FlightGear Simulation
Last updated
Last updated
is a flight simulator with powerful . This allows FlightGear to simulate rotorcrafts under various meteorological conditions (which is why the bridge was originally developed by ).
This page describes FlightGear's single-vehicle use in SITL. For information about multi-vehicle use see: .
Supported Vehicles: Autogyro, Plane, Rover.
@
:::note See for general information about simulators, the simulation environment, and simulation configuration (e.g. supported vehicles). :::
:::note These instructions were tested on Ubuntu 18.04 :::
Install the usual .
Install FlightGear:
This installs the latest stable FlightGear version from the PAA repository along with the FGdata package.
:::tip For some models (e.g. those with electric engines) the daily build with the newest features may be necessary. Install this using the . :::
Check that you are able to run FlightGear:
Set write permissions to the Protocols folder in the FlightGear installation directory:
Setting the permissions is required because the PX4-FlightGear-Bridge puts the communication definition file here.
Run a simulation by starting PX4 SITL, specifying the airframe configuration of your choice.
The easiest way to do this is to open a terminal in the root directory of the PX4 PX4-Autopilot repository and call make for the desired target. For example, to start a plane simulation :
The supported vehicles and make commands are listed below (click on the links to see the vehicle images).
make px4_sitl_nolockstep flightgear_rascal
make px4_sitl_nolockstep flightgear_tf-r1
make px4_sitl_nolockstep flightgear_tf-g1
The commands above launch a single vehicle with the full UI. QGroundControl should be able to automatically connect to the simulated vehicle.
:::note For the full list of FlightGear build targets (highlighted) run:
The make commands mentioned above first build PX4 and then run it along with the FlightGear simulator.
Once the PX4 has started it will launch the PX4 shell as shown below. You must select enter to get the command prompt.
The console will print out status as PX4 loads the airframe-specific initialization and parameter files, wait for (and connect to) the simulator. Once there is an INFO print that [ecl/EKF] is commencing GPS fusion the vehicle is ready to arm. At this point, you should see a FlightGear window with some view of aircraft.
:::note You can change the view by pressing Ctrl+V. :::
You can bring it into the air by typing:
You can tune your FG installation/settings by the following environment variables:
FG\_BINARY - absolute path to FG binary to run. (It can be an AppImage)
FG\_MODELS\_DIR - absolute path to the folder containing the manually-downloaded aircraft models which should be used for simulation.
FG\_ARGS\_EX - any additional FG parameters.
In FlightGear you can display the frame rate by enabling it in: View > View Options > Show frame rate.
Takeoff location in SITL FlightGear can be set using additional variables. Setting the variable will override the default takeoff location.
For example:
The joystick input in FlightGear should be disabled in otherwise there will be a "race condition" between the FG joystick input and PX4 commands.
Additional installation instructions can be found on .
For additional information see: (this includes information about "unsupported" vehicles, and adding new vehicles). :::
:::note The guide is a useful reference if there are build errors. :::
The variables which can be set are as follows: --airport, --runway, and --offset-distance. Other options can be found on
The example above starts the simulation on the
Joystick and thumb-joystick are supported through QGroundControl ().
To extend or customize the simulation interface, edit the files in the Tools/simulation/flightgear/flightgear_bridge folder. The code is available in the on Github.
