Betaflight CLI: объяснение и инструкция по использованию

Betaflight CLI - это интерфейс командной строки, который позволяет пользователям напрямую взаимодействовать с прошивкой полетного контроллера. Аналогично Windows и Linux, хотя вы можете получить доступ к большинству настроек через графический интерфейс (GUI), существуют более продвинутые настройки, доступные только через командную строку. Более того, для некоторых продвинутых пользователей интерфейс командной строки является более эффективным методом доступа к настройкам по сравнению с GUI. CLI также отлично подходит для резервного копирования и восстановления конфигураций, так как их можно сохранять в текстовом файле.

Зачем использовать Betaflight CLI

• Доступ к расширенным настройкам: CLI предоставляет доступ ко всем настройкам, включая те, которые недоступны в GUI.
• Легкое резервное копирование и восстановление: Вы можете легко сохранять и восстанавливать настройки, копируя и вставляя команды.
• Эффективное устранение неполадок: Быстро выявляйте и корректируйте параметры, которые могут вызывать проблемы с производительностью вашего дрона.

Как использовать Betaflight CLI

Вкладка CLI доступна в Betaflight Configurator. Вы получите к ней доступ после подключения полетного контроллера к конфигуратору. Вот руководство для новичков в Betaflight Configurator.

Вы можете вводить команды в текстовое поле в нижней части экрана и нажимать клавишу "Enter" для их выполнения.

Обычно команда в CLI выглядит так:

[команда] [настройка] = [значение]

Например, чтобы установить экспоненту для крена на ноль:

set roll_expo = 0

Чтобы выйти из CLI без изменения настроек, просто введите команду exit и нажмите Enter, перейдите на другую вкладку или нажмите кнопку disconnect в правом верхнем углу.

Синтаксис

Синтаксис в Betaflight CLI прост и удобен для начинающих.

Чувствительность к регистру

Все команды нечувствительны к регистру, вы можете вводить команды в любом регистре, большие или маленькие буквы не имеют значения. Все следующие варианты будут работать одинаково:

set serialrx_inverted = on
SET SERIALRX_INVERTED = ON
seT serialRX_inverTED = oN

Пробелы

Не имеет значения, ставите ли вы пробелы вокруг знака равенства "=", CLI может распознать команду, название настройки и значение независимо от пробелов. Все следующие варианты будут работать:

set serialrx_inverted = on
set serialrx_inverted=on
set serialrx_inverted =on
set serialrx_inverted =         on

Проверка настроек в CLI

Наиболее часто используемые команды в Betaflight CLI - это dump и diff.

При вводе dump в консоли отобразятся все настройки Betaflight. Это может быть огромный список (обычно более 1000 строк).

Поэтому мы часто используем команду diff. Если вы хотите проверить только настройки, которые отличаются от значений по умолчанию, вы можете ввести diff. Возвращаемый список гораздо короче и легче для восприятия, если вам нужно проверить только измененные настройки.

Команда get - еще одна, которую я использую постоянно. Просто введите get, затем пробел и несколько букв настройки, которую вы хотите проверить/изменить, и CLI покажет все настройки, начинающиеся с этих букв. Это очень полезно, так как вам не нужно запоминать все названия. Например:

get gps

get gps вернет все настройки, начинающиеся с gps, и, скорее всего, все они будут связаны с функциональностью GPS. А если вы введете get osd - CLI предложит все настройки, связанные с OSD. Очень полезно.

Резервное копирование и восстановление настроек Betaflight с помощью CLI

Хорошей практикой является создание резервной копии ваших настроек Betaflight CLI перед внесением изменений, чтобы вы могли откатиться, если что-то пойдет не так.

1. Для резервного копирования введите diff all и скопируйте текст в текстовый файл.
2. Для восстановления просто скопируйте и вставьте текст из файла в CLI и нажмите Enter. Не забудьте ввести save перед закрытием CLI.

Альтернативно вы можете просто использовать функцию Backup и Restore во вкладке Preset / Предустановки, которая дает тот же результат. 

Советы и хитрости

Нажмите Tab для автозавершения команды

Вы можете начать вводить начало команды CLI, а затем нажать клавишу TAB для ее завершения. Если есть несколько вариантов, CLI предложит все возможности. Это удобно, особенно для длинных команд.

Не забывайте SAVE (сохранять)!

Команда task

Команда task показывает загрузку ЦП различных процессов, работающих на полетном контроллере. Это отлично подходит для устранения неполадок, если ваш FC испытывает проблемы с загрузкой процессора.

Команды постоянно меняются - используйте Help!

Разные прошивки, такие как BetaFlight и iNav, даже если они происходят из одного источника, могут иметь разные наборы команд и названия команд, и они также могут меняться от версии к версии.

Если сомневаетесь, вы всегда можете проверить доступные команды с помощью команды help в CLI.

Другие полезные команды Betaflight CLI

Вот некоторые часто используемые команды, которые, как я думаю, вам следует знать: 

Приятных полетов!