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_Init();
HAL_SD_Init();
HAL_SD_MspInit();
HAL_SD_ReadBlocks();
HAL_SD_WriteBlocks();
HAL_SD_ReadBlocks_IT();
HAL_SD_ReadBlocks_DMA();
HAL_SD_Erase();
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日 |
第一次发布,介绍了该博客驱动所有函数的介绍及使用 |
总结
以上就是该博客驱动所有函数的介绍及使用的内容。
有不明白的地方欢迎留言;有建议欢迎留言,我后面编写文档好改进。
创作不容,如果文档对您有帮助,记得给个赞。