Weathervaning and Wind Hold

Flying a QuadPlane in significant levels of wind can present a challenge. The issue is that the large wing surface offers a lot of surface area for the wind to interact with. That can lead to a reduction in attitude and position control and high motor and ESC load.

To reduce the impact of wind when flying in VTOL modes the ArduPilot QuadPlane code supports two features:

  • Active weathervaning
  • Position hold using forward motor

Together these two features can greatly reduce the impact of wind on VTOL flight by keeping the aircraft pointed into the wind and reducing the area of the wing exposed to the wind.

Active Weathervaning

Active weathervaning acts to turn the aircraft into the wind when flying in position-controlled VTOL modes. You can enable active weathervaning by setting the Q_WVANE_ENABLE parameter to a non-zero value. The default is not to use active weathervaning.

Q_WVANE_ENABLE Value Weathervane Direction
0 Disabled
1 Nose Into Wind(default)
2 Nose OR Tail Into Wind
3 Side Into Wind
4 Tail Into Wind

The way it works is the autopilot looks at the roll and/or pitch attitude needed to control the desired position. The basic algorithm is “yaw into the roll/pitch”. If the aircraft needs hold roll to the right in order to hold position then it will turn in that direction on the assumption that the right roll is needed in order to hold against the wind (assuming nose into the wind). Similarly, for Side Into the Wind, it will use the pitch angle and yaw appropriately, trying to zero the pitch required to hold position.

How quickly the aircraft yaws is determined by the Q_WVANE_GAIN parameter. It converts the lean angle into degs/sec of yaw. A good value to start with is 1 (1 degree roll = 1 deg/sec yaw). Higher values will make the aircraft turn into the roll more quickly. If the value is too high then you can get instability and oscillation in yaw.

To cope with a small amount of trim in the aircraft there is an additional parameter Q_WVANE_ANG_MIN which controls the minimum roll/pitch level before weathervaning will be used. This defaults to one degree. If you find your aircraft starts yawing even in no wind then you may need to raise this value.

Active weathervaning is only active in VTOL modes, and VTOL sections of AUTO modes (such as VTOL takeoff and VTOL landing). It is not active in QSTABILIZE and QHOVER modes as those are not position controlled modes. It is active is QLOITER, QLAND and QRTL modes.

There are a number of additional parameters that can control when WeatherVaning is active (all are disabled by default):

  • Q_WVANE_HGT_MIN :above this height weathervaning is permitted
  • Q_WVANE_SPD_MAX :below this ground speed weathervaning is permitted
  • Q_WVANE_VELZ_MAX :maximum climb or descent speed at which the vehicle will still attempt to weathervane
  • Q_WVANE_TAKEOFF :override weathervaning direction in auto takeoffs*
  • Q_WVANE_LAND :overide weathervaning directions in auto landings*

note:* not QLOITER take-offs and landings


Weathervaning can be disabled or enabled by an RC Aux Function Switch, option “160”

Using the Forward Motor

In addition to active weathervaning, the QuadPlane code supports using the forward motor to hold the pitch level in VTOL flight modes. To enable use of the forward motor for position hold you need to set the Q_VFWD_GAIN parameter to a non-zero value.

The way it works is to look at two factors:

  • the navigation attitude pitch of the aircraft
  • the difference between the desired forward velocity and the actual forward velocity

These are combined with the Q_VFWD_GAIN to ramp up and down the throttle on the forward motor in order to minimize the attitude pitch of the aircraft. That keeps the area of wing exposed to the wind minimized which can reduce VTOL motor load.

A good value to start with for Q_VFWD_GAIN is 0.05. Higher values will use the forward motor more aggressively. If the value is too high you can get severe pitch oscillations.

Note that you can also use reverse thrust on the forward motor. If your THR_MIN parameter is less than zero then reverse thrust is available and the motor will use reverse thrust to slow down or move backwards as needed. See the reverse thrust section in the automatic landing documentation for more details.

As with active weathervaning, using the forward motor is only enabled in position controlled VTOL modes. This means it is not enabled in QSTABILIZE or QHOVER flight modes. It is available in QLOITER, QRTL, QLAND and in AUTO mode when executing VTOL flight commands.


Tilt-Rotor QuadPlanes do not have this capability, since there is no separate forward motor.