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

1 该驱动函数预览
- 1.15 HAL_UART_DMAResume
- 1.16 HAL_UART_DMAStop
- 1.17 HAL_UART_Abort
- 1.18 HAL_UART_AbortTransmit
- 1.19 HAL_UART_AbortReceive
- 1.20 HAL_UART_Abort_IT
- 1.21 HAL_UART_AbortTransmit_IT
- 1.22 HAL_UART_AbortReceive_IT
- 1.23 HAL_UART_IRQHandler
- 1.24 HAL_UART_TxCpltCallback
- 1.25 HAL_UART_TxHalfCpltCallback
- 1.26 HAL_UART_RxCpltCallback
该文档修改记录：
总结

1 该驱动函数预览

序号	函数名	描述
1	HAL_UART_Init()	初始化UART。
2	HAL_HalfDuplex_Init()	初始化半双工模式的UART。
3	HAL_LIN_Init()	初始化LIN模式的UART。
4	HAL_MultiProcessor_Init()	初始化多处理器模式的UART。
5	HAL_UART_DeInit()	反初始化UART。
6	HAL_UART_MspInit()	初始化UART的底层硬件资源。
7	HAL_UART_MspDeInit()	反初始化UART的底层硬件资源。
8	HAL_UART_Transmit()	发送UART数据。
9	HAL_UART_Receive()	接收UART数据。
10	HAL_UART_Transmit_IT()	使用中断发送UART数据。
11	HAL_UART_Receive_IT()	使用中断接收UART数据。
12	HAL_UART_Transmit_DMA()	使用DMA发送UART数据。
13	HAL_UART_Receive_DMA()	使用DMA接收UART数据。
14	HAL_UART_DMAPause()	暂停UART的DMA传输。
15	HAL_UART_DMAResume()	恢复UART的DMA传输。
16	HAL_UART_DMAStop()	停止UART的DMA传输。
17	HAL_UART_Abort()	中止UART的传输。
18	HAL_UART_AbortTransmit()	中止UART的发送。
19	HAL_UART_AbortReceive()	中止UART的接收。
20	HAL_UART_Abort_IT()	使用中断中止UART的传输。
21	HAL_UART_AbortTransmit_IT()	使用中断中止UART的发送。
22	HAL_UART_AbortReceive_IT()	使用中断中止UART的接收。
23	HAL_UART_IRQHandler()	UART中断处理函数。
24	HAL_UART_TxCpltCallback()	UART发送完成回调函数。
25	HAL_UART_TxHalfCpltCallback()	UART半发送完成回调函数。
26	HAL_UART_RxCpltCallback()	UART接收完成回调函数。
27	HAL_UART_RxHalfCpltCallback()	UART半接收完成回调函数。
28	HAL_UART_ErrorCallback()	UART错误回调函数。
29	HAL_UART_AbortCpltCallback()	UART中止完成回调函数。
30	HAL_UART_AbortTransmitCpltCallback()	UART发送中止完成回调函数。
31	HAL_UART_AbortReceiveCpltCallback()	UART接收中止完成回调函数。
32	HAL_LIN_SendBreak()	发送LIN总线的Break信号。
33	HAL_MultiProcessor_EnterMuteMode()	进入UART多处理器模式的静默模式。
34	HAL_MultiProcessor_ExitMuteMode()	退出UART多处理器模式的静默模式。
35	HAL_HalfDuplex_EnableTransmitter()	启用UART半双工模式的发送器。
36	HAL_HalfDuplex_EnableReceiver()	启用UART半双工模式的接收器。
37	HAL_UART_GetState()	获取UART状态。
38	HAL_UART_GetError()	获取UART错误状态。

1.15 HAL_UART_DMAResume

函数名	HAL_UART_DMAResume
函数原形	HAL_StatusTypeDef HAL_UART_DMAResume(UART_HandleTypeDef *huart)
功能描述	恢复UART DMA传输
输入参数	huart：UART句柄结构体指针
输出参数	无
返回值	HAL_StatusTypeDef：恢复状态
先决条件	无
被调用函数	无
案例	```c
	UART_HandleTypeDef huart;
	HAL_UART_DMAResume(&huart);
```

1.16 HAL_UART_DMAStop

函数名	HAL_UART_DMAStop
函数原形	HAL_StatusTypeDef HAL_UART_DMAStop(UART_HandleTypeDef *huart)
功能描述	停止UART DMA传

输 |
| 输入参数 | huart：UART句柄结构体指针 |
| 输出参数 | 无 |
| 返回值 | HAL_StatusTypeDef：停止状态 |
| 先决条件 | 无 |
| 被调用函数 | 无 |
| 案例 | c | | | UART_HandleTypeDef huart; | | | HAL_UART_DMAStop(&huart); | | |

1.17 HAL_UART_Abort

函数名	HAL_UART_Abort
函数原形	HAL_StatusTypeDef HAL_UART_Abort(UART_HandleTypeDef *huart)
功能描述	终止UART传输
输入参数	huart：UART句柄结构体指针
输出参数	无
返回值	HAL_StatusTypeDef：终止状态
先决条件	无
被调用函数	无
案例	```c
	UART_HandleTypeDef huart;
	HAL_UART_Abort(&huart);
```

1.18 HAL_UART_AbortTransmit

函数名	HAL_UART_AbortTransmit
函数原形	HAL_StatusTypeDef HAL_UART_AbortTransmit(UART_HandleTypeDef *huart)
功能描述	终止UART发送
输入参数	huart：UART句柄结构体指针
输出参数	无
返回值	HAL_StatusTypeDef：终止状态
先决条件	无
被调用函数	无
案例	```c
	UART_HandleTypeDef huart;
	HAL_UART_AbortTransmit(&huart);
```

1.19 HAL_UART_AbortReceive

函数名	HAL_UART_AbortReceive
函数原形	HAL_StatusTypeDef HAL_UART_AbortReceive(UART_HandleTypeDef *huart)
功能描述	终止UART接收
输入参数	huart：UART句柄结构体指针
输出参数	无
返回值	HAL_StatusTypeDef：终止状态
先决条件	无
被调用函数	无
案例	```c
	UART_HandleTypeDef huart;
	HAL_UART_AbortReceive(&huart);
```

1.20 HAL_UART_Abort_IT

函数名	HAL_UART_Abort_IT
函数原形	HAL_StatusTypeDef HAL_UART_Abort_IT(UART_HandleTypeDef *huart)
功能描述	中断终止UART传输
输入参数	huart：UART句柄结构体指针
输出参数	无
返回值	HAL_StatusTypeDef：终止状态
先决条件	无
被调用函数	无
案例	```c
	UART_HandleTypeDef huart;
	HAL_UART_Abort_IT(&huart);
```

1.21 HAL_UART_AbortTransmit_IT

函数名	HAL_UART_AbortTransmit_IT
函数原形	HAL_StatusTypeDef HAL_UART_AbortTransmit_IT(UART_HandleTypeDef *huart)
功能描述	中断终止UART发送
输入参数	huart：UART句柄结构体指针
输出参数	无
返回值	HAL_StatusTypeDef：终止状态
先决条件	无
被调用函数	无
案例	```c
	UART_HandleTypeDef huart;
	HAL_UART_AbortTransmit_IT(&huart);
```

1.22 HAL_UART_AbortReceive_IT

函数名	HAL_UART_AbortReceive_IT
函数原形	HAL_StatusTypeDef HAL_UART_AbortReceive_IT(UART_HandleTypeDef *huart)

|
| 功能描述 | 中断终止UART接收 |
| 输入参数 | huart：UART句柄结构体指针 |
| 输出参数 | 无 |
| 返回值 | HAL_StatusTypeDef：终止状态 |
| 先决条件 | 无 |
| 被调用函数 | 无 |
| 案例 | c | | | UART_HandleTypeDef huart; | | | HAL_UART_AbortReceive_IT(&huart); | | |

1.23 HAL_UART_IRQHandler

函数名	HAL_UART_IRQHandler
函数原形	void HAL_UART_IRQHandler(UART_HandleTypeDef *huart)
功能描述	UART中断处理函数
输入参数	huart：UART句柄结构体指针
输出参数	无
返回值	无
先决条件	无
被调用函数	无
案例	无

1.24 HAL_UART_TxCpltCallback

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

1.25 HAL_UART_TxHalfCpltCallback

函数名	HAL_UART_TxHalfCpltCallback
函数原形	void HAL_UART_TxHalfCpltCallback(UART_HandleTypeDef *huart)
功能描述	UART发送一半数据完成回调函数
输入参数	huart：UART句柄结构体指针
输出参数	无
返回值	无
先决条件	无
被调用函数	无
案例	无

1.26 HAL_UART_RxCpltCallback

函数名	HAL_UART_RxCpltCallback
函数原形	void HAL_UART_RxCpltCallback(UART_HandleTypeDef *huart)
功能描述	UART接收完成回调函数
输入参数	huart：UART句柄结构体指针
输出参数	无
返回值	无
先决条件	无
被调用函数	无
案例	无