QGroundControl ArduPilot 舵机输出(Servo Outputs)页面详解:实时 PWM 监视与 16 通道参数调校

原创2026-10-14 13:43:591,691 阅读
文章标签:无人机

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(舵机输出)**即可进入该页面。其核心能力可概括为两点:

  1. 实时可视化:以进度条 + 数字的形式展示各通道当前的 PWM 输出值(单位微秒 µs),并随飞控遥测实时刷新,用于验证舵机/电调对遥控或自动飞行控制输入的响应是否正确;
  2. 在线配置:直接读写飞控上 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,即直接展示参数枚举值对应的可读名称)。功能取值随机型而不同,典型配置如:

以上数值为仓库离线参数文件中的出厂/示例值,具体含义由 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”列的数据完全来自只读遥测,不在飞控端存储任何参数。其完整链路如下(这也是原文档“实时可视化”背后的实现原理):

  1. 飞控上行遥测:ArduPilot 周期性广播 SERVO_OUTPUT_RAW MAVLink 消息,包含 servo1_raw ~ servo16_raw 共 16 个通道的 PWM 值(µs);
  2. 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);
  3. Controller 转发:ServoOutputMonitorController.cc 在构造函数中连接该信号,servoValuesChanged() 更新内部 QVector<int> _servoValues(初始 16 个元素全部为 -1),并逐个发出 servoValueChanged(servo, pwmValue) 与 servoCountChanged;
  4. 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 范围内。

四、实测操作流程建议

  1. 连接并识别机型:确保地面站与 ArduPilot 飞控建立 MAVLink 连接,且固件已识别(页面依赖参数表,需等参数下载完成);
  2. 查看实时响应:在 Servo Outputs 页面观察 Position 列进度条——拨动遥控器对应通道或让飞控进入自稳,进度条应同步变化;无响应时优先排查上面的遥测链路;
  3. 调整行程与中立点:用 −/+ 长按微调或直接输入,将各通道 SERVOn_MIN / TRIM / MAX 调至与舵机/电调机械行程匹配的值;
  4. 修正方向:舵面方向错误时勾选 SERVOn_REVERSED,无需改动机械安装;
  5. 核对功能分配:通过 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 聚焦全通道静态配置与监视。

关联源码索引(便于深入阅读)

登录后查看全文
qgroundcontrol