Skip to content

Return Mode (Multicopter)

The Return flight mode is used to fly a vehicle to safety on an unobstructed path to a safe destination, where it can land.

Multicopters use a home/rally point return type by default. In this return type vehicles ascend to a safe altitude above obstructions if needed, fly directly to the closest safe landing point (a rally point or the home position), descend to the "descent altitude", wait briefly, and then land. The return altitude, descent altitude, and landing delay are normally set to conservative "safe" values, but can be changed if needed.

Multicopter supports the other PX4 return types, including mission landing, mission path and closest safe destination. The default type is recommended.

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.
  • Mode requires home position is set.
  • Mode prevents arming (vehicle must be armed when switching to this mode).
  • RC 제어 스위치는 기체의 비행 모드를 변경할 수 있습니다.
  • RC stick movement will by default change the vehicle to Position mode unless handling a critical battery failsafe.

Technical Summary

Multicopters use the home/rally point return type by default. For this return type the copter:

  • Ascends to the minimum return altitude (safely above any expected obstacles). The vehicle maintains its initial altitude if that is higher than the minimum return altitude.
  • Flies via a direct constant-altitude path to the safe landing point, which will be the nearest of any rally points and the home position.
  • On arrival at its destination, it rapidly descends to the "descent altitude" (RTL_DESCEND_ALT).
  • It waits for a configurable time (RTL_LAND_DELAY), which may be used for deploying landing gear.
  • Then lands.

목적지에 호버링/착륙

By default the minimum return altitude is set using RTL_RETURN_ALT, and the vehicle will just return at the higher of RTL_RETURN_ALT or the initial vehicle altitude.

The minimum return altitude can be further configured using RTL_CONE_ANG, which together with RTL_RETURN_ALT defines a half cone centered around the destination landing point. The cone angle allows a lower minimum return altitude when the return mode is executed close to the destination. This is useful when there are few obstacles near the destination, because it may reduce the minimum height that the vehicle needs to ascend before landing, and hence power consumption and time to land.

Return mode cone

The cone affects the minimum return altitude if return mode is triggered within the cylinder defined by the maximum cone radius and RTL_RETURN_ALT: outside this cyclinder RTL_RETURN_ALT is used. Inside the code the minimum return altitude is the intersection of the vehicle position with the cone, or RTL_DESCEND_ALT (whichever is higher). In other words, the vehicle must always ascend to at least RTL_DESCEND_ALT if below that value.

For more information on this return type see Home/Rally Point Return Type (RTL_TYPE=0)

매개변수

The RTL parameters are listed in Parameter Reference > Return Mode.

The parameters that are relevant to multicopter (assuming the RTL_TYPE is set to 0) are listed below.

매개변수설명
RTL_RETURN_ALTReturn altitude in meters (default: 60m) when RTL_CONE_ANG is 0. 이미 이 값을 초과하면 기체는 현재 고도로 복귀합니다.
RTL_DESCEND_ALT기체가 더 높은 복귀 고도에서 감속하거나 초기 하강을 중지할 최소 복귀 고도 및 고도 (기본값 : 30m)
RTL_LAND_DELAYTime to hover at RTL_DESCEND_ALT before landing (default: 0.5s) -by default this period is short so that the vehicle will simply slow and then land immediately. If set to -1 the system will loiter at RTL_DESCEND_ALT rather than landing. 이 지연은 랜딩 기어가 배치될 시간을 설정합니다. (자동으로 동작함).
RTL_MIN_DIST홈 위치에서 "원뿔"에 지정된 복귀 고도까지 상승을 시작하는 최소 수평 거리. If the vehicle is horizontally closer than this distance to home, it will return at its current altitude or RTL_DESCEND_ALT (whichever is higher) instead of first ascending to RTL_RETURN_ALT).
RTL_CONE_ANG기체 RTL 리턴 고도를 정의하는 원뿔의 반각. 값 (도) : 0, 25, 45, 65, 80, 90. Note that 0 is "no cone" (always return at RTL_RETURN_ALT or higher), while 90 indicates that the vehicle must return at the current altitude or RTL_DESCEND_ALT (whichever is higher).
COM_RC_OVERRIDEControls whether stick movement on a multicopter (or VTOL in MC mode) causes a mode change to Position mode (except when vehicle is handling a critical battery failsafe). 자동 모드와 오프보드 모드에 대해 별도로 활성화할 수 있으며, 기본적으로 자동 모드에서 활성화됩니다.
COM_RC_STICK_OVThe amount of stick movement that causes a transition to Position mode (if COM_RC_OVERRIDE is enabled).

See Also