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

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

• [1 该驱动函数预览](#1 该驱动函数预览)
• • [1.1 HAL_IRDA_Init](#1.1 HAL_IRDA_Init)
  • [1.2 HAL_IRDA_DeInit](#1.2 HAL_IRDA_DeInit)
  • [1.3 HAL_IRDA_MspInit](#1.3 HAL_IRDA_MspInit)
  • [1.4 HAL_IRDA_MspDeInit](#1.4 HAL_IRDA_MspDeInit)
  • [1.5 HAL_IRDA_Transmit](#1.5 HAL_IRDA_Transmit)
  • [1.6 HAL_IRDA_Receive](#1.6 HAL_IRDA_Receive)
  • [1.7 HAL_IRDA_Transmit_IT](#1.7 HAL_IRDA_Transmit_IT)
  • [1.8 HAL_IRDA_Receive_IT](#1.8 HAL_IRDA_Receive_IT)
  • [1.9 HAL_IRDA_Transmit_DMA](#1.9 HAL_IRDA_Transmit_DMA)
  • [1.10 HAL_IRDA_Receive_DMA](#1.10 HAL_IRDA_Receive_DMA)
• 该文档修改记录：
• 总结

1 该驱动函数预览

序号	函数名	描述
1	HAL_IRDA_Init()	初始化IRDA接口。
2	HAL_IRDA_DeInit()	反初始化IRDA接口。
3	HAL_IRDA_MspInit()	初始化MCU外设相关的IRDA引脚或资源。
4	HAL_IRDA_MspDeInit()	反初始化MCU外设相关的IRDA引脚或资源。
5	HAL_IRDA_Transmit()	通过IRDA接口发送数据。
6	HAL_IRDA_Receive()	通过IRDA接口接收数据。
7	HAL_IRDA_Transmit_IT()	使用中断发送数据通过IRDA接口。
8	HAL_IRDA_Receive_IT()	使用中断接收数据通过IRDA接口。
9	HAL_IRDA_Transmit_DMA()	使用DMA发送数据通过IRDA接口。
10	HAL_IRDA_Receive_DMA()	使用DMA接收数据通过IRDA接口。
11	HAL_IRDA_DMAPause()	暂停IRDA DMA传输。
12	HAL_IRDA_DMAResume()	恢复IRDA DMA传输。
13	HAL_IRDA_DMAStop()	停止IRDA DMA传输。
14	HAL_IRDA_Abort()	终止IRDA传输。
15	HAL_IRDA_AbortTransmit()	终止IRDA发送传输。
16	HAL_IRDA_AbortReceive()	终止IRDA接收传输。
17	HAL_IRDA_Abort_IT()	使用中断终止IRDA传输。
18	HAL_IRDA_AbortTransmit_IT()	使用中断终止IRDA发送传输。
19	HAL_IRDA_AbortReceive_IT()	使用中断终止IRDA接收传输。
20	HAL_IRDA_IRQHandler()	IRDA中断处理程序。
21	HAL_IRDA_TxCpltCallback()	IRDA发送完成回调函数。
22	HAL_IRDA_TxHalfCpltCallback()	IRDA发送半完成回调函数。
23	HAL_IRDA_RxCpltCallback()	IRDA接收完成回调函数。
24	HAL_IRDA_RxHalfCpltCallback()	IRDA接收半完成回调函数。
25	HAL_IRDA_ErrorCallback()	IRDA错误回调函数。
26	HAL_IRDA_AbortCpltCallback()	IRDA终止完成回调函数。
27	HAL_IRDA_AbortTransmitCpltCallback()	IRDA终止发送完成回调函数。
28	HAL_IRDA_AbortReceiveCpltCallback()	IRDA终止接收完成回调函数。
29	HAL_IRDA_GetState()	获取IRDA接口的状态。
30	HAL_IRDA_GetError()	获取IRDA接口的错误状态。

以下是使用模板：

#include "stm32f4xx_hal.h"

int main(void) {
    // HAL初始化
    HAL_Init();
    
    // 初始化MCU外设相关的IRDA引脚或资源
    HAL_IRDA_MspInit();
    
    // 初始化IRDA接口
    HAL_IRDA_Init();
    
    // 进行其他操作...
    
    // 通过IRDA接口发送数据
    HAL_IRDA_Transmit();
    
    // 通过IRDA接口接收数据
    HAL_IRDA_Receive();
    
    // 使用DMA发送数据通过IRDA接口
    HAL_IRDA_Transmit_DMA();
    
    // 使用DMA接收数据通过IRDA接口
    HAL_IRDA_Receive_DMA();
    
    // IRDA中断处理程序
    HAL_IRDA_IRQHandler();
    
    // 获取IRDA接口的状态
    uint32_t irdaState = HAL_IRDA_GetState();
    
    // 获取IRDA接口的错误状态
    uint32_t irdaError = HAL_IRDA_GetError();
    
    // 反初始化IRDA接口
    HAL_IRDA_DeInit();
    
    // 反初始化MCU外设相关的IRDA引脚或资源
    HAL_IRDA_MspDeInit();
    
    return 0;
}

1.1 HAL_IRDA_Init

函数名	HAL_IRDA_Init
函数原形	HAL_StatusTypeDef HAL_IRDA_Init(IRDA_HandleTypeDef *hiirda)
功能描述	初始化 IRDA 外设
输入参数	hiirda：IRDA 句柄，指向一个 IRDA_HandleTypeDef 结构体
输出参数	无
返回值	HAL_StatusTypeDef：操作状态，可以是 HAL_OK 或 HAL_ERROR
先决条件	无
被调用函数	无

---

1.2 HAL_IRDA_DeInit

函数名	HAL_IRDA_DeInit
函数原形	HAL_StatusTypeDef HAL_IRDA_DeInit(IRDA_HandleTypeDef *hiirda)
功能描述	反初始化 IRDA 外设
输入参数	hiirda：IRDA 句柄，指向一个 IRDA_HandleTypeDef 结构体
输出参数	无
返回值	HAL_StatusTypeDef：操作状态，可以是 HAL_OK 或 HAL_ERROR
先决条件	无
被调用函数	无

---

1.3 HAL_IRDA_MspInit

函数名	HAL_IRDA_MspInit
函数原形	void HAL_IRDA_MspInit(IRDA_HandleTypeDef *hiirda)
功能描述	初始化 IRDA 外设的 GPIO、时钟和 DMA 配置
输入参数	hiirda：IRDA 句柄，指向一个 IRDA_HandleTypeDef 结构体
输出参数	无
返回值	无
先决条件	无
被调用函数	无

---

1.4 HAL_IRDA_MspDeInit

函数名	HAL_IRDA_MspDeInit
函数原形	void HAL_IRDA_MspDeInit(IRDA_HandleTypeDef *hiirda)
功能描述	反初始化 IRDA 外设的 GPIO、时钟和 DMA 配置
输入参数	hiirda：IRDA 句柄，指向一个 IRDA_HandleTypeDef 结构体
输出参数	无
返回值	无
先决条件	无
被调用函数	无

---

1.5 HAL_IRDA_Transmit

函数名	HAL_IRDA_Transmit
函数原形	HAL_StatusTypeDef HAL_IRDA_Transmit(IRDA_HandleTypeDef *hiirda, uint8_t *pData, uint16_t Size, uint32_t Timeout)
功能描述	通过 IRDA 外设发送数据
输入参数 1	hiirda：IRDA 句柄，指向一个 IRDA_HandleTypeDef 结构体
输入参数 2	pData：指向发送数据的缓冲区
输入参数 3	Size：要发送的数据长度
输入参数 4	Timeout：超时时间
输出参数	无
返回值	HAL_StatusTypeDef：操作状态，可以是 HAL_OK 或 HAL_ERROR
先决条件	无
被调用函数	无

---

1.6 HAL_IRDA_Receive

函数名	HAL_IRDA_Receive
函数原形	HAL_StatusTypeDef HAL_IRDA_Receive(IRDA_HandleTypeDef *hiirda, uint8_t *pData, uint16_t Size, uint32_t Timeout)
功能描述	通过 IRDA 外设接收数据
输入参数 1	hiirda：IRDA 句柄，指向一个 IRDA_HandleTypeDef 结构体
输入参数 2	pData：指向接收数据的缓冲区
输入参数 3	Size：要接收的数据长度
输入参数 4	Timeout：超时时间
输出参数	无
返回值	HAL_StatusTypeDef：操作状态，可以是 HAL_OK 或 HAL_ERROR
先决条件	无
被调用函数	无

---

1.7 HAL_IRDA_Transmit_IT

函数名	HAL_IRDA_Transmit_IT
函数原形	HAL_StatusTypeDef HAL_IRDA_Transmit_IT(IRDA_HandleTypeDef *hiirda, uint8_t *pData, uint16_t Size)
功能描述	使用中断方式通过 IRDA 外设发送数据
输入参数 1	hiirda：IRDA 句柄，指向一个 IRDA_HandleTypeDef 结构体
输入参数 2	pData：指向发送数据的缓冲区
输入参数 3	Size：要发送的数据长度
输出参数	无
返回值	HAL_StatusTypeDef：操作状态，可以是 HAL_OK 或 HAL_ERROR
先决条件	无
被调用函数	无

---

1.8 HAL_IRDA_Receive_IT

函数名	HAL_IRDA_Receive_IT
函数原形	HAL_StatusTypeDef HAL_IRDA_Receive_IT(IRDA_HandleTypeDef *hiirda, uint8_t *pData, uint16_t Size)
功能描述	使用中断方式通过 IRDA 外设接收数据
输入参数 1	hiirda：IRDA 句柄，指向一个 IRDA_HandleTypeDef 结构体
输入参数 2	pData：指向接收数据的缓冲区
输入参数 3	Size：要接收的数据长度
输出参数	无
返回值	HAL_StatusTypeDef：操作状态，可以是 HAL_OK 或 HAL_ERROR
先决条件	无
被调用函数	无

---

1.9 HAL_IRDA_Transmit_DMA

函数名	HAL_IRDA_Transmit_DMA
函数原形	HAL_StatusTypeDef HAL_IRDA_Transmit_DMA(IRDA_HandleTypeDef *hiirda, uint8_t *pData, uint16_t Size)
功能描述	使用 DMA 方式通过 IRDA 外设发送数据
输入参数 1	hiirda：IRDA 句柄，指向一个 IRDA_HandleTypeDef 结构体
输入参数 2	pData：指向发送数据的缓冲区
输入参数 3	Size：要发送的数据长度
输出参数	无
返回值	HAL_StatusTypeDef：操作状态，可以是 HAL_OK 或 HAL_ERROR
先决条件	无
被调用函数	无

---

1.10 HAL_IRDA_Receive_DMA

函数名	HAL_IRDA_Receive_DMA
函数原形	HAL_StatusTypeDef HAL_IRDA_Receive_DMA(IRDA_HandleTypeDef *hiirda, uint8_t *pData, uint16_t Size)
功能描述	使用 DMA 方式通过 IRDA 外设接收数据
输入参数 1	hiirda：IRDA 句柄，指向一个 IRDA_HandleTypeDef 结构体
输入参数 2	pData：指向接收数据的缓冲区
输入参数 3	Size：要接收的数据长度
输出参数	无
返回值	HAL_StatusTypeDef：操作状态，可以是 HAL_OK 或 HAL_ERROR
先决条件	无
被调用函数	无

---

该文档修改记录：

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

总结

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