STM32F4xx HAL Documentation
Hardware Abstraction Layer for STM32F4 familiy
Loading...
Searching...
No Matches
SD Exported Macros

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

Collaboration diagram for SD Exported Macros:

Macros

#define __HAL_SD_RESET_HANDLE_STATE(__HANDLE__)
 Reset SD handle state.
 
#define __HAL_SD_ENABLE(__HANDLE__)
 Enable the SD device.
 
#define __HAL_SD_DISABLE(__HANDLE__)
 Disable the SD device.
 
#define __HAL_SD_DMA_ENABLE(__HANDLE__)
 Enable the SDMMC DMA transfer.
 
#define __HAL_SD_DMA_DISABLE(__HANDLE__)
 Disable the SDMMC DMA transfer.
 
#define __HAL_SD_ENABLE_IT(__HANDLE__, __INTERRUPT__)
 Enable the SD device interrupt.
 
#define __HAL_SD_DISABLE_IT(__HANDLE__, __INTERRUPT__)
 Disable the SD device interrupt.
 
#define __HAL_SD_GET_FLAG(__HANDLE__, __FLAG__)
 Check whether the specified SD flag is set or not.
 
#define __HAL_SD_CLEAR_FLAG(__HANDLE__, __FLAG__)
 Clear the SD's pending flags.
 
#define __HAL_SD_GET_IT(__HANDLE__, __INTERRUPT__)
 Check whether the specified SD interrupt has occurred or not.
 
#define __HAL_SD_CLEAR_IT(__HANDLE__, __INTERRUPT__)
 Clear the SD's interrupt pending bits.
 

Detailed Description

macros to handle interrupts and specific clock configurations

Macro Definition Documentation

◆ __HAL_SD_RESET_HANDLE_STATE

#define __HAL_SD_RESET_HANDLE_STATE ( __HANDLE__)

#include <stm32f4xx_hal_sd.h>

Value:
((__HANDLE__)->State = HAL_SD_STATE_RESET)
@ HAL_SD_STATE_RESET

Reset SD handle state.

Parameters
__HANDLE__: SD handle.
Return values
None

Definition at line 393 of file stm32f4xx_hal_sd.h.

◆ __HAL_SD_ENABLE

#define __HAL_SD_ENABLE ( __HANDLE__)

#include <stm32f4xx_hal_sd.h>

Value:
__SDIO_ENABLE((__HANDLE__)->Instance)

Enable the SD device.

Return values
None

Definition at line 400 of file stm32f4xx_hal_sd.h.

Referenced by HAL_SD_InitCard().

◆ __HAL_SD_DISABLE

#define __HAL_SD_DISABLE ( __HANDLE__)

#include <stm32f4xx_hal_sd.h>

Value:
__SDIO_DISABLE((__HANDLE__)->Instance)

Disable the SD device.

Return values
None

Definition at line 406 of file stm32f4xx_hal_sd.h.

Referenced by HAL_SD_InitCard().

◆ __HAL_SD_DMA_ENABLE

#define __HAL_SD_DMA_ENABLE ( __HANDLE__)

#include <stm32f4xx_hal_sd.h>

Value:
__SDIO_DMA_ENABLE((__HANDLE__)->Instance)

Enable the SDMMC DMA transfer.

Return values
None

Definition at line 412 of file stm32f4xx_hal_sd.h.

Referenced by HAL_SD_ReadBlocks_DMA(), and HAL_SD_WriteBlocks_DMA().

◆ __HAL_SD_DMA_DISABLE

#define __HAL_SD_DMA_DISABLE ( __HANDLE__)

#include <stm32f4xx_hal_sd.h>

Value:
__SDIO_DMA_DISABLE((__HANDLE__)->Instance)

Disable the SDMMC DMA transfer.

Return values
None

Definition at line 418 of file stm32f4xx_hal_sd.h.

◆ __HAL_SD_ENABLE_IT

#define __HAL_SD_ENABLE_IT ( __HANDLE__,
__INTERRUPT__ )

#include <stm32f4xx_hal_sd.h>

Value:
__SDIO_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:
  • SDIO_IT_CCRCFAIL: Command response received (CRC check failed) interrupt
  • SDIO_IT_DCRCFAIL: Data block sent/received (CRC check failed) interrupt
  • SDIO_IT_CTIMEOUT: Command response timeout interrupt
  • SDIO_IT_DTIMEOUT: Data timeout interrupt
  • SDIO_IT_TXUNDERR: Transmit FIFO underrun error interrupt
  • SDIO_IT_RXOVERR: Received FIFO overrun error interrupt
  • SDIO_IT_CMDREND: Command response received (CRC check passed) interrupt
  • SDIO_IT_CMDSENT: Command sent (no response required) interrupt
  • SDIO_IT_DATAEND: Data end (data counter, DATACOUNT, is zero) interrupt
  • SDIO_IT_DBCKEND: Data block sent/received (CRC check passed) interrupt
  • SDIO_IT_CMDACT: Command transfer in progress interrupt
  • SDIO_IT_TXACT: Data transmit in progress interrupt
  • SDIO_IT_RXACT: Data receive in progress interrupt
  • SDIO_IT_TXFIFOHE: Transmit FIFO Half Empty interrupt
  • SDIO_IT_RXFIFOHF: Receive FIFO Half Full interrupt
  • SDIO_IT_TXFIFOF: Transmit FIFO full interrupt
  • SDIO_IT_RXFIFOF: Receive FIFO full interrupt
  • SDIO_IT_TXFIFOE: Transmit FIFO empty interrupt
  • SDIO_IT_RXFIFOE: Receive FIFO empty interrupt
  • SDIO_IT_TXDAVL: Data available in transmit FIFO interrupt
  • SDIO_IT_RXDAVL: Data available in receive FIFO interrupt
  • SDIO_IT_SDIOIT: SDIO interrupt received interrupt
Return values
None

Definition at line 449 of file stm32f4xx_hal_sd.h.

Referenced by HAL_SD_ReadBlocks_DMA(), HAL_SD_ReadBlocks_IT(), HAL_SD_WriteBlocks_DMA(), HAL_SD_WriteBlocks_IT(), and SD_DMATransmitCplt().

◆ __HAL_SD_DISABLE_IT

#define __HAL_SD_DISABLE_IT ( __HANDLE__,
__INTERRUPT__ )

#include <stm32f4xx_hal_sd.h>

Value:
__SDIO_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:
  • SDIO_IT_CCRCFAIL: Command response received (CRC check failed) interrupt
  • SDIO_IT_DCRCFAIL: Data block sent/received (CRC check failed) interrupt
  • SDIO_IT_CTIMEOUT: Command response timeout interrupt
  • SDIO_IT_DTIMEOUT: Data timeout interrupt
  • SDIO_IT_TXUNDERR: Transmit FIFO underrun error interrupt
  • SDIO_IT_RXOVERR: Received FIFO overrun error interrupt
  • SDIO_IT_CMDREND: Command response received (CRC check passed) interrupt
  • SDIO_IT_CMDSENT: Command sent (no response required) interrupt
  • SDIO_IT_DATAEND: Data end (data counter, DATACOUNT, is zero) interrupt
  • SDIO_IT_DBCKEND: Data block sent/received (CRC check passed) interrupt
  • SDIO_IT_CMDACT: Command transfer in progress interrupt
  • SDIO_IT_TXACT: Data transmit in progress interrupt
  • SDIO_IT_RXACT: Data receive in progress interrupt
  • SDIO_IT_TXFIFOHE: Transmit FIFO Half Empty interrupt
  • SDIO_IT_RXFIFOHF: Receive FIFO Half Full interrupt
  • SDIO_IT_TXFIFOF: Transmit FIFO full interrupt
  • SDIO_IT_RXFIFOF: Receive FIFO full interrupt
  • SDIO_IT_TXFIFOE: Transmit FIFO empty interrupt
  • SDIO_IT_RXFIFOE: Receive FIFO empty interrupt
  • SDIO_IT_TXDAVL: Data available in transmit FIFO interrupt
  • SDIO_IT_RXDAVL: Data available in receive FIFO interrupt
  • SDIO_IT_SDIOIT: SDIO interrupt received interrupt
Return values
None

Definition at line 480 of file stm32f4xx_hal_sd.h.

Referenced by HAL_SD_Abort(), HAL_SD_Abort_IT(), HAL_SD_IRQHandler(), HAL_SD_ReadBlocks_DMA(), HAL_SD_WriteBlocks_DMA(), and SD_DMAError().

◆ __HAL_SD_GET_FLAG

#define __HAL_SD_GET_FLAG ( __HANDLE__,
__FLAG__ )

#include <stm32f4xx_hal_sd.h>

Value:
__SDIO_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:
  • SDIO_FLAG_CCRCFAIL: Command response received (CRC check failed)
  • SDIO_FLAG_DCRCFAIL: Data block sent/received (CRC check failed)
  • SDIO_FLAG_CTIMEOUT: Command response timeout
  • SDIO_FLAG_DTIMEOUT: Data timeout
  • SDIO_FLAG_TXUNDERR: Transmit FIFO underrun error
  • SDIO_FLAG_RXOVERR: Received FIFO overrun error
  • SDIO_FLAG_CMDREND: Command response received (CRC check passed)
  • SDIO_FLAG_CMDSENT: Command sent (no response required)
  • SDIO_FLAG_DATAEND: Data end (data counter, DATACOUNT, is zero)
  • SDIO_FLAG_DBCKEND: Data block sent/received (CRC check passed)
  • SDIO_FLAG_CMDACT: Command transfer in progress
  • SDIO_FLAG_TXACT: Data transmit in progress
  • SDIO_FLAG_RXACT: Data receive in progress
  • SDIO_FLAG_TXFIFOHE: Transmit FIFO Half Empty
  • SDIO_FLAG_RXFIFOHF: Receive FIFO Half Full
  • SDIO_FLAG_TXFIFOF: Transmit FIFO full
  • SDIO_FLAG_RXFIFOF: Receive FIFO full
  • SDIO_FLAG_TXFIFOE: Transmit FIFO empty
  • SDIO_FLAG_RXFIFOE: Receive FIFO empty
  • SDIO_FLAG_TXDAVL: Data available in transmit FIFO
  • SDIO_FLAG_RXDAVL: Data available in receive FIFO
  • SDIO_FLAG_SDIOIT: SDIO interrupt received
Return values
Thenew state of SD FLAG (SET or RESET).

Definition at line 511 of file stm32f4xx_hal_sd.h.

Referenced by HAL_SD_IRQHandler(), HAL_SD_ReadBlocks(), HAL_SD_WriteBlocks(), SD_FindSCR(), and SD_SendSDStatus().

◆ __HAL_SD_CLEAR_FLAG

#define __HAL_SD_CLEAR_FLAG ( __HANDLE__,
__FLAG__ )

#include <stm32f4xx_hal_sd.h>

Value:
__SDIO_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:
  • SDIO_FLAG_CCRCFAIL: Command response received (CRC check failed)
  • SDIO_FLAG_DCRCFAIL: Data block sent/received (CRC check failed)
  • SDIO_FLAG_CTIMEOUT: Command response timeout
  • SDIO_FLAG_DTIMEOUT: Data timeout
  • SDIO_FLAG_TXUNDERR: Transmit FIFO underrun error
  • SDIO_FLAG_RXOVERR: Received FIFO overrun error
  • SDIO_FLAG_CMDREND: Command response received (CRC check passed)
  • SDIO_FLAG_CMDSENT: Command sent (no response required)
  • SDIO_FLAG_DATAEND: Data end (data counter, DATACOUNT, is zero)
  • SDIO_FLAG_DBCKEND: Data block sent/received (CRC check passed)
  • SDIO_FLAG_SDIOIT: SDIO interrupt received
Return values
None

Definition at line 531 of file stm32f4xx_hal_sd.h.

Referenced by HAL_SD_Abort(), HAL_SD_Abort_IT(), HAL_SD_ConfigWideBusOperation(), HAL_SD_Erase(), HAL_SD_GetCardCSD(), HAL_SD_GetCardStatus(), HAL_SD_InitCard(), HAL_SD_IRQHandler(), HAL_SD_ReadBlocks(), HAL_SD_ReadBlocks_DMA(), HAL_SD_ReadBlocks_IT(), HAL_SD_WriteBlocks(), HAL_SD_WriteBlocks_DMA(), HAL_SD_WriteBlocks_IT(), SD_DMAError(), SD_DMAReceiveCplt(), SD_DMARxAbort(), SD_DMATxAbort(), SD_FindSCR(), and SD_SendSDStatus().

◆ __HAL_SD_GET_IT

#define __HAL_SD_GET_IT ( __HANDLE__,
__INTERRUPT__ )

#include <stm32f4xx_hal_sd.h>

Value:
__SDIO_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:
  • SDIO_IT_CCRCFAIL: Command response received (CRC check failed) interrupt
  • SDIO_IT_DCRCFAIL: Data block sent/received (CRC check failed) interrupt
  • SDIO_IT_CTIMEOUT: Command response timeout interrupt
  • SDIO_IT_DTIMEOUT: Data timeout interrupt
  • SDIO_IT_TXUNDERR: Transmit FIFO underrun error interrupt
  • SDIO_IT_RXOVERR: Received FIFO overrun error interrupt
  • SDIO_IT_CMDREND: Command response received (CRC check passed) interrupt
  • SDIO_IT_CMDSENT: Command sent (no response required) interrupt
  • SDIO_IT_DATAEND: Data end (data counter, DATACOUNT, is zero) interrupt
  • SDIO_IT_DBCKEND: Data block sent/received (CRC check passed) interrupt
  • SDIO_IT_CMDACT: Command transfer in progress interrupt
  • SDIO_IT_TXACT: Data transmit in progress interrupt
  • SDIO_IT_RXACT: Data receive in progress interrupt
  • SDIO_IT_TXFIFOHE: Transmit FIFO Half Empty interrupt
  • SDIO_IT_RXFIFOHF: Receive FIFO Half Full interrupt
  • SDIO_IT_TXFIFOF: Transmit FIFO full interrupt
  • SDIO_IT_RXFIFOF: Receive FIFO full interrupt
  • SDIO_IT_TXFIFOE: Transmit FIFO empty interrupt
  • SDIO_IT_RXFIFOE: Receive FIFO empty interrupt
  • SDIO_IT_TXDAVL: Data available in transmit FIFO interrupt
  • SDIO_IT_RXDAVL: Data available in receive FIFO interrupt
  • SDIO_IT_SDIOIT: SDIO interrupt received interrupt
Return values
Thenew state of SD IT (SET or RESET).

Definition at line 562 of file stm32f4xx_hal_sd.h.

◆ __HAL_SD_CLEAR_IT

#define __HAL_SD_CLEAR_IT ( __HANDLE__,
__INTERRUPT__ )

#include <stm32f4xx_hal_sd.h>

Value:
__SDIO_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:
  • SDIO_IT_CCRCFAIL: Command response received (CRC check failed) interrupt
  • SDIO_IT_DCRCFAIL: Data block sent/received (CRC check failed) interrupt
  • SDIO_IT_CTIMEOUT: Command response timeout interrupt
  • SDIO_IT_DTIMEOUT: Data timeout interrupt
  • SDIO_IT_TXUNDERR: Transmit FIFO underrun error interrupt
  • SDIO_IT_RXOVERR: Received FIFO overrun error interrupt
  • SDIO_IT_CMDREND: Command response received (CRC check passed) interrupt
  • SDIO_IT_CMDSENT: Command sent (no response required) interrupt
  • SDIO_IT_DATAEND: Data end (data counter, DATACOUNT, is zero) interrupt
  • SDIO_IT_SDIOIT: SDIO interrupt received interrupt
Return values
None

Definition at line 581 of file stm32f4xx_hal_sd.h.