Betaflight GPS Rescue Mode Setup Guide 2026: Return-to-Home Configuration Step-by-Step
GPS Rescue Mode is Betaflight’s most important safety feature — a configured failsafe that autonomously flies your quad back to you when signal is lost, rather than dropping it from the sky. For long-range pilots, it’s essential. For freestyle pilots flying around obstacles, it’s the difference between a walk of shame and a total loss. Setting up GPS Rescue correctly requires precise configuration across hardware, firmware, and field testing. This 2026 guide covers every step.
Hardware Requirements
You need a GPS module that supports the UBLOX protocol with at minimum NMEA output. Modern recommendations in 2026:
- BN-880Q: Budget option with compass. Adequate for basic rescue but slower fix times.
- Matek M10Q-5883: The gold standard for FPV. UBLOX M10 chip locks in under 30 seconds cold start, excellent sensitivity, includes magnetometer. Supports Galileo + GPS + GLONASS + BeiDou simultaneously.
- HGLRC M100 Mini: Ultralight option for toothpicks and sub-250g builds. UBLOX M10, no compass, tiny footprint.
- TBS M10 GPS: Premium option with GPS + GLONASS + BeiDou, excellent filtering, works well in high-RFI environments from nearby VTX.
Compass (magnetometer) is not strictly required for GPS Rescue in Betaflight 4.3+. The flight controller can derive heading from GPS course-over-ground once moving fast enough. However, a compass enables more accurate heading at low speeds and is recommended if your GPS module includes one.
Wiring and UART Configuration
Wire the GPS module to a free UART on your flight controller. Standard wiring: GPS TX to FC RX, GPS RX to FC TX, 5V and GND. If your GPS has a compass, connect SDA and SCL to the I2C pads (not a UART). In the Betaflight Ports tab, enable “Sensor Input” > “GPS” at the correct baud rate — 115200 for modern UBLOX modules. If using a compass, also enable “Magnetometer” in the Configuration tab.
Verify the GPS is working in the GPS tab: you should see satellite count increasing and, after 3D fix is acquired (typically 5-8 satellites), latitude/longitude coordinates populating. A cold start can take 30-60 seconds; warm starts are under 5 seconds.
GPS Rescue Parameters Explained
Navigate to the Failsafe tab in Betaflight and configure these critical parameters under GPS Rescue:
| Parameter | Recommended Starting Value | What It Controls |
|---|---|---|
| Angle | 30-40° | Maximum tilt angle during rescue flight. Higher = faster climb/return but less stability |
| Initial Climb | 30-50m | Altitude the quad climbs to above home point before heading home |
| Climb Rate | 500-800 cm/s | How fast the quad climbs during the initial ascent phase |
| Return Speed | 1000-1500 cm/s (10-15 m/s) | Cruise speed during the return journey |
| Ground Speed | 500-800 cm/s | Descent speed when reaching home position |
| Min Satellites | 6-8 | Minimum satellite count before rescue will execute |
| Sanity Checks | Enabled | Validates GPS data isn’t corrupted before acting; always enable |
| Allow Arming Without Fix | Disabled for critical use | Prevents arming without GPS lock — enable only for non-critical flying |
| Altitude Mode | Maximum (recommended) | Uses max of GPS alt, barometer, and fixed altitude. Most reliable |
Failsafe Configuration
GPS Rescue triggers when the receiver enters failsafe — either from signal loss (RX Loss) or deliberate activation. Configure both:
- Stage 1 Failsafe (RX Loss): Set Guard Time to 1.0s (how long Betaflight waits before declaring failsafe). Set Failsafe Procedure to “GPS Rescue.” When signal drops, the quad will attempt Rescue after 1 second of no valid packets.
- Stage 2 Failsafe (Complete Loss): If GPS Rescue fails (too few satellites, invalid position), the quad will disarm after the configured delay. This is your last-resort safety — failing armed is better than flying away.
- Switch Activation: Map an Aux channel to GPS Rescue on the Modes tab. This allows manual activation for testing or emergency use. Having a dedicated rescue switch on your radio is strongly recommended.
Field Testing Procedure
Never trust GPS Rescue without testing it. Follow this progression:
- Line-of-sight hover test: With the quad 5-10m away in angle mode, activate GPS Rescue via switch. Verify the quad climbs, holds position, and descends (or hovers if at home). Be ready to take over.
- Short-range FPV test: Fly 100m out, 30m up. Activate Rescue via switch. Confirm the quad turns toward home and flies back. Watch for toilet bowling (circling behavior, usually compass-related).
- Mid-range test: Fly 300-500m out and activate Rescue. Observe return speed, altitude hold, and landing accuracy.
- Long-range validation: Before a true long-range flight, verify Rescue at 1km+. GPS accuracy drift and wind compensation become apparent at longer ranges.
Common Problems and Fixes
| Problem | Cause | Fix |
|---|---|---|
| Toilet bowling (circling) | Compass interference or GPS heading drift | Disable compass in Configuration; GPS course-over-ground heading works at speed |
| Refuses to arm with GPS fix | “Allow arming without fix” disabled and weak GPS signal | Enable temporary arming without fix, or move GPS further from VTX |
| Climbs but doesn’t return | Min satellites threshold not met | Lower min satellites to 6; ensure GPS has clear sky view |
| Erratic altitude hold | Barometer drift or GPS altitude fluctuation | Cover barometer with open-cell foam; set Altitude Mode to Maximum |
| Failsafe doesn’t trigger rescue | Failsafe procedure not set to GPS Rescue | Check Failsafe tab: Stage 1 must be GPS Rescue, not Drop |
Betaflight 4.5 GPS Improvements
Betaflight 4.5 brought GPS Rescue refinements: improved speed and altitude PID controllers, better wind compensation using accelerometer data, and configurable landing detection (the quad now identifies when it’s near the ground and reduces descent speed). If you’re running 4.4 or earlier, upgrading to 4.5 or 4.6 is worth it for the GPS Rescue improvements alone.
GPS Rescue is not a set-and-forget feature. Test it regularly, especially after firmware updates or hardware changes. The best rescue system is the one you’ve verified works.