QGroundControl 与 ArduPilot 舵机输出(Servo Outputs)配置与实时监控实战指南
QGroundControl 与 ArduPilot 舵机输出(Servo Outputs)配置与实时监控实战指南
Servo Outputs(舵机输出)页面是 QGroundControl 面向 ArduPilot 飞控提供的专用设置面板,用于对最多 16 路舵机/电机输出通道进行实时 PWM 可视化和参数配置。本文以仓库文档与源码实现为依据,系统讲解该页面的逐通道控制项、参数含义、默认取值,以及从 MAVLink 遥测到界面进度条刷新的完整数据链路,帮助你在装机、舵机行程校准和通道反向排查中快速上手。
页面定位与功能概览
在 QGroundControl 中,当连接 ArduPilot 飞控后,Setup(设置)视图下会出现 Servo Outputs 页面,其对应源码实现为 src/AutoPilotPlugins/APM/APMServoComponent.qml(C++ 侧注册于 APMServoComponent.cc 与 APMAutoPilotPlugin.cc)。
该页面提供两大核心能力:
- 实时可视化:每个通道的当前 PWM 输出以进度条加数值的形式实时刷新,来源是飞控回传的舵机输出遥测,可用于验证控制输入到物理输出的响应是否正确;
- 参数配置:对每个通道的
SERVOn_FUNCTION、SERVOn_MIN、SERVOn_TRIM、SERVOn_MAX、SERVOn_REVERSED参数进行可视化编辑,写入飞控参数表。
页面可管理的通道数量为 16(对应源码中 _maxServos: 16 与 ServoOutputMonitorController 内部 QVector<int>(16, -1) 的固定容量,见 ServoOutputMonitorController.h)。
通道可见性规则
并非所有 16 行通道都会显示。页面遵循一条关键规则:只有当通道存在 SERVOn_FUNCTION 参数时,该行才可见。这一判断在 QML 中由 servoExists(n) 函数实现:
function servoExists(n) {
return controller.parameterExists(-1, "SERVO" + n + "_FUNCTION")
}
即页面会先向飞控查询参数表中是否已存在对应通道的 SERVOn_FUNCTION。从源码结构看,这一机制是为了让页面自动适配不同机型——Copter/Sub 默认只有前 4 路(或前 6 路)舵机配置了功能,而固定翼和直升机通常配置更多通道(详见下文"各机型默认通道分配")。
逐通道控制项详解
每个可见通道在表格中占一行,共 7 列。下表完整列出各列含义及其对应的飞控参数(表结构继承自 servo_outputs.md,并补充了源码实现的细节说明):
| 列 | 说明 | 对应参数 |
|---|---|---|
| # | 舵机通道编号(1–16),按 index + 1 渲染 |
— |
| Position | 实时 PWM 值,以进度条加数字读数显示 | (只读遥测) |
| Function | 输出功能分配(如 Motor1、Aileron、Throttle 等) | SERVOn_FUNCTION |
| Min | 最小 PWM 输出(可通过 +/− 按钮调整) | SERVOn_MIN |
| Trim | 中位/中立 PWM 值(可通过 +/− 按钮调整) | SERVOn_TRIM |
| Max | 最大 PWM 输出(可通过 +/− 按钮调整) | SERVOn_MAX |
| Reversed | 反转输出方向 | SERVOn_REVERSED |
#(通道号)
由 QML 中 Repeater 以 _maxServos = 16 为模型逐行生成,显示 index + 1,即 1 到 16。不满足 servoExists() 的行会被隐藏,因此实际看到的行数由飞控参数决定。
Position(实时位置条)
这是页面上唯一的只读列,数据来自飞控遥测而非参数表。进度条的填充比例按当前 PWM 值相对 SERVOn_MIN / SERVOn_MAX 的归一化位置计算:
readonly property double _range: _maxValue - _minValue
readonly property double _ratio: (_range > 0 && !isNaN(_rawValue) && !isNaN(_minValue))
? Math.max(0, Math.min(1, (_rawValue - _minValue) / _range))
: 0
即比例被钳制在 0–1 之间,当读数有效时进度条填充 _ratio * width,同时条中央以加粗数字显示取整后的 PWM 值(无效时显示 -)。该进度条宽度固定(_positionBarWidth),避免表格因数值长度变化而重排。
Function(功能分配)
以 FactComboBox 呈现,绑定 SERVOn_FUNCTION 参数。ArduPilot 用数字编码输出功能,例如仓库中离线编辑参数文件 src/FirmwarePlugin/APM/*.OfflineEditing.params 显示:
- Copter 默认
SERVO1_FUNCTION=33、SERVO2_FUNCTION=34、SERVO3_FUNCTION=35、SERVO4_FUNCTION=36,即 Motor1–Motor4; - Plane 默认
SERVO1_FUNCTION=4(Aileron)、SERVO2_FUNCTION=19(Elevator)、SERVO3_FUNCTION=70(Throttle)、SERVO4_FUNCTION=21(Rudder); - Rover 默认
SERVO1_FUNCTION=26(Steering)、SERVO3_FUNCTION=70(Throttle); - Sub 默认
SERVO1_FUNCTION=33~SERVO6_FUNCTION=38(Motor1–Motor6),另有SERVO8_FUNCTION=7、SERVO9_FUNCTION=59等特殊功能。
可见不同机型对同一功能的数字编码是通用的,但默认分配各不相同。修改 SERVOn_FUNCTION 会改变该物理输出通道的职责,是完成"接线 → 功能映射"的第一步。
Min / Trim / Max(PWM 行程设置)
三列均采用"− 按钮 + 数值输入框 + + 按钮"的 RowLayout 组合,通过 FactTextField 绑定对应参数。长按按钮时会触发连续调节:按住后先经过 350 ms 的 repeatInitial 定时器,随后进入 80 ms 间隔的 repeatTimer 重复累加,每次变化 1 个单位,松开即停止(_repeatDir 置 0)。这让你既可以在数值框直接输入精确值,也可以按住按钮快速逼近目标行程。
在 ArduPilot 中,这三个参数分别定义该通道输出的下端点、中位点和上端点。仓库默认参数值(如 Copter.OfflineEditing.params)统一为:
SERVOn_MIN = 1100(μs)SERVOn_TRIM = 1500(μs)SERVOn_MAX = 1900(μs)
以上是典型的 1100–1900 μs 舵机/电调行程默认值,实际应根据舵机机械行程和电调协议按需微调。
Reversed(反向)
以 FactCheckBox 绑定 SERVOn_REVERSED 参数,默认值为 0(不反转)。当机械安装导致某通道运动方向相反时,勾选该框即可反转输出方向,避免在摇杆端额外处理。
实时遥测链路:从 MAVLink 报文到进度条
Position 列的数据并非轮询参数表,而是由 QGroundControl 解析飞控周期性下发的 MAVLink SERVO_OUTPUT_RAW 报文驱动。完整链路如下:
- 报文解析:在 Vehicle.cc 中,
MAVLINK_MSG_ID_SERVO_OUTPUT_RAW被解码,servo1_raw~servo16_raw共 16 个字段逐一取出。ArduPilot 通常把 16 路输出放在同一个报文里(port 字段常为 0)。 - 无效值归一化:值为
UINT16_MAX(65535)的通道代表无输出,会被转换为 -1,表示"不可用"。 - 信号广播:处理后的 16 路数组通过
Vehicle::servoOutputsChanged(QVector<int>)信号发出(声明见 Vehicle.h)。 - 控制器中转:ServoOutputMonitorController.cc 在构造时将该信号连接到内部槽
servoValuesChanged,按通道逐路发出servoValueChanged(servo, pwmValue),并动态维护servoCount。 - 界面刷新:APMServoComponent.qml 中的
Connections监听servoValueChanged,把新值写入对应行 Position 列的pwmValue属性,触发进度条与数字刷新。
由此,你可以直接观察到:推动遥控器摇杆、切换飞行模式或执行电机测试时,各通道进度条应实时响应;若某通道无反应或数值为 -,通常说明该通道未输出(RAW 值为 65535)或未配置 SERVOn_FUNCTION。
各机型默认通道分配参考
仓库内置的离线编辑参数文件(src/FirmwarePlugin/APM/ 下的 Copter、Plane、Rover、Sub 四份 .OfflineEditing.params)提供了各机型的出厂默认分配,可作为配置对照:
| 机型 | 默认已分配通道 | 典型功能 |
|---|---|---|
| Copter | SERVO1–4 | Motor1–Motor4(33–36) |
| Plane | SERVO1–4 | Aileron(4)、Elevator(19)、Throttle(70)、Rudder(21) |
| Rover | SERVO1、SERVO3 | Steering(26)、Throttle(70) |
| Sub | SERVO1–6、SERVO8、SERVO9 | Motor1–Motor6(33–38)、Camera Tilt(7) 等 |
注意:参数文件只是离线编辑时使用的默认值模板,实际生效值以飞控参数表为准。
相关页面与进一步阅读
- 直升机机型还提供额外的斜盘(Swashplate)与旋翼转速控制(RSC)设置,其中斜盘通道同样使用
SERVO1_FUNCTION~SERVO8_FUNCTION(见 APMHeliComponent.qml 与 vehicle_specific.md); - 若需了解电调校准与电机测试,参见同一目录下的 esc.md;
- 原文其他语言版本:中文版、英文版、韩文版。
小结
Servo Outputs 页面把"输出功能映射"与"PWM 行程标定"两项装机必备操作整合进一个实时表格:先通过 SERVOn_FUNCTION 指定每路输出的职责,再用 Min/Trim/Max 与 +/− 按钮校准行程,用 Reversed 纠正方向,最后借助 Position 进度条实时验证控制链路。掌握这套操作流程,即可完成 ArduPilot 无人机输出通道的标准化配置与排障。