A44 STM32_HAL库函数 之SD通用驱动 --B -- 所有函数的介绍及使用

1 该驱动函数预览

序号	函数名	描述
1	HAL_SD_Init()	初始化SD卡。
2	HAL_SD_InitCard()	初始化SD卡。
3	HAL_SD_DeInit()	反初始化SD卡。
4	HAL_SD_MspInit()	初始化SD卡相关的MCU外设引脚或资源。
5	HAL_SD_MspDeInit()	反初始化SD卡相关的MCU外设引脚或资源。
6	HAL_SD_ReadBlocks()	从SD卡读取数据块。
7	HAL_SD_WriteBlocks()	向SD卡写入数据块。
8	HAL_SD_ReadBlocks_IT()	使用中断方式从SD卡读取数据块。
9	HAL_SD_WriteBlocks_IT()	使用中断方式向SD卡写入数据块。
10	HAL_SD_ReadBlocks_DMA()	使用DMA方式从SD卡读取数据块。
11	HAL_SD_WriteBlocks_DMA()	使用DMA方式向SD卡写入数据块。
12	HAL_SD_Erase()	擦除SD卡中的指定扇区。
13	HAL_SD_IRQHandler()	SD卡中断处理程序。
14	HAL_SD_GetState()	获取SD卡状态。
15	HAL_SD_GetError()	获取SD卡错误状态。
16	HAL_SD_TxCpltCallback()	SD卡传输完成回调函数。
17	HAL_SD_RxCpltCallback()	SD卡接收完成回调函数。
18	HAL_SD_ErrorCallback()	SD卡错误回调函数。
19	HAL_SD_AbortCallback()	SD卡中断回调函数。
20	HAL_SD_GetCardCID()	获取SD卡CID（卡识别寄存器）。
21	HAL_SD_GetCardCSD()	获取SD卡CSD（卡特性寄存器）。
22	HAL_SD_GetCardStatus()	获取SD卡状态。
23	HAL_SD_GetCardInfo()	获取SD卡信息。
24	HAL_SD_ConfigWideBusOperation()	配置SD卡的总线宽度。
25	HAL_SD_GetCardState()	获取SD卡状态。
26	HAL_SD_Abort()	终止SD卡操作。
27	HAL_SD_Abort_IT()	终止SD卡操作并启用中断。

以下是使用模板：

#include "stm32f4xx_hal.h"int main(void) {// HAL初始化HAL_Init();// 初始化SD卡HAL_SD_Init();// 初始化SD卡相关的MCU外设引脚或资源HAL_SD_MspInit();// 进行其他操作...// 从SD卡读取数据块HAL_SD_ReadBlocks();// 向SD卡写入数据块HAL_SD_WriteBlocks();// 使用中断方式从SD卡读取数据块HAL_SD_ReadBlocks_IT();// 使用DMA方式从SD卡读取数据块HAL_SD_ReadBlocks_DMA();// 擦除SD卡中的指定扇区HAL_SD_Erase();// 获取SD卡状态HAL_SD_GetState();return 0;
}

1.11 HAL_SD_WriteBlocks_DMA

函数名	HAL_SD_WriteBlocks_DMA
函数原形	HAL_StatusTypeDef HAL_SD_WriteBlocks_DMA(SD_HandleTypeDef *hsd, uint32_t *pData, uint32_t BlockAdd, uint32_t NumberOfBlocks)
功能描述	以DMA方式向SD卡写入数据块
输入参数 1	hsd：SD句柄结构体指针
输入参数 2	pData：数据缓冲区指针
输入参数 3	BlockAdd：数据块地址
输入参数 4	NumberOfBlocks：写入的数据块数量
输出参数	无
返回值	HAL_StatusTypeDef：函数执行状态
先决条件	无
被调用函数	无

---

1.12 HAL_SD_Erase

函数名	HAL_SD_Erase
函数原形	HAL_StatusTypeDef HAL_SD_Erase(SD_HandleTypeDef *hsd, uint32_t BlockStartAddr, uint32_t BlockEndAddr)
功能描述	擦除SD卡中指定范围的数据块
输入参数 1	hsd：SD句柄结构体指针
输入参数 2	BlockStartAddr：起始数据块地址
输入参数 3	BlockEndAddr：结束数据块地址
输出参数	无
返回值	HAL_StatusTypeDef：函数执行状态
先决条件	无
被调用函数	无

---

1.13 HAL_SD_IRQHandler

函数名	HAL_SD_IRQHandler
函数原形	void HAL_SD_IRQHandler(SD_HandleTypeDef *hsd)
功能描述	SD卡中断服务函数
输入参数	hsd：SD句柄结构体指针
输出参数	无
返回值	无
先决条件	无
被调用函数	无

---

1.14 HAL_SD_GetState

函数名	HAL_SD_GetState
函数原形	HAL_SD_StateTypeDef HAL_SD_GetState(SD_HandleTypeDef *hsd)
功能描述	获取SD卡状态
输入参数	hsd：SD句柄结构体指针
输出参数	无
返回值	HAL_SD_StateTypeDef：SD卡状态
先决条件	无
被调用函数	无

---

1.15 HAL_SD_GetError

函数名	HAL_SD_GetError
函数原形	uint32_t HAL_SD_GetError(SD_HandleTypeDef *hsd)
功能描述	获取SD卡错误信息
输入参数	hsd：SD句柄结构体指针
输出参数	无
返回值	uint32_t：SD卡错误码
先决条件	无
被调用函数	无

---

1.16 HAL_SD_TxCpltCallback

函数名	HAL_SD_TxCpltCallback
函数原形	void HAL_SD_TxCpltCallback(SD_HandleTypeDef *hsd)
功能描述	SD卡数据发送完成回调函数
输入参数	hsd：SD句柄结构体指针
输出参数	无
返回值	无
先决条件	无
被调用函数	无

---

1.17 HAL_SD_RxCpltCallback

函数名	HAL_SD_RxCpltCallback
函数原形	void HAL_SD_RxCpltCallback(SD_HandleTypeDef *hsd)
功能描述	SD卡数据接收完成回调函数
输入参数	hsd：SD句柄结构体指针
输出参数	无
返回值	无
先决条件	无
被调用函数	无

---

1.18 HAL_SD_ErrorCallback

函数名	HAL_SD_ErrorCallback
函数原形	void HAL_SD_ErrorCallback(SD_HandleTypeDef *hsd)
功能描述	SD卡错误处理回调函数
输入参数	h

sd：SD句柄结构体指针 |
| 输出参数 | 无 |
| 返回值 | 无 |
| 先决条件 | 无 |
| 被调用函数 | 无 |

---

1.19 HAL_SD_AbortCallback

函数名	HAL_SD_AbortCallback
函数原形	void HAL_SD_AbortCallback(SD_HandleTypeDef *hsd)
功能描述	SD卡操作中断处理回调函数
输入参数	hsd：SD句柄结构体指针
输出参数	无
返回值	无
先决条件	无
被调用函数	无

该文档修改记录：

修改时间	修改说明
2024年4月30日	第一次发布，介绍了该博客驱动所有函数的介绍及使用

总结

以上就是该博客驱动所有函数的介绍及使用的内容。
有不明白的地方欢迎留言；有建议欢迎留言，我后面编写文档好改进。
创作不容，如果文档对您有帮助，记得给个赞。