← All tools

Message & Error Explainer

What an ArduPilot message means and what to do about it

Українська

The QuikTune script stopped, or would not start

WarningAutoTune and control

What ArduPilot says:

“Tuning: Must be flying to tune”: the switch is in the tune position but the aircraft is disarmed or not yet flying (repeated every 5 s). “Tuning: reverted”: the switch went low, or the aircraft landed or disarmed, before the tune was saved; the gains from before are back. “attitude error … ABORTING”: the aircraft was more than QUIK_ANGLE_MAX (10° by default) away from the attitude asked of it, so the old gains were put back at once. “Quicktune unknown vehicle”: the script found neither Copter's nor QuadPlane's parameters. The first two are sent at the highest severity; they are not emergencies.

What to do, most likely first

  1. “attitude error”: a gain rose into a real oscillation before the script caught it, or a gust or a stick movement tilted the aircraft.

    FixMove the switch low to reset, then fly the tune again in calm air with the sticks left alone. A higher QUIK_DOUBLE_TIME tunes more slowly and a lower QUIK_OSC_SMAX stops each gain earlier.

  2. “reverted” when you meant to keep the tune: the switch went low, or you landed, before saving.

    FixAfter “Tuning: DONE” move the switch high and wait for “Tuning: saved”; with a two-position switch set bit 0 of QUIK_OPTIONS and QUIK_AUTO_SAVE to a few seconds.

  3. “Must be flying”: the switch was left in the tune position on the ground.

    FixSwitch low, take off and hover, then move the switch to the middle.

Parameters to look at

ParameterWhat it is
QUIK_ENABLEQuicktune enable
QUIK_RC_FUNCQuicktune RC function
QUIK_ANGLE_MAXmaximum angle error for tune abort
QUIK_DOUBLE_TIMEQuicktune doubling time
QUIK_OSC_SMAXQuicktune oscillation rate threshold
QUIK_AUTO_SAVEQuicktune auto save
QUIK_OPTIONSQuicktune options
The code that sends it

Tuning: attitude error N.Ndeg - ABORTING

libraries/AP_Scripting/applets/VTOL-quicktune.lua update() · Open in ArduPilot Copter-4.7.1

Quicktune unknown vehicle

libraries/AP_Scripting/applets/VTOL-quicktune.lua bind_add_param() · Open in ArduPilot Copter-4.7.1

Tuning: reverted

libraries/AP_Scripting/applets/VTOL-quicktune.lua update() · Open in ArduPilot Copter-4.7.1

Tuning: Must be flying to tune

libraries/AP_Scripting/applets/VTOL-quicktune.lua update() · Open in ArduPilot Copter-4.7.1

Written here for Copter 4.6. In the tool you choose your vehicle and version, see your own parameter values beside the ones named here, and drop a flight log to have every message in it explained.

Open it in the Message & Error Explainer