Failsafe.md

   1 # Setting up Failsafe for RTH
   2
   3 ---
   4 Warning: one can assign a RC switch to simulate a FAILSAFE condition. Bear in mind that while the mode is activated, the FC will behave as if radio link is lost. This means that disarming the model will not work. To regain control one will have to 1) cancel the FAILSAFE with the RC assigned switch 2) move the roll / pitch sticks 3) possibly DISARM. Not to say that in case of emergency this procedure has to be well known. Therefore, it is wise to not assign FAILSAFE to a switch, but rather assign RTH.
   5 ---
   6
   7
   8 ## Foreword
   9
  10 The goal is to configure both your flight controller and radio receiver so that failsafe does as you expect in every situation.
  11
  12 For failsafe to work optimally INAV needs to know it's in a failsafe event and not just doing regular RTH. This is necessary for example to correctly handle loss of GPS while returning to home.
  13
  14 This assumes you have regular GPS modes like `RTH` working **already**.
  15
  16 ## Configuration of receiver
  17
  18 You have several options on how to configure receiver:
  19
  20 ### Option one
  21
  22 Set receiver to send out `NO PULSES` or `HOLD` on a failsafe event. This is perfectly fine for FrSky Radios.
  23
  24 ### Option two
  25
  26 1. Set up INAV "Failsafe" mode on an RC channel.
  27
  28 2. Set up the radio receiver failsafe so the RC channel used in 1. outputs a value that activates INAV "Failsafe" mode on RC link loss.
  29
  30 The above is fine on FlySky radio.
  31
  32 ### Option three
  33
  34 Set up  the radio receiver failsafe so the throttle channel outputs a value below the `rx_min_usec` setting. This will trigger INAV Failsafe when the radio receiver goes into failsafe.
  35
  36 The throttle channel lower endpoint may need to be temporarily set to the lowest setting allowing the failsafe value to be set low also (around 800us should be possible). Once the receiver failsafe setting has been saved the throttle endpoint can be reset to the normal value.
  37
  38 Works well with Flysky radios without the need to set Failsafe mode (option 2).
  39
  40 ## Configuration of INAV
  41
  42 Go to `Failsafe` tab, and enable `RTH` as Stage 2 failsafe.
  43
  44 For fixed wing set `failsafe_throttle_low_delay = 0` or else it will disarm the fixed wing in the air when Failsafe triggers and you have had low throttle for the default time period.
  45
  46 The behavior of `RTH` can also be configured.
  47
  48  - [INAV Flight modes / Navigation Modes](/iNavFlight/inav/wiki/Navigation-modes#rth-altitude-control-modes)
  49
  50 Loss of GPS during Failsafe RTH will result in an emergency landing so make sure the following are set to avoid surprises:
  51 - `nav_emerg_landing_speed` - default is 5 m/s. Reduce for a fixed wing.
  52 - `failsafe_off_delay` - default will disarm after 20s. Increase or disable if more time required.
  53 - `failsafe_throttle` - default setting is 1000 which will cause a multicopter to drop if not increased to slightly below hover throttle.
  54
  55 ## Verifying that failsafe works as intended
  56
  57 Verify that your failsafe works without props:
  58
  59 1. Remove all props
  60
  61 1. Go outside, arm and apply throttle, run with it 50meter away from home (normally the place where you armed it) and then turn off transmitter. The aircraft should now try to climb (increase throttle). Also verify that you're able to regain control by turning on transmitter again, and move the ROLL/PITCH stick more than `failsafe_stick_threshold`
  62
  63 Now, verify that failsafe works while in flight:
  64
  65 1. Put the props on again
  66
  67 1. Take off, fly at least 50 meters from home, and turn off transmitter. Tip: Do this over soft grass. If it's an airplane it's better to have some altitude
  68
  69 Note: If you are using a fixed wing without a magnetometer enabled you will need to run with the airplane before turning off the transmitter to test failsafe. This is because GPS speed needs to be above a certain threshold to acquire a valid heading. Without a valid heading failsafe will not initiate.
  70
  71 Note: To regain control after a failsafe event, you must move the roll/pitch sticks more than `failsafe_stick_threshold` in order to regain control.
  72
  73 **INAV offers additional failsafe safety features**
  74
  75 **failsafe_min_distance** and the action you wish to invoke (_failsafe_min_distance_procedure_)
  76
  77 ****failsafe_throttle_low_delay**** (Time throttle level must have been closed  to Auto disarm)
  78
  79 The first setting could avoid injury as it will prevent the possibility of the craft blasting off to its RTH height within chosen safety distance of the set home point. It could also work against you if a failsafe event occurred while flying close with a setting of (just land) and you were flying from a very small safe landing area.
  80 All options are available to best suit your needs.
  81
  82 The second setting could just ruin your day with a mid-air disarm but conversely save you from personal injury if it is forgotten to disarm the craft (not using motor stop also goes a long way to making the craft safer as the spinning propellers are a visible sign the craft is armed and dangerous).
  83
  84 Further reading and settable parameters are available here :-
  85 https://github.com/iNavFlight/inav/blob/master/docs/Failsafe.md#failsafe_throttle
  86
  87 And here :-
  88 https://github.com/iNavFlight/inav/blob/master/docs/Cli.md
  89