1. 课程导入
ArduPilot 之所以能成为开源飞控领域应用最广的固件之一，不仅因为它拥有成熟的姿态控制与导航算法，更因为它具备一套高度可扩展的外设驱动与设备接入体系。从最简单的 GPS、气压计，到复杂的激光雷达、光流、云台、RTK 与伴飞计算机，ArduPilot 都通过统一的驱动框架把它们纳入飞行控制回路。本课程的目标，就是帮助学习者从“会接线、会改参数”进阶到“看得懂驱动、接得进设备、排得掉故障”。
一、核心概念：什么是“外设驱动”与“设备接入”
在 ArduPilot 中，“外设驱动”指的是运行在飞控固件内部、负责与某一类硬件芯片或模块通信的代码单元；“设备接入”则是指把物理设备通过总线连接到飞控，并让固件正确识别、初始化、周期读取数据的过程。二者关系可以理解为：驱动是“软件能力”，接入是“系统集成”。
理解 ArduPilot 外设体系，需要抓住四个关键抽象：
- 总线（Bus）：I2C、SPI、UART、CAN、ADC、GPIO 等物理或逻辑通道，是设备与飞控通信的“道路”。
- 设备（Device）：挂载在总线上的具体硬件，如 MS5611 气压计、UBLOX GPS、TFmini 激光测距仪。
- 驱动（Driver）：实现设备协议、寄存器操作与数据解析的代码，通常以
AP_XXX库形式存在。 - 前端（Frontend）：把多个同类设备抽象为统一接口，例如
AP_Baro、AP_GPS、AP_RangeFinder，供上层控制与导航调用。
这四层构成了 ArduPilot 外设接入的基本模型：总线承载设备，驱动解析设备，前端统一设备，飞控使用设备。
二、整体框架：从物理设备到飞控应用的四层结构
如上图所示，ArduPilot 的外设接入可以划分为四层。最底层是总线与接口层，它决定了设备“怎么连”；往上是驱动层，决定设备“怎么读”；再往上是前端抽象层，决定设备“怎么被统一使用”；最上层是飞控应用层，决定设备数据“怎么参与控制与决策”。
这种分层设计带来两个直接好处：一是新增设备时只需实现对应驱动并注册到前端，不必修改控制代码；二是同一类设备可以多源冗余，例如双 GPS、双气压计，前端会自动做健康检查与切换。
三、方法流程：一个外设接入的标准闭环
无论是接入一个 I2C 气压计，还是一个 CAN 接口的 RTK，标准流程都可以归纳为以下六步：
- 确认总线与供电：查看设备手册，确认电压、接口类型、默认地址或节点 ID。
- 物理连接：按飞控引脚定义接线，注意 I2C 上拉、CAN 终端电阻、UART 交叉收发。
- 参数配置：设置
XXX_TYPE、XXX_ORIENT、CAN_P1_DRIVER等关键参数。 - 启动识别：上电后观察地面站是否出现新设备，或通过
MAVLink Inspector查看消息。 - 数据验证：检查数值范围、更新率、方向与单位是否符合预期。
- 日志复盘：飞行后分析
.bin日志中对应消息，确认无丢包、无跳变、无超时。
# 以接入一个 I2C 激光测距仪为例
RNGFND1_TYPE = 25 # 选择对应驱动
RNGFND1_ADDR = 0x10 # I2C 地址
RNGFND1_ORIENT = 0 # 朝前
RNGFND1_MIN_CM = 20
RNGFND1_MAX_CM = 1200
# 保存后重启飞控，观察 RNGFND1 是否出现有效距离四、案例与场景：三类典型接入任务
| 场景 | 典型设备 | 总线 | 关键参数 | 验证要点 |
|---|---|---|---|---|
| 基础导航增强 | UBLOX GPS + 磁罗盘 | UART / I2C | GPS_TYPE、COMPASS_ORIENT | 定位星数、航向一致性 |
| 定高与避障 | TFmini / LW20 激光雷达 | UART / I2C | RNGFND1_TYPE、MAX_CM | 距离跳变、盲区处理 |
| 精准农业与测绘 | RTK 模块、双天线定向 | CAN / UART | GPS_TYPE、GPS_POS_* | 固定解比例、基线长度 |
以激光雷达接入为例，常见误区是只改了 RNGFND1_TYPE 却忘记设置正确的 ORIENT，导致避障方向相反；或者量程参数设置过大，使飞控在无效距离上触发误动作。正确做法是先在地面用 MAVLink Inspector 观察 DISTANCE_SENSOR 消息，确认数值随遮挡物移动而线性变化，再进入飞行测试。
五、学习路径与常见误区复盘
本课程后续将沿着“总线基础 → 驱动框架 → 单设备接入 → 多设备冗余 → 故障排查”的路径展开。建议学习者按以下顺序推进：
- 先理解 I2C、SPI、UART、CAN 的电气特性与典型拓扑；
- 再阅读
AP_HAL与AP_Vehicle中设备注册的基本流程； - 然后动手接入一个真实外设，完成参数配置与日志验证；
- 最后学习多源冗余、健康检查与故障降级策略。
复盘时请重点区分三类问题：硬件层问题（接线、供电、终端电阻）、配置层问题（参数类型、地址、方向）、驱动层问题（协议不匹配、固件版本过旧）。大多数“设备不工作”并非驱动缺陷，而是前两层没有对齐。掌握这套分层排查思路，你就能在复杂机型与外设组合中保持清晰的判断力。