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

把帧编码封装成独立模块

把帧编码封装成独立模块

把字段、长度、转义和 CRC 集中到一个帧编码器后,业务代码只需要传入结构化数据,不再手工拼接字节。这样协议修改、单元测试和联调复用都会更容易控制。

学习目标

  • 能把协议字段编码集中到独立函数中
  • 能正确处理长度、转义与 CRC 的执行顺序
  • 能用十六进制结果验证编码器行为

为什么要独立封装

业务代码手工拼接帧时,最容易出现三个问题:字段顺序写错、长度统计范围不一致、CRC 与转义处理顺序混乱。编码逻辑一旦分散到多个调用点,同一个协议很快就会产生多套实现。

独立编码器的边界应该很清楚:输入是结构化字段,输出是可以直接发送的完整字节帧。业务层不关心缓冲区下标、转义细节或校验位计算。

一个常见的数据流可以固定为:组装未转义字段 → 计算长度 → 计算 CRC → 按协议规则转义 → 加入帧头尾。真正顺序应以设备协议规范为准,不要把“先转义还是先算 CRC”当成通用规则。

一个可测试的编码器

下面示例假设协议格式为:AA LEN ADDR CMD PAYLOAD CRC,其中 LEN 表示 ADDR + CMD + PAYLOAD 的字节数,CRC 使用 CRC-16/CCITT-FALSE。这里仅演示模块化结构,实际项目应替换为设备协议定义。

python
from typing import Iterable

START = 0xAA


def crc16_ccitt(data: Iterable[int]) -> int:
    crc = 0xFFFF
    for byte in data:
        crc ^= byte << 8
        for _ in range(8):
            crc = ((crc << 1) ^ 0x1021) & 0xFFFF if crc & 0x8000 else (crc << 1) & 0xFFFF
    return crc


def encode_frame(address: int, command: int, payload: bytes) -> bytes:
    if not 0 <= address <= 0xFF or not 0 <= command <= 0xFF:
        raise ValueError("address and command must be one byte")

    body = bytes([address, command]) + payload
    if len(body) > 0xFF:
        raise ValueError("payload is too large")

    crc = crc16_ccitt(body)
    # CRC 字节序必须按具体协议约定;这里采用高字节在前。
    frame = bytes([START, len(body)]) + body + crc.to_bytes(2, "big")
    return frame


frame = encode_frame(0x01, 0x10, bytes([0x20, 0x30]))
print(frame.hex(" "))

预期输出

text
aa 04 01 10 20 30 3a 4c

上面的示例故意把 CRC 独立为函数。这样协议字段编码、长度计算和校验计算都有明确边界,后续增加转义时也只需要扩展编码流水线,而不是修改所有业务调用点。

把转义放在协议边界

假设协议规定 0xAA、0xAB 和 0x7D 需要转义,那么不要在业务代码里发现特殊字节后临时替换。应由编码器统一完成,并明确 CRC 是对转义前数据还是转义后数据计算。

典型封装方式

可以把编码过程继续拆成几个职责单一的函数:build_body() 负责字段,append_crc() 负责校验,escape_bytes() 负责转义,build_frame() 负责最终拼装。拆分后,每一步都能单独测试边界值。

测试时至少覆盖空负载、最大允许负载、包含转义字节的负载,以及 CRC 字节本身需要转义的情况。不要只测试一条“正常帧”,因为编码器最容易在边界字节上出错。

什么时候不该让业务层参与编码

只要发送方存在两个以上调用场景,就不应让各个业务模块自己拼帧。业务层应该表达“发什么”,编码器负责表达“在线路上长什么样”。这种边界能让协议格式变化集中在一个位置,也使抓包后的原始字节更容易与测试样例逐一对应。

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

目录与阅读设置

阅读设置

17

记录一个想法

把帧编码封装成独立模块

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

登录哪都通