Skip to content


着陆探测器是一个动态飞行器模型,代表了从接触地面到着陆的关键飞行器状态。 本节主题说明您可能希望调整的主要参数,以改善飞行器着陆行为。



您可以设置 COM_DISARM_LAND 来指定着陆后系统上锁前的秒数(或通过将参数设置为 -1 关闭自动上锁)。


所有的关于着陆探测器的参数集在参数索引中列出,带有前缀 LNDMC (可以通过参数编辑器在 QGroundControl 中编辑这些参数)。


Information about how the parameters affect landing can be found below in Land Detector States.


  • MPC_THR_HOVER-系统的悬停油门 (默认值为 50%)。 正确设置这一点是很重要的, 因为它使高度控制更加准确, 并确保正确的地面检测。 没有安装有效载荷的穿越机或大型相机的无人机可能需要更低的悬停油门 (例如 35%)。

    Incorrectly setting MPC_THR_HOVER may result in ground-contact or maybe-landed detection while still in air (in particular, while descending in Position mode or Altitude mode). 这将导致载具 "抽搐" (关闭电机,然后立即将其重新打开)。


  • MPC_THR_MIN-系统的全局最小油门。 应该将其设置为可控的下降
  • MPC_LAND_CRWL - the vertical speed applied in the last stage of autonomous landing if the system has a distance sensor and it is present and working. Has to be set larger than LNDMC_Z_VEL_MAX.

MC Land Detector States

为了探测着陆,多旋翼首先必须经历三个不同的状态,其中每个状态都包含来自先前状态的条件以及更严格的约束。 如果由于缺少传感器而无法达到条件,则默认情况下认为该条件为真。 For instance, in Acro mode and no sensor is active except for the gyro sensor, then the detection solely relies on thrust output and time.

In order to proceed to the next state, each condition has to be true for a third of the configured total land detector trigger time LNDMC_TRIG_TIME. If the vehicle is equipped with a distance sensor, but the distance to ground is currently not measurable (usually because it is too large), the trigger time is increased by a factor of 3.



Conditions for this state:

  • 没有垂直运动 (LNDMC_Z_VEL_MAX)
  • 没有水平运动 (LNDMC_XY_VEL_MAX)
  • lower thrust than MPC_THR_MIN + (hover throttle - MPC_THR_MIN) * (0.3, unless a hover thrust estimate is available, then 0.6),
  • additional check if vehicle is currently in a height-rate controlled flight mode: the vehicle has to have the intent to descend (vertical velocity setpoint above LNDMC_Z_VEL_MAX).
  • additional check for vehicles with a distance sensor: current distance to ground is below 1m.

If the vehicle is in position- or velocity-control and ground contact was detected, the position controller will set the thrust vector along the body x-y-axis to zero.


Conditions for this state:

  • all conditions of the ground contact state are true
  • 没有滚动运动 (LNDMC_Z_VEL_MAX)
  • 具有低推力 MPC_THR_MIN + (MPC_THR_HOVER - MPC_THR_MIN) * 0.1
  • no freefall detected

If the vehicle only has knowledge of thrust and angular rate, in order to proceed to the next state the vehicle has to have low thrust and no rotation for 8.0 seconds.

If the vehicle is in position or velocity control and maybe landed was detected, the position controller will set the thrust vector to zero.


Conditions for this state:

Fixed-wing Configuration

Tuning parameters for fixed-wing land detection:

  • LNDFW_AIRSPD_MAX----飞机降落时允许的最大空速。 Has to be a tradeoff between airspeed sensing accuracy and triggering fast enough. 越好的空速传感器允许此参数的值越低。
  • LNDFW_VEL_XY_MAX -是着陆时系统的最大水平速度,这应当被考虑,从而选择一个合适的值。
  • LNDFW_VEL_Z_MAX-是着陆时系统的最大垂直速度,这应当被考虑,从而选择一个合适的值。
  • LNDFW_XYACC_MAX - the maximal horizontal acceleration for the system to still be considered landed.
  • LNDFW_TRIG_TIME - Trigger time during which the conditions above have to be fulfilled to declare a landing.

When FW launch detection is enabled (FW_LAUN_DETCN_ON), the vehicle will stay in "landed" state until takeoff is detected (which is purely based on acceleration and not velocity).

VTOL Land Detector

The VTOL land detector is 1:1 the same as the MC land detector if the system is in hover mode. In FW mode, land detection is disabled.