Update readme
[betaflight.git] / docs / Rssi.md
blob63a50f6330ae95d9848f245c82479aea7c372de8
1 # RSSI
3 RSSI is a measurement of signal strength and is very handy so you know when your aircraft isw 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_ppm_invert = 1
24 ```
25 Default is set to "0" 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.
42 FrSky D4R-II and X8R supported.
44 The feature can not be used when RX_PARALLEL_PWM is enabled.