A47 STM32_HAL库函数 之 SPI通用驱动 -- A -- 所有函数的介绍及使用
1 该驱动函数预览
序号 | 函数名 | 描述 |
---|
1 | HAL_SPI_Init() | 初始化SPI外设。 |
2 | HAL_SPI_DeInit() | 反初始化SPI外设。 |
3 | HAL_SPI_MspInit() | 初始化SPI外设相关的MCU外设引脚或资源。 |
4 | HAL_SPI_MspDeInit() | 反初始化SPI外设相关的MCU外设引脚或资源。 |
5 | HAL_SPI_Transmit() | 发送数据到SPI外设。 |
6 | HAL_SPI_Receive() | 从SPI外设接收数据。 |
7 | HAL_SPI_TransmitReceive() | 发送并接收数据到SPI外设。 |
8 | HAL_SPI_Transmit_IT() | 使用中断方式发送数据到SPI外设。 |
9 | HAL_SPI_Receive_IT() | 使用中断方式从SPI外设接收数据。 |
10 | HAL_SPI_TransmitReceive_IT() | 使用中断方式发送并接收数据到SPI外设。 |
11 | HAL_SPI_Transmit_DMA() | 使用DMA方式发送数据到SPI外设。 |
12 | HAL_SPI_Receive_DMA() | 使用DMA方式从SPI外设接收数据。 |
13 | HAL_SPI_TransmitReceive_DMA() | 使用DMA方式发送并接收数据到SPI外设。 |
14 | HAL_SPI_Abort() | 终止SPI外设操作。 |
15 | HAL_SPI_Abort_IT() | 终止SPI外设操作并启用中断。 |
16 | HAL_SPI_DMAPause() | 暂停SPI外设DMA传输。 |
17 | HAL_SPI_DMAResume() | 恢复SPI外设DMA传输。 |
18 | HAL_SPI_DMAStop() | 停止SPI外设DMA传输。 |
19 | HAL_SPI_IRQHandler() | SPI外设中断处理程序。 |
20 | HAL_SPI_TxCpltCallback() | 发送完成回调函数。 |
21 | HAL_SPI_RxCpltCallback() | 接收完成回调函数。 |
22 | HAL_SPI_TxRxCpltCallback() | 发送接收完成回调函数。 |
23 | HAL_SPI_TxHalfCpltCallback() | 发送一半完成回调函数。 |
24 | HAL_SPI_RxHalfCpltCallback() | 接收一半完成回调函数。 |
25 | HAL_SPI_TxRxHalfCpltCallback() | 发送接收一半完成回调函数。 |
26 | HAL_SPI_ErrorCallback() | SPI外设错误回调函数。 |
27 | HAL_SPI_AbortCpltCallback() | 终止完成回调函数。 |
28 | HAL_SPI_GetState() | 获取SPI外设状态。 |
29 | HAL_SPI_GetError() | 获取SPI外设错误状态。 |
以下是使用模板:
#include "stm32f4xx_hal.h"
int main(void) {
HAL_Init();
HAL_SPI_Init();
HAL_SPI_MspInit();
HAL_SPI_Transmit();
HAL_SPI_Receive();
HAL_SPI_Transmit_IT();
HAL_SPI_Transmit_DMA();
HAL_SPI_Abort();
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数据 |
输入参数 1 | hspi:SPI句柄结构体指针 |
输入参数 2 | pData:要发送的数据缓冲区指针 |
输入参数 3 | Size:要发送的数据大小 |
输入参数 4 | Timeout:超时时间(单位:毫秒) |
输出参数 | 无 |
返回值 | 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数据 |
输入参数 1 | hspi:SPI句柄结构体指针 |
输入参数 2 | pData:接收数据的缓冲区指针 |
输入参数 3 | Size:要接收的数据大小 |
输入参数 4 | Timeout:超时时间(单位:毫秒) |
输出参数 | 无 |
返回值 | 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数据 |
输入参数 1 | hspi:SPI句柄结构体指针 |
输入参数 2 | pTxData:要发送的数据缓冲区指针 |
输入参数 3 | pRxData:接收数据的缓冲区指针 |
输入参数 4 | Size:要发送/接收的数据大小 |
输入参数 5 | Timeout:超时时间(单位:毫秒) |
输出参数 | 无 |
返回值 | 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数据 |
输入参数 1 | hspi:SPI句柄结构体指针 |
输入参数 2 | pData:要发送的数据缓冲区指针 |
输入参数 3 | Size:要发送的数据大小 |
输出参数 | 无 |
返回值 | |
| 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数据 |
输入参数 1 | hspi:SPI句柄结构体指针 |
输入参数 2 | pData:接收数据的缓冲区指针 |
输入参数 3 | Size:要接收的数据大小 |
输出参数 | 无 |
返回值 | 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数据 |
输入参数 1 | hspi:SPI句柄结构体指针 |
输入参数 2 | pTxData:要发送的数据缓冲区指针 |
输入参数 3 | pRxData:接收数据的缓冲区指针 |
输入参数 4 | Size:要发送/接收的数据大小 |
输出参数 | 无 |
返回值 | HAL_StatusTypeDef:函数执行状态 |
先决条件 | 无 |
被调用函数 | 无 |
该文档修改记录:
修改时间 | 修改说明 |
---|
2024年4月30日 | 第一次发布,介绍了该博客驱动所有函数的介绍及使用 |
总结
以上就是该博客驱动所有函数的介绍及使用的内容。
有不明白的地方欢迎留言;有建议欢迎留言,我后面编写文档好改进。
创作不容,如果文档对您有帮助,记得给个赞。