Betaflight CLI: команды, резервная копия и безопасная настройка

Актуально на июль 2026 года.

Betaflight CLI — командная строка для просмотра, диагностики и изменения настроек полётного контроллера. Она полезна, когда нужного параметра нет в графическом интерфейсе, но требует понимания версии прошивки: имена, диапазоны и смысл параметров меняются между выпусками.

Перед работой снимите пропеллеры и отключите полётную батарею. Подключайте аккумулятор только для конкретного наземного теста, когда это действительно необходимо. Команды управления моторами, переназначения ресурсов и изменения протокола ESC способны запустить мотор или лишить контроллер управления.

Вкладка командной строки Betaflight CLI в официальном Betaflight App 2025.12 — Командная строка в официальном Betaflight App 2025.12. Скриншот сделан в виртуальном режиме без подключения реального полётного контроллера.

1. Определить версиюversion и status

2. Сохранить копиюdiff all вне CLI

3. Проверить параметрget имя

4. Изменить одноset имя = значение

5. Проверить и сохранитьget, затем save

Содержание

Что CLI умеет и когда он нужен
Правильная резервная копия
Основные команды
Почему версия Betaflight критична
Безопасный пример изменения
Диагностика через CLI
Профили и восстановление
Команды повышенного риска
Проверка перед полётом

Что CLI умеет и когда он нужен

Большинство обычных настроек удобнее выполнять во вкладках Betaflight App: Ports, Receiver, Motors, PID Tuning, GPS, OSD и Presets. CLI нужен для четырёх типов задач:

посмотреть точную версию прошивки, аппаратный статус и причины запрета арминга;
найти параметр и допустимые для него значения непосредственно в установленной прошивке;
сохранить текстовую копию конфигурации или сравнить её с настройками по умолчанию;
выполнить аппаратное переназначение или настройку, которой нет в интерфейсе.

CLI не делает настройку «точнее» сам по себе. Если параметр есть в графическом интерфейсе, безопаснее пользоваться им: приложение показывает взаимосвязанные настройки и снижает риск опечатки.

Главный источник истины — сам контроллер. Команды help и get часть_имени показывают, что действительно поддерживает конкретная сборка прошивки и какие значения допустимы.

Правильная резервная копия

До любого изменения сохраните версию прошивки и конфигурацию. Минимальный набор:

version
status
diff all

diff all выводит отличия от настроек по умолчанию для всех профилей. Вывод нужно скопировать из окна CLI и сохранить в текстовый файл средствами Betaflight App или операционной системы.

Команда diff all > backup.txt в Betaflight CLI не работает. Оператор перенаправления > относится к командным оболочкам компьютера, а не к CLI полётного контроллера.

Для полной диагностической копии можно дополнительно сохранить:

dump all

dump all длиннее: он включает значения по умолчанию. Для обычного восстановления чаще удобнее diff all. На момент проверки публичный Betaflight App показывает версию 2025.12.2. В официальных примечаниях к выпуску 2026.6 уже описано прямое восстановление через вкладку Backups; классическая вкладка CLI при этом сохранена. Поэтому перед процедурой ориентируйтесь на номер версии именно вашего приложения.

Основные команды Betaflight CLI

Команда	Назначение	Что важно
`help`	Список команд этой прошивки	Проверяйте перед использованием инструкции из интернета
`version`	Версия, target и идентификатор сборки	Сохраните вместе с резервной копией
`status`	Датчики, загрузка, частота цикла, arming disable flags	Первая команда при диагностике
`tasks`	Статистика планировщика	Нужна для анализа нагрузки и поздних запусков задач
`get gps`	Найти параметры, содержащие `gps`	CLI покажет текущие и разрешённые значения
`set имя = значение`	Изменить один параметр	Изменение не записано во flash до `save`
`diff all`	Все отличия от default	Основной текстовый бэкап
`dump all`	Полная конфигурация	Большой вывод, включая значения по умолчанию
`save`	Записать настройки и перезагрузить FC	Соединение временно прервётся
`exit`	Выйти без сохранения и перезагрузить	Полезно, если передумали сохранять
`defaults`	Сбросить конфигурацию	Команда повышенного риска; не средство обычной диагностики

В прошивках ветки 2025.12 появились варианты save noreboot, exit noreboot и defaults nosave. В Betaflight 4.5 их может не быть — проверяйте через help.

Почему версия Betaflight критична

Нельзя объединять Betaflight 4.5, 2025.12 и последующие выпуски в одну таблицу параметров. Официальная документация приводит конкретные примеры несовместимости:

Область	Betaflight 4.5	Ветка 2025.12
Динамический D	`d_roll` обозначал D max, использовался `d_min_roll`	`d_roll` — базовый D, максимум задаётся `d_max_roll`
GPS Rescue	Набор параметров `gps_rescue_*` версии 4.5	Подсистема переработана; старый набор нельзя переносить вслепую
Посадка при failsafe	`failsafe_off_delay`	`failsafe_landing_time`

Кроме версии имеет значение состав online build. Опции GPS, OSD, телеметрии, датчиков и отладки могут отсутствовать, если соответствующий код не включён при сборке прошивки.

Надёжное правило: если get имя не находит параметр, не подбирайте похожее название и не вставляйте команду силой. Проверьте версию, target, build options и официальную документацию именно для этой ветки.

Безопасный пример изменения

Допустим, нужно переключить единицы OSD на метрические. Сначала узнайте имя и допустимые значения:

version
get osd_units

Если CLI подтвердил существование параметра и среди разрешённых значений есть METRIC:

set osd_units = METRIC
get osd_units
diff all

Проверьте результат. Только после этого:

save

Для параметров PID, фильтров, моторов, failsafe и GPS Rescue одного синтаксического подтверждения недостаточно: нужно понимать физический эффект, проверить вкладки приложения и провести наземный тест.

Если меняете расположение или единицы экрана, сначала сверьтесь с отдельным руководством по настройке OSD. Для поведения регуляторов на малом газе смотрите материал об Airmode, а не переносите случайные CLI-значения.

Диагностика через CLI

Контроллер не армится

status

Смотрите поле arming disable flags. Оно указывает причину: активный CLI, отсутствие сигнала приёмника, неверный угол, калибровка, перегрузка процессора и другие состояния. Не отключайте защиту, пока не устранена исходная причина.

Нужный параметр не находится

version
help
get часть_названия

Если инструкция написана для другой версии, найдите архивную CLI-справку этой ветки. Особенно внимательно проверяйте GPS Rescue, failsafe, PID, D-term и аппаратные ресурсы.

После изменения поведение стало хуже

Не меняйте ещё пять параметров. Выйдите без сохранения, если save ещё не выполнялся. Если изменение уже сохранено, верните конкретное прежнее значение из резервной копии, затем снова проверьте diff all.

Проверка загрузки контроллера

status
tasks

Оценивайте загрузку в контексте конкретной платы и функций. Универсального значения «CPU минус 5%» от одной настройки OSD не существует.

Профили и восстановление

PID-профили и профили rates — разные наборы настроек. Перед изменением проверьте активный профиль:

profile
rateprofile
diff profile
diff rates

Нумерация в CLI начинается с нуля. Не копируйте только видимые PID-значения, забывая о выбранном профиле, фильтрах и rates.

Восстановление на той же версии

Сверьте version и target с сохранённой копией.
Снимите пропеллеры.
Импортируйте проверенный diff через штатное восстановление или вставляйте его контролируемыми частями.
Просмотрите сообщения об ошибках CLI.
После перезагрузки проверьте Ports, Receiver, Motors, Modes, Failsafe, OSD и направление модели.

Перенос после обновления прошивки

Официальная инструкция рекомендует ручную перенастройку после прошивки. В пределах одной point-версии diff часто можно импортировать, но между крупными ветками безопаснее переносить только понятные разделы и проверять каждую команду. Старые resource-команды и параметры профилей особенно чувствительны к изменениям.

Команды и настройки повышенного риска

Область	Риск	Минимальная мера безопасности
`motor` и тесты ESC	Неожиданный запуск двигателя	Всегда снять пропеллеры и закрепить аппарат
`resource`, `dma`, `timer`	Потеря выхода мотора, UART или конфликт периферии	Сохранить исходную карту ресурсов и схему платы
Протокол моторов и bidirectional DShot	Моторы не запускаются или телеметрия неверна	Проверить поддержку ESC и ошибки DShot в Motors
PID и фильтры	Осцилляции, перегрев моторов, потеря управления	Менять постепенно, контролировать температуру и Blackbox
Failsafe и GPS Rescue	Неверное действие при потере связи	Полный наземный тест без пропеллеров и безопасный первый полёт
`defaults` и прошивка	Потеря всей конфигурации	Проверенная резервная копия и точный target

Не используйте готовые «конфиги для 5″/7″/cinewhoop» как универсальные. Даже при одинаковом размере отличаются полётный контроллер, гироскоп, ESC, моторы, масса, пропеллеры, приёмник, GPS и состав прошивки.

Проверка после изменений

пропеллеры сняты для всех наземных проверок;
status не показывает необъяснимых ошибок датчиков или загрузки;
3D-модель движется в правильную сторону;
каналы Receiver и переключатели Modes работают правильно;
порядок и направление моторов проверены отдельно;
измерение напряжения и тока сопоставлено с внешним прибором;
failsafe проверен на земле по официальной процедуре;
для GPS Rescue подтверждены home point, спутники, направление и условия активации;
после проверки сохранён новый diff all с версией прошивки.

Что читать дальше

Официальные источники

Коротко: CLI безопасен, когда вы работаете с параметрами своей версии, сохраняете резервную копию и понимаете назначение каждой команды. Случайный набор «оптимальных значений» опаснее заводских настроек.