单片机与物联网 / 系统课时
定位丢字节、乱码与收发超时
定位丢字节、乱码与收发超时
UART 通道出现乱码、缺少字节或等待超时,先区分线上信号错误、硬件接收溢出和应用缓冲区丢弃,再决定改波特率、调整中断或修复消费逻辑。这里用 STM32F407 的 USART2 建立一套可复测的定位方法。
学习目标
- 通过波形与串口参数判断乱码是否发生在物理链路。
- 利用 HAL 错误码和接收计数区分 ORE 与软件缓冲区溢出。
- 按统一测试负载定位阻塞和超时,并完成修复验收。
固定条件,复现故障
以 STM32F407 USART2 为例,PA2 是 TX、PA3 是 RX,复用功能为 AF7。连接 3.3 V TTL USB 转串口时,板端 TX 接适配器 RX、板端 RX 接适配器 TX,并共地;不可把 RS-232 电平直接接到 MCU 引脚。
两端统一为 115200 bit/s、8 数据位、无校验、1 停止位(8N1)、无硬件流控。对端每隔 10 ms 发送 16 字节 00 01 … 0F,连续发送 1000 组,总计 16000 字节。记录收到的字节数、错误标志及丢弃计数;复测前清零统计量,并确保没有其他设备插入测试数据。
一个 8N1 字节占 10 位:115200 bit/s 时每位约 8.68 μs,每帧约 86.8 μs。这个间隔是判断中断处理是否过慢的基准。
先用波形定位乱码
逻辑分析仪 CH0 接 PA2、CH1 接 PA3,GND 接板端 GND,采样率设为 4 MHz 或更高,UART 解码设为 115200、8N1、LSB first。优先观察接收引脚 PA3,而不只看对端发送的软件日志。
- 接收引脚已乱码:比较单个位宽与预期 8.68 μs;若测出约 104 μs,优先核对是否有一端误设为 9600 bit/s。再检查共地、接线、电平和噪声。
- 线上解码正确而应用数据错误:检查接收回调、环形缓冲区写入位置,以及读取端是否跟得上;此时不要首先修改波特率。
- 完全没有起始位:检查 TX/RX 是否交叉、GPIO 是否配置 AF7、USART2 时钟与发送动作是否实际发生。

用错误标志和接收计数区分丢字节来源
STM32F4 UART HAL 驱动 的 HAL_UART_ErrorCallback() 可以读取 HAL_UART_GetError() 的位掩码;同一事件可能包含多种错误,因此应逐位判断,而不是用互斥的 else if。
| 现象或计数 | 含义与优先排查项 |
|---|---|
HAL_UART_ERROR_FE |
帧格式错误;核对波特率、停止位和信号完整性 |
HAL_UART_ERROR_PE |
校验错误;仅在启用校验时重点排查两端校验设置 |
HAL_UART_ERROR_NE |
检测到噪声;检查地线、走线和干扰 |
HAL_UART_ERROR_ORE |
接收数据未及时取走,新字节到达;检查中断延迟、优先级和接收是否持续启动 |
rx_sw_drop 增加 |
本示例的软件环形缓冲区满;检查主循环阻塞及消费速度 |
以下为片段示例,适用于 STM32CubeF4 HAL 的中断单字节接收诊断,依赖 CubeMX 已生成的 huart2、MX_USART2_UART_Init() 和 USART2 全局中断。将下列定义放入 main.c 的 USER CODE BEGIN 0 区;若工程已有同名 HAL 回调,应合并逻辑,不能重复定义。此诊断模式与同一个 UART 的 DMA 接收不能同时启用。
#define RX_RING_SIZE 128U
static uint8_t rx_one;
static volatile uint8_t rx_ring[RX_RING_SIZE];
static volatile uint16_t rx_head, rx_tail;
static volatile uint32_t rx_irq_bytes, rx_processed, rx_sw_drop, rx_mismatch;
static uint8_t rx_expected;
static volatile uint32_t rx_ore, rx_fe, rx_ne, rx_pe, rx_rearm_fail;
/* 仅在 HAL 接收状态空闲时启动下一次单字节接收。 */
static void UART2_StartRx(void)
{
if (huart2.RxState == HAL_UART_STATE_READY &&
HAL_UART_Receive_IT(&huart2, &rx_one, 1U) != HAL_OK) {
rx_rearm_fail++;
}
}
void HAL_UART_RxCpltCallback(UART_HandleTypeDef *h)
{
if (h->Instance != USART2) return;
rx_irq_bytes++;
uint16_t next = (uint16_t)((rx_head + 1U) % RX_RING_SIZE);
if (next == rx_tail) {
rx_sw_drop++; /* 软件队列满,不等于硬件 ORE。 */
} else {
rx_ring[rx_head] = rx_one;
rx_head = next;
}
UART2_StartRx();
}
void HAL_UART_ErrorCallback(UART_HandleTypeDef *h)
{
if (h->Instance != USART2) return;
uint32_t err = HAL_UART_GetError(h);
if (err & HAL_UART_ERROR_ORE) rx_ore++;
if (err & HAL_UART_ERROR_FE) rx_fe++;
if (err & HAL_UART_ERROR_NE) rx_ne++;
if (err & HAL_UART_ERROR_PE) rx_pe++;
/* 不在错误中断内打印;由主循环检查状态后重启。 */
}
void UART2_Poll(void)
{
UART2_StartRx();
if (rx_tail != rx_head) {
uint8_t value = rx_ring[rx_tail];
rx_tail = (uint16_t)((rx_tail + 1U) % RX_RING_SIZE);
if (value != rx_expected) rx_mismatch++;
rx_expected = (uint8_t)((value + 1U) & 0x0FU);
rx_processed++;
}
}在 USER CODE BEGIN 2(MX_USART2_UART_Init() 之后)调用一次 UART2_StartRx(),在主循环的 USER CODE BEGIN 3 持续调用 UART2_Poll();确认 USART2_IRQHandler() 已调用 HAL_UART_IRQHandler(&huart2)。通过调试器查看这些 volatile 计数,不要在中断回调里调用阻塞式 printf。
预期结果:链路正常且主循环及时消费时,16000 字节测试结束并排空缓冲区后,rx_irq_bytes = rx_processed = 16000,rx_sw_drop = rx_mismatch = rx_ore = rx_fe = rx_ne = rx_pe = 0。若主循环被长时间阻塞,可能出现 rx_sw_drop > 0;若中断无法及时读取外设,则可能出现 rx_ore > 0。实际计数依现场负载变化;rx_mismatch 比较测试序列,丢字节后也可能触发,不等同于物理层乱码。
分别修复溢出、阻塞与超时
硬件 ORE:先确认 USART2 IRQ 已启用且没有长期关中断的代码。不要在 IRQ 内发送日志、等待互斥锁或执行耗时解析。若连续字节量较大,改用 DMA 循环接收,在半传输、传输完成或 IDLE 事件中按读写位置处理数据;DMA 环形缓冲区仍须防止生产者覆盖尚未消费的数据。
软件缓冲区满:本示例 128 字节数组采用留空一格判断满,实际容量为 127 字节。以 115200 bit/s 连续满速输入计算,约 11 ms 就可能装满。增大缓冲区只能延缓溢出,必须同时缩短主循环阻塞时间,或者让消费端以足够速率持续读取。
接收超时:先区分 HAL_TIMEOUT 与“帧迟迟未收齐”。例如调用阻塞式 HAL_UART_Receive() 读取 32 字节,但对端只发了 16 字节,就可能等到所设超时;它并不证明线上丢了 16 字节。非阻塞接收应记录开始时间,用 HAL_GetTick() 检查帧间截止时间,同时允许协议层处理半包,避免把 HAL_BUSY 错判成超时。
修复后用相同的 16000 字节负载连续复测,再人为阻塞消费端制造软件丢弃,检查 rx_sw_drop 是否单独上升。最后恢复正常处理,确认计数归零后的整轮测试无丢失、乱码和超时,再撤下调试日志与人工故障注入。