docs/Rx.md

   1 # Receivers (RX)
   2
   3 A receiver is used to receive radio control signals from your transmitter and convert them into signals that the flight controller can understand.
   4
   5 There are 3 basic types of receivers:
   6
   7 1. Parallel PWM Receivers
   8 2. PPM Receivers
   9 3. Serial Receivers
  10
  11 ## Parallel PWM Receivers
  12
  13 8 channel support, 1 channel per input pin.  On some platforms using parallel input will disable the use of serial ports
  14 and SoftSerial making it hard to use telemetry or GPS features.
  15
  16 ## PPM Receivers
  17
  18 PPM is sometimes known as PPM SUM or CPPM.
  19
  20 12 channels via a single input pin, not as accurate or jitter free as methods that use serial communications, but readily available.
  21
  22 These receivers are reported working:
  23
  24 FrSky D4R-II
  25 http://www.frsky-rc.com/product/pro.php?pro_id=24
  26
  27 Graupner GR24
  28 http://www.graupner.de/en/products/33512/product.aspx
  29
  30 R615X Spektrum/JR DSM2/DSMX Compatible 6Ch 2.4GHz Receiver w/CPPM
  31 http://orangerx.com/2014/05/20/r615x-spektrumjr-dsm2dsmx-compatible-6ch-2-4ghz-receiver-wcppm-2/
  32
  33 FrSky D8R-XP 8ch telemetry receiver, or CPPM and RSSI enabled receiver
  34 http://www.frsky-rc.com/product/pro.php?pro_id=21
  35
  36 ## Serial Receivers
  37
  38 ### Spektrum
  39
  40 8 channels via serial currently supported.
  41
  42 These receivers are reported working:
  43
  44 Lemon Rx DSMX Compatible PPM 8-Channel Receiver + Lemon DSMX Compatible Satellite with Failsafe
  45 http://www.lemon-rx.com/shop/index.php?route=product/product&product_id=118
  46
  47
  48 ### S.BUS
  49
  50 16 channels via serial currently supported.  See the Serial chapter in the documentation for a configuration example.
  51
  52 * In most cases you will need an inverter between the receiver output and the flight controller hardware.
  53 * Softserial ports cannot be used with SBUS because it runs at too high of a bitrate (1Mbps).  Refer to the chapter specific to your board to determine which port(s) may be used.
  54 * You will need to configure the channel mapping in the GUI (Receiver tab) or CLI (`map` command).
  55
  56 These receivers are reported working:
  57
  58 FrSky X4RSB 3/16ch Telemetry Receiver
  59 http://www.frsky-rc.com/product/pro.php?pro_id=135
  60
  61 FrSky X8R 8/16ch Telemetry Receiver
  62 http://www.frsky-rc.com/product/pro.php?pro_id=105
  63
  64 Futaba R2008SB 2.4GHz S-FHSS
  65 http://www.futaba-rc.com/systems/futk8100-8j/
  66
  67
  68 #### OpenTX S.BUS configuration
  69
  70 If using OpenTX set the transmitter module to D16 mode and select CH1-16 on the transmitter before binding to allow reception
  71 of 16 channels.
  72
  73 OpenTX 2.09, which is shipped on some Taranis X9D Plus transmitters, has a bug - [issue:1701](https://github.com/opentx/opentx/issues/1701).
  74 The bug prevents use of all 16 channels.  Upgrade to the latest OpenTX version to allow correct reception of all 16 channels,
  75 without the fix you are limited to 8 channels regardless of the CH1-16/D16 settings.
  76
  77
  78 ### XBUS
  79
  80 The firmware currently supports the MODE B version of the XBus protocol.
  81 Make sure to set your TX to use "MODE B" for XBUS in the TX menus!
  82 See here for info on JR's XBUS protocol: http://www.jrpropo.com/english/propo/XBus/
  83
  84 These receivers are reported working:
  85
  86 XG14 14ch DMSS System w/RG731BX XBus Receiver
  87 http://www.jramericas.com/233794/JRP00631/
  88
  89 ### SUMD
  90
  91 16 channels via serial currently supported.
  92
  93 These receivers are reported working:
  94
  95 GR-24 receiver HoTT
  96 http://www.graupner.de/en/products/33512/product.aspx
  97
  98 Graupner receiver GR-12SH+ HoTT
  99 http://www.graupner.de/en/products/870ade17-ace8-427f-943b-657040579906/33565/product.aspx
 100
 101 ### SUMH
 102
 103 8 channels via serial currently supported.
 104
 105 SUMH is a legacy Graupner protocol.  Graupner have issued a firmware updates for many recivers that lets them use SUMD instead.
 106
 107 ## MultiWii serial protocol (MSP)
 108
 109 Allows you to use MSP commands as the RC input.  Only 8 channel support to maintain compatibility with MSP.
 110
 111 ## Configuration
 112
 113 There are 3 features that control receiver mode:
 114
 115 ```
 116 RX_PPM
 117 RX_SERIAL
 118 RX_PARALLEL_PWM
 119 RX_MSP
 120 ```
 121
 122 Only one receiver feature can be enabled at a time.
 123
 124 ### Serial RX
 125
 126 See the Serial chapter for some some RX configuration examples.
 127
 128 For Serial RX enable `RX_SERIAL` and set the `serialrx_provider` CLI setting as follows.
 129
 130 | Serial RX Provider | Value |
 131 | ------------------ | ----- |
 132 | SPEKTRUM1024       | 0     |
 133 | SPEKTRUM2048       | 1     |
 134 | SBUS               | 2     |
 135 | SUMD               | 3     |
 136 | SUMH               | 4     |
 137 | XBUS_MODE_B        | 5     |
 138
 139
 140 ### PPM/PWM input filtering.
 141
 142 Hardware input filtering can be enabled if you are experiencing interference on the signal sent via your PWM/PPM RX.
 143
 144 Use the `input_filtering_mode` CLI setting to select a mode.
 145
 146 | Value | Meaning   |
 147 | ----- | --------- |
 148 | 0     | Disabled  |
 149 | 1     | Enabled   |
 150