SDMMC Low Layer HAL module driver. More...

Functions
static uint32_t	SDMMC_GetCmdError (SDMMC_TypeDef *SDMMCx)
	Checks for error conditions for CMD0. More...

static uint32_t	SDMMC_GetCmdResp1 (SDMMC_TypeDef *SDMMCx, uint8_t SD_CMD, uint32_t Timeout)
	Checks for error conditions for R1 response. More...

static uint32_t	SDMMC_GetCmdResp2 (SDMMC_TypeDef *SDMMCx)
	Checks for error conditions for R2 (CID or CSD) response. More...

static uint32_t	SDMMC_GetCmdResp3 (SDMMC_TypeDef *SDMMCx)
	Checks for error conditions for R3 (OCR) response. More...

static uint32_t	SDMMC_GetCmdResp7 (SDMMC_TypeDef *SDMMCx)
	Checks for error conditions for R7 response. More...

static uint32_t	SDMMC_GetCmdResp6 (SDMMC_TypeDef SDMMCx, uint8_t SD_CMD, uint16_t pRCA)
	Checks for error conditions for R6 (RCA) response. More...

HAL_StatusTypeDef	SDMMC_Init (SDMMC_TypeDef *SDMMCx, SDMMC_InitTypeDef Init)
	Initializes the SDMMC according to the specified parameters in the SDMMC_InitTypeDef and create the associated handle. More...

uint32_t	SDMMC_ReadFIFO (SDMMC_TypeDef *SDMMCx)
	Read data (word) from Rx FIFO in blocking mode (polling) More...

HAL_StatusTypeDef	SDMMC_WriteFIFO (SDMMC_TypeDef SDMMCx, uint32_t pWriteData)
	Write data (word) to Tx FIFO in blocking mode (polling) More...

HAL_StatusTypeDef	SDMMC_PowerState_ON (SDMMC_TypeDef *SDMMCx)
	Set SDMMC Power state to ON. More...

HAL_StatusTypeDef	SDMMC_PowerState_Cycle (SDMMC_TypeDef *SDMMCx)
	Set SDMMC Power state to Power-Cycle. More...

HAL_StatusTypeDef	SDMMC_PowerState_OFF (SDMMC_TypeDef *SDMMCx)
	Set SDMMC Power state to OFF. More...

uint32_t	SDMMC_GetPowerState (SDMMC_TypeDef *SDMMCx)
	Get SDMMC Power state. More...

HAL_StatusTypeDef	SDMMC_SendCommand (SDMMC_TypeDef SDMMCx, SDMMC_CmdInitTypeDef Command)
	Configure the SDMMC command path according to the specified parameters in SDMMC_CmdInitTypeDef structure and send the command. More...

uint8_t	SDMMC_GetCommandResponse (SDMMC_TypeDef *SDMMCx)
	Return the command index of last command for which response received. More...

uint32_t	SDMMC_GetResponse (SDMMC_TypeDef *SDMMCx, uint32_t Response)
	Return the response received from the card for the last command. More...

HAL_StatusTypeDef	SDMMC_ConfigData (SDMMC_TypeDef SDMMCx, SDMMC_DataInitTypeDef Data)
	Configure the SDMMC data path according to the specified parameters in the SDMMC_DataInitTypeDef. More...

uint32_t	SDMMC_GetDataCounter (SDMMC_TypeDef *SDMMCx)
	Returns number of remaining data bytes to be transferred. More...

uint32_t	SDMMC_GetFIFOCount (SDMMC_TypeDef *SDMMCx)
	Get the FIFO data. More...

HAL_StatusTypeDef	SDMMC_SetSDMMCReadWaitMode (SDMMC_TypeDef *SDMMCx, uint32_t SDMMC_ReadWaitMode)
	Sets one of the two options of inserting read wait interval. More...

uint32_t	SDMMC_CmdBlockLength (SDMMC_TypeDef *SDMMCx, uint32_t BlockSize)
	Send the Data Block Lenght command and check the response. More...

uint32_t	SDMMC_CmdReadSingleBlock (SDMMC_TypeDef *SDMMCx, uint32_t ReadAdd)
	Send the Read Single Block command and check the response. More...

uint32_t	SDMMC_CmdReadMultiBlock (SDMMC_TypeDef *SDMMCx, uint32_t ReadAdd)
	Send the Read Multi Block command and check the response. More...

uint32_t	SDMMC_CmdWriteSingleBlock (SDMMC_TypeDef *SDMMCx, uint32_t WriteAdd)
	Send the Write Single Block command and check the response. More...

uint32_t	SDMMC_CmdWriteMultiBlock (SDMMC_TypeDef *SDMMCx, uint32_t WriteAdd)
	Send the Write Multi Block command and check the response. More...

uint32_t	SDMMC_CmdSDEraseStartAdd (SDMMC_TypeDef *SDMMCx, uint32_t StartAdd)
	Send the Start Address Erase command for SD and check the response. More...

uint32_t	SDMMC_CmdSDEraseEndAdd (SDMMC_TypeDef *SDMMCx, uint32_t EndAdd)
	Send the End Address Erase command for SD and check the response. More...

uint32_t	SDMMC_CmdEraseStartAdd (SDMMC_TypeDef *SDMMCx, uint32_t StartAdd)
	Send the Start Address Erase command and check the response. More...

uint32_t	SDMMC_CmdEraseEndAdd (SDMMC_TypeDef *SDMMCx, uint32_t EndAdd)
	Send the End Address Erase command and check the response. More...

uint32_t	SDMMC_CmdErase (SDMMC_TypeDef *SDMMCx)
	Send the Erase command and check the response. More...

uint32_t	SDMMC_CmdStopTransfer (SDMMC_TypeDef *SDMMCx)
	Send the Stop Transfer command and check the response. More...

uint32_t	SDMMC_CmdSelDesel (SDMMC_TypeDef *SDMMCx, uint64_t Addr)
	Send the Select Deselect command and check the response. More...

uint32_t	SDMMC_CmdGoIdleState (SDMMC_TypeDef *SDMMCx)
	Send the Go Idle State command and check the response. More...

uint32_t	SDMMC_CmdOperCond (SDMMC_TypeDef *SDMMCx)
	Send the Operating Condition command and check the response. More...

uint32_t	SDMMC_CmdAppCommand (SDMMC_TypeDef *SDMMCx, uint32_t Argument)
	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. More...

uint32_t	SDMMC_CmdAppOperCommand (SDMMC_TypeDef *SDMMCx, uint32_t Argument)
	Send the command asking the accessed card to send its operating condition register (OCR) More...

uint32_t	SDMMC_CmdBusWidth (SDMMC_TypeDef *SDMMCx, uint32_t BusWidth)
	Send the Bus Width command and check the response. More...

uint32_t	SDMMC_CmdSendSCR (SDMMC_TypeDef *SDMMCx)
	Send the Send SCR command and check the response. More...

uint32_t	SDMMC_CmdSendCID (SDMMC_TypeDef *SDMMCx)
	Send the Send CID command and check the response. More...

uint32_t	SDMMC_CmdSendCSD (SDMMC_TypeDef *SDMMCx, uint32_t Argument)
	Send the Send CSD command and check the response. More...

uint32_t	SDMMC_CmdSetRelAdd (SDMMC_TypeDef SDMMCx, uint16_t pRCA)
	Send the Send CSD command and check the response. More...

uint32_t	SDMMC_CmdSendStatus (SDMMC_TypeDef *SDMMCx, uint32_t Argument)
	Send the Status command and check the response. More...

uint32_t	SDMMC_CmdStatusRegister (SDMMC_TypeDef *SDMMCx)
	Send the Status register command and check the response. More...

uint32_t	SDMMC_CmdOpCondition (SDMMC_TypeDef *SDMMCx, uint32_t Argument)
	Sends host capacity support information and activates the card's initialization process. Send SDMMC_CMD_SEND_OP_COND command. More...

uint32_t	SDMMC_CmdSwitch (SDMMC_TypeDef *SDMMCx, uint32_t Argument)
	Checks switchable function and switch card function. SDMMC_CMD_HS_SWITCH comand. More...

uint32_t	SDMMC_CmdVoltageSwitch (SDMMC_TypeDef *SDMMCx)
	Send the command asking the accessed card to send its operating condition register (OCR) More...

uint32_t	SDMMC_CmdSendEXTCSD (SDMMC_TypeDef *SDMMCx, uint32_t Argument)
	Send the Send EXT_CSD command and check the response. More...

	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))

else	if (__SDMMC_GET_FLAG(SDMMCx, SDMMC_FLAG_CCRCFAIL))

	if (SDMMC_GetCommandResponse(SDMMCx) !=SD_CMD)

	if ((response_r1 &SDMMC_OCR_ERRORBITS)==SDMMC_ALLZERO)

else	if ((response_r1 &SDMMC_OCR_ADDR_OUT_OF_RANGE)==SDMMC_OCR_ADDR_OUT_OF_RANGE)

else	if ((response_r1 &SDMMC_OCR_ADDR_MISALIGNED)==SDMMC_OCR_ADDR_MISALIGNED)

else	if ((response_r1 &SDMMC_OCR_BLOCK_LEN_ERR)==SDMMC_OCR_BLOCK_LEN_ERR)

else	if ((response_r1 &SDMMC_OCR_ERASE_SEQ_ERR)==SDMMC_OCR_ERASE_SEQ_ERR)

else	if ((response_r1 &SDMMC_OCR_BAD_ERASE_PARAM)==SDMMC_OCR_BAD_ERASE_PARAM)

else	if ((response_r1 &SDMMC_OCR_WRITE_PROT_VIOLATION)==SDMMC_OCR_WRITE_PROT_VIOLATION)

else	if ((response_r1 &SDMMC_OCR_LOCK_UNLOCK_FAILED)==SDMMC_OCR_LOCK_UNLOCK_FAILED)

else	if ((response_r1 &SDMMC_OCR_COM_CRC_FAILED)==SDMMC_OCR_COM_CRC_FAILED)

else	if ((response_r1 &SDMMC_OCR_ILLEGAL_CMD)==SDMMC_OCR_ILLEGAL_CMD)

else	if ((response_r1 &SDMMC_OCR_CARD_ECC_FAILED)==SDMMC_OCR_CARD_ECC_FAILED)

else	if ((response_r1 &SDMMC_OCR_CC_ERROR)==SDMMC_OCR_CC_ERROR)

else	if ((response_r1 &SDMMC_OCR_STREAM_READ_UNDERRUN)==SDMMC_OCR_STREAM_READ_UNDERRUN)

else	if ((response_r1 &SDMMC_OCR_STREAM_WRITE_OVERRUN)==SDMMC_OCR_STREAM_WRITE_OVERRUN)

else	if ((response_r1 &SDMMC_OCR_CID_CSD_OVERWRITE)==SDMMC_OCR_CID_CSD_OVERWRITE)

else	if ((response_r1 &SDMMC_OCR_WP_ERASE_SKIP)==SDMMC_OCR_WP_ERASE_SKIP)

else	if ((response_r1 &SDMMC_OCR_CARD_ECC_DISABLED)==SDMMC_OCR_CARD_ECC_DISABLED)

else	if ((response_r1 &SDMMC_OCR_ERASE_RESET)==SDMMC_OCR_ERASE_RESET)

else	if ((response_r1 &SDMMC_OCR_AKE_SEQ_ERROR)==SDMMC_OCR_AKE_SEQ_ERROR)

Variables
	else

	response_r1 = SDMMC_GetResponse(SDMMCx, SDMMC_RESP1)

Detailed Description

SDMMC Low Layer HAL module driver.

Author

MCD Application Team 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

==============================================================================
                     ##### 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 (SDMMCCLK = 48 MHz) is coming from a specific output (MSI, PLLUSB1CLK,
        PLLUSB2CLK). Before start working with SDMMC peripheral make sure that the
        PLL is well configured.
        The SDMMC peripheral uses two clock signals:
        (++) SDMMC adapter clock (SDMMCCLK = 48 MHz)
        (++) APB2 bus clock (PCLK2)

        -@@- PCLK2 and SDMMC_CK clock frequencies must respect the following condition:
             Frequency(PCLK2) >= (3 / 8 x Frequency(SDMMC_CK)) for STM32L496xG and STM32L4A6xG
             Frequency(PCLK2) >= (3 / 4 x Frequency(SDMMC_CK)) otherwise

    (+) 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 clock using the __SDMMC_ENABLE()/__SDMMC_DISABLE() macros.

    (+) 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
        (++) On STM32L4Rx/STM32L4Sxx devices
             (+++) Configure the IDMA mode (Single buffer or double)
             (+++) Configure the buffer address
             (+++) Configure Data Path State Machine
        (++) On other devices
             (+++) Configure the DMA in the MSP layer of the external device
             (+++) Active the needed channel Request 
             (+++) Enable the DMA using __SDMMC_DMA_ENABLE() macro or Disable it using the macro
                   __SDMMC_DMA_DISABLE().

    (+) 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.

Attention

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

Definition in file stm32l4xx_ll_sdmmc.c.

Functions

Variables

Detailed Description

© Copyright (c) 2017 STMicroelectronics. All rights reserved.