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

Редакционная адаптация WARPfly на основе материала Oscar Liang «Betaflight CLI Explained».

CLI даёт прямой доступ к состоянию и настройкам Betaflight. Это полезный диагностический инструмент, но он не проверяет смысл вставленной команды за пилота. Параметры, имена и допустимые диапазоны меняются между версиями, поэтому старый dump или строка из видео может быть несовместима со стабильной Betaflight 2025.12.5. Безопасный подход — сначала прочитать, затем сохранить резервную копию и менять по одному параметру.

Подготовка до открытия CLI

Сними пропеллеры, подключи FC по исправному USB-кабелю и убедись, что приложение видит точную версию прошивки и target. Сохрани конфигурацию средствами приложения и отдельный текстовый вывод CLI. Для анализа изменений особенно удобен diff all: он показывает отличия от текущих defaults. dump выводит более полный набор настроек и полезен как снимок состояния.

Резервная копия не является универсальным установочным файлом. Сохрани рядом версию Betaflight, target, дату и назначение аппарата. После обновления не вставляй старый полный dump вслепую: сначала используй официальный процесс миграции и переноси только проверенные настройки, которые существуют в новой версии.

Команды только для чтения

• version — показывает версию прошивки, target и сведения о сборке.
• status — состояние системы, датчиков, загрузки и причины, важные для диагностики.
• get имя — ищет параметр и показывает текущее значение с допустимым диапазоном.
• diff all — выводит отличия конфигурации от defaults.
• dump — формирует полный текстовый снимок доступной конфигурации.
• resource show all — показывает активные назначения пинов и связанные ресурсы.
• tasks — помогает оценить выполняемые задачи и нагрузку при диагностике.

Вывод зависит от установленной версии и возможностей target. Если команда из старой статьи не существует, не подбирай похожее имя наугад. Открой официальный CLI reference именно для 2025.12 и найди актуальный параметр. Отсутствующая настройка может быть переименована, удалена или перенесена в другую модель конфигурации.

Изменение одного параметра

Типовой порядок состоит из чтения, изменения, повторного чтения и сохранения. Сначала выполни get имя, запиши исходное значение и допустимый диапазон. Затем используй форму set имя = значение. CLI обычно сообщает об ошибке синтаксиса или диапазона, но корректная по форме цифра всё ещё может быть опасна для конкретного аппарата.

Команда save записывает настройки и перезагружает контроллер. До неё многие изменения остаются в рабочей сессии и могут не пережить перезапуск. После reconnect снова выполни get и убедись, что значение применилось. Затем сравни новый diff all со старым, чтобы увидеть только ожидаемую строку.

Диагностика без случайного ремонта

1. Запиши наблюдаемый симптом и условия, при которых он появляется.
2. Сними version, status и исходный diff all.
3. Проверь аппаратную причину: питание, проводку, пайку и повреждения.
4. Найди связанный параметр в официальном reference стабильной версии.
5. Измени только одну величину и сохрани её.
6. Повтори безопасный наземный тест либо короткий полёт по заранее заданному сценарию.
7. Если результат ухудшился, верни записанное исходное значение.

CLI не способен исправить оборванный провод, повреждённый гироскоп или сгоревший выход MCU. Большое число случайных команд маскирует исходный симптом и усложняет помощь. Если проблема появилась после удара или пайки, сначала осматривают железо. Если после обновления — сравнивают версии и изменения defaults.

Опасные действия

defaults сбрасывает конфигурацию и не является безобидной диагностикой. Команды ресурсного назначения, DMA, моторов и passthrough могут изменить аппаратное поведение или передать управление другому устройству. Их выполняют только с резервной копией, снятыми пропеллерами и точным пониманием target.

Не вставляй огромный блок команд, не прочитав его. В нём могут быть чужой target, порядок каналов, ориентация платы, моторные ресурсы, VTX-частоты или failsafe. Даже если CLI не выдаёт ошибку, аппарат способен стать неуправляемым. Настройки безопасности всегда проверяют заново на земле.

Как хранить резервные копии

• Имя файла включает модель, target, версию прошивки и дату.
• Исходный diff all хранится отдельно от экспериментального.
• Рядом записываются версии приёмника, ESC и радиосистемы.
• Секреты, Wi-Fi-данные и binding phrase не публикуются в открытых логах.
• Перед прошивкой проверяется, что файл действительно читается и не пуст.

Хорошая CLI-сессия оставляет проверяемый след: что было, какая одна строка изменилась, почему и чем подтверждён результат.

CLI особенно силён как инструмент наблюдения и воспроизводимости. version, status, get и diff all часто дают ответ до первой правки. Когда изменение всё же необходимо, сохрани исходное значение, используй документацию Betaflight 2025.12.5, выполни save и проверь конфигурацию после перезагрузки.