bsp_driver_sd.c File Reference

This file includes a generic uSD card driver. To be completed by the user according to the board used for the project. More...

#include "bsp_driver_sd.h"

Include dependency graph for bsp_driver_sd.c:

Go to the source code of this file.

Functions
__weak uint8_t	BSP_SD_Init (void)
	Initializes the SD card device. More...
__weak uint8_t	BSP_SD_ITConfig (void)
	Configures Interrupt mode for SD detection pin. More...
__weak void	BSP_SD_DetectIT (void)
	SD detect IT treatment. More...
__weak 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. More...
__weak 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. More...
__weak 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. More...
__weak 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. More...
__weak uint8_t	BSP_SD_Erase (uint32_t StartAddr, uint32_t EndAddr)
	Erases the specified memory area of the given SD card. More...
__weak uint8_t	BSP_SD_GetCardState (void)
	Gets the current SD card data status. More...
__weak void	BSP_SD_GetCardInfo (HAL_SD_CardInfoTypeDef *CardInfo)
	Get SD information about specific SD card. More...
void	HAL_SD_AbortCallback (SD_HandleTypeDef *hsd)
	SD Abort callbacks. More...
void	HAL_SD_TxCpltCallback (SD_HandleTypeDef *hsd)
	Tx Transfer completed callback. More...
void	HAL_SD_RxCpltCallback (SD_HandleTypeDef *hsd)
	Rx Transfer completed callback. More...
__weak void	BSP_SD_AbortCallback (void)
	BSP SD Abort callback. More...
__weak void	BSP_SD_WriteCpltCallback (void)
	BSP Tx Transfer completed callback. More...
__weak void	BSP_SD_ReadCpltCallback (void)
	BSP Rx Transfer completed callback. More...
__weak uint8_t	BSP_SD_IsDetected (void)
	Detects if SD card is correctly plugged in the memory slot or not. More...

Variables
SD_HandleTypeDef	hsd

Detailed Description

This file includes a generic uSD card driver. To be completed by the user according to the board used for the project.

for F4 (based on stm324x9i_eval_sd.c)

Note

Some functions generated as weak: they can be overriden by

• code in user files
• or BSP code from the FW pack files if such files are added to the generated project (by the user).

Attention

© Copyright (c) 2020 STMicroelectronics. All rights reserved.

This software component is licensed by ST under Ultimate Liberty license SLA0044, the "License"; You may not use this file except in compliance with the License. You may obtain a copy of the License at: www.st.com/SLA0044

Definition in file bsp_driver_sd.c.

Function Documentation

BSP_SD_AbortCallback()

__weak void BSP_SD_AbortCallback

(

void

)

BSP SD Abort callback.

Return values

None

Note

empty (up to the user to fill it in or to remove it if useless)

Definition at line 269 of file bsp_driver_sd.c.

BSP_SD_DetectIT()

__weak void BSP_SD_DetectIT

(

void

)

SD detect IT treatment.

Definition at line 87 of file bsp_driver_sd.c.

BSP_SD_Erase()

__weak 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

SD

status

Definition at line 194 of file bsp_driver_sd.c.

BSP_SD_GetCardInfo()

__weak 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 224 of file bsp_driver_sd.c.

BSP_SD_GetCardState()

__weak uint8_t BSP_SD_GetCardState

(

void

)

Gets the current SD card data status.

Parameters

None

Return values

Data	transfer 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 214 of file bsp_driver_sd.c.

BSP_SD_Init()

__weak uint8_t BSP_SD_Init

(

void

)

Initializes the SD card device.

Return values

SD

status

Definition at line 47 of file bsp_driver_sd.c.

BSP_SD_IsDetected()

__weak uint8_t BSP_SD_IsDetected

(

void

)

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

Parameters

None

Return values

Returns

if SD is detected or not

Definition at line 301 of file bsp_driver_sd.c.

BSP_SD_ITConfig()

__weak uint8_t BSP_SD_ITConfig

(

void

)

Configures Interrupt mode for SD detection pin.

Return values

Returns

0

Definition at line 78 of file bsp_driver_sd.c.

BSP_SD_ReadBlocks()

__weak 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

SD

status

Definition at line 104 of file bsp_driver_sd.c.

BSP_SD_ReadBlocks_DMA()

__weak 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

SD

status

Definition at line 149 of file bsp_driver_sd.c.

BSP_SD_ReadCpltCallback()

__weak void BSP_SD_ReadCpltCallback

(

void

)

BSP Rx Transfer completed callback.

Return values

None

Note

empty (up to the user to fill it in or to remove it if useless)

Definition at line 289 of file bsp_driver_sd.c.

BSP_SD_WriteBlocks()

__weak 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

SD

status

Definition at line 127 of file bsp_driver_sd.c.

BSP_SD_WriteBlocks_DMA()

__weak 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

SD

status

Definition at line 172 of file bsp_driver_sd.c.

BSP_SD_WriteCpltCallback()

__weak void BSP_SD_WriteCpltCallback

(

void

)

BSP Tx Transfer completed callback.

Return values

None

Note

empty (up to the user to fill it in or to remove it if useless)

Definition at line 279 of file bsp_driver_sd.c.

HAL_SD_AbortCallback()

void HAL_SD_AbortCallback

(

SD_HandleTypeDef *

hsd

)

SD Abort callbacks.

Parameters

hsd

SD handle

Return values

None

Definition at line 238 of file bsp_driver_sd.c.

HAL_SD_RxCpltCallback()

void HAL_SD_RxCpltCallback

(

SD_HandleTypeDef *

hsd

)

Rx Transfer completed callback.

Parameters

hsd

SD handle

Return values

None

Definition at line 258 of file bsp_driver_sd.c.

HAL_SD_TxCpltCallback()

void HAL_SD_TxCpltCallback

(

SD_HandleTypeDef *

hsd

)

Tx Transfer completed callback.

Parameters

hsd

SD handle

Return values

None

Definition at line 248 of file bsp_driver_sd.c.

Variable Documentation

hsd

SD_HandleTypeDef hsd

extern

TODO: this is old and this was mostly made for test purposes. maybe this can move right into the card driver ?

Definition at line 15 of file mmc_driver.c.