Servo Outputs(ArduPilot 舵机/电机输出)配置指南

原创2026-10-12 13:38:081,873 阅读
文章标签:无人机

Servo Outputs(ArduPilot 舵机/电机输出)配置指南

Servo Outputs 页面是 QGroundControl 中面向 ArduPilot 飞控的专用设置页,用于对最多 16 路舵机/电机 PWM 输出通道进行实时可视化监控与参数化配置。本文将以官方文档为主线,结合 QGroundControl 源码中的实际实现(APMServoComponent 页面、ServoOutputMonitorController 控制器以及 Vehicle 对 SERVO_OUTPUT_RAW 遥测的处理),详细介绍每个通道各列的字段含义、对应飞控参数及底层数据链路,帮助你快速完成舵机行程、中位(Trim)、输出方向与功能分配的调试。

页面概述:实时可视化 + 参数化配置

该页面(源码实现为 APMServoComponent.qml)的核心能力有两点:

  • 实时可视化:以进度条 + 数字的形式实时显示各通道当前的 PWM 输出值(Position),数据来自飞控的 SERVO_OUTPUT_RAW 遥测消息;
  • 参数化配置:每个通道的 Function、Min、Trim、Max、Reversed 均可直接写入 ArduPilot 对应的 SERVOn_* 参数,无需切换到参数编辑器。

页面代码中对通道数做了明确约束:

readonly property int _maxServos: 16

即最多渲染 16 路通道(SERVO1~SERVO16)。每一行是否显示,取决于对应通道的 SERVOn_FUNCTION 参数是否存在:

function servoExists(n) {
    return controller.parameterExists(-1, "SERVO" + n + "_FUNCTION")
}

这意味着只有飞控固件中确实定义了该通道功能参数的通道才会出现在页面上,未使用的通道不会占位显示。

逐列字段说明

每个舵机通道(只要其 SERVOn_FUNCTION 参数存在)都会显示以下 7 列:

列名 含义 关联飞控参数
# 舵机编号(1–16) —
Position 实时 PWM 值,以进度条 + 数字读数展示 (只读遥测)
Function 输出功能分配(如 Motor1、Aileron、Throttle 等) SERVOn_FUNCTION
Min 最小 PWM 输出(可通过 +/− 按钮调整) SERVOn_MIN
Trim 中位/居中 PWM 值(可通过 +/− 按钮调整) SERVOn_TRIM
Max 最大 PWM 输出(可通过 +/− 按钮调整) SERVOn_MAX
Reversed 反转输出方向 SERVOn_REVERSED

#:通道编号

第一列为舵机编号 1–16,对应 ArduPilot 的 SERVO1~SERVO16 参数组,由页面中的 Repeater 按 index + 1 生成。该列仅作标识,不与任何参数直接关联。

Position:实时 PWM 进度条

Position 列是本页最具特色的“实时可视化”能力。其数据来源并非参数,而是只读遥测:飞控通过 MAVLink 的 SERVO_OUTPUT_RAW 消息周期性上报各通道的实际输出 PWM(微秒)。

在底层,Vehicle.cc 对 MAVLINK_MSG_ID_SERVO_OUTPUT_RAW 的处理逻辑如下:

  • 将 servo1_raw~servo16_raw 共 16 个字段解包为 rawValues[16];
  • 对每个通道,若原始值为 UINT16_MAX(即飞控未使用该输出),则归一化为 -1 表示无效:
    _servoOutputRawValues[servoIndex] = (rawValues[servoIndex] == UINT16_MAX) ? -1 : static_cast<int>(rawValues[servoIndex]);
    
  • 随后发出信号:
    emit servoOutputsChanged(_servoOutputRawValues);
    

这些值(索引 0~15 对应 SERVO1~SERVO16,无效值记为 -1)由 ServoOutputMonitorController 监听并转发给 QML 页面:

(void) connect(_vehicle, &Vehicle::servoOutputsChanged, this, &ServoOutputMonitorController::servoValuesChanged);

servoValuesChanged 中会为每个通道发出 servoValueChanged(servo, pwmValue) 信号,QML 侧的 Connections 处理器随即刷新对应行的进度条与数字(见 APMServoComponent.qml)。

进度条的具体表现逻辑(同样见 APMServoComponent.qml):

  • 以该通道的 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 之间,填充色使用主题绿色(qgcPal.colorGreen),轨道为灰色半透明;
  • 中间以加粗数字显示取整后的实际 PWM 值(微秒);当数据无效(PWM 为 -1 或 MIN/MAX 参数缺失)时显示 -。

通过这一列,你可以实时验证舵机/电机输出是否随遥控器摇杆、模式切换或飞控指令正确响应,无需额外接示波器或 LED 指示灯。

Function:输出功能分配

Function 列是一个下拉选择框(FactComboBox),对应参数 SERVOn_FUNCTION。可选项涵盖 ArduPilot 的常用输出功能,例如:

  • Motor1~Motor8 等电机输出;
  • Aileron、Elevator、Rudder、Throttle 等固定翼舵面;
  • Flap、Aux1 等辅助输出;
  • 其他自定义功能(具体枚举以飞控固件版本为准)。

在仓库提供的离线参数文件中,可以看到典型的取值示例(见 Plane.OfflineEditing.params):

SERVO1_FUNCTION  4
SERVO1_MAX       1900
SERVO1_MIN       1100
SERVO1_REVERSED  0
SERVO1_TRIM      1500

其中 SERVO1_FUNCTION = 4 表示该通道被分配为某一标准功能(功能编号的具体含义以 ArduPilot 官方参数说明为准)。修改 Function 即改写了飞控的输出映射,通常需要配合飞控重启/参数刷新使设置生效。

Min / Trim / Max:PWM 行程设置

三列均使用 “−/+ 按钮 + 数字输入框” 的交互方式(FactTextField),对应参数:

列 参数 默认值参考(Plane 离线参数)
Min SERVOn_MIN 1100
Trim SERVOn_TRIM 1500
Max SERVOn_MAX 1900

需要特别说明的是 QML 中的长按连加/连减实现(见 APMServoComponent.qml):

  • 单击 −/+ 按钮:步进 ±1,直接修改参数值;
  • 按住不放:先启动 350ms 的 repeatInitial 定时器,触发后再启动 80ms 间隔的 repeatTimer 持续连加/连减,松开按钮即停止。
onPressed: {
    _repeatDir = -1
    spFact.value -= 1
    repeatInitial.start()   // 350ms 后进入连续调节
}
// 松开时:
onReleased: {
    _repeatDir = 0
    repeatInitial.stop()
    repeatTimer.stop()
}

这样既支持精确的 ±1 微调,也支持快速大步调节,方便在飞机上快速标定行程。

实际调参中的典型做法:

  1. 先用 −/+ 把 Trim 调整到舵面机械中立位(通常 1500µs 附近,视舵机中立角而定);
  2. 再分别调整 Min 与 Max,让舵面在两端极限位置不堵转、不撞限位;
  3. 若舵面动作方向与预期相反,勾选 Reversed 即可,无需重焊线缆。

Reversed:输出方向反转

该列为复选框(FactCheckBox),对应参数 SERVOn_REVERSED(默认 0,勾选后写 1)。作用是把该通道的 PWM 输出方向反转,用于修正因舵机安装方向、连杆结构等原因造成的反向问题。

页面如何被加载:组件注册与显示条件

Servo Outputs 页面并不是无条件显示在 Setup(设置)视图中的。在 APMAutoPilotPlugin.cc 中,组件创建的判断条件非常明确:

if (_vehicle->parameterManager()->parameterExists(-1, QStringLiteral("SERVO1_MIN"))) {
    _servoComponent = new APMServoComponent(_vehicle, this);
    _servoComponent->setupTriggerSignals();
    _components.append(QVariant::fromValue(qobject_cast<VehicleComponent*>(_servoComponent)));
}

也就是说,只有当飞控参数列表中检测到 SERVO1_MIN 参数时,Servo Outputs 组件才会被加入设置页组件列表。这也解释了为什么某些机型/固件版本(例如部分未暴露传统 SERVO 参数的子机型)不会出现该页面。

组件本身继承自 VehicleComponent(见 APMServoComponent.h):

bool requiresSetup() const final { return false; }
bool setupComplete() const final { return true; }

requiresSetup() = false 意味着它不是“必须完成设置才能起飞”的强制项,而是可选的高级调参入口;页面描述为 “Configure servo PWM limits, trim, direction, and function assignment.”(配置舵机 PWM 行程、中位、方向与功能分配),图标使用 MotorComponentIcon.svg。

QML 页面的加载路径由 APMServoComponent.cc 指定:

QUrl APMServoComponent::setupSource() const
{
    return QUrl::fromUserInput(QStringLiteral("qrc:/qml/QGroundControl/AutoPilotPlugins/APM/APMServoComponent.qml"));
}

数据链路总结

把上面的分析串起来,Position 实时数据的完整链路为:

ArduPilot 飞控
   └─ MAVLink SERVO_OUTPUT_RAW(servo1_raw..servo16_raw,单位 µs)
        └─ Vehicle::_handleMavlinkMessage → 解码、UINT16_MAX→-1 归一化
             └─ signal servoOutputsChanged(QVector<int>)
                  └─ ServoOutputMonitorController::servoValuesChanged
                       └─ signal servoValueChanged(servo, pwmValue)
                            └─ APMServoComponent.qml 进度条 + 数字刷新

而 Min / Trim / Max / Function / Reversed 则通过页面的 FactPanelController 直接读写飞控参数(SERVOn_MIN、SERVOn_TRIM、SERVOn_MAX、SERVOn_FUNCTION、SERVOn_REVERSED),属于“所见即所得”的参数化配置。注意 Position 是只读遥测,不可在页面上直接输入数值——要“设置”某个通道的期望输出位置,应通过修改 Min/Trim/Max 或 Function 实现。

相关阅读

登录后查看全文
qgroundcontrol