← 返回文章库

团队怎样共享一份 CRC 校验样本,避免上位机和固件各算各的

最后更新 2026-10-23
⏱ 约 8 分钟 🟢 软件/低风险

团队共享 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 结果前面少了零,要不要补:用固定宽度测试向量核对。

📄 来源 / 自校链接

本文为公开资料整理,非亲测。关键参数与代码请结合实物与下列官方来源验证。

内容有错、看不懂、或想看下一期?告诉我们 →

本文为公开资料的学习整理,非亲测。涉接线/花钱/合规的步骤请结合实物与官方最新资料验证,风险自负。见免责声明。

这个页面有问题?

提交时会附带当前页面地址和浏览器信息,帮助我们定位问题。不填联系方式即为匿名。