4. 开发环境搭建
DroneCAN 设备（电调、GPS、电源模块等）能否被飞控正确识别，很大程度上取决于开发环境是否搭建完整。本节围绕“飞控固件配置—调试工具—地面站—编译烧录”这条主线，把从零到能跑通第一个 DroneCAN 节点的完整链路讲清楚。核心目标是：让飞控固件开启 DroneCAN 驱动、让上位机具备调试与监控能力、让地面站能可视化查看节点状态，并掌握固件编译与烧录的标准流程。
一、核心原理：DroneCAN 开发环境的四层结构
DroneCAN 开发环境并不是单一软件，而是由四个层次协同构成：最底层是飞控固件中的 CAN 驱动与 DroneCAN 协议栈；其上是运行在 PC 上的调试工具（如 DroneCAN GUI Tool、dronecan 命令行工具）；再往上是地面站（Mission Planner / QGroundControl），用于参数配置与节点监控；最外层是编译与烧录工具链，负责把修改后的固件写入飞控。四层之间通过 CAN 总线、USB/串口和网络连接，缺一不可。
理解这个结构后，排障就有了方向：节点不识别，先查固件是否开启 DroneCAN；能识别但参数读不出，查调试工具与总线速率；参数能读但地面站看不到，查地面站连接方式；固件改不动，查编译工具链与烧录方式。
二、飞控固件配置：让 CAN 口“活”起来
以 ArduPilot 为例，飞控默认并不一定开启 DroneCAN。需要在参数树中确认以下关键参数。不同飞控的 CAN 端口编号不同，常见为 CAN1、CAN2，对应参数前缀 CAN_P1_、CAN_P2_。
CAN_P1_DRIVER = 1 # 启用 CAN1 驱动
CAN_P1_BITRATE = 1000000 # DroneCAN 标准 1Mbps
CAN_D1_PROTOCOL = 1 # 1 = DroneCAN
UAVCAN_ENABLE = 2 # 2 = 启用 DroneCAN，允许动态节点
UAVCAN_NODE_ID = 10 # 飞控自身节点 ID
配置完成后必须重启飞控，再通过地面站查看 CAN 节点列表。若节点未出现，优先检查终端电阻（120Ω）是否安装、CAN_H/CAN_L 是否接反、总线速率是否一致。DroneCAN 对总线完整性非常敏感，接触不良会表现为节点时有时无。
三、DroneCAN 调试工具：从总线扫描到参数读写
DroneCAN GUI Tool 是最常用的图形化调试工具，支持节点扫描、参数读写、固件升级和报文监控。命令行工具 dronecan 则适合脚本化批量操作。典型使用流程如下：
- 用 USB-CAN 适配器连接飞控 CAN 口与 PC，确认适配器驱动正常。
- 打开 GUI Tool，选择对应 CAN 接口与 1Mbps 速率，点击“Scan”扫描节点。
- 在节点列表中查看节点 ID、名称、健康状态与固件版本。
- 选中电调节点，读取参数如
esc_index、pole_count、direction。 - 修改参数后点击“Store”，再重启节点确认参数已持久化。
四、地面站软件：可视化监控与参数管理
Mission Planner 与 QGroundControl 都支持 DroneCAN 节点监控。Mission Planner 在“初始设置—可选硬件—DroneCAN”中可查看节点状态；QGroundControl 则在“车辆设置—组件”中显示 DroneCAN 设备。地面站的价值在于把总线上的原始报文转化为可读的电压、电流、转速、GPS 定位等业务数据，便于飞行前检查。
| 工具 | 主要用途 | 连接方式 | 典型场景 |
|---|---|---|---|
| DroneCAN GUI Tool | 节点扫描、参数读写、固件升级 | USB-CAN 适配器 | 单节点调试、总线排障 |
| dronecan 命令行 | 批量参数操作、脚本化测试 | USB-CAN / SLCAN | 产线批量配置 |
| Mission Planner | 节点状态、参数树、日志 | USB / 数传 | 整机联调、飞行前检查 |
| QGroundControl | 组件监控、参数配置 | USB / UDP | 多平台地面站 |
五、编译与烧录流程：从源码到飞控
若需要修改飞控固件以支持特定 DroneCAN 设备，需完成编译与烧录。以 ArduPilot 为例，标准流程如下：
# 1. 获取源码
git clone https://github.com/ArduPilot/ardupilot.git
cd ardupilot
git submodule update --init --recursive
# 2. 配置目标板
./waf configure --board CubeOrange
# 3. 编译
./waf copter
# 4. 产物位置
build/CubeOrange/bin/arducopter.apj
烧录方式主要有三种：地面站“加载固件”直接烧录 .apj；DFU 模式通过 USB 烧录；串口 bootloader 烧录。烧录完成后重启飞控，重新扫描 CAN 节点，确认固件版本与参数均已更新。
六、常见误区与复盘
- 只装地面站，不装调试工具：地面站能看到节点，但无法深入读写参数和升级固件，排障效率低。
- 忽略终端电阻：短距离测试可能正常，长线或高负载时通信不稳定，表现为节点随机掉线。
- 总线速率不一致：飞控设为 1Mbps，适配器设为 500kbps，扫描不到任何节点。
- 烧录后未重新上电：部分参数需冷启动才生效，热重启可能仍使用旧配置。
- 多节点 ID 冲突：两个电调使用相同节点 ID，地面站只显示一个，需启用动态分配或手动改 ID。
建议把“固件参数—调试工具—地面站—编译烧录”做成一张检查清单，每次集成新设备时逐项确认。这样既能快速定位问题，也能保证 DroneCAN 电调与 GPS 设备在整机环境中稳定运行。