Все статьи · Все уроки · Материалы по ArduPilot
Актуально: август 2026 года. Перед подключением реального аппарата сверяйте версию ArduPilot и актуальную документацию проекта.
ArduConfigurator — браузерный конфигуратор для ArduPilot, ориентированный прежде всего на FPV-мультикоптеры. Он позволяет подключить полётный контроллер через USB, синхронизировать параметры, выполнить первичную настройку, откалибровать датчики, проверить приёмник, моторы, порты, failsafe и сохранить резервные копии конфигурации.
Интерфейс работает непосредственно в браузере через Web Serial, а для знакомства с программой предусмотрен демонстрационный режим без подключённого контроллера. Официальная Wiki подчёркивает, что ArduConfigurator дополняет документацию ArduPilot, но не заменяет её: описание параметров, логика настройки и правила первого полёта остаются за ArduPilot Wiki.
По соседней теме: после настройки контроллера пригодятся обзор инструментов ArduPilot, руководство по анализу логов и базовое руководство по настройке ArduPilot.
Официальный сайт ArduConfigurator · официальная Wiki · GitHub проекта
Для каких задач подходит ArduConfigurator
Программа закрывает типичный цикл настройки аппарата:
- подключение к контроллеру через Serial/USB;
- работа через WebSocket-мост или встроенный Demo Mode;
- первоначальная настройка ArduCopter, ArduPlane, Rover и Sub;
- синхронизация таблицы параметров;
- настройка портов, GPS, приёмника и периферии;
- конфигурация режимов полёта и failsafe;
- калибровка акселерометра, уровня, компаса, напряжения и тока;
- настройка OSD, VTX, CAN и DroneCAN;
- изменение PID, фильтров и параметров управления;
- сохранение snapshots, presets и резервных копий;
- загрузка DataFlash-логов и просмотр MAVLink-потоков;
- прошивка контроллера.
⚠️ Конфигуратор проверяет настройки и состояние контроллера, но не подтверждает лётную годность аппарата. Перед любым запуском необходимо отдельно проверить механику, направление вращения моторов, тягу, питание, радиоканал и failsafe.
Что требуется для подключения
Для подключения к реальному полётному контроллеру понадобятся:
- контроллер с установленным ArduPilot;
- качественный USB-кабель с линиями данных;
- браузер на базе Chromium — Chrome, Edge, Brave или Opera;
- защищённое HTTPS-соединение;
- стабильное питание компьютера и контроллера.
Web Serial не поддерживается Firefox и Safari. Если браузер не показывает режим Serial / USB, можно использовать десктопную версию или Demo Mode. Подробные условия подключения описаны в разделе Getting Connected.
| Режим | Назначение |
|---|---|
| Demo (Copter) | Знакомство с интерфейсом без оборудования |
| Demo (Plane) | Демонстрация функций ArduPlane |
| Serial / USB | Подключение реального контроллера по USB |
| WebSocket | SITL, replay или локальный MAVLink-мост |
Первый запуск: Demo Mode
Перед подключением реального аппарата удобно выбрать Demo (Copter) или Demo (Plane). Программа загружает встроенный тестовый контроллер, поэтому можно открыть вкладки, Guided Setup, инспекторы, настройки портов и калибровки без риска изменить настоящие параметры.
На демонстрационном экране Plane отображаются тип аппарата, версия ArduPilot, количество параметров, уровень заряда, состояние GPS, дальномера, RC-каналов и предварительных проверок.
В правой части экрана находятся карточки System Info и Instruments. В них можно быстро увидеть:
- тип транспортного средства;
- версию прошивки;
- состояние синхронизации параметров;
- напряжение и заряд батареи;
- количество RC-каналов;
- RSSI;
- режим полёта;
- состояние pre-arm;
- текущие roll, pitch и heading.
Это полезнее, чем сразу открывать дерево параметров: сначала видно общее состояние системы, а затем уже можно переходить к отдельной подсистеме.
Подключение реального контроллера
Порядок подключения:
- Снимите пропеллеры.
- Подключите полётный контроллер к компьютеру по USB.
- В верхнем меню выберите Serial / USB.
- Нажмите Connect.
- В системном окне выберите порт контроллера.
- Дождитесь определения MAVLink и полной синхронизации параметров.
Некоторые платы ArduPilot показывают два последовательных USB-порта. Один может использоваться для MAVLink, другой — для консоли или SLCAN. ArduConfigurator проверяет наличие heartbeat и старается автоматически выбрать рабочий MAVLink-порт. Если соединение не установилось, отключите контроллер и повторите подключение, выбрав другой порт.
После подключения не переходите сразу к изменению параметров. Дождитесь сообщения о завершённой синхронизации. Если связь оборвалась во время загрузки, программа сохраняет уже полученные данные и после восстановления соединения продолжает синхронизацию.
Status & Info: контроль состояния аппарата
Вкладка Status & Info — это не просто стартовый экран. Здесь собраны диагностические карточки:
- Craft View — положение и ориентация аппарата;
- GPS;
- Rangefinder;
- Optical Flow;
- Pre-arm;
- Statistics;
- Recent Notices;
- System Info;
- Instruments;
- Guided Setup.
На скриншоте Plane хорошо видно важное преимущество такого подхода: программа показывает не только наличие датчика, но и качество его фактической работы. Например, Rangefinder может быть настроен, но не передавать данные. Optical Flow может быть выбран через DroneCAN, но фактически не иметь сообщений в телеметрии.
⚠️ Статус «configured» не равен статусу «работает». Для каждого датчика нужно проверять наличие живых сообщений, актуальность времени последнего пакета и отсутствие предупреждений.
Guided Setup — основной маршрут первичной настройки
Для нового аппарата рекомендуется использовать Guided Setup. Это пошаговый мастер, который проверяет каждый этап по живым данным от контроллера.
Типовой порядок:
- Vehicle Link — соединение и синхронизация параметров.
- Airframe / Ports — тип аппарата и назначение последовательных портов.
- Sensors — акселерометр, компас и уровень.
- Radio / Receiver — каналы, диапазон и направления стиков.
- Outputs / Motors — протокол ESC, порядок и направление моторов.
- Battery — монитор напряжения и тока.
- Failsafe — реакция на потерю RC-сигнала и проблемы питания.
- Verify — итоговая проверка перед первым запуском.
Точный набор шагов зависит от типа аппарата и возможностей прошивки. В ArduPlane часть пунктов может отличаться от ArduCopter.
Мастер показывает не только кнопку «продолжить», но и:
- критерии завершения;
- фактические данные от контроллера;
- невыполненные проверки;
- следующий рекомендуемый шаг;
- кнопки перехода к нужной вкладке.
Особенно важна проверка направления каналов. Если roll, pitch, yaw или throttle работают в обратную сторону, Guided Setup не должен считаться завершённым.
Подробное описание находится в Guided Setup Wiki.
Ports & Peripherals: настройка UART и периферии
Вкладка Ports & Peripherals показывает последовательные порты в виде матрицы. Для каждого UART можно выбрать:
- функцию порта;
- скорость baud rate;
- аппаратный flow control;
- дополнительные Serial Options;
- параметры Bitmask.
На примере видно:
- USB / Console настроен на MAVLink2;
- USART1 используется под GPS;
- USART2 назначен для SmartAudio;
- изменения собраны в отдельный блок Staged Changes;
- запись выполняется кнопкой Apply Port Changes.
⚠️ Не копируйте такую конфигурацию на другой контроллер без проверки распиновки и документации оборудования. Номер UART, физический разъём, инверсия, назначение TX/RX и поддерживаемая скорость зависят от конкретной платы.
После изменения портов обязательно проверьте:
- GPS fix;
- телеметрию;
- приёмник;
- VTX-команды;
- DroneCAN-периферию;
- отсутствие конфликтов между устройствами.
Receiver, Modes и Failsafe
Вкладка Receiver предназначена для проверки радиоканала:
- наличие живых RC-каналов;
- соответствие каналов функциям;
- положение центра;
- диапазон PWM;
- направление стиков;
- переключатели режимов.
Перед полётом нужно убедиться, что:
- throttle уменьшается до безопасного минимума;
- roll и pitch реагируют в правильную сторону;
- yaw не перепутан;
- переключатель режима действительно выбирает ожидаемый режим;
- failsafe активируется при выключении передатчика.
Вкладка Modes используется для назначения режимов полёта на каналы передатчика. Failsafe должен проверяться отдельно для радиосигнала, батареи и, если используется, GPS/навигации.
⚠️ Никогда не проверяйте направление моторов с установленными пропеллерами. Для всех стендовых проверок пропеллеры должны быть сняты.
Calibration: датчики, уровень, батарея и ESC
На странице собраны несколько разных процедур.
Accelerometer
Калибровка акселерометра выполняется в шести положениях. Контроллер нужно неподвижно удерживать в каждом положении, указанном программой.
Не ставьте аппарат на мягкую поверхность и не выполняйте процедуру на вибрирующем столе. После завершения проверьте показания горизонта в Craft View.
Level
Калибровка уровня компенсирует небольшое отклонение при установке платы. Она не исправляет неправильно выбранную ориентацию контроллера. Сначала в Config нужно убедиться, что AHRS_ORIENTATION соответствует фактическому монтажу платы.
Compass
Компас калибруется вдали от металлического стола, силовых проводов, динамиков, магнитных креплений и работающих двигателей.
Внешний компас должен быть установлен с правильной ориентацией относительно корпуса. После калибровки нужно проверить, что heading меняется ожидаемо и не вращается самопроизвольно.
Battery voltage
Сначала измерьте напряжение мультиметром непосредственно на силовой линии. Затем введите измеренное значение в поле калибровки.
Не используйте для калибровки значение с зарядного устройства или маркировки аккумулятора. Важна фактическая величина, измеренная на входе контроллера.
Battery current
Для калибровки тока необходимо сравнить показания контроллера с эталонным измерением под стабильной нагрузкой. На снимке интерфейс отдельно просит указать нагрузку и подтверждение безопасности.
ESC calibration
В интерфейсе указано, что процедура предназначена для калибровки конечных точек PWM ESC. Перед ней необходимо:
- снять пропеллеры;
- освободить рабочую зону;
- закрепить аппарат;
- исключить случайное включение моторов;
- повторно подключиться после перезагрузки.
Не переносите эту процедуру автоматически на DShot и другие цифровые протоколы. Проверяйте тип ESC и рекомендации ArduPilot для конкретной силовой установки.
Config и Expert Mode
Вкладка Config группирует основные настройки по категориям:
- Airframe;
- Sensors;
- GPS;
- RC & Arming;
- System.
Изменения сначала сохраняются как локальный staged draft. Контроллер не меняется до нажатия Apply Config. Это позволяет просмотреть подготовленные значения и отменить ошибочные правки через Revert.
Expert Mode открывает прямую работу с деревом параметров. Он полезен для опытного пользователя, но опаснее продуктовых вкладок: здесь легче изменить взаимосвязанные параметры без понимания последствий.
Перед серьёзными изменениями следует:
- синхронизировать параметры;
- создать snapshot;
- сохранить резервную копию;
- изменить одну логически связанную группу;
- проверить diff;
- применить изменения;
- перезагрузить контроллер, если это требуется;
- повторно проверить состояние аппарата.
Официальная Wiki описывает snapshots, presets, импорт и экспорт в разделе Parameters.
Tuning: PID, фильтры и AutoTune
Вкладка Tuning объединяет настройки, которые обычно приходится искать в большом дереве параметров:
- реакция на стики;
- угол наклона;
- rate-контроллеры;
- P, I, D и feedforward;
- фильтры;
- профили;
- AutoTune;
- анализ логов.
Изменения также проходят через staged draft и review.
AutoTune нельзя запускать на стенде. Это полётная процедура, во время которой аппарат выполняет тестовые движения. Перед запуском необходимо:
- сохранить рабочий snapshot;
- выбрать безопасное открытое место;
- убедиться в исправности питания и радиолинии;
- настроить режим аварийного прекращения;
- обеспечить высоту и пространство для манёвра.
⚠️ Не пытайтесь компенсировать механические проблемы увеличением P или D. Вибрации, люфты, неправильный баланс, слабое питание и неверный фильтр сначала устраняются физически и диагностически.
Подробнее: Tuning Wiki.
Logs, MAVLink Inspector и DroneCAN
После полёта вкладка Logs позволяет получить DataFlash-логи с контроллера. В зависимости от возможностей платы используются MAVFTP или классический механизм LOG_REQUEST.
Логи полезны для проверки:
- вибраций;
- ошибок EKF;
- просадок питания;
- работы GPS;
- реакции failsafe;
- поведения PID;
- фактического выходного сигнала на моторы;
- качества RC- и MAVLink-связи.
Expert Mode добавляет MAVLink Inspector — просмотр входящих и исходящих сообщений, частоты, пропусков, bandwidth и отдельных полей.
Для устройств DroneCAN программа предоставляет отдельную вкладку CAN и экспертный DroneCAN Inspector. Он показывает узлы, состояние, параметры и ESC-телеметрию. При изменении параметров периферии важно помнить, что запись и сохранение на CAN-узле могут быть отдельными операциями.
Источники: Logs & Inspectors и CAN & DroneCAN.
Прошивка и вкладка Flash
ArduConfigurator поддерживает работу с прошивками ArduPilot и загрузчиком. Но прошивка — отдельная рискованная процедура.
Перед ней нужно проверить:
- точную модель платы;
- тип прошивки;
- совместимость периферии;
- резервную копию параметров;
- стабильность USB-соединения;
- уровень питания;
- возможность восстановить контроллер при сбое.
Не отключайте USB и питание во время записи. После прошивки параметры необходимо загрузить заново, проверить версию, выполнить обязательные калибровки и повторно пройти pre-arm проверки.
Практический порядок настройки нового FPV-аппарата
Оптимальный порядок работы выглядит так:
- Снять пропеллеры.
- Подключить контроллер и дождаться полной синхронизации.
- Сохранить исходный snapshot.
- Проверить тип рамы и ориентацию платы.
- Настроить порты.
- Настроить приёмник и проверить направления каналов.
- Назначить режимы.
- Настроить выходы и протокол ESC.
- Выполнить калибровку акселерометра, уровня и компаса.
- Настроить монитор батареи.
- Настроить failsafe.
- Проверить моторы без пропеллеров.
- Проверить GPS, дальномер, optical flow и периферию.
- Убедиться, что pre-arm не содержит ошибок.
- Выполнить короткий наземный тест.
- Провести первый полёт в безопасном режиме.
- Скачать лог и проверить его после посадки.
Итог
ArduConfigurator удобен тем, что переводит настройку ArduPilot из набора разрозненных параметров в последовательный рабочий процесс. Новичку помогает Guided Setup, опытному пилоту — Config, Tuning, Expert Mode, snapshots, логи и инспекторы.
Главное преимущество программы — связь между действием и проверяемым результатом: недостаточно выбрать GPS, порт или датчик, нужно увидеть живые данные и убедиться, что система действительно работает.
При этом ArduConfigurator не отменяет базовые правила ArduPilot: резервные копии перед изменениями, проверка параметров, снятые пропеллеры на стенде, контроль failsafe и обязательная проверка логов после полёта.