Setting Up The Simulator

This guide will go through how to set up the simulator to simulate Autopilot scripts or MavLink connections!

System Requirements:

OS: Ubuntu 22.04+ (Or equivalent to it, WSL will also work, please note that some functionality in WSL is limited)

Create Working Environment for your simulator It is recommended to enclose

your simulator in its own directory for ease of use.

Installing APM Planner (for Ubuntu Users)

Follow through the Ubuntu 22.04 LTS installation from here: https://github.com/ArduPilot/apm_planner?tab=readme-ov-file#linux

Installing QGroundControl (For WSL Users) Unfortunately there are connection

issues over UDP for APM Planner so for now you can just run QGroundControl

https://docs.qgroundcontrol.com/master/en/qgc-user-guide/getting_started/download_and_install.html#ubuntu

After installing QGC (QGroundControl): Go to application settings, and then network settings. Add a connection via UDP and make the address 127.0.0.1:14551 and the connection port to be 14551

Set up ArduCopter SITL

Set up the build environment for ArduPilot

Install required packages:

sudo apt-get update
sudo apt-get install git
sudo apt-get install gitk git-gui

Clone ArduPilot repository into the simulator directory

git clone --recurse-submodules git@github.com:ArduPilot/ardupilot.git
cd ardupilot

Install required packages for SITL (Software In The Loop)

Tools/environment_install/install-prereqs-ubuntu.sh -y

NOTE: This installation can be quite lengthy, don't exit out just because its taking too long. Patience is a wonderful thing

Reload the path in order to make these changes take effect. Personally, I'd recommend rebooting your system.

sudo reboot

After your system has finished rebooting:

Build the code and configure it for ArduCopter

./waf configure
./waf copter
./waf clean

At this point, you can test if everything is working by running

sim_vehicle.py -v Copter
mavproxy.py

If there are no errors, then everything is working. If there are issues, please report them so we can investigate further.

Getting the Scripts to run the simulator

For ease of use, I have created shell scripts that you can run to make things easier

For those of you who are unfamiliar, a shell script is basically a script you can run which will execute commands as if it were you typing things out in the terminal (with a few exceptions)

You can clone the simulator-scripts repo into your simulator directory and the scripts will be added into the directory

git clone git@github.com:uaarg/simulator-scripts.git

Next you need to make these shell scripts executable

chmod +x ./sitl.sh ./proxy.sh

Running the Simulator

Open up 4 terminals

In the first terminal, run ./sitl.sh
In the second terminal, run ./proxy.sh
In the third terminal, run ./release/apmplanner2
The fourth terminal is where you will be executing your scripts to run in the simulator

To run a python script, navigate to the root of the directory with the script. For example, navigate to the root of shepard and then you can run your scripts as follows:

PYTHONPATH=. python3 <path to your script>

After the script is running, you will know if it is running if there is a print statement in your console saying that the connection has been established

To start flying the drone in the simulator, you will need to go into the mission planner, set the mode to Guided and then arm the drone and it will start flying.

UAARG Guide