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

2024-07-13 18:26:01
开发
15

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

1 该驱动函数预览
该文档修改记录：
总结

1 该驱动函数预览

序号	函数名	描述
1	HAL_USART_Init()	初始化USART。
2	HAL_USART_DeInit()	反初始化USART。
3	HAL_USART_MspInit()	初始化USART的底层硬件资源。
4	HAL_USART_MspDeInit()	反初始化USART的底层硬件资源。
5	HAL_USART_Transmit()	发送USART数据。
6	HAL_USART_Receive()	接收USART数据。
7	HAL_USART_TransmitReceive()	发送并接收USART数据。
8	HAL_USART_Transmit_IT()	使用中断发送USART数据。
9	HAL_USART_Receive_IT()	使用中断接收USART数据。
10	HAL_USART_TransmitReceive_IT()	使用中断发送并接收USART数据。
11	HAL_USART_Transmit_DMA()	使用DMA发送USART数据。
12	HAL_USART_Receive_DMA()	使用DMA接收USART数据。
13	HAL_USART_TransmitReceive_DMA()	使用DMA发送并接收USART数据。
14	HAL_USART_DMAPause()	暂停USART的DMA传输。
15	HAL_USART_DMAResume()	恢复USART的DMA传输。
16	HAL_USART_DMAStop()	停止USART的DMA传输。
17	HAL_USART_Abort()	中止USART的传输。
18	HAL_USART_Abort_IT()	使用中断中止USART的传输。
19	HAL_USART_IRQHandler()	USART中断处理函数。
20	HAL_USART_TxCpltCallback()	USART发送完成回调函数。
21	HAL_USART_TxHalfCpltCallback()	USART半发送完成回调函数。
22	HAL_USART_RxCpltCallback()	USART接收完成回调函数。
23	HAL_USART_RxHalfCpltCallback()	USART半接收完成回调函数。
24	HAL_USART_TxRxCpltCallback()	USART发送接收完成回调函数。
25	HAL_USART_ErrorCallback()	USART错误回调函数。
26	HAL_USART_AbortCpltCallback()	USART中止完成回调函数。
27	HAL_USART_GetState()	获取USART状态。
28	HAL_USART_GetError()	获取USART错误状态。

1.1 HAL_USART_Init

函数名	HAL_USART_Init
函数原形	HAL_StatusTypeDef HAL_USART_Init(USART_HandleTypeDef *husart)
功能描述	初始化USART外设
输入参数	husart：USART句柄结构体指针
输出参数	无
返回值	HAL_StatusTypeDef：函数执行状态
先决条件	无
被调用函数	无
案例	```c
	USART_HandleTypeDef husart;
	HAL_StatusTypeDef status = HAL_USART_Init(&husart);
```

1.2 HAL_USART_DeInit

函数名	HAL_USART_DeInit
函数原形	HAL_StatusTypeDef HAL_USART_DeInit(USART_HandleTypeDef *husart)
功能描述	复位USART外设
输入参数	husart：USART句柄结构体指针
输出参数	无
返回值	HAL_StatusTypeDef：函数执行状态
先决条件	无
被调用函数	无
案例	```c
	USART_HandleTypeDef husart;
	HAL_StatusTypeDef status = HAL_USART_DeInit(&husart);
```

1.3 HAL_USART_MspInit

函数名	HAL_USART_MspInit
函数原形	void HAL_USART_MspInit(USART_HandleTypeDef *husart)
功能描述	初始化USART外设的GPIO和时钟
输入参数	husart：USART句柄结构体指针
输出参数	无
返回值	无
先决条件	无
被调用函数	无
案例	```c
	USART_HandleTypeDef husart;
	HAL_USART_MspInit(&husart);
```

1.4 HAL_USART_MspDeInit

函数名	HAL_USART_MspDeInit
函数原形	void HAL_USART_MspDeInit(USART_HandleTypeDef *husart)
功能描述	复位USART外设的GPIO和时钟
输入参数	husart：USART句柄结构体指针
输出参数	无
返回值	无
先决条件	无
被调用函数	无
案例	```c
	USART_HandleTypeDef husart;
	HAL_USART_MspDeInit(&husart);
```

1.5 HAL_USART_Transmit

函数名	HAL_USART_Transmit
函数原形	HAL_StatusTypeDef HAL_USART_Transmit(USART_HandleTypeDef husart, uint8_t pData, uint16_t Size, uint32_t Timeout)
功能描述	发送数据到USART外设
输入参数	husart：USART句柄结构体指针
	pData：要发送的数据缓冲区指针
	Size：要发送的数据大小
	Timeout：发送超时时间（毫秒）
输出参数	无
返回值	HAL_StatusTypeDef：函数执行状态
先决条件	无
被调用函数	无
案例	```c
	USART_HandleTypeDef husart;
	uint8_t data[] = {0x01, 0x02, 0x03};
	HAL_StatusTypeDef status = HAL_USART_Transmit(&husart, data, sizeof(data), 1000);
```

1.6 HAL_USART_Receive

函数名	HAL_USART_Receive
函数原形	HAL_StatusTypeDef HAL_USART_Receive(USART_HandleTypeDef husart, uint8_t pData, uint16_t Size, uint32_t Timeout)
功能描述	从USART外设接收数据
输入参数	husart：USART句柄结构体指

针 |
| | pData：接收数据的缓冲区指针 |
| | Size：要接收的数据大小 |
| | Timeout：接收超时时间（毫秒） |
| 输出参数 | 无 |
| 返回值 | HAL_StatusTypeDef：函数执行状态 |
| 先决条件 | 无 |
| 被调用函数 | 无 |
| 案例 | c | | | USART_HandleTypeDef husart; | | | uint8_t data[10]; | | | HAL_StatusTypeDef status = HAL_USART_Receive(&husart, data, sizeof(data), 1000); | | |

1.7 HAL_USART_TransmitReceive

函数名	HAL_USART_TransmitReceive
函数原形	HAL_StatusTypeDef HAL_USART_TransmitReceive(USART_HandleTypeDef husart, uint8_t pTxData, uint8_t *pRxData, uint16_t Size, uint32_t Timeout)
功能描述	发送和接收数据到USART外设
输入参数	husart：USART句柄结构体指针
	pTxData：要发送的数据缓冲区指针
	pRxData：接收数据的缓冲区指针
	Size：要发送和接收的数据大小
	Timeout：发送和接收超时时间（毫秒）
输出参数	无
返回值	HAL_StatusTypeDef：函数执行状态
先决条件	无
被调用函数	无
案例	```c
	USART_HandleTypeDef husart;
	uint8_t tx_data[] = {0x01, 0x02, 0x03};
	uint8_t rx_data[3];
	HAL_StatusTypeDef status = HAL_USART_TransmitReceive(&husart, tx_data, rx_data, sizeof(tx_data), 1000);
```

1.8 HAL_USART_Transmit_IT

函数名	HAL_USART_Transmit_IT
函数原形	HAL_StatusTypeDef HAL_USART_Transmit_IT(USART_HandleTypeDef husart, uint8_t pData, uint16_t Size)
功能描述	使用中断方式发送数据到USART外设
输入参数	husart：USART句柄结构体指针
	pData：要发送的数据缓冲区指针
	Size：要发送的数据大小
输出参数	无
返回值	HAL_StatusTypeDef：函数执行状态
先决条件	无
被调用函数	无
案例	```c
	USART_HandleTypeDef husart;
	uint8_t data[] = {0x01, 0x02, 0x03};
	HAL_StatusTypeDef status = HAL_USART_Transmit_IT(&husart, data, sizeof(data));
```

1.9 HAL_USART_Receive_IT

函数名	HAL_USART_Receive_IT
函数原形	HAL_StatusTypeDef HAL_USART_Receive_IT(USART_HandleTypeDef husart, uint8_t pData, uint16_t Size)
功能描述	使用中断方式从USART外设接收数据
输入参数	husart：USART句柄结构体指针
	pData：接收数据的缓冲区指针
	Size：要接收的数据大小
输出参数	无
返回值	HAL_StatusTypeDef：函数执行状态
先决条件	无
被调用函数	无
案例	```c
	USART_HandleTypeDef husart;
	uint8_t data[10];
	HAL_StatusTypeDef status = HAL_USART_Receive_IT(&husart, data, sizeof(data));
```

1.10 HAL_USART_TransmitReceive_IT

函数名	HAL_USART_TransmitReceive_IT
函数原形	HAL_StatusTypeDef HAL_USART_TransmitReceive_IT(USART_HandleTypeDef husart, uint8_t pTx

Data, uint8_t *pRxData, uint16_t Size) |
| 功能描述 | 使用中断方式发送和接收数据到USART外设 |
| 输入参数 | husart：USART句柄结构体指针 |
| | pTxData：要发送的数据缓冲区指针 |
| | pRxData：接收数据的缓冲区指针 |
| | Size：要发送和接收的数据大小 |
| 输出参数 | 无 |
| 返回值 | HAL_StatusTypeDef：函数执行状态 |
| 先决条件 | 无 |
| 被调用函数 | 无 |
| 案例 | c | | | USART_HandleTypeDef husart; | | | uint8_t tx_data[] = {0x01, 0x02, 0x03}; | | | uint8_t rx_data[3]; | | | HAL_StatusTypeDef status = HAL_USART_TransmitReceive_IT(&husart, tx_data, rx_data, sizeof(tx_data)); | | |

1.11 HAL_USART_Transmit_DMA

函数名	HAL_USART_Transmit_DMA
函数原形	HAL_StatusTypeDef HAL_USART_Transmit_DMA(USART_HandleTypeDef husart, uint8_t pData, uint16_t Size)
功能描述	使用DMA方式发送数据到USART外设
输入参数	husart：USART句柄结构体指针
	pData：要发送的数据缓冲区指针
	Size：要发送的数据大小
输出参数	无
返回值	HAL_StatusTypeDef：函数执行状态
先决条件	无
被调用函数	无
案例	```c
	USART_HandleTypeDef husart;
	uint8_t data[] = {0x01, 0x02, 0x03};
	HAL_StatusTypeDef status = HAL_USART_Transmit_DMA(&husart, data, sizeof(data));
```

1.12 HAL_USART_Receive_DMA

函数名	HAL_USART_Receive_DMA
函数原形	HAL_StatusTypeDef HAL_USART_Receive_DMA(USART_HandleTypeDef husart, uint8_t pData, uint16_t Size)
功能描述	使用DMA方式从USART外设接收数据
输入参数	husart：USART句柄结构体指针
	pData：接收数据的缓冲区指针
	Size：要接收的数据大小
输出参数	无
返回值	HAL_StatusTypeDef：函数执行状态
先决条件	无
被调用函数	无
案例	```c
	USART_HandleTypeDef husart;
	uint8_t data[10];
	HAL_StatusTypeDef status = HAL_USART_Receive_DMA(&husart, data, sizeof(data));
```

1.13 HAL_USART_TransmitReceive_DMA

函数名	HAL_USART_TransmitReceive_DMA
函数原形	HAL_StatusTypeDef HAL_USART_TransmitReceive_DMA(USART_HandleTypeDef husart, uint8_t pTxData, uint8_t *pRxData, uint16_t Size)
功能描述	使用DMA方式发送和接收数据到USART外设
输入参数	husart：USART句柄结构体指针
	pTxData：要发送的数据缓冲区指针
	pRxData：接收数据的缓冲区指针
	Size：要发送和接收的数据大小
输出参数	无
返回值	HAL_StatusTypeDef：函数执行状态
先决条件	无
被调用函数	无
案例	```c
	USART_HandleTypeDef husart;
	uint8_t tx_data[] = {0x01, 0x02, 0x03};
	uint8_t rx_data[3];
	HAL_StatusTypeDef status

= HAL_USART_TransmitReceive_DMA(&husart, tx_data, rx_data, sizeof(tx_data)); |
| ``` |

1.14 HAL_USART_DMAPause

函数名	HAL_USART_DMAPause
函数原形	HAL_StatusTypeDef HAL_USART_DMAPause(USART_HandleTypeDef *husart)
功能描述	暂停USART外设的DMA传输
输入参数	husart：USART句柄结构体指针
输出参数	无
返回值	HAL_StatusTypeDef：函数执行状态
先决条件	无
被调用函数	无
案例	```c
	USART_HandleTypeDef husart;
	HAL_StatusTypeDef status = HAL_USART_DMAPause(&husart);
```

该文档修改记录：

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

总结

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

原文地址:https://blog.csdn.net/qq_50808730/article/details/137537977 本文来自互联网用户投稿，该文观点仅代表作者本人，不代表本站立场。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如若转载，请注明出处：https://www.suanlizi.com/kf/1812070973269217280.html 如若内容造成侵权/违法违规/事实不符，请联系《酸梨子》网邮箱：1419361763@qq.com进行投诉反馈，一经查实，立即删除！

阅读全部