Skip to content

串口调试实战 ​

串口是最便宜的调试通道,也是最容易做错的通道。本文从「能打印」做到「能传结构化数据」,中间补齐三个工程必备件:中断接收、环形缓冲、帧协议。

波特率与误差 ​

异步通信靠双方各自的时钟对时,误差必须足够小:

误差 = (实际波特率 - 目标波特率) / 目标波特率 × 100%
误差范围后果
< 1%稳定
1%–2%偶发误码,长帧更明显
> 2%大量乱码,基本不可用

8MHz 晶振配 115200 时误差约 3.5%,这就是「用内部 RC 跑 115200 必乱码」的原因。解决办法:换用更高主频(如 72MHz)、改用外部晶振,或降低波特率到 9600 / 38400。

快速自查

能收到数据但内容随机 → 先怀疑波特率误差;一个字节都收不到 → 先查 TX/RX 是否交叉、是否共地。

中断接收 + 环形缓冲 ​

不要在主循环里 while 等字节。中断只负责把数据塞进缓冲,主循环按自己的节奏取。

c
#define RX_RB_SIZE 256

typedef struct {
    volatile unsigned short head;
    volatile unsigned short tail;
    unsigned char buf[RX_RB_SIZE];
} uart_rb_t;

static uart_rb_t s_rx;

void USART1_IRQHandler(void)
{
    /* 收到一个字节:读 SR 再读 DR 才能清 RXNE */
    if (USART1->SR & USART_SR_RXNE) {
        unsigned char byte = (unsigned char)(USART1->DR & 0xFF);
        unsigned short next = (s_rx.head + 1) & (RX_RB_SIZE - 1);
        if (next != s_rx.tail) {          /* 未满才写,满了丢弃 */
            s_rx.buf[s_rx.head] = byte;
            s_rx.head = next;
        }
    }

    /* 溢出错误必须清,否则会反复进中断 */
    if (USART1->SR & (USART_SR_ORE | USART_SR_FE | USART_SR_NE)) {
        (void)USART1->DR;
    }
}

主循环取数据:

c
int uart_read_byte(unsigned char *out)
{
    if (s_rx.head == s_rx.tail) return -1;
    *out = s_rx.buf[s_rx.tail];
    s_rx.tail = (s_rx.tail + 1) & (RX_RB_SIZE - 1);
    return 0;
}

为什么需要帧协议 ​

裸发数据在工程上不可用:干扰会让字节丢失、错位,接收端无法判断「这一包从哪开始、是否完整」。

一个够用的帧结构:

字段长度说明
帧头1固定 0xA5,用于定位起点
命令1区分数据类型
长度1载荷长度,0–64
载荷N实际数据
校验2CRC16(覆盖命令+长度+载荷)
c
#define FRAME_HEAD   0xA5
#define FRAME_MAX    64

/* CRC16/MODBUS,多项式 0xA001,初值 0xFFFF */
unsigned short crc16(const unsigned char *data, unsigned int len)
{
    unsigned short crc = 0xFFFF;
    while (len--) {
        crc ^= *data++;
        for (unsigned char i = 0; i < 8; i++) {
            if (crc & 1) crc = (crc >> 1) ^ 0xA001;
            else         crc >>= 1;
        }
    }
    return crc;
}

接收状态机 ​

用状态机解析,逐字节喂入,不依赖「一次收完整包」这种不可靠假设:

c
typedef enum { S_HEAD, S_CMD, S_LEN, S_DATA, S_CRC_L, S_CRC_H } parse_state_t;

typedef struct {
    parse_state_t state;
    unsigned char cmd;
    unsigned char len;
    unsigned char idx;
    unsigned char data[FRAME_MAX];
    unsigned short crc;
} frame_parser_t;

static frame_parser_t s_fp;

/* 返回 1 表示解析出一帧完整且校验通过的数据 */
int frame_feed(unsigned char byte)
{
    switch (s_fp.state) {
    case S_HEAD:
        if (byte == FRAME_HEAD) s_fp.state = S_CMD;
        break;

    case S_CMD:
        s_fp.cmd = byte;
        s_fp.state = S_LEN;
        break;

    case S_LEN:
        if (byte > FRAME_MAX) { s_fp.state = S_HEAD; break; }
        s_fp.len = byte;
        s_fp.idx = 0;
        s_fp.state = (byte == 0) ? S_CRC_L : S_DATA;
        break;

    case S_DATA:
        s_fp.data[s_fp.idx++] = byte;
        if (s_fp.idx >= s_fp.len) s_fp.state = S_CRC_L;
        break;

    case S_CRC_L:
        s_fp.crc = byte;
        s_fp.state = S_CRC_H;
        break;

    case S_CRC_H:
        s_fp.crc |= (unsigned short)byte << 8;
        s_fp.state = S_HEAD;
        {
            unsigned char tmp[FRAME_MAX + 2];
            tmp[0] = s_fp.cmd;
            tmp[1] = s_fp.len;
            for (unsigned char i = 0; i < s_fp.len; i++) tmp[2 + i] = s_fp.data[i];
            if (crc16(tmp, s_fp.len + 2) == s_fp.crc) return 1;
        }
        break;

    default:
        s_fp.state = S_HEAD;
        break;
    }
    return 0;
}

超时保护

只有状态机还不够。若在 S_DATA 中途断包,解析器会一直等后续字节,下一帧的帧头被当成数据吞掉。工程上要加帧内超时(如 50ms 无新字节就复位状态机)。

调试技巧 ​

需求做法
看原始字节串口助手切 HEX 模式,别用文本模式猜
确认波特率发 0x55(01010101),示波器量位宽
判断丢包发送端每帧带自增序号,接收端看是否连续
定位干扰降低波特率对比,若低速正常则为信号完整性问题
同时调试多机每个模块加前缀 [SENSOR] / [MOTOR],日志里区分来源

完整链路 ​

c
int main(void)
{
    board_clock_init();
    uart_init(115200);

    printf("boot v1.0, build %s %s\r\n", __DATE__, __TIME__);

    for (;;) {
        unsigned char b;
        while (uart_read_byte(&b) == 0) {
            if (frame_feed(b)) {
                handle_frame(s_fp.cmd, s_fp.data, s_fp.len);
            }
        }
        /* 其它任务 */
    }
}

做到这一步,你就有了一个能长期使用、不会因为干扰而崩掉的通信通道,后续接传感器、接屏、接上位机都基于它扩展。

以资料沉淀经验,用产品验证想法 · 嵌入式资料与产品文档