Tuning guide
I-term relax is one of the few settings that can fix a fault and create its opposite with the same slider. The cutoff also moves in the opposite direction to the way most people expect. Here is what it is doing.
P reacts to the current error. D reacts to how fast the error is changing. I reacts to the error that has accumulated over time, which is what keeps the quad holding an attitude when a steady disturbance — wind, an off-centre battery, a bent arm — keeps pushing it off target.
That accumulation is useful in a hover and a liability in a fast move. If I builds up during a long roll, it is still pushing after the stick stops, and the quad rotates back past the point you asked for. That is bounceback. I-term relax exists to stop I accumulating during the fastest part of the move.
A lower cutoff suppresses I earlier and holds it down for longer. A higher cutoff lets I come back sooner. So:
This is the single most useful thing to understand about the setting. If you raise the cutoff to cure bounceback, you are weakening the mechanism that was supposed to cure it.
| What you see | When | What it means |
|---|---|---|
| Quad rotates back or oscillates once after a flip or roll | After the stick has stopped | I wound up during the move and is unwinding. Relax is not suppressing it enough, or I itself is too high for the build. |
| Nose or attitude sags while the turn is still being held | During a sustained fast turn | I is not accumulating enough to hold the attitude. Relax may be suppressing too early or too long, or I is too low. |
| Fast ring during the move, not after it | While the stick is still moving | This is the P/D balance, not relax. Do not answer it with the relax cutoff. |
| Wobble only near idle | Throttle near the bottom | Thrust and idle, not the integrator. See the hard-stop guide. |
The two faults are easy to confuse because both look like "the quad is not doing what I asked". The timing is the tell: after the move is bounceback, during a held turn is droop.
Find a move where the stick goes in fast and then stops. Zoom in on the gyro, the setpoint and the I-term trace.
iterm_relax selects which axes are relaxed. Roll and pitch
are the usual choice; yaw is usually left alone because yaw authority
comes from motor inertia rather than thrust, and the behaviour is
different. iterm_relax_type selects the signal used to detect
a fast move: setpoint or gyro. Betaflight's documentation says setpoint is
the default and that gyro mode was a workaround for an older setpoint
problem, so current firmware should normally be on setpoint.
The _INC modes only stop I from increasing during
the move; they still let it decrease when the offset is no longer needed.
That can resolve the post-move offset faster than plain RP. It is a
different trade from changing the cutoff, which is why it is worth
separating "how early" from "how completely".
The analyser detects post-maneuver integrator activity and measures whether a chart-grade step settles below the commanded rate. It uses those two signals separately: one points toward stronger suppression, the other toward less. When both appear, the output says so rather than pretending there is a single direction that fixes both.
The relax policy is also profile-aware. A race tune wants I available quickly for tight turns; a freestyle or cinematic build can tolerate longer suppression. The tool starts from the logged value and the class baseline, then moves only when the log supports it. It does not publish a universal cutoff, because there is no universal quad.
No. Lower means suppression starts earlier and lasts longer. That is stronger relaxation.
Bounceback happens after the move, when the integrator unwinds. Droop happens while the stick is held, when the response settles below the command. The same setting can influence both, in opposite directions.
Betaflight's documentation treats setpoint as the default and says gyro mode was a workaround for an older setpoint issue. On current firmware, start from setpoint.
Yes. If it suppresses I too early or for too long for the build, the quad can sag in a sustained turn. The log shows the response below the command while the stick is still held.
Easyquadtune measures post-move integrator activity and steady-state droop separately, then suggests a direction instead of a universal cutoff. First log is free per browser.
More guides: how to read a blackbox log, wobble on hard stops, overshoot vs droop, frame resonance vs prop noise, 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.