mirror of
https://github.com/PX4/PX4-Autopilot.git
synced 2026-11-22 14:19:57 +08:00
* docs(msg): add missing uORB message pages to SUMMARY The msg_docs block in SUMMARY.md is not regenerated by the metadata sync, so seven message pages were unreachable from the sidebar (PageNotInTOC). Replace the block with the fragment written by generate_msg_docs.py, which also moves VehicleControlMode to the unversioned list. Assisted-by: Claude:claude-opus-5-5 Signed-off-by: Hamish Willee <hamishwillee@gmail.com> * docs: fix broken and permanently redirected external links CUAV moved its docs to a /en/<product>/ layout, so the Nora, C-RTK 9Ps and C-RTK2 links returned 404. Other vendor links (InvenSense, Bosch, ARK, CORVON) permanently redirect; point them at the final URL. Assisted-by: Claude:claude-opus-5-5 Signed-off-by: Hamish Willee <hamishwillee@gmail.com> * docs: fix remaining dead external links RaccoonLab's store product pages, the CubeNode pin descriptions, wiki.ubuntu.com/LTS and the Bitbucket NuttX repos no longer resolve. RaccoonLab now only has docs pages for these devices, so link those. ubuntu.sh and macos.sh already install kconfig-frontends, so the NuttX porting guide no longer tells Ubuntu users to build it from source; the old steps are kept in a comment. Assisted-by: Claude:claude-opus-5-5 Signed-off-by: Hamish Willee <hamishwillee@gmail.com> * docs: ignore unresolvable external links for 6 months These links fail the external link check for reasons a docs edit can't fix: bot blocking (raccoonlab.co, gitlab.arm.com), expired vendor certificates (svehicle.cn, jmarple.ai), and the ARKV6X-RT order link, which is waiting on a replacement URL from ARK. Assisted-by: Claude:claude-opus-5-5 Signed-off-by: Hamish Willee <hamishwillee@gmail.com> --------- Signed-off-by: Hamish Willee <hamishwillee@gmail.com>
81 lines
4.8 KiB
Markdown
81 lines
4.8 KiB
Markdown
# Barometers
|
|
|
|
Barometers measure atmospheric pressure, and are used in drones as altitude sensors.
|
|
|
|
Most [flight controllers](../flight_controller/index.md) on which PX4 runs include a barometer.
|
|
By default PX4 will select the barometer with the highest priority (if any are present), and configure it as a data source for [Height estimation](../advanced_config/tuning_the_ecl_ekf.md#height).
|
|
If a sensor fault is detected, PX4 will fall back to the next highest priority sensor.
|
|
|
|
Generally barometers require no user configuration (or thought)!
|
|
|
|
## Hardware Options
|
|
|
|
[Pixhawk standard](../flight_controller/autopilot_pixhawk_standard.md) flight controllers include a barometer, as do [many others](../flight_controller/index.md).
|
|
|
|
They are also present in other hardware:
|
|
|
|
- [CUAV NEO 3 Pro GNSS module](https://doc.cuav.net/gps/neo-series-gnss/en/neo-3-pro.html#key-data) ([MS5611](../modules/modules_driver_baro.md#ms5611))
|
|
- [RaccoonLab L1 GNSS NEO-M8N](https://docs.raccoonlab.co/guide/gps_mag_baro/)
|
|
|
|
At time of writing, drivers/parts include: bmp280, bmp388 (and BMP380), dps310, goertek (spl06), invensense (icp10100, icp10111, icp101xx, icp201xx), lps22hb, lps25h, lps33hw, maiertek (mpc2520), mpl3115a2, ms5611, ms5837, tcbp001ta.
|
|
|
|
Note that the supported barometer part numbers can be inferred from the driver names listed in the [Modules Reference: Baro (Driver)](../modules/modules_driver_baro.md) documentation (and the driver source: [PX4-Autopilot/src/drivers/barometer](https://github.com/PX4/PX4-Autopilot/tree/main/src/drivers/barometer)).
|
|
|
|
## PX4 Configuration
|
|
|
|
Generally barometers require no user configuration.
|
|
If needed, you can:
|
|
|
|
- Enable/Disable barometers as data source for [Height estimation](../advanced_config/tuning_the_ecl_ekf.md#height) using the [EKF2_BARO_CTRL](../advanced_config/parameter_reference.md#EKF2_BARO_CTRL) parameter.
|
|
- Change the selection order of barometers using the [CAL_BAROx_PRIO](../advanced_config/parameter_reference.md#CAL_BARO0_PRIO) parameters for each barometer.
|
|
- Disable a barometer by setting its [CAL_BAROx_PRIO](../advanced_config/parameter_reference.md#CAL_BARO0_PRIO) value to `0`.
|
|
|
|
## Baro Auto-Calibration (Developers)
|
|
|
|
::: tip
|
|
This section documents the automated calibration mechanisms that ensure accurate altitude measurements throughout flight operations.
|
|
It is intended primarily for a developer audience who want to understand the underlying mechanisms.
|
|
:::
|
|
|
|
The system implements two complementary calibration approaches that work together to maintain altitude measurement precision.
|
|
Both calibrations are initiated at the beginning after a system boot.
|
|
Relative calibration is performed first, followed by GNSS-barometric calibration.
|
|
|
|
### Relative Calibration
|
|
|
|
Relative baro calibration is **always enabled** and operates automatically during system initialization.
|
|
This calibration establishes offset corrections for all secondary baro sensors relative to the primary (selected) sensor.
|
|
|
|
This calibration:
|
|
|
|
- Eliminates altitude jumps when switching between baro sensors during flight.
|
|
- Ensures consistent altitude readings across all available baro sensors.
|
|
- Maintains seamless sensor redundancy and failover capability.
|
|
|
|
### GNSS-Baro Calibration
|
|
|
|
::: info
|
|
GNSS-baro calibration requires an operational GNSS receiver with vertical accuracy (EPV) ≤ 8 meters.
|
|
Relative calibration must already have completed.
|
|
:::
|
|
|
|
GNSS-baro calibration adjusts baro sensor offsets to align with absolute altitude measurements from the GNSS receiver.
|
|
This calibration is controlled by the [SENS_BAR_AUTOCAL](../advanced_config/parameter_reference.md#SENS_BAR_AUTOCAL) parameter (enabled by default).
|
|
|
|
The algorithm monitors GNSS quality, collects altitude differences over a 2-second filtered window, and verifies stability within 4m tolerance.
|
|
Once stable, it uses binary search to calculate pressure offsets that align baro altitude with GNSS altitude (0.1m precision), then applies the offset to all sensors and saves the parameters.
|
|
|
|
Notes:
|
|
|
|
- **EKF Independence**: GNSS-baro calibration operates independently of EKF2 altitude fusion settings.
|
|
- **Execution Timing**: Calibration runs even when [EKF2_GPS_CTRL](../advanced_config/parameter_reference.md#EKF2_GPS_CTRL) altitude fusion is disabled.
|
|
- **One-Time Process**: Each calibration session completes once per system startup.
|
|
- **Persistence**: Calibration offsets are saved to parameters and persist across reboots.
|
|
- **Faulty GNSS Vulnerability**: If GNSS data is faulty during boot, the calibration will use incorrect altitude reference.
|
|
See [Faulty GNSS Data During Boot](../advanced_config/tuning_the_ecl_ekf.md#faulty-gnss-data-during-boot) for mitigation strategies.
|
|
|
|
## See Also
|
|
|
|
- [Baro driver source code](https://github.com/PX4/PX4-Autopilot/tree/main/src/drivers/barometer)
|
|
- [Modules Reference: Baro (Driver)](../modules/modules_driver_baro.md) documentation.
|