单片机与物联网 / 系统课时
用长度字段和 CRC 校验串口报文
用长度字段和 CRC 校验串口报文
UART 只传输连续字节,不会自动标出一条命令的边界。本篇定义固定帧头、长度与 CRC-16 的串口协议,编写可跨 DMA 回调保留状态的 C 解析器,并验证完整帧、分段到达的半帧和校验失败帧。
学习目标
- 明确长度的含义、CRC 参数与线上字节序,能够手工核对测试帧。
- 用状态机逐字节接收,区分暂未收齐与确实无效的报文。
- 通过可运行测试确认正确帧交付、截断帧等待、CRC 错误丢弃。
定义收发双方一致的字节格式
以 USART2、115200 baud、8N1 为例,报文按以下顺序发送。长度 L 只计算负载,不包括帧头、长度字节和 CRC;负载上限为 32 字节,所以整帧长度为 L + 5,最大 37 字节。
| 字段 | 长度 | 线上表示 |
|---|---|---|
| 同步帧头 | 2 字节 | 固定 AA 55 |
长度 L |
1 字节 | 00~20(十六进制,即 0~32) |
| 负载 | L 字节 |
原始二进制数据,允许出现 AA 55 |
| CRC | 2 字节 | CRC-16 的高字节在前、低字节在后 |
选择 CRC-16/CCITT-FALSE:多项式 0x1021、初值 0xFFFF、输入与输出均不反射、最终异或 0x0000。CRC 输入严格为长度字节加负载字节,不含 AA 55 和 CRC 本身。例子中 03 10 20 30 算得 CRC 为 0x6CCA,完整帧为 AA 55 03 10 20 30 6C CA。CRC 用于发现传输错误,不能代替身份认证。
按字节推进解析状态
解析器先寻找连续的 AA 55,读到 L 后检查是否超过 32,再精确收取 L 字节负载和末尾 2 字节 CRC。只有接收 CRC 低字节并验证通过时,才向业务层交付负载。即使负载包含 AA 55,也必须把它当作普通数据,而不能重新找帧头。
DMA、中断或串口驱动一次交付的字节数不等于完整帧长度。例如第一次收到 AA 55 03 10,解析器只记录已收到 1 个负载字节;下一次收到 20 30 6C CA,才能成功输出完整负载。遇到 L > 32 或 CRC 不一致就丢弃候选帧,重新寻找同步头。

编写并运行 C 状态机
下面是独立于 HAL 的 完整 C11 示例,保存为 uart_frame.c,可先在电脑上测试,再把 parser_feed 和 CRC 逻辑移入 STM32 工程。PENDING 表示字节仍未收齐,不是错误;ACCEPT 才表示完整合法帧。测试发送端和接收端共用 CRC 函数,避免人为引入算法参数差异。
#include <stdint.h>
#include <stdio.h>
#include <string.h>
#define MAX_PAYLOAD 32
typedef enum { SYNC_AA, SYNC_55, LEN, DATA, CRC_H, CRC_L } State;
typedef enum { PENDING, ACCEPT, REJECT_LEN, REJECT_CRC } Result;
typedef struct {
State state;
uint8_t len, used, payload[MAX_PAYLOAD];
uint16_t crc, received;
} Parser;
typedef struct { uint8_t len, payload[MAX_PAYLOAD]; } Packet;
static uint16_t crc_step(uint16_t crc, uint8_t data) {
// CRC-16/CCITT-FALSE 按高位优先计算,不反射位序
crc ^= (uint16_t)data << 8;
for (int bit = 0; bit < 8; ++bit)
crc = (crc & 0x8000u) ? (uint16_t)((crc << 1) ^ 0x1021u)
: (uint16_t)(crc << 1);
return crc;
}
static void parser_reset(Parser *p) {
p->state = SYNC_AA;
p->len = p->used = 0;
p->crc = 0xFFFFu;
p->received = 0;
}
static Result parser_feed(Parser *p, uint8_t byte, Packet *out) {
switch (p->state) {
case SYNC_AA:
if (byte == 0xAA) p->state = SYNC_55;
break;
case SYNC_55:
// 连续出现 AA 时,后一个 AA 仍可能是帧头起点
p->state = (byte == 0x55) ? LEN : (byte == 0xAA ? SYNC_55 : SYNC_AA);
break;
case LEN:
if (byte > MAX_PAYLOAD) { parser_reset(p); return REJECT_LEN; }
p->len = byte;
p->used = 0;
p->crc = crc_step(0xFFFFu, byte);
p->state = (byte == 0) ? CRC_H : DATA;
break;
case DATA:
p->payload[p->used++] = byte;
p->crc = crc_step(p->crc, byte);
if (p->used == p->len) p->state = CRC_H;
break;
case CRC_H:
p->received = (uint16_t)byte << 8;
p->state = CRC_L;
break;
case CRC_L: {
// CRC 两字节均到达才交付,半帧始终处于等待状态
p->received |= byte;
Result r = (p->received == p->crc) ? ACCEPT : REJECT_CRC;
if (r == ACCEPT) {
out->len = p->len;
memcpy(out->payload, p->payload, p->len);
}
parser_reset(p);
return r;
}
}
return PENDING;
}
static size_t encode(const uint8_t *data, uint8_t len, uint8_t *buf) {
buf[0] = 0xAA; buf[1] = 0x55; buf[2] = len;
// 发端与收端使用完全相同的 CRC 覆盖范围和初值
uint16_t crc = crc_step(0xFFFFu, len);
for (uint8_t i = 0; i < len; ++i) {
buf[i + 3] = data[i];
crc = crc_step(crc, data[i]);
}
buf[len + 3] = (uint8_t)(crc >> 8);
buf[len + 4] = (uint8_t)crc;
return (size_t)len + 5u;
}
static void process(Parser *p, const uint8_t *bytes, size_t n) {
int reported = 0;
for (size_t i = 0; i < n; ++i) {
Packet packet;
Result r = parser_feed(p, bytes[i], &packet);
if (r == ACCEPT) {
printf("有效帧 len=%u payload=", (unsigned)packet.len);
for (unsigned j = 0; j < packet.len; ++j)
printf("%02X%s", packet.payload[j], j + 1 == packet.len ? "" : " ");
putchar('\n');
reported = 1;
} else if (r == REJECT_CRC) {
puts("CRC不匹配,丢弃");
reported = 1;
} else if (r == REJECT_LEN) {
puts("长度越界,丢弃");
reported = 1;
}
}
if (!reported) puts("等待后续字节");
}
int main(void) {
Parser p = {0};
parser_reset(&p);
const uint8_t data[] = {0x10, 0x20, 0x30};
uint8_t raw[MAX_PAYLOAD + 5], corrupted[MAX_PAYLOAD + 5];
size_t n = encode(data, sizeof(data), raw);
printf("编码帧: ");
for (size_t i = 0; i < n; ++i) printf("%02X%s", raw[i], i + 1 == n ? "\n" : " ");
puts("完整帧:"); process(&p, raw, n);
// 模拟 DMA 将同一帧拆成两次回调,解析状态不可在回调间清零
puts("截断前4字节:"); process(&p, raw, 4);
puts("补齐剩余字节:"); process(&p, raw + 4, n - 4);
memcpy(corrupted, raw, n);
corrupted[n - 1] ^= 1u; // 故意破坏 CRC 低字节
puts("CRC错误帧:"); process(&p, corrupted, n);
puts("错误后接正确帧:"); process(&p, raw, n);
const uint8_t oversized[] = {0xAA, 0x55, 33};
puts("长度超过32:"); process(&p, oversized, sizeof(oversized));
return 0;
}用 GCC 编译并运行;Windows 上如使用 MinGW,可将运行命令改为 uart_frame.exe。
gcc -std=c11 -Wall -Wextra -Werror -pedantic uart_frame.c -o uart_frame && ./uart_frame预期输出:
编码帧: AA 55 03 10 20 30 6C CA
完整帧:
有效帧 len=3 payload=10 20 30
截断前4字节:
等待后续字节
补齐剩余字节:
有效帧 len=3 payload=10 20 30
CRC错误帧:
CRC不匹配,丢弃
错误后接正确帧:
有效帧 len=3 payload=10 20 30
长度超过32:
长度越界,丢弃可以看到,4 字节残帧既没有上报命令,也没有被误判为 CRC 错误;补齐后只交付一次。故意翻转 CRC 最后一位会触发拒绝,而下一条正确帧仍能解析。修改负载但不重算 CRC,也应得到 CRC 不匹配。
接入 STM32 DMA 并防止残帧卡住
在 STM32F407 的 CubeMX 工程中,可将 USART2 设为 115200、8 位数据、无校验、1 停止位;RX DMA 使用 64 字节环形缓冲。若 HAL 版本支持 HAL_UARTEx_ReceiveToIdle_DMA,可利用接收事件和 DMA 写入位置定位新增字节,逐字节送入同一个 Parser。环形缓冲发生回绕时要分两段消费,不可把回调的 Size 一律当作本次新增长度。
- 一帧最长 37 字节,在 115200、8N1 下理想线上传输约 3.2 ms。可以先设相邻接收字节空闲 20 ms为残帧超时阈值,超时后调用
parser_reset;这是应用层策略,应按实际链路间隔和调度延迟调整。 - 在接收回调中仅保存解析结果或投递消息到任务队列,不要直接执行耗时命令或打印大段日志;CRC 失败、长度越界分别计数,便于现场诊断。
- 接入真机后,先发送
AA 55 03 10 20 30 6C CA,再把同一帧分两批发送,最后把末字节改为CB。验收结果分别应为成功一次、补齐后成功一次、CRC 错误丢弃。
对于超长、CRC 失败和超时的报文,解析器只能丢弃当前候选帧并继续同步,不能执行其中的负载命令。这样即使串口 DMA 回调把一帧拆开,业务层仍只会收到长度正确且 CRC 校验通过的完整报文。