| /** |
| ****************************************************************************** |
| * @file stm32h7xx_ll_sdmmc.c |
| * @author MCD Application Team |
| * @brief SDMMC Low Layer HAL module driver. |
| * |
| * This file provides firmware functions to manage the following |
| * functionalities of the SDMMC peripheral: |
| * + Initialization/de-initialization functions |
| * + I/O operation functions |
| * + Peripheral Control functions |
| * + Peripheral State functions |
| * |
| @verbatim |
| ============================================================================== |
| ##### SDMMC peripheral features ##### |
| ============================================================================== |
| [..] The SD/SDMMC MMC card host interface (SDMMC) provides an interface between the AHB |
| peripheral bus and MultiMedia cards (MMCs), SD memory cards, SDMMC cards and CE-ATA |
| devices. |
| |
| [..] The SDMMC features include the following: |
| (+) Full compliance with MultiMediaCard System Specification Version 4.51. Card support |
| for three different databus modes: 1-bit (default), 4-bit and 8-bit. |
| (+) Full compatibility with previous versions of MultiMediaCards (backward compatibility). |
| (+) Full compliance with SD memory card specifications version 4.1. |
| (SDR104 SDMMC_CK speed limited to maximum allowed IO speed, SPI mode and |
| UHS-II mode not supported). |
| (+) Full compliance with SDIO card specification version 4.0. Card support |
| for two different databus modes: 1-bit (default) and 4-bit. |
| (SDR104 SDMMC_CK speed limited to maximum allowed IO speed, SPI mode and |
| UHS-II mode not supported). |
| (+) Data transfer up to 208 Mbyte/s for the 8 bit mode. (depending maximum allowed IO speed). |
| (+) Data and command output enable signals to control external bidirectional drivers |
| |
| ##### How to use this driver ##### |
| ============================================================================== |
| [..] |
| This driver is a considered as a driver of service for external devices drivers |
| that interfaces with the SDMMC peripheral. |
| According to the device used (SD card/ MMC card / SDMMC card ...), a set of APIs |
| is used in the device's driver to perform SDMMC operations and functionalities. |
| |
| This driver is almost transparent for the final user, it is only used to implement other |
| functionalities of the external device. |
| |
| [..] |
| (+) The SDMMC clock is coming from output of PLL1_Q or PLL2_R. |
| Before start working with SDMMC peripheral make sure that the PLL is well configured. |
| The SDMMC peripheral uses two clock signals: |
| (++) PLL1_Q bus clock (default after reset) |
| (++) PLL2_R bus clock |
| |
| (+) Enable/Disable peripheral clock using RCC peripheral macros related to SDMMC |
| peripheral. |
| |
| (+) Enable the Power ON State using the SDMMC_PowerState_ON(SDMMCx) |
| function and disable it using the function SDMMC_PowerState_OFF(SDMMCx). |
| |
| (+) Enable/Disable the peripheral interrupts using the macros __SDMMC_ENABLE_IT(hSDMMC, IT) |
| and __SDMMC_DISABLE_IT(hSDMMC, IT) if you need to use interrupt mode. |
| |
| (+) When using the DMA mode |
| (++) Configure the IDMA mode (Single buffer or double) |
| (++) Configure the buffer address |
| (++) Configure Data Path State Machine |
| |
| (+) To control the CPSM (Command Path State Machine) and send |
| commands to the card use the SDMMC_SendCommand(SDMMCx), |
| SDMMC_GetCommandResponse() and SDMMC_GetResponse() functions. First, user has |
| to fill the command structure (pointer to SDMMC_CmdInitTypeDef) according |
| to the selected command to be sent. |
| The parameters that should be filled are: |
| (++) Command Argument |
| (++) Command Index |
| (++) Command Response type |
| (++) Command Wait |
| (++) CPSM Status (Enable or Disable). |
| |
| -@@- To check if the command is well received, read the SDMMC_CMDRESP |
| register using the SDMMC_GetCommandResponse(). |
| The SDMMC responses registers (SDMMC_RESP1 to SDMMC_RESP2), use the |
| SDMMC_GetResponse() function. |
| |
| (+) To control the DPSM (Data Path State Machine) and send/receive |
| data to/from the card use the SDMMC_DataConfig(), SDMMC_GetDataCounter(), |
| SDMMC_ReadFIFO(), SDMMC_WriteFIFO() and SDMMC_GetFIFOCount() functions. |
| |
| *** Read Operations *** |
| ======================= |
| [..] |
| (#) First, user has to fill the data structure (pointer to |
| SDMMC_DataInitTypeDef) according to the selected data type to be received. |
| The parameters that should be filled are: |
| (++) Data TimeOut |
| (++) Data Length |
| (++) Data Block size |
| (++) Data Transfer direction: should be from card (To SDMMC) |
| (++) Data Transfer mode |
| (++) DPSM Status (Enable or Disable) |
| |
| (#) Configure the SDMMC resources to receive the data from the card |
| according to selected transfer mode (Refer to Step 8, 9 and 10). |
| |
| (#) Send the selected Read command (refer to step 11). |
| |
| (#) Use the SDMMC flags/interrupts to check the transfer status. |
| |
| *** Write Operations *** |
| ======================== |
| [..] |
| (#) First, user has to fill the data structure (pointer to |
| SDMMC_DataInitTypeDef) according to the selected data type to be received. |
| The parameters that should be filled are: |
| (++) Data TimeOut |
| (++) Data Length |
| (++) Data Block size |
| (++) Data Transfer direction: should be to card (To CARD) |
| (++) Data Transfer mode |
| (++) DPSM Status (Enable or Disable) |
| |
| (#) Configure the SDMMC resources to send the data to the card according to |
| selected transfer mode. |
| |
| (#) Send the selected Write command. |
| |
| (#) Use the SDMMC flags/interrupts to check the transfer status. |
| |
| *** Command management operations *** |
| ===================================== |
| [..] |
| (#) The commands used for Read/Write/Erase operations are managed in |
| separate functions. |
| Each function allows to send the needed command with the related argument, |
| then check the response. |
| By the same approach, you could implement a command and check the response. |
| |
| @endverbatim |
| ****************************************************************************** |
| * @attention |
| * |
| * <h2><center>© Copyright (c) 2017 STMicroelectronics. |
| * All rights reserved.</center></h2> |
| * |
| * This software component is licensed by ST under BSD 3-Clause license, |
| * the "License"; You may not use this file except in compliance with the |
| * License. You may obtain a copy of the License at: |
| * opensource.org/licenses/BSD-3-Clause |
| * |
| ****************************************************************************** |
| */ |
| |
| /* Includes ------------------------------------------------------------------*/ |
| #include "stm32h7xx_hal.h" |
| |
| /** @addtogroup STM32H7xx_HAL_Driver |
| * @{ |
| */ |
| |
| /** @defgroup SDMMC_LL SDMMC Low Layer |
| * @brief Low layer module for SD |
| * @{ |
| */ |
| |
| #if defined (HAL_SD_MODULE_ENABLED) || defined (HAL_MMC_MODULE_ENABLED) |
| |
| /* Private typedef -----------------------------------------------------------*/ |
| /* Private define ------------------------------------------------------------*/ |
| /* Private macro -------------------------------------------------------------*/ |
| /* Private variables ---------------------------------------------------------*/ |
| /* Private function prototypes -----------------------------------------------*/ |
| static uint32_t SDMMC_GetCmdError(SDMMC_TypeDef *SDMMCx); |
| static uint32_t SDMMC_GetCmdResp1(SDMMC_TypeDef *SDMMCx, uint8_t SD_CMD, uint32_t Timeout); |
| static uint32_t SDMMC_GetCmdResp2(SDMMC_TypeDef *SDMMCx); |
| static uint32_t SDMMC_GetCmdResp3(SDMMC_TypeDef *SDMMCx); |
| static uint32_t SDMMC_GetCmdResp7(SDMMC_TypeDef *SDMMCx); |
| static uint32_t SDMMC_GetCmdResp6(SDMMC_TypeDef *SDMMCx, uint8_t SD_CMD, uint16_t *pRCA); |
| |
| /* Exported functions --------------------------------------------------------*/ |
| |
| /** @defgroup SDMMC_LL_Exported_Functions SDMMC Low Layer Exported Functions |
| * @{ |
| */ |
| |
| /** @defgroup HAL_SDMMC_LL_Group1 Initialization de-initialization functions |
| * @brief Initialization and Configuration functions |
| * |
| @verbatim |
| =============================================================================== |
| ##### Initialization/de-initialization functions ##### |
| =============================================================================== |
| [..] This section provides functions allowing to: |
| |
| @endverbatim |
| * @{ |
| */ |
| |
| /** |
| * @brief Initializes the SDMMC according to the specified |
| * parameters in the SDMMC_InitTypeDef and create the associated handle. |
| * @param SDMMCx: Pointer to SDMMC register base |
| * @param Init: SDMMC initialization structure |
| * @retval HAL status |
| */ |
| HAL_StatusTypeDef SDMMC_Init(SDMMC_TypeDef *SDMMCx, SDMMC_InitTypeDef Init) |
| { |
| uint32_t tmpreg = 0; |
| |
| /* Check the parameters */ |
| assert_param(IS_SDMMC_ALL_INSTANCE(SDMMCx)); |
| assert_param(IS_SDMMC_CLOCK_EDGE(Init.ClockEdge)); |
| assert_param(IS_SDMMC_CLOCK_POWER_SAVE(Init.ClockPowerSave)); |
| assert_param(IS_SDMMC_BUS_WIDE(Init.BusWide)); |
| assert_param(IS_SDMMC_HARDWARE_FLOW_CONTROL(Init.HardwareFlowControl)); |
| assert_param(IS_SDMMC_CLKDIV(Init.ClockDiv)); |
| |
| /* Set SDMMC configuration parameters */ |
| tmpreg |= (Init.ClockEdge |\ |
| Init.ClockPowerSave |\ |
| Init.BusWide |\ |
| Init.HardwareFlowControl |\ |
| Init.ClockDiv |
| ); |
| |
| /* Write to SDMMC CLKCR */ |
| MODIFY_REG(SDMMCx->CLKCR, CLKCR_CLEAR_MASK, tmpreg); |
| |
| return HAL_OK; |
| } |
| |
| |
| /** |
| * @} |
| */ |
| |
| /** @defgroup HAL_SDMMC_LL_Group2 IO operation functions |
| * @brief Data transfers functions |
| * |
| @verbatim |
| =============================================================================== |
| ##### I/O operation functions ##### |
| =============================================================================== |
| [..] |
| This subsection provides a set of functions allowing to manage the SDMMC data |
| transfers. |
| |
| @endverbatim |
| * @{ |
| */ |
| |
| /** |
| * @brief Read data (word) from Rx FIFO in blocking mode (polling) |
| * @param SDMMCx: Pointer to SDMMC register base |
| * @retval HAL status |
| */ |
| uint32_t SDMMC_ReadFIFO(SDMMC_TypeDef *SDMMCx) |
| { |
| /* Read data from Rx FIFO */ |
| return (SDMMCx->FIFO); |
| } |
| |
| /** |
| * @brief Write data (word) to Tx FIFO in blocking mode (polling) |
| * @param SDMMCx: Pointer to SDMMC register base |
| * @param pWriteData: pointer to data to write |
| * @retval HAL status |
| */ |
| HAL_StatusTypeDef SDMMC_WriteFIFO(SDMMC_TypeDef *SDMMCx, uint32_t *pWriteData) |
| { |
| /* Write data to FIFO */ |
| SDMMCx->FIFO = *pWriteData; |
| |
| return HAL_OK; |
| } |
| |
| /** |
| * @} |
| */ |
| |
| /** @defgroup HAL_SDMMC_LL_Group3 Peripheral Control functions |
| * @brief management functions |
| * |
| @verbatim |
| =============================================================================== |
| ##### Peripheral Control functions ##### |
| =============================================================================== |
| [..] |
| This subsection provides a set of functions allowing to control the SDMMC data |
| transfers. |
| |
| @endverbatim |
| * @{ |
| */ |
| |
| /** |
| * @brief Set SDMMC Power state to ON. |
| * @param SDMMCx: Pointer to SDMMC register base |
| * @retval HAL status |
| */ |
| HAL_StatusTypeDef SDMMC_PowerState_ON(SDMMC_TypeDef *SDMMCx) |
| { |
| /* Set power state to ON */ |
| SDMMCx->POWER |= SDMMC_POWER_PWRCTRL; |
| |
| return HAL_OK; |
| } |
| |
| /** |
| * @brief Set SDMMC Power state to Power-Cycle. |
| * @param SDMMCx: Pointer to SDMMC register base |
| * @retval HAL status |
| */ |
| HAL_StatusTypeDef SDMMC_PowerState_Cycle(SDMMC_TypeDef *SDMMCx) |
| { |
| /* Set power state to Power Cycle*/ |
| SDMMCx->POWER |= SDMMC_POWER_PWRCTRL_1; |
| |
| return HAL_OK; |
| } |
| |
| /** |
| * @brief Set SDMMC Power state to OFF. |
| * @param SDMMCx: Pointer to SDMMC register base |
| * @retval HAL status |
| */ |
| HAL_StatusTypeDef SDMMC_PowerState_OFF(SDMMC_TypeDef *SDMMCx) |
| { |
| /* Set power state to OFF */ |
| SDMMCx->POWER &= ~(SDMMC_POWER_PWRCTRL); |
| |
| return HAL_OK; |
| } |
| |
| /** |
| * @brief Get SDMMC Power state. |
| * @param SDMMCx: Pointer to SDMMC register base |
| * @retval Power status of the controller. The returned value can be one of the |
| * following values: |
| * - 0x00: Power OFF |
| * - 0x02: Power UP |
| * - 0x03: Power ON |
| */ |
| uint32_t SDMMC_GetPowerState(SDMMC_TypeDef *SDMMCx) |
| { |
| return (SDMMCx->POWER & SDMMC_POWER_PWRCTRL); |
| } |
| |
| /** |
| * @brief Configure the SDMMC command path according to the specified parameters in |
| * SDMMC_CmdInitTypeDef structure and send the command |
| * @param SDMMCx: Pointer to SDMMC register base |
| * @param Command: pointer to a SDMMC_CmdInitTypeDef structure that contains |
| * the configuration information for the SDMMC command |
| * @retval HAL status |
| */ |
| HAL_StatusTypeDef SDMMC_SendCommand(SDMMC_TypeDef *SDMMCx, SDMMC_CmdInitTypeDef *Command) |
| { |
| uint32_t tmpreg = 0; |
| |
| /* Check the parameters */ |
| assert_param(IS_SDMMC_CMD_INDEX(Command->CmdIndex)); |
| assert_param(IS_SDMMC_RESPONSE(Command->Response)); |
| assert_param(IS_SDMMC_WAIT(Command->WaitForInterrupt)); |
| assert_param(IS_SDMMC_CPSM(Command->CPSM)); |
| |
| /* Set the SDMMC Argument value */ |
| SDMMCx->ARG = Command->Argument; |
| |
| /* Set SDMMC command parameters */ |
| tmpreg |= (uint32_t)(Command->CmdIndex |\ |
| Command->Response |\ |
| Command->WaitForInterrupt |\ |
| Command->CPSM); |
| |
| /* Write to SDMMC CMD register */ |
| MODIFY_REG(SDMMCx->CMD, CMD_CLEAR_MASK, tmpreg); |
| |
| return HAL_OK; |
| } |
| |
| /** |
| * @brief Return the command index of last command for which response received |
| * @param SDMMCx: Pointer to SDMMC register base |
| * @retval Command index of the last command response received |
| */ |
| uint8_t SDMMC_GetCommandResponse(SDMMC_TypeDef *SDMMCx) |
| { |
| return (uint8_t)(SDMMCx->RESPCMD); |
| } |
| |
| |
| /** |
| * @brief Return the response received from the card for the last command |
| * @param SDMMCx: Pointer to SDMMC register base |
| * @param Response: Specifies the SDMMC response register. |
| * This parameter can be one of the following values: |
| * @arg SDMMC_RESP1: Response Register 1 |
| * @arg SDMMC_RESP2: Response Register 2 |
| * @arg SDMMC_RESP3: Response Register 3 |
| * @arg SDMMC_RESP4: Response Register 4 |
| * @retval The Corresponding response register value |
| */ |
| uint32_t SDMMC_GetResponse(SDMMC_TypeDef *SDMMCx, uint32_t Response) |
| { |
| uint32_t tmp; |
| |
| /* Check the parameters */ |
| assert_param(IS_SDMMC_RESP(Response)); |
| |
| /* Get the response */ |
| tmp = (uint32_t)(&(SDMMCx->RESP1)) + Response; |
| |
| return (*(__IO uint32_t *) tmp); |
| } |
| |
| /** |
| * @brief Configure the SDMMC data path according to the specified |
| * parameters in the SDMMC_DataInitTypeDef. |
| * @param SDMMCx: Pointer to SDMMC register base |
| * @param Data : pointer to a SDMMC_DataInitTypeDef structure |
| * that contains the configuration information for the SDMMC data. |
| * @retval HAL status |
| */ |
| HAL_StatusTypeDef SDMMC_ConfigData(SDMMC_TypeDef *SDMMCx, SDMMC_DataInitTypeDef* Data) |
| { |
| uint32_t tmpreg = 0; |
| |
| /* Check the parameters */ |
| assert_param(IS_SDMMC_DATA_LENGTH(Data->DataLength)); |
| assert_param(IS_SDMMC_BLOCK_SIZE(Data->DataBlockSize)); |
| assert_param(IS_SDMMC_TRANSFER_DIR(Data->TransferDir)); |
| assert_param(IS_SDMMC_TRANSFER_MODE(Data->TransferMode)); |
| assert_param(IS_SDMMC_DPSM(Data->DPSM)); |
| |
| /* Set the SDMMC Data TimeOut value */ |
| SDMMCx->DTIMER = Data->DataTimeOut; |
| |
| /* Set the SDMMC DataLength value */ |
| SDMMCx->DLEN = Data->DataLength; |
| |
| /* Set the SDMMC data configuration parameters */ |
| tmpreg |= (uint32_t)(Data->DataBlockSize |\ |
| Data->TransferDir |\ |
| Data->TransferMode |\ |
| Data->DPSM); |
| |
| /* Write to SDMMC DCTRL */ |
| MODIFY_REG(SDMMCx->DCTRL, DCTRL_CLEAR_MASK, tmpreg); |
| |
| return HAL_OK; |
| |
| } |
| |
| /** |
| * @brief Returns number of remaining data bytes to be transferred. |
| * @param SDMMCx: Pointer to SDMMC register base |
| * @retval Number of remaining data bytes to be transferred |
| */ |
| uint32_t SDMMC_GetDataCounter(SDMMC_TypeDef *SDMMCx) |
| { |
| return (SDMMCx->DCOUNT); |
| } |
| |
| /** |
| * @brief Get the FIFO data |
| * @param SDMMCx: Pointer to SDMMC register base |
| * @retval Data received |
| */ |
| uint32_t SDMMC_GetFIFOCount(SDMMC_TypeDef *SDMMCx) |
| { |
| return (SDMMCx->FIFO); |
| } |
| |
| /** |
| * @brief Sets one of the two options of inserting read wait interval. |
| * @param SDMMCx: Pointer to SDMMC register base |
| * @param SDMMC_ReadWaitMode: SDMMC Read Wait operation mode. |
| * This parameter can be: |
| * @arg SDMMC_READ_WAIT_MODE_CLK: Read Wait control by stopping SDMMCCLK |
| * @arg SDMMC_READ_WAIT_MODE_DATA2: Read Wait control using SDMMC_DATA2 |
| * @retval None |
| */ |
| HAL_StatusTypeDef SDMMC_SetSDMMCReadWaitMode(SDMMC_TypeDef *SDMMCx, uint32_t SDMMC_ReadWaitMode) |
| { |
| /* Check the parameters */ |
| assert_param(IS_SDMMC_READWAIT_MODE(SDMMC_ReadWaitMode)); |
| |
| /* Set SDMMC read wait mode */ |
| MODIFY_REG(SDMMCx->DCTRL, SDMMC_DCTRL_RWMOD, SDMMC_ReadWaitMode); |
| |
| return HAL_OK; |
| } |
| |
| /** |
| * @} |
| */ |
| |
| |
| /** @defgroup HAL_SDMMC_LL_Group4 Command management functions |
| * @brief Data transfers functions |
| * |
| @verbatim |
| =============================================================================== |
| ##### Commands management functions ##### |
| =============================================================================== |
| [..] |
| This subsection provides a set of functions allowing to manage the needed commands. |
| |
| @endverbatim |
| * @{ |
| */ |
| |
| /** |
| * @brief Send the Data Block Lenght command and check the response |
| * @param SDMMCx: Pointer to SDMMC register base |
| * @retval HAL status |
| */ |
| uint32_t SDMMC_CmdBlockLength(SDMMC_TypeDef *SDMMCx, uint32_t BlockSize) |
| { |
| SDMMC_CmdInitTypeDef sdmmc_cmdinit; |
| uint32_t errorstate; |
| |
| /* Set Block Size for Card */ |
| sdmmc_cmdinit.Argument = (uint32_t)BlockSize; |
| sdmmc_cmdinit.CmdIndex = SDMMC_CMD_SET_BLOCKLEN; |
| sdmmc_cmdinit.Response = SDMMC_RESPONSE_SHORT; |
| sdmmc_cmdinit.WaitForInterrupt = SDMMC_WAIT_NO; |
| sdmmc_cmdinit.CPSM = SDMMC_CPSM_ENABLE; |
| (void)SDMMC_SendCommand(SDMMCx, &sdmmc_cmdinit); |
| |
| /* Check for error conditions */ |
| errorstate = SDMMC_GetCmdResp1(SDMMCx, SDMMC_CMD_SET_BLOCKLEN, SDMMC_CMDTIMEOUT); |
| |
| return errorstate; |
| } |
| |
| /** |
| * @brief Send the Read Single Block command and check the response |
| * @param SDMMCx: Pointer to SDMMC register base |
| * @retval HAL status |
| */ |
| uint32_t SDMMC_CmdReadSingleBlock(SDMMC_TypeDef *SDMMCx, uint32_t ReadAdd) |
| { |
| SDMMC_CmdInitTypeDef sdmmc_cmdinit; |
| uint32_t errorstate; |
| |
| /* Set Block Size for Card */ |
| sdmmc_cmdinit.Argument = (uint32_t)ReadAdd; |
| sdmmc_cmdinit.CmdIndex = SDMMC_CMD_READ_SINGLE_BLOCK; |
| sdmmc_cmdinit.Response = SDMMC_RESPONSE_SHORT; |
| sdmmc_cmdinit.WaitForInterrupt = SDMMC_WAIT_NO; |
| sdmmc_cmdinit.CPSM = SDMMC_CPSM_ENABLE; |
| (void)SDMMC_SendCommand(SDMMCx, &sdmmc_cmdinit); |
| |
| /* Check for error conditions */ |
| errorstate = SDMMC_GetCmdResp1(SDMMCx, SDMMC_CMD_READ_SINGLE_BLOCK, SDMMC_CMDTIMEOUT); |
| |
| return errorstate; |
| } |
| |
| /** |
| * @brief Send the Read Multi Block command and check the response |
| * @param SDMMCx: Pointer to SDMMC register base |
| * @retval HAL status |
| */ |
| uint32_t SDMMC_CmdReadMultiBlock(SDMMC_TypeDef *SDMMCx, uint32_t ReadAdd) |
| { |
| SDMMC_CmdInitTypeDef sdmmc_cmdinit; |
| uint32_t errorstate; |
| |
| /* Set Block Size for Card */ |
| sdmmc_cmdinit.Argument = (uint32_t)ReadAdd; |
| sdmmc_cmdinit.CmdIndex = SDMMC_CMD_READ_MULT_BLOCK; |
| sdmmc_cmdinit.Response = SDMMC_RESPONSE_SHORT; |
| sdmmc_cmdinit.WaitForInterrupt = SDMMC_WAIT_NO; |
| sdmmc_cmdinit.CPSM = SDMMC_CPSM_ENABLE; |
| (void)SDMMC_SendCommand(SDMMCx, &sdmmc_cmdinit); |
| |
| /* Check for error conditions */ |
| errorstate = SDMMC_GetCmdResp1(SDMMCx, SDMMC_CMD_READ_MULT_BLOCK, SDMMC_CMDTIMEOUT); |
| |
| return errorstate; |
| } |
| |
| /** |
| * @brief Send the Write Single Block command and check the response |
| * @param SDMMCx: Pointer to SDMMC register base |
| * @retval HAL status |
| */ |
| uint32_t SDMMC_CmdWriteSingleBlock(SDMMC_TypeDef *SDMMCx, uint32_t WriteAdd) |
| { |
| SDMMC_CmdInitTypeDef sdmmc_cmdinit; |
| uint32_t errorstate; |
| |
| /* Set Block Size for Card */ |
| sdmmc_cmdinit.Argument = (uint32_t)WriteAdd; |
| sdmmc_cmdinit.CmdIndex = SDMMC_CMD_WRITE_SINGLE_BLOCK; |
| sdmmc_cmdinit.Response = SDMMC_RESPONSE_SHORT; |
| sdmmc_cmdinit.WaitForInterrupt = SDMMC_WAIT_NO; |
| sdmmc_cmdinit.CPSM = SDMMC_CPSM_ENABLE; |
| (void)SDMMC_SendCommand(SDMMCx, &sdmmc_cmdinit); |
| |
| /* Check for error conditions */ |
| errorstate = SDMMC_GetCmdResp1(SDMMCx, SDMMC_CMD_WRITE_SINGLE_BLOCK, SDMMC_CMDTIMEOUT); |
| |
| return errorstate; |
| } |
| |
| /** |
| * @brief Send the Write Multi Block command and check the response |
| * @param SDMMCx: Pointer to SDMMC register base |
| * @retval HAL status |
| */ |
| uint32_t SDMMC_CmdWriteMultiBlock(SDMMC_TypeDef *SDMMCx, uint32_t WriteAdd) |
| { |
| SDMMC_CmdInitTypeDef sdmmc_cmdinit; |
| uint32_t errorstate; |
| |
| /* Set Block Size for Card */ |
| sdmmc_cmdinit.Argument = (uint32_t)WriteAdd; |
| sdmmc_cmdinit.CmdIndex = SDMMC_CMD_WRITE_MULT_BLOCK; |
| sdmmc_cmdinit.Response = SDMMC_RESPONSE_SHORT; |
| sdmmc_cmdinit.WaitForInterrupt = SDMMC_WAIT_NO; |
| sdmmc_cmdinit.CPSM = SDMMC_CPSM_ENABLE; |
| (void)SDMMC_SendCommand(SDMMCx, &sdmmc_cmdinit); |
| |
| /* Check for error conditions */ |
| errorstate = SDMMC_GetCmdResp1(SDMMCx, SDMMC_CMD_WRITE_MULT_BLOCK, SDMMC_CMDTIMEOUT); |
| |
| return errorstate; |
| } |
| |
| /** |
| * @brief Send the Start Address Erase command for SD and check the response |
| * @param SDMMCx: Pointer to SDMMC register base |
| * @retval HAL status |
| */ |
| uint32_t SDMMC_CmdSDEraseStartAdd(SDMMC_TypeDef *SDMMCx, uint32_t StartAdd) |
| { |
| SDMMC_CmdInitTypeDef sdmmc_cmdinit; |
| uint32_t errorstate; |
| |
| /* Set Block Size for Card */ |
| sdmmc_cmdinit.Argument = (uint32_t)StartAdd; |
| sdmmc_cmdinit.CmdIndex = SDMMC_CMD_SD_ERASE_GRP_START; |
| sdmmc_cmdinit.Response = SDMMC_RESPONSE_SHORT; |
| sdmmc_cmdinit.WaitForInterrupt = SDMMC_WAIT_NO; |
| sdmmc_cmdinit.CPSM = SDMMC_CPSM_ENABLE; |
| (void)SDMMC_SendCommand(SDMMCx, &sdmmc_cmdinit); |
| |
| /* Check for error conditions */ |
| errorstate = SDMMC_GetCmdResp1(SDMMCx, SDMMC_CMD_SD_ERASE_GRP_START, SDMMC_CMDTIMEOUT); |
| |
| return errorstate; |
| } |
| |
| /** |
| * @brief Send the End Address Erase command for SD and check the response |
| * @param SDMMCx: Pointer to SDMMC register base |
| * @retval HAL status |
| */ |
| uint32_t SDMMC_CmdSDEraseEndAdd(SDMMC_TypeDef *SDMMCx, uint32_t EndAdd) |
| { |
| SDMMC_CmdInitTypeDef sdmmc_cmdinit; |
| uint32_t errorstate; |
| |
| /* Set Block Size for Card */ |
| sdmmc_cmdinit.Argument = (uint32_t)EndAdd; |
| sdmmc_cmdinit.CmdIndex = SDMMC_CMD_SD_ERASE_GRP_END; |
| sdmmc_cmdinit.Response = SDMMC_RESPONSE_SHORT; |
| sdmmc_cmdinit.WaitForInterrupt = SDMMC_WAIT_NO; |
| sdmmc_cmdinit.CPSM = SDMMC_CPSM_ENABLE; |
| (void)SDMMC_SendCommand(SDMMCx, &sdmmc_cmdinit); |
| |
| /* Check for error conditions */ |
| errorstate = SDMMC_GetCmdResp1(SDMMCx, SDMMC_CMD_SD_ERASE_GRP_END, SDMMC_CMDTIMEOUT); |
| |
| return errorstate; |
| } |
| |
| /** |
| * @brief Send the Start Address Erase command and check the response |
| * @param SDMMCx: Pointer to SDMMC register base |
| * @retval HAL status |
| */ |
| uint32_t SDMMC_CmdEraseStartAdd(SDMMC_TypeDef *SDMMCx, uint32_t StartAdd) |
| { |
| SDMMC_CmdInitTypeDef sdmmc_cmdinit; |
| uint32_t errorstate; |
| |
| /* Set Block Size for Card */ |
| sdmmc_cmdinit.Argument = (uint32_t)StartAdd; |
| sdmmc_cmdinit.CmdIndex = SDMMC_CMD_ERASE_GRP_START; |
| sdmmc_cmdinit.Response = SDMMC_RESPONSE_SHORT; |
| sdmmc_cmdinit.WaitForInterrupt = SDMMC_WAIT_NO; |
| sdmmc_cmdinit.CPSM = SDMMC_CPSM_ENABLE; |
| (void)SDMMC_SendCommand(SDMMCx, &sdmmc_cmdinit); |
| |
| /* Check for error conditions */ |
| errorstate = SDMMC_GetCmdResp1(SDMMCx, SDMMC_CMD_ERASE_GRP_START, SDMMC_CMDTIMEOUT); |
| |
| return errorstate; |
| } |
| |
| /** |
| * @brief Send the End Address Erase command and check the response |
| * @param SDMMCx: Pointer to SDMMC register base |
| * @retval HAL status |
| */ |
| uint32_t SDMMC_CmdEraseEndAdd(SDMMC_TypeDef *SDMMCx, uint32_t EndAdd) |
| { |
| SDMMC_CmdInitTypeDef sdmmc_cmdinit; |
| uint32_t errorstate; |
| |
| /* Set Block Size for Card */ |
| sdmmc_cmdinit.Argument = (uint32_t)EndAdd; |
| sdmmc_cmdinit.CmdIndex = SDMMC_CMD_ERASE_GRP_END; |
| sdmmc_cmdinit.Response = SDMMC_RESPONSE_SHORT; |
| sdmmc_cmdinit.WaitForInterrupt = SDMMC_WAIT_NO; |
| sdmmc_cmdinit.CPSM = SDMMC_CPSM_ENABLE; |
| (void)SDMMC_SendCommand(SDMMCx, &sdmmc_cmdinit); |
| |
| /* Check for error conditions */ |
| errorstate = SDMMC_GetCmdResp1(SDMMCx, SDMMC_CMD_ERASE_GRP_END, SDMMC_CMDTIMEOUT); |
| |
| return errorstate; |
| } |
| |
| /** |
| * @brief Send the Erase command and check the response |
| * @param SDMMCx: Pointer to SDMMC register base |
| * @retval HAL status |
| */ |
| uint32_t SDMMC_CmdErase(SDMMC_TypeDef *SDMMCx) |
| { |
| SDMMC_CmdInitTypeDef sdmmc_cmdinit; |
| uint32_t errorstate; |
| |
| /* Set Block Size for Card */ |
| sdmmc_cmdinit.Argument = 0U; |
| sdmmc_cmdinit.CmdIndex = SDMMC_CMD_ERASE; |
| sdmmc_cmdinit.Response = SDMMC_RESPONSE_SHORT; |
| sdmmc_cmdinit.WaitForInterrupt = SDMMC_WAIT_NO; |
| sdmmc_cmdinit.CPSM = SDMMC_CPSM_ENABLE; |
| (void)SDMMC_SendCommand(SDMMCx, &sdmmc_cmdinit); |
| |
| /* Check for error conditions */ |
| errorstate = SDMMC_GetCmdResp1(SDMMCx, SDMMC_CMD_ERASE, SDMMC_MAXERASETIMEOUT); |
| |
| return errorstate; |
| } |
| |
| /** |
| * @brief Send the Stop Transfer command and check the response. |
| * @param SDMMCx: Pointer to SDMMC register base |
| * @retval HAL status |
| */ |
| uint32_t SDMMC_CmdStopTransfer(SDMMC_TypeDef *SDMMCx) |
| { |
| SDMMC_CmdInitTypeDef sdmmc_cmdinit; |
| uint32_t errorstate; |
| |
| /* Send CMD12 STOP_TRANSMISSION */ |
| sdmmc_cmdinit.Argument = 0U; |
| sdmmc_cmdinit.CmdIndex = SDMMC_CMD_STOP_TRANSMISSION; |
| sdmmc_cmdinit.Response = SDMMC_RESPONSE_SHORT; |
| sdmmc_cmdinit.WaitForInterrupt = SDMMC_WAIT_NO; |
| sdmmc_cmdinit.CPSM = SDMMC_CPSM_ENABLE; |
| |
| __SDMMC_CMDSTOP_ENABLE(SDMMCx); |
| __SDMMC_CMDTRANS_DISABLE(SDMMCx); |
| |
| (void)SDMMC_SendCommand(SDMMCx, &sdmmc_cmdinit); |
| |
| /* Check for error conditions */ |
| errorstate = SDMMC_GetCmdResp1(SDMMCx, SDMMC_CMD_STOP_TRANSMISSION, SDMMC_STOPTRANSFERTIMEOUT); |
| |
| __SDMMC_CMDSTOP_DISABLE(SDMMCx); |
| |
| return errorstate; |
| } |
| |
| /** |
| * @brief Send the Select Deselect command and check the response. |
| * @param SDMMCx: Pointer to SDMMC register base |
| * @param addr: Address of the card to be selected |
| * @retval HAL status |
| */ |
| uint32_t SDMMC_CmdSelDesel(SDMMC_TypeDef *SDMMCx, uint64_t Addr) |
| { |
| SDMMC_CmdInitTypeDef sdmmc_cmdinit; |
| uint32_t errorstate; |
| |
| /* Send CMD7 SDMMC_SEL_DESEL_CARD */ |
| sdmmc_cmdinit.Argument = (uint32_t)Addr; |
| sdmmc_cmdinit.CmdIndex = SDMMC_CMD_SEL_DESEL_CARD; |
| sdmmc_cmdinit.Response = SDMMC_RESPONSE_SHORT; |
| sdmmc_cmdinit.WaitForInterrupt = SDMMC_WAIT_NO; |
| sdmmc_cmdinit.CPSM = SDMMC_CPSM_ENABLE; |
| (void)SDMMC_SendCommand(SDMMCx, &sdmmc_cmdinit); |
| |
| /* Check for error conditions */ |
| errorstate = SDMMC_GetCmdResp1(SDMMCx, SDMMC_CMD_SEL_DESEL_CARD, SDMMC_CMDTIMEOUT); |
| |
| return errorstate; |
| } |
| |
| /** |
| * @brief Send the Go Idle State command and check the response. |
| * @param SDMMCx: Pointer to SDMMC register base |
| * @retval HAL status |
| */ |
| uint32_t SDMMC_CmdGoIdleState(SDMMC_TypeDef *SDMMCx) |
| { |
| SDMMC_CmdInitTypeDef sdmmc_cmdinit; |
| uint32_t errorstate; |
| |
| sdmmc_cmdinit.Argument = 0U; |
| sdmmc_cmdinit.CmdIndex = SDMMC_CMD_GO_IDLE_STATE; |
| sdmmc_cmdinit.Response = SDMMC_RESPONSE_NO; |
| sdmmc_cmdinit.WaitForInterrupt = SDMMC_WAIT_NO; |
| sdmmc_cmdinit.CPSM = SDMMC_CPSM_ENABLE; |
| (void)SDMMC_SendCommand(SDMMCx, &sdmmc_cmdinit); |
| |
| /* Check for error conditions */ |
| errorstate = SDMMC_GetCmdError(SDMMCx); |
| |
| return errorstate; |
| } |
| |
| /** |
| * @brief Send the Operating Condition command and check the response. |
| * @param SDMMCx: Pointer to SDMMC register base |
| * @retval HAL status |
| */ |
| uint32_t SDMMC_CmdOperCond(SDMMC_TypeDef *SDMMCx) |
| { |
| SDMMC_CmdInitTypeDef sdmmc_cmdinit; |
| uint32_t errorstate; |
| |
| /* Send CMD8 to verify SD card interface operating condition */ |
| /* Argument: - [31:12]: Reserved (shall be set to '0') |
| - [11:8]: Supply Voltage (VHS) 0x1 (Range: 2.7-3.6 V) |
| - [7:0]: Check Pattern (recommended 0xAA) */ |
| /* CMD Response: R7 */ |
| sdmmc_cmdinit.Argument = SDMMC_CHECK_PATTERN; |
| sdmmc_cmdinit.CmdIndex = SDMMC_CMD_HS_SEND_EXT_CSD; |
| sdmmc_cmdinit.Response = SDMMC_RESPONSE_SHORT; |
| sdmmc_cmdinit.WaitForInterrupt = SDMMC_WAIT_NO; |
| sdmmc_cmdinit.CPSM = SDMMC_CPSM_ENABLE; |
| (void)SDMMC_SendCommand(SDMMCx, &sdmmc_cmdinit); |
| |
| /* Check for error conditions */ |
| errorstate = SDMMC_GetCmdResp7(SDMMCx); |
| |
| return errorstate; |
| } |
| |
| /** |
| * @brief Send the Application command to verify that that the next command |
| * is an application specific com-mand rather than a standard command |
| * and check the response. |
| * @param SDMMCx: Pointer to SDMMC register base |
| * @param Argument: Command Argument |
| * @retval HAL status |
| */ |
| uint32_t SDMMC_CmdAppCommand(SDMMC_TypeDef *SDMMCx, uint32_t Argument) |
| { |
| SDMMC_CmdInitTypeDef sdmmc_cmdinit; |
| uint32_t errorstate; |
| |
| sdmmc_cmdinit.Argument = (uint32_t)Argument; |
| sdmmc_cmdinit.CmdIndex = SDMMC_CMD_APP_CMD; |
| sdmmc_cmdinit.Response = SDMMC_RESPONSE_SHORT; |
| sdmmc_cmdinit.WaitForInterrupt = SDMMC_WAIT_NO; |
| sdmmc_cmdinit.CPSM = SDMMC_CPSM_ENABLE; |
| (void)SDMMC_SendCommand(SDMMCx, &sdmmc_cmdinit); |
| |
| /* Check for error conditions */ |
| /* If there is a HAL_ERROR, it is a MMC card, else |
| it is a SD card: SD card 2.0 (voltage range mismatch) |
| or SD card 1.x */ |
| errorstate = SDMMC_GetCmdResp1(SDMMCx, SDMMC_CMD_APP_CMD, SDMMC_CMDTIMEOUT); |
| |
| return errorstate; |
| } |
| |
| /** |
| * @brief Send the command asking the accessed card to send its operating |
| * condition register (OCR) |
| * @param SDMMCx: Pointer to SDMMC register base |
| * @param Argument: Command Argument |
| * @retval HAL status |
| */ |
| uint32_t SDMMC_CmdAppOperCommand(SDMMC_TypeDef *SDMMCx, uint32_t Argument) |
| { |
| SDMMC_CmdInitTypeDef sdmmc_cmdinit; |
| uint32_t errorstate; |
| |
| sdmmc_cmdinit.Argument = Argument; |
| sdmmc_cmdinit.CmdIndex = SDMMC_CMD_SD_APP_OP_COND; |
| sdmmc_cmdinit.Response = SDMMC_RESPONSE_SHORT; |
| sdmmc_cmdinit.WaitForInterrupt = SDMMC_WAIT_NO; |
| sdmmc_cmdinit.CPSM = SDMMC_CPSM_ENABLE; |
| (void)SDMMC_SendCommand(SDMMCx, &sdmmc_cmdinit); |
| |
| /* Check for error conditions */ |
| errorstate = SDMMC_GetCmdResp3(SDMMCx); |
| |
| return errorstate; |
| } |
| |
| /** |
| * @brief Send the Bus Width command and check the response. |
| * @param SDMMCx: Pointer to SDMMC register base |
| * @param BusWidth: BusWidth |
| * @retval HAL status |
| */ |
| uint32_t SDMMC_CmdBusWidth(SDMMC_TypeDef *SDMMCx, uint32_t BusWidth) |
| { |
| SDMMC_CmdInitTypeDef sdmmc_cmdinit; |
| uint32_t errorstate; |
| |
| sdmmc_cmdinit.Argument = (uint32_t)BusWidth; |
| sdmmc_cmdinit.CmdIndex = SDMMC_CMD_APP_SD_SET_BUSWIDTH; |
| sdmmc_cmdinit.Response = SDMMC_RESPONSE_SHORT; |
| sdmmc_cmdinit.WaitForInterrupt = SDMMC_WAIT_NO; |
| sdmmc_cmdinit.CPSM = SDMMC_CPSM_ENABLE; |
| (void)SDMMC_SendCommand(SDMMCx, &sdmmc_cmdinit); |
| |
| /* Check for error conditions */ |
| errorstate = SDMMC_GetCmdResp1(SDMMCx, SDMMC_CMD_APP_SD_SET_BUSWIDTH, SDMMC_CMDTIMEOUT); |
| |
| return errorstate; |
| } |
| |
| /** |
| * @brief Send the Send SCR command and check the response. |
| * @param SDMMCx: Pointer to SDMMC register base |
| * @retval HAL status |
| */ |
| uint32_t SDMMC_CmdSendSCR(SDMMC_TypeDef *SDMMCx) |
| { |
| SDMMC_CmdInitTypeDef sdmmc_cmdinit; |
| uint32_t errorstate; |
| |
| /* Send CMD51 SD_APP_SEND_SCR */ |
| sdmmc_cmdinit.Argument = 0U; |
| sdmmc_cmdinit.CmdIndex = SDMMC_CMD_SD_APP_SEND_SCR; |
| sdmmc_cmdinit.Response = SDMMC_RESPONSE_SHORT; |
| sdmmc_cmdinit.WaitForInterrupt = SDMMC_WAIT_NO; |
| sdmmc_cmdinit.CPSM = SDMMC_CPSM_ENABLE; |
| (void)SDMMC_SendCommand(SDMMCx, &sdmmc_cmdinit); |
| |
| /* Check for error conditions */ |
| errorstate = SDMMC_GetCmdResp1(SDMMCx, SDMMC_CMD_SD_APP_SEND_SCR, SDMMC_CMDTIMEOUT); |
| |
| return errorstate; |
| } |
| |
| /** |
| * @brief Send the Send CID command and check the response. |
| * @param SDMMCx: Pointer to SDMMC register base |
| * @retval HAL status |
| */ |
| uint32_t SDMMC_CmdSendCID(SDMMC_TypeDef *SDMMCx) |
| { |
| SDMMC_CmdInitTypeDef sdmmc_cmdinit; |
| uint32_t errorstate; |
| |
| /* Send CMD2 ALL_SEND_CID */ |
| sdmmc_cmdinit.Argument = 0U; |
| sdmmc_cmdinit.CmdIndex = SDMMC_CMD_ALL_SEND_CID; |
| sdmmc_cmdinit.Response = SDMMC_RESPONSE_LONG; |
| sdmmc_cmdinit.WaitForInterrupt = SDMMC_WAIT_NO; |
| sdmmc_cmdinit.CPSM = SDMMC_CPSM_ENABLE; |
| (void)SDMMC_SendCommand(SDMMCx, &sdmmc_cmdinit); |
| |
| /* Check for error conditions */ |
| errorstate = SDMMC_GetCmdResp2(SDMMCx); |
| |
| return errorstate; |
| } |
| |
| /** |
| * @brief Send the Send CSD command and check the response. |
| * @param SDMMCx: Pointer to SDMMC register base |
| * @param Argument: Command Argument |
| * @retval HAL status |
| */ |
| uint32_t SDMMC_CmdSendCSD(SDMMC_TypeDef *SDMMCx, uint32_t Argument) |
| { |
| SDMMC_CmdInitTypeDef sdmmc_cmdinit; |
| uint32_t errorstate; |
| |
| /* Send CMD9 SEND_CSD */ |
| sdmmc_cmdinit.Argument = Argument; |
| sdmmc_cmdinit.CmdIndex = SDMMC_CMD_SEND_CSD; |
| sdmmc_cmdinit.Response = SDMMC_RESPONSE_LONG; |
| sdmmc_cmdinit.WaitForInterrupt = SDMMC_WAIT_NO; |
| sdmmc_cmdinit.CPSM = SDMMC_CPSM_ENABLE; |
| (void)SDMMC_SendCommand(SDMMCx, &sdmmc_cmdinit); |
| |
| /* Check for error conditions */ |
| errorstate = SDMMC_GetCmdResp2(SDMMCx); |
| |
| return errorstate; |
| } |
| |
| /** |
| * @brief Send the Send CSD command and check the response. |
| * @param SDMMCx: Pointer to SDMMC register base |
| * @param pRCA: Card RCA |
| * @retval HAL status |
| */ |
| uint32_t SDMMC_CmdSetRelAdd(SDMMC_TypeDef *SDMMCx, uint16_t *pRCA) |
| { |
| SDMMC_CmdInitTypeDef sdmmc_cmdinit; |
| uint32_t errorstate; |
| |
| /* Send CMD3 SD_CMD_SET_REL_ADDR */ |
| sdmmc_cmdinit.Argument = 0U; |
| sdmmc_cmdinit.CmdIndex = SDMMC_CMD_SET_REL_ADDR; |
| sdmmc_cmdinit.Response = SDMMC_RESPONSE_SHORT; |
| sdmmc_cmdinit.WaitForInterrupt = SDMMC_WAIT_NO; |
| sdmmc_cmdinit.CPSM = SDMMC_CPSM_ENABLE; |
| (void)SDMMC_SendCommand(SDMMCx, &sdmmc_cmdinit); |
| |
| /* Check for error conditions */ |
| errorstate = SDMMC_GetCmdResp6(SDMMCx, SDMMC_CMD_SET_REL_ADDR, pRCA); |
| |
| return errorstate; |
| } |
| |
| /** |
| * @brief Send the Status command and check the response. |
| * @param SDMMCx: Pointer to SDMMC register base |
| * @param Argument: Command Argument |
| * @retval HAL status |
| */ |
| uint32_t SDMMC_CmdSendStatus(SDMMC_TypeDef *SDMMCx, uint32_t Argument) |
| { |
| SDMMC_CmdInitTypeDef sdmmc_cmdinit; |
| uint32_t errorstate; |
| |
| sdmmc_cmdinit.Argument = Argument; |
| sdmmc_cmdinit.CmdIndex = SDMMC_CMD_SEND_STATUS; |
| sdmmc_cmdinit.Response = SDMMC_RESPONSE_SHORT; |
| sdmmc_cmdinit.WaitForInterrupt = SDMMC_WAIT_NO; |
| sdmmc_cmdinit.CPSM = SDMMC_CPSM_ENABLE; |
| (void)SDMMC_SendCommand(SDMMCx, &sdmmc_cmdinit); |
| |
| /* Check for error conditions */ |
| errorstate = SDMMC_GetCmdResp1(SDMMCx, SDMMC_CMD_SEND_STATUS, SDMMC_CMDTIMEOUT); |
| |
| return errorstate; |
| } |
| |
| /** |
| * @brief Send the Status register command and check the response. |
| * @param SDMMCx: Pointer to SDMMC register base |
| * @retval HAL status |
| */ |
| uint32_t SDMMC_CmdStatusRegister(SDMMC_TypeDef *SDMMCx) |
| { |
| SDMMC_CmdInitTypeDef sdmmc_cmdinit; |
| uint32_t errorstate; |
| |
| sdmmc_cmdinit.Argument = 0U; |
| sdmmc_cmdinit.CmdIndex = SDMMC_CMD_SD_APP_STATUS; |
| sdmmc_cmdinit.Response = SDMMC_RESPONSE_SHORT; |
| sdmmc_cmdinit.WaitForInterrupt = SDMMC_WAIT_NO; |
| sdmmc_cmdinit.CPSM = SDMMC_CPSM_ENABLE; |
| (void)SDMMC_SendCommand(SDMMCx, &sdmmc_cmdinit); |
| |
| /* Check for error conditions */ |
| errorstate = SDMMC_GetCmdResp1(SDMMCx, SDMMC_CMD_SD_APP_STATUS, SDMMC_CMDTIMEOUT); |
| |
| return errorstate; |
| } |
| |
| /** |
| * @brief Sends host capacity support information and activates the card's |
| * initialization process. Send SDMMC_CMD_SEND_OP_COND command |
| * @param SDMMCx: Pointer to SDMMC register base |
| * @parame Argument: Argument used for the command |
| * @retval HAL status |
| */ |
| uint32_t SDMMC_CmdOpCondition(SDMMC_TypeDef *SDMMCx, uint32_t Argument) |
| { |
| SDMMC_CmdInitTypeDef sdmmc_cmdinit; |
| uint32_t errorstate; |
| |
| sdmmc_cmdinit.Argument = Argument; |
| sdmmc_cmdinit.CmdIndex = SDMMC_CMD_SEND_OP_COND; |
| sdmmc_cmdinit.Response = SDMMC_RESPONSE_SHORT; |
| sdmmc_cmdinit.WaitForInterrupt = SDMMC_WAIT_NO; |
| sdmmc_cmdinit.CPSM = SDMMC_CPSM_ENABLE; |
| (void)SDMMC_SendCommand(SDMMCx, &sdmmc_cmdinit); |
| |
| /* Check for error conditions */ |
| errorstate = SDMMC_GetCmdResp3(SDMMCx); |
| |
| return errorstate; |
| } |
| |
| /** |
| * @brief Checks switchable function and switch card function. SDMMC_CMD_HS_SWITCH comand |
| * @param SDMMCx: Pointer to SDMMC register base |
| * @parame Argument: Argument used for the command |
| * @retval HAL status |
| */ |
| uint32_t SDMMC_CmdSwitch(SDMMC_TypeDef *SDMMCx, uint32_t Argument) |
| { |
| SDMMC_CmdInitTypeDef sdmmc_cmdinit; |
| uint32_t errorstate; |
| |
| /* Send CMD6 to activate SDR50 Mode and Power Limit 1.44W */ |
| /* CMD Response: R1 */ |
| sdmmc_cmdinit.Argument = Argument; /* SDMMC_SDR25_SWITCH_PATTERN;*/ |
| sdmmc_cmdinit.CmdIndex = SDMMC_CMD_HS_SWITCH; |
| sdmmc_cmdinit.Response = SDMMC_RESPONSE_SHORT; |
| sdmmc_cmdinit.WaitForInterrupt = SDMMC_WAIT_NO; |
| sdmmc_cmdinit.CPSM = SDMMC_CPSM_ENABLE; |
| (void)SDMMC_SendCommand(SDMMCx, &sdmmc_cmdinit); |
| |
| /* Check for error conditions */ |
| errorstate = SDMMC_GetCmdResp1(SDMMCx, SDMMC_CMD_HS_SWITCH, SDMMC_CMDTIMEOUT); |
| |
| return errorstate; |
| } |
| |
| /** |
| * @brief Send the command asking the accessed card to send its operating |
| * condition register (OCR) |
| * @param None |
| * @retval HAL status |
| */ |
| uint32_t SDMMC_CmdVoltageSwitch(SDMMC_TypeDef *SDMMCx) |
| { |
| SDMMC_CmdInitTypeDef sdmmc_cmdinit; |
| uint32_t errorstate; |
| |
| sdmmc_cmdinit.Argument = 0x00000000; |
| sdmmc_cmdinit.CmdIndex = SDMMC_CMD_VOLTAGE_SWITCH; |
| sdmmc_cmdinit.Response = SDMMC_RESPONSE_SHORT; |
| sdmmc_cmdinit.WaitForInterrupt = SDMMC_WAIT_NO; |
| sdmmc_cmdinit.CPSM = SDMMC_CPSM_ENABLE; |
| (void)SDMMC_SendCommand(SDMMCx, &sdmmc_cmdinit); |
| |
| /* Check for error conditions */ |
| errorstate = SDMMC_GetCmdResp1(SDMMCx, SDMMC_CMD_VOLTAGE_SWITCH, SDMMC_CMDTIMEOUT); |
| |
| return errorstate; |
| } |
| |
| /** |
| * @brief Send the Send EXT_CSD command and check the response. |
| * @param SDMMCx: Pointer to SDMMC register base |
| * @param Argument: Command Argument |
| * @retval HAL status |
| */ |
| uint32_t SDMMC_CmdSendEXTCSD(SDMMC_TypeDef *SDMMCx, uint32_t Argument) |
| { |
| SDMMC_CmdInitTypeDef sdmmc_cmdinit; |
| uint32_t errorstate; |
| |
| /* Send CMD9 SEND_CSD */ |
| sdmmc_cmdinit.Argument = Argument; |
| sdmmc_cmdinit.CmdIndex = SDMMC_CMD_HS_SEND_EXT_CSD; |
| sdmmc_cmdinit.Response = SDMMC_RESPONSE_SHORT; |
| sdmmc_cmdinit.WaitForInterrupt = SDMMC_WAIT_NO; |
| sdmmc_cmdinit.CPSM = SDMMC_CPSM_ENABLE; |
| (void)SDMMC_SendCommand(SDMMCx, &sdmmc_cmdinit); |
| |
| /* Check for error conditions */ |
| errorstate = SDMMC_GetCmdResp1(SDMMCx, SDMMC_CMD_HS_SEND_EXT_CSD,SDMMC_CMDTIMEOUT); |
| |
| return errorstate; |
| } |
| |
| |
| /** |
| * @} |
| */ |
| |
| /* Private function ----------------------------------------------------------*/ |
| /** @addtogroup SD_Private_Functions |
| * @{ |
| */ |
| |
| /** |
| * @brief Checks for error conditions for CMD0. |
| * @param hsd: SD handle |
| * @retval SD Card error state |
| */ |
| static uint32_t SDMMC_GetCmdError(SDMMC_TypeDef *SDMMCx) |
| { |
| /* 8 is the number of required instructions cycles for the below loop statement. |
| The SDMMC_CMDTIMEOUT is expressed in ms */ |
| register uint32_t count = SDMMC_CMDTIMEOUT * (SystemCoreClock / 8U /1000U); |
| |
| do |
| { |
| if (count-- == 0U) |
| { |
| return SDMMC_ERROR_TIMEOUT; |
| } |
| |
| }while(!__SDMMC_GET_FLAG(SDMMCx, SDMMC_FLAG_CMDSENT)); |
| |
| /* Clear all the static flags */ |
| __SDMMC_CLEAR_FLAG(SDMMCx, SDMMC_STATIC_CMD_FLAGS); |
| |
| return SDMMC_ERROR_NONE; |
| } |
| |
| /** |
| * @brief Checks for error conditions for R1 response. |
| * @param hsd: SD handle |
| * @param SD_CMD: The sent command index |
| * @retval SD Card error state |
| */ |
| static uint32_t SDMMC_GetCmdResp1(SDMMC_TypeDef *SDMMCx, uint8_t SD_CMD, uint32_t Timeout) |
| { |
| uint32_t response_r1; |
| uint32_t sta_reg; |
| |
| /* 8 is the number of required instructions cycles for the below loop statement. |
| The Timeout is expressed in ms */ |
| register uint32_t count = Timeout * (SystemCoreClock / 8U /1000U); |
| |
| do |
| { |
| if (count-- == 0U) |
| { |
| return SDMMC_ERROR_TIMEOUT; |
| } |
| sta_reg = SDMMCx->STA; |
| }while(((sta_reg & (SDMMC_FLAG_CCRCFAIL | SDMMC_FLAG_CMDREND | SDMMC_FLAG_CTIMEOUT | SDMMC_FLAG_BUSYD0END)) == 0U) || |
| ((sta_reg & SDMMC_FLAG_CMDACT) != 0U )); |
| |
| if(__SDMMC_GET_FLAG(SDMMCx, SDMMC_FLAG_CTIMEOUT)) |
| { |
| __SDMMC_CLEAR_FLAG(SDMMCx, SDMMC_FLAG_CTIMEOUT); |
| |
| return SDMMC_ERROR_CMD_RSP_TIMEOUT; |
| } |
| else if(__SDMMC_GET_FLAG(SDMMCx, SDMMC_FLAG_CCRCFAIL)) |
| { |
| __SDMMC_CLEAR_FLAG(SDMMCx, SDMMC_FLAG_CCRCFAIL); |
| |
| return SDMMC_ERROR_CMD_CRC_FAIL; |
| } |
| else |
| { |
| /* Nothing to do */ |
| } |
| |
| /* Clear all the static flags */ |
| __SDMMC_CLEAR_FLAG(SDMMCx, SDMMC_STATIC_CMD_FLAGS); |
| |
| /* Check response received is of desired command */ |
| if(SDMMC_GetCommandResponse(SDMMCx) != SD_CMD) |
| { |
| return SDMMC_ERROR_CMD_CRC_FAIL; |
| } |
| |
| /* We have received response, retrieve it for analysis */ |
| response_r1 = SDMMC_GetResponse(SDMMCx, SDMMC_RESP1); |
| |
| if((response_r1 & SDMMC_OCR_ERRORBITS) == SDMMC_ALLZERO) |
| { |
| return SDMMC_ERROR_NONE; |
| } |
| else if((response_r1 & SDMMC_OCR_ADDR_OUT_OF_RANGE) == SDMMC_OCR_ADDR_OUT_OF_RANGE) |
| { |
| return SDMMC_ERROR_ADDR_OUT_OF_RANGE; |
| } |
| else if((response_r1 & SDMMC_OCR_ADDR_MISALIGNED) == SDMMC_OCR_ADDR_MISALIGNED) |
| { |
| return SDMMC_ERROR_ADDR_MISALIGNED; |
| } |
| else if((response_r1 & SDMMC_OCR_BLOCK_LEN_ERR) == SDMMC_OCR_BLOCK_LEN_ERR) |
| { |
| return SDMMC_ERROR_BLOCK_LEN_ERR; |
| } |
| else if((response_r1 & SDMMC_OCR_ERASE_SEQ_ERR) == SDMMC_OCR_ERASE_SEQ_ERR) |
| { |
| return SDMMC_ERROR_ERASE_SEQ_ERR; |
| } |
| else if((response_r1 & SDMMC_OCR_BAD_ERASE_PARAM) == SDMMC_OCR_BAD_ERASE_PARAM) |
| { |
| return SDMMC_ERROR_BAD_ERASE_PARAM; |
| } |
| else if((response_r1 & SDMMC_OCR_WRITE_PROT_VIOLATION) == SDMMC_OCR_WRITE_PROT_VIOLATION) |
| { |
| return SDMMC_ERROR_WRITE_PROT_VIOLATION; |
| } |
| else if((response_r1 & SDMMC_OCR_LOCK_UNLOCK_FAILED) == SDMMC_OCR_LOCK_UNLOCK_FAILED) |
| { |
| return SDMMC_ERROR_LOCK_UNLOCK_FAILED; |
| } |
| else if((response_r1 & SDMMC_OCR_COM_CRC_FAILED) == SDMMC_OCR_COM_CRC_FAILED) |
| { |
| return SDMMC_ERROR_COM_CRC_FAILED; |
| } |
| else if((response_r1 & SDMMC_OCR_ILLEGAL_CMD) == SDMMC_OCR_ILLEGAL_CMD) |
| { |
| return SDMMC_ERROR_ILLEGAL_CMD; |
| } |
| else if((response_r1 & SDMMC_OCR_CARD_ECC_FAILED) == SDMMC_OCR_CARD_ECC_FAILED) |
| { |
| return SDMMC_ERROR_CARD_ECC_FAILED; |
| } |
| else if((response_r1 & SDMMC_OCR_CC_ERROR) == SDMMC_OCR_CC_ERROR) |
| { |
| return SDMMC_ERROR_CC_ERR; |
| } |
| else if((response_r1 & SDMMC_OCR_STREAM_READ_UNDERRUN) == SDMMC_OCR_STREAM_READ_UNDERRUN) |
| { |
| return SDMMC_ERROR_STREAM_READ_UNDERRUN; |
| } |
| else if((response_r1 & SDMMC_OCR_STREAM_WRITE_OVERRUN) == SDMMC_OCR_STREAM_WRITE_OVERRUN) |
| { |
| return SDMMC_ERROR_STREAM_WRITE_OVERRUN; |
| } |
| else if((response_r1 & SDMMC_OCR_CID_CSD_OVERWRITE) == SDMMC_OCR_CID_CSD_OVERWRITE) |
| { |
| return SDMMC_ERROR_CID_CSD_OVERWRITE; |
| } |
| else if((response_r1 & SDMMC_OCR_WP_ERASE_SKIP) == SDMMC_OCR_WP_ERASE_SKIP) |
| { |
| return SDMMC_ERROR_WP_ERASE_SKIP; |
| } |
| else if((response_r1 & SDMMC_OCR_CARD_ECC_DISABLED) == SDMMC_OCR_CARD_ECC_DISABLED) |
| { |
| return SDMMC_ERROR_CARD_ECC_DISABLED; |
| } |
| else if((response_r1 & SDMMC_OCR_ERASE_RESET) == SDMMC_OCR_ERASE_RESET) |
| { |
| return SDMMC_ERROR_ERASE_RESET; |
| } |
| else if((response_r1 & SDMMC_OCR_AKE_SEQ_ERROR) == SDMMC_OCR_AKE_SEQ_ERROR) |
| { |
| return SDMMC_ERROR_AKE_SEQ_ERR; |
| } |
| else |
| { |
| return SDMMC_ERROR_GENERAL_UNKNOWN_ERR; |
| } |
| } |
| |
| /** |
| * @brief Checks for error conditions for R2 (CID or CSD) response. |
| * @param hsd: SD handle |
| * @retval SD Card error state |
| */ |
| static uint32_t SDMMC_GetCmdResp2(SDMMC_TypeDef *SDMMCx) |
| { |
| uint32_t sta_reg; |
| /* 8 is the number of required instructions cycles for the below loop statement. |
| The SDMMC_CMDTIMEOUT is expressed in ms */ |
| register uint32_t count = SDMMC_CMDTIMEOUT * (SystemCoreClock / 8U /1000U); |
| |
| do |
| { |
| if (count-- == 0U) |
| { |
| return SDMMC_ERROR_TIMEOUT; |
| } |
| sta_reg = SDMMCx->STA; |
| }while(((sta_reg & (SDMMC_FLAG_CCRCFAIL | SDMMC_FLAG_CMDREND | SDMMC_FLAG_CTIMEOUT)) == 0U) || |
| ((sta_reg & SDMMC_FLAG_CMDACT) != 0U )); |
| |
| if (__SDMMC_GET_FLAG(SDMMCx, SDMMC_FLAG_CTIMEOUT)) |
| { |
| __SDMMC_CLEAR_FLAG(SDMMCx, SDMMC_FLAG_CTIMEOUT); |
| |
| return SDMMC_ERROR_CMD_RSP_TIMEOUT; |
| } |
| else if (__SDMMC_GET_FLAG(SDMMCx, SDMMC_FLAG_CCRCFAIL)) |
| { |
| __SDMMC_CLEAR_FLAG(SDMMCx, SDMMC_FLAG_CCRCFAIL); |
| |
| return SDMMC_ERROR_CMD_CRC_FAIL; |
| } |
| else |
| { |
| /* No error flag set */ |
| /* Clear all the static flags */ |
| __SDMMC_CLEAR_FLAG(SDMMCx, SDMMC_STATIC_CMD_FLAGS); |
| } |
| |
| return SDMMC_ERROR_NONE; |
| } |
| |
| /** |
| * @brief Checks for error conditions for R3 (OCR) response. |
| * @param hsd: SD handle |
| * @retval SD Card error state |
| */ |
| static uint32_t SDMMC_GetCmdResp3(SDMMC_TypeDef *SDMMCx) |
| { |
| uint32_t sta_reg; |
| /* 8 is the number of required instructions cycles for the below loop statement. |
| The SDMMC_CMDTIMEOUT is expressed in ms */ |
| register uint32_t count = SDMMC_CMDTIMEOUT * (SystemCoreClock / 8U /1000U); |
| |
| do |
| { |
| if (count-- == 0U) |
| { |
| return SDMMC_ERROR_TIMEOUT; |
| } |
| sta_reg = SDMMCx->STA; |
| }while(((sta_reg & (SDMMC_FLAG_CCRCFAIL | SDMMC_FLAG_CMDREND | SDMMC_FLAG_CTIMEOUT)) == 0U) || |
| ((sta_reg & SDMMC_FLAG_CMDACT) != 0U )); |
| |
| if(__SDMMC_GET_FLAG(SDMMCx, SDMMC_FLAG_CTIMEOUT)) |
| { |
| __SDMMC_CLEAR_FLAG(SDMMCx, SDMMC_FLAG_CTIMEOUT); |
| |
| return SDMMC_ERROR_CMD_RSP_TIMEOUT; |
| } |
| else |
| { |
| /* Clear all the static flags */ |
| __SDMMC_CLEAR_FLAG(SDMMCx, SDMMC_STATIC_CMD_FLAGS); |
| } |
| |
| return SDMMC_ERROR_NONE; |
| } |
| |
| /** |
| * @brief Checks for error conditions for R6 (RCA) response. |
| * @param hsd: SD handle |
| * @param SD_CMD: The sent command index |
| * @param pRCA: Pointer to the variable that will contain the SD card relative |
| * address RCA |
| * @retval SD Card error state |
| */ |
| static uint32_t SDMMC_GetCmdResp6(SDMMC_TypeDef *SDMMCx, uint8_t SD_CMD, uint16_t *pRCA) |
| { |
| uint32_t response_r1; |
| uint32_t sta_reg; |
| |
| /* 8 is the number of required instructions cycles for the below loop statement. |
| The SDMMC_CMDTIMEOUT is expressed in ms */ |
| register uint32_t count = SDMMC_CMDTIMEOUT * (SystemCoreClock / 8U /1000U); |
| |
| do |
| { |
| if (count-- == 0U) |
| { |
| return SDMMC_ERROR_TIMEOUT; |
| } |
| sta_reg = SDMMCx->STA; |
| }while(((sta_reg & (SDMMC_FLAG_CCRCFAIL | SDMMC_FLAG_CMDREND | SDMMC_FLAG_CTIMEOUT)) == 0U) || |
| ((sta_reg & SDMMC_FLAG_CMDACT) != 0U )); |
| |
| if(__SDMMC_GET_FLAG(SDMMCx, SDMMC_FLAG_CTIMEOUT)) |
| { |
| __SDMMC_CLEAR_FLAG(SDMMCx, SDMMC_FLAG_CTIMEOUT); |
| |
| return SDMMC_ERROR_CMD_RSP_TIMEOUT; |
| } |
| else if(__SDMMC_GET_FLAG(SDMMCx, SDMMC_FLAG_CCRCFAIL)) |
| { |
| __SDMMC_CLEAR_FLAG(SDMMCx, SDMMC_FLAG_CCRCFAIL); |
| |
| return SDMMC_ERROR_CMD_CRC_FAIL; |
| } |
| else |
| { |
| /* Nothing to do */ |
| } |
| |
| /* Check response received is of desired command */ |
| if(SDMMC_GetCommandResponse(SDMMCx) != SD_CMD) |
| { |
| return SDMMC_ERROR_CMD_CRC_FAIL; |
| } |
| |
| /* Clear all the static flags */ |
| __SDMMC_CLEAR_FLAG(SDMMCx, SDMMC_STATIC_CMD_FLAGS); |
| |
| /* We have received response, retrieve it. */ |
| response_r1 = SDMMC_GetResponse(SDMMCx, SDMMC_RESP1); |
| |
| if((response_r1 & (SDMMC_R6_GENERAL_UNKNOWN_ERROR | SDMMC_R6_ILLEGAL_CMD | SDMMC_R6_COM_CRC_FAILED)) == SDMMC_ALLZERO) |
| { |
| *pRCA = (uint16_t) (response_r1 >> 16); |
| |
| return SDMMC_ERROR_NONE; |
| } |
| else if((response_r1 & SDMMC_R6_ILLEGAL_CMD) == SDMMC_R6_ILLEGAL_CMD) |
| { |
| return SDMMC_ERROR_ILLEGAL_CMD; |
| } |
| else if((response_r1 & SDMMC_R6_COM_CRC_FAILED) == SDMMC_R6_COM_CRC_FAILED) |
| { |
| return SDMMC_ERROR_COM_CRC_FAILED; |
| } |
| else |
| { |
| return SDMMC_ERROR_GENERAL_UNKNOWN_ERR; |
| } |
| } |
| |
| /** |
| * @brief Checks for error conditions for R7 response. |
| * @param hsd: SD handle |
| * @retval SD Card error state |
| */ |
| static uint32_t SDMMC_GetCmdResp7(SDMMC_TypeDef *SDMMCx) |
| { |
| uint32_t sta_reg; |
| /* 8 is the number of required instructions cycles for the below loop statement. |
| The SDMMC_CMDTIMEOUT is expressed in ms */ |
| register uint32_t count = SDMMC_CMDTIMEOUT * (SystemCoreClock / 8U /1000U); |
| |
| do |
| { |
| if (count-- == 0U) |
| { |
| return SDMMC_ERROR_TIMEOUT; |
| } |
| sta_reg = SDMMCx->STA; |
| }while(((sta_reg & (SDMMC_FLAG_CCRCFAIL | SDMMC_FLAG_CMDREND | SDMMC_FLAG_CTIMEOUT)) == 0U) || |
| ((sta_reg & SDMMC_FLAG_CMDACT) != 0U )); |
| |
| if(__SDMMC_GET_FLAG(SDMMCx, SDMMC_FLAG_CTIMEOUT)) |
| { |
| /* Card is SD V2.0 compliant */ |
| __SDMMC_CLEAR_FLAG(SDMMCx, SDMMC_FLAG_CTIMEOUT); |
| |
| return SDMMC_ERROR_CMD_RSP_TIMEOUT; |
| } |
| |
| else if(__SDMMC_GET_FLAG(SDMMCx, SDMMC_FLAG_CCRCFAIL)) |
| { |
| /* Card is SD V2.0 compliant */ |
| __SDMMC_CLEAR_FLAG(SDMMCx, SDMMC_FLAG_CCRCFAIL); |
| |
| return SDMMC_ERROR_CMD_CRC_FAIL; |
| } |
| else |
| { |
| /* Nothing to do */ |
| } |
| |
| if(__SDMMC_GET_FLAG(SDMMCx, SDMMC_FLAG_CMDREND)) |
| { |
| /* Card is SD V2.0 compliant */ |
| __SDMMC_CLEAR_FLAG(SDMMCx, SDMMC_FLAG_CMDREND); |
| } |
| |
| return SDMMC_ERROR_NONE; |
| |
| } |
| |
| /** |
| * @} |
| */ |
| |
| #endif /* HAL_SD_MODULE_ENABLED || HAL_MMC_MODULE_ENABLED */ |
| /** |
| * @} |
| */ |
| |
| /** |
| * @} |
| */ |
| |
| /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/ |