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

串口协议与数据帧

串口协议与数据帧

串口接收的是连续字节流,本身并不知道一条消息从哪里开始、在哪里结束。本课设计一个包含帧头、长度、命令、数据和校验的简单协议,并用流式解析器同时处理粘连、半包、噪声和校验失败。

学习目标

  • 说明数据帧各字段的职责与长度计算方式
  • 从任意分段的字节流中提取完整帧
  • 将解析器接入 STM32 中断或 DMA 接收流程

设计一条可解析的数据帧

本课使用如下格式:帧头 2 字节 + 长度 1 字节 + 命令 1 字节 + 数据 N 字节 + 校验 1 字节。长度字段只表示数据区字节数,因此整帧长度为 N + 5。

帧头固定为 0xAA 0x55,用于在连续字节流中寻找起点;命令字段区分业务操作;校验字段对“长度、命令和数据”逐字节异或。真实项目还可加入版本号、序号或 CRC,但双方必须对字段顺序、字节序和校验范围作出唯一约定。

串口数据帧与流式解析流程

粘连和不完整数据的本质

一次串口中断或一次 DMA 回调得到的字节数,不等于一条协议帧的长度。发送端连续发送两帧时,接收端可能一次得到两帧,这就是粘连;一帧跨越两次接收时,第一次只得到前半段,这就是不完整数据。

因此,接收函数只负责把新字节追加到缓冲区,解析器则反复执行三件事:先丢弃帧头前的噪声,再根据长度判断整帧是否到齐,最后校验并消费完整帧。数据不足时必须保留现有字节,等待下一批数据,而不是立即报错或清空缓冲区。

实现流式解析器

下面的完整 C 程序先送入“噪声加半帧”,再送入“剩余半帧加另一整帧”。解析器不会因接收边界变化而改变结果。

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

#define HEAD_1 0xAAU
#define HEAD_2 0x55U
#define MAX_DATA_LEN 32U
#define RX_BUFFER_SIZE 128U

static uint8_t frame_checksum(const uint8_t *data, size_t len) {
    uint8_t value = 0U;
    for (size_t i = 0; i < len; ++i) {
        value ^= data[i];
    }
    return value;
}

static void remove_prefix(uint8_t *buffer, size_t *used, size_t count) {
    memmove(buffer, buffer + count, *used - count);
    *used -= count;
}

static void parse_frames(uint8_t *buffer, size_t *used) {
    while (*used >= 2U) {
        size_t head = 0U;
        while (head + 1U < *used &&
               (buffer[head] != HEAD_1 || buffer[head + 1U] != HEAD_2)) {
            ++head;
        }

        if (head > 0U) {
            remove_prefix(buffer, used, head);
        }
        if (*used < 5U) {
            return;
        }

        uint8_t data_len = buffer[2];
        if (data_len > MAX_DATA_LEN) {
            remove_prefix(buffer, used, 1U);
            continue;
        }

        size_t frame_len = (size_t)data_len + 5U;
        if (*used < frame_len) {
            return;  // 半帧保留到下一次接收
        }

        uint8_t expected = frame_checksum(&buffer[2], (size_t)data_len + 2U);
        if (expected == buffer[frame_len - 1U]) {
            printf("frame cmd=0x%02X len=%u data=", buffer[3], data_len);
            for (uint8_t i = 0U; i < data_len; ++i) {
                printf("%02X ", buffer[4U + i]);
            }
            printf("\n");
            remove_prefix(buffer, used, frame_len);
        } else {
            remove_prefix(buffer, used, 1U);  // 校验失败后重新寻找帧头
        }
    }
}

static void feed_bytes(uint8_t *buffer, size_t *used,
                       const uint8_t *chunk, size_t chunk_len) {
    if (*used + chunk_len > RX_BUFFER_SIZE) {
        *used = 0U;
        return;
    }
    memcpy(buffer + *used, chunk, chunk_len);
    *used += chunk_len;
    parse_frames(buffer, used);
}

int main(void) {
    uint8_t rx_buffer[RX_BUFFER_SIZE] = {0};
    size_t used = 0U;

    const uint8_t chunk_1[] = {0x00, 0xAA, 0x55, 0x02, 0x10, 0x01};
    const uint8_t chunk_2[] = {
        0x02, 0x11,
        0xAA, 0x55, 0x01, 0x20, 0xFF, 0xDE
    };

    feed_bytes(rx_buffer, &used, chunk_1, sizeof(chunk_1));
    feed_bytes(rx_buffer, &used, chunk_2, sizeof(chunk_2));
    return 0;
}

预期输出

text
frame cmd=0x10 len=2 data=01 02
frame cmd=0x20 len=1 data=FF

第一帧校验值为 0x02 ^ 0x10 ^ 0x01 ^ 0x02 = 0x11,第二帧校验值为 0x01 ^ 0x20 ^ 0xFF = 0xDE。即使输入被任意拆分或合并,最终提取结果仍然一致。

接入 STM32 时的边界

使用中断或 DMA 接收时,应在回调中快速记录新数据长度并追加到环形缓冲区,把帧搜索、校验和业务处理放到主循环或任务中,避免回调执行过久。若采用 DMA 空闲线接收,还要根据本次实际接收长度继续喂给同一个解析器。

缓冲区溢出、非法长度和连续校验失败都应计数。非法长度不能直接相信,否则一个错误字节可能让解析器长期等待不存在的大帧;校验失败时也不宜清空全部数据,而应向后移动一个字节重新寻找帧头。

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

目录与阅读设置

阅读设置

17

记录一个想法

串口协议与数据帧

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

登录哪都通