Updated Lightweight Telemetry (LTM) (markdown)
[inav.wiki.git] / Howto:-CC3D-flight-controller,-minimOSD,-GPS-and-LTM-telemetry-for-fixed-wing.md
blobe4e6b5e7d0ec0d54329c82e2e59f93d076ea6e31
1 # HOWTO setup iNAV for fixed wing
3 ## Index
4 1. Features
6 2. What is needed
8 3. Flashing iNAV firmware to CC3D.
10 4. Basic settings
12 Flight controller orientation.
14 Port settings
16 Configuration
18 Failsafe
20 Telemetry (LTM)
22 Transmitter setup
24 Motors
26 Servo setup
28 Recommended power layout
30 OSD setup
34 ## 1. Features
35 - Stabilization (Angle, Horizon modes)
36 - RTH (baro and mag are not needed for fixed wing)
37 - Waypoint missions (with EZGUI android apk).
38 - Battery monitoring
39 - RSSI monitoring
40 - Failsafe
41 - Telemetry
42 - etc
44 ## 2. What is needed
45 - Flight controller (one from the list, this guide shows how to setup CC3D)
46 - OSD (minimOSD or any other that supports Cleanflight)
47 - RX with telemetry support (just in case you want also telemetry). And a telemetry capable ground system.
48 - GPS receiver (any that supports at least 5Hz update)
49 - FPV hardware, airframe, RC
51 ## 3. Flashing iNAV firmware to CC3D.
52 First you need to download a precompiled firmware for the board [here](https://github.com/iNavFlight/inav/releases). Select one of the releases precompiled for CC3D:
53 - _inav_x.x.x_CC3D.hex_ 
54 - _inav_x.x.x_CC3D_PPM1.hex_ (for  PPM input  on Pin 3 and RSSI_ADC  on Pin 8. See Board_CC3D document in /docs)
56 You only can flash cc3d through FTDI and MainPort (USART1). Not usb, neither FlexiPort.
58 Next, you can check [numerous guides](https://www.youtube.com/watch?v=eClp-YBeSms&t=0s) how to flash CC3D with third party firmware (Attention, you'll need a FTDI adapter for the purpose). Of course you need to specify the previously downloaded firmware for the flashing. 
60 ## 4. Basic settings
62 ### Port settings
63 It is done using Ports tab ![Ports tab](http://s8.hostingkartinok.com/uploads/images/2017/02/631dc2afa3f22266a8308532735b836e.png).
65 - UART1 - leave default value. You'll connect here either OSD or FTDI to setup the FC. If you want telemetry select it in Inav configurator, so you can have telemetry when the aircraft is armed. In this case, your OSD should be capable to read LTM, in order to mantain working OSD and telemetry at the same time. You have to connect the TX line from CC3D to both OSD and RX telemetry capable receiver (as openlrsng systems). MWOSD can read both MSP and LTM telemetry.
66 - UART3 - for GPS. Switch on the option and select the correct port speed (38400 or 57600). Please pay attention that when using a ublox GPS receiver family 6-8 you don't need to make any configurations in the u-center. The flight controller under iNAV will do everything what is needed.
68 ### Configuration
69 On the Configuration tab in the Mixer group select the Airplane or Flying Wing depending on the airframe you are using.
70 ![Airplane](http://s8.hostingkartinok.com/uploads/images/2017/02/cbcafe5219dcc85798b0cf2e2a86fcde.png)
71 Do not pay attention on the servo numbering! It will be described later.
72 Now you need to make the accelerometer calibration. It is mandatory to fulfill it and it is better to do it before installing the FC into airframe. Please follow the [instructions](https://github.com/iNavFlight/inav/wiki/Sensor-calibration) to perform the 6 point accelerometer calibration.
73 Do not activate "enable motor and servo otput" until you are sure the kind of airplane has been selected correctly. Otherwise, servos can receive high frecuencies (as for ESCs) and burn.
75 ### Flight controller orientation.
76 After the calibration is done you may select the sutable board orientation
77 ![Orientation](http://s8.hostingkartinok.com/uploads/images/2017/02/5fc75e098b96313009ac4a192954b714.png)
78 If you need to install your FC board into airplane such a way that the forward arrow points to some other direction, you need to change the FC orientation. This can be done or in the iNAV GUI or from CLI. I prefer doing it from GUI. Follow the Configuration tab and Board and sensor Alignment. If you want to mount the CC3D flight controller with USB plug to the left you need to set the Yaw Degrees parameter to 90. If you are going to mount the FC with USB plug facing right, then the Yaw Degrees = 270, etc.
80 Now you are ready to connect your hardware according to the schemes:
82 Parallel PWM Receiver ([click here](http://s8.hostingkartinok.com/uploads/images/2016/02/a47fb019c7783371053239a3d23a8d46.jpg) to see the real hardware photo)
84 <img src="http://s8.hostingkartinok.com/uploads/images/2016/02/4e641362191528c42758d626757b747a.png" width="400" height="300" />
86 PPM Receiver
88 <img src="http://s8.hostingkartinok.com/uploads/images/2016/02/c98cfcf64df8a8a7645429dc7ac4c0ea.png" width="400" height="300" />
90 Of course, according to the receiver used you need to use the aproppriate firmware for CC3D - inav_1.6.0_CC3D.hex for parallel PWM or inav_1.6.0_CC3D_PPM1.hex PPM receiver. For more information about CC3D pinout check the [CC3D](https://github.com/iNavFlight/inav/blob/master/docs/Board%20-%20CC3D.md) page
92 I usually don't like the motor rotation on arm, so I switch on the "Don't spin motors when armed" feature.
94 The new iNAV firmware has all PWM outputs disable until you switch on the "Enable motor and servo output"
96 Switch on the GPS feature, and select the protocol.
97 ![GPS and other settings](http://s8.hostingkartinok.com/uploads/images/2017/02/299f7c79a6293db997088e129a696caf.png)
99 If your GPS receiver have enough satellites visible you'll be able to check the 3D fix in GPS tab
100 ![3D fix] (http://s8.hostingkartinok.com/uploads/images/2017/02/2db676b5f03d436480919b1cbc945fb5.png)
102 By default INAV won't arm without GPS fix if the GPS feature is ON. To disable it use CLI: "set nav_extra_arming_safety = OFF". And it is highly recomended to switch it back ON before real flights.
104 If your receiver connection is other than Parallel PWM Receiver, then you'll be able to setup battery voltage, current, RSSI monitoring. It is very userful. So IMHO a PPM is a must for CC3D FC.
106 On the Receiver tab set up the channel order and their correspondence to TX sticks movements.
108 On the Modes tab set up the flight modes according to the position of the AUX channels. For example, if you have a 3pos switch for the AUX1 you can get at minimum the following:
110 * minimum channel value - do not select any mode - only gyros will work. The hand launch take off in this mode is excellent.
111 * middle value - Angle or Horizon.
112 * maximum value - RTH. Automatic return home.
114 ![Flight modes](http://s8.hostingkartinok.com/uploads/images/2017/02/60c42df3c50ead25347f0252b51f55da.png)
116 ### Failsafe
118 Check [this link](https://github.com/iNavFlight/inav/wiki/Failsafe) for RTH failsafe
120 Starting from INAV 1.6 the Filesafe feature is very transparent and clear. For the failsafe to work you'll need:
121 * Setup the receiver output no signal when your TX is off
122 * OR assign the Failsafe mode to one of the channels and force it to trigger when your TX is off
124 Set the desired Failsafe behavior. I prefer RTH.
125 ![My failsafe](http://s8.hostingkartinok.com/uploads/images/2017/02/f91f666e2b97dce17462bb6534592519.png)
127 ###Telemetry
129 Connect your TX line and configure FC as explained above. Nowadays you can use several telemetry systems as [mwptools](https://github.com/stronnag/mwptools), [EZGUI](http://ez-gui.com/), [LTM Telemetry OLED](https://github.com/sppnk/LTM-Telemetry-OLED) and possibly others. The USART port can be shared with a OSD or used only for one of both features. For example, you can fly FPV w/o telemetry (just in your googles) or fly thermal soaring 3rd view w/o OSD. Or have both. Amazing you can do this with a simple cc3d, isnt it?.
131 ###Transmitter setup
133 You should adjust (normal or reverse) on your transmitter so sticks correspond to below:
135 In reciever tab:
136 * Throttle stick push away - increased value
137 * Yaw (Rudder) stick right - increased value
138 * Pitch (Elevator) stick push away - increased value
139 * Roll (Ailerons) stick right - increased value
141 Also use subtrim to get center value of 1500us and use travel adjustment to get at lowest value 1000us and highest 2000us when moving sticks.
142 ![My receiver settings](http://s8.hostingkartinok.com/uploads/images/2017/02/b2199bbbb760c7c7c1b3699c89cc4883.png)
144 ### Motors
146 After this follow to the Motors tab, rock your plane and notice what levels are moving depending on PITCH, ROLL and YAW angles. You can remember it or write it down. ROLL - 4,5; PITCH - 3, YAW - 6.
148 ![Motors tab](http://s8.hostingkartinok.com/uploads/images/2017/02/6996d5db9400c8d5330fc10bde0817a8.png)
150 Turn on your transmitter, switch to the Angle or Horizon flight mode and follow the Servos tab.
152 ### Servo setup
154 ![Servo tab](http://s8.hostingkartinok.com/uploads/images/2017/02/baafb90dc93d5553a945b684dd2f4ac8.png)
156 Here you need to be very attentive. In this tab you set up endpoints, neutral, rates and reverse for stabilization modes. Servo numbering in the tab starts from 0!
158 For the Elevator, tilt the plane's tail down, and the Elevator should go down. If the elevator goes up, then you need to set the Rate (the right-most drop down list) Servo 2 with negative sign.
160 Tilt the left wing down. Left Aileron should go down and right one should go up. If it is not so, then put negative Rate values for Servo 3 and Servo 4 (if your ailerons are connected by means of Y-cable, than you can change the settings for only one Servo or connect the Y-cable to other Servo out). 
162 Turn the tail to the left, and the Rudder should go to the left. Otherwise switch the Servo 5 Rate to negative.
164 After this stick movement should also move servos the correct way. (General rules: Elevator stick down - elevator goes up, Aileron stick to the left - left aileron is up, right aileron is down, Rudder stick to the left, rudder goes to the left)
166 Attention! all the endpoints, neutrals, trimmers should be done on this tab, not in transmitter!
168 ### Recommended power layout
170 To prevent brownout its wise to power servos with one BEC and the flight controller + other equipment with another BEC.
172 This is one way to accomplish it: 
174 Glued a new row of pins onto the case of the flightcontroller, the must be connected together. (See the bottom of pins)
176 All servos and ESC is connected to flightcontroller, except positive wire which goes to the new row. (This line gets its power from the BEC in the ESC)
178 Another external BEC is connected at random positive and negativ pin on flight controller to power it, the receiver and GPS.
180 This way if one servo get stuck and draws alot of amps you shouldnt risk your flight system to power down.
182 ![Connection Diagram](http://s13.postimg.org/5kpkb9ppz/Connection_Diagram.png)
183 ![Real life example](http://s28.postimg.org/jjg5paz65/Real_life_example_power_supply.png)
185 ### PID/PIFF Settings
186 The default PID settings that are set using Presets tab are a good starting point but usually you may need to chnge them if you want yor plane to fly really stable.
187 Here are my PIFF settings for a small 800mm flying wing - EPP Rainbow.
188 ![My PID settings](http://s8.hostingkartinok.com/uploads/images/2017/02/317e88fbcaee882142291b81260a5e3d.png) 
190 DigitalEntity wrote about the PIFF controller setup procedure the following, I have nothing to add:
192 If you have inflight adjustments - this will be easier for you. I tuned like this:
194 0) Fly ANGLE mode, LOS, calm day. Started with these PIFFs: P=5, I=10, D/FF = 20
196 1) Give hard roll command, watch how plane executes it. It should be smooth from start to finish, without (or with minimal) oscillation at the end of the roll, without much wobble. If it oscillates at the end of maneuver - reduce FF; if it starts fast, then slows down and after a moment pushes it further - that's indication of too low FF
198 2) Repeat for pitch
200 3) I dialed up FF as much as possible until I started to get oscillations at the end of maneuver and backed about 20%
202 4) If it doesn't reach commanded angle - increase I-gain (best verifiable with OSD indication for roll/pitch angles
204 5) Wait for some wind (to get some turbulence) 
206 6) Dial up P to fight turbulence better. In ANGLE mode I+FF will keep aircraft nice and level, but P will improve turbulence handling. WARNING - increasing P will cause much more active servos and reduce their life expectancy.
208 ### OSD setup
209 I prefer using MW-OSD. It supports many protocols and also has native support of iNAV. Say you have a minimOSD or micro minimOSD. So first you need to upload [MWOSD](http://www.mwosd.com/) firmware to your minimOSD. You can find pretty straight forward install guide following the [link](https://github.com/ShikOfTheRa/scarab-osd/blob/master/OTHER/DOCUMENTATION/FirmwareFlashing.md). As usual you use Arduino IDE for global OSD config. All changes are done in the Config.h file. In our case we need to leave uncommented the following lines:
211 OSD HARDWARE settings:
213 `#define MINIMOSD`
215 CONTROLLER SOFTWARE
217 `#define iNAV`
219 AIRCRAFT/INSTALLATION TYPE settings
221 `#define FIXEDWING`
223 TELEMETRY LTM settings
225 `#define FORCE_MSP`                 // Uncomment to enable use of MSP as well as telemetry. Uses more memory
227 `#define PROTOCOL_LTM`              // To use LTM protocol instead of MSP
229 `#define BAUDRATE 9600`
232 Usualy it is enough.
234 You may enable also rather helpful `#define MAPMODE` under FEATURES that allows you to see the map indication of relative positions of home and aircraft.
236 Configure config.h allowing LTM if you want to share USART1 with your telemetry system, as explained above.
238 All other settings are done in MWOSD configurator. Everything you need is to select the font you like, OSD indicators' positions. As iNAV takes care of voltage/current/rssi monitoring you'll need to ask the MWOSD to take these values from the FC (see the fig) 
240 The screenshot of the MWOSD configuration is shown below:
241 ![MWOSD config](http://s8.hostingkartinok.com/uploads/images/2017/02/57085e4054b03a4ee52179224bc5f337.png)
243 Watch this demo video of the iNAV flight and RTH function:
245 [![iNAV on FT Duster](http://img.youtube.com/vi/GYd7mxGxNL8/0.jpg)](https://www.youtube.com/watch?v=GYd7mxGxNL8)
247 Good luck!