PX4-Gazebo simulator (headless)

Quickstart

The Docker images resulting from this repo are available on Docker Hub.

Note that the following commands are referring to the latest supported release of PX4, which is currently v1.15.4.

Run in BROADCAST mode:

In this mode, the simulator will be available from your host (e.g. run the following command, and QGroundControl running on your computer will connect automatically).

docker run --rm -it jonasvautherin/px4-gazebo-headless:1.15.4

In this configuration, the container will send MAVLink to the host on ports 14550 (for QGC) and 14540 (for e.g. MAVSDK).

Run with a custom IP for the second MAVLink interface

This mode is useful for running QGroundControl on the computer running docker, and the offboard app (e.g. using MAVSDK) on another device (e.g. a phone).

docker run --rm -it jonasvautherin/px4-gazebo-headless:1.15.4 192.168.0.12

where 192.168.0.12 should be replaced by the IP listening on the API port 14540 (e.g. MAVSDK or MAVROS).

Run with custom IP for both MAVLink interfaces

This mode is useful for running both QGroundControl and the offboard app (e.g. using MAVSDK) on another device than the one running docker.

docker run --rm -it jonasvautherin/px4-gazebo-headless:1.15.4 192.168.0.10 10.0.0.12

where 192.168.0.10 should be replaced by the IP listening on the QGC port 14550 (e.g. QGroundControl) and 10.0.0.12 should be replaced by the IP listening on the API port 14540 (e.g. MAVSDK or MAVROS).

Exposing a video stream

When running with the Typhoon H480 vehicle (with -v typhoon_h480), a video stream will be available. Expose it with e.g. -p 8554:8554, like so:

docker run --rm -it -p 8554:8554 jonasvautherin/px4-gazebo-headless:1.15.4 -v typhoon_h480

Run with another start location

The start location can be set when running the container by setting the following environment variables:

• PX4_HOME_LAT: starting latitude of the drone.
• PX4_HOME_LON: starting longitude of the drone.
• PX4_HOME_ALT: starting altitude of the drone.

For instance:

docker run --rm -it --env PX4_HOME_LAT=47.397742 --env PX4_HOME_LON=8.545594 --env PX4_HOME_ALT=488.0 jonasvautherin/px4-gazebo-headless:1.15.4

Manual build

Note that a clean build from the master branch will pull the latest upstream from the PX4 repository (as can be seen here). In order to build a stable version, change master for a tag (e.g. v1.15.4) in the following commands.

Build the image from this git repository:

docker build https://github.com/JonasVautherin/px4-gazebo-headless.git#master -t px4-gazebo-headless

The starting location of the drone can be set at build time using build arguments (by default the drone is in Zuerich). The possible build arguments are:

• HOME_LAT: starting latitude of the drone (defaults to 47.397742).
• HOME_LON: starting longitude of the drone (defaults to 8.545594).
• HOME_ALT: starting altitude of the drone (defaults to 488.0).

Build arguments can be added to the above command line as follows:

docker build https://github.com/JonasVautherin/px4-gazebo-headless.git#master --build-arg HOME_LAT=37.873350 --build-arg HOME_LON=-122.302525 --build-arg HOME_ALT=20 -t px4-gazebo-headless