SD Exported Macros

macros to handle interrupts and specific clock configurations More...

Macros
#define	__HAL_SD_RESET_HANDLE_STATE(__HANDLE__)   ((__HANDLE__)->State = HAL_SD_STATE_RESET)
	Reset SD handle state.
#define	__HAL_SD_ENABLE_IT(__HANDLE__, __INTERRUPT__)   __SDMMC_ENABLE_IT((__HANDLE__)->Instance, (__INTERRUPT__))
	Enable the SD device interrupt.
#define	__HAL_SD_DISABLE_IT(__HANDLE__, __INTERRUPT__)   __SDMMC_DISABLE_IT((__HANDLE__)->Instance, (__INTERRUPT__))
	Disable the SD device interrupt.
#define	__HAL_SD_GET_FLAG(__HANDLE__, __FLAG__)   __SDMMC_GET_FLAG((__HANDLE__)->Instance, (__FLAG__))
	Check whether the specified SD flag is set or not.
#define	__HAL_SD_CLEAR_FLAG(__HANDLE__, __FLAG__)   __SDMMC_CLEAR_FLAG((__HANDLE__)->Instance, (__FLAG__))
	Clear the SD's pending flags.
#define	__HAL_SD_GET_IT(__HANDLE__, __INTERRUPT__)   __SDMMC_GET_IT((__HANDLE__)->Instance, (__INTERRUPT__))
	Check whether the specified SD interrupt has occurred or not.
#define	__HAL_SD_CLEAR_IT(__HANDLE__, __INTERRUPT__)   __SDMMC_CLEAR_IT((__HANDLE__)->Instance, (__INTERRUPT__))
	Clear the SD's interrupt pending bits.

Detailed Description

macros to handle interrupts and specific clock configurations

Macro Definition Documentation

__HAL_SD_CLEAR_FLAG

#define __HAL_SD_CLEAR_FLAG	(		__HANDLE__,
			__FLAG__
	)		__SDMMC_CLEAR_FLAG((__HANDLE__)->Instance, (__FLAG__))

Clear the SD's pending flags.

Parameters

__HANDLE__

SD Handle.

__FLAG__

specifies the flag to clear. This parameter can be one or a combination of the following values: SDMMC_FLAG_CCRCFAIL: Command response received (CRC check failed) SDMMC_FLAG_DCRCFAIL: Data block sent/received (CRC check failed) SDMMC_FLAG_CTIMEOUT: Command response timeout SDMMC_FLAG_DTIMEOUT: Data timeout SDMMC_FLAG_TXUNDERR: Transmit FIFO underrun error SDMMC_FLAG_RXOVERR: Received FIFO overrun error SDMMC_FLAG_CMDREND: Command response received (CRC check passed) SDMMC_FLAG_CMDSENT: Command sent (no response required) SDMMC_FLAG_DATAEND: Data end (data counter, DATACOUNT, is zero) SDMMC_FLAG_DHOLD: Data transfer Hold SDMMC_FLAG_DBCKEND: Data block sent/received (CRC check passed) SDMMC_FLAG_DABORT: Data transfer aborted by CMD12 SDMMC_FLAG_BUSYD0END: End of SDMMC_D0 Busy following a CMD response detected SDMMC_FLAG_SDIOIT: SDIO interrupt received SDMMC_FLAG_ACKFAIL: Boot Acknowledgment received SDMMC_FLAG_ACKTIMEOUT: Boot Acknowledgment timeout SDMMC_FLAG_VSWEND: Voltage switch critical timing section completion SDMMC_FLAG_CKSTOP: SDMMC_CK stopped in Voltage switch procedure SDMMC_FLAG_IDMATE: IDMA transfer error SDMMC_FLAG_IDMABTC: IDMA buffer transfer complete

Return values

None

__HAL_SD_CLEAR_IT

#define __HAL_SD_CLEAR_IT	(		__HANDLE__,
			__INTERRUPT__
	)		__SDMMC_CLEAR_IT((__HANDLE__)->Instance, (__INTERRUPT__))

Clear the SD's interrupt pending bits.

Parameters

__HANDLE__

SD Handle.

__INTERRUPT__

specifies the interrupt pending bit to clear. This parameter can be one or a combination of the following values: SDMMC_IT_CCRCFAIL: Command response received (CRC check failed) interrupt SDMMC_IT_DCRCFAIL: Data block sent/received (CRC check failed) interrupt SDMMC_IT_CTIMEOUT: Command response timeout interrupt SDMMC_IT_DTIMEOUT: Data timeout interrupt SDMMC_IT_TXUNDERR: Transmit FIFO underrun error interrupt SDMMC_IT_RXOVERR: Received FIFO overrun error interrupt SDMMC_IT_CMDREND: Command response received (CRC check passed) interrupt SDMMC_IT_CMDSENT: Command sent (no response required) interrupt SDMMC_IT_DATAEND: Data end (data counter, DATACOUNT, is zero) interrupt SDMMC_IT_DHOLD: Data transfer Hold interrupt SDMMC_IT_DBCKEND: Data block sent/received (CRC check passed) interrupt SDMMC_IT_DABORT: Data transfer aborted by CMD12 interrupt SDMMC_IT_BUSYD0END: End of SDMMC_D0 Busy following a CMD response detected interrupt SDMMC_IT_SDIOIT: SDIO interrupt received interrupt SDMMC_IT_ACKFAIL: Boot Acknowledgment received interrupt SDMMC_IT_ACKTIMEOUT: Boot Acknowledgment timeout interrupt SDMMC_IT_VSWEND: Voltage switch critical timing section completion interrupt SDMMC_IT_CKSTOP: SDMMC_CK stopped in Voltage switch procedure interrupt SDMMC_IT_IDMABTC: IDMA buffer transfer complete interrupt

Return values

None

__HAL_SD_DISABLE_IT

#define __HAL_SD_DISABLE_IT	(		__HANDLE__,
			__INTERRUPT__
	)		__SDMMC_DISABLE_IT((__HANDLE__)->Instance, (__INTERRUPT__))

Disable the SD device interrupt.

Parameters

__HANDLE__

SD Handle.

__INTERRUPT__

specifies the SDMMC interrupt sources to be disabled. This parameter can be one or a combination of the following values: SDMMC_IT_CCRCFAIL: Command response received (CRC check failed) interrupt SDMMC_IT_DCRCFAIL: Data block sent/received (CRC check failed) interrupt SDMMC_IT_CTIMEOUT: Command response timeout interrupt SDMMC_IT_DTIMEOUT: Data timeout interrupt SDMMC_IT_TXUNDERR: Transmit FIFO underrun error interrupt SDMMC_IT_RXOVERR: Received FIFO overrun error interrupt SDMMC_IT_CMDREND: Command response received (CRC check passed) interrupt SDMMC_IT_CMDSENT: Command sent (no response required) interrupt SDMMC_IT_DATAEND: Data end (data counter, DATACOUNT, is zero) interrupt SDMMC_IT_DHOLD: Data transfer Hold interrupt SDMMC_IT_DBCKEND: Data block sent/received (CRC check passed) interrupt SDMMC_IT_DABORT: Data transfer aborted by CMD12 interrupt SDMMC_IT_TXFIFOHE: Transmit FIFO Half Empty interrupt SDMMC_IT_RXFIFOHF: Receive FIFO Half Full interrupt SDMMC_IT_RXFIFOF: Receive FIFO full interrupt SDMMC_IT_TXFIFOE: Transmit FIFO empty interrupt SDMMC_IT_BUSYD0END: End of SDMMC_D0 Busy following a CMD response detected interrupt SDMMC_IT_SDIOIT: SDIO interrupt received interrupt SDMMC_IT_ACKFAIL: Boot Acknowledgment received interrupt SDMMC_IT_ACKTIMEOUT: Boot Acknowledgment timeout interrupt SDMMC_IT_VSWEND: Voltage switch critical timing section completion interrupt SDMMC_IT_CKSTOP: SDMMC_CK stopped in Voltage switch procedure interrupt SDMMC_IT_IDMABTC: IDMA buffer transfer complete interrupt

Return values

None

__HAL_SD_ENABLE_IT

#define __HAL_SD_ENABLE_IT	(		__HANDLE__,
			__INTERRUPT__
	)		__SDMMC_ENABLE_IT((__HANDLE__)->Instance, (__INTERRUPT__))

Enable the SD device interrupt.

Parameters

__HANDLE__

SD Handle.

__INTERRUPT__

specifies the SDMMC interrupt sources to be enabled. This parameter can be one or a combination of the following values: SDMMC_IT_CCRCFAIL: Command response received (CRC check failed) interrupt SDMMC_IT_DCRCFAIL: Data block sent/received (CRC check failed) interrupt SDMMC_IT_CTIMEOUT: Command response timeout interrupt SDMMC_IT_DTIMEOUT: Data timeout interrupt SDMMC_IT_TXUNDERR: Transmit FIFO underrun error interrupt SDMMC_IT_RXOVERR: Received FIFO overrun error interrupt SDMMC_IT_CMDREND: Command response received (CRC check passed) interrupt SDMMC_IT_CMDSENT: Command sent (no response required) interrupt SDMMC_IT_DATAEND: Data end (data counter, DATACOUNT, is zero) interrupt SDMMC_IT_DHOLD: Data transfer Hold interrupt SDMMC_IT_DBCKEND: Data block sent/received (CRC check passed) interrupt SDMMC_IT_DABORT: Data transfer aborted by CMD12 interrupt SDMMC_IT_TXFIFOHE: Transmit FIFO Half Empty interrupt SDMMC_IT_RXFIFOHF: Receive FIFO Half Full interrupt SDMMC_IT_RXFIFOF: Receive FIFO full interrupt SDMMC_IT_TXFIFOE: Transmit FIFO empty interrupt SDMMC_IT_BUSYD0END: End of SDMMC_D0 Busy following a CMD response detected interrupt SDMMC_IT_SDIOIT: SDIO interrupt received interrupt SDMMC_IT_ACKFAIL: Boot Acknowledgment received interrupt SDMMC_IT_ACKTIMEOUT: Boot Acknowledgment timeout interrupt SDMMC_IT_VSWEND: Voltage switch critical timing section completion interrupt SDMMC_IT_CKSTOP: SDMMC_CK stopped in Voltage switch procedure interrupt SDMMC_IT_IDMABTC: IDMA buffer transfer complete interrupt

Return values

None

__HAL_SD_GET_FLAG

#define __HAL_SD_GET_FLAG	(		__HANDLE__,
			__FLAG__
	)		__SDMMC_GET_FLAG((__HANDLE__)->Instance, (__FLAG__))

Check whether the specified SD flag is set or not.

Parameters

__HANDLE__

SD Handle.

__FLAG__

specifies the flag to check. This parameter can be one of the following values: SDMMC_FLAG_CCRCFAIL: Command response received (CRC check failed) SDMMC_FLAG_DCRCFAIL: Data block sent/received (CRC check failed) SDMMC_FLAG_CTIMEOUT: Command response timeout SDMMC_FLAG_DTIMEOUT: Data timeout SDMMC_FLAG_TXUNDERR: Transmit FIFO underrun error SDMMC_FLAG_RXOVERR: Received FIFO overrun error SDMMC_FLAG_CMDREND: Command response received (CRC check passed) SDMMC_FLAG_CMDSENT: Command sent (no response required) SDMMC_FLAG_DATAEND: Data end (data counter, DATACOUNT, is zero) SDMMC_FLAG_DHOLD: Data transfer Hold SDMMC_FLAG_DBCKEND: Data block sent/received (CRC check passed) SDMMC_FLAG_DABORT: Data transfer aborted by CMD12 SDMMC_FLAG_DPSMACT: Data path state machine active SDMMC_FLAG_CPSMACT: Command path state machine active SDMMC_FLAG_TXFIFOHE: Transmit FIFO Half Empty SDMMC_FLAG_RXFIFOHF: Receive FIFO Half Full SDMMC_FLAG_TXFIFOF: Transmit FIFO full SDMMC_FLAG_RXFIFOF: Receive FIFO full SDMMC_FLAG_TXFIFOE: Transmit FIFO empty SDMMC_FLAG_RXFIFOE: Receive FIFO empty SDMMC_FLAG_BUSYD0: Inverted value of SDMMC_D0 line (Busy) SDMMC_FLAG_BUSYD0END: End of SDMMC_D0 Busy following a CMD response detected SDMMC_FLAG_SDIOIT: SDIO interrupt received SDMMC_FLAG_ACKFAIL: Boot Acknowledgment received SDMMC_FLAG_ACKTIMEOUT: Boot Acknowledgment timeout SDMMC_FLAG_VSWEND: Voltage switch critical timing section completion SDMMC_FLAG_CKSTOP: SDMMC_CK stopped in Voltage switch procedure SDMMC_FLAG_IDMATE: IDMA transfer error SDMMC_FLAG_IDMABTC: IDMA buffer transfer complete

Return values

The	new state of SD FLAG (SET or RESET).

__HAL_SD_GET_IT

#define __HAL_SD_GET_IT	(		__HANDLE__,
			__INTERRUPT__
	)		__SDMMC_GET_IT((__HANDLE__)->Instance, (__INTERRUPT__))

Check whether the specified SD interrupt has occurred or not.

Parameters

__HANDLE__

SD Handle.

__INTERRUPT__

specifies the SDMMC interrupt source to check. This parameter can be one of the following values: SDMMC_IT_CCRCFAIL: Command response received (CRC check failed) interrupt SDMMC_IT_DCRCFAIL: Data block sent/received (CRC check failed) interrupt SDMMC_IT_CTIMEOUT: Command response timeout interrupt SDMMC_IT_DTIMEOUT: Data timeout interrupt SDMMC_IT_TXUNDERR: Transmit FIFO underrun error interrupt SDMMC_IT_RXOVERR: Received FIFO overrun error interrupt SDMMC_IT_CMDREND: Command response received (CRC check passed) interrupt SDMMC_IT_CMDSENT: Command sent (no response required) interrupt SDMMC_IT_DATAEND: Data end (data counter, DATACOUNT, is zero) interrupt SDMMC_IT_DHOLD: Data transfer Hold interrupt SDMMC_IT_DBCKEND: Data block sent/received (CRC check passed) interrupt SDMMC_IT_DABORT: Data transfer aborted by CMD12 interrupt SDMMC_IT_TXFIFOHE: Transmit FIFO Half Empty interrupt SDMMC_IT_RXFIFOHF: Receive FIFO Half Full interrupt SDMMC_IT_RXFIFOF: Receive FIFO full interrupt SDMMC_IT_TXFIFOE: Transmit FIFO empty interrupt SDMMC_IT_BUSYD0END: End of SDMMC_D0 Busy following a CMD response detected interrupt SDMMC_IT_SDIOIT: SDIO interrupt received interrupt SDMMC_IT_ACKFAIL: Boot Acknowledgment received interrupt SDMMC_IT_ACKTIMEOUT: Boot Acknowledgment timeout interrupt SDMMC_IT_VSWEND: Voltage switch critical timing section completion interrupt SDMMC_IT_CKSTOP: SDMMC_CK stopped in Voltage switch procedure interrupt SDMMC_IT_IDMABTC: IDMA buffer transfer complete interrupt

Return values

The	new state of SD IT (SET or RESET).

__HAL_SD_RESET_HANDLE_STATE

#define __HAL_SD_RESET_HANDLE_STATE

(

__HANDLE__

)

((__HANDLE__)->State = HAL_SD_STATE_RESET)

Reset SD handle state.

Parameters

__HANDLE__

SD Handle.

Return values

None