Installation

From source

Into a colcon workspace:

mkdir -p ~/ws/src
cd ~/ws/src
git clone https://github.com/HonuRobotics/holybro_models.git
cd ~/ws
rosdep update
rosdep install --from-paths src --ignore-packages-from-source --default-yes
colcon build --merge-install
source install/setup.bash

Tip

rosdep update refreshes the dependency database; skipping it in fresh containers is the usual cause of “Cannot locate rosdep definition” errors.

The project standard is colcon build --merge-install (one deb style prefix, the layout users get from binary installs). The default isolated layout also works if you prefer it.

The build generates the default vehicle artifacts from the vehicle’s config (the URDF, the composed Gazebo model, the ros_gz bridge config).

From ROS packages (debs)

Binary packages (ros-<distro>-x500-gazebo, ros-<distro>-x500-description, ros-<distro>-holybro-parts) are planned for the ROS build farm and are not published yet. When they are, installation is:

sudo apt install ros-lyrical-x500-gazebo
source /opt/ros/lyrical/setup.bash
ros2 launch x500_gazebo sim.launch.xml

Nothing under /opt/ros is meant to be edited. The default vehicle is baked into the packages; a custom config is a YAML file anywhere on disk passed to the launch (config_file:=), which regenerates every artifact at launch time (Configuration).