STM32769I_EVAL BSP User Manual: SD Exported Functions

STM32769I_EVAL BSP

STM32769I_EVAL BSP User Manual
SD Exported Functions

Functions

uint8_t BSP_SD_Init (void)
 Initializes the SD card device.
uint8_t BSP_SD_InitEx (uint32_t SdCard)
 Initializes the SD card device.
uint8_t BSP_SD_DeInit (void)
 DeInitializes the SD card device.
uint8_t BSP_SD_DeInitEx (uint32_t SdCard)
 DeInitializes the SD card device.
uint8_t BSP_SD_ITConfig (void)
 Configures Interrupt mode for SD1 detection pin.
uint8_t BSP_SD_ITConfigEx (uint32_t SdCard)
 Configures Interrupt mode for SD detection pin.
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_ReadBlocksEx (uint32_t SdCard, 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_WriteBlocksEx (uint32_t SdCard, 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_ReadBlocks_DMAEx (uint32_t SdCard, 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_WriteBlocks_DMAEx (uint32_t SdCard, 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.
uint8_t BSP_SD_EraseEx (uint32_t SdCard, uint32_t StartAddr, uint32_t EndAddr)
 Erases the specified memory area of the given SD card.
uint8_t BSP_SD_GetCardState (void)
 Gets the current SD card data status.
uint8_t BSP_SD_GetCardStateEx (uint32_t SdCard)
 Gets the current SD card data status.
void BSP_SD_GetCardInfo (BSP_SD_CardInfo *CardInfo)
 Get SD information about specific SD card.
void BSP_SD_GetCardInfoEx (uint32_t SdCard, BSP_SD_CardInfo *CardInfo)
 Get SD information about specific SD card.
uint8_t BSP_SD_IsDetected (void)
 Detects if SD card is correctly plugged in the memory slot or not.
uint8_t BSP_SD_IsDetectedEx (uint32_t SdCard)
 Detects if SD card is correctly plugged in the memory slot or not.
void BSP_SD_MspInit (SD_HandleTypeDef *hsd, void *Params)
 Initializes the SD MSP.
void BSP_SD_MspDeInit (SD_HandleTypeDef *hsd, void *Params)
 DeInitializes the SD MSP.
void BSP_SD_AbortCallback (uint32_t SdCard)
 BSP SD Abort callbacks.
void BSP_SD_WriteCpltCallback (uint32_t SdCard)
 BSP Tx Transfer completed callbacks.
void BSP_SD_ReadCpltCallback (uint32_t SdCard)
 BSP Rx Transfer completed callbacks.

Function Documentation

void BSP_SD_AbortCallback ( uint32_t  SdCard)

BSP SD Abort callbacks.

Parameters:
SdCard,:SD_CARD1 or SD_CARD2
Return values:
None

Definition at line 989 of file stm32f769i_eval_sd.c.

Referenced by HAL_SD_AbortCallback().

uint8_t BSP_SD_DeInit ( void  )

DeInitializes the SD card device.

Return values:
SDstatus

Definition at line 269 of file stm32f769i_eval_sd.c.

References BSP_SD_DeInitEx(), and SD_CARD1.

uint8_t BSP_SD_DeInitEx ( uint32_t  SdCard)

DeInitializes the SD card device.

Parameters:
SdCard,:SD card to be used, that should be SD_CARD1 or SD_CARD2
Return values:
SDstatus

Definition at line 280 of file stm32f769i_eval_sd.c.

References BSP_IO_ConfigPin(), BSP_SD_MspDeInit(), MSD_ERROR, MSD_OK, SD_CARD1, uSdHandle, uSdHandle2, and UseExtiModeDetection.

Referenced by BSP_SD_DeInit().

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 590 of file stm32f769i_eval_sd.c.

References BSP_SD_EraseEx(), and SD_CARD1.

uint8_t BSP_SD_EraseEx ( uint32_t  SdCard,
uint32_t  StartAddr,
uint32_t  EndAddr 
)

Erases the specified memory area of the given SD card.

Parameters:
SdCard,:SD card to be used, that should be SD_CARD1 or SD_CARD2
StartAddr,:Start byte address
EndAddr,:End byte address
Return values:
SDstatus

Definition at line 602 of file stm32f769i_eval_sd.c.

References MSD_ERROR, MSD_OK, SD_CARD1, uSdHandle, and uSdHandle2.

Referenced by BSP_SD_Erase().

void BSP_SD_GetCardInfo ( BSP_SD_CardInfo CardInfo)

Get SD information about specific SD card.

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

Definition at line 930 of file stm32f769i_eval_sd.c.

References BSP_SD_GetCardInfoEx(), and SD_CARD1.

void BSP_SD_GetCardInfoEx ( uint32_t  SdCard,
BSP_SD_CardInfo CardInfo 
)

Get SD information about specific SD card.

Parameters:
SdCard,:SD card to be used, that should be SD_CARD1 or SD_CARD2
CardInfo,:Pointer to HAL_SD_CardInfoTypedef structure
Return values:
None

Definition at line 941 of file stm32f769i_eval_sd.c.

References SD_CARD1, uSdHandle, and uSdHandle2.

Referenced by BSP_SD_GetCardInfo().

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 900 of file stm32f769i_eval_sd.c.

References BSP_SD_GetCardStateEx(), and SD_CARD1.

uint8_t BSP_SD_GetCardStateEx ( uint32_t  SdCard)

Gets the current SD card data status.

Parameters:
SdCard,:SD_CARD1 or SD_CARD2
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 913 of file stm32f769i_eval_sd.c.

References SD_CARD1, SD_TRANSFER_BUSY, SD_TRANSFER_OK, uSdHandle, and uSdHandle2.

Referenced by BSP_SD_GetCardState().

uint8_t BSP_SD_Init ( void  )

Initializes the SD card device.

Return values:
SDstatus

Definition at line 161 of file stm32f769i_eval_sd.c.

References BSP_SD_InitEx(), and SD_CARD1.

uint8_t BSP_SD_InitEx ( uint32_t  SdCard)

Initializes the SD card device.

Parameters:
SdCard,:SD card to be used, that should be SD_CARD1 or SD_CARD2
Return values:
SDstatus

Definition at line 172 of file stm32f769i_eval_sd.c.

References BSP_IO_ConfigPin(), BSP_IO_Init(), BSP_SD_IsDetected(), BSP_SD_IsDetectedEx(), BSP_SD_MspInit(), MSD_ERROR, MSD_ERROR_SD_NOT_PRESENT, MSD_OK, SD_CARD1, SD_CARD2, SD_PRESENT, uSdHandle, and uSdHandle2.

Referenced by BSP_SD_Init().

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 349 of file stm32f769i_eval_sd.c.

References BSP_SD_IsDetectedEx(), and SD_CARD1.

Referenced by BSP_SD_InitEx(), and BSP_SD_ITConfig().

uint8_t BSP_SD_IsDetectedEx ( uint32_t  SdCard)

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

Parameters:
SdCard,:SD card to be used, that should be SD_CARD1 or SD_CARD2
Return values:
Returnsif SD is detected or not

Definition at line 359 of file stm32f769i_eval_sd.c.

References BSP_IO_ConfigPin(), BSP_IO_ReadPin(), SD_CARD1, SD_NOT_PRESENT, SD_PRESENT, and UseExtiModeDetection.

Referenced by BSP_SD_InitEx(), BSP_SD_IsDetected(), and BSP_SD_ITConfigEx().

uint8_t BSP_SD_ITConfig ( void  )

Configures Interrupt mode for SD1 detection pin.

Return values:
Returns0

Definition at line 320 of file stm32f769i_eval_sd.c.

References BSP_SD_IsDetected(), and UseExtiModeDetection.

uint8_t BSP_SD_ITConfigEx ( uint32_t  SdCard)

Configures Interrupt mode for SD detection pin.

Parameters:
SdCard,:SD card to be used, that should be SD_CARD1 or SD_CARD2
Return values:
Returns0

Definition at line 335 of file stm32f769i_eval_sd.c.

References BSP_SD_IsDetectedEx(), and UseExtiModeDetection.

void BSP_SD_MspDeInit ( SD_HandleTypeDef *  hsd,
void *  Params 
)

DeInitializes the SD MSP.

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

Definition at line 837 of file stm32f769i_eval_sd.c.

References SD1_DMAx_Rx_IRQn, SD1_DMAx_Rx_STREAM, SD1_DMAx_Tx_IRQn, SD1_DMAx_Tx_STREAM, SD2_DMAx_Rx_IRQn, SD2_DMAx_Rx_STREAM, SD2_DMAx_Tx_IRQn, and SD2_DMAx_Tx_STREAM.

Referenced by BSP_SD_DeInitEx().

void BSP_SD_MspInit ( SD_HandleTypeDef *  hsd,
void *  Params 
)
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 412 of file stm32f769i_eval_sd.c.

References BSP_SD_ReadBlocksEx(), and SD_CARD1.

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 501 of file stm32f769i_eval_sd.c.

References BSP_SD_ReadBlocks_DMAEx(), and SD_CARD1.

uint8_t BSP_SD_ReadBlocks_DMAEx ( uint32_t  SdCard,
uint32_t *  pData,
uint32_t  ReadAddr,
uint32_t  NumOfBlocks 
)

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

Parameters:
SdCard,:SD card to be used, that should be SD_CARD1 or SD_CARD2
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 514 of file stm32f769i_eval_sd.c.

References MSD_ERROR, MSD_OK, SD_CARD1, uSdHandle, and uSdHandle2.

Referenced by BSP_SD_ReadBlocks_DMA().

uint8_t BSP_SD_ReadBlocksEx ( uint32_t  SdCard,
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:
SdCard,:SD card to be used, that should be SD_CARD1 or SD_CARD2
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 426 of file stm32f769i_eval_sd.c.

References MSD_ERROR, MSD_OK, SD_CARD1, uSdHandle, and uSdHandle2.

Referenced by BSP_SD_ReadBlocks().

void BSP_SD_ReadCpltCallback ( uint32_t  SdCard)

BSP Rx Transfer completed callbacks.

Parameters:
SdCard,:SD_CARD1 or SD_CARD2
Return values:
None

Definition at line 1009 of file stm32f769i_eval_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 457 of file stm32f769i_eval_sd.c.

References BSP_SD_WriteBlocksEx(), and SD_CARD1.

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 546 of file stm32f769i_eval_sd.c.

References BSP_SD_WriteBlocks_DMAEx(), and SD_CARD1.

uint8_t BSP_SD_WriteBlocks_DMAEx ( uint32_t  SdCard,
uint32_t *  pData,
uint32_t  WriteAddr,
uint32_t  NumOfBlocks 
)

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

Parameters:
SdCard,:SD card to be used, that should be SD_CARD1 or SD_CARD2
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 559 of file stm32f769i_eval_sd.c.

References MSD_ERROR, MSD_OK, SD_CARD1, uSdHandle, and uSdHandle2.

Referenced by BSP_SD_WriteBlocks_DMA().

uint8_t BSP_SD_WriteBlocksEx ( uint32_t  SdCard,
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:
SdCard,:SD card to be used, that should be SD_CARD1 or SD_CARD2
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 471 of file stm32f769i_eval_sd.c.

References MSD_ERROR, MSD_OK, SD_CARD1, uSdHandle, and uSdHandle2.

Referenced by BSP_SD_WriteBlocks().

void BSP_SD_WriteCpltCallback ( uint32_t  SdCard)

BSP Tx Transfer completed callbacks.

Parameters:
SdCard,:SD_CARD1 or SD_CARD2
Return values:
None

Definition at line 999 of file stm32f769i_eval_sd.c.

Referenced by HAL_SD_TxCpltCallback().

Generated on Thu May 25 2017 11:03:12 for STM32769I_EVAL BSP User Manual by   doxygen 1.7.6.1