# VTOL Back-transition Tuning

Note

Some of the following features will be available in PX4 version 1.7 and are currently only available on the experimental development branch.

When a VTOL performs a back-transition (transition from fixed wing mode to multicopter) it needs to slow down before the multicopter can take proper control. As of PX4 version 1.7, and on the current developer branch, the vehicle will consider the back-transition complete when the horizontal speed has reached multicopter cruise speed (MPC_XY_CRUISE) or when the back-transition duration (VT_B_TRANS_DUR) has passed (whichever comes first).

# Back-transition duration

Setting a high back-transition time (VT_B_TRANS_DUR) will give the vehicle more time to slow down. During this period the VTOL will shut down its fixed wing motor and slowly ramp up its MC motors while gliding. The higher this time is set the longer the vehicle will glide in an attempt to slow down. The caveat of this behavior is that the vehicle will only control altitude and not position during this period, so some drift can occur.

# Setting expected deceleration

When flying missions that make use of a VTOL_LAND (opens new window) waypoint the autopilot will attempt to calculate the proper distance at which to initiate the back-transition. It does this by looking at the current velocity (comparable to ground speed) and the expected deceleration. To get the vehicle to come out of back-transition very close to its landing point you can tune the expected deceleration (VT_B_DEC_MSS) parameter. Make sure you have a large enough back-transition duration to allow the vehicle to reach its intended position before this timeout kicks in.

# Applying airbrakes

If your vehicle is equipped with airbrakes, and your selected airframe supports them (in code), you can set the airbrake position during back-transition in VT_B_REV_OUT. The values scale from 0 to 1, so a value of 0.7 equals 70% output.

# Applying reverse thrust on your fixed wing motor

To get the shortest possible back-transition, PX4 supports active breaking by reversing the fixed wing motor direction. To use this feature you will require an ESC that supports motor rotation reversing.

Note

A typical fixed wing propeller is not optimized to spin in reverse, when the throttle during reverse thrust is set too high the propeller can stall.

Generally there are 2 ways a reverse-capable ESC can implement reverse thrust.

# Using throttle scaling (3D)

Normally the throttle stick is used purely for forward thrust.

3D ESCs assume 0 thrust at 50% throttle, positive (forward) thrust above 50% and negative thrust (reverse) below 50%. The airframe can be modified to implement this behaviour only during back transition, allowing reverse thrust to be applied during the transition.

WARNING

Support for 3D throttle scaling during back-transition requires code support in the airframe.

The amount of negative thrust during back transition can then be configured using the VT_B_TRANS_THR parameter (set to a negative value between 0 and -1).

# On a control channel

ESCs that use a separate control channel to control the motor direction (e.g. Hobbywing Platinum series (opens new window)) can use the airbrakes channel to apply reverse thrust during back-transition.

Airframes that have been configured to support this behavior (like the DeltaQuad airframe) can be configured to do so by setting both VT_B_REV_OUT to 1 and VT_B_TRANS_THR to the desired throttle level to apply for active breaking. The values scale from 0 to 1, so a value of 0.7 equals 70% throttle.

# Typical setup

An example of a setup that employs most features listed above would be the following:

  • Airframe: Any VTOL supporting reverse thrust (e.g. DeltaQuad)
  • ESC: A fixed wing ESC that supports motor reversing (e.g. Hobbywing Platinum Pro 60A)
  • Estimated deceleration value in m/s/s VT_B_DEC_MSS: 2.5
  • Back-transition duration timeout in seconds VT_B_TRANS_DUR: 10
  • Set reverse channel high during back-transition VT_B_REV_OUT: 1.0
  • Apply 70% thrust during back-transition VT_B_TRANS_THR: 0.7