团队怎样共享一份 CRC 校验样本,避免上位机和固件各算各的
团队共享 CRC 校验样本,最小交付物不是聊天里一句“我算的是 CDC5”,而是一份能让两端程序自动读取的向量文件。算法、输入字节、范围、数值与线序都要显式写出,否则一方验证的是显示文本,另一方验证的是线上尾字节,仍可能各算各的。
定义团队共用的向量字段
本文选择 CRC-16/MODBUS,不建立新的工具或私有算法。每个向量至少包含 id、算法参数、input_hex、输入字节数、范围说明、expected_value_hex、expected_wire_hex 和依据。参数记录 width=16、poly=8005、init=FFFF、refin/refout=true、xorout=0000;右移参考实现用 A001。
把数值固定四位大写 HEX,把线上字节固定两位并空格分隔。这样 CDC5 与 C5 CD 不会在一个字段里混用。来源既有官方算法规范,也应写明该输入是标准检查串、合成协议帧还是设备厂商提供的有效样本,不能把自己编的数据标成厂商实测。
| 向量身份 | 输入 HEX | 期望数值 | 低位先传 | 用途 |
|---|---|---|---|---|
| 数字检查串 | 31 32 33 34 35 36 37 38 39 | 4B37 | 37 4B | 快查算法参数 |
| 合成 RTU 请求 | 01 03 00 00 00 0A | CDC5 | C5 CD | 检查协议输入 |
| 前导零样例 | 00 BF | 0040 | 40 00 | 检查固定宽度 |
| 空字节序列 | 空 | FFFF | FF FF | 检查初值与空输入 |
空输入是算法测试,不是有效 Modbus 请求。前三组数值均由配套参考实现实际计算;没有真实从站参与。本篇附件 JSON 可作为仓库的黄金向量起点,接入工程时还要加入授权设备的实际协议样本。
两端怎样执行同一验收
先由一位负责人冻结向量文件版本并计算文件摘要。固件侧把输入展开为字节数组,上位机侧从同一 JSON 读取,分别断言数学值与序列化尾字节。参考脚本reference.py提供可运行的独立计算例子;项目自己的两个实现应分别运行,不能仅让它们调用同一个库,再宣称实现互相验证。
失败时报告向量 id、实际输入展开、长度、实际数学值和实际线序,不只输出 assert failed。若数值正确但尾字节反了,改序列化;若检查串错误,查算法参数;若检查串正确、业务样本错误,查范围或文本编码。这个分流比让两端互相贴截图有效。
加入有解释的负例
负例可从合法合成帧翻转一个数据位,保留旧 CRC,预期校验失败。再测试截断 CRC 尾、少一个前导零字节、把 HEX 文本直接编码等错误。每条负例写清拒绝原因,别把“某值不等”当作完整协议校验;长度、地址和功能码仍需各自检查。
以后修改范围或算法时,新建版本并说明不兼容点,不覆盖旧文件让历史日志失去依据。保存最少一条跨版本差异样本。向量不应包含客户密钥、生产地址或设备识别信息,可用合成数据验证同一数学关系,真实敏感样本留在受控环境。
怎样接受团队变更
评审应看到“哪一条向量改变、依据哪页手册、两个实现怎样输出”。只有都通过才更新基线;某一端暂时不支持时,标注未通过范围,不能在测试代码里改期望值迎合现状。保留前导零和空输入,能防止格式优化无意改变线上长度。
常见问题
CRC16 同名库都能用这份文件吗? 只有参数完全一致才适用,名称相近不等于算法相同。
需要保存整帧还是计算输入? 最好两者都有,并提供半开范围,整帧用于还原协议,输入用于独立计算。
一百条随机数据足够吗? 随机覆盖不能替代有明确目的的边界样本;先覆盖编码、范围、线序和前导零,再增加随机测试。
来源与配套记录
下载本文样例或空白记录(N061.json)。附件的 kind 明确区分合成数据与待填写记录,空值不是实测结果。
本文依据官方文档与自建合成样例整理,未连接真实设备完成现场测试;计算结果以附件脚本输出为准。核对日期:2026-10-23。
操作入口见CRC / Modbus 计算器;继续处理相关任务可看CRC 结果前面少了零,要不要补:用固定宽度测试向量核对。
本文为公开资料整理,非亲测。关键参数与代码请结合实物与下列官方来源验证。
- Modbus 串行规范 V1.02 附录 B ↗
modbus.org/file/secure/modbusoverserial.pdf