Table of Contents
User Guide for Parameters
Autopilot parameters can be set in the groundstation and provide an easy way to tune the behavior of the firmware for your purposes. Typical parameters are the PID gains of the controllers. Others include the flight environment, calibration information (sensor offsets) and so on.
It is possible to tune the parameters in flight (e.g. PID gains), but it is only recommended if you absolutely know what you are doing. The controller apps (attitude control, position control) update their internal copy of the PID gains periodically.
List of all on-board Parameters
A list of all on-board parameters can be found on this page: Parameter Reference
How to set a parameter using QGroundControl
- Make sure you have the Calibration and On-board Parameters widget visible in QGroundControl (menu bar/Tool Widgets/Calibration and Parameters).
- Make sure you are connected to the FMU.
- If you are connected, there should be a list with the current parameter values visible. If this is not the case, press Refresh.
- Change the parameters' values.
- Press Set.
- If you are happy with the new parameter and want to save it permanently, press Write (ROM).
How to set a parameter using a Potentiometer Knob on your RC
Binding a parameter to a potentiometer knob on your RC is handy for tuning control gains. You will need at least 1 unused channel on you receiver. If you only have 8 channels in total you can map the switches to one channel on your RC to free up 3 channels. PX4 supports mapping up to 3 knobs to a parameter.
The following sequence describes the setup for one channel.
- Find the RC channel which your knob is controlling with the help of the RC Calibration tool in the Setup view
- Set the parameter `RC_MAP_PARAM1` (or 2/3) to the value obtained in 1 as described in 'How to set a parameter using QGroundControl' (don't forget to press Write (ROM))
- Make sure the knob on your RC is centered and the value visible in the RC Calibration tool in the Setup view is centered as well
- When you turn your knob every second the parameter will be updated to the value defined by the RC knob. To get the current value right-click on the parameter and hit Refresh this param. The general idea is that you don't have to look up the value while tuning. slowly turn the knob until you are happy with the behavior.
- If you are happy with the new parameter and want to save it permanently, press Write (ROM).
Note that if you restart the autopilot you will have to restart at step 4, as the settings are not stored for safety reasons.
Developer Information
Information on creating your own parameters can be found on this page.