Repository navigation
feat(ground): 新增 CAN 报文信号解码与 CRC/计数器校验 - #1299
Conversation
把 8 字节 CAN 载荷按位域(Intel/Motorola)还原成物理量,并同时校验 CRC8(SAE J1850) 与滚动计数器。用注入故障的数据说明不校验会错到什么程度:同一批数据里车速会被污染成 403 km/h、扭矩出现 3198 Nm,加校验后只丢弃 7.3% 的帧,信号统计回到真值范围。 - 纯解析计算,不依赖仿真器,colcon test 全部通过 - 已补 mkdocs 导航与首页链接(仅新增)
LinFengCi
left a comment
There was a problem hiding this comment.
审核通过。模块结构完整(package.xml / setup.py / launch / resource 标记 / README / 测试齐全),docs/ 与 src/ 分离,导航已挂 mkdocs.yml 与 docs/index.md,含「大模型使用声明」。README 给出实测验证数据与简化假设,离线测试覆盖核心公式、数值与边界(含参数非法抛错),代码质量与自洽性良好,予以批准。
建议(非阻塞):声明目前只写「使用大模型」未点名具体工具,按仓库自查第 6 条建议补上具体大模型工具名(如豆包 / ChatGPT / 文心 / WorkBuddy 等)。
QS-339
left a comment
There was a problem hiding this comment.
改动集中在 src/ground/can_signal_decode/ 的三个纯计算文件上:frame.py 里的 SignalSpec.raw_from_payload() 把 8 字节看成一个 64 位整数按位域取数,motorola_positions() 用「同字节递减、跨字节跳 +15」的锯齿顺序处理 DBC 的 Motorola 写法,这个细节很容易写反,实现和 test_motorola_positions_are_sawtooth() 对得上;checksum.py 的 crc8_sae_j1850() 用标准串 b'123456789' → 0x4B 自检,test_crc_detects_every_single_bit_flip() 把 7 字节 56 个单 bit 翻转全试了一遍,这比只测一个样例更让人放心。
FrameSpec._check_overlap() 在构造时就拒绝位重叠的信号,SignalSpec.in_range() 带 1e-9 容差,配合 main.py 里注入的 3% CRC / 2% 丢帧 / 2% 超量程,能复现出「不校验时车速被污染成 403 km/h」这个反例,动机讲得很实。CI 用 ros-tooling/setup-ros 只 build 这五个纯计算包,几分钟能跑完,也照顾到了评审的机器。
想确认的一点(不阻塞合并):main.py 的 run() 里 previous[codec.name] = payload 是无条件更新的,CRC 校验失败的那一帧也会成为下一帧的计数器参考;如果把更新挪到 decoded['crc_ok'] 成立之后,单帧误码就只会影响它自己,不会连累下一帧被判计数器跳变。另外 default_frames() 里 Steering_Status 写的是 cycle_ms=20.0,而 simulate() 里是 if step % 3 == 0(50 Hz 下 60 ms),两处周期口径可以统一一下。
Approved —— 纯标准库、无仿真器依赖、校验链路(位域 → CRC → 计数器 → 量程)完整,13 项测试覆盖到位。
|
@LinFengCi @QS-339 两条意见都处理了,另外把上一轮失败的 CI 也一并修了。 1. 大模型使用声明(LinFengCi)已补上具体工具名与辅助范围(commit
2. 坏帧污染计数器基准(QS-339)确认是 bug,已改。
效果: 3. 周期口径不一致(QS-339)确认不一致,已统一到
并加了用例 4. CI 失败原因与处理上一轮的红色不是代码问题,是 失败发生在 这 5 个包除 已在 Ubuntu 22.04.5 + Python 3.10.12 上验证「不 source ROS 也能构建测试」:5 包 测试项数 13 → 15,README 与教程页的数字已同步。 |
|
补一条 CI 的后续说明。 刚才把 ROS 去掉之后第一次跑是绿的,但日志里是 已修正(commit PYTHONPATH=src/ground/<pkg> python3 -m pytest src/ground/<pkg>/test -q现在这一次是真跑了: 5 个模块合计 63 项全部通过,job 总耗时 45 秒(此前装 ROS 的版本是 6 分钟以上,且会因 apt 源 DNS 抖动整条挂掉)。 |
|
PR #1299 大模型使用声明(需要说明的文本)
|
把 8 字节 CAN 载荷按位域(Intel/Motorola)还原成物理量,并同时校验 CRC8(SAE J1850) 与滚动计数器。用注入故障的数据说明不校验会错到什么程度:同一批数据里车速会被污染成 403 km/h、扭矩出现 3198 Nm,加校验后只丢弃 7.3% 的帧,信号统计回到真值范围。
实测:
colcon build约 2 s;colcon test13 项全过;离线入口输出校验统计表;ros2 launch起 3 个进程、3 个话题。修改目的与内容
仓库里没有与该功能重复的模块(已核对
src/ground、src/air下 190+ 个模块)。本模块只做CAN 位域解码、CRC 与计数器校验,纯解析计算,不依赖 CARLA/AirSim/MuJoCo 等仿真器,因此审核方无需搭环境即可复现全部数字。
src/ground/can_signal_decode/(ament_python 包,提供main、main_node与launch/main.launch.py)docs/ground/can_signal_decode.mdtest/test_*.py(pytest,colcon test直接跑).github/workflows/control_modules_tests.yml测试环境与结果
colcon build通过(约 2 s),colcon test13 项全部通过,main离线入口与ros2 launch均正常(详见 README 第 3 节的实测输出)。运行效果
README 第 3 节贴了完整实测输出与结果表格;
docs/ground/can_signal_decode.md给出了模型公式、对比数据与已知限制。运行
ros2 launch后可用下列命令查看本模块话题:提交前检查
大模型使用声明
使用 DeepSeek 的 deepseek-flash 模型(通过 DeepSeek Harness 客户端调用)辅助完成:
位域(Intel/Motorola)与 CRC8 的实现方案、单元测试用例、README 与教程页初稿、以及运行输出与统计表格的整理。
所有公式推导、位序约定、CRC 参数、量程设置与实测数字均由作者逐项复核,并在 Ubuntu 22.04.5 + ROS 2 Humble + Python 3.10.12 上实跑确认(
colcon build/colcon test13 项 /ros2 launch);作者对提交内容与正确性负全部责任。