GPS-Failsafe-and-Glitch-Protection.md

   1 ## Overview
   2
   3 GPS Systems can occasionally drop the signal (lose FIX) or provide significantly inaccurate position information (glitch). While errors are more likely in conditions where the GPS signal can bounce off multiple paths before reaching the receiver (multipathing), errors can occasionally occur even with clear sky.
   4
   5 Without updates from GPS System, the inertial position estimation allow approximately 1.5 seconds of position information but after this the horizontal position drift becomes so large that the horizontal position cannot be maintained at all. At this point the position estimator will report invalid position to the navigation core. If you still have RC radio control it is recommended to take back control using ANGLE, HORIZON, ALTHOLD or ACRO as soon as possible.
   6
   7 Action taken on invalid position is dependent on current flight mode.
   8
   9 ## GPS glitch protection
  10
  11 Sometimes GPS provides very inaccurate position information despite having the fix and the good satellite count. This event is usually called a "GPS glitch". iNav has logic to detect and ignore inaccurate/inconsistent GPS position updates. Glitches are detected by comparing the new position update received from the GPS unit with a position projected out from the previous update's position and velocity.
  12
  13 The new GPS position is accepted as “good” if:
  14
  15 1. the two positions are within the hard coded INAV_GPS_GLITCH_RADIUS (currently 2.5m)
  16 1. the new position is within a radius that is 10m/s/s (INAV_GPS_GLITCH_ACCEL) * dt * dt.  Where “dt” is the time difference between the two GPS samples.
  17
  18 GPS glitches are treated by the position estimator in the same way as losing GPS fix.
  19
  20 **At the moment the code is experimental and "glitched" GPS positions are not ignored.**
  21
  22 ## Action taken on invalid position event
  23
  24 ### ANGLE, HORIZON, ACRO, ALTHOLD mode
  25 These modes are not GPS-dependent, nothing will happen but you will be unable to switch into an autopilot flight mode (POSHOLD, RTH, WP) until the failure clears.
  26
  27 ### POSHOLD mode
  28 The copter will be forced into ANGLE mode, pilot will have complete control over copter attitude. If ALTHOLD mode was selected it will remain active. When failure clears POSHOLD more will resume.
  29
  30 ### RTH and WP modes (including failsafe RTH)
  31 RTH and WP are considered full-auto modes. It is assumed that pilot might have no control over the copter so the safest action in case of invalid position is landing the machine. Copter will enter Emergency Landing state if failure is consistent for over 2 seconds.
  32
  33 ## Emergency Landing
  34 In case of critical failure, Emergency Landing is triggered. In Emergency Landing state copter is forced into ANGLE mode, ROLL and PITCH input is centered to maintain level, pilot stick input is ignored and copter enters a controlled descent.
  35
  36 While Emergency Landing is active pilot is unable to switch into ALTHOLD, POSHOLD, RTH or WP mode. If pilot wants to regain control of the copter he should switch to ANGLE, HORIZON or ACRO more.
  37
  38 ## Tips to improve GPS reception and avoid GPS outages and glitches
  39
  40 1. Place the GPS module on the outside of your vehicle (in an elevated position or on a mast if appropriate) with a clear view of the sky.
  41 1. If GPS module is combined with a compass sensor, place it as far as possible from the motors, ESCs and power wires (at lest 10 cm)
  42 1. 1.2-1.3 GHz FPV video transmitters are know to be interfering with GPS reception. If you use such transmitter place it as far as possible from GPS module and expect some degradation in GPS quality
  43 1. Select a GPS module with biggest GPS antenna. Bigger GPS antenna - better reception.
  44 1. Use a two-system receiver is possible. For example uBlox NEO-M8N is GPS/GLONASS capable receiver. More systems means better noise resistance, more satellites, better accuracy.