Finding/Updating Parameters
Last updated
Last updated
PX4 behaviour can be configured/tuned using (e.g. , calibration information, etc.).
The QGroundControl Parameters screen allows you to find and modify any of the parameters associated with the vehicle. The screen is accessed by clicking the Q application icon > Vehicle Setup, and then Parameters in the sidebar.
:::note Most of the more commonly used parameters are more conveniently set using the dedicated setup screens, as described in the section. The Parameters screen is needed when modifying less commonly modified parameters - for example while tuning a new vehicle. :::
:::warning While some parameters can be changed in flight, this is not recommended (except where explicitly stated in the guide). :::
You can search for a parameter by entering a term in the Search field. This will show you a list of all parameter names and descriptions that contain the entered substring (press Clear to reset the search, and use the Show modified only checkbox to filter out unchanged parameters).
You can also browse the parameters by type and group by clicking on the buttons to the left (in the image below the DShot group in the Standard parameters is selected).
Parameters are usually not visible because either they are conditional on other parameters, or they are not present in the firmware (see below).
A parameter may not be displayed if it is conditional on another parameter that is not enabled.
A parameter may not be present in the firmware because you're using a different version of PX4 or because you're using a build in which the associated module is not included.
The other reason that a parameter might not be in firmware is if its associated module has not been included. This is a problem (in particular) for FMUv2 firmware, which omits many modules so that PX4 can fit into the 1MB of available flash. There are two options to solve this problem:
:::note You may also need to disable other modules in order to fit the rebuilt firmware into 1MB flash. Finding modules to remove requires some trial/error and depends on what use cases you need the vehicle to meet. :::
To change the value of a parameter click on the parameter row in a group or search list. This will open a side dialog in which you can update the value (this dialog also provides additional detailed information about the parameter - including whether a reboot is required for the change to take effect).
:::note When you click Save the parameter is automatically and silently uploaded to the connected vehicle. Depending on the parameter, you may then need to reboot the flight controller for the change to take effect. :::
You can select additional options from the Tools menu on the top right hand side of the screen.
Refresh Refresh the parameter values by re-requesting all of them from the vehicle.
Reset all to firmware defaults Reset all parameters to their original default values in the firmware.
Reset to vehicle's configuration defaults Reset all parameters to their original default values for the particular selected airfame configuration.
Load from file / Save to file Load parameters from an existing file or save your current parameter settings to a file.
Reboot Vehicle Reboot the vehicle (required after changing some parameters).
You can expand/collapse the "type" groupings as shown. Note that the groups at the bottom named Component X are attached ("X" is the node id). of these peripherals if they are attached to the Flight Controller when QGC is started.
:::tip If you can't find an expected parameter, see the . :::
You can usually find out what parameters are conditional by searching the and other documentation. In particular depend on what service is assigned to a serial port.
New parameters are added in each PX4 version, and existing parameters are sometimes removed or renamed. You can check whether a parameter should be present by reviewing the for the version you're targeting. You can also search for the parameter in the source tree and in the release notes.
Check if you can update your board to run FMUv3 firmware, which includes all modules:
If your board can only run FMUv2 firmware you will need to with the missing modules enabled. You need reconfigure the PX4 firmware itself through make px4_fmuv2_default boardconfig where you can enabled/disable modules.
Clear all RC to Param This clears all associations between RC transmitter controls and parameters. For more information see: .
