单片机与物联网 / 系统课时
接收端怎样安全反转义
接收端怎样安全反转义
本课解决串口协议接收端在遇到转义数据时的解析风险:既要还原被编码的字节,也要正确处理帧尾出现孤立转义符等异常输入,并明确校验应落在原始数据还是线路编码数据上。
学习目标
- 能区分线路编码数据与还原后的原始数据
- 能实现按状态处理转义符、正常字节和异常结尾
- 能确定校验字段应在哪一层计算与验证
反转义真正要处理什么
假设协议规定 0x7E 为帧边界、0x7D 为转义符,编码规则为:原始字节 0x7E 编成 0x7D 0x5E,原始字节 0x7D 编成 0x7D 0x5D。接收端不能看到 0x7D 就立即输出它,而要等待下一个字节决定它代表什么。
因此反转义本质上是一个很小的状态机:正常状态直接输出普通字节;看到转义符后进入“等待转义值”状态;下一字节到达后按规则还原,否则把该输入判为异常。
安全反转义的核心规则
最容易出错的地方是帧结束、超时或缓冲区结束恰好发生在转义符之后。此时没有第二个字节可供解释,不能把 0x7D 当成普通数据吞掉,也不能凭猜测补一个字节。
推荐把异常分类为“孤立转义符”并让当前帧失败,再根据协议约定丢弃、记录错误或重新同步。这样可以避免错误字节进入上层业务数据。
下面是一个可直接运行的 Python 示例。它只负责处理已经取得的单帧线路数据,不负责找帧边界。
def unescape(data: bytes) -> bytes:
ESC = 0x7D
XOR = 0x20
result = bytearray()
escaped = False
for byte in data:
if escaped:
# 转义后的值必须能够按协议规则还原。
if byte not in (0x5D, 0x5E):
raise ValueError(f"invalid escape value: 0x{byte:02X}")
result.append(byte ^ XOR)
escaped = False
continue
if byte == ESC:
escaped = True
else:
result.append(byte)
# 帧在转义状态结束,说明输入被截断。
if escaped:
raise ValueError("isolated escape byte")
return bytes(result)
print(unescape(bytes([0x01, 0x7D, 0x5E, 0x02])).hex())
try:
unescape(bytes([0x01, 0x7D]))
except ValueError as exc:
print(exc)预期输出
017e02
isolated escape byte校验应该针对哪一层
协议同时存在“线路编码数据”和“原始协议数据”两种视图时,必须先读懂校验字段定义。若 CRC 规范说明计算的是反转义后的原始数据,那么接收端流程应先完成反转义,再按原始字段计算 CRC;若规范明确要求对线路编码后的字节流校验,则应在反转义之前验证。
不能因为两种数据“看起来代表同样的内容”就随意交换顺序。转义会改变实际字节序列,例如原始数据中的一个 0x7E 可能在线路上变成两个字节,因此对两层分别计算得到的 CRC 可以完全不同。
建议在实现中把两个缓冲区明确区分,例如 encoded 表示线路收到的字节,decoded 表示反转义后的协议内容。日志、测试和异常信息也尽量说明当前操作针对哪一层。
异常输入怎样避免污染下一帧
收到非法转义值时,不要继续把后续字节当成当前帧的一部分;当前帧应进入失败路径。真正的恢复动作应由帧解析层决定,例如等待下一个边界字节重新同步。
对于串口这类连续字节流,最危险的做法是“遇到异常继续猜”。一旦错误解释了一个转义字节,后续长度、CRC 甚至帧边界都可能跟着错位。把异常尽早截断,反而更容易恢复。
反转义完成后的数据还应继续经过长度检查、字段检查和完整性校验。反转义成功只说明编码层处理成功,并不代表整帧已经可信。