CRC 应该从哪一个字节开始算:按设备手册确定校验范围
CRC 应该从哪一个字节开始算,答案必须来自协议手册,而不是从十几个切片里试出一个碰巧相等的值。CRC 只能说明指定算法对指定字节序列的计算结果;如果范围没有定义清楚,上位机和固件都可能“各自正确”却无法互通。
先把帧拆成带偏移的字段
本文先用 Modbus RTU 的合成响应 01 03 02 00 2A 39 9B。从偏移 0 开始标注:地址 01、功能码 03、字节计数 02、两个数据字节 00 2A、CRC 尾 39 9B。生成 CRC 的输入是前五字节,计算值为 9B39,传输低字节在前。
| 字段 | 偏移范围 | 字节 | 生成 CRC 时 |
|---|---|---|---|
| 地址 | [0,1) | 01 | 包含 |
| 功能码 | [1,2) | 03 | 包含 |
| 字节计数 | [2,3) | 02 | 包含 |
| 数据 | [3,5) | 00 2A | 包含 |
| CRC 尾 | [5,7) | 39 9B | 排除 |
这里采用左闭右开的区间,长度就是 end-start。偏移和长度都是字节,不能把 HEX 字符串下标当成字节下标;字符串里一个字节可能占两位,再加一个分隔空格,切片数字会完全不同。
不要把传输层包装算进去
日志中的时间戳、TX/RX、串口起停位不属于上述 CRC 输入。若数据经过串口服务器,外层 TCP/IP 头同样不是 RTU CRC 的范围。Modbus TCP 使用自己的 MBAP 结构,不能简单把 RTU 校验尾无条件追加到 TCP 报文中;先确认设备要求的是原生 Modbus TCP 还是透明传输 RTU 字节。
下面再定义一个专门用于演示的自定义包络:AA 55 | 05 | 01 03 02 00 2A | 39 9B。假定这个实验协议手册明确规定“只对五字节内部负载做 CRC”,那么 AA55 和外层长度 05 都排除。该定义是本文自建样例,不属于 Modbus RTU 标准,不能迁移到未知设备。
用两条独立断言验收
frame = bytes.fromhex('01 03 02 00 2A 39 9B')
expected = int.from_bytes(frame[-2:], 'little')
# crc_modbus 使用配套 reference.py 中的函数
assert crc_modbus(frame[:-2]) == expected == 0x9B39
envelope = bytes.fromhex('AA 55 05 01 03 02 00 2A 39 9B')
assert envelope[2] == len(envelope[3:-2])
assert crc_modbus(envelope[3:-2]) == expected
保存原始帧与范围表达式,而不是只保存最后的 9B39。如果设备厂商后续修改了头部、长度或转义规则,读者能看到当时依据。对经过转义的协议还要问“在转义前还是后计算”;这由手册定义,不能用显示出的可见字符串替代线上字节。
范围文档没有写清时怎么办
先整理手册页码、字段图和几条已知有效请求,向协议提供方确认起点、终点、是否含长度和序号。多条样本能排除部分错误假设,但不能把穷举匹配当作规范。特别是短帧与固定字段,某种错误范围可能暂时碰巧符合,换一个载荷就失效。
现场最实用的交付是“帧字段表 + 字节偏移 + 算法参数 + 两条不同载荷的预期值”。附件中分别写入标准 RTU 与自定义包络的身份,避免后续只拿到样本却不知道它属于哪种协议。跨团队共享可继续看CRC 向量交付。
手册里的长度也需要单独解释:有的表示正文长度,有的包含头部或校验尾。先按字段定义验证总长,再取得 CRC 切片,避免用一个含义不明的 length 同时控制收帧和校验范围。
常见问题
把 CRC 尾也算进去得到零,是否也可以? 某些算法和线序可用于整帧余数检查,但它与生成新 CRC 的范围是两种约定,不能混写。
长度字段是否一定参与? 不一定,必须按具体协议规定,本例的 RTU 字节计数参与,实验外层长度不参与。
帧头 AA55 是否总排除? 不是。本例只是明确这样定义的自建包络,其他设备可能完全相反。
来源与配套记录
下载本文样例或空白记录(N059.json)。附件的 kind 明确区分合成数据与待填写记录,空值不是实测结果。
本文依据官方文档与自建合成样例整理,未连接真实设备完成现场测试;计算结果以附件脚本输出为准。核对日期:2026-10-23。
操作入口见CRC / Modbus 计算器;继续处理相关任务可看团队怎样共享一份 CRC 校验样本,避免上位机和固件各算各的。
本文为公开资料整理,非亲测。关键参数与代码请结合实物与下列官方来源验证。
- Modbus 串行规范 V1.02 附录 B ↗
modbus.org/file/secure/modbusoverserial.pdf