Hamish Willee 88d623bedb
Move PX4 Guide source into /docs (#24490)
* 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>
2025-03-13 16:08:27 +11:00

3.7 KiB

Hold Mode (Multicopter)

The Hold flight mode causes the vehicle to stop and hover at its current GPS position and altitude.

:::tip Hold mode can be used to pause a mission or to help you regain control of a vehicle in an emergency. It is usually activated with a pre-programmed switch. :::

::: info

  • Mode is automatic - no user intervention is required to control the vehicle.
  • Mode requires a global 3d position estimate (from GPS or inferred from a local position).
    • Flying vehicles can't switch to this mode without global position.
    • Flying vehicles will failsafe if they lose the position estimate.
    • Disarmed vehicles can switch to mode without valid position estimate but can't arm.
  • Mode requires wind and flight time are within allowed limits (specified via parameters).
  • RC control switches can be used to change flight modes on any vehicle.
  • RC stick movement will by default change the vehicle to Position mode unless handling a critical battery failsafe.

:::

Technical Summary

The vehicle hovers at the current position and altitude. The vehicle will first ascend to NAV_MIN_LTR_ALT if the mode is engaged below this altitude.

RC stick movement will change the vehicle to Position mode (by default).

Parameters

Hold mode behaviour can be configured using the parameters below.

Parameter Description
NAV_MIN_LTR_ALT This is the minimum altitude above Home the system will always obey in Hold mode if switched into this mode without specifying an altitude (e.g. through switch on RC).
COM_RC_OVERRIDE Controls whether stick movement on a multicopter (or VTOL in MC mode) causes a mode change to Position mode. This can be separately enabled for auto modes and for offboard mode, and is enabled in auto modes by default.
COM_RC_STICK_OV The amount of stick movement that causes a transition to Position mode (if COM_RC_OVERRIDE is enabled).

See Also

Hold Mode (FW)