单片机与物联网 / 系统课时
接入编码器与流式解析器
接入编码器与流式解析器
本篇把协议编码、串口接收缓冲区和解析状态机串起来,重点解决连续帧、半包和异常帧在真实字节流中的处理问题。完成后,同一条串口流可以稳定拆出完整消息。
学习目标
- 能把消息对象编码成字节帧,并送入接收缓冲区
- 能用状态机处理连续帧、半包和坏帧
- 能通过测试输出验证解析器不会因异常数据失步
先确定字节流边界
串口读取通常没有“消息”概念,一次 read 可能拿到半帧、一帧或多帧。因此解析器不能假设一次读取就对应一次消息,而应持续消费缓冲区中的字节。
下面用一个明确的示例协议演示:帧格式为 0xAA 起始字节、1 字节长度、1 字节类型、N 字节载荷和 1 字节校验和。这里的协议只是本课示例,实际项目应替换为设备协议规定的字段。

编码器负责生成完整帧
编码器应该集中处理长度字段、字段顺序和校验规则。这样发送端只关心业务数据,不需要在业务代码里手工拼接字节。
python
HEADER = 0xAA
def encode_frame(msg_type: int, payload: bytes) -> bytes:
"""示例协议:AA + 长度 + 类型 + 载荷 + 校验和。"""
if not 0 <= msg_type <= 0xFF:
raise ValueError("msg_type must fit in one byte")
if len(payload) > 255:
raise ValueError("payload too long")
length = 1 + len(payload) # 类型字段也属于长度
body = bytes([length, msg_type]) + payload
checksum = sum(body) & 0xFF
return bytes([HEADER]) + body + bytes([checksum])
frame = encode_frame(0x10, b"OK")
print(frame.hex(" "))预期输出
text
AA 03 10 4F 4B 7B校验和只覆盖示例协议中长度、类型和载荷字段。不要直接套用到实际设备;实际协议若规定 CRC、异或或其他范围,应以协议定义为准。
用状态机处理连续帧和半包
解析器的关键不是“一次找到一帧”,而是每次收到一段字节后都保留未完成的数据。下面的实现把缓冲区保存在解析器对象内部,因此连续调用 feed 也能自然处理半包。
python
HEADER = 0xAA
class StreamParser:
def __init__(self):
self.buffer = bytearray()
def feed(self, data: bytes) -> list[tuple[int, bytes]]:
self.buffer.extend(data)
frames = []
while True:
# 丢弃帧头之前的噪声,避免坏数据让解析器永久失步。
try:
start = self.buffer.index(HEADER)
except ValueError:
self.buffer.clear()
break
if start:
del self.buffer[:start]
if len(self.buffer) < 2:
break
length = self.buffer[1]
total = 1 + 1 + length + 1
if length < 1:
del self.buffer[0]
continue
if len(self.buffer) < total:
break
frame = bytes(self.buffer[:total])
body = frame[1:-1]
checksum = frame[-1]
if (sum(body) & 0xFF) != checksum:
# 校验失败时只丢掉当前帧头,继续寻找下一个合法帧。
del self.buffer[0]
continue
msg_type = frame[2]
payload = frame[3:-1]
frames.append((msg_type, payload))
del self.buffer[:total]
return frames
def encode_frame(msg_type: int, payload: bytes) -> bytes:
length = 1 + len(payload)
body = bytes([length, msg_type]) + payload
return bytes([HEADER]) + body + bytes([sum(body) & 0xFF])
parser = StreamParser()
frame1 = encode_frame(0x10, b"OK")
frame2 = encode_frame(0x20, b"42")
bad = bytearray(encode_frame(0x30, b"BAD"))
bad[-1] ^= 0xFF # 制造校验错误
print(parser.feed(frame1[:3]))
print(parser.feed(frame1[3:] + bytes(bad) + frame2))预期输出
text
[]
[(16, b'OK'), (32, b'42')]第一批只有半帧,所以结果为空,剩余字节会留在缓冲区。第二批补齐第一帧后,解析器继续遇到坏帧;坏帧被跳过后仍能找到后面的合法帧,说明解析没有因为单个异常消息而整体阻塞。
接入串口读循环
真实程序中,串口层只负责不断读取原始字节,再把数据交给 feed。不要在串口读取层按“本次读到多少字节”划分业务消息。
片段示例:需要把 serial 替换为项目当前使用的串口对象。
python
while True:
data = serial.read(256)
if not data:
continue
for msg_type, payload in parser.feed(data):
handle_message(msg_type, payload)其中 read(256) 的返回长度只是本次读取得到的字节数,不代表协议帧长度。解析器应成为唯一的消息边界判断层。这样即使设备连续发送多帧,或者操作系统一次只返回几个字节,业务层仍然只收到完整消息。
按自己的节奏,确认真正理解。