Airmode: руководство по настройке и устранению проблем

Что такое Airmode

Airmode — это не отдельный режим полёта, а функция, которая позволяет системе стабилизации (PID-контроллерам) работать даже при нулевом газе.

Обычно, когда вы опускаете стик газа в ноль, контроллер отключает или ограничивает работу регуляторов, чтобы моторы не реагировали на микро-движения. Airmode меняет это поведение: полный контроль ориентацией сохраняется даже в свободном падении (Oscar Liang).

Зачем это нужно:

Выполнение акробатических элементов (флипы, роллы) с нулевым газом
Плавный вход и выход из манёвров без потери контроля
Более точная траектория в фристейле и гонках
Предотвращение «падения в штопор» при резком сбросе газа

Airmode позволяет квадрокоптеру максимизировать тягу для контроля углового положения независимо от ввода газа пилотом (Oscar Liang).

Проблема: моторы сами набирают обороты

Ситуация

После арминга и небольшого газа моторы начинают сами набирать скорость. Это распространённая проблема, связанная с Airmode.

Причина: I-Term Windup (Накопление интеграла)

Когда дрон стоит на земле в наклонённом положении с заармленными моторами:

PID-контроллер видит ошибку ориентации
Пытается выровнять дрон, добавляя газ на моторы
Так как дрон зафиксирован, ошибка не исчезает
I-терм (интегральная составляющая) накапливается
При добавлении газа накопленный «долг» резко подаётся на моторы
Моторы взвинчивают обороты

⚠️ Важное замечание

Airmode переопределяет функцию Motor Stop — моторы не останавливаются полностью при нулевом газе (Betaflight Modes).

Airmode в Betaflight

Как работает

В стандартном микшере, когда roll, pitch и yaw насыщают мотор, все моторы уменьшаются одинаково. Когда мотор опускается ниже минимума, он обрезается. Если бы у вас был газ чуть выше минимума и вы попытались сделать быстрый ролл — так как два мотора не могут опуститься ниже, вы получаете половину мощности (Betaflight Modes).

Airmode решает эту проблему:

Включает полную коррекцию PID при нулевом газе
Даёт возможность плавного планирования и акробатики на нулевой тяге
Повороты становятся более резкими, так как всегда выполняется максимально возможная коррекция (Betaflight Modes)

Ключевые особенности Betaflight

Параметр	Описание
I-Term при нулевом газе	Полностью активен (Betaflight Modes)
Защита на земле	При нулевом газе (ниже `min_check`) и центрированных стиках roll/pitch есть базовая защита от раскрутки моторов (Betaflight Modes)
Сброс I-term	При 70% отклонения стика в Acro режиме I-term сбрасывается для предотвращения быстрых windup при завершении флипов и роллов (Betaflight Modes)

Настройка в Betaflight

1. Включение Airmode

Есть два способа:

Способ A: Постоянное включение

Вкладка Configuration → включите AIRMODE как feature (Oscar Liang — Modes)

Способ B: Через переключатель

Вкладка Modes → назначьте переключатель на AIRMODE (ID 28) (Betaflight Modes)

2. Параметр `airmode_start_throttle_percent`

Этот параметр определяет порог газа, с которого начинается полноценная работа Airmode (Oscar Liang):

# В CLI:
set airmode_start_throttle_percent = 15

Зачем это нужно:

На мощных сборках дрон может вести себя непредсказуемо при взлёте с включенным Airmode
Установка значения около hover throttle (например, 20%) обеспечивает стабильный взлёт (Oscar Liang)
Для гоночных дронов можно установить 10-15% для удержания угла на стартовом блоке без взлёта (Oscar Liang)

3. I-Term Relax

Защита от накопления интеграла на земле (включено по умолчанию в современных версиях) (Betaflight I-Term Relax):

# Проверка в CLI:
get iterm_relax
get iterm_relax_cutoff

Рекомендации:

Для фристайла: iterm_relax_cutoff = 15 (по умолчанию)
Для гонок: iterm_relax_cutoff = 20-30 для более быстрой реакции (Betaflight I-Term Relax)

⚠️ Нюансы Betaflight

Motor Stop + Airmode: Airmode переопределяет Motor Stop (Betaflight Modes)
Безопасность: Современные версии включают защиту — Airmode активируется только если:

Газ > min_check более 1 секунды
Стики roll/pitch не в центре (Betaflight Modes)

Вибрации: На земле при нулевом газе стабилизация может быть ограничена для предотвращения «прыжков» от вибраций

🔹 Airmode в ArduPilot

Как работает

В ArduPilot Airmode — это опция внутри режимов ACRO и STABILIZE, а не отдельная функция (ArduPilot Copter Airmode).

Активация в ArduPilot

Способ 1: Через арминг (рекомендуемый)

Используйте переключатель с RCx_OPTION = 154 (ARM/DISARM с Airmode):

Если арминг выполняется через этот переключатель, стабилизация при холостом газе остаётся полностью активной (ArduPilot Copter Airmode)

Важно: Если использовать RCx_OPTION = 153 (обычный ARM/DISARM), Airmode не активируется (ArduPilot Copter Airmode)

Способ 2: Отдельный переключатель

Назначьте канал на RCx_OPTION = 84 для ручного включения/выключения Airmode в режимах ACRO и STABILIZE (ArduPilot Auxiliary Functions)

Способ 3: Постоянное включение в ACRO

Установите бит 0 параметра ACRO_OPTIONS = 1 для постоянного включения Airmode в режиме ACRO (если не переопределено переключателем) (ArduPilot Copter Airmode)

⚠️ Нюансы ArduPilot

Ручной арминг стиками: Если используется rudder-arming (ARMING_RUDDER = 2), Airmode не активируется, даже если опция включена (ArduPilot Copter Airmode)
Защита на земле:

Предотвращает движение от вибраций на земле при холостом газе
В полёте позволяет стабилизацию для акробатики и быстрого снижения (ArduPilot Copter Airmode)

Traditional Helicopter: Airmode не влияет на традиционные вертолёты (ArduPilot Copter Airmode)
QACRO/QSTABILIZE (QuadPlane): Если Airmode включён переключателем при разармленном состоянии и вы армитесь через rudder, аппарат сразу попытается повернуть вправо, ещё находясь на земле (ArduPilot Plane Airmode)

🔹 Сравнение реализаций

Аспект	Betaflight	ArduPilot
Целевое применение	Фристайл, гонки, акробатика (Oscar Liang)	Автономные миссии, съёмка, доставка (ArduPilot Copter Airmode)
Активация	Отдельная функция или режим через Modes tab (Oscar Liang — Modes)	Привязана к способу арминга (`RCx_OPTION = 154`) или параметрам режима (ArduPilot Copter Airmode)
Работа с газом	Полная работа PID при 0 газе (Betaflight Modes)	Стабилизация при холостом газе с защитой от вибраций на земле (ArduPilot Copter Airmode)
I-Term защита	`I-Term Relax`, `airmode_start_throttle_percent` (Betaflight I-Term Relax)	Встроенная логика: не активируется, если дрон на земле и стики в центре (ArduPilot Copter Airmode)
Гибкость	Высокая (CLI, множество параметров) (Betaflight CLI)	Умеренная (через параметры и режимы) (ArduPilot Auxiliary Functions)
Motor Stop	Airmode переопределяет Motor Stop (Betaflight Modes)	Не применимо (другая логика работы моторов)
Влияние на режимы	Только в ручных режимах (Acro) (Betaflight Modes)	Работает в ACRO и STABILIZE, не влияет на традиционные вертолёты (ArduPilot Copter Airmode)

🔹 Настройка и безопасность

✅ Чек-лист для Betaflight

1. Проверка Receiver

Зайдите во вкладку Receiver и убедитесь:

При стике газа внизу значение = 1000 (или близко)
Значение не «плавает» (1010-1020 без касания)

Если плавает → откалибруйте стики на пульте

2. Настройка Modes

Вкладка Modes (Betaflight Modes):

Убедитесь, что на переключателе не висит Angle/Horizon (летайте в Acro)
Назначьте Airmode на отдельный переключатель (рекомендуется для новичков)

3. CLI настройки

# Проверка текущих настроек
get airmode
get airmode_start_throttle_percent
get iterm_relax
get min_check

# Рекомендуемые настройки для мощных сборок
set airmode_start_throttle_percent = 15
set iterm_relax = ON
set iterm_relax_cutoff = 15

4. Motor Stop

Вкладка Motors:

Конфигурация	Поведение
Airmode OFF + Motor Stop ON	Моторы не крутятся до поднятия газа
Airmode OFF + Motor Stop OFF	Моторы крутятся на холостых при арме
Airmode ON	Motor Stop игнорируется — моторы всегда на холостых (Betaflight Modes)

✅ Чек-лист для ArduPilot

1. Настройка параметров (Mission Planner/MAVProxy)

# Вариант A: ARM + Airmode на одном переключателе
RCx_OPTION = 154  # ARM/DISARM с Airmode

# Вариант B: Отдельное управление Airmode
RCx_OPTION = 84   # Только Airmode

# Вариант C: Постоянный Airmode в ACRO
ACRO_OPTIONS = 1  # Бит 0 = 1

2. Проверка арминга

Не используйте rudder-arming с Airmode — он не активируется (ArduPilot Copter Airmode)
Используйте переключатель с RCx_OPTION = 154

3. Тестирование

Проверьте поведение на малой высоте
Убедитесь, что на земле при нулевом газе дрон не пытается выровняться

🔹 Практические рекомендации

🎯 Для пользователей Betaflight

Новичкам:

Не включайте Airmode постоянно — используйте переключатель (Oscar Liang)
Взлетайте без Airmode, включайте его в воздухе для трюков
Установите airmode_start_throttle_percent = 15 для защиты на земле (Oscar Liang)
Никогда не держите дрон в наклоне на земле с заармленными моторами

Опытным пилотам:

Можно включить Airmode постоянно через Configuration tab (Oscar Liang — Modes)
Для гонок: настройте iterm_relax_cutoff = 20-30 для быстрой реакции (Betaflight I-Term Relax)
Для фристайла: оставьте iterm_relax_cutoff = 15 (по умолчанию) (Betaflight I-Term Relax)
Проверьте PID — с Airmode может потребоваться небольшое снижение значений (Oscar Liang)

Если моторы раскручиваются на земле:

# 1. Установите порог включения Airmode
set airmode_start_throttle_percent = 15

# 2. Проверьте I-Term Relax
get iterm_relax
# Должно быть: iterm_relax = ON

# 3. Проверьте min_check
get min_check
# По умолчанию: 1050

# 4. Если проблема остаётся — отключите Airmode на земле
# Используйте переключатель вместо постоянного включения

🎯 Для пользователей ArduPilot

Безопасная настройка:

Назначьте ARM/DISARM на переключатель с RCx_OPTION = 154 (ArduPilot Copter Airmode)
Не используйте rudder-arming с Airmode
Для дополнительного контроля: назначьте RCx_OPTION = 84 на отдельный переключатель (ArduPilot Auxiliary Functions)

Для QuadPlane:

Если используете ARMING_RUDDER = 2, помните: в Airmode нельзя disarm через rudder (ArduPilot Plane Airmode)
Warning: Если Airmode включён при disarm и вы армитесь через rudder, аппарат попытается повернуть вправо на земле (ArduPilot Plane Airmode)

🔹 Ответ на вопрос: «Работает ли Airmode при газе ниже минимума?»

Короткий ответ: Зависит от ситуации

1. Если «минимум» = остановка моторов (`MOTOR_STOP`)

Airmode НЕ работает, так как моторы остановлены
Airmode начнёт работать только когда газ поднимется выше порога запуска моторов (Betaflight Modes)

2. Если «минимум» = холостые обороты (Idle)

В воздухе:

✅ Airmode работает даже при полностью сброшенном газе
Это его основная задача — контроль на нулевой тяге (Oscar Liang)

На земле:

⚠️ Ограниченная работа через параметр airmode_start_throttle_percent
Если газ ниже этого процента (например, <15%), логика Airmode приглушается для защиты от I-term windup (Oscar Liang)

3. Порог `min_check`

Обычно min_check = 1050 мкс
Если стик газа ниже этого значения, FC считает, что вы не готовы к полёту
При газе ниже min_check некоторые функции могут быть ограничены

🔹 Troubleshooting

❓ Проблема: Моторы сами раскручиваются на земле

Причина: I-term windup из-за наклона дрона

Решение:

# Betaflight:
set airmode_start_throttle_percent = 15
set iterm_relax = ON

# Или используйте переключатель Airmode вместо постоянного включения

❓ Проблема: Дрон «прыгает» на земле

Причина: Вибрации гироскопа + активный Airmode

Решение:

Проверьте крепление FC (soft-mount)
Настройте фильтры гироскопа
Увеличьте airmode_start_throttle_percent

❓ Проблема: Не могу disarm в Airmode

Причина: В ArduPilot при ARMING_RUDDER = 2 и включенном Airmode rudder- disarm блокируется (ArduPilot Copter Airmode)

Решение:

Используйте переключатель ARM/DISARM (RCx_OPTION = 154)
Или отключите Airmode перед disarm

❓ Проблема: Airmode не включается

Betaflight:

Проверьте, назначен ли переключатель во вкладке Modes (Betaflight Modes)
Проверьте feature AIRMODE в CLI

ArduPilot:

Убедитесь, что используете переключатель RCx_OPTION = 154, а не rudder-arming (ArduPilot Copter Airmode)
Проверьте параметр ACRO_OPTIONS

🔹 Вывод

Betaflight vs ArduPilot: Философия

Критерий	Betaflight	ArduPilot
Философия	Максимальный контроль пилота, «ручной» подход (Oscar Liang)	Автоматизация, безопасность, миссион-ориентированность (ArduPilot Copter Airmode)
Airmode по умолчанию	Выключен, включается вручную (Oscar Liang — Modes)	Зависит от настройки арминга (ArduPilot Copter Airmode)
Гибкость	Высокая (CLI, множество параметров) (Betaflight CLI)	Умеренная (через параметры и режимы) (ArduPilot Auxiliary Functions)
Безопасность на земле	Требует ручной настройки фильтров и порогов (Betaflight Modes)	Встроена в логику активации (ArduPilot Copter Airmode)

Главный совет:

💡 Если вы переходите с Betaflight на ArduPilot (или наоборот), не ожидайте идентичного поведения. Airmode решает одну и ту же задачу, но реализован с учётом разных целей: акробатика против надёжности и автономности.

Для каких задач что использовать:

Betaflight: Фристайл, гонки, акробатика, трюки на нулевом газе (Oscar Liang)
ArduPilot: Автономные полёты, съёмка, доставка, большие БПЛА (ArduPilot Copter Airmode)

📚 Полезные ресурсы

🟦 Официальная документация

Betaflight:

Modes — Betaflight Documentation — подробное описание Airmode и других режимов
I-Term Relax Explained — как работает защита от накопления интеграла
PID Tuning Guide — руководство по настройке PID
CLI Reference — справочник по командам CLI
Motors Tab Documentation — настройка моторов и Motor Stop

ArduPilot:

AirMode — Copter Documentation — официальное описание Airmode для коптеров
AirMode — Plane Documentation — Airmode для самолётов и конвертопланов
Auxiliary Functions — настройка вспомогательных функций через переключатели
Flight Modes — Copter — обзор всех режимов полёта

🟨 Сторонние руководства

Understanding Betaflight Airmode — Oscar Liang — подробное объяснение принципов работы и настройки
Betaflight Modes Explained — Oscar Liang — обзор всех режимов с примерами настройки
Betaflight FPV Drone Tuning — Oscar Liang — пошаговое руководство по тюнингу
What is Betaflight Air Mode? — QuadMeUp — базовое объяснение для новичков

🟩 Сообщество и поддержка

Betaflight GitHub — исходный код, баг-репорты, обсуждения
ArduPilot Discourse Forum — официальное сообщество пользователей и разработчиков
Betaflight Slack/Discord — чаты для быстрой помощи
RC Groups — Betaflight Thread — активное обсуждение настроек и проблем

⚠️ ВАЖНО: Перед любыми проверками и настройками всегда снимайте пропеллеры для безопасности!

Последнее обновление: 2026

Что такое Airmode

Зачем это нужно:

Проблема: моторы сами набирают обороты

Ситуация

Причина: I-Term Windup (Накопление интеграла)

⚠️ Важное замечание

Airmode в Betaflight

Как работает

Ключевые особенности Betaflight

Настройка в Betaflight

1. Включение Airmode

2. Параметр airmode_start_throttle_percent

3. I-Term Relax

⚠️ Нюансы Betaflight

🔹 Airmode в ArduPilot

Как работает

Активация в ArduPilot

Способ 1: Через арминг (рекомендуемый)

Способ 2: Отдельный переключатель

Способ 3: Постоянное включение в ACRO

⚠️ Нюансы ArduPilot

🔹 Сравнение реализаций

🔹 Настройка и безопасность

✅ Чек-лист для Betaflight

1. Проверка Receiver

2. Настройка Modes

3. CLI настройки

4. Motor Stop

✅ Чек-лист для ArduPilot

1. Настройка параметров (Mission Planner/MAVProxy)

2. Проверка арминга

3. Тестирование

🔹 Практические рекомендации

🎯 Для пользователей Betaflight

Новичкам:

Опытным пилотам:

Если моторы раскручиваются на земле:

🎯 Для пользователей ArduPilot

Безопасная настройка:

Для QuadPlane:

🔹 Ответ на вопрос: «Работает ли Airmode при газе ниже минимума?»

Короткий ответ: Зависит от ситуации

1. Если «минимум» = остановка моторов (MOTOR_STOP)

2. Если «минимум» = холостые обороты (Idle)

3. Порог min_check

🔹 Troubleshooting

❓ Проблема: Моторы сами раскручиваются на земле

❓ Проблема: Дрон «прыгает» на земле

❓ Проблема: Не могу disarm в Airmode

❓ Проблема: Airmode не включается

🔹 Вывод

Betaflight vs ArduPilot: Философия

Главный совет:

Для каких задач что использовать:

📚 Полезные ресурсы

🟦 Официальная документация

🟨 Сторонние руководства

🟩 Сообщество и поддержка

2. Параметр `airmode_start_throttle_percent`

1. Если «минимум» = остановка моторов (`MOTOR_STOP`)

3. Порог `min_check`