A47 STM32_HAL库函数 之 SPI通用驱动 所有函数的介绍及使用

1 该驱动函数预览

序号函数名描述
1HAL_SPI_Init()初始化SPI外设。
2HAL_SPI_DeInit()反初始化SPI外设。
3HAL_SPI_MspInit()初始化SPI外设相关的MCU外设引脚或资源。
4HAL_SPI_MspDeInit()反初始化SPI外设相关的MCU外设引脚或资源。
5HAL_SPI_Transmit()发送数据到SPI外设。
6HAL_SPI_Receive()从SPI外设接收数据。
7HAL_SPI_TransmitReceive()发送并接收数据到SPI外设。
8HAL_SPI_Transmit_IT()使用中断方式发送数据到SPI外设。
9HAL_SPI_Receive_IT()使用中断方式从SPI外设接收数据。
10HAL_SPI_TransmitReceive_IT()使用中断方式发送并接收数据到SPI外设。
11HAL_SPI_Transmit_DMA()使用DMA方式发送数据到SPI外设。
12HAL_SPI_Receive_DMA()使用DMA方式从SPI外设接收数据。
13HAL_SPI_TransmitReceive_DMA()使用DMA方式发送并接收数据到SPI外设。
14HAL_SPI_Abort()终止SPI外设操作。
15HAL_SPI_Abort_IT()终止SPI外设操作并启用中断。
16HAL_SPI_DMAPause()暂停SPI外设DMA传输。
17HAL_SPI_DMAResume()恢复SPI外设DMA传输。
18HAL_SPI_DMAStop()停止SPI外设DMA传输。
19HAL_SPI_IRQHandler()SPI外设中断处理程序。
20HAL_SPI_TxCpltCallback()发送完成回调函数。
21HAL_SPI_RxCpltCallback()接收完成回调函数。
22HAL_SPI_TxRxCpltCallback()发送接收完成回调函数。
23HAL_SPI_TxHalfCpltCallback()发送一半完成回调函数。
24HAL_SPI_RxHalfCpltCallback()接收一半完成回调函数。
25HAL_SPI_TxRxHalfCpltCallback()发送接收一半完成回调函数。
26HAL_SPI_ErrorCallback()SPI外设错误回调函数。
27HAL_SPI_AbortCpltCallback()终止完成回调函数。
28HAL_SPI_GetState()获取SPI外设状态。
29HAL_SPI_GetError()获取SPI外设错误状态。

以下是使用模板:

#include "stm32f4xx_hal.h"

int main(void) {
    // HAL初始化
    HAL_Init();
    
    // 初始化SPI外设
    HAL_SPI_Init();
    
    // 初始化SPI外设相关的MCU外设引脚或资源
    HAL_SPI_MspInit();
    
    // 进行其他操作...
    
    // 发送数据到SPI外设
    HAL_SPI_Transmit();
    
    // 从SPI外设接收数据
    HAL_SPI_Receive();
    
    // 使用中断方式发送数据到SPI外设
    HAL_SPI_Transmit_IT();
    
    // 使用DMA方式发送数据到SPI外设
    HAL_SPI_Transmit_DMA();
    
    // 终止SPI外设操作
    HAL_SPI_Abort();
    
    // 获取SPI外设状态
    HAL_SPI_GetState();
    
    return 0;
}

1.1 HAL_SPI_Init

函数名HAL_SPI_Init
函数原形HAL_StatusTypeDef HAL_SPI_Init(SPI_HandleTypeDef *hspi)
功能描述初始化SPI外设
输入参数hspi:SPI句柄结构体指针
输出参数
返回值HAL_StatusTypeDef:函数执行状态
先决条件
被调用函数

1.2 HAL_SPI_DeInit

函数名HAL_SPI_DeInit
函数原形HAL_StatusTypeDef HAL_SPI_DeInit(SPI_HandleTypeDef *hspi)
功能描述复位SPI外设
输入参数hspi:SPI句柄结构体指针
输出参数
返回值HAL_StatusTypeDef:函数执行状态
先决条件
被调用函数

1.3 HAL_SPI_MspInit

函数名HAL_SPI_MspInit
函数原形void HAL_SPI_MspInit(SPI_HandleTypeDef *hspi)
功能描述初始化SPI外设的时钟、GPIO和DMA相关GPIO口配置
输入参数hspi:SPI句柄结构体指针
输出参数
返回值
先决条件
被调用函数

1.4 HAL_SPI_MspDeInit

函数名HAL_SPI_MspDeInit
函数原形void HAL_SPI_MspDeInit(SPI_HandleTypeDef *hspi)
功能描述反初始化SPI外设的时钟、GPIO和DMA相关GPIO口配置
输入参数hspi:SPI句柄结构体指针
输出参数
返回值
先决条件
被调用函数

1.5 HAL_SPI_Transmit

函数名HAL_SPI_Transmit
函数原形HAL_StatusTypeDef HAL_SPI_Transmit(SPI_HandleTypeDef *hspi, uint8_t *pData, uint16_t Size, uint32_t Timeout)
功能描述在阻塞模式下发送SPI数据
输入参数 1hspi:SPI句柄结构体指针
输入参数 2pData:要发送的数据缓冲区指针
输入参数 3Size:要发送的数据大小
输入参数 4Timeout:超时时间(单位:毫秒)
输出参数
返回值HAL_StatusTypeDef:函数执行状态
先决条件
被调用函数

1.6 HAL_SPI_Receive

函数名HAL_SPI_Receive
函数原形HAL_StatusTypeDef HAL_SPI_Receive(SPI_HandleTypeDef *hspi, uint8_t *pData, uint16_t Size, uint32_t Timeout)
功能描述在阻塞模式下接收SPI数据
输入参数 1hspi:SPI句柄结构体指针
输入参数 2pData:接收数据的缓冲区指针
输入参数 3Size:要接收的数据大小
输入参数 4Timeout:超时时间(单位:毫秒)
输出参数
返回值HAL_StatusTypeDef:函数执行状态
先决条件
被调用函数

1.7 HAL_SPI_TransmitReceive

函数名HAL_SPI_TransmitReceive
函数原形HAL_StatusTypeDef HAL_SPI_TransmitReceive(SPI_HandleTypeDef *hspi, uint8_t *pTxData, uint8_t *pRxData, uint16_t Size, uint32_t Timeout)
功能描述在阻塞模式下同时发送和接收SPI数据
输入参数 1hspi:SPI句柄结构体指针
输入参数 2pTxData:要发送的数据缓冲区指针
输入参数 3pRxData:接收数据的缓冲区指针
输入参数 4Size:要发送/接收的数据大小
输入参数 5Timeout:超时时间(单位:毫秒)
输出参数
返回值HAL_StatusTypeDef:函数执行状态
先决条件
被调用函数

1.8 HAL_SPI_Transmit_IT

函数名HAL_SPI_Transmit_IT
函数原形HAL_StatusTypeDef HAL_SPI_Transmit_IT(SPI_HandleTypeDef *hspi, uint8_t *pData, uint16_t Size)
功能描述在非阻塞模式下发送SPI数据
输入参数 1hspi:SPI句柄结构体指针
输入参数 2pData:要发送的数据缓冲区指针
输入参数 3Size:要发送的数据大小
输出参数
返回值

| HAL_StatusTypeDef:函数执行状态 |
| 先决条件 | 无 |
| 被调用函数 | 无 |


1.9 HAL_SPI_Receive_IT

函数名HAL_SPI_Receive_IT
函数原形HAL_StatusTypeDef HAL_SPI_Receive_IT(SPI_HandleTypeDef *hspi, uint8_t *pData, uint16_t Size)
功能描述在非阻塞模式下接收SPI数据
输入参数 1hspi:SPI句柄结构体指针
输入参数 2pData:接收数据的缓冲区指针
输入参数 3Size:要接收的数据大小
输出参数
返回值HAL_StatusTypeDef:函数执行状态
先决条件
被调用函数

1.10 HAL_SPI_TransmitReceive_IT

函数名HAL_SPI_TransmitReceive_IT
函数原形HAL_StatusTypeDef HAL_SPI_TransmitReceive_IT(SPI_HandleTypeDef *hspi, uint8_t *pTxData, uint8_t *pRxData, uint16_t Size)
功能描述在非阻塞模式下同时发送和接收SPI数据
输入参数 1hspi:SPI句柄结构体指针
输入参数 2pTxData:要发送的数据缓冲区指针
输入参数 3pRxData:接收数据的缓冲区指针
输入参数 4Size:要发送/接收的数据大小
输出参数
返回值HAL_StatusTypeDef:函数执行状态
先决条件
被调用函数

该文档修改记录:

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

总结

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

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

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

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

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

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

打赏作者

常驻客栈

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

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

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

打赏作者

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

抵扣说明:

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

余额充值