5.24 SDIO Guide

name   SDIO_DeInit.
fun    Reset the SDIO peripheral registers to their default reset values.
param  none
return none

name   SDIO_Init.
fun    Initializes the SDIO peripheral according to the specified
       parameters in the InitStruct.
param  InitStruct pointer to a SDIO_InitType structure.
       The input parameters must be the following values:
          - ClkEdge:
               - SDIO_CLK_EDGE_RISING
               - SDIO_CLK_EDGE_FALLING
          - ClkBypass:
               - SDIO_CLK_BYPASS_DISABLE
               - SDIO_CLK_BYPASS_ENABLE
          - ClkPwrSave:
               - SDIO_CLK_POWER_SAVE_DISABLE
               - SDIO_CLK_POWER_SAVE_ENABLE
          - BusWidth:
               - SDIO_BUS_WIDTH_1B
               - SDIO_BUS_WIDTH_4B
               - SDIO_BUS_WIDTH_8B
          - HardwareClkCtrl:
               - SDIO_HARDWARE_CLKCTRL_DISABLE
               - SDIO_HARDWARE_CLKCTRL_ENABLE
          - ClkDiv: Must be a value between 0x00 and 0x1FF.
return none

name   SDIO_InitStruct.
fun    Fills each InitStruct member with its default value.
param  InitStruct pointer to an SDIO_InitType structure which will be initialized.
return none

name   SDIO_EnableClock.
fun    Enables or disables the SDIO Clock.
param  Cmd new state of the SDIO Clock.
           This parameter must be one of the following values:
               - ENABLE
               - DISABLE
return none

name   SDIO_SetPower.
fun    Sets the power status of the controller.
param  PowerState new state of the Power state.
           This parameter must be one of the following values:
               - SDIO_POWER_CTRL_OFF
               - SDIO_POWER_CTRL_ON
return none

name   SDIO_GetPower.
fun    Gets the power status of the controller.
param  none
return Current Power status,the value can be:
           - SDIO_POWER_CTRL_OFF
           - SDIO_POWER_CTRL_UP
           - SDIO_POWER_CTRL_ON

name   SDIO_ConfigInt.
fun    Enables or disables the SDIO interrupts.
param  Int specifies the SDIO interrupt sources to be enabled or disabled.
           This parameter must be a value or combination of the following values:
               - SDIO_INT_CCRCERR
               - SDIO_INT_DCRCERR
               - SDIO_INT_CMDTIMEOUT
               - SDIO_INT_DATTIMEOUT
               - SDIO_INT_TXURERR
               - SDIO_INT_RXORERR
               - SDIO_INT_CMDRESPRECV
               - SDIO_INT_CMDSEND
               - SDIO_INT_DATEND
               - SDIO_INT_SBERR
               - SDIO_INT_DATBLKEND
               - SDIO_INT_CMDRUN
               - SDIO_INT_TXRUN
               - SDIO_INT_RXRUN
               - SDIO_INT_TFIFOE
               - SDIO_INT_TFIFOHE
               - SDIO_INT_TFIFOF
               - SDIO_INT_TDATVALID
               - SDIO_INT_RFIFOE
               - SDIO_INT_RFIFOHF
               - SDIO_INT_RFIFOF
               - SDIO_INT_RDATVALID
               - SDIO_INT_SDIOINT
param  Cmd new state of the specified SDIO interrupts.Must be one of one of the following values:
               - ENABLE
               - DISABLE
return none

name   SDIO_DMACmd.
fun    Enables or disables the SDIO DMA request.
param  Cmd new state of the SDIO DMA request.
           This parameter must be one of the following values:
               - ENABLE
               - DISABLE
return none

name   SDIO_SendCmd.
fun    Initializes the SDIO Command according to the specified
       parameters in the CmdInitStruct and send the command.
param  CmdInitStruct pointer to a SDIO_CmdInitType structure.
       The input parameters must be the following values:
          - CmdArgument: Optional SDIO command argument.
          - CmdIndex: SDIO command index, must be lower than 0x40.
          - ResponseType:
               - SDIO_RESP_NO
               - SDIO_RESP_SHORT
               - SDIO_RESP_LONG
          - WaitType:
               - SDIO_WAIT_NO
               - SDIO_WAIT_INT
               - SDIO_WAIT_PEND
          - CPSMConfig:
               - SDIO_CPSM_DISABLE
               - SDIO_CPSM_ENABLE
return none

name   SDIO_InitCmdStruct.
fun    Fills each CmdInitStruct member with its default value.
param  CmdInitStruct pointer to a SDIO_CmdInitType structure.
return none

name   SDIO_GetCmdResp.
fun    Returns command index of last command for which response received.
param  none
return Command index of the last command response received

name   SDIO_GetResp.
fun    Returns response received from the card for the last command.
param  SDIO_RESP Specifies the SDIO response register.
       This parameter must be one of the following values:
           - SDIO_RESPONSE_1
           - SDIO_RESPONSE_2
           - SDIO_RESPONSE_3
           - SDIO_RESPONSE_4
return The Corresponding response register value.

name   SDIO_ConfigData.
fun    Initializes the SDIO data path according to the specified
       parameters in the DataInitStruct.
param  DataInitStruct pointer to a SDIO_DataInitType structure.
       The input parameters must be the following values:
          - DatTimeout: data timeout period.
          - DatLen: Number of data bytes to be transferred,
                   must be a value between 0x0 and 0x01FFFFFF
          - DatBlkSize:
               - SDIO_DATBLK_SIZE_1B
               - SDIO_DATBLK_SIZE_2B
               - SDIO_DATBLK_SIZE_4B
               - SDIO_DATBLK_SIZE_8B
               - SDIO_DATBLK_SIZE_16B
               - SDIO_DATBLK_SIZE_32B
               - SDIO_DATBLK_SIZE_64B
               - SDIO_DATBLK_SIZE_128B
               - SDIO_DATBLK_SIZE_256B
               - SDIO_DATBLK_SIZE_512B
               - SDIO_DATBLK_SIZE_1024B
               - SDIO_DATBLK_SIZE_2048B
               - SDIO_DATBLK_SIZE_4096B
               - SDIO_DATBLK_SIZE_8192B
               - SDIO_DATBLK_SIZE_16384B
          - TransferDirection:
               - SDIO_TRANSDIR_TOCARD
               - SDIO_TRANSDIR_TOSDIO
          - TransferMode:
               - SDIO_TRANSMODE_BLOCK
               - SDIO_TRANSMODE_STREAM
          - DPSMConfig:
               - SDIO_DPSM_DISABLE
               - SDIO_DPSM_ENABLE
return none

name   SDIO_InitDataStruct.
fun    Fills each DataInitStruct member with its default value.
param  DataInitStruct pointer to a SDIO_DataInitType structure.
return none

name   SDIO_GetDataCountValue.
fun    Returns number of remaining data bytes to be transferred.
param  none
return Number of remaining data bytes to be transferred.

name   SDIO_ReadData.
fun    Read one data word from Rx DATFIFO.
param  none
return Data received.

name   SDIO_WriteData.
fun    Write one data word to Tx DATFIFO.
param  Data 32-bit data word to write.
return none

name   SDIO_GetFifoCounter.
fun    Returns the number of words left to be written to or read from DATFIFO.
param  none
return Remaining number of words in the FIFO.

name   SDIO_EnableReadWait.
fun    Enable the SD I/O Read Wait operation.
param  Cmd new state of the read wait operation.
           This parameter must be one of the following values:
               - ENABLE
               - DISABLE
return none

name   SDIO_EnableSdioReadWaitMode.
fun    Sets one of the two options of inserting read wait interval.
param  ReadWaitMode SD I/O Read Wait operation mode.
           This parameter must be one of the following values:
               - SDIO_RDWAIT_MODE_CLK
               - SDIO_RDWAIT_MODE_DAT2
return none

name   SDIO_StartReadWait.
fun    Start the SD I/O Read Wait operation when RWAITEN bit is set.
param  none
return none

name   SDIO_StopReadWait.
fun    Stop the SD I/O Read Wait operation when RWAITEN bit is set.
param  none
return none

name   SDIO_EnableSdioOperation.
fun    Enables the SD I/O Mode Operation.
param  Cmd new state of the SD I/O Mode Operation.
           This parameter must be one of the following values:
               - ENABLE
               - DISABLE
return none

name   SDIO_EnableSendSdioSuspend.
fun    Enables the SD I/O Mode suspend command sending.
param  Cmd new state of the SD I/O Mode suspend command sending.
           This parameter must be one of the following values:
               - ENABLE
               - DISABLE
return none

name   SDIO_EnableCommandCompletion.
fun    Enables the command completion signal.
param  Cmd new state of the command completion signal.
           This parameter must be one of the following values:
               - ENABLE
               - DISABLE
return none

name   SDIO_GetFlag.
fun    Checks whether the specified SDIO flag is set or not.
param  Flag specifies the flag to check.
           This parameter must be one of the following values:
               - SDIO_FLAG_CCRCERR
               - SDIO_FLAG_DCRCERR
               - SDIO_FLAG_CMDTIMEOUT
               - SDIO_FLAG_DATTIMEOUT
               - SDIO_FLAG_TXURERR
               - SDIO_FLAG_RXORERR
               - SDIO_FLAG_CMDRESPRECV
               - SDIO_FLAG_CMDSEND
               - SDIO_FLAG_DATEND
               - SDIO_FLAG_SBERR
               - SDIO_FLAG_DATBLKEND
               - SDIO_FLAG_CMDRUN
               - SDIO_FLAG_TXRUN
               - SDIO_FLAG_RXRUN
               - SDIO_FLAG_TFIFOE
               - SDIO_FLAG_TFIFOHE
               - SDIO_FLAG_TFIFOF
               - SDIO_FLAG_TDATVALID
               - SDIO_FLAG_RFIFOE
               - SDIO_FLAG_RFIFOHF
               - SDIO_FLAG_RFIFOF
               - SDIO_FLAG_RDATVALID
               - SDIO_FLAG_SDIOINT
return FlagStatus:
           - SET
           - RESET

name   SDIO_ClrFlag.
fun    Clears the SDIO's pending flags.
param  FlagClr specifies the flag to clear.
           This parameter must be one of the following values:
               - SDIO_FLAG_CCRCERR
               - SDIO_FLAG_DCRCERR
               - SDIO_FLAG_CMDTIMEOUT
               - SDIO_FLAG_DATTIMEOUT
               - SDIO_FLAG_TXURERR
               - SDIO_FLAG_RXORERR
               - SDIO_FLAG_CMDRESPRECV
               - SDIO_FLAG_CMDSEND
               - SDIO_FLAG_DATEND
               - SDIO_FLAG_SBERR
               - SDIO_FLAG_DATBLKEND
               - SDIO_FLAG_SDIOINT
return none

name   SDIO_GetIntStatus.
fun    Checks whether the specified SDIO interrupt has occurred or not.
param  Int specifies the SDIO interrupt source to check.
           This parameter must be one of the following values:
               - SDIO_INT_CCRCERR
               - SDIO_INT_DCRCERR
               - SDIO_INT_CMDTIMEOUT
               - SDIO_INT_DATTIMEOUT
               - SDIO_INT_TXURERR
               - SDIO_INT_RXORERR
               - SDIO_INT_CMDRESPRECV
               - SDIO_INT_CMDSEND
               - SDIO_INT_DATEND
               - SDIO_INT_SBERR
               - SDIO_INT_DATBLKEND
               - SDIO_INT_CMDRUN
               - SDIO_INT_TXRUN
               - SDIO_INT_RXRUN
               - SDIO_INT_TFIFOE
               - SDIO_INT_TFIFOHE
               - SDIO_INT_TFIFOF
               - SDIO_INT_TDATVALID
               - SDIO_INT_RFIFOE
               - SDIO_INT_RFIFOHF
               - SDIO_INT_RFIFOF
               - SDIO_INT_RDATVALID
               - SDIO_INT_SDIOINT
return INTStatus:
           - SET
           - RESET

name   SDIO_CmdShortResponse1.
fun    Send command with argument and check R1 response with timeout.
param  Cmd specifies the command index to be sent.
param  Arg specifies the command argument.
param  timeout timeout value for response, can not be 0.
return SDIO error state

name   SDIO_CmdShortResponse3.
fun    Send command with argument and check R3 response.
param  Cmd specifies the command index to be sent.
param  Arg specifies the command argument.
return SDIO error state

name   SDIO_CmdLongResponse2.
fun    Send command with argument and check the R2 response.
param  Cmd specifies the command index to be sent.
param  Arg specifies the command argument.
return SDIO error state

name   SDIO_CmdBlockLength.
fun    Send the Data Block Length command and check the response
param  BlockSize specifies the SDIO data block length.
return SDIO error state

name   SDIO_CmdBlockCount.
fun    Send the Set Data Block Count command and check the response
param  BlockCnt specifies the SDIO block count.
return SDIO error state

name   SDIO_CmdReadSingleBlock.
fun    Send the Read Single Block command and check the response
param  ReadAdd specifies the start address for reading.
return SDIO error state

name   SDIO_CmdReadMultiBlock.
fun    Send the Read Multi Block command and check the response
param  ReadAdd specifies the start address for reading.
return SDIO error state

name   SDIO_CmdWriteSingleBlock.
fun    Send the Write Single Block command and check the response
param  WriteAdd specifies the start address for writing.
return SDIO error state

name   SDIO_CmdWriteMultiBlock.
fun    Send the Write Multi Block command and check the response
param  WriteAdd specifies the start address for writing.
return SDIO error state

name   SDIO_CmdSDEraseStartAdd.
fun    Send the Start Address Erase command for SD and check the response
param  StartAdd specifies the start address for erasing.
return SDIO error state

name   SDIO_CmdSDEraseEndAdd.
fun    Send the End Address Erase command for SD and check the response
param  EndAdd specifies the end address for erasing.
return SDIO error state

name   SDIO_CmdEraseStartAdd.
fun    Send the Start Address Erase command and check the response
param  StartAdd specifies the start address for erasing.
return SDIO error state

name   SDIO_CmdEraseEndAdd.
fun    Send the End Address Erase command and check the response
param  StartAdd specifies the start address for erasing.
return SDIO error state

name   SDIO_CmdErase.
fun    Send the Erase command and check the response
param  none
return SDIO error state

name   SDIO_CmdLockUnlock.
fun    Send the lock/unlock command and check the response
param  none
return SDIO error state

name   SDIO_CmdStopTransfer.
fun    Send the Stop Transfer command and check the response.
param  none
return SDIO error state

name   SDIO_CmdSelDesel.
fun    Send the Select Deselect command and check the response.
param  RCA: Address of the card to be selected
return SDIO error state

name   SDIO_CmdGoIdleState.
fun    Send the Go Idle State command and check the response.
param  none
return SDIO error state

name   SDIO_CmdOperCond.
fun    Send the Operating Condition command and check the response.
param  none
return SDIO error state

name   SDIO_CmdAppCommand.
fun    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  Arg: Command Argument
return SDIO error state

name   SDIO_CmdAppOperCommand.
fun    Send the command asking the accessed card to send its operating
       condition register (OCR)
param  Arg: Command Argument
return SDIO error state

name   SDIO_CmdBusWidth.
fun    Send the Bus Width command and check the response.
param  BusWidth: Bus width
return SDIO error state

name   SDIO_CmdSendSCR.
fun    Send the Send SCR command and check the response.
param  none
return SDIO error state

name   SDIO_CmdAllSendCID.
fun    Send the Send all CID command and check the response.
param  none
return SDIO error state

name   SDIO_CmdSendCID.
fun    Send the Send CID command and check the response.
param  RCA: Card RCA
return SDIO error state

name   SDIO_CmdSendCSD.
fun    Send the Send CSD command and check the response.
param  RCA: Card RCA
return SDIO error state

name   SDIO_CmdSetRelAdd.
fun    Send the Set Relative Address command.
param  pRCA: pointer to the Card RCA
return SDIO error state

name   SDIO_CmdSetRelAddMmc.
fun    Send the Set Relative Address command to MMC card (not SD card).
param  RCA: Card RCA
return SDIO error state

name   SDIO_CmdSendStatus.
fun    Send the Status command and check the response.
param  Arg: command argument
return SDIO error state

name   SDIO_CmdStatusRegister.
fun     Send the Status register command and check the response.
param  none
return SDIO error state

name   SDIO_CmdOpCondition.
fun    Sends host capacity support information and activates the card's
       initialization process by send SDMMC_CMD_SEND_OP_COND command.
param  Arg: command argument
return SDIO error state

name   SDIO_CmdSwitch.
fun    Checks switchable function and switch card function. SDMMC_CMD_HS_SWITCH command
param  Arg: command argument
return SDIO error state

name   SDIO_CmdSendEXTCSD.
fun    Send the Send EXT_CSD command and check the response.
param  Arg: command argument
return SDIO error state

name   SDIO_GetCmdResp1.
fun    Checks for error conditions for R1 response.
param  Cmd: The sent command index
param  Timeout: timeout value， can not be 0.
return SDIO error state

name   SDIO_GetCmdResp2.
fun    Checks for error conditions for R2 (CID or CSD) response.
param  none
return SDIO error state

name   SDIO_GetCmdResp3.
fun    Checks for error conditions for R3 (OCR) response.
param  none
return SDIO error state

name   SDIO_GetCmdResp6
fun    Checks for error conditions for R6 (RCA) response.
param  Cmd: The sent command index
param  pRCA: Pointer to the variable that will contain the SD card relative address RCA
return SDIO error state

name   SDIO_GetCmdResp7
fun    Checks for error conditions for R7 response.
param  none
return SDIO error state