A43 STM32_HAL库函数 之SD通用驱动 --A -- 所有函数的介绍及使用
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.1 HAL_SD_Init
函数名 | HAL_SD_Init |
---|
函数原形 | HAL_StatusTypeDef HAL_SD_Init(SD_HandleTypeDef *hsd, SD_InitTypeDef *Init) |
功能描述 | 初始化SD卡 |
输入参数 1 | hsd:SD句柄结构体指针 |
输入参数 2 | Init:SD初始化配置结构体指针 |
输出参数 | 无 |
返回值 | HAL_StatusTypeDef:函数执行状态 |
先决条件 | 无 |
被调用函数 | 无 |
1.2 HAL_SD_InitCard
函数名 | HAL_SD_InitCard |
---|
函数原形 | HAL_StatusTypeDef HAL_SD_InitCard(SD_HandleTypeDef *hsd, HAL_SD_CardInfoTypeDef *pCardInfo) |
功能描述 | 初始化SD卡并获取卡信息 |
输入参数 1 | hsd:SD句柄结构体指针 |
输入参数 2 | pCardInfo:SD卡信息结构体指针 |
输出参数 | 无 |
返回值 | HAL_StatusTypeDef:函数执行状态 |
先决条件 | 无 |
被调用函数 | 无 |
1.3 HAL_SD_DeInit
函数名 | HAL_SD_DeInit |
---|
函数原形 | HAL_StatusTypeDef HAL_SD_DeInit(SD_HandleTypeDef *hsd) |
功能描述 | 反初始化SD卡 |
输入参数 | hsd:SD句柄结构体指针 |
输出参数 | 无 |
返回值 | HAL_StatusTypeDef:函数执行状态 |
先决条件 | 无 |
被调用函数 | 无 |
1.4 HAL_SD_MspInit
函数名 | HAL_SD_MspInit |
---|
函数原形 | void HAL_SD_MspInit(SD_HandleTypeDef *hsd) |
功能描述 | 初始化SD卡外设时钟、引脚、DMA等资源 |
输入参数 | hsd:SD句柄结构体指针 |
输出参数 | 无 |
返回值 | 无 |
先决条件 | 无 |
被调用函数 | 无 |
1.5 HAL_SD_MspDeInit
函数名 | HAL_SD_MspDeInit |
---|
函数原形 | void HAL_SD_MspDeInit(SD_HandleTypeDef *hsd) |
功能描述 | 反初始化SD卡外设时钟、引脚、DMA等资源 |
输入参数 | hsd:SD句柄结构体指针 |
输出参数 | 无 |
返回值 | 无 |
先决条件 | 无 |
被调用函数 | 无 |
1.6 HAL_SD_ReadBlocks
函数名 | HAL_SD_ReadBlocks |
---|
函数原形 | HAL_StatusTypeDef HAL_SD_ReadBlocks(SD_HandleTypeDef *hsd, uint32_t *pData, uint32_t BlockAdd, uint32_t NumberOfBlocks, uint32_t Timeout) |
功能描述 | 从SD卡读取数据块 |
输入参数 1 | hsd:SD句柄结构体指针 |
输入参数 2 | pData:数据缓冲区指针 |
输入参数 3 | BlockAdd:数据块地址 |
输入参数 4 | NumberOfBlocks:读取的数据块数量 |
输入参数 5 | Timeout:超时时间(以毫秒为单位) |
输出参数 | 无 |
返回值 | HAL_StatusTypeDef:函数执行状态 |
先决条件 | 无 |
被调用函数 | 无 |
1.7 HAL_SD_WriteBlocks
函数名 | HAL_SD_WriteBlocks |
---|
函数原形 | HAL_StatusTypeDef HAL_SD_WriteBlocks(SD_HandleTypeDef *hsd, uint32_t *pData, uint32_t BlockAdd, uint32_t NumberOfBlocks, uint32_t Timeout) |
功能描述 | 向SD卡写入数据块 |
输入参数 1 | hsd:SD句柄结构体指针 |
输入参数 2 | pData:数据缓冲区指针 |
输入参数 3 | BlockAdd:数据块地址 |
输入参数 4 | NumberOfBlocks:写入的数据块数量 |
输入参数 5 | Timeout:超时时间(以毫秒为单位) |
输出参数 | 无 |
返回值 | HAL_StatusTypeDef:函数执行状态 |
先决条件 | 无 |
被调用函数 | 无 |
1.8 HAL_SD_ReadBlocks_IT
函数名 | HAL_SD_ReadBlocks_IT |
---|
函数原形 | HAL_StatusTypeDef HAL_SD_ReadBlocks_IT(SD_HandleTypeDef *hsd, uint32_t *pData, uint32_t BlockAdd, uint32_t NumberOfBlocks) |
功能描述 | 以中断方式从SD卡读取数据块 |
输入参数 1 | hsd:SD句柄结构体指针 |
输入参数 2 | pData:数据缓冲区指针 |
输入参数 3 | BlockAdd:数据块地址 |
输入参数 4 | NumberOfBlocks:读取的数据块数量 |
输出参数 | 无 |
返回值 | HAL_StatusTypeDef:函数执行状态 |
先决条件 | 无 |
被调用函数 | 无 |
1.9 HAL_SD_WriteBlocks_IT
函数名 | HAL_SD_WriteBlocks_IT |
---|
函数原形 | HAL_StatusTypeDef HAL_SD_WriteBlocks_IT(SD_HandleTypeDef *hsd, uint32_t *pData, uint32_t BlockAdd, uint32_t NumberOfBlocks) |
功能描述 | |
| 以中断方式向SD卡写入数据块 |
| 输入参数 1 | hsd:SD句柄结构体指针 |
| 输入参数 2 | pData:数据缓冲区指针 |
| 输入参数 3 | BlockAdd:数据块地址 |
| 输入参数 4 | NumberOfBlocks:写入的数据块数量 |
| 输出参数 | 无 |
| 返回值 | HAL_StatusTypeDef:函数执行状态 |
| 先决条件 | 无 |
| 被调用函数 | 无 |
1.10 HAL_SD_ReadBlocks_DMA
函数名 | HAL_SD_ReadBlocks_DMA |
---|
函数原形 | HAL_StatusTypeDef HAL_SD_ReadBlocks_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:函数执行状态 |
先决条件 | 无 |
被调用函数 | 无 |
该文档修改记录:
修改时间 | 修改说明 |
---|
2024年4月30日 | 第一次发布,介绍了该博客驱动所有函数的介绍及使用 |
总结
以上就是该博客驱动所有函数的介绍及使用的内容。
有不明白的地方欢迎留言;有建议欢迎留言,我后面编写文档好改进。
创作不容,如果文档对您有帮助,记得给个赞。