summaryrefslogtreecommitdiff
path: root/led/ws281x/README
blob: b933a8e9ad90980bd117821828991026a806ffd9 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
-------------------------------------------------------------------------------
WS2812B LED strip
-------------------------------------------------------------------------------

This is a capture of data output to 4 LED universes of 256 RGB LEDs.
Every universe has a frame size of 768 bytes and the dumps are clocked at
roughly 100 frames per second.

Details:
 - Koen Kooi's evil vendor tree: https://github.com/koenkooi/kernel
 - PRU WS28xx firmware: https://github.com/mranostay/ws28xx-lighting-pru
 - WS2812B datasheet: http://www.adafruit.com/datasheets/WS2812.pdf


WS2812B protocol overview
-------------------------

All values have a +/- tolerance of 150 nanoseconds so the PRU firmware uses
the slightly different timing values below to sync the high/low transitions.

  Logic low  -> high 0.40 uS -> low 0.85 uS (1.25 uS)
  Logic high -> high 0.80 uS -> low 0.45 uS (1.25 uS)
  Latch      -> low 50 uS

Each LED receives and then stores the first 24-bits of GRB ordered data then
passes any more out the Data Output pin to the next LED in the chain.

This functions as a "reverse" shift register and allows the strip length not
to be defined in the protocol.


Logic analyzer setup
--------------------

The logic analyzer used was a Saleae Logic16 (at 5MHz):

  Probe       WS2812B LED strip
  -----------------------------
  1 (black)   Universe #1
  2 (brown)   Universe #2
  3 (red)     Universe #3
  4 (orange)  Universe #4


Data
----

The data contains various RGB values and frames.

The sigrok command line used was:

  sigrok-cli --driver saleae-logic16 --samples 10M --config samplerate=5mhz \
             -p 0=UNI1,1=UNI2,2=UNI3,3=UNI4 -o ws281x_4ch_5mhz.sr