Peripheral Control functions

management functions More...

Collaboration diagram for Peripheral Control functions:

Functions
HAL_StatusTypeDef	HAL_SD_ConfigWideBusOperation (SD_HandleTypeDef *hsd, uint32_t WideMode)
	Enables wide bus operation for the requested card if supported by card.
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_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_SD_ConfigWideBusOperation()

HAL_StatusTypeDef HAL_SD_ConfigWideBusOperation	(	SD_HandleTypeDef *	hsd,
		uint32_t	WideMode )

#include <stm32f4xx_hal_sd.h>

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

Parameters

hsd	Pointer to SD handle
WideMode	Specifies 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

HAL

status

Definition at line 2245 of file stm32f4xx_hal_sd.c.

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

HAL_SD_GetCardCID()

HAL_StatusTypeDef HAL_SD_GetCardCID	(	SD_HandleTypeDef *	hsd,
		HAL_SD_CardCIDTypeDef *	pCID )

#include <stm32f4xx_hal_sd.c>

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

Parameters

hsd	Pointer to SD handle
pCID	Pointer to a HAL_SD_CardCIDTypeDef structure that contains all CID register parameters

Return values

HAL

status

Definition at line 2013 of file stm32f4xx_hal_sd.c.

References SD_HandleTypeDef::CID, HAL_SD_CardCIDTypeDef::CID_CRC, HAL_OK, 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_SD_GetCardCSD()

HAL_StatusTypeDef HAL_SD_GetCardCSD	(	SD_HandleTypeDef *	hsd,
		HAL_SD_CardCSDTypeDef *	pCSD )

#include <stm32f4xx_hal_sd.c>

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

Parameters

hsd	Pointer to SD handle
pCSD	Pointer to a HAL_SD_CardCSDTypeDef structure that contains all CSD register parameters

Return values

HAL

status

< Reserved

Definition at line 2046 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::FileFormatGroup, HAL_ERROR, HAL_OK, 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_SD_GetCardStatus()

HAL_StatusTypeDef HAL_SD_GetCardStatus	(	SD_HandleTypeDef *	hsd,
		HAL_SD_CardStatusTypeDef *	pStatus )

#include <stm32f4xx_hal_sd.c>

Gets the SD status info.

Parameters

hsd	Pointer to SD handle
pStatus	Pointer to the HAL_SD_CardStatusTypeDef structure that will contain the SD card status information

Return values

HAL

status

Definition at line 2160 of file stm32f4xx_hal_sd.c.

References __HAL_SD_CLEAR_FLAG, HAL_SD_CardStatusTypeDef::AllocationUnitSize, BLOCKSIZE, HAL_SD_CardStatusTypeDef::CardType, HAL_SD_CardStatusTypeDef::DataBusWidth, HAL_SD_CardStatusTypeDef::EraseOffset, HAL_SD_CardStatusTypeDef::EraseSize, HAL_SD_CardStatusTypeDef::EraseTimeout, SD_HandleTypeDef::ErrorCode, HAL_ERROR, HAL_OK, HAL_SD_ERROR_NONE, HAL_SD_STATE_READY, SD_HandleTypeDef::Instance, HAL_SD_CardStatusTypeDef::PerformanceMove, HAL_SD_CardStatusTypeDef::ProtectedAreaSize, SD_SendSDStatus(), HAL_SD_CardStatusTypeDef::SecuredMode, HAL_SD_CardStatusTypeDef::SpeedClass, and SD_HandleTypeDef::State.

HAL_SD_GetCardInfo()

HAL_StatusTypeDef HAL_SD_GetCardInfo	(	SD_HandleTypeDef *	hsd,
		HAL_SD_CardInfoTypeDef *	pCardInfo )

#include <stm32f4xx_hal_sd.c>

Gets the SD card info.

Parameters

hsd	Pointer to SD handle
pCardInfo	Pointer to the HAL_SD_CardInfoTypeDef structure that will contain the SD card status information

Return values

HAL

status

Definition at line 2220 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_OK, HAL_SD_CardInfoTypeDef::LogBlockNbr, HAL_SD_CardInfoTypeDef::LogBlockSize, HAL_SD_CardInfoTypeDef::RelCardAdd, and SD_HandleTypeDef::SdCard.

HAL_SD_GetCardState()

HAL_SD_CardStateTypeDef HAL_SD_GetCardState

(

SD_HandleTypeDef *

hsd

)

#include <stm32f4xx_hal_sd.c>

Gets the current sd card data state.

Parameters

hsd	pointer to SD handle

Return values

Card

state

Definition at line 2327 of file stm32f4xx_hal_sd.c.

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

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

HAL_SD_Abort()

HAL_StatusTypeDef HAL_SD_Abort

(

SD_HandleTypeDef *

hsd

)

#include <stm32f4xx_hal_sd.c>

Abort the current transfer and disable the SD.

Parameters

hsd	pointer to a SD_HandleTypeDef structure that contains the configuration information for SD module.

Return values

HAL

status

Definition at line 2350 of file stm32f4xx_hal_sd.c.

References __HAL_SD_CLEAR_FLAG, __HAL_SD_DISABLE_IT, SD_HandleTypeDef::Context, SD_HandleTypeDef::ErrorCode, HAL_DMA_Abort(), HAL_ERROR, HAL_OK, HAL_SD_CARD_RECEIVING, HAL_SD_CARD_SENDING, HAL_SD_ERROR_DMA, HAL_SD_ERROR_NONE, HAL_SD_GetCardState(), HAL_SD_STATE_READY, SD_HandleTypeDef::hdmarx, SD_HandleTypeDef::hdmatx, SD_HandleTypeDef::Instance, SD_CONTEXT_DMA, SD_CONTEXT_NONE, SD_CONTEXT_READ_MULTIPLE_BLOCK, SD_CONTEXT_READ_SINGLE_BLOCK, SD_CONTEXT_WRITE_MULTIPLE_BLOCK, SD_CONTEXT_WRITE_SINGLE_BLOCK, and SD_HandleTypeDef::State.

HAL_SD_Abort_IT()

HAL_StatusTypeDef HAL_SD_Abort_IT

(

SD_HandleTypeDef *

hsd

)

#include <stm32f4xx_hal_sd.c>

Abort the current transfer and disable the SD (IT mode).

Parameters

hsd	pointer to a SD_HandleTypeDef structure that contains the configuration information for SD module.

Return values

HAL

status

Definition at line 2414 of file stm32f4xx_hal_sd.c.

References __HAL_SD_CLEAR_FLAG, __HAL_SD_DISABLE_IT, SD_HandleTypeDef::Context, SD_HandleTypeDef::ErrorCode, HAL_DMA_Abort_IT(), HAL_ERROR, HAL_OK, HAL_SD_AbortCallback(), 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, SD_CONTEXT_DMA, SD_CONTEXT_NONE, SD_CONTEXT_READ_MULTIPLE_BLOCK, SD_CONTEXT_READ_SINGLE_BLOCK, SD_CONTEXT_WRITE_MULTIPLE_BLOCK, SD_CONTEXT_WRITE_SINGLE_BLOCK, SD_DMARxAbort(), SD_DMATxAbort(), SD_HandleTypeDef::State, and __DMA_HandleTypeDef::XferAbortCallback.