Середовище розробки MacOS
Наступні інструкції для встановлення середовища розробки PX4 для macOS. Це середовище може бути використане для збірки PX4 для:
- Pixhawk та іншого апаратного забезпечення на основі NuttX
- Симуляція jMAVSim
- Симуляція Gazebo Classic
TIP
Ця установка підтримується командою розробників PX4. Для збірки для інших цільових платформ потрібно використати інші ОС (або середовище розробки що не підтримується).
Відеоінструкція
Базове налаштування
"Базове" налаштування macOS встановлює інструменти, необхідні для збірки прошивки та включає загальні інструменти, які будуть потрібні для встановлення/використання симуляторів.
Налаштування середовища
Details
Користувачі Apple M1 Macbook! Якщо у вас є Apple M1 Macbook, переконайтеся, що запускаєте x86 термінал шляхом налаштування термінала:
- Знайдіть термінальний додаток в теці Utilities (Finder > Меню > Utilities)
- Виберіть Terminal.app та клацніть правою кнопкою миші, а потім оберіть Копіювати
- Перейменуйте скопійований додаток терміналу, наприклад x86 Terminal
- Тепер оберіть перейменований додаток x86 Terminal і клацніть правою кнопкою миші та оберіть Отримати Інформацію
- Поставте відмітку Відкрити з Rosetta та закрийте вікно
- Запустіть x86 Terminal як зазвичай, який тепер повинен підтримувати інструментарій PX4
Спочатку налаштуйте середовище
Збільште кількість одночасно відкритих файлів додавши наступний рядок у файл
~/.zshenv
(створивши його якщо необхідно):shecho ulimit -S -n 2048 >> ~/.zshenv
:::note Якщо ви цього не зробите, інструментарій збірки може повідомити про помилку: "LD: too many open files"
:::
Забезпечте виконання Python 3 додаванням наступних рядків до
~/.zshenv
sh# Направляємо pip3 на системний pip MacOS alias pip3=/usr/bin/pip3
Загальні інструменти
Для налаштування середовища з можливістю збірки для обладнання Pixhawk/NuttX (і встановлення загальних інструментів для використання симуляторів):
Встановіть Homebrew дотримуючись наступних інструкцій установки.
Виконайте ці команди в командній оболонці для встановлення загальних інструментів:
shbrew tap PX4/px4 brew install px4-dev
Встановіть необхідні пакети Python:
sh# install required packages using pip3 python3 -m pip install --user pyserial empty toml numpy pandas jinja2 pyyaml pyros-genmsg packaging kconfiglib future jsonschema # if this fails with a permissions error, your Python install is in a system path - use this command instead: sudo -H python3 -m pip install --user pyserial empty toml numpy pandas jinja2 pyyaml pyros-genmsg packaging kconfiglib future jsonschema
Симуляція Gazebo Classic
Для встановлення середовища Gazebo Classic:
Виконайте наступні команди в командній оболонці:
shbrew unlink tbb sed -i.bak '/disable! date:/s/^/ /; /disable! date:/s/./#/3' $(brew --prefix)/Library/Taps/homebrew/homebrew-core/Formula/[email protected] brew install tbb@2020 brew link tbb@2020
:::note Станом на вересень 2021: Команди вище - це обхідний шлях для помилки: PX4-Autopilot#17644. Вони можуть бути видалені після того, як вона буде виправлена (разом з цією нотаткою). :::
Для встановлення симуляції SITL з Gazebo Classic:
shbrew install --cask temurin brew install --cask xquartz brew install px4-sim-gazebo
Запустіть скрипт налаштування macOS:
PX4-Autopilot/Tools/setup/macos.sh
Найпростіший спосіб зробити це - клонувати вихідний код PX4 і потім виконати скрипт з директорії, як показано:shgit clone https://github.com/PX4/PX4-Autopilot.git --recursive cd PX4-Autopilot/Tools/setup sh macos.sh
Симуляція jMAVSim
Для встановлення середовища для симуляції jMAVSim:
Встановіть останню версію Java (наприклад, Java 15). Ви можете завантажити Java 15 (або новіше) від Oracle або використати Eclipse Temurin:
shbrew install --cask temurin
Встановіть jMAVSim:
shbrew install px4-sim-jmavsim
PX4 v1.11 і далі вимагає щонайменше JDK 15 для симуляції jMAVSim.
Для попередніх версій, користувачі macOS можуть побачити помилку
Exception in thread "main" java.lang.UnsupportedClassVersionError:
. Знайти виправлення можна в розділі jMAVSim з SITL > Усунення проблем).
:::
Наступні кроки
Після того, як ви закінчите налаштування інструментів командного рядка:
- Встановіть VSCode (якщо ви надаєте перевагу IDE ніж командному рядку).
- Встановіть денну збірку QGroundControl.
TIP
Денна збірка включає інструменти розробки яких немає в релізних збірках. Вона також може надати доступ до нових функцій PX4, які ще не підтримуються в релізних збірках.
- Переходьте до інструкцій збірки.