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

接收端怎样安全反转义

接收端怎样安全反转义

本课解决串口协议接收端在遇到转义数据时的解析风险:既要还原被编码的字节,也要正确处理帧尾出现孤立转义符等异常输入,并明确校验应落在原始数据还是线路编码数据上。

学习目标

  • 能区分线路编码数据与还原后的原始数据
  • 能实现按状态处理转义符、正常字节和异常结尾
  • 能确定校验字段应在哪一层计算与验证

反转义真正要处理什么

假设协议规定 0x7E 为帧边界、0x7D 为转义符,编码规则为:原始字节 0x7E 编成 0x7D 0x5E,原始字节 0x7D 编成 0x7D 0x5D。接收端不能看到 0x7D 就立即输出它,而要等待下一个字节决定它代表什么。

因此反转义本质上是一个很小的状态机:正常状态直接输出普通字节;看到转义符后进入“等待转义值”状态;下一字节到达后按规则还原,否则把该输入判为异常。

安全反转义的核心规则

最容易出错的地方是帧结束、超时或缓冲区结束恰好发生在转义符之后。此时没有第二个字节可供解释,不能把 0x7D 当成普通数据吞掉,也不能凭猜测补一个字节。

推荐把异常分类为“孤立转义符”并让当前帧失败,再根据协议约定丢弃、记录错误或重新同步。这样可以避免错误字节进入上层业务数据。

下面是一个可直接运行的 Python 示例。它只负责处理已经取得的单帧线路数据,不负责找帧边界。

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)

预期输出

text
017e02
isolated escape byte

校验应该针对哪一层

协议同时存在“线路编码数据”和“原始协议数据”两种视图时,必须先读懂校验字段定义。若 CRC 规范说明计算的是反转义后的原始数据,那么接收端流程应先完成反转义,再按原始字段计算 CRC;若规范明确要求对线路编码后的字节流校验,则应在反转义之前验证。

不能因为两种数据“看起来代表同样的内容”就随意交换顺序。转义会改变实际字节序列,例如原始数据中的一个 0x7E 可能在线路上变成两个字节,因此对两层分别计算得到的 CRC 可以完全不同。

建议在实现中把两个缓冲区明确区分,例如 encoded 表示线路收到的字节,decoded 表示反转义后的协议内容。日志、测试和异常信息也尽量说明当前操作针对哪一层。

异常输入怎样避免污染下一帧

收到非法转义值时,不要继续把后续字节当成当前帧的一部分;当前帧应进入失败路径。真正的恢复动作应由帧解析层决定,例如等待下一个边界字节重新同步。

对于串口这类连续字节流,最危险的做法是“遇到异常继续猜”。一旦错误解释了一个转义字节,后续长度、CRC 甚至帧边界都可能跟着错位。把异常尽早截断,反而更容易恢复。

反转义完成后的数据还应继续经过长度检查、字段检查和完整性校验。反转义成功只说明编码层处理成功,并不代表整帧已经可信。

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

目录与阅读设置

阅读设置

17

记录一个想法

接收端怎样安全反转义

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

登录哪都通