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

1 该驱动函数预览

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

函数名HAL_SD_Init
函数原形HAL_StatusTypeDef HAL_SD_Init(SD_HandleTypeDef *hsd, SD_InitTypeDef *Init)
功能描述初始化SD卡
输入参数 1hsd:SD句柄结构体指针
输入参数 2Init:SD初始化配置结构体指针
输出参数
返回值HAL_StatusTypeDef:函数执行状态
先决条件
被调用函数

1.2 HAL_SD_InitCard

函数名HAL_SD_InitCard
函数原形HAL_StatusTypeDef HAL_SD_InitCard(SD_HandleTypeDef *hsd, HAL_SD_CardInfoTypeDef *pCardInfo)
功能描述初始化SD卡并获取卡信息
输入参数 1hsd:SD句柄结构体指针
输入参数 2pCardInfo: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卡读取数据块
输入参数 1hsd:SD句柄结构体指针
输入参数 2pData:数据缓冲区指针
输入参数 3BlockAdd:数据块地址
输入参数 4NumberOfBlocks:读取的数据块数量
输入参数 5Timeout:超时时间(以毫秒为单位)
输出参数
返回值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卡写入数据块
输入参数 1hsd:SD句柄结构体指针
输入参数 2pData:数据缓冲区指针
输入参数 3BlockAdd:数据块地址
输入参数 4NumberOfBlocks:写入的数据块数量
输入参数 5Timeout:超时时间(以毫秒为单位)
输出参数
返回值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卡读取数据块
输入参数 1hsd:SD句柄结构体指针
输入参数 2pData:数据缓冲区指针
输入参数 3BlockAdd:数据块地址
输入参数 4NumberOfBlocks:读取的数据块数量
输出参数
返回值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卡读取数据块
输入参数 1hsd:SD句柄结构体指针
输入参数 2pData:数据缓冲区指针
输入参数 3BlockAdd:数据块地址
输入参数 4NumberOfBlocks:读取的数据块数量
输出参数
返回值HAL_StatusTypeDef:函数执行状态
先决条件
被调用函数

该文档修改记录:

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

总结

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

  • 29
    点赞
  • 14
    收藏
    觉得还不错? 一键收藏
  • 打赏
    打赏
  • 0
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

常驻客栈

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付:¥1
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值