Tuning guide
A blackbox spectrum tells you where the energy is. It does not tell you what made it. The difference between a fixed frame tone and a throttle-tracking prop ridge is visible in the log — but naming the cause still needs a hardware check.
The FFT takes the gyro signal, cuts it into windows, and shows how much energy sits at each frequency. That is a measurement. It becomes a diagnosis only when the peak's behaviour — fixed or moving, narrow or broad, one axis or several — matches a physical mechanism you can verify.
This is why "there is a peak at 180 Hz" is not a useful tuning instruction on its own. A motor harmonic, a frame mode, a camera mount and a loose screw can all put energy at the same frequency. The useful instruction is "this peak stays put while throttle changes, so check the frame hardware before you filter it".
| Signature | What it looks like | What it is consistent with |
|---|---|---|
| Fixed tone | A narrow peak whose centre stays at the same frequency from hover to full throttle. It may be strongest where a motor harmonic crosses it. | A frame, arm, standoff or mount resonance — a mechanical mode of the structure. Check screws, carbon and mounts before filtering. |
| Moving ridge | A ridge that climbs as RPM climbs, often with evenly spaced copies at higher frequencies. In a spectrogram it is diagonal. | Motor rotation and propeller blade-pass energy, plus their harmonics. Normal at some level; a problem when it is excessive or reaches the control loop. |
| Broad raised floor | No single dominant peak; the whole band is louder than it should be. | Many small sources at once: damaged props, dirty motors, a hard-mounted FC, wiring rattling, or simply a noisy build. |
The fixed-versus-moving distinction is the one that changes the fix. A static notch is only meaningful for a tone that does not move. A motor harmonic that sweeps with throttle needs a filter that tracks RPM, not a fixed notch at one throttle setting.
Lowering a lowpass reduces the noise the controller sees, but it also adds phase delay. That delay makes the quad respond later, which can increase overshoot and make the tune feel disconnected. If the noise is a fixed frame tone, a correctly placed notch is more targeted than lowering every filter. If the noise is motor harmonics, RPM filtering is the mechanism designed for it. If the noise is a damaged prop, neither filter is the fix.
The safe order is mechanical first, then the most targeted filter that addresses the confirmed pattern, then re-log. Filtering below what the evidence requires buys nothing and costs phase.
It cannot tell you whether a peak is "too much". A normal motor harmonic can be taller than a frame tone that is actually causing a problem. It cannot tell you the condition of a bearing from a single flight. It cannot separate two sources that happen to share a frequency. And it cannot prove a filter change helped: only a before/after log with the same props, battery and maneuvers can do that.
This is why a good analyser hedges. "Consistent with a frame resonance" is a testable statement. "Your frame resonates" is not, unless someone has checked the frame.
The analyser requires a peak to stand above the local noise floor, to have a believable width, and — for the mechanical labels — to be confirmed on more than one axis. It compares the high-throttle band with the cruise band instead of averaging the whole flight into one spectrum, because a short punchout disappears in a whole-log average. It reports the peak and the likely category, then recommends a hardware check rather than a filter value.
A peak that is consistent with damage is still only a flag. The next step is always "look at the prop, the screw, the mount", because that is the only way to turn a correlation into a cause.
No. It proves the gyro saw energy there. A motor harmonic or an electrical source can land at the same frequency. A throttle sweep, a prop swap or a bench check is what turns the peak into a diagnosis.
Rotation frequency rises with RPM, and blade-pass frequency is rotation frequency times blade count. Their harmonics move too, which is why they appear as diagonal ridges rather than fixed lines.
That trades noise for phase delay and leaves the cause in place. Filter only as far as the evidence requires, after the mechanical cause has been checked.
No. A static notch suits a tone that does not move. A motor harmonic sweeps with RPM, so a fixed notch covers it at one throttle setting only.
Easyquadtune computes the spectrum, checks the high-throttle band separately, and separates a fixed frame candidate from motor-band noise before suggesting a filter or a hardware check. First log is free per browser.
More guides: how to read a blackbox log, wobble on hard stops, overshoot vs droop, 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.