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日 |
第一次发布，介绍了该博客驱动所有函数的介绍及使用 |
总结
以上就是该博客驱动所有函数的介绍及使用的内容。
有不明白的地方欢迎留言；有建议欢迎留言，我后面编写文档好改进。
创作不容，如果文档对您有帮助，记得给个赞。