STM32746G-Discovery BSP User Manual: STM32746G_DISCOVERY_SD Exported Functions

STM32746G-Discovery BSP Drivers

STM32746G-Discovery BSP User Manual
STM32746G_DISCOVERY_SD Exported Functions

Functions

uint8_t BSP_SD_Init (void)
 Initializes the SD card device.
uint8_t BSP_SD_DeInit (void)
 DeInitializes the SD card device.
uint8_t BSP_SD_ITConfig (void)
 Configures Interrupt mode for SD detection pin.
uint8_t BSP_SD_IsDetected (void)
 Detects if SD card is correctly plugged in the memory slot or not.
uint8_t BSP_SD_ReadBlocks (uint32_t *pData, uint32_t ReadAddr, uint32_t NumOfBlocks, uint32_t Timeout)
 Reads block(s) from a specified address in an SD card, in polling mode.
uint8_t BSP_SD_WriteBlocks (uint32_t *pData, uint32_t WriteAddr, uint32_t NumOfBlocks, uint32_t Timeout)
 Writes block(s) to a specified address in an SD card, in polling mode.
uint8_t BSP_SD_ReadBlocks_DMA (uint32_t *pData, uint32_t ReadAddr, uint32_t NumOfBlocks)
 Reads block(s) from a specified address in an SD card, in DMA mode.
uint8_t BSP_SD_WriteBlocks_DMA (uint32_t *pData, uint32_t WriteAddr, uint32_t NumOfBlocks)
 Writes block(s) to a specified address in an SD card, in DMA mode.
uint8_t BSP_SD_Erase (uint32_t StartAddr, uint32_t EndAddr)
 Erases the specified memory area of the given SD card.
__weak void BSP_SD_MspInit (SD_HandleTypeDef *hsd, void *Params)
 Initializes the SD MSP.
__weak void BSP_SD_Detect_MspInit (SD_HandleTypeDef *hsd, void *Params)
 Initializes the SD Detect pin MSP.
__weak void BSP_SD_MspDeInit (SD_HandleTypeDef *hsd, void *Params)
 DeInitializes the SD MSP.
uint8_t BSP_SD_GetCardState (void)
 Gets the current SD card data status.
void BSP_SD_GetCardInfo (HAL_SD_CardInfoTypeDef *CardInfo)
 Get SD information about specific SD card.
void HAL_SD_AbortCallback (SD_HandleTypeDef *hsd)
 SD Abort callbacks.
void HAL_SD_TxCpltCallback (SD_HandleTypeDef *hsd)
 Tx Transfer completed callbacks.
void HAL_SD_RxCpltCallback (SD_HandleTypeDef *hsd)
 Rx Transfer completed callbacks.
__weak void BSP_SD_AbortCallback (void)
 BSP SD Abort callbacks.
__weak void BSP_SD_WriteCpltCallback (void)
 BSP Tx Transfer completed callbacks.
__weak void BSP_SD_ReadCpltCallback (void)
 BSP Rx Transfer completed callbacks.

Function Documentation

void BSP_SD_AbortCallback ( void  )

BSP SD Abort callbacks.

Return values:
None

Definition at line 559 of file stm32746g_discovery_sd.c.

Referenced by HAL_SD_AbortCallback().

uint8_t BSP_SD_DeInit ( void  )

DeInitializes the SD card device.

Return values:
SDstatus

Definition at line 190 of file stm32746g_discovery_sd.c.

References BSP_SD_MspDeInit(), MSD_ERROR, MSD_OK, and uSdHandle.

void BSP_SD_Detect_MspInit ( SD_HandleTypeDef *  hsd,
void *  Params 
)

Initializes the SD Detect pin MSP.

Parameters:
hsd,:SD handle
Params
Return values:
None

Definition at line 451 of file stm32746g_discovery_sd.c.

References SD_DETECT_GPIO_CLK_ENABLE, SD_DETECT_GPIO_PORT, and SD_DETECT_PIN.

Referenced by BSP_SD_Init().

uint8_t BSP_SD_Erase ( uint32_t  StartAddr,
uint32_t  EndAddr 
)

Erases the specified memory area of the given SD card.

Parameters:
StartAddr,:Start byte address
EndAddr,:End byte address
Return values:
SDstatus

Definition at line 334 of file stm32746g_discovery_sd.c.

References MSD_ERROR, MSD_OK, and uSdHandle.

void BSP_SD_GetCardInfo ( HAL_SD_CardInfoTypeDef *  CardInfo)

Get SD information about specific SD card.

Parameters:
CardInfo,:Pointer to HAL_SD_CardInfoTypedef structure
Return values:
None

Definition at line 519 of file stm32746g_discovery_sd.c.

References uSdHandle.

uint8_t BSP_SD_GetCardState ( void  )

Gets the current SD card data status.

Return values:
Datatransfer state. This value can be one of the following values:
  • SD_TRANSFER_OK: No data transfer is acting
  • SD_TRANSFER_BUSY: Data transfer is acting

Definition at line 508 of file stm32746g_discovery_sd.c.

References SD_TRANSFER_BUSY, SD_TRANSFER_OK, and uSdHandle.

uint8_t BSP_SD_Init ( void  )

Initializes the SD card device.

Return values:
SDstatus

Definition at line 139 of file stm32746g_discovery_sd.c.

References BSP_SD_Detect_MspInit(), BSP_SD_IsDetected(), BSP_SD_MspInit(), MSD_ERROR, MSD_ERROR_SD_NOT_PRESENT, MSD_OK, SD_PRESENT, and uSdHandle.

uint8_t BSP_SD_IsDetected ( void  )

Detects if SD card is correctly plugged in the memory slot or not.

Return values:
Returnsif SD is detected or not

Definition at line 235 of file stm32746g_discovery_sd.c.

References SD_DETECT_GPIO_PORT, SD_DETECT_PIN, SD_NOT_PRESENT, and SD_PRESENT.

Referenced by BSP_SD_Init().

uint8_t BSP_SD_ITConfig ( void  )

Configures Interrupt mode for SD detection pin.

Return values:
ReturnsMSD_OK

Definition at line 213 of file stm32746g_discovery_sd.c.

References MSD_OK, SD_DETECT_EXTI_IRQn, SD_DETECT_GPIO_PORT, and SD_DETECT_PIN.

void BSP_SD_MspDeInit ( SD_HandleTypeDef *  hsd,
void *  Params 
)

DeInitializes the SD MSP.

Parameters:
hsd,:SD handle
Params
Return values:
None

Definition at line 471 of file stm32746g_discovery_sd.c.

References SD_DMAx_Rx_IRQn, SD_DMAx_Rx_STREAM, SD_DMAx_Tx_IRQn, and SD_DMAx_Tx_STREAM.

Referenced by BSP_SD_DeInit().

void BSP_SD_MspInit ( SD_HandleTypeDef *  hsd,
void *  Params 
)

Initializes the SD MSP.

Parameters:
hsd,:SD handle
Params
Return values:
None

Definition at line 352 of file stm32746g_discovery_sd.c.

References __DMAx_TxRx_CLK_ENABLE, SD_DMAx_Rx_CHANNEL, SD_DMAx_Rx_IRQn, SD_DMAx_Rx_STREAM, SD_DMAx_Tx_CHANNEL, SD_DMAx_Tx_IRQn, and SD_DMAx_Tx_STREAM.

Referenced by BSP_SD_Init().

uint8_t BSP_SD_ReadBlocks ( uint32_t *  pData,
uint32_t  ReadAddr,
uint32_t  NumOfBlocks,
uint32_t  Timeout 
)

Reads block(s) from a specified address in an SD card, in polling mode.

Parameters:
pData,:Pointer to the buffer that will contain the data to transmit
ReadAddr,:Address from where data is to be read
NumOfBlocks,:Number of SD blocks to read
Timeout,:Timeout for read operation
Return values:
SDstatus

Definition at line 256 of file stm32746g_discovery_sd.c.

References MSD_ERROR, MSD_OK, and uSdHandle.

uint8_t BSP_SD_ReadBlocks_DMA ( uint32_t *  pData,
uint32_t  ReadAddr,
uint32_t  NumOfBlocks 
)

Reads block(s) from a specified address in an SD card, in DMA mode.

Parameters:
pData,:Pointer to the buffer that will contain the data to transmit
ReadAddr,:Address from where data is to be read
NumOfBlocks,:Number of SD blocks to read
Return values:
SDstatus

Definition at line 295 of file stm32746g_discovery_sd.c.

References MSD_ERROR, MSD_OK, and uSdHandle.

void BSP_SD_ReadCpltCallback ( void  )

BSP Rx Transfer completed callbacks.

Return values:
None

Definition at line 577 of file stm32746g_discovery_sd.c.

Referenced by HAL_SD_RxCpltCallback().

uint8_t BSP_SD_WriteBlocks ( uint32_t *  pData,
uint32_t  WriteAddr,
uint32_t  NumOfBlocks,
uint32_t  Timeout 
)

Writes block(s) to a specified address in an SD card, in polling mode.

Parameters:
pData,:Pointer to the buffer that will contain the data to transmit
WriteAddr,:Address from where data is to be written
NumOfBlocks,:Number of SD blocks to write
Timeout,:Timeout for write operation
Return values:
SDstatus

Definition at line 276 of file stm32746g_discovery_sd.c.

References MSD_ERROR, MSD_OK, and uSdHandle.

uint8_t BSP_SD_WriteBlocks_DMA ( uint32_t *  pData,
uint32_t  WriteAddr,
uint32_t  NumOfBlocks 
)

Writes block(s) to a specified address in an SD card, in DMA mode.

Parameters:
pData,:Pointer to the buffer that will contain the data to transmit
WriteAddr,:Address from where data is to be written
NumOfBlocks,:Number of SD blocks to write
Return values:
SDstatus

Definition at line 315 of file stm32746g_discovery_sd.c.

References MSD_ERROR, MSD_OK, and uSdHandle.

void BSP_SD_WriteCpltCallback ( void  )

BSP Tx Transfer completed callbacks.

Return values:
None

Definition at line 568 of file stm32746g_discovery_sd.c.

Referenced by HAL_SD_TxCpltCallback().

void HAL_SD_AbortCallback ( SD_HandleTypeDef *  hsd)

SD Abort callbacks.

Parameters:
hsd,:SD handle
Return values:
None

Definition at line 530 of file stm32746g_discovery_sd.c.

References BSP_SD_AbortCallback().

void HAL_SD_RxCpltCallback ( SD_HandleTypeDef *  hsd)

Rx Transfer completed callbacks.

Parameters:
hsd,:SD handle
Return values:
None

Definition at line 550 of file stm32746g_discovery_sd.c.

References BSP_SD_ReadCpltCallback().

void HAL_SD_TxCpltCallback ( SD_HandleTypeDef *  hsd)

Tx Transfer completed callbacks.

Parameters:
hsd,:SD handle
Return values:
None

Definition at line 540 of file stm32746g_discovery_sd.c.

References BSP_SD_WriteCpltCallback().

Generated on Fri Dec 30 2016 16:31:33 for STM32746G-Discovery BSP User Manual by   doxygen 1.7.6.1