Merge pull request #4923 from mikeller/add_rx_unidirectional_check
[betaflight.git] / docs / Rssi.md
blob96d49475ea125975ce10acaab2e36828748ee1e5
1 # RSSI
3 RSSI is a measurement of signal strength and is very handy so you know when your aircraft is going out of range or if it is suffering RF interference.
5 Some receivers have RSSI outputs. 3 types are supported.
7 1. RSSI via PPM channel
8 1. RSSI via Parallel PWM channel
9 1. RSSI via ADC with PPM RC that has an RSSI output - aka RSSI ADC
11 ## RSSI via PPM
13 Configure your receiver to output RSSI on a spare channel, then select the channel used via the CLI.
15 e.g. if you used channel 9 then you would set:
17 ```
18 set rssi_channel = 9
19 ```
20 Note: Some systems such as EZUHF invert the RSSI ( 0 = Full signal / 100 = Lost signal). To correct this problem you can invert the channel input so you will get a correct reading by using command:
22 ```
23 set rssi_invert = ON
24 ```
25 Default is set to "OFF" for normal operation ( 100 = Full signal / 0 = Lost signal).
27 ## RSSI via Parallel PWM channel
29 Connect the RSSI signal to any PWM input channel then set the RSSI channel as you would for RSSI via PPM
31 ## RSSI ADC
33 Connect the RSSI signal to the RC2/CH2 input. The signal must be between 0v and 3.3v.
34 Use inline resistors to lower voltage if required; inline smoothing capacitors may also help.
35 A simple PPM->RSSI conditioner can easily be made. See the  PPM-RSSI conditioning.pdf  for details.
37 Under CLI :
38 - enable using the RSSI_ADC feature  :  `feature RSSI_ADC`
39 - set the RSSI_SCALE parameter (between 1 and 255) to adjust RSSI level according to your configuration. The raw ADC value is divided by the value of this parameter.
41 Note: Some systems invert the RSSI ( 0 = Full signal / 100 = Lost signal). To correct this problem you can invert the input so you will get a correct reading by using command:
43 ```
44 set rssi_invert = ON
45 ```
47 ## RSSI_SCALE setup method:
49 - set rssi_scale = 100. The displayed percentage will then be the raw ADC value.
50 - turn on RX (close to board). RSSI value should vary a little.
51 - Update rssi_scale to the maximum RSSI value previously measured.
53 FrSky D4R-II and X8R supported.
55 The feature can not be used when RX_PARALLEL_PWM is enabled.