Сборка на собственной машине
Настройка среды для симуляции с нуля требует некоторых усилий, однако это приведет к улучшению производительности и к уменьшению вероятности появления проблем с драйверами.
СОВЕТ
Смотрите актуальный набор команд установки необходимого ПО для запуска симулятора Клевера в скрипте сборки виртуальной машины с симулятором: install_software.sh
.
Требования для сборки: Ubuntu 20.04.
Установка ROS
Установите ROS Noetic используя официальную документацию по установке (Desktop или Full установка).
Добавьте выполнение инициализирующего скрипта ROS setup.bash
в ваш файл .bashrc
:
echo "source /opt/ros/noetic/setup.bash" >> ~/.bashrc
source ~/.bashrc
Установите необходимые инструменты, которые понадобятся для дальнейшей установки:
sudo apt install build-essential git python3-pip python3-rosdep
Создание рабочего пространства для симулятора
Создайте рабочее пространство:
mkdir -p ~/catkin_ws/src
cd ~/catkin_ws
catkin_make
echo "source ~/catkin_ws/devel/setup.bash" >> ~/.bashrc
source ~/.bashrc
Склонируйте исходный код пакетов Clover:
cd ~/catkin_ws/src
git clone --depth 1 https://github.com/CopterExpress/clover
git clone --depth 1 https://github.com/CopterExpress/ros_led
git clone --depth 1 https://github.com/ethz-asl/mav_comm
Установите все зависимости, используя rosdep
:
cd ~/catkin_ws
sudo rosdep init
rosdep update
rosdep install --from-paths src --ignore-src -y
Установите Python-зависимости:
sudo /usr/bin/python3 -m pip install -r ~/catkin_ws/src/clover/clover/requirements.txt
Загрузка исходного кода PX4
Сборка PX4 будет осуществлена вместе с другими пакетами в нашем рабочем пространстве. Вы можете загрузить его прямо в рабочее пространство или поместить куда-нибудь и создать симлинк к ~/catkin_ws/src
. Нам также нужно будет поместить его подмодули sitl_gazebo
и mavlink
в ~/catkin_ws/src
.
Склонируйте исходный код PX4 и создайте необходимые симлинки:
git clone --recursive --depth 1 --branch v1.12.0 https://github.com/PX4/PX4-Autopilot.git ~/PX4-Autopilot
ln -s ~/PX4-Autopilot ~/catkin_ws/src/
ln -s ~/PX4-Autopilot/Tools/sitl_gazebo ~/catkin_ws/src/
ln -s ~/PX4-Autopilot/mavlink ~/catkin_ws/src/
СОВЕТ
Вы можете использовать более позднюю версию PX4 с большим риском, что что-то не заработает.
Установка зависимостей PX4
PX4 имеет свой собственный скрипт для установки зависимостей. Воспользуемся им:
cd ~/catkin_ws/src/PX4-Autopilot/Tools/setup
sudo ./ubuntu.sh
Он установит все, что нужно для сборки PX4 и SITL.
СОВЕТ
Также вы можете пропустить установку ARM тулчейна, если вы не планируете компилировать PX4 для вашего полетного контроллера. Для этого воспользуйтесь флагом --no-nuttx
: sudo ./ubuntu.sh --no-nuttx
.
Установите дополнительные необходимые Python-пакеты:
pip3 install --user toml
Добавление рамы Клевера
Добавьте в PX4 раму Клевера с помощью следующей команды:
ln -s ~/catkin_ws/src/clover/clover_simulation/airframes/* ~/PX4-Autopilot/ROMFS/px4fmu_common/init.d-posix/airframes/
Установка датасетов geographiclib
Для mavros
нужны датасеты geographiclib:
sudo /opt/ros/noetic/lib/mavros/install_geographiclib_datasets.sh
Сборка симулятора
После установки всех зависимостей можно начинать сборку рабочего пространства:
cd ~/catkin_ws
catkin_make
СОВЕТ
Если процесс сборки завершится с ошибкой, связанной с недостатком памяти (c++: fatal error: Killed signal terminated program cc1plus
), уменьшите количество параллельно исполняемых процессов используя ключ -j
. Например, чтобы использовать только два параллельных процесса используйте команду catkin_make -j2
.
Запуск симулятора
Чтобы удостовериться в том, что все было собрано корректно, попробуйте запустить симулятор:
roslaunch clover_simulation simulator.launch
Вы можете проверить автономный полет используя скрипты в директории ~/catkin_ws/src/clover/clover/examples
.
Дополнительные шаги
Опционально вы можете установить systemd-сервис для roscore для того, чтобы roscore был постоянно запущен в фоне:
sed -i "s/pi/$USER/g" ~/catkin_ws/src/clover/builder/assets/roscore.service
sudo cp ~/catkin_ws/src/clover/builder/assets/roscore.service /etc/systemd/system
sudo systemctl enable roscore
sudo systemctl start roscore
Установите любой веб-сервер, чтобы раздавать веб-инструменты Клевера (директория ~/.ros/www
), например, Monkey:
wget https://github.com/CopterExpress/clover_vm/raw/master/assets/packages/monkey_1.6.9-1_$(dpkg --print-architecture).deb -P /tmp
sudo dpkg -i /tmp/monkey_*.deb
sed "s/pi/$USER/g" ~/catkin_ws/src/clover/builder/assets/monkey | sudo tee /etc/monkey/sites/default
sudo sed -i 's/SymLink Off/SymLink On/' /etc/monkey/monkey.conf
sudo cp ~/catkin_ws/src/clover/builder/assets/monkey.service /etc/systemd/system/monkey.service
sudo systemctl enable monkey
sudo systemctl start monkey