Перейти к содержимому
4

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

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).

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

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

СистемаКоманда
Windows (PuTTY) Connection type = Serial, Speed = 115200
Linux screen /dev/ttyACM0 115200
macOS picocom -b 115200 /dev/ttyACM0
PuTTY (Windows) — по шагам:
  1. Скачайте PuTTY с официального сайта и запустите. Выберите Connection type: Serial.
  2. В поле Serial line укажите COM-порт полётника. Его номер виден в «Диспетчере устройств → Порты (COM и LPT)» после подключения платы по USB — обычно COM3 и выше.
  3. Задайте Speed: 115200 и нажмите Open.
  4. В открывшемся чёрном окне нажмите Enter, затем введите символ # и снова Enter.

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

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

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

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

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

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

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

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

# version
# status
# get name
Plain text

get name покажет имя аппарата (по умолчанию пустое). Зададим его:

# set name = MOI_DROON
# save
Plain text

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

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

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      ＜- выключить
Plain text

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

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

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

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

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

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

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

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

8. Чек-лист самопроверки

  • Открыл CLI через терминал, а не через конфигуратор
  • Выполнил version и увидел версию Betaflight
  • Различаю set и feature
  • Умею сохранять изменения через save
  • Понимаю, зачем нужен diff all
Результат: Все пункты выполнены — переходите к следующему уроку.
↑ К оглавлению

9. Что дальше

  • Следующий урок: 2. Конфигурация: diff / dump / defaults / save
  • Полный перечень тем — в статье «Содержание курса».
↑ К оглавлению
  • мод. : Среда, 26 августа 2026