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

接入编码器与流式解析器

接入编码器与流式解析器

本篇把协议编码、串口接收缓冲区和解析状态机串起来,重点解决连续帧、半包和异常帧在真实字节流中的处理问题。完成后,同一条串口流可以稳定拆出完整消息。

学习目标

  • 能把消息对象编码成字节帧,并送入接收缓冲区
  • 能用状态机处理连续帧、半包和坏帧
  • 能通过测试输出验证解析器不会因异常数据失步

先确定字节流边界

串口读取通常没有“消息”概念,一次 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) 的返回长度只是本次读取得到的字节数,不代表协议帧长度。解析器应成为唯一的消息边界判断层。这样即使设备连续发送多帧,或者操作系统一次只返回几个字节,业务层仍然只收到完整消息。

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

目录与阅读设置

阅读设置

17

记录一个想法

接入编码器与流式解析器

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

登录哪都通