PX4 执行机构(Actuator)配置与测试完全指南:几何、输出映射与电机/舵面调校

原创2026-09-22 12:24:291,943 阅读
文章标签:无人机机器人RTOS嵌入式固件传感器驱动硬件开发ROS自动驾驶系统编程

PX4 执行机构(Actuator)配置与测试完全指南:几何、输出映射与电机/舵面调校

本篇指南以 PX4 Autopilot 官方文档 docs/en/config/actuators.md 为骨架,结合仓库内 control_allocator 参数定义、output_functions.yaml 输出函数表与 actuator_test.cpp 源码实现,系统讲解 QGroundControl 中 Actuators Setup 视图的三大功能:几何(Geometry)配置、执行机构输出(Actuator Outputs)映射、以及电机/舵面测试(Actuator Testing)。读完本文你将掌握从选型机架、配置电机与控制面几何、把逻辑功能映射到物理输出引脚,到通过滑杆完成电机正反转、舵面中立点与行程调校的完整实战流程(适用于 PX4 v1.14+)。

Overview:Actuators 配置视图总览

在 QGroundControl 中通过 "Q"(应用菜单)> Vehicle Setup > Actuators(选项卡)打开该视图。视图中显示的要素取决于 所选机架(airframe),输出默认映射关系参见 Airframe Reference。

视图划分为三个区域:

  • Geometry(几何):配置所选机架的几何参数,包括 电机 的数量、位置与属性,以及 控制面 和 电机倾转舵机 的数量与属性。
  • Actuator Outputs(执行机构输出):将电机、舵面与其他执行机构映射到具体物理输出。
  • Actuator Testing(执行机构测试):验证电机与舵面的运动方向/速度是否符合预期。

例如一架四旋翼(X 构型)的典型配置为:4 个电机映射到 AUX1~AUX4 输出并连接 DShot1200 ESC,同时将 PWM400 AUX 输出用于降落伞与起落架控制:

Actuators MC (QGC) 典型多旋翼配置界面

::: info 视图默认只显示最常见的设置;勾选右上角 Advanced 复选框可显示全部设置项。 :::

Geometry:几何配置

Geometry 区域用于设置所选 机架 的所有可配置几何参数,包括 电机 的数量与位置、控制面 的数量/功能/属性,对于 VTOL 倾转旋翼机还包含 倾转舵机 的数量与属性。

::: info UI 会针对所选机架类型定制显示:

  • 仅显示该机架类型可配置的字段,不可配置字段被隐藏;
  • 电机位置示意图目前仅对多旋翼机架显示。 :::

Motor Geometry:电机几何

电机几何部分用于设置电机数量、相对位置与各项属性。大部分电机属性适用于所有机架,少数属性仅针对特定机架,例如 Tilted-by(由哪个舵机倾转)仅适用于 Tiltrotor VTOL,Axis 仅适用于 Standard VTOL。

多旋翼机架会提供一张各电机相对 x、y 位置示意图;其他机架的电机位置可参考 Airframe Reference。

多旋翼电机几何

以下为四旋翼(quadrotor)几何设置的界面(含普通与 Advanced 模式):

Geometry MC (QGC) 多旋翼几何配置

首先通过 Motors 下拉框选择电机数量(上例为 4)。随后可对每个电机设置:

  • Position X / Position Y / Position Z:FRD 坐标系下的位置,单位米。
  • (Advanced) Direction CCW:勾选表示电机逆时针旋转(不勾选为顺时针)。
  • (Advanced) Bidirectional:勾选表示 双向电机。
  • (Advanced) Slew Rate:电机输出达到最大值所需的最短时间,详见 Control Surfaces Geometry。

::: info X、Y、Z 位置基于 FRD 坐标系、相对重心(centre of gravity),这可能与飞控安装位置不一致! :::

在源码层面,这些界面字段与 control_allocator/module.yaml 中的 CA_ROTOR${i}_PX/PY/PZ(位置,单位 m,默认 0)、CA_ROTOR${i}_AX/AY/AZ(推力矢量轴向分量,AZ 默认 -1 即朝上)、CA_ROTOR${i}_CT(推力系数,默认 6.5,Thrust = CT * u^2)、CA_ROTOR${i}_KM(力矩系数,CCW 取正、CW 取负,默认 0.05)一一对应,这些参数最终被控制分配器(control allocator)用于将期望力矩换算为各电机的输出信号。

VTOL 四旋翼 Tailsitter 电机几何

VTOL Quad Tailsitter 的电机几何配置字段与多旋翼完全相同,其他 tailsitter 机型配置方式类似:

Geometry motor: tailsitter vtol 倾转尾座式电机几何

VTOL Tiltrotor 电机几何

Generic Quadplane VTOL Tiltrotor 的电机几何配置如下,其他 VTOL tiltrotors 配置方式类似:

Geometry motor: tiltrotor vtol 倾转旋翼电机几何

  • Tilted by:用于倾转该电机的关联舵机,其属性在 Motor Tilt Servo Geometry 中定义(对应参数 CA_ROTOR${i}_TILT,可取值 None / Tilt 1~4)。

Standard VTOL 电机几何

Generic Standard VTOL 的电机几何配置与其他 Standard VTOL 类似:

Geometry motor: standard vtol 标准垂直起降电机几何

电机字段与多旋翼基本相同,多了一个用于指示电机推动机体方向的字段(Standard VTOL 中,悬停电机通常设为 "Upwards",推进电机设为 "Forwards"):

  • Axis:取值 Upwards、Downwards、Forwards、Backwards、Leftwards、Rightwards、Custom。
    • 选择 Custom 时 UI 会显示三个附加字段用于手动设置电机方向向量(对应 CA_ROTOR${i}_AX/AY/AZ)。

其他车辆类型的电机几何

其他车辆类型(如固定翼仅单个推进电机、差速转向 rover 有油门与转向电机)会按自身机架定义相应的电机几何,属性字段大体与上述一致。

Motor Position Coordinate System:电机位置坐标系

电机位置采用机体坐标系 FRD:X 轴指向前方、Y 轴指向右侧、Z 轴指向下方。原点为车辆重心(COG),不一定与自驾仪安装位置重合:

Actuators CG reference diagram 重心参考示意图

Bidirectional Motors:双向电机

部分车辆使用双向电机(可正反转),例如需要前进/后退的地面车辆,或推进电机可双向旋转的 VTOL。使用双向电机时务必为对应电机勾选 Reversible 复选框(Advanced 选项):

Reversible 双向电机配置

同时还需确保 ESC 支持反转:

Control Surfaces Geometry:控制面几何

控制面区域用于设置车辆上控制面的数量与类型,某些情况下还需设置 Trim 与 Slew Rate。高级用户可以配置 roll scale、yaw scale、pitch scale(一般默认值即可,无需修改)。以下为具有两个副翼(ailerons)的示例,副翼只影响滚转,因此 pitch 与 yaw 字段被禁用:

Control Surface Setup Example 控制面配置示例

各字段说明:

  • Control Surfaces:控制面数量(首先设置此值)。
  • Type:每个控制面的类型,可选:LeftAileron、RightAileron、Elevator、Rudder、Left Elevon、Right Elevon、Left V-Tail、Right V-Tail、Left Flap、Right Flap、Airbrakes、Custom。对应参数 CA_SV_CS${i}_TYPE(module.yaml 中还额外支持 Left/Right A-tail、Single Channel Aileron、Steering Wheel、Left/Right Spoiler 等枚举值)。
  • Roll Torque:执行机构绕滚转轴的效能(归一化 -1~1),一般使用默认值。对应参数 CA_SV_CS${i}_TRQ_R。
  • Pitch Torque:绕俯仰轴的效能(-1~1),对应参数 CA_SV_CS${i}_TRQ_P。
  • Yaw Torque:绕偏航轴的效能(-1~1),对应参数 CA_SV_CS${i}_TRQ_Y。
  • Trim:无输入时加到执行机构上的偏移量,使舵面居中。通常靠试错确定;推荐改用更完善的 PWM_CENT 参数:见 PWM 控制面(围绕中立点双向运动)。对应参数 CA_SV_CS${i}_TRIM(范围 -1.0~1.0,仅当所有 PWM Center 参数为默认值时才能设置,官方不建议 PWM 舵机使用该参数)。
  • (Advanced) Slew Rate:电机/舵机信号通过其完整输出范围所允许的最短时间(秒),即执行机构变化率限制(未设置则不限速)。适用于移动过快会损坏或引起飞行扰动的执行机构,例如 tiltrotor VTOL 的倾转机构、快速动作的襟翼。例如设置为 2.0 意味着电机/舵机从 0 到 1 的变化不会在少于 2 秒内完成(可逆电机范围为 -1~1)。
  • (Advanced) Flap Scale:在"全襟翼配置"下该执行机构的偏转量 [0, 1](见 Flap/Spoiler Scale 配置),可将气动面配置为襟翼或补偿主襟翼产生的力矩。对应参数 CA_SV_CS${i}_FLAP(范围 -1.0~1.0)。
  • (Advanced) Spoiler Scale:在"全扰流板配置"下的偏转量 [0, 1],可将气动面配置为扰流板或补偿主扰流板力矩。对应参数 CA_SV_CS${i}_SPOIL(范围 -1.0~1.0)。
  • (VTOL only) Lock control surfaces in hover:
    • Enabled:大多数车辆悬停时不用舵面,锁定它们以免影响动力学;
    • Disabled:用于悬停时使用舵面的车辆,如 duo tailsitter(用 elevon 控制俯仰与偏航),也用于高速或大风悬停时需要舵面提供额外稳定的车辆。

Flap Scale 与 Spoiler Scale 配置

"Flap-control" 与 "Spoiler-control" 是两种气动构型,可由飞行员手动指令(RC 或摇杆,见 Flaps/Spoiler 手动控制),也可由控制器自动设置。例如飞行员或降落系统可在着陆前启用 "Spoiler-control" 以降低空速。

这是控制器告知分配器"相对全襟翼/全扰流板构型应调整多少机翼气动特性"的抽象方式(取值 [0,1],1 表示全范围)。分配器随后使用任何可用的控制面(通常为襟翼、副翼、升降舵)来实现请求的构型。

UI 中的 flap scale 与 spoiler scale 通知分配器:副翼、升降舵、襟翼、扰流板等控制面各自对请求的 "Flap-control"/"Spoiler-control" 值贡献多少——即当控制器要求"全襟翼"或"全扰流板"时,各控制面应偏转多少。

以下示例车辆具有两个副翼、一个升降舵、一个方向舵和两个襟翼:

Flaps and spoiler actuator configuration example 襟翼与扰流板配置示例

  • 襟翼的 Flap Scale 均为 1,表示 flap-control 为 1 时完全偏转;同时 slew rate 为 0.5/s,即完全偏转需要 2 秒(襟翼设置 slew rate 一般用于减小其动作带来的扰动)。
  • 副翼主要提供滚转力矩,Spoiler Scale 为 0.5,即控制器请求全扰流板构型时会额外向上偏转 50%。副翼总偏转 =(不对称的)滚转偏转 +(对称的)扰流板设定偏转。
  • 升降舵主要提供俯仰力矩,同时在 Flap Scale 和 Spoiler Scale 中有非零值,用于补偿襟翼/扰流板动作产生的俯仰力矩。本例中襟翼完全展开时升降舵会上偏 0.3,以抵消襟翼造成的低头力矩。

源码侧,扰流板/襟翼指令的斜率限制由参数 CA_SV_FLAP_SLEW(归一化 flap 设定值的变化率,范围 0.0~5.0,默认 0.5)体现。

Flaps 与 Spoiler 的手动控制

推荐的手动控制方式是:将一个手动控制开关映射到 AUX 输出(见 Generic Actuator Control with RC),再通过 FW_FLAPS_MAN 或 FW_SPOILERS_MAN 将该 AUX 输出映射到襟翼/扰流板功能。手动控制源可以是 RC 或 MAVLink。

::: warning 以下方法不推荐,将在未来版本移除,应迁移到基于 AUX 的方法:也可通过 RC_MAP_FLAPS 直接在 RC 上定义襟翼通道,将 FW_SPOILERS_MAN 设为 Flaps channel 即可用该通道控制扰流板。但此方法在手动控制源为 MAVLink 时不可用。 :::

Actuator Roll、Pitch 与 Yaw Scaling(力矩缩放)

::: info 绝大多数机架设置中,各控制面类型的默认缩放值都不应改动。 :::

Roll scale、Pitch scale 与 Yaw scale 表示执行机构绕对应轴归一化的效能。调校属于底层/高级话题,通常仅在调校耦合控制面(如同时控制俯仰与滚转的 elevon)时需要,此时需了解:

  • 输入数值会直接放入分配矩阵,该矩阵随后被求逆,以从期望力矩(归一化)得到控制信号;
  • 增大 scale 会减小控制面偏转(因为经过了求逆)。

控制面偏转方向约定(Deflection Convention)

从中立点可双向偏转的控制面包括:副翼(Ailerons)、升降副翼(Elevons)、V 尾(V-Tails)、A 尾(A-Tails)、方向舵(Rudder)。

为保证这些舵面在控制器正/负输入下始终按预期运动,需要一套与物理舵机安装方式无关的偏转方向定义:正输入产生正偏转。下图展示了正输入时的运动方向:

Control Surface Deflections 控制面偏转方向约定

总结而言,正输入导致:

  • 水平控制面:向上运动(包括副翼、升降副翼);
  • 垂直控制面:向右运动(包括方向舵);
  • 混合控制面:向上/向右运动(包括 V 尾、A 尾)。

::: tip 只能从中立点单向偏转的控制面包括:Airbrakes(减速板)、Spoiler(扰流板)、Flaps(襟翼)。对这些控制,正输入总是"从中立点偏转"(0:无效果,1:完全效果),与运动方向无关,且不响应负输入。 :::

Motor Tilt Servo Geometry:电机倾转舵机几何

VTOL 倾转旋翼机 通过倾转电机在悬停与前飞之间过渡。本节定义倾转舵机属性,并在电机几何中映射到具体电机。以下示例展示了 上文 tiltrotor 电机几何 对应的倾转舵机配置:

Tilt Servo Geometry Setup Example 倾转舵机几何配置示例

可设置的值:

  • Tilt servos:舵机(可倾转电机)数量。对应参数 CA_SV_TL_COUNT。
  • Angle at min tilt:最大倾转角(度,相对 z 轴)。对应参数 CA_SV_TL${i}_MINA。
  • Angle at max tilt:最小倾转角(度,相对 z 轴)。对应参数 CA_SV_TL${i}_MAXA。
  • Tilt direction:Towards front(正 x 方向)或 Towards right(正 y 方向)。对应参数 CA_SV_TL${i}_TD。
  • Use for control:倾转舵机是否用于偏航/俯仰控制,对应参数 CA_SV_TL${i}_CT:
    • None:不使用力矩控制;
    • Yaw:倾转舵机用于控制偏航;
    • Pitch:倾转舵机用于控制俯仰;
    • Both Yaw and Pitch:倾转舵机同时用于偏航与俯仰控制。

倾转舵机坐标系

倾转角的参考方向为正上方(0 度);朝车辆前方或右方倾转为正,朝后或左方为负:

Tilt Axis 倾转轴定义

Angle at min tilt 与 Angle at max tilt 表示倾转舵机的运动范围,min 是两个角中数值更小(非绝对值)的那个。若最大/最小倾转向量为 P₀、P₁(如上图),两角均为正且 θ₀ 更小,则:

  • Angle at min tilt = θ₀
  • Angle at max tilt = θ₁

::: info 若将图示镜像到 -x、-y 象限,两角均为负;因 θ₁ 比 θ₀ 更负(更小),此时 θ₁ 为 Angle at min tilt。同理,一个舵机:

  • 在竖直与前倾之间运动:min=0、max=90;
  • 绕竖直位置对称 ±45°:min=-45、max=45;
  • 在竖直与后倾之间运动:min=-90、max=0。 :::

Tilt direction 表示舵机在朝 Front(前)还是 Right(右)的平面内倾转,即图中的 α 只能取 0(前)或 90(右)。

用于偏航/俯仰控制的倾转舵机

倾转舵机可在一个或多个轴上提供力矩,用于偏航或俯仰:

  • 偏航常以这种方式控制,不过四电机及以上机型通常改用电机差动;
  • 俯仰更常见的是用电机差动推力控制,倾转舵机控制方式适用于无法差动推力的机型(如 Bicopter)。

是否启用该特性由 Use for control 设置决定。

Actuator Outputs:输出映射

Actuator Outputs 部分用于将电机、舵面舵机及其他执行机构分配给飞控的物理输出,并设置这些输出的参数:

Actuator Outputs - Multicopter diagram 多旋翼输出映射界面

连接的飞控支持的总线各自显示独立选项卡:PWM MAIN(I/O 板输出)、PWM AUX(FMU 板输出)、UAVCAN。电机与执行机构(即 "functions")可分配到任一总线的任意物理输出。

::: info 控制电机时 PWM AUX 输出优先于 PWM MAIN 输出(延迟更低)。 :::

PWM 输出按硬件定时器组分组,同一组内所有输出必须以相同协议、相同速率工作(如一组内所有输出均为 400Hz 的 PWM 信号)。因此不能在同一输出组内同时映射 Servo 与 Motor,因为它们通常工作在不同速率。

PWM AUX 选项卡中的 CAP 输出通常用作 相机拍摄/触发输入,但也可将 CAP 输出映射为其他功能,其他 AUX 输出也可用作相机拍摄/触发输入。

::: info 配置相机拍摄/触发输入后需要重启才能生效。 :::

应按电机/舵机的实际物理接线为输出分配功能,并使用下方 Actuator Testing 部分确定合适的输出参数值。完整流程见 Output Assignment and Configuration。

Output Functions:输出功能

输出功能用于将机架的"逻辑功能"(如 Motor 1、Landing gear)映射到物理输出(如 FMU 输出引脚 2),使同一引脚几乎可用于任何用途。部分功能仅适用于特定机架或输出类型。

功能包括:

  • Disabled:输出无分配功能。
  • Constant_Min:输出恒为最小值(-1)。
  • Constant_Max:输出恒为最大值(+1)。
  • Motor 1 ~ Motor 12:输出指定电机,仅显示机架允许的电机。
  • Servo 1 ~ Servo 8:舵机输出,其具体含义由机架进一步指定(如 "tilt servo"、"left aileron")。
  • Peripheral via Actuator Set 1 ~ Peripheral via Actuator Set 6:Generic Actuator Control with MAVLink。
  • Landing Gear:起落架输出。
  • Parachute:降落伞输出。正常使用时输出最小值,触发 failsafe 时输出最大值。
  • RC Roll / RC Pitch / RC Throttle / RC Yaw / RC Flaps:RC 直通输出(分别由 RC_MAP_ROLL、RC_MAP_PITCH、RC_MAP_THROTTLE、RC_MAP_YAW、RC_MAP_FLAPS 将 RC 通道映射到该输出)。
  • RC AUX1 ~ RC AUXn:用于 RC 直通触发的任意载荷。
  • Gimbal Roll / Gimbal Pitch / Gimbal Yaw:云台滚转/俯仰/偏航控制。
  • Gripper(PX4 v1.14+):机械爪开合控制。
  • Landing_Gear_Wheel(PX4 v1.14+):起落架机轮展开控制。

以下功能仅能用于 FMU 输出:

  • Camera_Trigger:相机触发输出,TRIG_MODE==0 时启用,通过 TRIG_* 参数配置。
  • Camera_Capture:图像拍摄通知输入,CAM_CAP_FBACK==0 时启用,通过 CAM_CAP_* 参数配置。
  • PPS_Input:每秒脉冲输入捕获,用于 GPS 同步,PPS_CAP_ENABLE==0 时启用。

::: info 这些功能在源码中定义于 src/lib/mixer_module/output_functions.yaml:Motor 从 101 起始共 12 个、Servo 从 201 起始共 15 个、Peripheral_via_Actuator_Set 从 301 起始共 6 个、Landing_Gear=400、Parachute=401、RC_* 402~406、RC_AUX 407 起始 6 个、Gimbal_* 420~422、Gripper=430、Landing_Gear_Wheel=440,以及仅存在于 FMU PWM 引脚的 Camera_Trigger(2000)、Camera_Capture(2032)、PPS_Input(2064)、RPM_Input(2070)。索引不可变更,否则会破坏既有配置。该列表在 PX4 v1.15 准确。 :::

Actuator Testing:执行机构测试

右下角的 Actuator Testing 部分提供滑杆,用于测试(并确定)执行机构与电机设置。每个在 Actuator Outputs 中定义的输出对应一个滑杆。以下为典型 VTOL Tiltrotor 机架的示例:

Actuator Testing Slider 执行机构测试滑杆

该部分有一个 Enable Sliders 开关,必须先打开才能使用滑杆。滑杆可使电机/舵机在完整行程范围内动作,并可"吸附"到 disarmed(解除武装)与 minimum(最小)位置。

::: info 打开 Enable sliders 开关后,在移动对应滑杆之前执行机构不会动作——这是防止开关开启后电机突然转动的安全特性。 :::

滑杆可用于验证以下内容:

  1. 执行机构(电机、舵面等)是否分配到预期输出;
  2. 在 disarmed PWM 输出值时电机不转动;
  3. 在 minimum PWM 输出值时电机刚好微转;
  4. 电机在预期方向产生正推力;
  5. 在 disarmed 输出值时舵面处于正确的空闲位置;
  6. 舵面按 Control Surface Convention 定义的方向运动;
  7. 在 disarmed 输出值时倾转舵机处于正确的空闲位置;
  8. 倾转舵机按 Tilt Servo Convention 定义的方向运动。

Output Assignment and Configuration:输出分配与配置

输出在 Actuator Outputs 中分配功能并配置,Actuator Testing 滑杆则常用于确定应输入的配置值:

多旋翼 PWM 电机分配(Identify & Assign Motors)

使用 Identify & Assign Motors 按钮可通过半自动流程将电机分配到 PWM 输出。

::: info 这是分配电机最简便的方式,但目前仅支持连接 PWM 输出的多旋翼车辆(UAVCAN 输出及其他机架类型不支持)。其他机架请按 Output Assignment (Manual) 操作。 :::

::: warning 分配输出或任何测试前,务必拆除电机螺旋桨。 :::

Identify motor button 识别电机按钮

点击按钮后 QGC 会向一个电机发送命令使其转动。要分配该电机,只需在屏幕上选择对应电机,QGC 随后转动下一个电机让你分配,依此类推。

操作步骤:

  1. 将电机几何配置为与机架电机一致;
  2. 选择要分配电机的 PWM 选项卡;
  3. 点击 Identify & Assign Motors 按钮;
  4. 一个电机开始转动(若转动太快来不及记录,可点击 Spin Motor Again 再次转动):
    • 在几何区域选择对应的电机: Screenshot showing how to identify/assign motors 电机识别进行中
  5. 分配完所有电机后,工具会写入正确的输出映射并退出。

手动输出分配(Output Assignment Manual)

::: warning 测试前务必拆除螺旋桨。 :::

电机与舵机的执行机构输出均可在 Actuator Testing 部分用滑杆手动分配。

分配执行机构的步骤:

  1. 先在 Actuator Outputs 部分将你认为可能正确的功能分配到输出;
  2. 打开 Actuator Testing 部分的 Enable sliders 开关;
  3. 移动要测试的执行机构滑杆:
    • 电机应移到最小推力位置;
    • 舵机应移到中间位置附近;
  4. 观察车辆上哪个执行机构动了,应与几何配置中的位置一致(airframe reference 展示了多种标准机架的电机位置):
    • 若正确,则进入下一步;
    • 若错误,则交换输出分配;
    • 若没有动作,将滑杆提到范围中段再提高。仍无动作则可能是输出未连接、电机未上电或输出配置错误,需要排查(可尝试其他执行机构输出看是否有动作);
  5. 将滑杆回到 "disarmed" 位置(电机滑杆底部、舵机滑杆中间);
  6. 对所有执行机构重复上述步骤。

Motor Configuration:电机配置

::: info 使用 PWM 或 OneShot ESC 时,应首先执行 ESC 校准(该主题也涵盖 PWM 电机特有配置)。DShot ESC 无需配置指令限值,只需设置旋转方向。 :::

::: warning 拆除螺旋桨! :::

电机配置的目标是设置输出值,使电机:

  • disarmed 时不转(disarmed PWM 输出值);
  • 在 minimum PWM 输出值下刚好、可靠地启动;
  • maximum PWM 输出值取能让电机以最高转速旋转的最低值;
  • 在预期方向产生正推力。

每个电机按以下步骤配置:

  1. 将电机滑杆拉到最底部(吸附到底部),此时输出为 disarmed 值:
    • 验证电机不转;
    • 若电机转动,在 Actuator Outputs 中把对应 PWM disarmed 值降到低于"仍会转动"的水平。
  2. 缓慢上移滑杆直到吸附到 minimum 位置,此时输出为 minimum 值:
    • 验证电机在此位置缓慢转动;

    • 若电机不转或转太快,在 Actuator Outputs 中调整对应 PWM minimum 值,使电机刚好微转:

      PWM Minimum Output 最小 PWM 输出调整 ::: info 对于 DShot 输出,此步不需要。 :::

  3. 将滑杆提升到足以验证电机旋转方向正确、在预期方向产生正推力的水平:
    • 预期推力方向因机型而异:多旋翼推力始终向上,固定翼推力推动机体向前;
    • VTOL 在 Tilt Servo Convention 定义的倾转舵机 0 度时推力应向上(Tilt Servo 测试见后文);
    • 若推力方向错误,可能需要 反转电机。
  4. 将滑杆提到最大值使电机高速旋转:把 PWM 输出 maximum 值从默认值开始降低,以 25µs 小步长增大值并聆听电机音调,"最优" maximum 值为最后一次听到音调变化时的值。

Control Surface Setup:舵面设置

首先为每组输出设置舵机_帧率_(frame rate),通常设为舵机支持的最大值。以下示例设为 PWM50(最常见):

Control Surface Disarmed 1500 Setting 舵面 disarmed 1500 设置

::: info 几乎肯定需要把脉冲率从默认的 400Hz 改低,因为 400Hz 支持很少见(若不支持,舵机通常会发出"奇怪"的噪音)。PWM 舵机使用 PWM50 常见得多;若确实需要高速舵机,DShot 是更好的选择。 :::

PWM:围绕中立点双向运动的舵面

为便于设置舵机中立点,可为每个舵机定义双线性曲线函数,参数为 PWM_MAIN_CENTx / PWM_AUX_CENTx,允许正负方向非对称偏转:

Asymmetric Servo Deflections 非对称舵面偏转

设置步骤:

  1. 将所有舵面的 Trim 设为 0.00:

    PWM Trimming 舵面 Trim 置零

  2. 设置 PWM_MAIN_CENTx / PWM_AUX_CENTx,使舵面保持中立(与翼型对齐)位置,PWM 舵机通常约为 1500(舵机行程中心附近):

    Control Surface Trimming 舵面中立点设置

  3. 逐步增大每个舵机的 Maximum,直到达到期望偏转量。可在将 COM_PREARM_MODE 设为 Always 后使用遥控手动模式检查偏转,或使用滑杆;

  4. 逐步减小每个舵机的 Minimum,直到达到期望偏转量;

  5. 设置 Disarmed 值为期望值,通常希望与 Center 值相同。

::: info 若希望在设置 Center 后保留舵机的线性行为,请调整 Minimum 或 Maximum,使两个区间(min→cent 与 cent→max)等大:

Linear PWM Adjustment 线性 PWM 调整 :::

非 PWM:围绕中立点双向运动的舵面

可围绕中立点双向运动的舵面包括:副翼、升降副翼、V 尾、A 尾、方向舵。

设置步骤:

  1. 将所有 PWM_MAIN_CENTx 与 PWM_AUX_CENTx 设为默认(-1),否则无法进行 trim;

  2. 设置 Disarmed 值,使舵面在解除武装时保持中立位置,PWM 舵机通常约为 1500:

    Control Surface Aileron Setup 副翼 Disarmed 设置

  3. 向上移动该舵面的滑杆(正指令),验证其按 Control Surface Convention 定义的方向运动:

    • 副翼、升降副翼、V 尾、A 尾等水平舵面应向上运动;
    • 方向舵等"纯垂直"舵面应向右运动。

    ::: tip 滑杆运动必须与舵面约定一致,以归一化不同舵机安装方式(向上移动滑杆可能实际降低输出值)。若舵面反向运动,勾选 Rev Range 复选框反转范围。 :::

  4. 再次把滑杆移到中间,检查舵面是否与机翼中立位置对齐:

    • 若未对齐,可设置该舵面的 Trim 值。

    ::: info 在 Geometry 面板的 Trim 设置中完成,通常靠"试错":

    Control Surface Trimming 舵面 Trim 调整 :::

    • 设置 trim 后,将滑杆移离中心再释放回 disarmed(中间)位置,确认舵面处于中立位置。

::: tip 若任一舵机的 PWM_MAIN_CENTx 或 PWM_AUX_CENTx 未设为默认(-1),系统会自动移除所有舵面的 Trim,以避免新旧 trim 工具混用。 :::

::: info 不用滑杆的另一种测试方式:将 COM_PREARM_MODE 参数设为 Always:

  • 即使车辆解除武装也可控制舵机,并持续对舵面施加 Trim 设置;
  • 可尝试不同的 Trim 值检查对齐情况,直到满意。 :::

从中立点运动到完全偏转的舵面

仅从中立点单向运动的舵面包括:减速板(airbrakes)、扰流板(spoilers)、襟翼(flaps)。

对这些控制,应根据控制的完整范围设置最小与最大 PWM 值。Disarmed 值应匹配对应控制处于"中立"位置的值(最大或最小)。对襟翼而言,中立即完全收起、与机翼齐平。

一种设置方法:

  1. 将所有 PWM_MAIN_CENTx 与 PWM_AUX_CENTx 设为默认(-1),否则无法 trim;
  2. 将 Disarmed 设为 1500、Min 设为 1200、Max 设为 1700,使各值位于舵机行程中心附近;
  3. 向上移动对应滑杆,确认控制面运动且为伸出方向(远离 disarmed 位置);若不是,勾选 Rev Range 反转范围;
  4. 将滑杆停在 disarmed 位置,改变 Disarmed 信号值直到控制面收起/与机翼齐平。可能需要增大或减小 Disarmed 值:
    • 若向 Min 方向减小,则将 Min 设为与 Disarmed 相同;
    • 若向 Max 方向增大,则将 Max 设为与 Disarmed 相同;
  5. 未与 Disarmed 匹配的那个值控制舵面最大伸出量:将滑杆移到顶部,改变该值(Max 或 Min)使滑杆在顶部时舵面完全伸出;
  6. (仅 PWM 舵机)将 Center 设为 Min 与 Max 的中间值。

::: info 襟翼特别说明 某些机型两个襟翼由单个输出控制,此时需确保两个襟翼都随滑杆上移而伸出/展开。若只有一个正常展开,需用第三方舵机编程器改变另一舵机方向;或者将该舵机移到独立输出通道,用 Rev range 复选框反转其方向。 :::

Tilt Servo Setup:倾转舵机设置

首先为每组输出设置舵机帧率,通常设为舵机支持的最大值,以下为 PWM50(最常见值),与舵面设置相同:

Tilt Servo Setup 倾转舵机设置

对每个倾转舵机:

  1. 设置 Disarmed 值(PWM 舵机如 1000 或 2000),使舵机在解除武装时指向预期方向;

  2. 将滑杆置于最低位置,验证正值增加时指向 Angle at Min Tilt(Geometry 中定义):

    Tilt Servo Geometry Setup 倾转舵机几何配置

  3. 将滑杆置于最高位置,验证正电机推力指向 Angle at Max Tilt(Geometry 中定义)。

其他说明

  • 若使用安全按钮,必须先按下才能进行执行机构测试;

  • kill-switch 仍可立即停止电机;

  • 舵机在对应滑杆被移动之前不会实际动作;

  • 在 shell 中也可使用 actuator_test 进行执行机构测试(其实现位于 src/lib/mixer_module/actuator_test.cpp,会解析 actuator_test_s 消息中的功能分配并在 Motor/Servo 输出上执行测试指令);

  • VTOL 在固定翼飞行时会自动关闭朝上的电机:

    • Standard VTOL:定义为多旋翼电机的电机关闭;
    • Tiltrotor:无关联倾转舵机的电机关闭;
    • Tailsitter:固定翼飞行时不会关闭任何电机;
  • 从舵面 trim 迁移到 PWM trim 的换算公式:

    PWM_MAIN_CENTx = ((PWM_MAX - PWM_MIN) / 2) * CA_SV_CSx_TRIM + PWM_MIN + ((PWM_MAX - PWM_MIN) / 2)
    

Reversing Motors:反转电机

电机必须按几何配置中定义的方向旋转("Direction CCW"复选框)。若电机转向错误必须反转,可选方案:

  • 若 ESC 配置为 DShot,可在 UI 中永久反转方向:Actuator 滑杆下方会显示 Set Spin Direction 按钮(使用 DShot 电机时),点击后弹出对话框选择要设置方向的电机:

    Set spin direction buttons DShot 反转方向按钮

    注意当前方向无法查询,可能需要两种选项都试一遍。

  • 交换 3 根电机线中的任意 2 根。

    ::: info 若电机未使用子弹头连接器,则需要重新焊接(这也是优先选用 DShot ESC 的原因之一)。 :::

小结:一套完整的执行机构调校流程

综合以上各节,一次完整的执行机构配置与测试可归纳为:① 在 airframe 配置 选定机架后,于 Geometry 面板设置电机/控制面/倾转舵机的数量、位置与方向属性;② 在 Actuator Outputs 面板按物理接线把逻辑功能映射到 PWM MAIN / PWM AUX / UAVCAN 输出(多旋翼可借助 Identify & Assign Motors 半自动完成);③ 在 Actuator Testing 面板启用滑杆,逐项验证电机 disarmed/min/max 三段输出、正推力方向与正反转,按 Control Surface Convention](#control-surface-deflection-convention) 与 Tilt Servo Convention 核对舵面与倾转方向,并依据机型选择 PWM 中心点(PWM_MAIN_CENTx/PWM_AUX_CENTx)或 Trim(CA_SV_CS${i}_TRIM)完成中立点与行程标定。所有 UI 字段均可在 [control_allocator 参数定义(CA_ROTOR*、CA_SV_CS*、CA_SV_TL*)与 output_functions.yaml 中找到对应的底层参数与枚举,便于脚本化配置与排障。

登录后查看全文
PX4-Autopilot