Быстрый старт
Раздел объединяет подготовку квадрокоптера, бортовую систему Pioneer OS, сервис Pioneer Code и подключение по SSH. Для Пионера Мини 2 операционная система предустановлена — отдельная установка не требуется.
Быстрый старт
Перед использованием квадрокоптера выполните его подготовку к полетам, изучите управление и инструкции по эксплуатации.
Выполните подготовку квадрокоптера
- Сборка. Пионер Мини 2 поставляется собранным; проверьте затяжку винтов, установите и зафиксируйте воздушные винты, наденьте защиту и верхнюю крышку. Для Пионера Базового сборка — отдельный этап (см. Пионер Базовый).
- Обновите прошивку автопилота. Актуальная прошивка и порядок обновления публикуются в официальной документации Geoscan. Обновление выполняется через конфигуратор Pioneer Station 2. Подробнее — в уроке «Калибровка и обслуживание».
- Загрузите параметры автопилота. Параметры зависят от способа управления (пульт / 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-карту:
- Скачайте архив с образом Pioneer OS для нужного модуля (Radxa или Pi Zero).
- Скачайте и запустите balenaEtcher.
- Вставьте SD-карту (не менее 16 ГБ) в компьютер.
- Нажмите
Flash from fileи выберите архив образа. - Нажмите
Select targetи выберите вашу SD-карту. - Нажмите
Flashи дождитесь завершения записи. - Извлеките SD-карту и вставьте её в слот на обратной стороне модуля.
- Подключите аккумулятор — начнётся установка. Дождитесь появления Wi-Fi сети:
RaZero-(12 символов)для Radxa илиPiZero-(12 символов)для Pi Zero (может занять до 10 минут).
Важно: не отключайте питание до появления Wi-Fi сети — иначе образ придётся записать на SD-карту заново.
Pioneer Code
Экосистема приложений операционной системы Pioneer OS объединяет визуальные и текстовые инструменты программирования, сервис управления медиафайлами и работу с моделями искусственного интеллекта.
Поддержка сервисов Pioneer Code в зависимости от оборудования
| Квадрокоптер/Модуль | Bricks | CodeOSS | Галерея | Модели ИИ |
|---|---|---|---|---|
| Пионер Мини 2 | ✅ | ✅ | ✅ | ✅ |
| Radxa Zero 3W | ✅ | ✅ | ❌ | ✅ |
Подключение
- Включите квадрокоптер и дождитесь появления Wi-Fi сети
PMINI2-(12 символов). - Подключитесь к этой сети, пароль
geoscan123. - Откройте в браузере 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
- Включите квадрокоптер и дождитесь появления Wi-Fi сети
PMINI2-(12 символов). - Подключитесь к сети, пароль
geoscan123. - Откройте в браузере http://10.42.0.1:9999/.
Рабочая папка на борту — /home/pioneermini/workspace. Порядок запуска программ описан в уроке «Способы запуска программы».
Галерея
Галерея — сервис для просмотра, загрузки и удаления медиафайлов, сохраненных на Пионер Мини 2.
Подключение к Галерее
- Включите квадрокоптер и дождитесь появления Wi-Fi сети
PMINI2-(12 символов). - Подключитесь к сети, пароль
geoscan123. - Откройте в браузере http://10.42.0.1:5000/.
Модели ИИ
Модели ИИ — сервис, который позволяет просматривать, удалять и редактировать описание имеющихся моделей, а также загружать собственные.
Подключение к сервису «Модели ИИ»
- Включите квадрокоптер и дождитесь появления Wi-Fi сети
PMINI2-(12 символов). - Подключитесь к сети, пароль
geoscan123. - Откройте в браузере http://10.42.0.1:7777/.
Загрузка модели
Для загрузки модели воспользуйтесь кнопкой Загрузить модель. Модель должна быть в формате ONNX (аргумент opset=19) и затем сконвертирована в RKNN. Пошагово — в уроке «Свои нейросети на NPU».
Архитектура моделей
При загрузке или редактировании моделей, созданных на основе архитектур, поддерживаемых библиотекой Pioneer_RKNN, необходимо указать название архитектуры, использованной при обучении, например yolov8, yolov8-pose. Если архитектура не поддерживается — укажите custom.
Рекомендации для обучения ИИ-модели
Для обучения модели на компьютере можно воспользоваться рекомендованным набором библиотек и версий. Важно: это версии для среды обучения на ПК, а не установленные на борту коптера.
| Библиотека/Версия | Библиотека/Версия | Библиотека/Версия | Библиотека/Версия |
|---|---|---|---|
| certifi==2022.12.7 | charset-normalizer==2.1.1 | colorama==0.4.6 | polars-runtime-32==1.38.1 |
| contourpy==1.3.3 | cycler==0.12.1 | filelock==3.20.0 | protobuf==6.33.5 |
| flatbuffers==25.12.19 | fonttools==4.61.1 | fsspec==2025.12.0 | psutil==7.2.2 |
| idna==3.4 | Jinja2==3.1.6 | kiwisolver==1.4.9 | pyparsing==3.3.2 |
| MarkupSafe==2.1.5 | matplotlib==3.10.8 | ml_dtypes==0.5.4 | python-dateutil==2.9.0.post0 |
| mpmath==1.3.0 | networkx==3.6.1 | numpy==2.3.5 | PyYAML==6.0.3 |
| onnx==1.20.1 | onnxruntime==1.24.1 | onnxslim==0.1.85 | requests==2.28.1 |
| opencv-python==4.13.0.92 | openvino==2025.4.1 | openvino-telemetry==2025.2.0 | scipy==1.17.0 |
| packaging==26.0 | pillow==12.0.0 | polars==1.38.1 | six==1.17.0 |
| sympy==1.14.0 | torch==2.2.0 | torchaudio==2.2.0 | torchvision==0.17.0 |
| typing_extensions==4.15.0 | ultralytics==8.4.14 | ultralytics-thop==2.0.18 | urllib3==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».