Knowledge Base

Straight answers for multirotor builders and FPV pilots. One question per article: what is happening, and what to do next.

SITL Forge — FPV Laboratory

Are you sure about your tune?

SITL Forge runs real Betaflight and iNAV firmware against a 1000 Hz physics model of your aircraft — your motors, your props, your mass. Find out what your PIDs, your filters and your failsafe actually do, before you fly them.

See it on Steam

Diagnostics

13 articles

Something is wrong with the aircraft. Each article answers exactly one question.

Slow wobble on a big quad: PID too hot, or is your arm a spring?

On a heavy airframe, an over-gained control loop and a flexing frame produce the same slow wobble. Here is how to tell which one you have, and why no PID value fixes a spring.

Why did one motor stop mid-flight?

The quad drops out of the sky, then flies home as if nothing happened. That is desync — the ESC losing track of where the rotor is. Here is what it actually is, and how to prove it in a log.

Is it propwash, or is my tune bad?

One question separates them, and it is not what the shake looks like — it is when it happens. Clean air is the test.

Why do my motors get hot?

Heat is not a fault in its own right. It is the electrical energy your build failed to turn into thrust, and it tells you exactly where the waste is going.

Why do I lose GPS lock?

Almost every bad GPS is a good GPS being shouted down by your own aircraft. Find the noise source, not a new module.

Why does my quad drift in Angle mode?

"Drift" is at least three different faults, and one of them is not a fault at all. Work out which one you have before you calibrate anything.

Why does my quad flip on takeoff?

The flip of death is not a tuning problem, and it is not bad luck. It is a very short list of causes, and the direction it flipped tells you which one.

Why does my video break up?

Video breakup is an RF problem wearing a video costume. Three questions separate almost every case, and the answer is usually the antenna.

Why is my ESC beeping?

An ESC beeps by playing tones through the motor windings. Once you know that, the sound tells you which of half a dozen things is wrong — starting with whether it is the ESC beeping at all.

Why does my quadcopter shake?

Shaking is four completely different faults wearing the same costume. Identify which one you have in about a minute, then fix that one.

Why does my voltage sag under throttle?

Every LiPo sags. That is Ohm's law, not a fault. The only question worth asking is whether yours sags more than it should — and here is how to answer it.

Why does one motor behave differently?

One motor hotter, louder, or working harder than the other three is almost never the motor's fault. It is the flight controller correcting for something, and the pattern tells you what.

Why won't my quad arm?

Betaflight already knows why, and it will tell you in one word. Here is how to ask it, and what every answer means.

Flight Firmware

4 articles

Betaflight, iNAV, ArduPilot — how they differ, how they are built, and how to test changes without crashing.

Tuning

7 articles

PIDs, filters, rates and vibration, explained in terms of what you will actually feel in the air.

Is AutoTune safe on a 20 kg aircraft?

AutoTune works by deliberately walking an aircraft toward instability and stopping just before. On a 20 kg airframe, the margin between "just before" and "too late" is very thin, and very expensive.

Why a 5-inch racer tune destroys a 5 kg quad

Every default PID set you can flash was written for a 250 g aircraft. Here is what actually changes when the machine gets big, what it does to each term, and why nobody can hand you numbers.

Hover throttle is the number that decides everything

The throttle position you hover at is the cheapest diagnostic on the aircraft, and almost nobody reads it. It tells you whether the thing can be tuned, flown safely, or trusted to come home.

PID and filters in plain English

What P, I, D and feedforward actually respond to, what each one feels like when it is wrong, and why every filter you add is a loan against your control authority.

Rates: what each number actually does to the stick

Rates are not a tune. They are the mapping from your stick to a commanded rotation rate. Here is what each of the three knobs does, and why copying someone else's rates is pointless.

How to read a Blackbox log

The log is the only record of what your aircraft actually did. Four traces carry most of the diagnosis — here is what each one means and the order to read them in.

Tuning an aircraft whose weight changes

A sprayer that takes off at 38 kg and lands at 22 kg is two different aircraft. You cannot tune both, so you tune the one that would otherwise kill you — and it is not the one most people pick.

Autonomous Flight

3 articles

GPS, RTL, missions, geofences and failsafe — the parts of the stack the FPV world skips.

Building

3 articles

Soldering, wiring, capacitors, centre of gravity, and the checks that come before the first spin-up.