Betaflight GPS Rescue Explained: Control Flow and Recovery

ByThe Answerlode Editorial Team

How GPS Rescue Takes Control

Yes, when GPS rescue activates during a failsafe event, Betaflight assumes complete autonomous control of all four flight axes. The flight controller takes over pitch, roll, yaw, and throttle—you have zero input on any stick. Your job at that point is to sit back and let it fly itself home.

Here’s what happens: throttle is automatically managed to reach and hold your configured rescue altitude. Yaw is controlled to keep the nose pointed toward home. Pitch and roll are calculated to fly forward toward home at a configurable speed while correcting for wind drift. The whole sequence runs on closed-loop control without any pilot input.

What Triggers GPS Rescue Failsafe

GPS rescue is stage 2 of Betaflight’s failsafe system. Stage 1 is the initial response to signal loss—by default, it cuts throttle to zero after 1.5 seconds (the guard time). Stage 2, which activates if you don’t regain signal after that, is where GPS rescue kicks in.

You can trigger it three ways: RC signal loss beyond the configured delay, critically low battery, or manually via a failsafe switch if you set one up.

The Autonomous Flight Sequence

Once active, GPS rescue follows this order:

  • Climbs to your pre-set rescue altitude (helps clear obstacles like trees)
  • Pitches forward and flies toward the home point using GPS navigation
  • Corrects heading to stay on course, mixing in roll to handle wind
  • When close enough to home, begins a gentle descent
  • Lands and disarms automatically at the home location

The home point is the GPS coordinate recorded when you armed the quad, so you must have a solid GPS lock before you take off.

How to Regain Control During Failsafe

This is the key detail most pilots get wrong. Simply moving your sticks will not snap control back immediately—that would be dangerous if your receiver is genuinely offline. Instead, Betaflight waits for signal recovery.

Once your RC link comes back online, you have two scenarios:

If it was a real signal loss: Move any stick (roll, pitch, or yaw) beyond your failsafe_stick_threshold setting—default is 30 percent off-center. The moment you hit that threshold, failsafe is canceled and you regain full control. No need to move throttle. This delay lets you see your video feed return and verify the quad is recovering before you intervene.

If you manually triggered failsafe with a switch: Just flip the switch back off. Control returns immediately—no stick movement needed.

If you want control back instantly when signal recovers, you can set failsafe_stick_threshold to 0 in the Betaflight CLI, but this means losing the safety margin that the delay provides.

What About Throttle During Failsafe?

Here’s a gotcha: when stage 1 failsafe triggers, Betaflight can drop throttle to zero by default (Throttle Channel Fallback set to “Auto”). If your motors stall or nearly stall during that guard time, GPS rescue may fail or perform poorly. To avoid this, change Throttle Channel Fallback to “Hold” so it maintains the last throttle value during the 1.5-second guard period. This keeps your motors spinning and ready for the rescue climb.

Critical Setup Requirements

GPS rescue will abort and your quad will disarm if any of these are missing:

  • A working accelerometer (gyro + accel) for attitude control
  • A GPS module with an active satellite lock before arm
  • Enough battery to climb and fly home (low battery failsafe can trigger mid-rescue)
  • Barometer recommended but not required; it improves altitude accuracy

Let your quad sit armed with props off for 15–30 seconds before your first flight to lock in a solid home position. GPS accuracy matters.

Common Configuration Options

The main tuning parameters are:

  • gps_rescue_initial_climb: How high to climb before flying home (e.g., 20 meters)
  • gps_rescue_return_speed: Forward velocity while flying toward home (e.g., 10 m/s)
  • gps_rescue_descent_rate: How fast to descend near home (e.g., 0.5 m/s for a soft landing)
  • failsafe_stick_threshold: Stick input needed to cancel failsafe (default 30%)

Betaflight comes with reasonable defaults, so if you’re new to this, start there and tune only after a few test flights.

Testing GPS Rescue Safely

Never test GPS rescue on the first flight. Fly normally for a few minutes to build confidence. Then, in an open area with props on, trigger the failsafe switch and watch it fly home from 20–30 meters away. Stay clear of the quad in case something goes wrong. If it lands cleanly, you’re good. If it drifts sideways or descends too fast, adjust your GPS rescue settings before the next test.

Sources


Similar Posts