docs/LedStrip.md

   1 # LED Strip
   2
   3 Betaflight supports the use of addressable LED strips.  Addressable LED strips allow each LED in the strip to be programmed with a unique and independent color.  This is far more advanced than the normal RGB strips which require that all the LEDs in the strip show the same color.
   4
   5
   6 ## LED Strip Profiles
   7
   8 The LED strip feature supports 3 LED strip profiles, STATUS, RACE and BEACON.  The selected profile can be changed from the CLI, OSD LED strip menu or from an adjustment channel, i.e. switch on your radio.  Take note that the adjustment channel from your radio overrides all other LED strip profile selection options.
   9
  10
  11 ### STATUS Profile
  12
  13 The STATUS profile is used to display all the information mentioned below, i.e. warning indications, Larson scanner etc.
  14
  15 Addressable LED strips can be used to show information from the flight controller system, the current implementation supports the following:
  16
  17 * Up to 32 LEDs. (Support for more than 32 LEDs is possible, it just requires additional development.)
  18 * Indicators showing pitch/roll stick positions.
  19 * Heading/Orientation lights.
  20 * Flight mode specific color schemes.
  21 * Low battery warning.
  22 * AUX operated on/off switch.
  23 * GPS state.
  24 * RSSI level.
  25 * Battery level.
  26
  27
  28 ### RACE Profile
  29
  30 The RACE profile is used to set ALL strip LEDs to the selected color for racing, i.e. to identify quads based on LED color.  The LED color is fixed and no other information is displayed.
  31
  32
  33 ### BEACON Profile
  34
  35 The BEACON profile is used to find a lost quad, it flashes all LEDs white once per second.  Again in this profile no other information is displayed on the LEDs.
  36
  37
  38 ### LED Profile Configuration
  39
  40 ###### OPTION 1: Configure an adjustment range to change the LED strip profile from your radio
  41 1. Turn on Expert mode - see top right of configurator screen "Enable Expert Mode".
  42 2. The LED strip profile selection is performed using an adjustment configured via the Adjustments tab.
  43     - Enable an adjustment. ("If enabled")
  44     - Select the AUX channel to be used to change the LED strip profile. ("when channel")
  45     - Set the range to cover the entire range of the selected AUX channel. ("is in ranges")
  46     - For the action select "RC Rate Adjustment". ("then apply")  This will be configured in the CLI since LED strip profiles is not supported by Configurator 10.4.0 and earlier. "RC Rate Adjustment" is only selected to make the configuration in the CLI a little easier below.
  47     - Select the "via channel" to match the selected AUX channel of above. ("when channel").
  48     - Save
  49 3. Open the CLI and type ```adjrange``` followed by enter.
  50 4. Copy the adjrange configured in step 2. above and paste it in the command window.  Change the '1' following the range of the channel to '30' and press enter.  Type ```save``` and press enter.  The configured adjrange will now be saved and the FC will reboot.
  51 5. Configure the AUX channel on your radio.  When this channel is changed the selected LED strip profile will change between STATUS, RACE and BEACON, you should see the LED function change as you do this.
  52
  53
  54 ###### OPTION 2: Use the CLI to select the LED strip profile (i.e. not selecting the LED strip profile with your radio)
  55 1. Open the CLI.
  56 2. Type ```get ledstrip_profile``` followed by enter to display the currently selected LED strip profile.
  57 3. Type ```set ledstrip_profile=x``` where x is the profile STATUS, RACE or BEACON and press enter.
  58 4. Type ```save``` followed by enter to save the selected LED strip profile.
  59
  60
  61 ###### OPTION 3: By using the OSD
  62 1. Open the OSD menu by yawing left and pitching forward on your radio.
  63 2. Using the pitch stick, move down to the LED Strip menu and roll right to enter the menu.
  64 3. The profile and race color can be configured using the left stick to go back and the right stick to navigate up/down and to change the selected value.
  65 4. Use the left stick to go to the top level menu and select save & reboot to complete.
  66
  67
  68 ###### RACE COLOR: The Race color can be configured using the CLI:
  69 1. Open the CLI.
  70 2. Type ```get ledstrip_race_color``` followed by enter to display the currently selected race color number.
  71 3. Type ```set ledstrip_race_color=x``` where x is the required color.
  72 4. Type ```save``` followed by enter to save the race color to be used.
  73
  74
  75 ## Supported hardware
  76
  77 Only strips of 32 WS2811/WS2812 LEDs are supported currently.  If the strip is longer than 32 LEDs it does not matter, but only the first 32 are used.
  78
  79 WS2812 LEDs require an 800khz signal and precise timings and thus requires the use of a dedicated hardware timer.
  80
  81 Note: Not all WS2812 ICs use the same timings, some batches use different timings.
  82
  83 It could be possible to be able to specify the timings required via CLI if users request it.
  84
  85 ### Tested Hardware
  86
  87 * [Adafruit NeoPixel Jewel 7](https://www.adafruit.com/products/2226) (preliminary testing)
  88   * Measured current consumption in all white mode ~ 350 mA.
  89   * Fits well under motors on mini 250 quads.
  90 * [Adafruit NeoPixel Stick](https://www.adafruit.com/products/1426) (works well)
  91   * Measured current consumption in all white mode ~ 350 mA.
  92 * [Aliexpress SK6812 RBGWW strip](https://www.aliexpress.com/wholesale?SearchText=rgbw+sk6812) (works well)
  93   * Alternative [Adafruit NeoPixel Stick RGBW](https://www.adafruit.com/product/2869)
  94
  95
  96 ### WS2811 vs WS2812
  97
  98 The [WS2811](https://cdn-shop.adafruit.com/datasheets/WS2811.pdf) is a LED driver IC which is connected to an RGB LED. It accepts data in the form of 8 bits each of Red-Green-Blue.
  99
 100 The [WS2812](https://cdn-shop.adafruit.com/datasheets/WS2812.pdf) is integrated into the package of a 50:50 LED rather than as a separate device. It accepts data in the form of 8 bits each of Green-Red-Blue.
 101
 102 With the [SK6812](https://cdn-shop.adafruit.com/product-files/1138/SK6812+LED+datasheet+.pdf) also GRBW variants are supported, which have a fourth (white) channel and such provide a much cleaner white color.
 103
 104 It is thus possible, depending on the LED board/strip being used that either Red-Green-Blue or Green-Red-Blue encoding may be required. This may be controlled by setting the following.
 105
 106 ```
 107 set ledstrip_grb_rgb = RGB
 108 ```
 109 or
 110
 111 ```
 112 set ledstrip_grb_rgb = GRB
 113 ```
 114 or
 115
 116 ```
 117 set ledstrip_grb_rgb = GRBW
 118 ```
 119
 120 Then confirm the required setting by simply setting an LED to be green. If it lights up red, you have the wrong setting.
 121 Afterwards check if the second LED also lights up red - if not, you might have 4-color SK6812 LEDs and would have to select GRBW.
 122
 123 ## Connections
 124
 125 WS2812 LED strips generally require a single data line, 5V and GND.
 126
 127 WS2812 LEDs on full brightness can consume quite a bit of current.  It is recommended to verify the current draw and ensure your supply can cope with the load.  On a multirotor that uses multiple BEC ESC's you can try use a different BEC to the one the FC uses.  e.g. ESC1/BEC1 -> FC, ESC2/BEC2 -> LED strip.   It's also possible to power one half of the strip from one BEC and the other half from another BEC.  Just ensure that the GROUND is the same for all BEC outputs and LEDs.
 128
 129 | Target                | Pin  | LED Strip | Signal |
 130 | --------------------- | ---- | --------- | -------|
 131 | Naze                  | RC5  | Data In   | PA6    |
 132 | CC3D                  | RCO5 | Data In   | PB4    |
 133 | ChebuzzF3/F3Discovery | PB8  | Data In   | PB8    |
 134 | Sparky                | PWM5 | Data In   | PA6    |
 135
 136 Since RC5 is also used for SoftSerial on the Naze it means that you cannot use SoftSerial and led strips at the same time. Additionally, since RC5 is also used for Parallel PWM RC input on both the Naze, Chebuzz and STM32F3Discovery targets, led strips can not be used at the same time at Parallel PWM.
 137
 138 If you have LEDs that are intermittent, flicker or show the wrong colors then drop the VIN to less than 4.7v, e.g. by using an inline diode on the VIN to the LED strip. The problem occurs because of the difference in voltage between the data signal and the power signal.  The WS2811 LED's require the data signal (Din) to be between 0.3 * Vin (Max) and 0.7 * VIN (Min) to register valid logic low/high signals.  The LED pin on the CPU will always be between 0v to ~3.3v, so the Vin should be 4.7v (3.3v / 0.7 = 4.71v). Some LEDs are more tolerant of this than others.
 139
 140 The datasheet can be found here: http://www.adafruit.com/datasheets/WS2812.pdf
 141
 142 ## Configuration
 143
 144 The led strip feature can be configured via the GUI.
 145
 146 GUI:
 147 Enable the Led Strip feature via the GUI under setup.
 148
 149 Configure the LEDs from the Led Strip tab in the cleanflight GUI.
 150 First setup how the LEDs are laid out so that you can visualize it later as you configure and so the flight controller knows how many LEDs there are available.
 151
 152 There is a step by step guide on how to use the GUI to configure the Led Strip feature using the GUI http://blog.oscarliang.net/setup-rgb-led-cleanflight/ which was published early 2015 by Oscar Liang which may or may not be up-to-date by the time you read this.
 153
 154 CLI:
 155 Enable the `LED_STRIP` feature via the cli:
 156
 157 ```
 158 feature LED_STRIP
 159 ```
 160
 161 If you enable LED_STRIP feature and the feature is turned off again after a reboot then check your config does not conflict with other features, as above.
 162
 163 Configure the LEDs using the `led` command.
 164
 165 The `led` command takes either zero or two arguments - an zero-based led number and a sequence which indicates pair of coordinates, direction flags and mode flags and a color.
 166
 167 If used with zero arguments it prints out the led configuration which can be copied for future reference.
 168
 169 Each led is configured using the following template: `x,y:ddd:mmm:cc`
 170
 171 `x` and `y` are grid coordinates of a 0 based 16x16 grid, north west is 0,0, south east is 15,15
 172 `ddd` specifies the directions, since an led can face in any direction it can have multiple directions.  Directions are:
 173
 174  `N` - North
 175  `E` - East
 176  `S` - South
 177  `W` - West
 178  `U` - Up
 179  `D` - Down
 180
 181 For instance, an LED that faces South-east at a 45 degree downwards angle could be configured as `SED`.
 182
 183 Note: It is perfectly possible to configure an LED to have all directions `NESWUD` but probably doesn't make sense.
 184
 185 `mmm` specifies the modes that should be applied an LED.
 186
 187 Each LED has one base function:
 188
 189 * `C` - `C`olor.
 190 * `F` - `F`light mode & Orientation
 191 * `A` - `A`rmed state.
 192 * `R` - `R`ing thrust state.
 193 * `G` - `G`PS state.
 194 * `S` - R`S`SSI level.
 195 * `L` - Battery `L`evel.
 196
 197 And each LED has overlays:
 198
 199 * `W` - `W`warnings.
 200 * `I` - `I`ndicator.
 201 * `T` - `T`hrust state.
 202 * `B` - `B`link (flash twice) mode.
 203 * `O` - Lars`O`n Scanner (Cylon Effect).
 204 * `N` - Blink on la`N`ding (throttle < 50%).
 205
 206 `cc` specifies the color number (0 based index).
 207
 208 Example:
 209
 210 ```
 211 led 0 0,15:SD:AWI:0
 212 led 1 15,0:ND:AWI:0
 213 led 2 0,0:ND:AWI:0
 214 led 3 0,15:SD:AWI:0
 215 led 4 7,7::C:1
 216 led 5 8,8::C:2
 217 led 6 8,9::B:1
 218 ```
 219
 220 To erase an led, and to mark the end of the chain, use `0,0::` as the second argument, like this:
 221
 222 ```
 223 led 4 0,0:::
 224 ```
 225
 226 It is best to erase all LEDs that you do not have connected.
 227
 228 ### Modes
 229
 230 #### Warning
 231
 232 This mode simply uses the LEDs to flash when warnings occur.
 233
 234 | Warning | LED Pattern | Notes |
 235 |---------|-------------|-------|
 236 | Arm-lock enabled | flash between green and off | occurs during calibration or when unarmed and the aircraft is tilted too much |
 237 | Low Battery | flash red and off | battery monitoring must be enabled.  May trigger temporarily under high-throttle due to voltage drop |
 238 | Failsafe | flash between light blue and yellow | Failsafe must be enabled |
 239
 240 Flash patterns appear in order, so that it's clear which warnings are enabled.
 241
 242 #### GPS state
 243
 244 This mode shows the GPS state and satellite count.
 245
 246 No fix = red LED
 247 3D fix = green LED
 248
 249 The LEDs will blink as many times as the satellite count, then pause and start again.
 250
 251 #### RSSI level
 252
 253 This mode binds the LED color to RSSI level.
 254
 255 | Color      |   RSSI   |
 256 | ---------- | ---------|
 257 | Green      |   100%   |
 258 | Lime green |    80%   |
 259 | Yellow     |    60%   |
 260 | Orange     |    40%   |
 261 | Red        |    20%   |
 262 | Deep pink  |     0%   |
 263
 264 When RSSI is below 50% is reached, LEDs will blink slowly, and they will blink fast when under 20%.
 265
 266
 267 #### Battery level
 268
 269 This mode binds the LED color to remaining battery capacity.
 270
 271 | Color      | Capacity |
 272 | ---------- | ---------|
 273 | Green      |   100%   |
 274 | Lime green |    80%   |
 275 | Yellow     |    60%   |
 276 | Orange     |    40%   |
 277 | Red        |    20%   |
 278 | Deep pink  |     0%   |
 279
 280 When Warning or Critical voltage is reached, LEDs will blink slowly or fast.
 281 Note: this mode requires a current sensor. If you don't have the actual device you can set up a virtual current sensor (see [Battery](Battery.md)).
 282
 283 #### Blink
 284
 285 This mode blinks the current LED, alternatively from black to the current active color.
 286
 287 #### Blink on landing
 288
 289 This mode blinks the current LED, alternatively from black to the current active color, when throttle is below 50% and the craft is armed.
 290
 291 #### Larson Scanner (Cylon Effect)
 292
 293 The Larson Scanner replicates the scanning "eye" effect seen on the mechanical Cylons and on Kitt from Knight Rider.
 294 This overlay dims all of the LEDs it is assigned to and brightens certain ones at certain times in accordance with the animation. The animation is active regardless of arm state.
 295
 296 #### Flight Mode & Orientation
 297
 298 This mode shows the flight mode and orientation.
 299
 300 When flight modes are active then the LEDs are updated to show different colors depending on the mode, placement on the grid and direction.
 301
 302 LEDs are set in a specific order:
 303  * LEDs that marked as facing up or down.
 304  * LEDs that marked as facing west or east AND are on the west or east side of the grid.
 305  * LEDs that marked as facing north or south AND are on the north or south side of the grid.
 306
 307 That is, south facing LEDs have priority.
 308
 309 The mapping between modes led placement and colors is currently fixed and cannot be changed.
 310
 311 #### Indicator
 312
 313 This mode flashes LEDs that correspond to roll and pitch stick positions.  i.e.  they indicate the direction the craft is going to turn.
 314
 315 | Mode | Direction | LED Color |
 316 |------------|--------|---------------------|
 317 |Orientation | North  | WHITE                   |
 318 |Orientation | East   | DARK VIOLET     |
 319 |Orientation | South  | RED                     |
 320 |Orientation | West   | DEEP PINK               |
 321 |Orientation | Up     | BLUE                    |
 322 |Orientation | Down   | ORANGE          |
 323 | | | |
 324 |Head Free   | North  | LIME GREEN      |
 325 |Head Free   | East   | DARK VIOLET     |
 326 |Head Free   | South  | ORANGE          |
 327 |Head Free   | West   | DEEP PINK       |
 328 |Head Free   | Up     | BLUE                    |
 329 |Head Free   | Down   | ORANGE          |
 330 | | | |
 331 |Horizon     | North  | BLUE                    |
 332 |Horizon     | East   | DARK VIOLET     |
 333 |Horizon     | South  | YELLOW          |
 334 |Horizon     | West   | DEEP PINK       |
 335 |Horizon     | Up     | BLUE                    |
 336 |Horizon     | Down   | ORANGE          |
 337 | | | |
 338 |Angle       | North  | CYAN                    |
 339 |Angle       | East   | DARK VIOLET     |
 340 |Angle       | South  | YELLOW          |
 341 |Angle       | West   | DEEP PINK       |
 342 |Angle       | Up     | BLUE                    |
 343 |Angle       | Down   | ORANGE          |
 344 | | | |
 345 |Mag         | North  | MINT GREEN      |
 346 |Mag         | East   | DARK VIOLET     |
 347 |Mag         | South  | ORANGE          |
 348 |Mag         | West   | DEEP PINK       |
 349 |Mag         | Up     | BLUE                    |
 350 |Mag         | Down   | ORANGE          |
 351 | | | |
 352 |Baro        | North  | LIGHT BLUE      |
 353 |Baro        | East   | DARK VIOLET     |
 354 |Baro        | South  | RED                     |
 355 |Baro        | West   | DEEP PINK       |
 356 |Baro        | Up     | BLUE                    |
 357 |Baro        | Down   | ORANGE          |
 358
 359 #### Armed state
 360
 361 This mode toggles LEDs between green and blue when disarmed and armed, respectively.
 362
 363 Note: Armed State cannot be used with Flight Mode.
 364
 365 #### Thrust state
 366
 367 This mode fades the LED current LED color to the previous/next color in the HSB color space depending on throttle stick position.  When the throttle is in the middle position the color is unaffected, thus it can be mixed with orientation colors to indicate orientation and throttle at the same time.  Thrust should normally be combined with Color or Mode/Orientation.
 368
 369 #### Thrust ring state
 370
 371 This mode is allows you to use one or multiple led rings (e.g. NeoPixel ring) for an afterburner effect. LEDs with this mode will light up with their assigned color in a repeating sequence. Assigning the color black to an LED with the ring mode will prevent the LED from lighting up.
 372
 373 A better effect is achieved when LEDs configured for thrust ring have no other functions.
 374
 375 LED direction and X/Y positions are irrelevant for thrust ring LED state.  The order of the LEDs that have the state determines how the LED behaves, and the throttle value determines the animation rate. The animation is only active while armed.
 376
 377 Each LED of the ring can be a different color. The color can be selected between the 16 colors available.
 378
 379 For example, led 0 is set as a `R`ing thrust state led in color 13 as follow.
 380
 381 ```
 382 led 0 2,2::R:13
 383 ```
 384
 385 LED strips and rings can be combined.
 386
 387 #### Solid Color
 388
 389 The mode allows you to set an LED to be permanently on and set to a specific color.
 390
 391 x,y position and directions are ignored when using this mode.
 392
 393 Other modes will override or combine with the color mode.
 394
 395 For example, to set led 0 to always use color 10 you would issue this command.
 396
 397 ```
 398 led 0 0,0::C:10
 399 ```
 400
 401 ### Colors
 402
 403 Colors can be configured using the cli `color` command.
 404
 405 The `color` command takes either zero or two arguments - an zero-based color number and a sequence which indicates pair of hue, saturation and value (HSV).
 406
 407 See http://en.wikipedia.org/wiki/HSL_and_HSV
 408
 409 If used with zero arguments it prints out the color configuration which can be copied for future reference.
 410
 411 The default color configuration is as follows:
 412
 413 | Index | Color       |
 414 | ----- | ----------- |
 415 |     0 | black       |
 416 |     1 | white       |
 417 |     2 | red         |
 418 |     3 | orange      |
 419 |     4 | yellow      |
 420 |     5 | lime green  |
 421 |     6 | green       |
 422 |     7 | mint green  |
 423 |     8 | cyan        |
 424 |     9 | light blue  |
 425 |    10 | blue        |
 426 |    11 | dark violet |
 427 |    12 | magenta     |
 428 |    13 | deep pink   |
 429 |    14 | black       |
 430 |    15 | black       |
 431
 432 ```
 433 color 0 0,0,0
 434 color 1 0,255,255
 435 color 2 0,0,255
 436 color 3 30,0,255
 437 color 4 60,0,255
 438 color 5 90,0,255
 439 color 6 120,0,255
 440 color 7 150,0,255
 441 color 8 180,0,255
 442 color 9 210,0,255
 443 color 10 240,0,255
 444 color 11 270,0,255
 445 color 12 300,0,255
 446 color 13 330,0,255
 447 color 14 0,0,0
 448 color 15 0,0,0
 449 ```
 450
 451 ### Mode Colors Assignement
 452
 453 Mode Colors can be configured using the cli `mode_color` command.
 454
 455 - No arguments: lists all mode colors
 456 - arguments: mode, function, color
 457
 458 First 7 groups of ModeIndexes are :
 459
 460 | mode | name        |
 461 |------|-------------|
 462 | 0    | orientation |
 463 | 1    | headfree    |
 464 | 2    | horizon     |
 465 | 3    | angle       |
 466 | 4    | mag         |
 467 | 5    | baro        |
 468 | 6    | special     |
 469
 470 Modes 0 to 5 functions:
 471
 472 | function | name  |
 473 |----------|-------|
 474 | 0        | north |
 475 | 1        | east  |
 476 | 2        | south |
 477 | 3        | west  |
 478 | 4        | up    |
 479 | 5        | down  |
 480
 481 Mode 6 use these functions:
 482
 483 | function | name               |
 484 |----------|--------------------|
 485 | 0        | disarmed           |
 486 | 1        | armed              |
 487 | 2        | animation          |
 488 | 3        | background         |
 489 | 4        | blink background   |
 490 | 5        | gps: no satellites |
 491 | 6        | gps: no fix        |
 492 | 7        | gps: 3D fix        |
 493
 494 The ColorIndex is picked from the colors array ("palette").
 495
 496 Examples (using the default colors):
 497
 498 - set armed color to red: ```mode_color 6 1 2```
 499 - set disarmed color to yellow: ```mode_color 6 0 4```
 500 - set Headfree mode 'south' to Cyan: ```mode_color 1 2 8```
 501
 502 ## Positioning
 503
 504 Cut the strip into sections as per diagrams below.  When the strips are cut ensure you reconnect each output to each input with cable where the break is made. e.g. connect 5V out to 5V in, GND to GND and Data Out to Data In.
 505
 506 Orientation is when viewed with the front of the aircraft facing away from you and viewed from above.
 507
 508 ### Example 12 LED config
 509
 510 The default configuration is as follows
 511 ```
 512 led 0 15,15:ES:IA:0
 513 led 1 15,8:E:WF:0
 514 led 2 15,7:E:WF:0
 515 led 3 15,0:NE:IA:0
 516 led 4 8,0:N:F:0
 517 led 5 7,0:N:F:0
 518 led 6 0,0:NW:IA:0
 519 led 7 0,7:W:WF:0
 520 led 8 0,8:W:WF:0
 521 led 9 0,15:SW:IA:0
 522 led 10 7,15:S:WF:0
 523 led 11 8,15:S:WF:0
 524 led 12 7,7:U:WF:0
 525 led 13 8,7:U:WF:0
 526 led 14 7,8:D:WF:0
 527 led 15 8,8:D:WF:0
 528 led 16 8,9::R:3
 529 led 17 9,10::R:3
 530 led 18 10,11::R:3
 531 led 19 10,12::R:3
 532 led 20 9,13::R:3
 533 led 21 8,14::R:3
 534 led 22 7,14::R:3
 535 led 23 6,13::R:3
 536 led 24 5,12::R:3
 537 led 25 5,11::R:3
 538 led 26 6,10::R:3
 539 led 27 7,9::R:3
 540 led 28 0,0:::0
 541 led 29 0,0:::0
 542 led 30 0,0:::0
 543 led 31 0,0:::0
 544 ```
 545
 546 Which translates into the following positions:
 547
 548 ```
 549      6             3
 550       \           /
 551        \   5-4   /
 552         \ FRONT /
 553     7,8 | 12-15 | 1,2
 554         /  BACK \
 555        /  10,11  \
 556       /           \
 557      9             0
 558        RING 16-27
 559 ```
 560
 561 LEDs 0,3,6 and 9 should be placed underneath the quad, facing downwards.
 562 LEDs 1-2, 4-5, 7-8 and 10-11 should be positioned so the face east/north/west/south, respectively.
 563 LEDs 12-13 should be placed facing down, in the middle
 564 LEDs 14-15 should be placed facing up, in the middle
 565 LEDs 16-27 should be placed in a ring and positioned at the rear facing south.
 566
 567 This is the default so that if you don't want to place LEDs top and bottom in the middle just connect the first 12 LEDs.
 568
 569 ### Example 16 LED config
 570
 571 ```
 572 led 0 15,15:SD:IA:0
 573 led 1 8,8:E:FW:0
 574 led 2 8,7:E:FW:0
 575 led 3 15,0:ND:IA:0
 576 led 4 7,7:N:FW:0
 577 led 5 8,7:N:FW:0
 578 led 6 0,0:ND:IA:0
 579 led 7 7,7:W:FW:0
 580 led 8 7,8:W:FW:0
 581 led 9 0,15:SD:IA:0
 582 led 10 7,8:S:FW:0
 583 led 11 8,8:S:FW:0
 584 led 12 7,7:D:FW:0
 585 led 13 8,7:D:FW:0
 586 led 14 7,7:U:FW:0
 587 led 15 8,7:U:FW:0
 588 ```
 589
 590 Which translates into the following positions:
 591
 592 ```
 593      6             3
 594       \           /
 595        \   5-4   /
 596       7 \ FRONT / 2
 597         | 12-15 |
 598       8 /  BACK \ 1
 599        /  10-11  \
 600       /           \
 601      9             0
 602 ```
 603
 604 LEDs 0,3,6 and 9 should be placed underneath the quad, facing downwards.
 605 LEDs 1-2, 4-5, 7-8 and 10-11 should be positioned so the face east/north/west/south, respectively.
 606 LEDs 12-13 should be placed facing down, in the middle
 607 LEDs 14-15 should be placed facing up, in the middle
 608
 609 ### Example 28 LED config
 610
 611 ```
 612 #right rear cluster
 613 led 0 9,9:S:FWT:0
 614 led 1 10,10:S:FWT:0
 615 led 2 11,11:S:IA:0
 616 led 3 11,11:E:IA:0
 617 led 4 10,10:E:AT:0
 618 led 5 9,9:E:AT:0
 619 # right front cluster
 620 led 6 10,5:S:F:0
 621 led 7 11,4:S:F:0
 622 led 8 12,3:S:IA:0
 623 led 9 12,2:N:IA:0
 624 led 10 11,1:N:F:0
 625 led 11 10,0:N:F:0
 626 # center front cluster
 627 led 12 7,0:N:FW:0
 628 led 13 6,0:N:FW:0
 629 led 14 5,0:N:FW:0
 630 led 15 4,0:N:FW:0
 631 # left front cluster
 632 led 16 2,0:N:F:0
 633 led 17 1,1:N:F:0
 634 led 18 0,2:N:IA:0
 635 led 19 0,3:W:IA:0
 636 led 20 1,4:S:F:0
 637 led 21 2,5:S:F:0
 638 # left rear cluster
 639 led 22 2,9:W:AT:0
 640 led 23 1,10:W:AT:0
 641 led 24 0,11:W:IA:0
 642 led 25 0,11:S:IA:0
 643 led 26 1,10:S:FWT:0
 644 led 27 2,9:S:FWT:0
 645 ```
 646
 647 ```
 648        16-18  9-11
 649 19-21 \           / 6-8
 650        \  12-15  /
 651         \ FRONT /
 652         /  BACK \
 653        /         \
 654 22-24 /           \ 3-5
 655        25-27   0-2
 656 ```
 657
 658 All LEDs should face outwards from the chassis in this configuration.
 659
 660 Note:
 661 This configuration is specifically designed for the [Alien Spider AQ50D PRO 250mm frame](http://www.goodluckbuy.com/alien-spider-aq50d-pro-250mm-mini-quadcopter-carbon-fiber-micro-multicopter-frame.html).
 662
 663
 664 ## Troubleshooting
 665
 666 On initial power up the LEDs on the strip will be set to WHITE.  This means you can attach a current meter to verify the current draw if your measurement equipment is fast enough.  Most 5050 LEDs will draw 0.3 Watts a piece.
 667 This also means that you can make sure that each R,G and B LED in each LED module on the strip is also functioning. After a short delay the LEDs will show the unarmed color sequence and or low-battery warning sequence.
 668
 669 Also check that the feature `LED_STRIP` was correctly enabled and that it does not conflict with other features, as above.