Урок 1 из 13 · Модуль 1. Введение: что такое CLI и как в него попасть #

Betaflight без GUI · Урок 1 из 13 · Модуль 1. Основы CLI

Что такое командная строка Betaflight, как подключиться к полётнику без конфигуратора и освоить базовые команды get, set, feature, save.

CLI — это не урезанная альтернатива конфигуратору, а его «движок». Освоив вход и базовые команды, вы получаете доступ к каждому параметру полётника.

Содержание

1. Цели урока

После этого урока вы будете понимать:

что такое CLI и где он живёт
как подключиться к полётнику без конфигуратора
базовые команды: help, version, get, set
разницу между параметрами, фичами и командами-конфигураторами

↑ К оглавлению

2. Что такое CLI в Betaflight

CLI (Command Line Interface, командная строка) — текстовый интерфейс, встроенный в прошивку полётного контроллера. Через него можно прочитать и изменить любой параметр Betaflight.

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

↑ К оглавлению

3. Как попасть в CLI без конфигуратора

Нужен обычный терминал последовательного порта. По USB полётник виден компьютеру как COM-порт (Windows) или /dev/ttyACM0, /dev/ttyUSB0 (Linux/macOS).

Подключите полётник по USB.
Откройте терминал на этом порту со скоростью 115200 бод.
Если полётник работает, наберите символ # и нажмите Enter.

Примеры запуска терминала:

Система	Команда
Windows (PuTTY)	Connection type = Serial, Speed = 115200
Linux	`screen /dev/ttyACM0 115200`
macOS	`picocom -b 115200 /dev/ttyACM0`

PuTTY (Windows) — по шагам:

Скачайте PuTTY с официального сайта и запустите. Выберите Connection type: Serial.
В поле Serial line укажите COM-порт полётника. Его номер виден в «Диспетчере устройств → Порты (COM и LPT)» после подключения платы по USB — обычно COM3 и выше.
Задайте Speed: 115200 и нажмите Open.
В открывшемся чёрном окне нажмите Enter, затем введите символ # и снова Enter.

Если порт не появился в списке — драйвер STM32/CP210x не установлен: поставьте его, затем перезапустите PuTTY.

После ввода # появится приглашение:

Entering CLI Mode, type 'exit' to return, or 'help'

#

Подсказка: Иногда нужно нажать Enter пару раз, чтобы увидеть приглашение #.

↑ К оглавлению

4. Базовые команды

Начните с безопасных команд, чтобы освоиться:

Команда	Что делает
`help`	Список всех команд CLI
`version`	Версия прошивки и информация о полётнике
`status`	Текущее состояние: арм, профили, температура
`get <имя>`	Значение параметра(ов); `get` без аргумента — все
`set <имя> = <значение>`	Изменить параметр
`diff all`	Отличия от заводских настроек (ваш бэкап)
`dump all`	Полная конфигурация целиком
`save`	Сохранить изменения и перезагрузить
`defaults`	Сбросить всё к заводским (стирает настройки)
`exit`	Выйти из CLI в режим полёта

Попробуйте прямо сейчас:

# version
# status
# get small_angle

get с частью имени показывает все подходящие параметры. Для первого опыта берите числовой параметр — они одинаково работают во всех версиях прошивки и не зависят от раскладки клавиатуры:

# set small_angle = 25
# save

После save полётник перезагрузится. Проверьте: get small_angle.

get и set ищут по-разному: get ＜часть имени＞ ищет подстроку без учёта регистра, поэтому get name покажет и craft_name, и osd_craft_name_pos, и pilot_name. А set требует точного имени: любой лишний символ — пробел, табуляция, кириллическая «с» вместо латинской — и вы получите ###ERROR IN set: INVALID NAME: .... Правило: найдите имя через get и скопируйте его из вывода, а не перепечатывайте вручную.

Имя аппарата

Имя задаётся строковым параметром craft_name: только латиница и цифры, до 16 символов. У строковых параметров пробелы вокруг = лучше не ставить:

# set craft_name=MOI_DRONE
# save

Как отличить строковый параметр: Имя аппарата и pilot_name — строковые параметры: они хранят текст, а не число. В выводе get это видно сразу: вместо диапазона значений печатается String length: 1 - 16, то есть длина текста от 1 до 16 символов. Если get craft_name параметр показывает, а set отвечает ###ERROR IN set: INVALID NAME: craft_name — дело не в команде, а в самой прошивке: она собрана некорректно или устарела. Пересоберите или обновите её. Как временный обход: задайте имя в конфигураторе на вкладке Configuration (поле Craft name) — на полёт имя не влияет, это только подпись на экране OSD.

Имена параметров меняются между версиями: В Betaflight 4.4 и новее имя аппарата — параметр craft_name, в 4.3 и старше он назывался просто name. Поэтому на свежей прошивке команда set name = MOI_DROON возвращает ###ERROR IN set: INVALID NAME: name. По той же причине вместо gyro_lowpass_hz пишут gyro_lpf1_static_hz, вместо battery_capacity — bat_capacity, вместо current_meter_scale — ibata_scale. Не угадывайте имя: найдите его маской (get lowpass, get capacity, get ibat), а версию прошивки покажет version.

↑ К оглавлению

5. Три понятия, без которых дальше никуда

Параметры (set / get)

Вся настройка Betaflight — это сотни параметров с именами вида p_pitch, vbat_min_cell_voltage, osd_vbat_pos. Их читают через get, меняют через set. get поддерживает маску: get osd покажет все параметры с osd в имени.

Фичи (feature)

«Фичи» — крупные включатели подсистем: OSD, GPS, LED-лента, AIRMODE. Они либо есть, либо нет.

# feature           ＜- список и состояние
# feature OSD       ＜- включить
# feature -OSD      ＜- выключить

Команды-конфигураторы

Кроме set, есть отдельные команды для сложных структур: serial (порты), aux (режимы), led (лента), resource (выводы микроконтроллера). Их разберём в соответствующих уроках.

↑ К оглавлению

6. Правила безопасности

Всегда делайте diff all и сохраняйте вывод перед изменениями.
Помните про save: до него изменения живут только в памяти.
defaults необратимо сбрасывает настройки.
Настройку моторов и тесты проводите без пропеллеров.

↑ К оглавлению

7. Проверьте себя

Сформулируйте ответ своими словами, прежде чем сверяться со справочником ответов (последняя статья курса).

Чем CLI отличается от графического конфигуратора и почему через CLI можно сделать то же самое?
С какой скоростью открывается порт при подключении к полётнику по USB?
Чем set/get отличаются от feature?
Почему без save изменения не сохраняются?

↑ К оглавлению