Урок 1. Введение: CLI INAV и вкладки Configurator … ↩
mod. Суббота, 17 октября 2026 22:37 . См. 5
Курс CLI · INAV firmware 9.1.0 · урок 1 из 13
Цель курса — научиться читать, проверять и документированно менять настройки INAV через CLI. Последовательность и учебный формат повторяют прежний курс CLI, но команды, параметры, примеры и выводы здесь относятся только к INAV 9.1.0.
Что такое CLI в INAV
CLI (Command Line Interface) — текстовый интерфейс прошивки. Через него можно просматривать состояние и настройки, выполнять поддерживаемые команды, готовить резервную копию и менять часть конфигурации. INAV Configurator предоставляет графические вкладки и отдельную вкладку CLI; изменения в GUI и CLI должны проверяться по одной и той же прошивке и одному подключённому контроллеру.
Для внешнего терминала документация INAV 9.1.0 описывает подключение к CLI-порту (обычно это MSP-порт) с baud rate, заданной для MSP; затем в терминале отправляется символ #. В Configurator достаточно открыть вкладку CLI. CLI доступен не на любой произвольной последовательной линии: сначала проверяют назначение UART и фактическую конфигурацию.
Во внешнем терминале отправьте один символ #, чтобы войти в CLI, затем используйте команды чтения:
help
version
status
exitЭтот пример содержит команды просмотра и выхода. help показывает доступные команды конкретной сборки; список может зависеть от платы и параметров сборки. version сообщает версию и target, status — текущий статус, exit покидает CLI без сохранения несохранённых изменений. Не записывайте в учебный отчёт вымышленные строки вывода — снимайте их с реального стенда.
Как курс связан с вкладками INAV Configurator 9.1.0
Это карта учебного покрытия, а не утверждение, что все страницы одинаково доступны на каждой плате. Набор и видимость зависят от прошивки, функций и режима работы Configurator.
| Вкладка / группа вкладок INAV | Где рассматривается в курсе | Связь с CLI |
|---|---|---|
| Setup | Уроки 1, 4 и 10 | Статус и причины блокировки сопоставляются с status и документированными параметрами; визуальные калибровки не заменяются произвольными командами. |
| Ports | Урок 3 | serial отображает назначения функций и скорости портов; конкретные UART сверяются с target и схемой платы. |
| Configuration | Уроки 4 и 8 | Функции и параметры проверяются командами feature, get, set; батарейные измерения разбираются отдельно. |
| Receiver, Receiver MSP | Урок 5 | Провайдер, карта каналов и телеметрический путь проверяются средствами INAV. |
| Auxiliary (Modes), Adjustments | Урок 6 | Режимы и диапазоны — команды aux и adjrange; доступные режимы зависят от платформы и условий допуска. |
| PID Tuning, Advanced Tuning | Урок 7 | PID, rates и связанные параметры; не переносить имена или шкалы из других прошивок. |
| Mixer | Урок 4 | Тип платформы и микшер; CLI включает mmix, smix, servo и связанные команды, только если они доступны конкретной сборке. |
| Outputs | Урок 9 | Моторные/серво-выходы, протоколы, ресурсы и тестирование с отдельными мерами безопасности. |
| Failsafe | Урок 10 | Проверка сценариев по failsafe_procedure и параметрам навигационного возврата. |
| GPS, Mission Control, Landing | Уроки 10 и 13 | GPS и параметры навигации имеют CLI-представление; планирование миссий и часть действий выполняются в специализированном GUI. Для точек маршрута INAV 9.1.0 документирует команду wp. |
| OSD | Урок 11 | osd_layout и параметры osd_*; видеосистема и доступные поля зависят от OSD-пути. |
| LED Strip | Урок 12 | led, feature LED_STRIP и цвета; адресные светодиоды не равны общей функции LIGHTS. |
| Onboard Logging, Logging | Урок 13 | Blackbox и носитель проверяются по доступным функциям/параметрам. Наличие вкладки не доказывает, что конкретная плата имеет поддерживаемое хранилище. |
| CLI | Уроки 1–13 | Основной интерфейс курса. |
| Calibration, Magnetometer, Sensors | Уроки 1, 4 и 13 | Часть отображает измерения или запускает калибровочные действия; у них нет универсальной безопасной CLI-команды-замены. |
| Firmware Flasher, Options, Search | Уроки 1–2 | Сервисные интерфейсы; перед обновлением нужен backup. Поиск в Configurator не является командой CLI. |
| Programming, JavaScript Programming, SITL, Debug Trace | Отмечены как расширенные/диагностические средства в уроках 1 и 13 | Не являются обычными вкладками настройки базового полёта. Для них нельзя придумывать универсальные CLI-эквиваленты. |
Справочник: CLI-связь каждой страницы Configurator 9.1.0
Названия ниже — модули вкладок из исходников Configurator tag 9.1.0. Команда может отсутствовать в сборке конкретного target; перед выполнением всегда сверяйтесь с help. «Нет прямой CLI-команды» означает, что нельзя заменять действие графического экрана случайно выбранным CLI-параметром.
| Вкладка (имя модуля) | CLI-команды / настройки INAV 9.1.0 | Примечание |
|---|---|---|
setup | version, status | Статус и блокировки можно сопоставить; 3D-модель/визуализация GUI не имеет прямой CLI-копии. |
ports | serial, help serial | Команда serial без аргументов выводит текущую конфигурацию. |
configuration | feature, get, set | Читать/менять только имена и значения из Settings tag 9.1.0. |
receiver | map, rxrange, get serialrx_provider, status | Порт и проводка отдельно проверяются через serial и схему платы. |
receiver_msp | map, status; bind_msp_rx только при поддерживаемом MSP receiver (mLRS) | Не является синонимом обычного RX_SERIAL. |
auxiliary | aux | Настройка ranges режимов; изучить help aux. |
adjustments | adjrange, при необходимости gvar | Adjustment не тождественна режиму. |
pid_tuning | pid, get, set | Подробности и точные переменные — в INAV PID/Settings docs. |
advanced_tuning | get, set для точных документированных settings | Общий экран не означает, что у каждого поля очевидное CLI-имя. |
mixer | get platform_type, mmix, smix, servo | Пользовательский mixer меняет назначение выходов; не копировать строки без схемы. |
outputs | resource, timer_output_mode, get motor_pwm_protocol, servo | Фактический target и таймеры задают, какие значения допустимы. |
failsafe | get failsafe_procedure, get failsafe_throttle, get nav_rth_alt_mode, get nav_rth_altitude | Чтение не доказывает корректность GPS, home point или сценария. |
gps | serial, status, get gps_provider, get gps_ublox_nav_hz, get gps_ublox_use_galileo, get gps_ublox_use_beidou | Параметры провайдера применимы только к фактическому GPS/target. |
mission_control | wp, safehome | Команды работают с waypoints/safehomes; план в GUI и реальная навигационная проверка остаются обязательными. |
landing | get nav_rth_allow_landing, get nav_landing_bump_detection, get nav_emerg_landing_speed | Параметры зависят от платформы и сценария; использовать соответствующие Landing/Navigation docs. |
osd | osd_layout, get osd_video_system | CLI layout и доступность элементов зависят от аналогового/цифрового тракта. |
led_strip | feature, led, color, mode_color | Это адресная LED strip; generic LIGHTS — отдельная функция. |
onboard_logging | blackbox, get blackbox_device, sd_info (если команда доступна) | Проверить фактический носитель/target, а не только UI. |
logging | blackbox, get blackbox_device, status | Обработка/просмотр файла журнала и запись на FC — разные задачи. |
cli | Все команды, перечисленные в help | Синтаксис и доступность зависят от сборки. |
calibration | Универсального безопасного CLI-эквивалента калибровке GUI нет | Выполнять процедуру через соответствующую вкладку и документацию датчика. |
magnetometer | status может показать состояние; универсальной CLI-команды калибровки нет | Не смешивать калибровку, механическую ориентацию и offset. |
sensors | status, tasks — статус/задачи, но не графическая визуализация датчиков | Набор данных зависит от target/сборки. |
firmware_flasher | version; dfu — переход в DFU при перезапуске | CLI не прошивает firmware; обновление выполняется штатным flasher после backup. |
options | Нет команды FC CLI | Это настройки приложения Configurator, а не конфигурация контроллера. |
search | Нет команды FC CLI | Поиск — функция интерфейса Configurator. |
programming | logic, gvar — там, где используется соответствующий INAV Programming Framework | Проверить доступность и документацию; GUI-программу нельзя автоматически переводить в CLI. |
javascript_programming | Нет универсального CLI-эквивалента; отдельные logic/gvar настройки — только по framework docs | Это специальный программируемый интерфейс Configurator, не стандартная настройка CLI. |
sitl | Нет команды физического FC CLI, эквивалентной управлению симулятором | Параметры SITL относятся к приложению/симуляции. |
debug_trace | Нет универсальной команды CLI-замены этому экрану | Диагностический trace не следует включать случайными debug-параметрами. |
Рабочий порядок и безопасность
- Запишите, какая версия firmware и Configurator подключена, а также точную маркировку платы.
- Сначала выполняйте только команды чтения; сохраняйте оригинальный вывод в текстовый файл с датой и названием стенда.
- Сверяйте каждое имя команды/параметра с документацией tag
9.1.0и, где нужно, с target/схемой платы. - Перед любым изменением сохраните backup, изменяйте по одному обоснованному пункту и фиксируйте его источник.
- Команда
saveсохраняет настройки и перезагружает контроллер. Не вводите её автоматически после чтения.
Курс — черновик для последующих авторских правок: замечания к названиям, порядку, глубине и примерам можно вносить по мере прохождения. Каждая статья должна оставаться INAV-специфичной.
Контрольные вопросы
- Что делает
#при подключении внешнего терминала, и для чего используютсяhelp,versionиstatus? - Какие вкладки INAV 9.1.0 имеют явное CLI-представление, а какие выполняют визуальную калибровку/диагностику без универсальной CLI-команды?
- Почему отсутствие отдельной вкладки Battery, Motors или VTX не означает, что соответствующие настройки отсутствуют?
Официальные источники INAV 9.1.0
- мод. : Суббота, 17 октября 2026