FlySpark logo
Betaflight logoBetaflightBetaflight setup guidesUpdated

Betaflight GPS setup and GPS Rescue

FlySpark's GPS tab turns the GPS feature on, chooses the protocol and the u-blox options, and shows satellites, HDOP and the coordinates. Betaflight GPS Rescue, the return-to-home used by the GPS Rescue failsafe and the GPS RESCUE mode, is configured on the Failsafe tab: return altitude, climb, speed, descent and the sanity checks. INAV does not use that GPS Rescue block. INAV's return-to-home is its own failsafe procedure.

These tabs are part of the FlySpark configurator. In Chrome or Edge, connect over USB or Bluetooth. The Android app also connects over USB OTG or a Wi-Fi MSP bridge. The iPhone app uses Bluetooth or Wi-Fi, because an iPhone has no USB host. A browser cannot open the craft's Wi-Fi. Edits collect in the save bar. The Ports tab still has to put GPS on a UART. This tab does not assign the port.

Free. Hardware connections need Chrome or Edge on a computer; phones use the FlySpark app.

  • Free
  • Nothing to install
  • Demo without hardware

In short

Betaflight GPS setup enables the receiver, the u-blox options and the live satellite view. GPS Rescue, the Betaflight return path, is set on the Failsafe tab in FlySpark, in Chrome or Edge and in the Android and iPhone apps. INAV uses its own GPS settings and failsafe procedure, not that rescue form.

Key facts

  • The GPS feature has to be on before rescue or the OSD position will use it.
  • Auto-configure u-blox sets rate, constellations and messages on boot.
  • Set home only on first arm stops the home point moving every time you arm.
  • GPS Rescue altitude can be the highest of the choices, a fixed height, or the current height.
  • Rescue minimum satellites is a separate number from the INAV minimum satellites for a fix.
  • Allowing arming without a fix is an explicit switch, off unless you turn it on.
  • Betaflight logoBetaflight
  • INAV logoINAV
  • ArduPilot logoArduPilot
  • PX4 logoPX4
  • BLHeli_S
  • Bluejay logoBluejay
  • AM32 logoAM32
  • ExpressLRS logoExpressLRS
  • EdgeTX logoEdgeTX
  • DroneCAN logoDroneCAN
  • MAVLink logoMAVLink

Try it

Count the satellites

Eight or more is drawn as a fix. Fewer stay as searching.

Fix

Betaflight

Features

  • 01

    GPS feature switch

    On Betaflight the GPS switch is required for GPS Rescue and for the OSD position. On INAV the same switch is required for return to home, position hold and missions.

  • 02

    Protocol and baud

    Betaflight chooses a protocol, auto-configure for u-blox, auto baud and an SBAS correction. Galileo can be included. INAV adds a dynamic model, a fastest GPS baud, BeiDou and GLONASS.

  • 03

    Home point

    Betaflight can set home only on the first arm. Off means home is taken again every time you arm.

  • 04

    Live sky view

    The tab shows the satellite count, HDOP with a short quality label, and the coordinates, which can be copied. Each satellite row shows constellation, id, signal and whether it is used.

  • 05

    GPS Rescue return

    Altitude mode is the highest relevant height, a fixed height, or the current height. Return altitude is 5 to 1000 metres, with an extra climb of 0 to 100 metres, a climb rate and a ground speed.

  • 06

    Rescue descent

    Descent starts at a distance from home, then follows a descent rate and minimum, hover and maximum throttle in microseconds.

  • 07

    Rescue safety

    Minimum satellites for rescue runs from 5 to 50. Sanity checks are off, on, or failsafe only. Arming without a fix is a separate switch with its own hint.

  • 08

    INAV is not GPS Rescue

    INAV's failsafe procedure, including a land throttle and motors-off delay when land is selected, is the INAV failsafe. It is not the Betaflight GPS Rescue form.

Betaflight GPS tab

These are the Betaflight GPS settings. The rescue numbers are on Failsafe, described in the next section.

Protocol. The GPS protocol the UART should speak. It has to match the module. Auto baud tries the usual rates.

Auto-configure u-blox. On boot, FlySpark's connected firmware sets the rate, the constellations and the messages. Leave it on for a u-blox module unless you configure that module yourself.

SBAS. The satellite-based correction source. Pick the one that covers where you fly.

Use Galileo. Adds Galileo satellites. INAV also has switches for BeiDou and GLONASS, and a minimum satellite count for a fix.

INAV dynamic model. The hint on the control says Air 2G suits most multirotors. The update rate is in hertz.

Coordinates. The fix is shown as coordinates you can copy. Until the GPS feature is on, the tab tells you to turn it on, save and reboot.

GPS Rescue on the Failsafe tab

GPS Rescue is both a failsafe stage and a mode switch. The numbers live in one block titled for the rescue return. Altitude mode decides the target: the highest of the firmware's choices, a fixed altitude, or whatever height you are already at. Return altitude is metres. Extra climb is added on the way up, and the climb rate and ground speed are in metres per second.

Maximum pitch for the return is 30 to 60 degrees. Rescue will not start as a proper return inside the minimum distance from home, which is 10 to 30 metres. Descent begins at the distance you set, from 10 to 500 metres, and then uses its own descent rate. Minimum, hover and maximum throttle are the throttle limits during that descent, in microseconds.

Sanity checks can be off, on, or limited to failsafe. Minimum satellites is the count rescue itself requires, from 5 to 50. Allowing arming without a fix is off unless you enable it. The control's hint explains the consequence. FlySpark shows a rescue warning on that card when the firmware reports the feature is not in a usable state. Read that warning before treating rescue as a safety net.

INAV pilots looking for the same idea should use the INAV failsafe procedure, not this form. When that procedure is Land, the screen shows landing throttle and a motors-off delay. Near-home distance and climb behaviour are INAV settings on that failsafe card. Missions and geozones are planned on the mission planner.

A GPS fix still needs a port and a sky

Set a UART to GPS on the Ports tab at the module's baud, save, and reboot. The GPS tab then shows satellites. Indoor tests usually stay at zero satellites. HDOP is shown next to the count so a fix with many weak satellites is not mistaken for a good one.

The Betaflight configurator includes this tab with the rest of the setup. Position hold on Betaflight 2025.12 is a different, newer feature and is not configured by the GPS Rescue numbers on a 4.5 demo board.

Rescue throttle values are microseconds, the same unit as the radio endpoints on the Receiver tab. A hover throttle copied from a punch-out log is a starting point for the rescue hover field, not a promise that the descent will look like a manual landing. Try the return high and over open ground before you rely on it.

At a glance

GPS and GPS Rescue specifications

Betaflight GPSFeature switch, protocol, u-blox auto-config, auto baud, SBAS, Galileo, home on first arm
INAV GPSFeature switch, protocol, SBAS, dynamic model, auto-config, auto baud, max baud, Galileo, BeiDou, GLONASS, minimum satellites, update rate
Rescue altitudeHighest, fixed or current; return altitude 5 to 1000 m; extra climb 0 to 100 m
Rescue motionClimb rate, ground speed, max pitch 30 to 60 degrees, minimum start distance 10 to 30 m
Rescue descentStart distance 10 to 500 m, descent rate, minimum, hover and maximum throttle
Rescue safetyMinimum satellites 5 to 50, sanity checks off, on or failsafe only, arming without a fix

Betaflight

How to turn on Betaflight GPS Rescue

  1. Port

    On Ports, set the GPS module's UART to GPS and the baud the module uses. Save and reboot.

  2. Feature

    On the GPS tab, turn GPS on. Leave auto-configure and auto baud on for a u-blox module.

  3. Sky

    Take the craft outside. Wait until the satellite count and HDOP look usable. Copy the coordinates if you want a record of the spot.

  4. Rescue

    On Failsafe, set altitude mode, return altitude, climb, speed and the descent throttle limits.

  5. Checks

    Set minimum satellites and sanity checks. Leave arming without a fix off unless you mean to.

  6. Mode

    On Modes, put GPS RESCUE on a switch if you want to trigger it yourself as well as from failsafe. Save.

Guide 01

Check the fix before trusting rescue

Rescue cannot invent a home point.

  1. Power the GPS with a clear view of the sky.

  2. Confirm the satellite count is stable and read the HDOP label.

  3. Arm once, if home-on-first-arm is on, so a home exists.

  4. Only then expect GPS Rescue or the GPS RESCUE mode to have a target.

Troubleshooting

Common problems and fixes

  • Problem

    Turn on the GPS feature, then save and reboot

    Fix

    That line is the tab telling you the feature bit is off. Turn it on and reboot before judging the module.

  • Problem

    Rescue warning on the Failsafe tab

    Fix

    Read the warning. A common cause is GPS off, no fix, or the rescue feature not available on that firmware build.

  • Problem

    INAV will not show GPS Rescue

    Fix

    That is expected. Use the INAV failsafe procedure. Do not look for the Betaflight rescue cards.

  • Problem

    Coordinates jump

    Fix

    HDOP is still poor or SBAS and the constellation switches do not match the module. Wait for a calmer fix before setting home.

Glossary

Glossary of terms

GPS Rescue
Betaflight's return path, used by the failsafe stage and by the GPS RESCUE mode switch.
HDOP
A horizontal accuracy figure shown next to the satellite count. Lower is a tighter fix.
SBAS
A correction service such as a regional augmentation system, chosen to match where you fly.
Home point
The coordinate rescue returns to. Betaflight can lock it on the first arm.

FAQ

Frequently asked questions

Where is GPS Rescue configured?

On the Failsafe tab, in the rescue return, descent and safety cards. The GPS tab turns the receiver on and shows the fix.

Does INAV use GPS Rescue?

No. INAV uses its failsafe procedure, including return to home and land. The GPS Rescue form is Betaflight.

Why are there no satellites?

The GPS feature is off, the UART is not set to GPS, the baud is wrong, or the module cannot see the sky. The tab says to turn the feature on, save and reboot when the feature is the missing piece.

What does set home only on first arm do?

Home is taken the first time you arm and then left alone. Off means a new home is stored on every arm.

What is altitude mode?

Highest, fixed, or current. Fixed uses the return altitude in metres. Current uses the height you already have.

Can I arm with no GPS fix?

Only if Allow arming without a fix is on. It is a separate switch on the rescue safety card.

What minimum satellites does rescue use?

The rescue safety card, from 5 to 50. INAV's minimum satellites for a fix is a different setting on the INAV GPS tab.

Does this plan waypoints?

No. Waypoint missions are the mission planner. GPS Rescue is a return path, not a mission.

References

Sources

The official documentation behind the background facts on this page.

  1. GPS RescueBetaflight · betaflight.com
  2. FailsafeBetaflight · betaflight.com
  3. GPSINAV · github.com

Tools

See every FlySpark tool

Ready to try it?

Free. Hardware connections need Chrome or Edge on a computer; phones use the FlySpark app.