【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);
示例
//程序开始:开启IT模式串口接收数据(注意不要在循环中开启,否则会导致数据未接收完全,就重新开启,导致数据丢失,在setup初始化部分开启一次即可
HAL_UART_Receive_IT(&huart2, receiveData, sizeof(receiveData));
//重定义回调函数
void HAL_UART_RxCpltCallback(UART_HandleTypeDef *huart)
{
//好习惯,先判断下中断是否来自huart2,因为其他usart触发中断也会调用次回调函数
if(huart == &huart2)
{
/*此处为逻辑代码*/
//最后注意重新打开串口IT模式接收,如果不重新开启,在后续数据传入时,串口将不再接收数据
HAL_UART_Receive_IT(&huart2, receiveData, sizeof(receiveData));
}
}
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,因为其他usart触发的DMA模式接收数据完成中断也使用的是该中断回调函数
if(huart == &huart2)
{
/*此处为逻辑代码*/
//最后注意重新打开串口DMA模式接收,否则在后续数据传入时,DMA会不再搬运数据
HAL_UARTEx_ReceiveToIdle_DMA(&huart2, receiveData, sizeof(receiveData));
//关闭”DMA传输过半中断”,防止接收数据长度大于一半的接收数据最大长度时 导致的再进入该中断回调函数
//注意 该关闭“DMA传输过半中断”在程序开头也要有 防止第一次接收的数据大于一半最大接收数据上限
__HAL_DMA_DISABLE_IT(&hdma_usart2_rx,DMA_IT_HT);
}
}
补充
USART勾选NVIC使能并添加了DMA的通道,不影响串口的基本的轮询发送数据的功能,勾选NVIC与添加DMA通道只是扩展了串口的功能,并不限制原有的基本功能
串口重定向为printf
原理
为了能使用printf()函数来进行数据的交互,就要进行函数的”重映射“,即重新定义c库函数printf()中调用的fputc()函数
fputc为__weak弱定义,方便我们修改重定义以此调用printf
应用
CubeMX配置
与轮询模式配置一致
因为中断模式与DMA模式收发数据异常
Keil5配置
勾选 “Use MicroLIB”
添加头文件
重写fputc()函数
int fputc(int ch,FILE *f)
{
uint8_t temp[1] = {ch};
//采用轮询方式发送1字节数据
HAL_UART_Transmit(&huart3,temp,1,2);
return ch;
}
最后,你就能调用 printf() 函数了!!!