Betaflight GPS Rescue Setup: Do You Need a Compass?

GPS Rescue can bring a quad home without a magnetometer, and a compass that reports the wrong heading can send it circling or flying away. This covers when a compass helps, how a bad one fails, and how to check and align it in current Betaflight.

By the FPV Drone Essentials editors · Build · Published September 29, 2026

A lot of builders add a GPS module, see a compass chip on the same board, and assume GPS Rescue needs both. It doesn't. Betaflight's GPS Rescue runs without a magnetometer. That matters, because a compass that reports the wrong heading causes the circling and fly-aways that Rescue is supposed to prevent.

This column covers how Rescue works out which way the quad is pointing, when a compass actually helps, and how to check and align one in the current firmware before you rely on it over water or trees.

How GPS Rescue knows which way it is facing

To fly home, the flight controller needs two things: where home is, and which way the nose points. GPS answers the first. The second is harder, because a GPS receiver reports position and movement, not orientation.

Without a compass, Betaflight works heading out from movement. Betaflight's GPS Rescue guide, which covers 4.4 and later, explains that the quad infers its heading by comparing the path GPS says it has covered with the way it is flying. If you fly forward and GPS shows the quad moving north, the nose must be pointing roughly north.

This only works if the quad gives the firmware clean data. After takeoff, fly straight forward for several seconds at about 2 m/s (roughly 4.5 mph) or faster. Hovering, flying sideways or orbiting a subject straight off the ground doesn't give it a usable reference. Build that straight run into your takeoff routine on every GPS flight.

Why Betaflight is wary of compasses on small quads

A magnetometer measures the Earth's magnetic field, which is weak. Anything magnetic nearby swamps it, and that includes the field created by current running through your wiring. On an FPV quad, heavy battery leads, ESCs and motors sit a few inches from the flight controller and pull a lot of current.

Betaflight's guide is blunt about this. On most 5-inch and smaller quads, it says the mag is too noisy to be useful. It also says getting the compass far enough from those fields is very difficult even on a 7-inch build. That is the reason for its hard rule: don't enable the magnetometer for Rescue until you have confirmed the heading is correct.

Where you place the GPS and compass module matters as much as whether you fit one. If you are still planning the layout, FPV Drone Components Explained and The Power Chain show where the high-current parts of a quad sit, and those are the areas to keep the compass away from.

When a compass does help

A compass isn't useless. Betaflight's Magnetometer guide recommends getting Rescue working without the mag first and only then turning the mag on. A good compass helps most while the quad is climbing and descending. In those phases the quad isn't moving forward cleanly, and wind drift can make GPS-only heading guess wrong.

The 2026.6 release notes go further. They strongly recommend fitting a compass whenever a dependable rescue is important, because without a trusted compass Rescue depends on that clean nose-forward flight to calibrate heading. The two documents don't quite agree. A sensible reading is that the stronger recommendation is aimed at larger and long-range builds where the compass can be mounted well clear of the power wiring. On a typical 5-inch freestyle quad, the GPS-only method is the default for good reason.

How a bad compass causes toilet-bowling

When the compass is wrong, the flight controller believes it is facing one way when it is really facing another. It points toward home using that wrong heading, flies, and sees the position error get worse instead of better. It corrects, and the error moves again. The result is a quad circling around the spot it is trying to reach, or leaving altogether.

ArduPilot's compass setup documentation calls this circling toilet-bowling and ties it to interference from wires, ESCs and motors. Betaflight's docs don't use that name, but they describe the same failure: a heading that drifts wrong, or a fly-away.

A misaligned or poorly calibrated compass shows up on the bench. Betaflight points to a specific warning sign in the Configurator. When you rotate the quad, the on-screen model turns the right way at first, then slides off to a wrong heading. If you see that, don't fly Rescue with the mag on.

What changed in recent Betaflight versions

Compass setup has changed a lot over the last two releases, and many guides written before 2026 are out of date. The newest stable firmware is 2026.6.1, released August 2, which also adds a driver for the MMC5603 magnetometer.

The old routine, a stick command followed by 30 seconds of figure-8s plus trial and error with align_mag presets, has been replaced by guided calibration and the Detect and Full Cal tools in the Sensors tab. These settings depend on the firmware version, so make sure the Configurator you use at app.betaflight.com matches the firmware on the board.

Checking and aligning the compass on 2026.6

If you have decided a compass belongs on your build, work through these steps in order. Get Rescue working reliably without the mag before you start.

1. Confirm board alignment. With the flight controller's arrow pointing to the front of the quad, board alignment should be 0. Since 2025.12 there is no separate gyro alignment to fall back on, so a wrong value here throws everything else off.
2. Make sure the compass is detected. If you run an IST8310 that showed up on 4.5 or earlier and it has disappeared after upgrading, the default address moved from 0x0C to 0x0E. Setting mag_i2c_address = 12 in the CLI points Betaflight back to the old address.
3. Run Full Cal (auto-align). In the Sensors tab, this mode walks you through an 8-step sequence of spins, pitches and flips while it tracks coverage across 20 zones. From that one pass it solves hard-iron and soft-iron correction and works out how the compass is mounted. On 2025.12, the Detect control beside the compass orientation setting handles the mounting part on its own. It needs MSP API 1.47 or higher.
4. Set declination correctly. Remember the decidegree format on 2025.12 and later: 13 degrees is 130, and -3 degrees is -30.
5. Check the heading against a phone. Set a phone compass to True North, point the quad and phone the same way, and compare with the heading in the Configurator. Betaflight's test is that they agree within 10 degrees. Rotate the quad and watch for the turn-then-drift warning sign described above.
6. Opt in. On 2026.6.x, calibrating and aligning isn't enough. trust_mag defaults to OFF, so Position Hold and GPS Rescue ignore the compass until you enter set trust_mag = ON in the CLI and save.

That last step has a short shelf life. Pull request #15689, merged into master on September 17 for the 2026.12 milestone, removes trust_mag. Once you upgrade to that release, a compass that is enabled, calibrated and healthy will be used for heading automatically. There will be no separate opt-in switch, so enabling the magnetometer is the decision. If you don't want it steering Rescue after that upgrade, leave the magnetometer disabled.

The Rescue settings that matter more than the compass

Compass or not, a few Rescue basics decide whether the quad comes home. By default, Rescue wants at least 8 satellites, and its sanity check mode is SANITY_FS_ONLY. Most important of all, don't set the quad to arm before it has a home fix. Betaflight is explicit that a quad relying on Rescue should never be allowed to arm until that fix exists. Without a saved home point, Rescue has nowhere to return to.

Test Rescue over open ground in calm conditions before you depend on it anywhere you can't walk to. Start with the compass off and a clean straight run after every takeoff. Bring the compass in later, one verified step at a time. If you are setting up a new build from scratch, Betaflight First Setup covers the basics to get right before GPS, and the Installing Betaflight chapter of FPV Drone Essentials is a good place to start if you are new to the Configurator.

Sources

• Betaflight Wiki – GPS Rescue
• Betaflight Wiki – Magnetometer / Compass
• Betaflight Wiki – Magnetometer / Compass (GitHub source)
• Betaflight 2025.12 Release Notes
• Betaflight 2026.6 Release Notes
• GitHub – betaflight-configurator PR #5197
• GitHub – betaflight/betaflight Releases
• GitHub – betaflight PR #15689
• ArduPilot Copter docs – Advanced Compass Setup

Facts checked against the sources above as of September 29, 2026. Drone rules and firmware change; check the current version before you rely on a detail.