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

设计简单串口协议

设计简单串口协议

直接收发字符串适合调试,却难以稳定区分命令、参数和消息边界。本课设计一套包含帧头、命令、长度、数据和校验字段的轻量协议,并用逐字节状态机从连续字节流中恢复完整通信帧。

学习目标

  • 能够定义字段清晰、长度受控的串口帧格式
  • 能够解释接收状态机的同步、收数和校验过程
  • 能够实现并验证一个可移植的逐字节协议解析器

协议字段与边界

本课采用固定双字节帧头,后接命令、数据长度、数据区和校验字节。字段顺序固定后,接收端不需要依赖换行符,也能在包含噪声或多帧连续到达的字节流中寻找边界。

字段 长度 示例 作用
帧头 2 字节 0xAA 0x55 标记新帧起点并帮助重新同步
命令 1 字节 0x01 表示业务动作,例如设置 LED
长度 1 字节 0x01 只表示数据区长度
数据 0~32 字节 0x01 携带命令参数
校验 1 字节 0x01 对命令、长度和数据逐字节异或

示例中的异或校验计算简单,适合教学和低风险控制消息,但检错能力弱。对可靠性要求更高的设备,应改用 CRC-8 或 CRC-16,并考虑加入序号、设备地址和应答字段。

接收状态机

解析器不能假设一次串口读取恰好得到一帧。DMA、中断或操作系统缓冲区都可能把数据拆开或合并,因此更稳妥的做法是每收到一个字节就推进一次状态。

串口协议接收状态机

状态机有三条关键规则。第一,只有连续识别到两个帧头字节才开始收帧;第二,长度超过缓冲区容量时立即丢弃当前帧;第三,校验完成后无论成功还是失败都复位,避免旧状态污染下一帧。实际固件还应增加帧内超时,例如若两个字节间隔超过设定值,就主动回到等待帧头状态。

基础接入方式

接收中断或 DMA 回调只负责把字节写入环形缓冲区,主循环再逐字节调用 parser_feed()。这样可以缩短中断占用时间,也便于把协议解析、命令执行和硬件驱动分开测试。

发送端必须严格按字段顺序组帧。以设置 LED 为例,命令为 0x01,数据长度为 1,数据为 0x01,校验值为 0x01 ^ 0x01 ^ 0x01 = 0x01,完整帧就是 AA 55 01 01 01 01。

完整可运行示例

下面的 C11 程序在主机上模拟连续串口字节流。字节流依次包含一个噪声字节、一个合法的 LED 命令、一个校验错误的 PING 帧和一个合法的 PING 帧。

c
#include <stdint.h>
#include <stdio.h>

enum {
    FRAME_HEAD_1 = 0xAA,
    FRAME_HEAD_2 = 0x55,
    MAX_PAYLOAD = 32
};

typedef enum {
    WAIT_HEAD_1,
    WAIT_HEAD_2,
    READ_COMMAND,
    READ_LENGTH,
    READ_DATA,
    READ_CHECKSUM
} RxState;

typedef struct {
    RxState state;
    uint8_t command;
    uint8_t length;
    uint8_t index;
    uint8_t payload[MAX_PAYLOAD];
    uint8_t checksum;
} ProtocolParser;

static void parser_reset(ProtocolParser *parser) {
    parser->state = WAIT_HEAD_1;
    parser->index = 0;
}

static void handle_frame(const ProtocolParser *parser) {
    switch (parser->command) {
        case 0x01:
            if (parser->length == 1) {
                printf("RX: LED_SET value=%u\n", (unsigned int)parser->payload[0]);
            } else {
                printf("RX error: LED_SET length=%u\n", (unsigned int)parser->length);
            }
            break;
        case 0x02:
            if (parser->length == 0) {
                printf("RX: PING\n");
            } else {
                printf("RX error: PING length=%u\n", (unsigned int)parser->length);
            }
            break;
        default:
            printf("RX: unknown command=0x%02X\n", (unsigned int)parser->command);
            break;
    }
}

static void parser_feed(ProtocolParser *parser, uint8_t byte) {
    switch (parser->state) {
        case WAIT_HEAD_1:
            if (byte == FRAME_HEAD_1) {
                parser->state = WAIT_HEAD_2;
            }
            break;
        case WAIT_HEAD_2:
            if (byte == FRAME_HEAD_2) {
                parser->state = READ_COMMAND;
            } else {
                parser->state = (byte == FRAME_HEAD_1) ? WAIT_HEAD_2 : WAIT_HEAD_1;
            }
            break;
        case READ_COMMAND:
            parser->command = byte;
            parser->checksum = byte;
            parser->state = READ_LENGTH;
            break;
        case READ_LENGTH:
            parser->length = byte;
            parser->checksum ^= byte;
            parser->index = 0;
            if (parser->length > MAX_PAYLOAD) {
                printf("RX error: length=%u exceeds max=%u\n",
                       (unsigned int)parser->length,
                       (unsigned int)MAX_PAYLOAD);
                parser_reset(parser);
            } else {
                parser->state = (parser->length == 0) ? READ_CHECKSUM : READ_DATA;
            }
            break;
        case READ_DATA:
            parser->payload[parser->index++] = byte;
            parser->checksum ^= byte;
            if (parser->index == parser->length) {
                parser->state = READ_CHECKSUM;
            }
            break;
        case READ_CHECKSUM:
            if (byte == parser->checksum) {
                handle_frame(parser);
            } else {
                printf("RX error: checksum expected=0x%02X actual=0x%02X\n",
                       (unsigned int)parser->checksum,
                       (unsigned int)byte);
            }
            parser_reset(parser);
            break;
    }
}

int main(void) {
    ProtocolParser parser = {0};
    const uint8_t stream[] = {
        0x00,
        0xAA, 0x55, 0x01, 0x01, 0x01, 0x01,
        0xAA, 0x55, 0x02, 0x00, 0x00,
        0xAA, 0x55, 0x02, 0x00, 0x02
    };

    parser_reset(&parser);
    for (size_t i = 0; i < sizeof(stream); ++i) {
        parser_feed(&parser, stream[i]);
    }

    return 0;
}

将代码保存为 uart_protocol_demo.c,使用 GCC 编译并运行:

bash
gcc -std=c11 -Wall -Wextra -Wpedantic uart_protocol_demo.c -o uart_protocol_demo
./uart_protocol_demo

预期输出

text
RX: LED_SET value=1
RX error: checksum expected=0x02 actual=0x00
RX: PING

把该程序移植到 STM32 时,保留解析器结构和 parser_feed(),把测试数组替换为 USART 接收缓冲区,并将 handle_frame() 中的打印操作替换为真实命令处理。不要在串口中断中执行耗时业务。

常见错误与练习

把总帧长误写入长度字段会导致接收端多读或少读数据;校验范围不一致会让每一帧都失败;未限制长度则可能写越界。协议文档必须明确字段顺序、字节数、校验范围、最大长度和多字节整数的端序。

练习一:增加命令 0x03,数据区包含两个字节的 16 位参数,规定高字节在前。验收时应能正确解析 AA 55 03 02 12 34 27,其中校验值为命令、长度和数据的异或结果。

练习二:为解析器增加帧内超时。初始条件是系统每 1 ms 调用一次超时检查;当接收状态不是 WAIT_HEAD_1 且连续 20 ms 没有新字节时复位。验收时,残缺帧不能影响随后到达的合法帧。

本课总结

  • 串口协议通过帧头、长度和校验把无边界字节流转换为可验证消息
  • 逐字节状态机能够处理拆包、粘包、噪声和校验失败
  • 长度上限、超时复位和中断最小化是协议稳定运行的关键边界

下一课预告

下一课将学习“串口日志与故障定位”,用分级日志和固定排查顺序识别乱码、无数据、丢包与接收溢出。

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

目录与阅读设置

阅读设置

17

记录一个想法

设计简单串口协议

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

登录哪都通