docs/Models.md

   1 # Model Setup
   2 This is the page to document model or receiver specific setup instructions.
   3
   4 The Deviation project (on which this project was based) have a useful list of models [here](http://www.deviationtx.com/wiki/supported_models).
   5
   6 # Syma X5C
   7 <img src="http://img2.cheapdrone.co.uk/images/upload/2014/12/X5C%203/SKU115108-7.jpg" Width="200" Height="200" />
   8
   9 ## Channel Map
  10
  11 CH1|CH2|CH3|CH4|CH5|CH6|CH7|CH8|CH9
  12 ---|---|---|---|---|---|---|---|---
  13 A|E|T|R|FLIP|RATES|PICTURE|VIDEO|HEADLESS
  14
  15 ## Binding
  16 There are no special binding instructions.  The model powers up in Autobind mode and expects the bind sequence from the transmitter within the first 4-5 seconds.
  17
  18 ## Tx Setup
  19 A basic 4-channel setup works perfectly, but some improvements are possible:
  20
  21 ### Setting up a switch to Flip
  22
  23 1. Choose your "Rates" switch - typically the momentary TRN switch
  24 1. In the Mixer create an entry for CH5
  25 1. Edit this line as follows:
  26    - er9X: Source: sTRN, Weight 100 (or whatever switch you selected)
  27    - OpenTx: Source: SH, Weight 200 (or whatever switch you selected)
  28
  29 ### Setting up a swich for high rates
  30
  31 1. Choose your "Rates" switch
  32 1. In the Mixer create an entry for CH6
  33 1. Edit this line as follows:
  34    - er9X: Source: sTHR, Weight 100 (or whatever switch you selected)
  35    - OpenTx: Source: SF, Weight 200 (or whatever switch you selected)
  36
  37 When the switch is in the rear position the rates will be standard, when the switch is forward rates will be high.  There is no need to move the throttle stick to the full up and full down position as with the standard controller.
  38
  39 ### Setting up Idle-up
  40 One of the most annoying functions on the Syma X5C is that the motors stop when the throttle is pulled back.  This can be fixed by implmenting Idle-up on the transmitter (think of this as a very simple version of the Betaflight "Air Mode").  Idle up will ensure that even when the throttle is all the way down, a minimum command is passed to the motor to keep them spinning and to activate the stabilization.
  41
  42 **To do this**:
  43
  44 1. Decide on a switch you will use to activate Idle up
  45 1. In the mixer menu add a line under Throttle and mix in a value of between 4 and 6 to be added to the throttle value if the switch is activated.  What this does is effectively prevents the throttle from going down to less than this value.
  46 1. When you want to fly in "idle-up" mode flick the switch and your stabilization will always be active.
  47 1. Remeber to switch off idle-up as soon as the quad lands (or crashes - to avoid damage to the motors)
  48
  49 ### Additional notes on rates:
  50
  51 The SymaX driver can add full trim to the control output.  Doing so enables
  52 dramatic rates, steep angles, and high speeds.  If CH6 is low, the usual Syma
  53 full rates will be in effect.  If CH6 is high, the SymaX extreme trim rates will be
  54 in effect.  Be cautious when first trying out the extreme rates.
  55
  56 The extreme rates do not work with with headless mode because in this
  57 mode the trim and the primary control directions may not be aligned - the
  58 primary control directions will be based on the headless mode, but the trims
  59 remain based upon the quadcopter's heading.  So extreme rates are disabled
  60 when headless mode is selected.
  61
  62 Be aware that the use of extreme rates and the resulting steep angles will
  63 disorient the gyro responsible for maintaining headless mode, and that the
  64 direction the quadcopter thinks you selected for headless mode may not be
  65 correct after especially wild flights.
  66
  67
  68 # Inductrix (Horizon Hobby)
  69
  70 <img src="https://s7d5.scene7.com/is/image/horizonhobby/BLH8700_a0" Width="200" Height="200" />
  71
  72 ## Binding
  73 For telemetry enabled modules, you should just let the remote autodetect the settings. Otherwise choose DSMX 22ms with 6ch or 7ch. To bind the model, keep the transmitter off, power on the Inductrix. Wait until it flashes fast and then power up the Tx and use Bind.
  74
  75 ### Throttle
  76 For Inductrix FPV you might need to adjust the lower end of throttle to be a higher than default, otherwise motors will be spinning on minimal throttle.  One way to do this is to set the throttle to 80% output (100% of DSM output) and then to enable the **Throttle Idle Trim Only** under the Model Setup menu.  See image below:
  77
  78 <img src="images/Inductrix_Throttle_Setup.png" Width="600" Height="200" />
  79
  80 ### Acro and Level Mode
  81 Setup channel 6 with a momemtary button or switch (e.g. SH on the Taranis) and use that switch to switch between modes. Set the output to somewhere between 40% to 60% for best results.
  82
  83 An addition consideration when flying in Acro mode is to reduce stick sensitivity and to add some expo.  The screens below show one way of doing this.  Customize to your needs.
  84
  85 #### Inputs Screen
  86 The follwing INPUTS screen shows one potential setup to introduce expo for Acro mode.  The activation of the expo on Roll, Pitch and Yaw is when the SG switch is not in the back position.  Add to taste.
  87
  88 <img src="images/Inductrix_Inputs.png" Width="600" Height="200" />
  89
  90 #### Aileron Rates attached to Switch !SG-up
  91 The next screen shows and example of how the expo (50%) was set up on the stick input and how it is activated by !SG-up:
  92
  93 <img src="images/Inductrix_Aileron_Expo.png" Width="600" Height="200" />
  94
  95 #### Mixer Menu
  96 The next screen shows the mixer menu with the mode change on momentary switch SH and High-Low rates on switch SC:
  97
  98 <img src="images/Inductrix_Mixer.png" Width="600" Height="200" />
  99
 100 # Cheerson CX-20 / Quanum Nova
 101 <img src="images/cx20.jpg" Width="200" Height="155" />
 102
 103 ## Channel Map
 104
 105 CH1|CH2|CH3|CH4|CH5|CH6|CH7
 106 ---|---|---|---|---|---|---
 107 A|E|T|R|MODE|AUX1|AUX2
 108
 109 ## Binding
 110 The Rx powers up in binding mode so the transmitter should be set to autobind.  If the Tx signal is lost due to power-off or going out of range the Rx will not re-bind, and requires power-cycling before it will bind again.
 111
 112 ## Tx Setup
 113 AETR are simple +100% mixes.  Note that the model expects Elevator (CH2) to be reversed, which is handled in the module firmware, so no need to reverse it on the Tx.
 114
 115 ### Flight modes
 116 CH5 is used to transmit the flight mode to the APM flight controller by setting the output to a value in a pre-defined range.  The original Tx uses a 3-pos switch (SWA) and a 2-pos switch (SWB) to achieve six different combinations, but only five are used - with SWA at 0, 1500 is sent when SWB is at 0 and 1, leaving flight mode 3 unused.  However, in the stock CX-20 flight controller settings, both flight mode 3 and 4 are set to the same flight mode, meaning we can configure our new Tx settings to send a value for mode 3 without changing the standard flight mode behaviour.  Afterwards, you can optionally use Mission Planner to assign a new flight mode to mode 3 or mode 4, or reconfigure them altogether.
 117
 118 The values, modes, and switch positions for the stock Tx are:
 119
 120 Mode|Stock Tx PWM Value|CX-20 Mode|SWA|SWB
 121 ---|---|---|---|---
 122 1|1100|Return to Home|2|0
 123 2|1300|Altitude Sensor|2|1
 124 3||||
 125 4|1500|Manual|0|0 or 1
 126 5|1700|Direction Lock|1|1
 127 6|1900|Stable|1|0
 128
 129 **NB** The CX-20 uses flight mode names which are different to the standard APM flight mode names. The CX-20 modes map to APM modes as follows:
 130
 131 CX-20 Mode|APM Mode
 132 ---|---
 133 Manual|Stabilize
 134 Stable|Loiter
 135 Direction Locked|Simple
 136 Altitude Sensor|Altitude Hold
 137 Return to Home|RTL (Return to Launch)
 138
 139 We need to set the Tx up to output these values on CH5 (or very similar values - more information, including the PWM width ranges is documented in the [Arducopter Wiki](http://ardupilot.org/copter/docs/common-rc-transmitter-flight-mode-configuration.html#common-rc-transmitter-flight-mode-configuration)).
 140
 141 One easy way to acheive this is to configure six logical switches mapped to two physical switches, for example the 3-way ID switch and the AIL D/R switch, then configure the logical switches to activate a flgiht mode and to apply a specific weight to the CH5 output.
 142
 143 To simply map the old Tx modes to the new Tx using the same switch positions, use the following configuration. The stock SWA switch is replaced with the ID0/1/2 switch, SWB is replaced with the AIL D/R switch.
 144
 145 #### Logical switches:
 146
 147 Switch|Function|V1|V2
 148 ---|---|---|---
 149 L. Switch 1|AND|ID2|!AIL
 150 L. Switch 2|AND|ID2|AIL
 151 L. Switch 3|AND|ID0|!AIL
 152 L. Switch 4|AND|ID0|AIL
 153 L. Switch 5|AND|ID1|AIL
 154 L. Switch 6|AND|ID1|!AIL
 155
 156 #### light modes (using CX-20 names):
 157
 158 Mode|Name|Switch
 159 ---|---|---
 160 1|RTL|L1
 161 2|AltSen|L2
 162 3|Manual|L3
 163 4|Manual|L4
 164 5|DirLock|L5
 165 6|Stable|L6
 166
 167 #### Mixer setup:
 168
 169 Channel|Weight|Source|Switch|Multiplex
 170 ---|---|---|---|---
 171 CH5|-80%|HALF|L1|REPLACE
 172  |-40%|HALF|L2|REPLACE
 173  |-20%|HALF|L3|REPLACE
 174  |+0%|HALF|L4|REPLACE
 175  |+40%|HALF|L5|REPLACE
 176  |+80%|HALF|L6|REPLACE
 177
 178 **NB** The weight values in this table will get you in the ball park, and will most likely work fine.  Because transmitters can vary they should be double-checked in the Mission Planer Radio Calibration screen, and tweaked as necessary.
 179
 180 ### CH6 and CH7
 181 CH6 and CH7 can be assigned to switches or pots to provide additionaly functionality such as PID tuning, gimbal control, or APM auto-tune or auto-land.
 182
 183 Replicating the stock setup of two pots, you would assign:
 184
 185 Channel|Weight|Source|Multiplex
 186 ---|---|---|---
 187 CH6|+100%|P1|ADD
 188 CH7|+100%|P3|ADD
 189
 190 ## Full Mixer Setup
 191
 192 Channel|Source|Weight|Switch|Multiplex
 193 ---|---|---|---|---
 194 CH1|+100%|Aileron||
 195 CH2|+100%|Elevator||
 196 CH3|+100%|Throttle||
 197 CH4|+100%|Rudder||
 198 CH5|-80%|HALF|L1|REPLACE
 199  |-40%|HALF|L2|REPLACE
 200  |-20%|HALF|L3|REPLACE
 201  |+0%|HALF|L4|REPLACE
 202  |+40%|HALF|L5|REPLACE
 203  |+80%|HALF|L6|REPLACE
 204 CH6|+100%|P1|
 205 CH7|+100%|P3|
 206
 207 Once you have configured the mixes you should connect Mission Planner to your CX-20 and use the Radio Calibration screen to verify that the channels are correctly assigned, and that the flight modes are correct.  Mission planner will give the exact PWM value on CH5, allowing the weights to be adjusted if needed.
 208
 209