Skip to content

feat(ground): 新增 CAN 报文信号解码与 CRC/计数器校验 - #1299

Merged
LinFengCi merged 11 commits into
OpenHUTB:masterfrom
aaa12345zzz:feat/can_signal_decode
Nov 11, 2026
Merged

LinFengCi merged 11 commits into
OpenHUTB:masterfrom
aaa12345zzz:feat/can_signal_decode

Conversation

@aaa12345zzz

@aaa12345zzz aaa12345zzz commented Nov 11, 2026 •

Copy link
Copy Markdown
Contributor

把 8 字节 CAN 载荷按位域(Intel/Motorola)还原成物理量,并同时校验 CRC8(SAE J1850) 与滚动计数器。用注入故障的数据说明不校验会错到什么程度:同一批数据里车速会被污染成 403 km/h、扭矩出现 3198 Nm,加校验后只丢弃 7.3% 的帧,信号统计回到真值范围。

实测:colcon build 约 2 s;colcon test 13 项全过;离线入口输出校验统计表;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.md
  • 测试:test/test_*.py(pytest,colcon test 直接跑)
  • CI:.github/workflows/control_modules_tests.yml

测试环境与结果

  • 操作系统:Ubuntu 22.04.5 LTS
  • ROS 版本:ROS 2 Humble
  • Python:3.10.12
  • 构建与运行命令(在仓库根目录执行):
source /opt/ros/humble/setup.bash
colcon build --packages-select can_signal_decode
source install/setup.bash
colcon test --packages-select can_signal_decode && colcon test-result --verbose
ros2 launch can_signal_decode main.launch.py
  • 结果:colcon build 通过(约 2 s),colcon test 13 项全部通过,
    main 离线入口与 ros2 launch 均正常(详见 README 第 3 节的实测输出)。

运行效果

README 第 3 节贴了完整实测输出与结果表格;docs/ground/can_signal_decode.md 给出了模型公式、
对比数据与已知限制。运行 ros2 launch 后可用下列命令查看本模块话题:

ros2 topic list | grep -E 'can_|can/'
ros2 topic echo /can/signals --once

提交前检查

  • 已检查 Files changed 和冲突,无无关生成文件、重复内容或误删公共文件
  • 源码与教程按模块分别放在 src、docs,文件使用英文下划线命名
  • 模块提供 main.* 和 launch,依赖及安装路径正确,README 步骤已实际运行
  • 新模块已添加首页和导航链接(只新增,未改动任何既有条目)
  • 功能描述与验证证据一致;本模块无 PNG/GIF 二进制资源

大模型使用声明

使用 DeepSeek 的 deepseek-flash 模型(通过 DeepSeek Harness 客户端调用)辅助完成:
位域(Intel/Motorola)与 CRC8 的实现方案、单元测试用例、README 与教程页初稿、以及运行输出与统计表格的整理。

所有公式推导、位序约定、CRC 参数、量程设置与实测数字均由作者逐项复核,并在 Ubuntu 22.04.5 + ROS 2 Humble + Python 3.10.12 上实跑确认(colcon build / colcon test 13 项 / ros2 launch);作者对提交内容与正确性负全部责任。

把 8 字节 CAN 载荷按位域(Intel/Motorola)还原成物理量,并同时校验 CRC8(SAE J1850) 与滚动计数器。用注入故障的数据说明不校验会错到什么程度:同一批数据里车速会被污染成 403 km/h、扭矩出现 3198 Nm,加校验后只丢弃 7.3% 的帧,信号统计回到真值范围。

- 纯解析计算,不依赖仿真器,colcon test 全部通过
- 已补 mkdocs 导航与首页链接(仅新增)
@aaa12345zzz

Copy link
Copy Markdown
Contributor Author

@lcl52555

@LinFengCi LinFengCi left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

审核通过。模块结构完整(package.xml / setup.py / launch / resource 标记 / README / 测试齐全),docs/ 与 src/ 分离,导航已挂 mkdocs.yml 与 docs/index.md,含「大模型使用声明」。README 给出实测验证数据与简化假设,离线测试覆盖核心公式、数值与边界(含参数非法抛错),代码质量与自洽性良好,予以批准。

建议(非阻塞):声明目前只写「使用大模型」未点名具体工具,按仓库自查第 6 条建议补上具体大模型工具名(如豆包 / ChatGPT / 文心 / WorkBuddy 等)。

@QS-339 QS-339 left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

改动集中在 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 项测试覆盖到位。

@aaa12345zzz aaa12345zzz left a comment

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@aaa12345zzz

Copy link
Copy Markdown
Contributor Author

@LinFengCi @QS-339 两条意见都处理了,另外把上一轮失败的 CI 也一并修了。

1. 大模型使用声明(LinFengCi)

已补上具体工具名与辅助范围(commit 30dea031 / 47f90b45):

使用 DeepSeek 的 deepseek-flash 模型(通过 DeepSeek Harness 客户端调用)辅助完成:
位域(Intel/Motorola)与 CRC8 的实现方案、单元测试用例、README 与教程页初稿、
以及运行输出与统计表格的整理。所有公式推导、位序约定、CRC 参数、量程与实测数字均经人工逐项复核。

2. 坏帧污染计数器基准(QS-339)

确认是 bug,已改。run() 里原本 previous[codec.name] = payload 无条件执行,CRC 失败的帧也会成为下一帧的计数器参考。现在:

  • CRC 不通过的帧不再作为基准,也不参与计数器判定(它的计数器位本身可能已被打坏,拿它做连续性判断没有意义);
  • 新增 expected_step 参数:中间夹了 k 个坏帧时,下一帧的预期步进放宽为 1 + k,从而避免「一次误码罚两帧」——即 k, 坏(k+1), 好(k+2) 这对现在判为正常;
  • 新增回归用例 test_crc_failed_frame_does_not_break_next_counter(场景:第 6 帧在总线上被干扰、第 7 帧正常到达)。

效果:VCU_Status 的计数跳变 21 → 17(注入丢帧率 2% ≈ 20 次),通过率 92.2% → 92.4%。

3. 周期口径不一致(QS-339)

确认不一致,已统一到 simulate() 的实际发送频率(50 Hz 基频):

报文 原 cycle_ms 改为 依据
VCU_Status 10.0 20.0 每个基频周期都发
Steering_Status 20.0 60.0 step % 3 == 0,即每 3 帧

并加了用例 test_cycle_ms_matches_simulation_rates 把这个口径锁住。

4. CI 失败原因与处理

上一轮的红色不是代码问题,是 ros-tooling/setup-ros 安装 ROS 时 apt 源 DNS 抖动:

E: Failed to fetch https://security.ubuntu.com/... Temporary failure resolving 'azure.archive.ubuntu.com'
##[error]The process '/usr/bin/sudo' failed with exit code 100

失败发生在 Set up ROS 2 Humble 步骤,我的构建/测试步骤根本没执行到。

这 5 个包除 main_node.py 外都不 import rclpy,所以 CI 改为 pip install colcon-common-extensions pytest,不再安装 ROS;--packages-select 也改成按目录发现,这样 5 个 PR 各自只构建当前树里已存在的包。

已在 Ubuntu 22.04.5 + Python 3.10.12 上验证「不 source ROS 也能构建测试」:5 包 colcon build 2.80 s、Summary: 15 tests, 0 errors, 0 failures。job 耗时从 6 分钟以上降到 1 分钟以内。

测试项数 13 → 15,README 与教程页的数字已同步。

@aaa12345zzz

Copy link
Copy Markdown
Contributor Author

@LinFengCi

@aaa12345zzz

Copy link
Copy Markdown
Contributor Author

补一条 CI 的后续说明。

刚才把 ROS 去掉之后第一次跑是绿的,但日志里是 Summary: 0 tests——假绿:纯 pip 环境里
colcon test 的 python 任务不会自动调用 pytest(装了 ROS 的机器才会),所以测试其实没执行。

已修正(commit 77ebd2a9):colcon build 保留用于校验打包,测试改为直接

PYTHONPATH=src/ground/<pkg> python3 -m pytest src/ground/<pkg>/test -q

现在这一次是真跑了:

待构建: can_signal_decode control_discretization drivetrain_torsion_state_feedback wheel_speed_observer uav_hover_throttle
Summary: 5 packages finished [12.5s]
15 passed / 13 passed / 10 passed / 11 passed / 14 passed   (共测试 5 个模块)

5 个模块合计 63 项全部通过,job 总耗时 45 秒(此前装 ROS 的版本是 6 分钟以上,且会因 apt 源 DNS 抖动整条挂掉)。

@LinFengCi

Copy link
Copy Markdown
Contributor

PR #1299 大模型使用声明(需要说明的文本)
大模型使用声明
本作业在开发与撰写过程中使用了 AI 大模型编程助手辅助完成,具体使用的大模型工具为:【填写具体工具名,例如:豆包 / ChatGPT / 文心一言 / WorkBuddy 等】。
辅助范围包括:

  • 代码(CAN 报文位域解码、Intel/Motorola 字节序处理、CRC8-SAE-J1850 校验、滚动计数器检测)的编写与调试;
  • 文档(README)与说明文字的起草;
  • 单元测试(pytest)的编写;
  • 工程配置文件(package.xml、setup.py、launch 文件)的生成。
    说明与责任:上述所有数值、运行结果与效果验证数据,均由作者本人在本地环境中实际运行、测试与复核(操作系统:Ubuntu 22.04.5 LTS;colcon build 约 2s;colcon test 13 项全部通过)。作者对本次提交内容的正确性、完整性与合规性负全部责任。

@LinFengCi
LinFengCi merged commit 8b383fe into OpenHUTB:master Nov 11, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants