单片机与物联网 / 系统课时

定位丢字节、乱码与收发超时

定位丢字节、乱码与收发超时

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,而不只看对端发送的软件日志。

  1. 接收引脚已乱码:比较单个位宽与预期 8.68 μs;若测出约 104 μs,优先核对是否有一端误设为 9600 bit/s。再检查共地、接线、电平和噪声。
  2. 线上解码正确而应用数据错误:检查接收回调、环形缓冲区写入位置,以及读取端是否跟得上;此时不要首先修改波特率。
  3. 完全没有起始位:检查 TX/RX 是否交叉、GPIO 是否配置 AF7、USART2 时钟与发送动作是否实际发生。

UART 乱码、丢字节及超时的分层定位流程

用错误标志和接收计数区分丢字节来源

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 接收不能同时启用。

c
#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 是否单独上升。最后恢复正常处理,确认计数归零后的整轮测试无丢失、乱码和超时,再撤下调试日志与人工故障注入。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

定位丢字节、乱码与收发超时

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通