【STM32 HAL库】串口通信与CubeMX配置

前言

本文为笔者学习串口通信知识的总结与复盘，基于keysking的系列视频，欢迎大家指正文中错误

串口通信概述

USART

Universal Synchronous / Asynchronous Receiver & Transmitter
= USART 通用同步或异步接收器和发送器
故UART为通用异步接收器和发送器

硬件连接原理

STM32：一般由芯片引脚引出的为TTL电平或RS232电平，通信协议为UART或USART协议
PC：一般为USB电平标准，通信协议为USB协议
因此，STM32与PC端进行通信时，必须克服“语言”的障碍，需要“翻译官”为他们统一“语言”，一般需要USB转TTL串口模块充当STM32与PC通信的“翻译官”“桥梁”

注意，一些开发板有板载USB转TTL串口模块、CH340芯片，就不用外接USB转TTL串口模块了

轮询模式

理论

应用

CubeMX配置

Keil5代码

串口发送数据

HAL_UART_Transmit(UART_HandleTypeDef *huart, uint8_t *pData, uint16_t Size, uint32_t Timeout)

串口接收数据

HAL_UART_Receive(UART_HandleTypeDef *huart, uint8_t *pData, uint16_t Size, uint32_t Timeout)

参数详解：

HAL_UART_Transmit：HAL库以UART协议发送（Transmit）
HAL_UART_Receive：HAL库以UART协议接收（Receive）
UART_HandleTypeDef *huart：指向UART_HandleTypeDef结构体的指针（如&huart1，也即发送数据或接收数据的串口
uint8_t *pData：指向要发送数据或接收数据的指针（如(uint8_t *)message
uint16_t Size：发送的数据或接收的数据的字节长度（如2或strlen(message)
Timeout：最大发送或接收时间（如100或HAL_MAX_DELAY

中断模式

理论

中断模式详解：
当开启串口的中断模式（HAL_UART_Transmit_IT()）发送数据后，串口开始发送数据。若发送数据寄存器为空 --> 触发串口中断 --> 进入串口中断处理函数USARTx_IRQHandler --> 判断中断触发源 --> 进入”发送数据寄存器空中断“的中断回调函数 --> 叫回CPU进行数据搬运（内存数据 --> 发送数据寄存器）

又因为，中断模式的收发为非阻塞，所以为了避免在处理数据时还没有完全接收数据，我们不应在串口中断处理函数中写具体代码，而应该在中断回调函数中实现代码

如UART发送数据完成中断回调函数：

__weak void HAL_UART_TxCpltCallback(UART_HandleTypeDef *huart)

保证了在完全接收数据后，再处理数据

补充一下

因为每个USART只有一个中断向量，但有很多能触发USART中断处理函数的中断源（比如“接收数据寄存器非空”中断 “发送完成”中断 都能触发中断从而进入USART的中断处理函数）
这些中断源都由中断向量指向唯一的中断处理函数，所以中断处理函数中，根据不同的中断源，内置了不同的中断回调函数（比如：中断源为“发送完成” 那么对应进入”发送完成“中断的中断回调函数）

应用

CubeMX配置

先正常配置

再使能中断

Keil5代码

串口发送数据

HAL_UART_Transmit_IT(UART_HandleTypeDef *huart, uint8_t *pData, uint16_t Size)

IT模式下“串口发送数据完成”中断回调函数

HAL_UART_TxCpltCallback(UART_HandleTypeDef *huart); 

串口接收数据

HAL_UART_Receive_IT(UART_HandleTypeDef *huart, uint8_t *pData, uint16_t Size)

IT模式下“串口接收数据完成”中断回调函数

void HAL_UART_RxCpltCallback(UART_HandleTypeDef *huart); 

以串口接收数据并处理为例：
一般在while前开启串口中断模式接收，再在UART文件中重新定义串口接收完成中断回调函数，实现接收数据后的代码逻辑

毕竟串口接收完成中断回调函数的_weak弱定义就是让用户拉出来重新定义回调函数从而实现代码逻辑的

DMA模式

理论

什么是DMA?
DMA = Direct Memory Access 直接内存访问
充当CPU的小助手，帮助在内存变量与接收/发送数据寄存器之间搬运数据，可以提高传输速度并减少CPU负担

应用

CubeMX配置

先配置USART参数

再使能USART中断
因为DMA模式的UART通信也需要调用中断回调等中断相关函数

最后配置DMA模式 默认参数即可

Keil5代码

串口发送数据

HAL_UART_Transmit_DMA(UART_HandleTypeDef *huart, uint8_t *pData, uint16_t Size)

串口接收数据

HAL_UART_Receive_DMA(UART_HandleTypeDef *huart, uint8_t *pData, uint16_t Size)

DMA模式下 “串口接收数据完成”中断回调函数

void HAL_UARTEx_RxEventCallback(UART_HandleTypeDef *huart,uint16_t Size);

串口接收不定长数据

利用串口空闲(idle)中断：
当RX引脚无后续数据传入时触发该中断，也即RX从忙碌转为空闲时触发，也即一帧数据包接收完成时触发

CubeMX配置同DMA模式
Keil5代码

• 串口接收函数

HAL_UARTEx_ReceiveToIdle_DMA(UART_HandleTypeDef *huart, uint8_t *pData, uint16_t Size)

Ex = 扩展   Receive = 接收   Idle = 空闲中断
*huart = 接收串口的指针地址 例：&huart2
*pData = 用来接收数据的变量的指针地址 例：receiveData
Size = 一次能接收的最大数据长度，一般填写接收数据变量的长度，防止数组越界 例：sizeof(receiveData)

• DMA模式下“串口接收数据完成”中断回调函数

void HAL_UARTEx_RxEventCallback(UART_HandleTypeDef *huart,uint16_t Size)

• 整体

//程序开始：开启DMA模式串口接收数据空闲中断，关闭DMA传输过半中断
HAL_UARTEx_ReceiveToIdle_DMA(&huart2, receiveData, sizeof(receiveData))
__HAL_DMA_DISABLE_IT(&hdma_usart2_rx,DMA_IT_HT):

//重定义回调函数
void HAL_UARTEx_RxEventCallback(UART_HandleTypeDef *huart,uint16_t Size){
//养成好习惯，先判断下中断是否来自这次工程所使用的huart2，因为huart1触发的DMA模式接收数据完成中断也使用的是该中断回调函数
	if(huart == &huart2)
		{/*此处为逻辑代码*/
		//最后注意重新打开串口DMA模式接收，如果不重新开启串口DMA模式接收，在后续数据传入后，就有可能DMA不再搬运数据，所以要再重新打开串口接收DMA模式
		HAL_UARTEx_ReceiveToIdle_DMA(&huart2, receiveData, sizeof(receiveData))
		//关闭”DMA传输过半中断”，防止接收数据长度大于一半的接收数据最大长度时所导致的再进入该中断回调函数
		//注意 该关闭“DMA传输过半中断”在程序开头也要有 防止第一次接收的数据大于一半最大接收数据上限
		__HAL_DMA_DISABLE_IT(&hdma_usart2_rx,DMA_IT_HT):
		}
}