STM32F439xx HAL User Manual
Functions
Peripheral Control functions
SD Exported Functions

management functions More...

Functions

HAL_StatusTypeDef HAL_SD_GetCardCID (SD_HandleTypeDef *hsd, HAL_SD_CardCIDTypeDef *pCID)
 Returns information the information of the card which are stored on the CID register.
HAL_StatusTypeDef HAL_SD_GetCardCSD (SD_HandleTypeDef *hsd, HAL_SD_CardCSDTypeDef *pCSD)
 Returns information the information of the card which are stored on the CSD register.
HAL_StatusTypeDef HAL_SD_GetCardStatus (SD_HandleTypeDef *hsd, HAL_SD_CardStatusTypeDef *pStatus)
 Gets the SD status info.
HAL_StatusTypeDef HAL_SD_GetCardInfo (SD_HandleTypeDef *hsd, HAL_SD_CardInfoTypeDef *pCardInfo)
 Gets the SD card info.
HAL_StatusTypeDef HAL_SD_ConfigWideBusOperation (SD_HandleTypeDef *hsd, uint32_t WideMode)
 Enables wide bus operation for the requested card if supported by card.
HAL_SD_CardStateTypeDef HAL_SD_GetCardState (SD_HandleTypeDef *hsd)
 Gets the current sd card data state.
HAL_StatusTypeDef HAL_SD_Abort (SD_HandleTypeDef *hsd)
 Abort the current transfer and disable the SD.
HAL_StatusTypeDef HAL_SD_Abort_IT (SD_HandleTypeDef *hsd)
 Abort the current transfer and disable the SD (IT mode).

Detailed Description

management functions

  ==============================================================================
                      ##### Peripheral Control functions #####
  ==============================================================================  
  [..]
    This subsection provides a set of functions allowing to control the SD card 
    operations and get the related information


Function Documentation

HAL_StatusTypeDef HAL_SD_Abort ( SD_HandleTypeDef hsd)

Abort the current transfer and disable the SD.

Parameters:
hsdpointer to a SD_HandleTypeDef structure that contains the configuration information for SD module.
Return values:
HALstatus

Definition at line 2168 of file stm32f4xx_hal_sd.c.

References __HAL_SD_CLEAR_FLAG, __HAL_SD_DISABLE_IT, SD_HandleTypeDef::ErrorCode, HAL_DMA_Abort(), HAL_SD_CARD_RECEIVING, HAL_SD_CARD_SENDING, HAL_SD_ERROR_NONE, HAL_SD_GetCardState(), HAL_SD_STATE_READY, SD_HandleTypeDef::hdmarx, SD_HandleTypeDef::hdmatx, SD_HandleTypeDef::Instance, and SD_HandleTypeDef::State.

HAL_StatusTypeDef HAL_SD_Abort_IT ( SD_HandleTypeDef hsd)
HAL_StatusTypeDef HAL_SD_ConfigWideBusOperation ( SD_HandleTypeDef hsd,
uint32_t  WideMode 
)

Enables wide bus operation for the requested card if supported by card.

Parameters:
hsdPointer to SD handle
WideModeSpecifies the SD card wide bus mode This parameter can be one of the following values:
  • SDIO_BUS_WIDE_8B: 8-bit data transfer
  • SDIO_BUS_WIDE_4B: 4-bit data transfer
  • SDIO_BUS_WIDE_1B: 1-bit data transfer
Return values:
HALstatus

Definition at line 2073 of file stm32f4xx_hal_sd.c.

References __HAL_SD_CLEAR_FLAG, assert_param, CARD_SECURED, HAL_SD_CardInfoTypeDef::CardType, SD_HandleTypeDef::ErrorCode, HAL_SD_ERROR_NONE, HAL_SD_ERROR_PARAM, HAL_SD_ERROR_UNSUPPORTED_FEATURE, HAL_SD_STATE_BUSY, HAL_SD_STATE_READY, SD_HandleTypeDef::Init, __SAI_HandleTypeDef::Init, SD_HandleTypeDef::Instance, SD_WideBus_Disable(), SD_WideBus_Enable(), SD_HandleTypeDef::SdCard, and SD_HandleTypeDef::State.

HAL_StatusTypeDef HAL_SD_GetCardCID ( SD_HandleTypeDef hsd,
HAL_SD_CardCIDTypeDef pCID 
)

Returns information the information of the card which are stored on the CID register.

Parameters:
hsdPointer to SD handle
pCIDPointer to a HAL_SD_CIDTypeDef structure that contains all CID register parameters
Return values:
HALstatus

Definition at line 1732 of file stm32f4xx_hal_sd.c.

References SD_HandleTypeDef::CID, HAL_SD_CardCIDTypeDef::CID_CRC, HAL_SD_CardCIDTypeDef::ManufactDate, HAL_SD_CardCIDTypeDef::ManufacturerID, HAL_SD_CardCIDTypeDef::OEM_AppliID, HAL_SD_CardCIDTypeDef::ProdName1, HAL_SD_CardCIDTypeDef::ProdName2, HAL_SD_CardCIDTypeDef::ProdRev, HAL_SD_CardCIDTypeDef::ProdSN, HAL_SD_CardCIDTypeDef::Reserved1, and HAL_SD_CardCIDTypeDef::Reserved2.

HAL_StatusTypeDef HAL_SD_GetCardCSD ( SD_HandleTypeDef hsd,
HAL_SD_CardCSDTypeDef pCSD 
)

Returns information the information of the card which are stored on the CSD register.

Parameters:
hsdPointer to SD handle
pCSDPointer to a HAL_SD_CardCSDTypeDef structure that contains all CSD register parameters
Return values:
HALstatus

< Reserved

Definition at line 1813 of file stm32f4xx_hal_sd.c.

References __HAL_SD_CLEAR_FLAG, HAL_SD_CardInfoTypeDef::BlockNbr, HAL_SD_CardInfoTypeDef::BlockSize, CARD_SDHC_SDXC, CARD_SDSC, HAL_SD_CardCSDTypeDef::CardComdClasses, HAL_SD_CardInfoTypeDef::CardType, HAL_SD_CardCSDTypeDef::ContentProtectAppli, HAL_SD_CardCSDTypeDef::CopyFlag, SD_HandleTypeDef::CSD, HAL_SD_CardCSDTypeDef::CSD_CRC, HAL_SD_CardCSDTypeDef::CSDStruct, HAL_SD_CardCSDTypeDef::DeviceSize, HAL_SD_CardCSDTypeDef::DeviceSizeMul, HAL_SD_CardCSDTypeDef::DSRImpl, HAL_SD_CardCSDTypeDef::ECC, HAL_SD_CardCSDTypeDef::EraseGrMul, HAL_SD_CardCSDTypeDef::EraseGrSize, SD_HandleTypeDef::ErrorCode, HAL_SD_CardCSDTypeDef::FileFormat, HAL_SD_CardCSDTypeDef::FileFormatGrouop, HAL_SD_ERROR_UNSUPPORTED_FEATURE, HAL_SD_STATE_READY, HAL_SD_CardInfoTypeDef::LogBlockNbr, HAL_SD_CardInfoTypeDef::LogBlockSize, HAL_SD_CardCSDTypeDef::ManDeflECC, HAL_SD_CardCSDTypeDef::MaxBusClkFrec, HAL_SD_CardCSDTypeDef::MaxRdCurrentVDDMax, HAL_SD_CardCSDTypeDef::MaxRdCurrentVDDMin, HAL_SD_CardCSDTypeDef::MaxWrBlockLen, HAL_SD_CardCSDTypeDef::MaxWrCurrentVDDMax, HAL_SD_CardCSDTypeDef::MaxWrCurrentVDDMin, HAL_SD_CardCSDTypeDef::NSAC, HAL_SD_CardCSDTypeDef::PartBlockRead, HAL_SD_CardCSDTypeDef::PermWrProtect, HAL_SD_CardCSDTypeDef::RdBlockLen, HAL_SD_CardCSDTypeDef::RdBlockMisalign, HAL_SD_CardCSDTypeDef::Reserved1, HAL_SD_CardCSDTypeDef::Reserved2, HAL_SD_CardCSDTypeDef::Reserved3, HAL_SD_CardCSDTypeDef::Reserved4, SD_HandleTypeDef::SdCard, SD_HandleTypeDef::State, HAL_SD_CardCSDTypeDef::SysSpecVersion, HAL_SD_CardCSDTypeDef::TAAC, HAL_SD_CardCSDTypeDef::TempWrProtect, HAL_SD_CardCSDTypeDef::WrBlockMisalign, HAL_SD_CardCSDTypeDef::WriteBlockPaPartial, HAL_SD_CardCSDTypeDef::WrProtectGrEnable, HAL_SD_CardCSDTypeDef::WrProtectGrSize, and HAL_SD_CardCSDTypeDef::WrSpeedFact.

Referenced by SD_InitCard().

HAL_StatusTypeDef HAL_SD_GetCardInfo ( SD_HandleTypeDef hsd,
HAL_SD_CardInfoTypeDef pCardInfo 
)

Gets the SD card info.

Parameters:
hsdPointer to SD handle
pCardInfoPointer to the HAL_SD_CardInfoTypeDef structure that will contain the SD card status information
Return values:
HALstatus

Definition at line 2048 of file stm32f4xx_hal_sd.c.

References HAL_SD_CardInfoTypeDef::BlockNbr, HAL_SD_CardInfoTypeDef::BlockSize, HAL_SD_CardInfoTypeDef::CardType, HAL_SD_CardInfoTypeDef::CardVersion, HAL_SD_CardInfoTypeDef::Class, HAL_SD_CardInfoTypeDef::LogBlockNbr, HAL_SD_CardInfoTypeDef::LogBlockSize, HAL_SD_CardInfoTypeDef::RelCardAdd, and SD_HandleTypeDef::SdCard.

Gets the current sd card data state.

Parameters:
hsdpointer to SD handle
Return values:
Cardstate

Definition at line 2145 of file stm32f4xx_hal_sd.c.

References SD_HandleTypeDef::ErrorCode, HAL_SD_CARD_TRANSFER, HAL_SD_ERROR_NONE, and SD_SendStatus().

Referenced by HAL_SD_Abort(), HAL_SD_Abort_IT(), SD_DMAError(), SD_DMARxAbort(), and SD_DMATxAbort().

HAL_StatusTypeDef HAL_SD_GetCardStatus ( SD_HandleTypeDef hsd,
HAL_SD_CardStatusTypeDef pStatus 
)