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

[1 该驱动函数预览](#1 该驱动函数预览)
- [1.11 HAL_SPI_Transmit_DMA](#1.11 HAL_SPI_Transmit_DMA)
- [1.12 HAL_SPI_Receive_DMA](#1.12 HAL_SPI_Receive_DMA)
- [1.13 HAL_SPI_TransmitReceive_DMA](#1.13 HAL_SPI_TransmitReceive_DMA)
- [1.14 HAL_SPI_Abort](#1.14 HAL_SPI_Abort)
- [1.15 HAL_SPI_Abort_IT](#1.15 HAL_SPI_Abort_IT)
- [1.16 HAL_SPI_DMAPause](#1.16 HAL_SPI_DMAPause)
- [1.17 HAL_SPI_DMAResume](#1.17 HAL_SPI_DMAResume)
- [1.18 HAL_SPI_DMAStop](#1.18 HAL_SPI_DMAStop)
- [1.19 HAL_SPI_IRQHandler](#1.19 HAL_SPI_IRQHandler)
- [1.20 HAL_SPI_TxCpltCallback](#1.20 HAL_SPI_TxCpltCallback)
该文档修改记录：
总结

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外设错误状态。

以下是使用模板：

c 复制代码

#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.11 HAL_SPI_Transmit_DMA

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

1.12 HAL_SPI_Receive_DMA

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

1.13 HAL_SPI_TransmitReceive_DMA

函数名	HAL_SPI_TransmitReceive_DMA
函数原形	HAL_StatusTypeDef HAL_SPI_TransmitReceive_DMA(SPI_HandleTypeDef hspi, uint8_t pTxData, uint8_t *pRxData, uint16_t Size)
功能描述	在DMA模式下同时发送和接收SPI数据
输入参数 1	hspi：SPI句柄结构体指针
输入参数 2	pTxData：要发送的数据缓冲区指针
输入参数 3	pRxData：接收数据的缓冲区指针
输入参数 4	Size：要发送/接收的数据大小
输出参数

              | 无                                                           |

| 返回值 | HAL_StatusTypeDef：函数执行状态 |

| 先决条件 | 无 |

| 被调用函数 | 无 |

1.14 HAL_SPI_Abort

函数名	HAL_SPI_Abort
函数原形	HAL_StatusTypeDef HAL_SPI_Abort(SPI_HandleTypeDef *hspi)
功能描述	中止SPI传输
输入参数	hspi：SPI句柄结构体指针
输出参数	无
返回值	HAL_StatusTypeDef：函数执行状态
先决条件	无
被调用函数	无

1.15 HAL_SPI_Abort_IT

函数名	HAL_SPI_Abort_IT
函数原形	HAL_StatusTypeDef HAL_SPI_Abort_IT(SPI_HandleTypeDef *hspi)
功能描述	中止SPI传输（使用中断）
输入参数	hspi：SPI句柄结构体指针
输出参数	无
返回值	HAL_StatusTypeDef：函数执行状态
先决条件	无
被调用函数	无

1.16 HAL_SPI_DMAPause

函数名	HAL_SPI_DMAPause
函数原形	HAL_StatusTypeDef HAL_SPI_DMAPause(SPI_HandleTypeDef *hspi)
功能描述	暂停SPI的DMA传输
输入参数	hspi：SPI句柄结构体指针
输出参数	无
返回值	HAL_StatusTypeDef：函数执行状态
先决条件	无
被调用函数	无

1.17 HAL_SPI_DMAResume

函数名	HAL_SPI_DMAResume
函数原形	HAL_StatusTypeDef HAL_SPI_DMAResume(SPI_HandleTypeDef *hspi)
功能描述	恢复SPI的DMA传输
输入参数	hspi：SPI句柄结构体指针
输出参数	无
返回值	HAL_StatusTypeDef：函数执行状态
先决条件	无
被调用函数	无

1.18 HAL_SPI_DMAStop

函数名	HAL_SPI_DMAStop
函数原形	HAL_StatusTypeDef HAL_SPI_DMAStop(SPI_HandleTypeDef *hspi)
功能描述	停止SPI的DMA传输
输入参数	hspi：SPI句柄结构体指针
输出参数	无
返回值	HAL_StatusTypeDef：函数执行状态
先决条件	无
被调用函数	无

1.19 HAL_SPI_IRQHandler

函数名	HAL_SPI_IRQHandler
函数原形	void HAL_SPI_IRQHandler(SPI_HandleTypeDef *hspi)
功能描述	SPI外设的中断处理函数
输入参数	hspi：SPI句柄结构体指针
输出参数	无
返回值	无
先决条件	无
被调用函数	无

1.20 HAL_SPI_TxCpltCallback

函数名	HAL_SPI_TxCpltCallback
函数原形	void HAL_SPI_TxCpltCallback(SPI_HandleTypeDef *hspi)
功能描述	SPI发送完成回调函数
输入参数	hspi：SPI句柄结构体指针
输出参数	无
返回值	无
先决条件	无
被调用函数	无

该文档修改记录：

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

总结

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

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

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

1 该驱动函数预览

1.11 HAL_SPI_Transmit_DMA

1.12 HAL_SPI_Receive_DMA

1.13 HAL_SPI_TransmitReceive_DMA

1.14 HAL_SPI_Abort

1.15 HAL_SPI_Abort_IT

1.16 HAL_SPI_DMAPause

1.17 HAL_SPI_DMAResume

1.18 HAL_SPI_DMAStop

1.19 HAL_SPI_IRQHandler

1.20 HAL_SPI_TxCpltCallback

该文档修改记录：

总结

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

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