单片机与物联网 / 系统课时
串口协议与数据帧
串口协议与数据帧
串口接收的是连续字节流,本身并不知道一条消息从哪里开始、在哪里结束。本课设计一个包含帧头、长度、命令、数据和校验的简单协议,并用流式解析器同时处理粘连、半包、噪声和校验失败。
学习目标
- 说明数据帧各字段的职责与长度计算方式
- 从任意分段的字节流中提取完整帧
- 将解析器接入 STM32 中断或 DMA 接收流程
设计一条可解析的数据帧
本课使用如下格式:帧头 2 字节 + 长度 1 字节 + 命令 1 字节 + 数据 N 字节 + 校验 1 字节。长度字段只表示数据区字节数,因此整帧长度为 N + 5。
帧头固定为 0xAA 0x55,用于在连续字节流中寻找起点;命令字段区分业务操作;校验字段对“长度、命令和数据”逐字节异或。真实项目还可加入版本号、序号或 CRC,但双方必须对字段顺序、字节序和校验范围作出唯一约定。

粘连和不完整数据的本质
一次串口中断或一次 DMA 回调得到的字节数,不等于一条协议帧的长度。发送端连续发送两帧时,接收端可能一次得到两帧,这就是粘连;一帧跨越两次接收时,第一次只得到前半段,这就是不完整数据。
因此,接收函数只负责把新字节追加到缓冲区,解析器则反复执行三件事:先丢弃帧头前的噪声,再根据长度判断整帧是否到齐,最后校验并消费完整帧。数据不足时必须保留现有字节,等待下一批数据,而不是立即报错或清空缓冲区。
实现流式解析器
下面的完整 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;
}预期输出
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 空闲线接收,还要根据本次实际接收长度继续喂给同一个解析器。
缓冲区溢出、非法长度和连续校验失败都应计数。非法长度不能直接相信,否则一个错误字节可能让解析器长期等待不存在的大帧;校验失败时也不宜清空全部数据,而应向后移动一个字节重新寻找帧头。