单片机与物联网 / 系统课时
把帧编码封装成独立模块
把帧编码封装成独立模块
把字段、长度、转义和 CRC 集中到一个帧编码器后,业务代码只需要传入结构化数据,不再手工拼接字节。这样协议修改、单元测试和联调复用都会更容易控制。
学习目标
- 能把协议字段编码集中到独立函数中
- 能正确处理长度、转义与 CRC 的执行顺序
- 能用十六进制结果验证编码器行为
为什么要独立封装
业务代码手工拼接帧时,最容易出现三个问题:字段顺序写错、长度统计范围不一致、CRC 与转义处理顺序混乱。编码逻辑一旦分散到多个调用点,同一个协议很快就会产生多套实现。
独立编码器的边界应该很清楚:输入是结构化字段,输出是可以直接发送的完整字节帧。业务层不关心缓冲区下标、转义细节或校验位计算。
一个常见的数据流可以固定为:组装未转义字段 → 计算长度 → 计算 CRC → 按协议规则转义 → 加入帧头尾。真正顺序应以设备协议规范为准,不要把“先转义还是先算 CRC”当成通用规则。
一个可测试的编码器
下面示例假设协议格式为:AA LEN ADDR CMD PAYLOAD CRC,其中 LEN 表示 ADDR + CMD + PAYLOAD 的字节数,CRC 使用 CRC-16/CCITT-FALSE。这里仅演示模块化结构,实际项目应替换为设备协议定义。
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(" "))预期输出
aa 04 01 10 20 30 3a 4c上面的示例故意把 CRC 独立为函数。这样协议字段编码、长度计算和校验计算都有明确边界,后续增加转义时也只需要扩展编码流水线,而不是修改所有业务调用点。
把转义放在协议边界
假设协议规定 0xAA、0xAB 和 0x7D 需要转义,那么不要在业务代码里发现特殊字节后临时替换。应由编码器统一完成,并明确 CRC 是对转义前数据还是转义后数据计算。
典型封装方式
可以把编码过程继续拆成几个职责单一的函数:build_body() 负责字段,append_crc() 负责校验,escape_bytes() 负责转义,build_frame() 负责最终拼装。拆分后,每一步都能单独测试边界值。
测试时至少覆盖空负载、最大允许负载、包含转义字节的负载,以及 CRC 字节本身需要转义的情况。不要只测试一条“正常帧”,因为编码器最容易在边界字节上出错。
什么时候不该让业务层参与编码
只要发送方存在两个以上调用场景,就不应让各个业务模块自己拼帧。业务层应该表达“发什么”,编码器负责表达“在线路上长什么样”。这种边界能让协议格式变化集中在一个位置,也使抓包后的原始字节更容易与测试样例逐一对应。