docs/Failsafe.md

   1 # Failsafe
   2
   3 There are two types of failsafe:
   4
   5 1. Receiver based failsafe
   6 2. Flight controller based failsafe
   7
   8 Receiver based failsafe is where you, from your transmitter and receiver, configure channels to output desired signals if your receiver detects signal loss.
   9 The idea is that you set throttle and other controls so the aircraft descends in a controlled manner.  See your receiver's documentation for this method.
  10
  11 Flight controller based failsafe is where the flight controller attempts to detect signal loss from your receiver.
  12
  13 It is possible to use both types at the same time, which may be desirable.  Flight controller failsafe can even help if your receiver signal wires come loose, get damaged or your receiver malfunctions in a way the receiver itself cannot detect.
  14
  15 ## Flight controller failsafe system
  16
  17 The failsafe system is not activated until 5 seconds after the flight controller boots up.  This is to prevent failsafe from activating, as in the case of TX/RX gear with long bind procedures, before the RX sends out valid data. Note that you need to activate the 'FAILSAFE' feature in order to activate failsafe on flight controller.
  18
  19 After the failsafe has forced a landing, the flight controller cannot be armed and has to be reset.
  20
  21 The failsafe system attempts to detect when your receiver loses signal.  It then attempts to prevent your aircraft from flying away uncontrollably by enabling an auto-level mode and setting the throttle that should allow the craft to come to a safer landing.
  22
  23 The failsafe is activated when:
  24
  25 Either:
  26
  27 a) no valid channel data from the RX is received via Serial RX.
  28
  29 b) the first 4 channels do not have valid signals.
  30
  31 And when:
  32
  33 c) the failsafe guard time specified by `failsafe_delay` has elapsed.
  34
  35 Note that:
  36
  37 d) The failsafe system will be activated regardless of current throttle position.
  38
  39 e) The craft may already be on the ground with motors stopped and that motors and props could spin again - the software does not currently detect if the craft is on the ground.  Take care when using MOTOR_STOP feature.
  40
  41 ### Testing
  42
  43 Bench test the failsafe system before flying - remove props while doing so.
  44
  45 1. Arm the craft.
  46 1. Turn off transmitter or unplug RX.
  47 1. Observe motors spin at configured throttle setting for configured duration.
  48 1. Observe motors turn off after configured duration.
  49 1. Ensure that when you turn on your TX again or reconnect the RX that you cannot re-arm once the motors have stopped.
  50 1. Power cycle the FC.
  51 1. Arm the craft.
  52 1. Turn off transmitter or unplug RX.
  53 1. Observe motors spin at configured throttle setting for configured duration.
  54 1. Turn on TX or reconnect RX.
  55 1. Ensure that your switch positions don't now cause the craft to disarm (otherwise it would fall out of the sky on regained signal).
  56 1. Observe that normal flight behavior is resumed.
  57 1. Disarm.
  58
  59 Field test the failsafe system
  60
  61 1. Perform bench testing first!
  62 1. On a calm day go to an unpopulated area away from buildings or test indoors in a safe controlled environment - e.g. inside a big net.
  63 1. Arm the craft.
  64 1. Hover over something soft (long grass, ferns, heather, foam, etc.).
  65 1. Descend the craft and observe throttle position and record throttle value from your TX channel monitor.  Ideally 1500 should be hover. So your value should be less than 1500.
  66 1. Stop, disarm.
  67 1. Set failsafe throttle to the recorded value.
  68 1. Arm, hover over something soft again.
  69 1. Turn off TX (!)
  70 1. Observe craft descends and motors continue to spin for the configured duration.
  71 1. Observe FC disarms after the configured duration.
  72 1. Remove flight battery.
  73
  74 If craft descends too quickly then increase failsafe throttle setting.
  75
  76 Ensure that the duration is long enough for your craft to land at the altitudes you normally fly at.
  77
  78
  79
  80 ## Configuration
  81
  82 When configuring the flight controller failsafe, use the following steps:
  83
  84 1.  Configure your receiver to do one of the following:
  85
  86 a)  Upon signal loss, send no signal/pulses over the channels
  87
  88 b)  Send an invalid signal over the channels (for example, send values lower than 'rx_min_usec')
  89
  90 and
  91
  92 c)  Ensure your receiver does not send out channel data that would cause a disarm by switch or sticks to be registered by the FC. This is especially important for those using a switch to arm.
  93
  94 See your receiver's documentation for direction on how to accomplish one of these.
  95
  96 2.  Set 'failsafe_off_delay' to an appropriate value based on how high you fly
  97
  98 3.  Set 'failsafe_throttle' to a value that allows the aircraft to descend at approximately one meter per second (default is 1000 which should be throttle off).
  99
 100 4.  Enable 'FAILSAFE' feature in Cleanflight GUI or via CLI using `feature FAILSAFE`
 101
 102
 103
 104 These are the basic steps for flight controller failsafe configuration; see Failsafe Settings below for additional settings that may be changed.
 105
 106 ##Failsafe Settings
 107
 108 Failsafe delays are configured in 0.1 second steps.
 109
 110 1 step = 0.1sec
 111
 112 1 second = 10 steps
 113
 114 ### `failsafe_delay`
 115
 116 Guard time for failsafe activation after signal lost.  This is the amount of time the flight controller waits to see if it begins receiving a valid signal again before activating failsafe.
 117
 118 ### `failsafe_off_delay`
 119
 120 Delay after failsafe activates before motors finally turn off.  This is the amount of time 'failsafe_throttle' is active.  If you fly at higher altitudes you may need more time to descend safely.
 121
 122 ### `failsafe_throttle`
 123
 124 Throttle level used for landing.  Specify a value that causes the aircraft to descend at about 1M/sec. Default is set to 1000 which should correspond to throttle off.
 125
 126 Use standard RX usec values.  See RX documentation.
 127