Урок 01

Прошивка PteronautOS

Соберите и установите герметичную прошивку на примере приёмника CYCLONE ELRS 2.4GHz 7CH PWM RX.

PteronautOS поддерживает и другие платы приёмников. Общий ESP8285 не делает их распайку одинаковой: открытые GPIO, назначение каналов, соединения для программирования и ревизии PCB могут различаться. Питание и распайка CH2/CH3 ниже относятся к этому примеру CYCLONE; проверьте распиновку вашей платы и поддерживаемую конфигурацию оборудования перед подключением другого приёмника.

Перед подачей питания снимите движущие нагрузки с механизма крыла и убедитесь, что ни один сервопривод не может упереться в жёсткий упор. Прошивка — это электрическая работа; планер должен оставаться механически безопасным на протяжении всей процедуры.

01 · Сборка прошивки

Сначала соберите WebUI — интерфейс, который встраивается в прошивку приёмника. Для этого шага нужны Node.js 20 или новее и npm. Флаг I18N_LOCALES выбирает компилируемые языки; пример ниже включает язык этого руководства плюс английский. Опустите флаг, чтобы включить все 11 языков.

cd src/html && nvm use 20 && I18N_LOCALES=ru,en npm run build:pteronautos

Клонируйте репозиторий, установите PlatformIO и выполните следующую команду из корня репозитория. Проект PlatformIO находится в src; эта команда собирает выделенное окружение приёмника ESP8285 из этого примера.

cd ../.. && pio run -d src -e PteronautOS_ESP8285_2400_RX

02 · Подключение приёмника

Для этого приёмника CYCLONE используйте выход 5 В адаптера FTDI для питания приёмника, а не выход 3,3 В. Его соединения UART находятся на сигнальных выводах каналов 2 и 3 — искать отдельные площадки UART не нужно.

Адаптер FTDI Подключение приёмника
GND GND (−)
5 В / VCC Питание (+)
TX Сигнал CH3 — RX приёмника (GPIO3)
RX Сигнал CH2 — TX приёмника (GPIO1)

Настройка 5 В относится к питанию приёмника. Проверьте документацию адаптера: TX/RX должны использовать совместимую с ESP8285 логику 3,3 В, даже если выход питания 5 В. Не подключайте одновременно второй источник питания.

03 · Вход в загрузчик

Удерживайте BOOT (GPIO0), отключите и снова подключите USB-кабель FTDI, удерживайте BOOT около секунды, затем отпустите. Скрипт прошивки не выполняет автоматический сброс, поэтому войдите в загрузчик вручную перед его запуском.

04 · Запись образа

Из корня репозитория запустите предоставленный скрипт прошивки. Он собирает WebUI и прошивку с выбранным языком, находит рабочий инструмент прошивки из PlatformIO и собранную прошивку, выбирает последовательный порт и записывает образ с нужными настройками flash.

Флаг --lang ниже напрямую встраивает язык этого руководства. Опустите его, чтобы выбрать интерактивно — все языки, набор или пропуск пересборки.

./scripts/flash.sh --lang ru

Автовыбор порта ищет устройства macOS /dev/cu.*. Если подключено несколько последовательных устройств или вы используете другую ОС, явно укажите порт адаптера приёмника. Замените пример ниже на фактический путь вашего устройства.

./scripts/flash.sh --lang ru --port /dev/cu.usbserial-XXXX

Чтобы проверить связь с загрузчиком без записи прошивки, используйте опциональный режим проверки. При сбое повторите цикл питания BOOT перед повторной попыткой.

./scripts/flash.sh --port /dev/cu.usbserial-XXXX --check

05 · Проверка установки

Перезапустите приёмник, не удерживая BOOT. Убедитесь, что его точка доступа WiFi и WebUI стали доступны (SSID: Pteronaut OS , пароль: flynatural ), затем загрузите конфигурацию и проверьте имя таргета перед повторным подключением сервоприводов.

Продолжите со страница «Аппаратура» для карт выводов и примечаний по распайке для конкретной ревизии.