【产出】 > 用 STM32 HAL 库完成串口收发:printf 重定向到串口打印调试信息,再用
HAL_UARTEx_ReceiveToIdle_DMA接收长度不固定的一帧数据,不用逐字节中断、不丢数据。
【版本】 > 依据 ST 官方 STM32F4 HAL 驱动源码中的使用说明(stm32f4xx_hal_uart.c,"How to use this driver" 一节)编写,CubeIDE 生成的工程通用,F1 / F4 / G4 等系列 HAL 接口一致。
一、HAL 官方给出的串口使用步骤
ST 在驱动源码开头写明了串口的标准用法,CubeMX 生成的代码就是按这个顺序组织的:
- 声明句柄
UART_HandleTypeDef huart。 - 在
HAL_UART_MspInit()里初始化底层资源:打开 USART 时钟;打开 GPIO 时钟,把 TX / RX 配成复用功能、上拉。 - 要用中断收发时:配置 USART 中断优先级并在 NVIC 里打开。
- 要用 DMA 收发时:配置 DMA 流,并用句柄关联到串口;同时打开 DMA 和 USART 两个中断。
- 在
huart.Init里设置波特率、字长、停止位、校验、流控和收发模式,调用HAL_UART_Init()。
在 CubeMX(.ioc)里勾选 USART、在 NVIC Settings 里打开中断、在 DMA Settings 里添加 RX 通道,以上代码都会自动生成。
二、printf 打印到串口
在 main.c 的 USER CODE 区域加入(GCC / CubeIDE 工具链):
/* USER CODE BEGIN 0 */
#include <stdio.h>
int __io_putchar(int ch)
{
HAL_UART_Transmit(&huart2, (uint8_t *)&ch, 1, HAL_MAX_DELAY);
return ch;
}
/* USER CODE END 0 */
之后就可以直接 printf("adc=%d\r\n", value);。
【注意】 > - CubeIDE 默认的 newlib-nano 不支持打印浮点数,
printf("%f")什么都不输出。需要在工程属性 → C/C++ Build → Settings → MCU Settings 里勾选 Use float with printf from newlib-nano。
- 换行写
\r\n。只写\n的话,有的串口助手不会回到行首。printf用的是阻塞发送,不要在中断里调用。
三、为什么接收要用"空闲中断 + DMA"
HAL_UART_Receive_IT(&huart, buf, 10) 这类普通接收函数,只有收满指定字节数才算完成。实际通信中,上位机命令、GPS 语句、Modbus 帧的长度大多不固定,收不满就一直等着。
HAL 的扩展接收函数多了一个完成条件。官方说明是:除了收满指定数量,**RX 线在最后一个字节之后空闲了一帧时间(IDLE 事件)**也算一次接收完成。
| 函数 | 方式 |
|---|---|
HAL_UARTEx_ReceiveToIdle() | 阻塞,函数返回前一直在轮询 |
HAL_UARTEx_ReceiveToIdle_IT() | 中断方式 |
HAL_UARTEx_ReceiveToIdle_DMA() | DMA 方式,最推荐,收数据期间 CPU 不用管 |
非阻塞方式下,每次接收完成(或出错),HAL 会调用回调函数:
- 正常收到数据:
HAL_UARTEx_RxEventCallback(huart, Size),Size就是这次收到的字节数。 - 出错:
HAL_UART_ErrorCallback(huart)。
四、完整示例
/* USER CODE BEGIN PV */
#define RX_BUF_SIZE 128
uint8_t rx_buf[RX_BUF_SIZE];
/* USER CODE END PV */
/* 在 main() 里、while(1) 之前启动接收 */
/* USER CODE BEGIN 2 */
HAL_UARTEx_ReceiveToIdle_DMA(&huart2, rx_buf, RX_BUF_SIZE);
__HAL_DMA_DISABLE_IT(huart2.hdmarx, DMA_IT_HT); /* 关掉半传输中断,见下方说明 */
/* USER CODE END 2 */
/* USER CODE BEGIN 4 */
void HAL_UARTEx_RxEventCallback(UART_HandleTypeDef *huart, uint16_t Size)
{
if (huart->Instance == USART2) {
/* rx_buf[0 .. Size-1] 是这一帧数据,这里只做拷贝或置标志,不要做耗时处理 */
handle_frame(rx_buf, Size);
/* 重新启动下一次接收 */
HAL_UARTEx_ReceiveToIdle_DMA(&huart2, rx_buf, RX_BUF_SIZE);
__HAL_DMA_DISABLE_IT(huart2.hdmarx, DMA_IT_HT);
}
}
void HAL_UART_ErrorCallback(UART_HandleTypeDef *huart)
{
if (huart->Instance == USART2) {
/* 溢出等错误后接收会停止,必须重新启动 */
HAL_UARTEx_ReceiveToIdle_DMA(&huart2, rx_buf, RX_BUF_SIZE);
__HAL_DMA_DISABLE_IT(huart2.hdmarx, DMA_IT_HT);
}
}
/* USER CODE END 4 */
为什么要关半传输中断:HAL 头文件里定义了三种接收事件,HAL_UART_RXEVENT_TC(传输完成)、HAL_UART_RXEVENT_HT(传输过半)、HAL_UART_RXEVENT_IDLE(空闲)。DMA 方式下,缓冲区收到一半时也会触发一次回调,一帧数据就会被拆成两次回调。只想按帧处理时,把半传输中断关掉最简单。也可以在回调里用 HAL_UARTEx_GetRxEventType(huart) 判断是哪种事件。
【提示】 > 缓冲区要大于可能出现的最长一帧。帧长度超过缓冲区时,收满会先触发一次 TC 事件,剩下的数据就跟下一次接收混在一起了。
五、常见问题
| 现象 | 原因与处理 |
|---|---|
| 回调从来不进 | .ioc 里没打开 USART 全局中断;DMA 方式还要同时打开 DMA 中断 |
| 只收到第一帧 | 回调里没有重新调用 ReceiveToIdle_DMA |
| 收着收着突然不收了 | 发生溢出(ORE)等错误后接收停止,在 HAL_UART_ErrorCallback 里重启接收 |
| 一帧被分成两次回调 | DMA 半传输事件,按上文关掉 HT 中断 |
| 乱码 | 两端波特率不一致;或者时钟配置和实际晶振不符,导致实际波特率偏差 |
参考资料
- ST 官方 STM32F4 HAL 驱动源码(stm32f4xx_hal_uart.c / .h):https://github.com/STMicroelectronics/stm32f4xx-hal-driver
评价 (0)