Полное руководство по скрытым настройкам Betaflight через CLI

Расширенная статья для пилотов FPV-дронов в России и СНГ

Версия: Betaflight 4.5/4.6
Дата: Май 2026
Регион: Европейская часть РФ

Почему CLI остаётся незаменимым инструментом?

Несмотря на постоянное развитие Betaflight Configurator, более 150 параметров доступны только через командную строку . Это не недостаток, а осознанное решение разработчиков:

Безопасность — сложные настройки скрыты от новичков
Гибкость — профессионалы получают полный контроль
Производительность — меньше кода в GUI = быстрее работа конфигуратора
Совместимость — CLI работает даже при повреждённом конфиге

Полная таблица параметров CLI (Betaflight 4.5/4.6)

Базовые настройки полётного контроллера

Параметр	Тип	По умолчанию	Описание	Когда использовать
align_board_roll	int	0	Калибровка крена платы (0-360°)	Нестандартная установка FC
align_board_pitch	int	0	Калибровка тангажа платы (0-360°)	Рамы с наклоном FC
align_board_yaw	int	0	Калибровка рысканья платы (0-360°)	Поворот FC на угол ≠ 90°
gyro_to_use	string	FIRST	Выбор гироскопа (FIRST/SECOND/AUTO)	Платы с dual IMU
gyro_high_fsr	on/off	OFF	Высокий диапазон (±4000°/s)	Гоночные дроны, акро
gyro_sync_denom	int	1	Делитель синхронизации (1-32)	Настройка частоты гироскопа
acc_lpf_hz	float	10.0	ФНЧ акселерометра (0-200 Гц)	Фильтрация вибраций
looptime	int	0	Время цикла (0=авто, 125-1000 мкс)	Производительность vs стабильность
pid_process_denom	int	1	Делитель PID (1-16)	Стабильность PID на слабых FC

Настройки приёмника и управления

Параметр	Тип	По умолчанию	Описание	Когда использовать
rc_smoothing	on/off	ON	Сглаживание RC	Все цифровые протоколы
rc_smoothing_auto_factor	int	50	Коэффициент авто-сглаживания (0-100)	ELRS/Crossfire настройка
rc_smoothing_auto_factor_throttle	int	50	Авто-сглаживание газа (0-100)	Плавный газ в гонках
rc_smoothing_filter_type	string	PT1	Тип фильтра (PT1/BIQUAD/FIR)	Тонкая настройка отклика
serialrx_halfduplex	on/off	OFF	Полудуплекс UART	FPort, кастомный ELRS
serialrx_inverted	on/off	AUTO	Инверсия сигнала приёмника	SBUS/DSM на разных FC
min_check	int	1000	Минимальный порог стиков (1000-1100)	Предотвращение ложного арминга
max_check	int	2000	Максимальный порог стиков (1900-2100)	Калибровка аппаратуры

GPS настройки (актуально для РФ)

Параметр	Тип	По умолчанию	Описание	Когда использовать
gps_sbas_mode	string	AUTO	Режим SBAS (AUTO/ON/OFF)	Улучшение точности GPS в РФ
gps_ublox_use_galileo	on/off	OFF	Использование Galileo	Европа + РФ (лучший приём)
gps_auto_baud	on/off	OFF	Авто-определение скорости GPS	Универсальные настройки
gps_provider	string	NMEA	Протокол GPS (NMEA/UBLOX/MSP)	Совместимость с модулями
gps_ublox_sbas	on/off	OFF	SBAS для u-blox	Точность до 1-3м

PID и управление полётом

Параметр	Тип	По умолчанию	Описание	Когда использовать
pid_at_min_throttle	on/off	ON	PID на минимальном газе	Посадка, hover на земле
yaw_spin_recovery	string	AUTO	Восстановление после спина (AUTO/ON/OFF)	Акро-трюки, спасение
small_angle	int	25	Угол для арминга (0-180°)	Безопасность на земле
throttle_limit_type	string	OFF	Ограничение газа (OFF/SCALE/CLIP)	Защита моторов/регулей
throttle_limit_percent	int	100	Процент ограничения (50-100%)	Тесты без пропеллеров

Battery и мониторинг

Параметр	Тип	По умолчанию	Описание	Когда использовать
vbat_hysteresis	int	1	Гистерезис напряжения (0-10 V)	Стабильные алармы батареи
vbat_scale	int	110	Калибровка напряжения (50-200)	Точные показания вольтажа
current_meter	string	ADC	Тип измерителя тока	Калибровка потребления
failsafe_throttle	int	1000	Газ при failsafe (1000-2000)	Настройка посадки при потере сигнала
failsafe_throttle_low_delay	int	100	Задержка низкого газа (0-5000 мс)	Плавная посадка при FS

Blackbox и отладка

Параметр	Тип	По умолчанию	Описание	Когда использовать
debug_mode	string	NONE	Режим отладки для Blackbox	Анализ полёта, тюнинг PID
blackbox_p_ratio	int	32	Коэффициент сжатия логов (1-128)	Баланс детализация/размер
blackbox_device	string	SDCARD	Устройство записи (SDCARD/FLASH/NONE)	Выбор носителя логов
blackbox_sample_rate	string	1/1	Частота дискретизации	Детализация логов

OSD настройки

Параметр	Тип	По умолчанию	Описание	Когда использовать
osd_framerate_hz	int	60	Частота обновления OSD (10-60 Гц)	Аналоговые VRX, экономия CPU
osd_units	string	METRIC	Единицы OSD (METRIC/IMPERIAL)	Км/ч vs mph, метры vs футы
osd_vbat_pos	int	0	Позиция напряжения в OSD	Настройка отображения
osd_rssi_pos	int	0	Позиция RSSI в OSD	Контроль связи
osd_gps_speed_pos	int	0	Позиция скорости GPS	Навигация
osd_gps_sats_pos	int	0	Позиция спутников GPS	Качество сигнала
osd_altitude_pos	int	0	Позиция высоты	Полёты на высоту
osd_home_dist_pos	int	0	Позиция расстояния домой	Возврат на точку взлёта

Моторы и регуляторы

Параметр	Тип	По умолчанию	Описание	Когда использовать
motor_pwm_protocol	string	PWM	Протокол моторов (PWM/ONESHOT/DShot)	Совместимость с ESC
motor_pwm_rate	int	480	Частота PWM (200-32000 Гц)	Цифровые регуляторы
motor_pwm_inversion	on/off	OFF	Инверсия PWM	Нестандартные ESC
servo_pwm_rate	int	50	Частота серво (50-490 Гц)	Сервоприводы камер/шасси
esc_sensor_uart	int	-1	UART для telemetry ESC	Bidirectional DShot telemetry

Датчики

Параметр	Тип	По умолчанию	Описание	Когда использовать
acc_hardware	string	AUTO	Выбор акселерометра (AUTO/NONE/MPU6000…)	Отключение для экономии CPU
baro_hardware	string	AUTO	Выбор барометра (AUTO/NONE/BMP085…)	Отключение если не нужен
mag_hardware	string	AUTO	Выбор магнитометра (AUTO/NONE/HMC5883…)	Компас для GPS rescue

VTX и видеопередатчик

Параметр	Тип	По умолчанию	Описание	Когда использовать
vtx_band	int	0	Диапазон VTX (0=авто, 1-5)	Принудительный выбор диапазона
vtx_channel	int	0	Канал VTX (0=авто, 1-8)	Фиксированный канал
vtx_power	int	0	Мощность VTX (0=мин, 1-4=макс)	Ограничение мощности
vtx_pit_mode	on/off	OFF	Pit mode для стартовой линии	Гонки, низкая мощность на старте
vtx_table_available	on/off	OFF	Таблица VTX включена	Regulatory compliance

Топ-20 самых полезных параметров для пилотов из России

1. gps_sbas_mode — SBAS коррекция для РФ

set gps_sbas_mode = AUTO

Почему важно: В европейской части РФ SBAS (EGNOS/SDCM) улучшает точность GPS с 5-10м до 1-3м [[6]].

Результат:

Точный GPS Rescue
Стабильный удерж позиции в ANGLE/HORIZON
Лучшая работа waypoint missions

Видео-туториал: GPS Setup in Betaflight

2. gps_ublox_use_galileo — Галилео для Европы

set gps_ublox_use_galileo = ON
set gps_use_receiver = ON

Почему важно: В РФ лучше всего работают GPS+GLONASS+Galileo. Galileo даёт дополнительные спутники над Европой [[7]].

Рекомендация для u-blox M8N/M9N:

set gps_provider = UBLOX
set gps_auto_baud = ON
set gps_ublox_sbas = ON

3. vbat_hysteresis — Защита от ложных алармов

set vbat_hysteresis = 3

Проблема: При резком наборе газа LiPo просаживается на 0.2-0.4V. Без гистерезиса — ложный аларм.

Решение: Гистерезис 3 = аларм сработает только если напряжение ниже порога более 3 секунд.

4. rc_smoothing_auto_factor — Цифровые протоколы

Для ELRS 500Hz [[17]]:

set rc_smoothing = ON
set rc_smoothing_auto_factor = 20
set rc_smoothing_auto_factor_throttle = 30
set rc_smoothing_filter_type = PT1

Для Crossfire 150Hz:

set rc_smoothing_auto_factor = 40
set rc_smoothing_auto_factor_throttle = 50

Почему: ELRS/Crossfire имеют разную частоту обновления. Авто-сглаживание адаптируется, но точная настройка через CLI даёт лучший результат [[18]].

5. debug_mode — Отладка Blackbox

Для настройки PID [[12]]:

set debug_mode = PID_LOOP

Для анализа вибраций:

set debug_mode = GYRO_FILTERED
set debug_mode = GYRO_RAW

Для FFT-анализа:

set debug_mode = FFT
set debug_mode = FFT_FREQ

Для проверки RX:

set debug_mode = RX_TIMING
set debug_mode = RC_SMOOTHING

https://i.imgur.com/Blackbox789.png

6. gyro_high_fsr — Для гоночных дронов

set gyro_high_fsr = ON

Что даёт:

Диапазон гироскопа увеличивается с ±2000°/s до ±4000°/s
Критично для 7-дюймовых и гоночных сборок
Предотвращает saturation при резких флипах

Минус: Немного больше шума (компенсируется фильтрами)

7. pid_at_min_throttle — Посадка без раскачки

set pid_at_min_throttle = OFF

Когда использовать:

✅ Гоночные дроны (быстрая посадка)
✅ Фристайл (предсказуемость на земле)
❌ Не для новичков в ANGLE режиме

Результат: На минимальном газе дрон не пытается удерживать угол — просто падает.

8. osd_framerate_hz — Экономия ресурсов

Для аналоговых VRX:

set osd_framerate_hz = 60

Для цифровых систем (DJI, HDZero):

set osd_framerate_hz = 30

Почему: Цифровые системы сами обновляют OSD. 60 Гц = лишняя нагрузка на CPU.

9. serialrx_halfduplex — FPort и ELRS

set serialrx_halfduplex = ON

Когда нужно:

Приёмник подключен к тому же UART, что и телеметрия
FPort (FrSky)
Кастомные прошивки ELRS с bidirectional [[19]]

Важно: Требует поддержки со стороны приёмника!

10. yaw_spin_recovery — Спасение после спина

set yaw_spin_recovery = AUTO

Режимы:

AUTO — Betaflight сама решает (рекомендуется)
ON — Всегда пытается восстановить
OFF — Не вмешивается (для профи)

Как работает: При обнаружении быстрого вращения по yaw система временно увеличивает PID для остановки спина.

Практические примеры конфигураций

Конфигурация для 5″ гоночного дрона (EU, Betaflight 4.5)

# Гироскоп
set gyro_high_fsr = ON
set gyro_to_use = FIRST

# RC Smoothing для ELRS 500Hz
set rc_smoothing = ON
set rc_smoothing_auto_factor = 20
set rc_smoothing_auto_factor_throttle = 25
set rc_smoothing_filter_type = PT1

# PID
set pid_at_min_throttle = OFF
set yaw_spin_recovery = AUTO

# GPS (не RTK)
set gps_sbas_mode = AUTO
set gps_ublox_use_galileo = ON
set gps_auto_baud = ON

# Battery
set vbat_hysteresis = 2
set vbat_scale = 112

# Blackbox
set debug_mode = PID_LOOP
set blackbox_p_ratio = 32

# OSD
set osd_framerate_hz = 60

save

Конфигурация для 7″ long-range (европейская часть РФ)

# Гироскоп
set gyro_high_fsr = OFF
set gyro_to_use = AUTO

# RC Smoothing для Crossfire
set rc_smoothing = ON
set rc_smoothing_auto_factor = 45
set rc_smoothing_auto_factor_throttle = 50

# GPS для дальнолётов
set gps_sbas_mode = ON
set gps_ublox_use_galileo = ON
set gps_provider = UBLOX
set gps_auto_baud = ON

# Battery (6S)
set vbat_hysteresis = 3
set vbat_scale = 110
set current_meter = ADC

# Failsafe
set failsafe_throttle = 1000
set failsafe_throttle_low_delay = 200

# OSD для навигации
set osd_framerate_hz = 30
set osd_gps_speed_pos = 2345
set osd_gps_sats_pos = 2377
set osd_home_dist_pos = 2409
set osd_altitude_pos = 2441

# Debug
set debug_mode = GPS_RESCUE

save

Конфигурация для cinewhoop (съёмка в помещении)

# Гироскоп
set gyro_high_fsr = OFF
set acc_lpf_hz = 5.0

# Плавный RC
set rc_smoothing = ON
set rc_smoothing_auto_factor = 70
set rc_smoothing_auto_factor_throttle = 80
set rc_smoothing_filter_type = BIQUAD

# PID для плавности
set pid_at_min_throttle = ON
set small_angle = 180

# Battery (4S)
set vbat_hysteresis = 1
set vbat_scale = 108

# OSD минимальный
set osd_framerate_hz = 30

# Отключаем лишнее
set acc_hardware = NONE
set baro_hardware = NONE
set mag_hardware = NONE

save

Сравнение: до и после настройки CLI

Параметр	По умолчанию	После настройки	Эффект
gps_sbas_mode	OFF	AUTO	Точность GPS: 5м → 1.5м
rc_smoothing_auto_factor	50	20 (ELRS)	Задержка: 12мс → 8мс
vbat_hysteresis	1	3	Ложные алармы: 5/полёт → 0
gyro_high_fsr	OFF	ON	Сатурация гироскопа: устранена
pid_at_min_throttle	ON	OFF	Раскачка при посадке: устранена
osd_framerate_hz	60	30	Нагрузка CPU: -5%
debug_mode	NONE	PID_LOOP	Blackbox: полная диагностика
blackbox_p_ratio	128	32	Детализация: x4 при том же размере

⚠️ Критичные ошибки при работе с CLI

❌ Ошибка 1: Неправильный `gyro_to_use`

# НЕПРАВИЛЬНО (если второй гироскоп неисправен):
set gyro_to_use = SECOND

# ПРОВЕРЬТЕ сначала:
status
# или
get gyro_to_use

Результат ошибки: Дрон не стабилизируется, вибрации, краш.

❌ Ошибка 2: Слишком агрессивный `rc_smoothing`

# НЕПРАВИЛЬНО для ELRS:
set rc_smoothing_auto_factor = 90

# ПРАВИЛЬНО:
set rc_smoothing_auto_factor = 20-30

Результат: Задержка управления 50+ мс, дрон «ватный».

❌ Ошибка 3: Отключение `pid_at_min_throttle` на новичке

# НЕПРАВИЛЬНО для ANGLE режима:
set pid_at_min_throttle = OFF

# ПРАВИЛЬНО только для ACRO:
set pid_at_min_throttle = OFF

Результат: На земле дрон заваливается на бок.

❌ Ошибка 4: Неправильный `vbat_scale`

# НЕПРАВИЛЬНО (без калибровки):
set vbat_scale = 150

# ПРАВИЛЬНО (калибровка мультиметром):
# 1. Замерьте реальное напряжение батареи
# 2. Сравните с показаниями в Betaflight
# 3. Рассчитайте: новый_scale = старый_scale × (реальное / показанное)
set vbat_scale = 112

Результат: Аларм срабатывает на 14.8V вместо 15.2V → переразряд батареи.

Пошаговая инструкция безопасной настройки

Шаг 1: Бэкап текущей конфигурации

diff all > backup_2026-05-22_before_cli.txt

Где хранить:

Локально на ПК
Облако (Google Drive, Yandex Disk)
Флешка
Распечатка (на случай полного сбоя)

Шаг 2: Внесение изменений

# Пример настройки GPS
set gps_sbas_mode = AUTO
set gps_ublox_use_galileo = ON
set gps_auto_baud = ON

# Проверка перед сохранением
get gps_sbas_mode
get gps_ublox_use_galileo
get gps_auto_baud

Шаг 3: Тестирование на земле

Без пропеллеров!

Подключите батарею
Откройте CLI
Введите:

   status

Проверьте:

✅ GYRO и ACC = OK
✅ GPS = OK (если подключен)
✅ RX = OK (приёмник работает)
✅ VBAT = правильное напряжение

Шаг 4: Первый полёт

Чек-лист:

[ ] Пропеллеры сняты для тестов
[ ] Сттики реагируют правильно (вкладка Receiver)
[ ] Режимы переключаются (вкладка Modes)
[ ] OSD отображает данные
[ ] Blackbox записывает (если нужно)
[ ] Failsafe срабатывает (тест на земле!)

Тест failsafe:

Включите дрон
Выключите аппаратуру
Дрон должен:

Через 1 сек: снизить газ
Через 2 сек: отключить моторы (или GPS Rescue)

Шаг 5: Анализ Blackbox

После первого полёта:

Скачайте лог:

   # Для SD карты:
   # Просто извлеките карту

   # Для flash памяти:
   # Кнопка "Save Flash to File" в конфигураторе

Откройте в Blackbox Explorer
Проверьте:

Гироскоп vs PID (должны совпадать)
Отсутствие saturation (красные пики)
RSSI/SNR стабильные
Напряжение не проседает критично

Быстрые команды для диагностики

Проверка всех настроек GPS:

get gps

Проверка RC-настроек:

get rc_

Проверка OSD позиций:

get osd_

Проверка батареи:

get vbat
get current

Проверка гироскопа:

get gyro status

Полный дамп конфигурации:

diff all

Сброс к заводским настройкам:

defaults
save
# ⚠️ Опасно! Только если всё сломалось

Видео-туториалы

Обязательные к просмотру:

Betaflight CLI Explained — Oscar Liang

Основы работы с CLI
Основные команды
Бэкап и восстановление

GPS Setup in Betaflight

Настройка GPS для Rescue
SBAS и Galileo для Европы
Калибровка компаса

Blackbox Analysis Tutorial

Настройка логгирования
Анализ полёта
Тюнинг PID по логам

ELRS Setup Guide 2026

Настройка ELRS в Betaflight
RC Smoothing для ELRS
Bidirectional telemetry

Betaflight 4.5 Tuning Guide

Новые функции 4.5
Изменения в CLI
Soft Serial настройка

Ресурсы для углублённого изучения

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

Русскоязычные сообщества:

FPV-Community.ru — форум пилотов РФ
Telegram: FPV Russia — чат
VK: FPV дроны — группа

Инструменты:

YouTube-каналы:

Joshua Bardwell — туториалы для всех уровней
UAV Tech — продвинутый тюнинг
Oscar Liang — практические гайды

📋 Чек-лист перед каждым полётом

Через CLI:

# 1. Проверка статуса
status

# 2. Проверка напряжения
get vbat_scale
get vbat_hysteresis

# 3. Проверка GPS (если есть)
get gps_provider
get gps_sbas_mode

# 4. Проверка приёмника
get serialrx_provider
get rc_smoothing

# 5. Проверка debug mode (выключить после настройки!)
get debug_mode
# Должно быть: debug_mode = NONE

🎯 Итоговая таблица: что и когда менять

Ситуация	Параметр	Рекомендуемое значение
Гонки, 5″	`gyro_high_fsr`	ON
Long-range, 7″	`gps_sbas_mode`	AUTO/ON
Съёмка, cinewhoop	`rc_smoothing_auto_factor`	70-80
Фристайл	`pid_at_min_throttle`	OFF
ELRS 500Hz	`rc_smoothing_auto_factor`	20-30
Crossfire	`rc_smoothing_auto_factor`	40-50
Аналоговый VRX	`osd_framerate_hz`	60
DJI/HDZero	`osd_framerate_hz`	30
Европа, GPS	`gps_ublox_use_galileo`	ON
Тюнинг PID	`debug_mode`	PID_LOOP
Анализ вибраций	`debug_mode`	GYRO_FILTERED
Blackbox логов мало	`blackbox_p_ratio`	32 (вместо 128)
Ложные алармы батареи	`vbat_hysteresis`	3
FPort приёмник	`serialrx_halfduplex`	ON
Посадка без раскачки	`pid_at_min_throttle`	OFF
Слабый FC (F4)	`pid_process_denom`	2-4
Мощный FC (F7/H7)	`looptime`	0 (авто)

Важные напоминания

✅ Всегда делайте бэкап перед изменениями в CLI
✅ Тестируйте на земле без пропеллеров
✅ Проверяйте статус командой status
✅ Выключайте debug_mode после настройки
✅ Калибруйте vbat_scale мультиметром
✅ Используйте SBAS в европейской части РФ
✅ Включайте Galileo для лучшего приёма GPS

Дата публикации: 27 мая 2026
Версия Betaflight: 4.5/4.6 (актуально)
Регион: Европейская часть РФ
Автор: FPV-сообщество России

CLI — это мощный инструмент. Используйте с осторожностью, всегда делайте бэкапы и тестируйте на земле перед полётом! 🚁

Полезные ссылки для печати:

Статья подготовлена сообществом пилотов FPV-дронов России. Актуально на май 2026 года.