mirror of
https://github.com/PX4/PX4-Autopilot.git
synced 2026-07-24 15:27:41 +08:00
88d623bedb
* Add vitepress tree * Update existing workflows so they dont trigger on changes in the docs path * Add nojekyll, package.json, LICENCE etc * Add crowdin docs upload/download scripts * Add docs flaw checker workflows * Used docs prefix for docs workflows * Crowdin obvious fixes * ci: docs move to self hosted runner runs on a beefy server for faster builds Signed-off-by: Ramon Roche <mrpollo@gmail.com> * ci: don't run build action for docs or ci changes Signed-off-by: Ramon Roche <mrpollo@gmail.com> * ci: update runners Signed-off-by: Ramon Roche <mrpollo@gmail.com> * Add docs/en * Add docs assets and scripts * Fix up editlinks to point to PX4 sources * Download just the translations that are supported * Add translation sources for zh, uk, ko * Update latest tranlsation and uorb graphs * update vitepress to latest --------- Signed-off-by: Ramon Roche <mrpollo@gmail.com> Co-authored-by: Ramon Roche <mrpollo@gmail.com>
47 lines
2.2 KiB
Markdown
47 lines
2.2 KiB
Markdown
# Switching State Estimators
|
|
|
|
This page shows you which state estimators are available and how you can switch between them.
|
|
|
|
:::tip
|
|
EKF2 is the default and should be used unless you have a reason not to (in particular on vehicles with a GNSS/GPS).
|
|
The Q-Estimator can be used if you don't have GPS, and is commonly used in [multicopter racers](../config_mc/racer_setup.md).
|
|
:::
|
|
|
|
## Available Estimators
|
|
|
|
The available estimators are:
|
|
|
|
- **EKF2 attitude, position and wind states estimator** (_recommended_) - An extended Kalman filter estimating attitude, 3D position / velocity and wind states.
|
|
- **LPE position estimator** (_deprecated_) - An extended Kalman filter for 3D position and velocity states.
|
|
|
|
:::warning
|
|
LPE is deprecated.
|
|
It works (at time of writing, in PX4 v1.14) but is no longer supported or maintained.
|
|
:::
|
|
|
|
- **Q attitude estimator** - A very simple, quaternion based complementary filter for attitude.
|
|
It does not require a GPS, magnetometer, or barometer.
|
|
<!-- Q estimator is supported (at time of writing in PX4 v1.14). Test added in PX4-Autopilot/pull/21922 -->
|
|
|
|
## How to Enable Different Estimators
|
|
|
|
<!-- Changed in https://github.com/PX4/PX4-Autopilot/pull/22567 after v1.14 -->
|
|
|
|
To enable a particular estimator enable its parameter and disable the others:
|
|
|
|
- [EKF2_EN](../advanced_config/parameter_reference.md#EKF2_EN) - EKF2 (default/recommended)
|
|
- [ATT_EN](../advanced_config/parameter_reference.md#ATT_EN) - Q Estimator (quaternion based attitude estimator)
|
|
- [LPE_EN](../advanced_config/parameter_reference.md#LPE_EN) - LPE (not supported for Fixed-wing)
|
|
|
|
::: warning
|
|
It is important to enable one, and only one, estimator.
|
|
If more than one is enabled, the first to publish the UOrb topics [vehicle_attitude](../msg_docs/VehicleAttitude.md) or [vehicle_local_position](../msg_docs/VehicleLocalPosition.md) is used.
|
|
If none are enabled then the topics are not published.
|
|
:::
|
|
|
|
::: info
|
|
For FMU-v2 (only) you will also need to build PX4 to specifically include required estimator (e.g. EKF2: `make px4_fmu-v2`, LPE: `make px4_fmu-v2_lpe`).
|
|
This is required because FMU-v2 is too resource constrained to include both estimators.
|
|
Other Pixhawk FMU versions include both.
|
|
:::
|