QGroundControl ArduPilot 舵机输出(Servo Outputs)页面详解:实时 PWM 监视与 16 通道参数调校
QGroundControl ArduPilot 舵机输出(Servo Outputs)页面详解:实时 PWM 监视与 16 通道参数调校
导读:Servo Outputs 是 QGroundControl(QGC)为 ArduPilot 飞控提供的舵机/电机输出配置页,可在同一界面内实时查看最多 16 路 PWM 输出值,并直接编辑各通道的功能分配(SERVOn_FUNCTION)、最小/中位/最大脉宽(SERVOn_MIN/TRIM/MAX)与反向(SERVOn_REVERSED)。读完本文你将掌握该页面的每一列含义、底层 MAVLink 遥测链路(SERVO_OUTPUT_RAW → Vehicle::servoOutputsChanged → QML 进度条)以及可落地的调机操作手法。
一、页面定位:ArduPilot 输出通道的“实时仪表 + 参数编辑器”
在 QGC 的**Setup(设置)视图 → 左侧 ArduPilot 组件列表 → Servo Outputs(舵机输出)**即可进入该页面。其核心能力可概括为两点:
- 实时可视化:以进度条 + 数字的形式展示各通道当前的 PWM 输出值(单位微秒 µs),并随飞控遥测实时刷新,用于验证舵机/电调对遥控或自动飞行控制输入的响应是否正确;
- 在线配置:直接读写飞控上
SERVO1_FUNCTION~SERVO16_*系列参数,无需切换到参数表(Parameters)页面逐项查找。
该页面属于 ArduPilot 专属组件。从源码看,APMAutoPilotPlugin.cc 在初始化组件列表时,只要目标飞控存在 SERVO1_MIN 参数,就会注册 APMServoComponent(APMAutoPilotPlugin.cc#L110-L114),其 description() 自述为 "Configure servo PWM limits, trim, direction, and function assignment.",页面渲染源指向 APMServoComponent.qml。
二、单通道七列控件:参数与界面的一一对应
页面主体是一个 7 列网格(对应 QML 中 GridLayout 的 7 列定义),每个存在 SERVOn_FUNCTION 参数的通道(n 为 1–16)都会显示一行。各列含义与原文档一致,整理如下:
| 列 | 说明 | 对应飞控参数 |
|---|---|---|
| # | 舵机/电机通道编号(1–16) | —(仅用于标识) |
| Position | 实时 PWM 值,以进度条 + 加粗数字读出 | (只读遥测,来自 SERVO_OUTPUT_RAW) |
| Function | 输出功能分配(如 Motor1、Aileron、Throttle 等),下拉框选择 | SERVOn_FUNCTION |
| Min | 最小 PWM 输出,−/+ 按钮微调 |
SERVOn_MIN |
| Trim | 中立/居中 PWM 值,−/+ 按钮微调 |
SERVOn_TRIM |
| Max | 最大 PWM 输出,−/+ 按钮微调 |
SERVOn_MAX |
| Reversed | 是否反向输出,复选框 | SERVOn_REVERSED |
该表结构与 APMServoComponent.qml 中的列头定义(Position / Function / Min / Trim / Max / Reversed)严格对应;QML 中通过 servoExists(n) 判断 SERVOn_FUNCTION 是否存在来决定该行是否显示(APMServoComponent.qml#L39-L41),这与原文档“若该通道的 SERVOn_FUNCTION 参数存在才显示”的描述一致。
1. Function:输出功能分配
该列是一个绑定 SERVOn_FUNCTION 的 FactComboBox 下拉框(indexModel: false,即直接展示参数枚举值对应的可读名称)。功能取值随机型而不同,典型配置如:
- Copter:
SERVO1_FUNCTION = 33起依次为 Motor1~4(Copter.OfflineEditing.params 中SERVO1_FUNCTION=33、SERVO2_FUNCTION=34、SERVO3_FUNCTION=35、SERVO4_FUNCTION=36); - Plane(固定翼):
SERVO1_FUNCTION = 4(Elevator 升降舵,见 Plane.OfflineEditing.params); - Rover(地面车):
SERVO1_FUNCTION = 26(Steering 转向,见 Rover.OfflineEditing.params); - Sub(水下):与 Copter 类似,
SERVO1_FUNCTION = 33(见 Sub.OfflineEditing.params)。
以上数值为仓库离线参数文件中的出厂/示例值,具体含义由 ArduPilot 固件的 SERVO 输出功能枚举定义。改错功能可能导致舵面或电机行为异常,建议结合官方参数说明再动手。
2. Min / Trim / Max:PWM 范围微调
三列均采用“− 按钮 + FactTextField 输入框 + + 按钮”的组合(QML 中为 RowLayout 内嵌两个 QGCButton 和一个 FactTextField),单位默认隐藏(showUnits: false),值为微秒。交互上有两个细节值得注意:
- 长按连击:按下
−/+先执行一步(±1µs),若持续按住 350ms 后进入 80ms 间隔的连续步进(APMServoComponent.qml#L200-L262),便于快速跨越较大范围;松开即停止; - 可输入:也可直接在文本框中键入精确数值(如 1500)。
从仓库离线参数可见各机型的典型取值范围:Copter/Plane/Sub 为 MIN=1100、TRIM=1500、MAX=1900;Rover 为 MIN=1000、TRIM=1500、MAX=2000。实际应以飞控当前参数为准,QGC 的进度条绘制也会使用 SERVOn_MIN/MAX 作为刻度基准(见下文)。
3. Reversed:输出反向
该列为绑定 SERVOn_REVERSED 的 FactCheckBox 复选框(居中显示)。勾选后输出方向反转,常用于舵机安装方向相反、需在飞控端统一舵面动作方向的场景。
三、Position 进度条的实时更新链路:从 MAVLink 到界面
“Position”列的数据完全来自只读遥测,不在飞控端存储任何参数。其完整链路如下(这也是原文档“实时可视化”背后的实现原理):
- 飞控上行遥测:ArduPilot 周期性广播
SERVO_OUTPUT_RAWMAVLink 消息,包含servo1_raw~servo16_raw共 16 个通道的 PWM 值(µs); - Vehicle 层解码:Vehicle.cc#L604-L635 在消息分发中解析该消息,将 16 个原始值存入
_servoOutputRawValues,其中UINT16_MAX(无效通道)会被归一化为-1,随后发出servoOutputsChanged信号。信号签名注释明确:"The current servo output values in microseconds (0-15 -> SERVO1..SERVO16). Invalid values are -1."(Vehicle.h#L809-L811); - Controller 转发:ServoOutputMonitorController.cc 在构造函数中连接该信号,
servoValuesChanged()更新内部QVector<int> _servoValues(初始 16 个元素全部为 -1),并逐个发出servoValueChanged(servo, pwmValue)与servoCountChanged; - QML 绘制:页面中
ServoOutputMonitorController { id: servoMonitor }实例通过Connections监听onServoValueChanged,将最新 PWM 值写入对应进度条委托的pwmValue属性(APMServoComponent.qml#L163-L171)。
进度条的视觉实现也值得注意:QML 中按 (rawValue - SERVOn_MIN) / (SERVOn_MAX - SERVOn_MIN) 计算填充比例并夹取到 0,1],即进度条以当前通道的 Min/Max 为刻度归一化显示;无有效遥测或缺少 MIN/MAX 参数时填充宽度为 0、文本显示 -([APMServoComponent.qml#L100-L159)。因此,如果某通道进度条不动或显示 -,应优先检查:飞控是否在发送 SERVO_OUTPUT_RAW、该通道 SERVOn_MIN/MAX 参数是否存在、以及通道编号是否在 1–16 范围内。
四、实测操作流程建议
- 连接并识别机型:确保地面站与 ArduPilot 飞控建立 MAVLink 连接,且固件已识别(页面依赖参数表,需等参数下载完成);
- 查看实时响应:在 Servo Outputs 页面观察 Position 列进度条——拨动遥控器对应通道或让飞控进入自稳,进度条应同步变化;无响应时优先排查上面的遥测链路;
- 调整行程与中立点:用
−/+长按微调或直接输入,将各通道SERVOn_MIN / TRIM / MAX调至与舵机/电调机械行程匹配的值; - 修正方向:舵面方向错误时勾选
SERVOn_REVERSED,无需改动机械安装; - 核对功能分配:通过 Function 下拉框确认每个输出口绑定的功能(如电机、升降舵、转向),与离线参数文件中的示例值比对。
安全提示:进行任何输出调整前务必卸下螺旋桨。该页面会实时写入飞控参数,改动
SERVOn_*后参数即时生效;与电机/电调相关的脉宽范围校准可进一步参考同目录下的 ESC 校准(ArduPilot)文档(涉及MOT_PWM_TYPE、MOT_PWM_MIN/MAX与ESC_CALIBRATION)。
五、与相邻功能页面的关系
- APMHeliComponent(直升机设置页):同样直接操作
SERVO1_FUNCTION / MIN / MAX / TRIM / REVERSED五个参数用于尾舵机/斜盘配置(见 APMHeliComponent.qml#L85-L104),与 Servo Outputs 页写入的是同一组参数,二者会互相反映; - ESC 校准页:负责电机输出协议与油门行程校准,而 Servo Outputs 页负责通用 PWM 限位与功能分配,两者互补但不重叠(esc.md);
- Motor 页:针对多旋翼电机测试,与 Servo Outputs 同属 ArduPilot 设置组件,但 Motor 页聚焦单电机测试,Servo Outputs 聚焦全通道静态配置与监视。
关联源码索引(便于深入阅读)
- 页面 QML 实现:APMServoComponent.qml(7 列网格、
servoExists()显隐逻辑、−/+连击 Timer) - 组件注册与生命周期:APMAutoPilotPlugin.cc#L110-L114、APMServoComponent.cc
- 实时遥测控制器:ServoOutputMonitorController.cc、ServoOutputMonitorController.h
- MAVLink 遥测解码:Vehicle.cc#L604-L635、Vehicle.h#L809-L811
- 各机型默认参数示例:Copter.OfflineEditing.params、Plane.OfflineEditing.params、Rover.OfflineEditing.params、Sub.OfflineEditing.params