Быстрый старт

Раздел объединяет подготовку квадрокоптера, бортовую систему Pioneer OS, сервис Pioneer Code и подключение по SSH. Для Пионера Мини 2 операционная система предустановлена — отдельная установка не требуется.

Быстрый старт

Перед использованием квадрокоптера выполните его подготовку к полетам, изучите управление и инструкции по эксплуатации.

Выполните подготовку квадрокоптера

  1. Сборка. Пионер Мини 2 поставляется собранным; проверьте затяжку винтов, установите и зафиксируйте воздушные винты, наденьте защиту и верхнюю крышку. Для Пионера Базового сборка — отдельный этап (см. Пионер Базовый).
  2. Обновите прошивку автопилота. Актуальная прошивка и порядок обновления публикуются в официальной документации Geoscan. Обновление выполняется через конфигуратор Pioneer Station 2. Подробнее — в уроке «Калибровка и обслуживание».
  3. Загрузите параметры автопилота. Параметры зависят от способа управления (пульт / Jump 2 / Python) и загружаются тем же конфигуратором. Несовпадение параметров и способа управления — частая причина нестабильного полета.

Выберите способ управления

  • FlySky i6S — классический пульт радиоуправления (с приёмником FS-A8S).
  • Jump 2 — мобильное приложение для Android: блочное программирование, полет и трансляция изображения (см. Блочное ПО).
  • Python — удалённое управление через библиотеку pioneer_sdk2 (см. Способы запуска программы и Pioneer SDK 2).

Ознакомьтесь с инструкциями по эксплуатации

Работа с зарядным устройством

В Пионере Мини 2 используется литий-полимерный (Li-Po) аккумулятор. Заряжайте его только штатным зарядным устройством, не оставляйте процесс без присмотра, не разряжайте «в ноль» и храните при напряжении хранения. Полные правила и пороги — в уроке «Аккумулятор и зарядка».

Требования воздушного кодекса

Полеты БВС в России регулируются Воздушным кодексом РФ и подзаконными актами: беспилотники массой до 30 кг подлежат учёту, действуют ограничения вблизи аэропортов, над населёнными пунктами, объектами и массовыми мероприятиями. Перед полетом убедитесь, что вы не нарушаете действующие правила. Кратко — в уроке «Безопасность и регламенты».

Общие рекомендации

  • Летайте в закрытом помещении или на площадке без людей и препятствий.
  • Перед каждым полетом проверяйте винты, заряд АКБ и отсутствие посторонних предметов в зоне взлета.
  • Начинайте с режимов удержания высоты и позиции, переходите к ручному управлению постепенно.
  • Не ловите коптер руками и не приближайтесь к вращающимся винтам.

Выполните первый полет

Включите коптер, дождитесь готовности автопилота (индикация и отсутствие ошибок), взлетите в режиме удержания высоты, удержите коптер в точке и выполните штатную посадку. Предполетный чек-лист и аварийные процедуры — в уроке «Безопасность и регламенты».

Быстрый старт завершен!

Документация содержит множество других инструкций, описание модулей, программного обеспечения, примеров программирования и проектов.

Если у вас есть замечания или предложения по улучшению документации, напишите нам на support@geoscan.ru

Описание

Pioneer OS — Linux-система на базе Ubuntu 24.04. Главные особенности — поддержка библиотеки Pioneer-SDK2 на языке Python и сервиса Pioneer Code.

  • Pioneer Code — инструменты блочного и текстового программирования, управления медиафайлами и работы с моделями искусственного интеллекта.
  • PioNet — инструмент для работы с Wi-Fi сетью: позволяет задать имя и пароль, а также переключить режим работы (см. Сеть и PioNet).

Поддержка Pioneer OS и сервиса Pioneer Code квадрокоптерами Пионер

КвадрокоптерМодульPioneer CodeВычисления на борту
Пионер Мини 2Дополнительный модуль не требуется✅✅
БазовыйRadxa Zero 3W✅✅
БазовыйPi Zero 2W❌✅ (при подключении по SSH)

Установка

Pioneer OS предустановлена на квадрокоптеры Пионер Мини 2 и не требует дополнительных действий.

Если требуется обновить или восстановить образ операционной системы, воспользуйтесь конфигуратором Pioneer Station 2.

Установка образа на вычислительный модуль (Базовый)

Для Пионера Базового с модулем Radxa Zero 3W или Pi Zero 2W образ записывается на SD-карту:

  1. Скачайте архив с образом Pioneer OS для нужного модуля (Radxa или Pi Zero).
  2. Скачайте и запустите balenaEtcher.
  3. Вставьте SD-карту (не менее 16 ГБ) в компьютер.
  4. Нажмите Flash from file и выберите архив образа.
  5. Нажмите Select target и выберите вашу SD-карту.
  6. Нажмите Flash и дождитесь завершения записи.
  7. Извлеките SD-карту и вставьте её в слот на обратной стороне модуля.
  8. Подключите аккумулятор — начнётся установка. Дождитесь появления Wi-Fi сети: RaZero-(12 символов) для Radxa или PiZero-(12 символов) для Pi Zero (может занять до 10 минут).

Важно: не отключайте питание до появления Wi-Fi сети — иначе образ придётся записать на SD-карту заново.

Pioneer Code

Экосистема приложений операционной системы Pioneer OS объединяет визуальные и текстовые инструменты программирования, сервис управления медиафайлами и работу с моделями искусственного интеллекта.

Поддержка сервисов Pioneer Code в зависимости от оборудования

Квадрокоптер/МодульBricksCodeOSSГалереяМодели ИИ
Пионер Мини 2✅✅✅✅
Radxa Zero 3W✅✅❌✅

Подключение

  1. Включите квадрокоптер и дождитесь появления Wi-Fi сети PMINI2-(12 символов).
  2. Подключитесь к этой сети, пароль geoscan123.
  3. Откройте в браузере http://10.42.0.1:9090/ — портал Pioneer Code.
ПриложениеОписаниеАдрес
BricksБлочное программированиеhttp://10.42.0.1:2020/
CodeOssТекстовое программирование на Python (VS Code)http://10.42.0.1:9999/
ГалереяПросмотр и удаление фото и видеоhttp://10.42.0.1:5000/
Модели ИИРабота с ИИ-моделямиhttp://10.42.0.1:7777/

При подключении по USB-кабелю те же сервисы доступны по адресу 10.42.1.1.

CodeOSS

CodeOSS — текстовая среда программирования на основе VS Code, доступна в составе образа Pioneer OS. Это самый удобный способ запускать Python-скрипты на борту.

Подключение к CodeOSS

  1. Включите квадрокоптер и дождитесь появления Wi-Fi сети PMINI2-(12 символов).
  2. Подключитесь к сети, пароль geoscan123.
  3. Откройте в браузере http://10.42.0.1:9999/.

Рабочая папка на борту — /home/pioneermini/workspace. Порядок запуска программ описан в уроке «Способы запуска программы».

Галерея

Галерея — сервис для просмотра, загрузки и удаления медиафайлов, сохраненных на Пионер Мини 2.

Подключение к Галерее

  1. Включите квадрокоптер и дождитесь появления Wi-Fi сети PMINI2-(12 символов).
  2. Подключитесь к сети, пароль geoscan123.
  3. Откройте в браузере http://10.42.0.1:5000/.

Модели ИИ

Модели ИИ — сервис, который позволяет просматривать, удалять и редактировать описание имеющихся моделей, а также загружать собственные.

Подключение к сервису «Модели ИИ»

  1. Включите квадрокоптер и дождитесь появления Wi-Fi сети PMINI2-(12 символов).
  2. Подключитесь к сети, пароль geoscan123.
  3. Откройте в браузере http://10.42.0.1:7777/.

Загрузка модели

Для загрузки модели воспользуйтесь кнопкой Загрузить модель. Модель должна быть в формате ONNX (аргумент opset=19) и затем сконвертирована в RKNN. Пошагово — в уроке «Свои нейросети на NPU».

Архитектура моделей

При загрузке или редактировании моделей, созданных на основе архитектур, поддерживаемых библиотекой Pioneer_RKNN, необходимо указать название архитектуры, использованной при обучении, например yolov8, yolov8-pose. Если архитектура не поддерживается — укажите custom.

Рекомендации для обучения ИИ-модели

Для обучения модели на компьютере можно воспользоваться рекомендованным набором библиотек и версий. Важно: это версии для среды обучения на ПК, а не установленные на борту коптера.

Библиотека/ВерсияБиблиотека/ВерсияБиблиотека/ВерсияБиблиотека/Версия
certifi==2022.12.7charset-normalizer==2.1.1colorama==0.4.6polars-runtime-32==1.38.1
contourpy==1.3.3cycler==0.12.1filelock==3.20.0protobuf==6.33.5
flatbuffers==25.12.19fonttools==4.61.1fsspec==2025.12.0psutil==7.2.2
idna==3.4Jinja2==3.1.6kiwisolver==1.4.9pyparsing==3.3.2
MarkupSafe==2.1.5matplotlib==3.10.8ml_dtypes==0.5.4python-dateutil==2.9.0.post0
mpmath==1.3.0networkx==3.6.1numpy==2.3.5PyYAML==6.0.3
onnx==1.20.1onnxruntime==1.24.1onnxslim==0.1.85requests==2.28.1
opencv-python==4.13.0.92openvino==2025.4.1openvino-telemetry==2025.2.0scipy==1.17.0
packaging==26.0pillow==12.0.0polars==1.38.1six==1.17.0
sympy==1.14.0torch==2.2.0torchaudio==2.2.0torchvision==0.17.0
typing_extensions==4.15.0ultralytics==8.4.14ultralytics-thop==2.0.18urllib3==1.26.13

Для справки, на борту Пионер Мини 2 (PioneerOS 0.9.0) установлены: numpy 1.26.4, pillow 10.2.0, OpenCV 4.10.0, protobuf 6.33.6, pioneer_sdk2 0.15.1, pioneer_rknn 1.6.3, rknn-toolkit-lite2 2.3.0. Полный аудит — в уроке «Исследование системы».

Подключение по SSH

Этот способ рассчитан на опытных пользователей, знакомых с Linux. Если опыта нет — воспользуйтесь сервисом Pioneer Code.

Пионер Мини 2

  • Подключите аккумулятор и дождитесь появления Wi-Fi сети PMINI2-(12 символов).
  • Подключитесь к Wi-Fi сети модуля, пароль geoscan123.
  • В терминале выполните ssh pioneermini@10.42.0.1 и введите пароль geoscan123 (символы при вводе не отображаются).

Пионер Базовый (Radxa Zero / Pi Zero)

  • Дождитесь Wi-Fi сети RaZero-(12 символов) (Radxa) или PiZero-(12 символов) (Pi Zero), пароль geoscan123.
  • Для Radxa пользователь — pioneer: ssh pioneer@10.42.0.1. Для Pi Zero вычисления доступны по SSH.

Пользователям Windows: для подключения по SSH может потребоваться установить клиент OpenSSH. Если вы получаете ответ Connection closed by 10.42.0.1 port 22, создайте правило для входящих подключений в брандмауэре: тип «для порта», протокол TCP, порт 22.

Диагностика типовых проблем подключения — в уроке «Диагностика и FAQ».