Что такое Betaflight CLI?
CLI (Command Line Interface) означает командную строку, режим конфигурации, который дает пользователю доступ ко всем настройкам и параметрам в прошивке полетного контроллера.
CLI - мощнейший инструмент, но может испугать менее опытных пользователей. В этом руководстве я объясню, зачем и как использовать CLI в Betaflight.
Почему мы используем CLI?
CLI был представлен ещё в Baseflight и до сих пор существует в Betaflight, iNav, Emuflight и других.
Из-за большого количества настроек в программном обеспечении было бы невозможно отобразить их все в графическом интерфейсе пользователя, не создавая слишком загруженного в использовании конфигуратора. Большинство этих настроек редко меняются, поэтому их скрыли в командной строке.
Еще одним преимуществом командной строки является то, насколько легко получить все настройки и сделать их резервные копии просто вставив в текстовый файл, чуть ниже расскажу, как это сделать.
Как использовать Betaflight CLI?
Раздел CLI доступен в Betaflight Configurator (скачать), вы получите к нему доступ после того, как подключите полетный контроллер к конфигуратору.
Вы можете вводить команды в поле ввода текста в самом низу экрана и нажать клавишу «Enter» на клавиатуре, чтобы выполнить команду.
Обычно команда в CLI выглядит так:
[command] [setting] = [value]
Например, чтобы установить экспо для ролла равным нулю:
set roll_expo = 0
После того, как вы изменили настройку, вы должны ввести команду «save», чтобы сохранить изменения, после чего FC перезагрузится. Если вы выйдете из CLI, не сделав этого, ваши изменения будут потеряны.
Чтобы выйти из командной строки без изменения настроек, просто введите команду «exit» и нажмите Enter, или щелкните в другой раздел, или нажмите кнопку «disconnect» в правом верхнем углу.
Синтаксис
Синтаксис Betaflight CLI очень простой и удобный.
Чувствительность к регистру
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 на экране. Это большой список настроек (около 800 строк) и его просмотр может занять время.
Вот почему вместо него мы используем команду «diff».
Если вы хотите увидеть настройки, которые отличаются от настроек по умолчанию, вы можете ввести команду «diff», список будет намного короче и им легче управлять.
Ознакомьтесь с этой статье для получения дополнительной информации о команде «diff».
Команда «get» - это еще одна команда, которую часто использую. Просто введите «get», затем пробел и несколько букв параметра, который вы хотите проверить / изменить, и CLI вернет все настройки, которые начинаются с этих букв.
Это очень полезная команда, так как вам не нужно запоминать имена. Например:
get serialrx
Команда вернёт «serialrx_inverted» и «serialrx_duplex», которые тоже часто использую.
Резервное копирование и восстановление настроек Betaflight с помощью командной строки
Перед внесением изменений рекомендуется сделать резервную копию настроек командной строки Betaflight, чтобы можно было откатиться обратно, если что-то пойдет не так.
Для резервного копирования введите «diff all» и скопируйте текст в текстовый файл.
Чтобы восстановить, просто скопируйте и вставьте из текстового файл в CLI, далее нажмите Enter. Не забудьте ввести «save» перед закрытием.
Секреты и уловки
Нажмите Tab, чтобы завершить команду.
Вы можете начать вводить начало команды CLI, а затем нажать клавишу TAB, чтобы завершить ее. Если есть несколько вариантов, интерфейс командной строки покажет вам все возможные. Очень удобно для длинных команд.
Не забывайте СОХРАНЯТЬ!
Всегда вводите команду «save» перед выходом из командной строки, если вы планируете сохранить изменения.
Процессор задач
Команда tasks показывает загрузку ЦП различными процессами, запущенных на полетном контроллере. Она отлично подходит для устранения неполадок, если у вашего FC проблемы с загрузкой процессора.
Команды меняются - используйте help!
Разные прошивки (Cleanflight, BetaFlight, Emuflight и iNav) могут иметь разные наборы команд и имен.
Если сомневаетесь, вы можете проверить доступные команды с помощью команды «help».
Другие полезные команды в Betaflight
Вот некоторые команды, которые часто использую, и думаю Вам они пригодятся :) Напишите в комментариях какие команды добавить в список.
defaults //сбросить FC на дефолтные настройки и перезагрузить dump //показать настройки конфигурации diff //показать те настройки, которые отличаются от значений по умолчанию. Включает только текущий профиль PID. diff all //показать те настройки, которые отличаются от значений по умолчанию. Включает все профили PID. exit //выйти без сохранения настроек get //получить значение указанной переменной help //список всех команд save //сохранить настройки и перезагрузить FC set //установить значение переменной (name=value) status //показать статус системы version //показать версию bl or dfu //ввести в DFU режим, без нажатия на кнопку. Перезагружает FC в режиме загрузчика bind_rx //активирует режим bind на приемниках SPI для FC со встроенным RX для BF 4.1 и выше bind_rx_spi //То же, что и выше, но для BF 4.0 frsky_bind //то же, что и выше (BF 3.X)
Данная статья переведена с английского языка, первоисточником является oscarliang.com.