Tips and tricks for driving WS2811 LED strips - Part 1: Taming the wily WS2811
Thanks to their versatility, commodity-level pricing and the eye-popping visual effects they create, programmable LED strips have become a staple ingredient for both Maker-style projects and more conventional LED lighting applications. But as I quickly discovered when using them as a "Mood LED" for my Smart Hat project3, the serial protocol bus used to address and control the LEDs can be somewhat complicated and tricky to use. I've summarized some of the key design issues and located a few resources to help shorten your climb up the learning curve when you need to include LED strips in one of your projects.
Fig.1: The NeoPixel LED Strip in its native habitat. Courtesy of Adafruit Labs
There are several types of LED strips but this article will focus on driving LED arrays which use WS28114 and WS28124 driver chips. This is in part because products like Adafruit's NeoPixel strips which use them tend to be less expensive than similar products which use LPD8806 drivers. The cost was only one of the reasons I used Adafruit's NeoPixel strips (they are based on the '2811) for my Smart Hat project. I also like NeoPixels because they have consistently high quality and come in a wide variety of pixel densities and offer several form factors besides the traditional strip such as rings, matrixes, and several different types of individual pixels.
Fig.2: NeoPixel variants. Courtesy of Adafruit Labs.
Fig.3: WS2811 LED controllers pass instructions from the host MCU from pixel to pixel using a daisy-chain serial bus. Courtesy of World Semiconductor.
To give you a sense of what's involved, here's a quick overview of the sequence your MCU has to go through when it talks to a '2811-based LED strip:
After resetting the LED chain by holding the input low for 50usec, the MCU or whatever's controlling the string begins sending a stream of 24-bit color codes (8 bits each for the R, G & B LEDs) down the line. The first set of 24-bit RGB values is latched and displayed by the first LED pixel which allows the remainder of the bit stream to pass down the chain. The second LED pixel grabs RGB sequence #2, displays it, and so on until the end of the chain is reached (Fig.4).
To complicate matters further, the receive clock the LED pixels use to decide when to latch the data is derived from the serial data stream. To make generating the clock easier, the data line must toggle during each bit period (sort of like an NRZ code) so the only difference between a "1" and a "0" is how long the data line spends in each state. Don't panic if you're not familiar with pulse width-modulated (PWM) bit streams, Figure 5 provides a visual explanation of how it works.. (Note: If you're still shaky on how , there's a post on the "Do it Yourself Christmas" forum2 which provides a more detailed explanation).
Courtesy of World Semiconductor
Even if you are still struggling with some aspect of PWM-based data streams, it's easy to see that generating instructions for a string of WS2811 LED drivers requires some very specific and complicated timing that can make the driver code a tad tricky to write from scratch. Fortunately, much of the hard work has already been done and there are libraries of LED strip drivers and applications available for Arduino, Raspberry Pi, LaunchPad and other popular platforms. There are also assembly language driver routines for WS2811-style products available for a number of MCUs, including Atmel's popular 8-bit machines, TI's TMS430 series, and Microchip's PIC16F15xx devices.
We'll take a closer look at implementing LED strips on some of these platforms in subsequent installments, as well as a few of the more unique applications people have created using LED strip technologies. But if you are too excited to wait for me to post my next article, you can get a great head start by dropping over to the tutorials section of the AdaFruit site and going through their "NeoPixel Uberguide"5. In addition to some helpful info on programming the LED strips, Adafruits tutorial provides a lot of practical introductory material on the electrical and mechanical aspects of using LED strips I won't be able to include in this series.
- "WS2811 Signal line 256 Gray level 3 channal constant current LED drive IC" data sheet and application notes from World Semiconductor (Note: the title is spelled as it appears on the data sheet).
- "WS2811 pixel compatibility" a thread on Do it Yourself Christmas forum
- "Making the Smart Hat - Part 1" Lee H. Goldberg, EDN, October 11, 2015.
- "WS2811 & WS2813 - Single-wire three-channel constant current LED driver IC with PWM" a data sheet from World Semiconductor
- NeoPixel Uberguide – Adafruit