Tuning guide
Two step-response curves can look similar in a screenshot and mean opposite things. One peaks above the command and rings back; the other stops short and stays there. Read the plateau before you read the peak.
A step response is a short time window around a fast stick input. The horizontal axis is time from the start of the move. The vertical axis is rate, normalised so the commanded step becomes the reference. One line is the setpoint — what the sticks asked for — and the other is the gyro, which is what the frame actually did.
It is an estimate, not a laboratory test. A single logged move can be noisy, so analysers either pick a representative clean step or average many windows across the flight. That choice matters: an average over unlike moves can smooth away the fault you are looking for, while a single hand-picked move can be unrepresentative. The useful question is not "what is the peak value" but "what shape repeats".
| What you see | What it means | Where to look |
|---|---|---|
| Peaks above the command, then rings back | Under-damped: too much gain for the phase left after filtering, or not enough damping | The P/D balance, the filter delay feeding it, and whether the gyro was clean enough for D to be useful |
| Levels off below the command and stays there | Steady-state error: the integrator did not make up the remaining difference | I and iterm_relax — relax deliberately holds I down during fast moves, and too much suppression looks exactly like too little I |
| Rises, turns early, then slowly creeps up to the command | The integrator is doing the work after the fast terms have finished | I authority and relax timing, not the D gain |
| Peak is high but the curve settles immediately without ringing | Mostly feedforward and stick speed, not a P/D fault | Whether the move was a full-stick snap; compare with a smaller flick |
Feedforward responds to how fast the stick moves. A full-stick snap is about as fast as a stick can move, so feedforward contributes a large part of the peak. The same quad flown with a slower, smaller input may overshoot much less. If you tune the overshoot of a full-stick snap down to a number copied from someone else's quad, you may be tuning the stick speed rather than the control loop.
Other confounders:
A usable step chart has a clear command edge, a gyro trace that follows it, and a held portion long enough to see where the response settles. A chart that cannot support a decision usually has one of these shapes:
In each case the correct action is to fly a better log, not to choose a smaller adjustment and hope. A conservative change based on an unreadable chart is still a change based on nothing.
Rolls and flips are not a substitute for isolated flicks. A flip couples roll and pitch and often ends with the motors near saturation, which is exactly the condition that makes a step chart unrepresentative.
The analyser reports each axis separately. It measures overshoot, rise time, tracking error and the steady-state plateau, then labels the chart as usable, weak or unusable. A weak axis contributes less to the suggestion; an unusable axis contributes nothing, because there is nothing measured to contribute. Droop is only treated as evidence when the chart is clean and the response genuinely levels off below the command — otherwise too much damping could be mistaken for too little integrator.
That is also why the output is per-axis rather than one "tune quality" score. A quad can overshoot on roll and droop on pitch in the same flight. One number would average those into a middle that describes neither axis.
Two time-aligned traces around a fast stick input: the commanded rate and the measured gyro rate, normalised so the command is the reference. It is an estimate from one or more moves, not a lab test.
Overshoot passes the command and comes back. Droop stops short and stays there while the stick is still held. Overshoot is a damping question; droop is a steady-state error question.
The log did not contain a clean, measurable step on that axis. That is missing evidence, not a good result.
A target from another quad is not a measurement of yours. Feedforward, stick speed, rates, throttle and saturation all move the peak. Compare against your own logs and let the shape decide which family to inspect.
Easyquadtune aligns the gyro to the setpoint, measures overshoot and the steady-state plateau per axis, and refuses to invent a number when the chart cannot support one. First log is free per browser.
More guides: how to read a blackbox log, wobble on hard stops, frame resonance vs prop noise, I-term relax, dips in fast turns, when a log is not good enough.
Easyquadtune is not affiliated with the Betaflight project. Always fly responsibly and perform an initial hover test in a safe environment after any tuning change. The worked example on this site is an illustrative render, not a customer log.