UMT Help Center

How to setup GPS Rescue Mode in Betaflight

GPS Rescue Mode is intended to bring your quad back autonomously in case of an emergency such as loss of video or radio link. The only purpose is to bring the quad back into range so you can retake control as soon as possible. It is not meant to be a reliable Return to Home mode. Keep this in mind, and (other than for initial testing) only activate it to avoid losing your quad. In order to increase the probability of GPS Rescue's successful operation, please read this document and configure your system as best as possible for your particular environment and flying style.

GPS Rescue in Betaflight is not a full "Return To Home" (RTH) function. It is not meant to be a tool to autonomously fly your quad home and you should not try and use it this way. It has no ability to auto-land and will intentionally "soft-crash" when it approaches the home point. Its entire purpose is to return the quad closer to home so the pilot can resume control in the event of signal loss. The pilot should resume control as soon as possible and not rely on GPS Rescue to fly home.

Warning: Use with extreme caution

  1. This is an experimental feature.
  2. Use with extreme caution.
  3. This documentation WILL change so check this page often.
  4. Unless stated otherwise, this documentation refers to the last stable release (currently BF4.0)
  5. If you plan on using this as a failsafe method you should ABSOLUTELY enable sanity checks!
Always read the latest and official betaflight documentation before using this feature.

Before you can use GPS Rescue

Before configuring or testing GPS Rescue, you must calibrate the accelerometer and ensure that angle mode works properly. Set up the "ANGLE" flight mode and test in flight to ensure that the craft self-levels and behaves normally. If the craft does not properly level then recalibrate the accelerometer and test again. GPS Rescue uses angle mode so if this is not working properly GPS Rescue will be unable to recover the craft and may cause it to fly in the wrong direction.

How to activate and configure GPS Rescue mode

Common Issues

  1. Ensure that you are flying further than the minimum distance to home (100m by default) before testing GPS Rescue. The minimum distance can be set in the CLI using
set gps_rescue_min_dth = <meters>
  1. At distances less than this, GPS rescue will cause the quad to drop.
  1. In some particular setups, the accelerometer can drift over time and this can avoid GPS Rescue to work properly. This can be checked by flying for a long time and then activating angle mode, if the quad does not get to a nearly perfect stable orientation please do not use GPS Rescue on this quad.
  2. some GPS units need configuration with U-Center to work. 
  3. GPS Rescue is still actively maintained/developed, so if you're not using the last stable Betaflight release, chances are you could hit a known issue. Please be sure to use the last stable release (currently 4.0).
  4. GPS Rescue is not and will never be completely reliable, so it should never be used as the only recovery measure. Showing lat/lon GPS Coordinates on the OSD (and recording the flight with a DVR), logging the telemetry (including GPS coordinates) in the Radio TX or using an autonomous beeper are some measures that should be in place even before testing GPS Rescue.

    • Related Articles

    • How to setup BetaFlight Soft Serial

      What can we use Softserial for? Stuff that requires a UART connection but not timing critical, such as: SmartAudio, GPS SBUS ESC telemetry Smart Port With the limited number of UART’s on a flight controller (only 2 or 3 on F3/F4 boards), you can turn ...
    • BetaFlight FAQ

      This information is taken from the official Betaflight Wiki and gether from other various questions we usualy get from customers.  Most of theese questions cover the basics, but please note that some information here could be specific to certain ...
    • How to install Betaflight Firmware

      This is a quick guide that will walk you through the process of flashing betaflight firmware onto your flight controller Which HEX target do I download and flash to my Flight Controller ? The best way is to check the flight controller product page or ...
    • BetaFlight Resource Mapping Guide

      As manufacturers are stuffing more and more features into flight controllers, we are increasingly seeing boards that have fewer pins available for accessories. The result is lost capabilities, such as: Not enough UART input/outputs Inability to fly ...
    • How to troubleshoot your Motors and ESC (Betaflight)

      Problem:  One or more motors are not spinning up correctly when trying to fly your quadcopter. This is a fairly common issue pilots encounter with betaflight quads.  Sometimes this could be due to an incorrect flight controller setting, bad ...
    • Recent Articles

    • SpeedyBee ESC V2 and V2.1 Issues - Firmware Update

      Some early versions of the SpeedyBee ESC V2 and SpeedyBee ESC V2.1 have a firmware bug that can cause one or more motors to behave strangely.  This applies to BLheli_32 firmware version before 32.82  The fix will be included with the next release of ...
    • Pending charge on my card and no order confirmation

      Firstly, I would like to assure you that each time we take a payment, we send out a confirmation email, there is a possibility that your email provider marked our order as SPAM or filtered it somehow, to check this please see our article on No order ...
    • Caddx Vista air unit failed firmware update or overheating.

      As mentioned in the Vista manual, it is important to ensure proper cooling/airflow over your air unit when performing a firmware update.  Failing to do this can damage the air unit.  During a firmware update the automatic power management ...
    • BetaFPV Cetus Drone Troubleshooting Guide

      Here are some of the most common issues we find occurring with the BetaFPV Cetus Drone along with steps you can take to resolve them. Read the Manual First As obvious as it sounds, the manual covers a bunch of helpful information so please download ...
    • R/C Receiver Troubleshooting Guide

      This is a general guide to help direct you to check some of the common causes of issues customers have with their R/C receivers. Please check the information below and if you have checked the list below and still have an issue please contact us with ...