INAV ESC 与舵机输出完全指南:协议选择、更新频率与输出映射配置
INAV ESC 与舵机输出完全指南:协议选择、更新频率与输出映射配置
本篇技术指南以 INAV 官方文档 docs/ESC and servo outputs.md 为核心,系统讲解 INAV 支持的 ESC 协议(从标准 PWM 到 DSHOT600)、舵机输出频率的设置方法,以及 INAV 7 引入的 timer_output_mode 输出映射机制。读完本文,你将掌握如何为多旋翼与固定翼在 Configurator 和 CLI 中正确配置电机/舵机输出,并理解定时器共享对输出布局的根本约束。
ESC 协议支持一览
INAV 目前支持的 ESC 协议如下,覆盖从传统 PWM 到数字 DSHOT 的全部主流方案:
| 协议 | 类型 | 典型更新率 | 说明 |
|---|---|---|---|
| 标准 PWM(STANDARD) | 模拟脉宽 | 50–400 Hz | 兼容性最好,最通用的传统协议 |
| OneShot125 | 模拟脉宽 | 约 1 kHz(125 µs 帧) | 缩短帧周期、降低延迟的过渡方案 |
| OneShot42 | 模拟脉宽 | 更高帧率 | OneShot 家族的更快变体 |
| Multishot | 模拟脉宽 | 2–4 kHz | 在模拟协议中延迟最低 |
| Brushed 电机(BRUSHED) | 模拟脉宽 | 最高 32 kHz | 用于有刷电机的直驱输出 |
| DSHOT150 / DSHOT300 / DSHOT600 | 数字位流 | 150 / 300 / 600 kbaud | 数字信号,带 CRC 校验与遥测能力 |
协议枚举的完整定义可在 src/main/drivers/pwm_mapping.h#L42-L54 中看到:PWM_TYPE_STANDARD、PWM_TYPE_ONESHOT125、PWM_TYPE_MULTISHOT、PWM_TYPE_BRUSHED、PWM_TYPE_DSHOT150、PWM_TYPE_DSHOT300、PWM_TYPE_DSHOT600,以及附加在末尾的 PWM_TYPE_SRXL2。其中 DSHOT 系列在 src/main/drivers/pwm_mapping.c#L66-L79 的 motorProtocolProperties[] 表中被标记为 isDSHOT = true,而 SRXL2 被标记为 usesHwTimer = false——因为它走的是串口(UART)而不是定时器波形,这正是原文档最后一部分“不从输出引脚驱动的 ESC”的源码依据。
协议的选择方式
ESC 协议通过 Configurator 选择即可,无需任何特殊配置。对应到 CLI 与参数层面,这一选择由 motor_pwm_protocol 参数承载,定义于 src/main/fc/settings.yaml#L29-L30:
- name: motor_pwm_protocol
values: ["STANDARD", "ONESHOT125", "MULTISHOT", "BRUSHED", "DSHOT150", "DSHOT300", "DSHOT600", "SRXL2"]
其参数描述(settings.yaml#L875-L879)明确说明:该参数决定“用于向 ESC 发送电机更新所采用的协议”,默认值为 ONESHOT125。也就是说,全新刷写后 INAV 默认以 OneShot125 协议输出,Configurator 中切换协议实际就是在改写这个参数。
电机 PWM 频率参数
对于有刷电机,motor_pwm_rate 单独控制输出频率,定义于 settings.yaml#L869-L874:
- name: motor_pwm_rate
description: "Output frequency (in Hz) for motor pins. Applies only to brushed motors. "
default_value: 16000
min: 50
max: 32000
注意该参数仅适用于有刷电机,默认 16 kHz,可调范围 50–32000 Hz。无刷 ESC 的更新率则由所选协议自身决定(OneShot125/Multishot 由协议帧率决定,DSHOT 由波特率决定)。
舵机输出频率与 servo_pwm_rate
舵机输出与电机输出走完全不同的配置路径。默认情况下,INAV 使用 50Hz 的舵机更新率。如果你希望提高更新率,必须先确认舵机硬件支持——只有高端数字舵机才能可靠地工作在 200Hz 及以上,普通模拟舵机强行使用高更新率会过热甚至损坏。
对应参数为 servo_pwm_rate,定义于 settings.yaml#L1442-L1447:
- name: servo_pwm_rate
description: "Output frequency (in Hz) servo pins. When using tricopters or gimbal with digital servo, this rate can be increased. Max of 498Hz (for 500Hz pwm period), and min of 50Hz. Most digital servos will support for example 330Hz."
default_value: 50
min: 50
max: 498
从源码注释可以看到几个关键数值约束:
- 最小值 50Hz,即传统模拟舵机的标准更新率;
- 最大值 498Hz,对应 500Hz 的 PWM 周期(500 Hz 周期下保留信号边沿余量);
- 常见数字舵机的实用档位如 330Hz;
- 适用场景:三旋翼(tricopter)或云台(gimbal)配合数字舵机时提高此值。
需要强调的是,舵机协议本身也支持 PWM、SBUS 与 SBUS_PWM 三种类型(见 settings.yaml#L38-L39 与 pwm_mapping.h#L56-L60 的 servoProtocolType_e),此处讨论的 50Hz 更新率对应的是 PWM 类型输出。
舵机输出映射的硬件限制
并非飞控上的所有输出引脚都能用作舵机输出,这属于硬件层面的限制,因此在配线之前务必查阅对应飞控板的文档(docs/boards 目录下收录了各目标板的硬件说明)。
这里有几个实践要点:
- 电机输出通常是按顺序排列的(Motor 1、2、3…),但舵机输出没有任何标准的布局——不同板卡的舵机引脚位置差异很大;
- 有些板卡在多旋翼(Multirotor)配置下完全不支持舵机输出;
- 同一颗定时器(timer)可以被多个输出共享,但共享同一定时器的两个输出必须承担相同的功能(同为电机或同为舵机),这是决定输出布局的最核心约束。
从源码层面看,INAV 对输出数量与初始化的约束集中在 src/main/drivers/pwm_mapping.h:MAX_MOTORS 最大为 12(pwm_mapping.h#L29-L32)、MAX_SERVOS 为 18(pwm_mapping.h#L34)。当配置超过硬件承载能力时,PWM 初始化会返回明确的错误码,对应的错误消息定义在 src/main/drivers/pwm_mapping.c#L57-L64:
"No error"
"Mixer defines too many motors"
"Mixer defines too many servos"
"Not enough motor outputs/timers"
"Not enough servo outputs/timers"
"Output timer init failed"
也就是说,如果你的 Mixer 定义了 13 个电机,或需要的舵机数超过可用定时器通道数,系统会在启动阶段给出“Mixer defines too many motors”或“Not enough servo outputs/timers”之类的明确报错——这正是“输出受限于定时器资源”这一硬件事实的固件体现。
修改输出映射:Configurator 与 timer_output_mode
INAV 7 引入了新功能,允许你强制指定某些输出为 MOTORS 或 SERVOS,但仍受硬件限制约束——尤其是定时器共享规则:共享同一定时器的输出必须同为电机或同为舵机。
方式一:Configurator 的 Mixer 选项卡(推荐)
修改输出映射最简单的方式是使用 Configurator 中的 Mixer 选项卡。它会把每个输出所使用的定时器清晰展示出来,让你一眼看出哪些输出共享同一个定时器、从而不能混用功能。
方式二:CLI 命令 timer_output_mode
你也可以在 CLI 中使用 timer_output_mode 命令完成同样的配置。该命令在 src/main/fc/cli.c#L5171 注册,用法为:
timer_output_mode [<timer> [<AUTO|MOTORS|SERVOS|LED|PINIO|BEEPER>]]
命令解析如下:
| 参数 | 含义 |
|---|---|
timer |
定时器序号(从 0 开始,必须小于 HARDWARE_TIMER_DEFINITION_COUNT) |
AUTO |
自动模式,由固件根据 Mixer 自动判定该定时器的用途 |
MOTORS |
强制该定时器上的输出作为电机输出 |
SERVOS |
强制该定时器上的输出作为舵机输出 |
LED |
用于 LED 灯带(WS2811 等)输出 |
PINIO |
用于 PINIO 通用 IO 控制 |
BEEPER |
用于蜂鸣器输出 |
其实现逻辑位于 cli.c#L3209-L3271:
- 不带任何参数时,打印所有定时器的当前输出模式(调用
printTimerOutputModes); - 只给定时器序号、不给模式时,同样只打印(输出会被过滤到该定时器);
- 同时给出定时器与模式时,写入
timerOverridesMutable(timer)->outputMode = mode并打印更新结果; - 参数解析使用大小写不敏感的比较(
sl_strcasecmp),因此motors、Motors与MOTORS等价; - 定时器序号越界或模式不合法时输出解析错误(
cliShowParseError)。
在实际应用时,你需要先把输出改成需要的模式,再保存(save)并重启。接线后可用 CLI 验证:输入 timer_output_mode 即可看到每个定时器当前归属的功能。
源码视角:输出如何被分配
输出的最终分配逻辑在 src/main/drivers/pwm_mapping.c 中实现。分配电机与舵机时,固件会先处理显式指定(dedicated)模式的定时器,再处理 AUTO 模式的定时器——见 pwm_mapping.c#L386-L398:
// Motors: dedicated (OUTPUT_MODE_MOTORS) first, then auto
// Servos: dedicated (OUTPUT_MODE_SERVOS) first, then auto
这意味着:被强制指定为 MOTORS 的定时器优先保证分配给电机,被强制指定为 SERVOS 的优先分配给舵机,剩下的 AUTO 定时器再按 Mixer 需求自动填充。此外,OUTPUT_MODE_BEEPER 与 OUTPUT_MODE_LED 的定时器还会在分配时被“认领”(见 pwm_mapping.c#L356-L361),避免被电机/舵机占用。
不从输出引脚驱动的 ESC:Spektrum Smart ESC(SRXL2)
以上所有输出映射规则只适用于由定时器波形驱动的电机/舵机输出。有一类例外:Spektrum Smart ESC 连接到 UART 而非电机输出引脚,因为它的协议是串行协议而非定时器波形——前文提到的 PWM_TYPE_SRXL2 在 motorProtocolProperties<a href="https://link.gitcode.com/i/e348313322382770e981a933eb43355c" target="_blank">] 表中 usesHwTimer = false,正是这一特性的源码注释([pwm_mapping.c#L74-L78):
/* Not a timer waveform at all: the ESC hangs off a UART. The entry has to be
* here even on a target built without the protocol, because the value is
* stored in configuration and a diff restored from a board that does have it
* would otherwise index past the end of this array. */
因此,前面讲到的所有输出映射手段(timer_output_mode、Mixer 选项卡等)对 Spektrum Smart ESC 完全不适用。相关的完整配置说明请参阅仓库文档 docs/Spektrum Smart ESC.md。
在参数层面,SRXL2 协议还伴随三个专属参数(settings.yaml#L880-L893):
esc_srxl2_telemetry(默认 ON):从 SRXL2 链路读取 ESC 遥测,仅当motor_pwm_protocol = SRXL2时生效;esc_srxl2_telemetry_rate(默认 1HZ,可选 1HZ/2HZ/3HZ):遥测上报频率,需按 ESC 实际能力选择,过快可能让 Avian 等 ESC 停止响应油门,过慢会让链路超时;esc_srxl2_reverse_channel:Spektrum 智能 ESC 的反转(Thrust Rev.)辅助通道,1 基编号(5–9,默认 7),0 表示禁用反转。
总结与检查清单
围绕 ESC 与舵机输出,配置完成后建议按以下清单核对:
- 协议匹配:确认
motor_pwm_protocol与你的 ESC 实际支持的协议一致;标准 PWM 适合老式 ESC,OneShot125 是 INAV 默认值,Multishot/DSHOT 用于追求低延迟的数字/高速场景,DSHOT 还可解锁遥测能力; - 有刷电机频率:使用有刷电机时确认
motor_pwm_rate处于 50–32000 Hz 的合适档位(默认 16000 Hz); - 舵机更新率:
servo_pwm_rate默认 50 Hz,仅在舵机明确支持的前提下提升(如数字舵机常用 200–330 Hz,上限 498 Hz),模拟舵机务必保持低频率; - 输出映射:优先用 Configurator Mixer 选项卡核对定时器分配,避免把共享同一定时器的输出混用为电机与舵机;CLI 下用
timer_output_mode可查看与强制指定MOTORS/SERVOS/LED/PINIO/BEEPER; - 串行协议例外:Spektrum Smart ESC(SRXL2)走 UART,不占用电机输出引脚,也不受输出映射规则约束,请参照 docs/Spektrum Smart ESC.md 单独配置。
掌握以上要点,你就可以根据手中的 ESC、舵机型号与飞控板布局,在 INAV 中安全、精确地完成全部输出通道的配置。