CANopen 调试概述

1. 调试方法论

CANopen 系统的调试需要分层思维，从物理层到应用层逐层排查：

┌─────────────────────────────────────────┐
│  应用层 (Application Layer)            │ ← 用户代码、业务逻辑
│  - PDO 配置、NMT 状态、SDO 操作       │
├─────────────────────────────────────────┤
│  传输层 (Transport Layer)              │ ← SDO/PDO 协议
│  - SDO Expedited/Segmented 传输      │
│  - PDO 映射、触发方式                 │
├─────────────────────────────────────────┤
│  数据链路层 (Data Link Layer)          │ ← CAN 帧格式
│  - 帧结构、仲裁、错误帧               │
├─────────────────────────────────────────┤
│  物理层 (Physical Layer)              │ ← 硬件连接
│  - 差分信号、终端电阻、线缆           │
└─────────────────────────────────────────┘

1.1 调试原则

2. 调试工具全景图

2.1 工具分类

CANopen 调试工具
├── 基础工具
│   ├── can-utils          (Linux 命令行工具)
│   ├── candump          (帧捕获)
│   ├── cangen           (帧生成)
│   └── cansend         (帧发送)
│
├── 协议分析工具
│   ├── Wireshark        (图形化协议分析)
│   ├── CANalyzer       (Vector 商业工具)
│   └── CANoe          (Vector 仿真工具)
│
├── 专用 CANopen 工具
│   ├── CANopenMonitor  (开源 CANopen 监控)
│   ├── canopen-demo    (CANopenNode 示例)
│   └── LSS Master     (节点配置工具)
│
└── 硬件辅助工具
    ├── CAN 适配器      (PCAN-USB, SocketCAN)
    ├── 示波器          (信号质量检查)
    └── 逻辑分析仪      (时序分析)

2.2 工具选择指南

3. 调试流程标准化

3.1 标准调试五步法

┌─────────────────────────────────────────────────────────────┐
│  第 1 步：硬件检查                      │
│  - 终端电阻是否正确 (60Ω)                                 │
│  - 线缆连接是否正常 (CAN_H/CAN_L 接反?)                    │
│  - 波特率是否一致                                        │
└─────────────────────────────────────────────────────────────┘
                        │
                        ▼
┌─────────────────────────────────────────────────────────────┐
│  第 2 步：基础通信验证                  │
│  - candump 是否能看到帧                                    │
│  - 帧格式是否正确                                        │
│  - 仲裁是否正常 (低 ID 优先)                              │
└─────────────────────────────────────────────────────────────┘
                        │
                        ▼
┌─────────────────────────────────────────────────────────────┐
│  第 3 步：NMT 状态检查                   │
│  - 节点能否进入 Operational 状态                          │
│  - 心跳报文是否正常发送                                  │
│  - 节点间状态是否同步                                    │
└─────────────────────────────────────────────────────────────┘
                        │
                        ▼
┌─────────────────────────────────────────────────────────────┐
│  第 4 步：SDO/PDO 调试                                │
│  - SDO 读写是否成功                                      │
│  - PDO 映射是否正确                                      │
│  - 数据是否按预期传输                                     │
└─────────────────────────────────────────────────────────────┘
                        │
                        ▼
┌─────────────────────────────────────────────────────────────┐
│  第 5 步：应用逻辑验证                                 │
│  - 业务逻辑是否正确                                      │
│  - 异常处理是否完善                                      │
│  - 性能是否满足要求                                      │
└─────────────────────────────────────────────────────────────┘

3.2 调试检查清单

物理层检查

• CAN_H 和 CAN_L 是否接对（用万用表测电压）
• 终端电阻是否为 60Ω（测量总线两端）
• 波特率配置是否一致（所有节点）
• 线缆长度是否在允许范围内

通信层检查

• candump 能否看到 CAN 帧
• 帧计数器是否有递增
• 是否有错误帧（Error Frame）
• 节点是否都正常发送（cansend 测试）

CANopen 层检查

• NMT 启动命令是否发送成功
• 心跳报文是否正常接收
• 节点状态机是否正常转换
• SDO 读写是否超时
• PDO 数据是否按预期更新

应用层检查

• 数据值是否正确（单位、精度）
• 时序是否满足要求
• 异常情况下是否有合理的处理

4. 常见调试场景

4.1 场景一：节点不响应

4.2 场景二：数据不更新

4.3 场景三：通信频繁失败

5. 日志记录最佳实践

5.1 日志内容规范

# 日志文件命名格式
canopen_debug_<YYYY-MM-DD>_<场景描述>.log

# 日志头部信息
# Date: 2024-05-20
# Scenario: SDO Write Timeout
# Node IDs: 0x01 (Master), 0x02 (Slave)
# Bitrate: 500kbps
# Tool: candump vcan0

5.2 日志分析技巧

# 1. 统计帧频率
candump -l vcan0 | awk '{print $3}' | sort | uniq -c

# 2. 查找错误帧
candump -l vcan0 | grep -i error

# 3. 提取特定节点的通信
candump -l vcan0 | grep "vcan0 18[0-9A-F]{2}"

# 4. 对比正常/异常日志
diff normal.log abnormal.log

★ Insight ─────────────────────────────────────

• 分层调试是 CANopen 排查的核心思想：90% 的问题其实都在物理层（线缆、电阻、波特率），不要一上来就怀疑代码。
• 保留完整的调试日志是救命的——当问题在生产环境复现时，能够对比之前的日志往往能快速定位。
• Wireshark 的 CANopen 解码插件需要正确加载 EDS 文件，否则只能看到原始 CAN 帧，无法理解对象字典含义。 ─────────────────────────────────────────────────

下一步

→ 02-can-utils-tools.md —— 深入学习 can-utils 工具集