Установка программы «Пилотаж»

Документация по установке программы «Пилотаж» (полное наименование — «Симулятор БПЛА/дрона „Пилотаж“») на компьютеры под управлением операционных систем Windows, Astra Linux, РЕД ОС, Альт и macOS. Этот документ опубликован в составе сведений правообладателя для Единого реестра российского программного обеспечения.

1. Форма поставки

Программа поставляется в виде архива для каждой поддерживаемой операционной системы:

Операционная системаФайл дистрибутиваИсполняемый файл
WindowsPilotazh-Windows.zipPilotazh\Pilotazh.exe
Astra Linux, РЕД ОС, Альт и другие LinuxPilotazh-Linux.tar.gzPilotazh/Pilotazh.x86_64
macOSPilotazh-macOS.zipприложение «Пилотаж»

В имени файла на странице загрузки может быть указан номер версии, например Pilotazh-v1.0.0-Windows.zip.

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

2. Системные требования

2.1. Операционная система

  • Windows 10 или Windows 11, 64-разрядная.
  • Astra Linux Special Edition 1.7 и новее, РЕД ОС 7.3 и новее, Альт 10 и новее, а также другие дистрибутивы Linux с библиотекой glibc версии 2.28 и новее (Debian 10+, Ubuntu 20.04+); архитектура x86_64.
  • macOS 13 и новее, на компьютерах с процессорами Apple Silicon или Intel.

2.2. Оборудование

МинимальныеРекомендуемые
Процессорx86_64 (Windows, Linux); Apple Silicon или Intel (macOS)то же
Оперативная память4 ГБ8 ГБ
Видеокартавстроенная или отдельная с поддержкой OpenGL 3.3 (режим совместимости, качество графики «Низкое»)с поддержкой Vulkan 1.0; встроенная — качество «Среднее», отдельная — «Высокое» и «Ультра»
Место на диске1 ГБ1 ГБ
Экран1280×7201600×900 и выше
Управлениеклавиатура и мышьрадиопульт или геймпад по USB
Звук—динамики или наушники

Если видеокарта не поддерживает Vulkan, программа сама запускается в режиме совместимости через OpenGL 3.3. Качество графики при первом запуске выбирается автоматически по типу видеокарты и может быть изменено в настройках. Подключение к интернету и права администратора не нужны.

2.3. Устройства управления

  • Радиопульты, которые подключаются к компьютеру по USB как джойстик: RadioMaster, BetaFPV LiteRadio и другие пульты с прошивкой EdgeTX или OpenTX.
  • Геймпады, распознаваемые операционной системой.
  • Клавиатура — если пульта нет.

3. Получение дистрибутива

Экземпляр программы публично доступен на собственном веб-ресурсе правообладателя по адресу:

https://pilotazh.integro44.ru/download

Страница загрузки не требует регистрации, ввода адреса электронной почты и прохождения каких-либо проверок. На ней размещены:

  • прямые ссылки на архивы последней версии для каждой операционной системы;
  • контрольные суммы SHA-256 архивов для проверки целостности файлов;
  • сведения о версии и дате сборки.

Для компьютеров без доступа к интернету архив скачивается на любом другом компьютере и переносится на съёмном носителе.

Без лицензионного ключа программа работает в демонстрационном режиме: доступны все функции, один полёт длится не больше 5 минут. Лицензионный ключ правообладатель передаёт лицензиату при приобретении лицензии; порядок активации — в разделе 10.

4. Установка в Windows

  1. Скачайте архив Pilotazh-Windows.zip со страницы загрузки.
  2. Щёлкните по архиву правой кнопкой мыши и выберите «Извлечь всё…». Укажите папку, например C:\ или рабочий стол: в ней появится папка программы Pilotazh.
  3. Откройте папку Pilotazh и запустите Pilotazh.exe. Файлы в папке программы нельзя удалять или перемещать по отдельности.
  4. При первом запуске может появиться окно фильтра SmartScreen «Система Windows защитила ваш компьютер», так как программа распространяется вне магазина приложений. Нажмите «Подробнее» → «Выполнить в любом случае».
  5. Для удобства создайте ярлык: правой кнопкой мыши по Pilotazh.exe → «Отправить» → «Рабочий стол (создать ярлык)».

5. Установка в Astra Linux, РЕД ОС, Альт

  1. Скачайте архив Pilotazh-Linux.tar.gz со страницы загрузки.
  2. Распакуйте архив в домашнюю папку пользователя. В терминале:
    cd ~
    tar xzf ~/Загрузки/Pilotazh-Linux.tar.gz
    Можно распаковать архив и средствами файлового менеджера. Архив сохраняет права на запуск исполняемого файла.
  3. Запустите программу:
    ~/Pilotazh/Pilotazh.x86_64
    или двойным щелчком по файлу Pilotazh.x86_64 в файловом менеджере.
  4. Если видеокарта или драйвер не поддерживают Vulkan, программа автоматически переключится на OpenGL (режим совместимости). Режим совместимости можно включить принудительно:
    ~/Pilotazh/Pilotazh.x86_64 --rendering-driver opengl3
  5. Чтобы программа появилась в меню приложений, создайте файл ~/.local/share/applications/pilotazh.desktop:
    [Desktop Entry]
    Type=Application
    Name=Пилотаж
    Comment=Симулятор БПЛА/дрона
    Exec=/home/ИМЯ_ПОЛЬЗОВАТЕЛЯ/Pilotazh/Pilotazh.x86_64
    Terminal=false
    Categories=Education;
    В строке Exec укажите фактический путь к программе.

Права администратора для установки, запуска и работы с радиопультом по USB на типовой установке операционной системы не требуются.

6. Установка в macOS

  1. Скачайте архив Pilotazh-macOS.zip со страницы загрузки и распакуйте его двойным щелчком.
  2. Перенесите приложение «Пилотаж» в папку «Программы».
  3. При первом запуске щёлкните по приложению правой кнопкой мыши и выберите «Открыть», затем подтвердите запуск. Это нужно один раз, так как приложение распространяется вне App Store. Альтернативно в терминале:
    xattr -dr com.apple.quarantine /Applications/Пилотаж.app
  4. Для работы радиопульта может потребоваться разрешение: «Системные настройки» → «Конфиденциальность и безопасность» → «Мониторинг ввода» → включить «Пилотаж».

7. Установка в компьютерном классе

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

  1. Скачайте архив для нужной операционной системы на любом компьютере с доступом к интернету и проверьте контрольную сумму.
  2. Перенесите архив на компьютеры класса на съёмном носителе или через локальную сеть.
  3. Распакуйте архив на каждом компьютере по инструкции для соответствующей операционной системы.
  4. Создайте ярлык на рабочем столе или в меню приложений.
  5. Положите файл лицензионного ключа license.key в папку программы на каждом компьютере (рядом с Pilotazh.exe, Pilotazh.x86_64 или Пилотаж.app). Ключ будет действовать для всех пользователей компьютера; права администратора и ввод ключа под каждым пользователем не нужны.
  6. Подключите радиопульты и один раз выполните их калибровку на каждом компьютере (раздел «Пульт» в настройках программы).

Настройки программы (выбранный дрон, графика, звук, погода, назначение осей и калибровка пульта) хранятся отдельно для каждой учётной записи пользователя в его домашней папке: в Windows — внутри папки %APPDATA%, в Linux — внутри ~/.local/share, в macOS — внутри ~/Library/Application Support. Учётная запись ученика может не иметь прав администратора.

8. Подключение радиопульта

  • Пульты на EdgeTX (RadioMaster и другие): включите пульт, подключите его к компьютеру USB-кабелем и в появившемся на экране пульта меню выберите «USB Joystick (HID)».
  • BetaFPV LiteRadio 4: подключайте USB-кабель к выключенному пульту — тогда он работает как джойстик.
  • Пульты на OpenTX подключаются в режиме джойстика аналогично.

Подключённый пульт отображается внизу главного меню программы. Назначение осей и калибровка выполняются в разделе «Пульт и управление» — см. документ «Эксплуатация». Драйверы для пультов не требуются: операционная система распознаёт их как стандартный джойстик.

9. Первый запуск

  • После запуска открывается главное меню: название программы, кнопки «Начать полёт», «Настройки», «Пульт и управление», «Лицензия», «Выход» и модель выбранного дрона.
  • Если лицензионный ключ не активирован, в главном меню видна надпись «ДЕМО-РЕЖИМ — полёт до 5 минут».
  • При первом запуске программа сама выбирает уровень качества графики по типу видеокарты: для режима совместимости (OpenGL) — «Низкое», для встроенной видеокарты — «Среднее», для дискретной — «Высокое». Уровень можно изменить в настройках.
  • Внизу главного меню показано, подключён ли пульт. Если пульт не найден, программа подсказывает, как его подключить, и позволяет летать с клавиатуры.

10. Активация лицензии

Лицензионный ключ — одна строка вида PLZ1.… или файл license.key. Ключ выдаётся правообладателем на организацию и не привязан к компьютеру. Активация выполняется без подключения к интернету: ключ проверяется в программе по цифровой подписи.

Активация для текущего пользователя:

  1. В главном меню нажмите «Лицензия».
  2. Скопируйте ключ и нажмите «Вставить ключ из буфера обмена» либо нажмите «Выбрать файл ключа…» и укажите файл license.key.
  3. Появится сообщение «Лицензия активирована. Полная версия без ограничений.», состояние на экране сменится на «Полная версия».

Для всех пользователей компьютера, например в компьютерном классе, достаточно положить файл license.key в папку программы (имя файла — ровно license.key). Если найдены оба ключа, действует ключ пользователя, а если он не подходит — ключ из папки программы.

Где лежит ключWindowsLinuxmacOS
Активирован на экране «Лицензия» (для текущего пользователя)%APPDATA%\Pilotazh\license.key~/.local/share/Pilotazh/license.key~/Library/Application Support/Pilotazh/license.key
Для всех пользователей компьютераlicense.key рядом с Pilotazh.exelicense.key рядом с Pilotazh.x86_64license.key рядом с Пилотаж.app или внутри пакета в Пилотаж.app/Contents/MacOS/

Экран «Лицензия» показывает тип лицензии, организацию, ИНН, номер лицензии, число рабочих мест, дату выдачи, дату «Обновления до» и версию программы. Ключ действует для версий программы, выпущенных не позже даты «Обновления до».

Чтобы перенести лицензию на другой компьютер, скопируйте файл license.key или строку ключа и активируйте её на новом компьютере.

11. Проверка работоспособности

Для подтверждения корректной установки рекомендуется выполнить следующие действия:

  1. Запустите программу — должно открыться главное меню с вращающейся моделью дрона.
  2. Стрелками ‹ › в карточке дрона переключите дрон — должны смениться модель, название и характеристики.
  3. Нажмите «Начать полёт» — после затемнения экрана и надписи «Загрузка карты…» откроется полёт с видом из FPV-камеры и экранной информацией (напряжение батареи, режим полёта, таймер).
  4. Нажмите пробел (арм) и удерживайте клавишу W (газ) — дрон должен взлететь, звук моторов — усилиться.
  5. Нажмите C — вид должен переключиться на камеру сзади дрона.
  6. Нажмите R — дрон должен вернуться в точку старта.
  7. Нажмите Esc — должно открыться меню паузы. Выберите «Настройки» и проверьте наличие разделов «Полёт», «Управление», «Изображение», «Звук».
  8. Если подключён радиопульт, откройте «Настройки» → «Пульт»: при движении стиков должны меняться значения осей в разделе «Диагностика».
  9. В главном меню нажмите «Лицензия» — откроется экран «Лицензия» с состоянием («Полная версия» или «Демо-режим») и версией программы.

12. Обновление

Для обновления скачайте архив новой версии и распакуйте его на место папки предыдущей версии (предварительно удалив её). Настройки, калибровка пульта и ключ, активированный на экране «Лицензия», хранятся отдельно от папки программы и сохраняются при обновлении; файл license.key и папку maps с добавленными картами (если они есть) перенесите из папки программы в папку новой версии. Новая версия работает с ключом, если она выпущена не позже даты «Обновления до» в ключе. Программа не обновляется автоматически и не обращается к серверам правообладателя.

13. Удаление

  • Удалите папку программы (в macOS — приложение «Пилотаж» из папки «Программы») и созданные ярлыки.
  • Чтобы удалить и сохранённые настройки, удалите папку настроек программы в домашней папке пользователя (см. раздел 7).
  • Ключ, активированный для текущего пользователя, удаляется кнопкой «Удалить ключ» на экране «Лицензия»; файл license.key в папке программы удаляется вручную.

Программа не вносит изменений в системные каталоги и реестр Windows, поэтому другие действия при удалении не требуются.

15. Обращение к правообладателю

В случае вопросов или затруднений — обращение к правообладателю по электронной почте pilotazh@integro44.ru или через форму на сайте.