Using SITL with RealFlight¶
RealFlight is a commercial flight simulator with a 3D view, and the ability to design and test custom vehicles.
This simulator only runs on Windows and requires RealFlight version 8 or version 9. Note that RealFlight-X does not work with ArduPilot. If you are installing for the first time then RealFlight version 9 is recommended.
The following instructions assume that you have setup your Flight Control box method, using either the Interlink Controller normally sold with RealFlight, a joystick, or your OpenTX transmitter in joystick mode.
Realflight will not start unless a joystick device is present. If you wish to only simulate AUTO missions, or things not requiring a lot of joystick/controller input, you can install a virtual joystick like vJoy. This will allow you to start Realflight uses this controller and control the vehicle via the Ground Control Station or even by the virtual screen joystick (“vJoy Feeder”program which is installed at the same time the virtual device driver is installed).
See the last section on this page for setup instructions, if using an OpenTX transmitter. After installing RealFlight, familiarize yourself with its operation a bit before proceeding.
- Start RealFlight (it should look exactly like regular RealFlight, there is no way to visually determine the difference)
- Download the QuadcopterX from ArduPilot/SITL_Models/RealFlight/Released_Models/MultiRotors/QuadCopterX/QuadcopterX-flightaxis_AV.RFX.
- Download the parameter file for this model. Be sure its saved in text format.This will be used later.
- Select Simulation, Import, RealFlight Archive (RFX, G3X) and select the file QuadcopterX downloaded above. A message, “..was successfully imported” should be displayed
- Select Aircraft, Select Aircraft, open “Custom Aircraft” section and select “QuadcopterX-flightaxis”. In the current state, the RC inputs come straight from the stick so it is not flyable.
From within RealFlight, Reduce graphics options to improve performance:
- Simulation, Settings, Graphics
- Under “Quality” set all values to “No” or “Low” (i.e. set “Clouds” to “No”, “Water Quality” to “Low”, etc)
- Under “Hardware” set “Resolution” to “800 x 600 Medium(16 bit) and select “Full Screen” mode
- Under physics settings, change the option for “Pause Sim When in Background” to No, and “Automatic Reset Delay(sec)” to 2.0
Connecting to Mission Planner’s SITL¶
On many older, yet Windows 10 compatible PCs, there may not be sufficient processing power to smoothly run the Mission Planner SITL simultaneously. See the next section on Dual PC setups, if you already have a Linux PC to split the processing loads.
On Config/Tuning, Planner set the Layout drop-down to “Advanced”
On the top menu bar, select Simulation
From the “Model” drop-down, select “flightaxis” and push the Multirotor icon
on the Full Parameter List or Tree screens, on the right-side select realflight-quad and press load parameters
On the real-flight controller press the red “reset” button, or PC’s space bar, to reset the vehicle’s attitude and position and initialize the connection with SITL.
- the message “FlightAxis Controller Device has been activated.” should appear and the motors should become quieter
If the vehicle’s position is not reset, from within RealFlight:
- Aircraft, Select Aircraft
- Custom Aircraft, QuadcopterX-flightaxis
- press OK
- after the vehicles position is reset, press the transmitter’s “Reset” button or PC spacebar again
At this point, load the parameter file for this “QuadCopterX-flightaxis” model via Mission Planner. You are now ready to arm and fly.
Connecting to SITL running on a separate (or Virtual) machine:¶
This technique spreads the processing requirements between two PCs: one Windows machine running RealFlight and the physics/flight graphics, and another Linux PC or Linux VM running the SITL models. It also allows you to test and use locally generated code, rather than only the master branch, used by Mission Planner SITL.
- best performance is obtained using a direct Gigabit Ethernet connection between machines.
- determine the IP address of the Windows machine running RealFlight by opening a console and entering “ipconfig”.The result will likely be something like 192.168.x.x OR 127.0.0.1 if running sitl on a Windows machine using cygwin or WSL, or similar to 10.26.0.2 if using a direct ethernet connection.
be sure that there is no firewall preventing communication between the PCs. You should be able to “ping” one from the other.
on the separate machine where SITL will run, start SITL sim_vehicle.py with “-f flightaxis:192.168.x.x” or if using a traditional helicopter, “-f heli - -model flightaxis:192.168.x.x”.
- cd ArduCopter (See Note below)
- sim_vehicle.py -f flightaxis:192.168.x.x - -map - -console
back on RealFlight push the red “RESET” button on the transmitter, or spacebar on PC
after about a minute, the vehicle should be visible on the SITL map
from within SITL type
param load <filename>to load the parameter found in the same directory as the model. You may have to load them again, after typing
param fetch, in order to load parameters that require enabling before presenting their parameter set. And, in some cases, you may even need to restart SITL in order for some new parameters to take effect.
the performance of the connection can be checked by opening the “ArduCopter” window (on the machine running SITL), the “FPS” (Frames Per Second) count needs to be over 150 for the vehicle to fly well (the average can be lower)
the above was for a Copter. Change the directory to ArduPlane or ArduRover for those types of vehicles before beginning sim_vehicle.py or add the -v <vehicletype> directive when starting it.
Using ready-made models¶
As mentioned above, RealFlight allows designing your own custom vehicles including choosing the size, weight, appearance, and motor and control surface placement.
A number of custom models have been created by ArduPilot developers and stored in the ArduPilot/SITL_Models repository.
You should be able to clone this repo using
git clone https://github.com/ArduPilot/SITL_Models.git and then load the models into RealFlight.
In the directory for each model there is a .parm file that can be loaded into SITL so that appropriate tunings parameters are set.
The SITL_Models folder has a RealFlight directory with a WIP sub-directory for models in progress, and a Released_Models directory, which have models that have been tested to work with the InterLink controllers and have README.md files describing thier setup and special features.
To import one of these models:
- on RealFlight select Simulation >> Import >> RealFlight Archive (RFX, G3X) and select the model you’re interested in
- select Aircraft >> Select Aircraft and select the model imported from the above step
- from within SITL type
param load <filename>to load the parameter found in the same directory as the model, as in the above example. You may have to load them again, after typing
param fetch, in order to load parameters that require enabling before presenting their parameter set. And in some cases you may need to restart SITL in order for some parameters to take effect.
OpenTX use with RealFlight and SITL¶
There are three approaches you can use. Minimal: which only setups up the AETR flight control axes, and Maximal: Which gets at least 7 channels to the SITL module, more closely emulating how you would really use the TX to fly the vehicle, and Interlink DX controller emulation.
Minimal: power up the TX, program a new plane model for use with the sim with the wizard, plug in USB, select joystick (later OpenTX versions allow permanent selection in the main radio setup page). Select Simulation-> Select controller in RealFlight. Select Taranis, and proceed to setup the aileron,elevator,rudder, and throttle and calibrate them. Now to change modes or set switches, you will need to use MAVProxy or Mission Planner commands.
Maximal: In additon to the above, setup the TX model with switches or sliders/pots for channels 5,6,7, and 8. Then add them for functions in the RealFlight controller setup. Do not be concerned about the function names, we just want them to be passed thru to the SITL model. Now you can assign
RCx_OPTION functions to those channels in the model parameters.
InterLink DX/Elite controller emulation: This closely mimics these Interlink controllers, normally sold with RealFlight. This allows the use of a transmitter with normal RealFlight simulations as well as SITL which closely matches the physical layout of the Interlink controllers. See Interlink Simulator Controller Emulation with OpenTX for setup details.
To setup a six position mode switch, you would do so just as explained here for an OpenTX transmitter, but first calibrate the RealFlight controller using a dual position switch on the mode channel. Then change the transmitter back to provide the six PWM levels. This required since RealFlight auto-scales from the calibration values, so if your six PWM levels are centered in the recognition ranges , then the channel’s PWM extremes will not be used for calibration and the PWM levels will be altered by RealFlight before passing on to the SITL.