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

发布于:2024-06-19 ⋅ 阅读:(50) ⋅ 点赞:(0)

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日 第一次发布,介绍了该博客驱动所有函数的介绍及使用

总结

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


网站公告

今日签到

点亮在社区的每一天
去签到