These LED 10-packs are an easy way to add colorful and complex lighting effects to a project. Each RGB LED contains an integrated WS2811 driver that allows it to be controlled with a high-speed one-wire interface (see the bottom of this page for sample code, including an Arduino library for controlling these LEDs). Multiple LEDs can be connected together to form a chain of RGB LEDs, and the entire chain can be controlled from a single microcontroller pin. These are very similar to the LEDs in Pololu's addressable RGB LED strips, but with these discrete LEDs you have far more flexibility in how they are arranged. The picture on the right shows a chain of 10 LEDs in a breadboard controlled by an A-Star 32U4 Micro.
Features and specifications
- One-wire digital control interface
- Can form a chain of individually-addressable RGB LEDs
- 24-bit color control (8-bit PWM per channel); 16.8 million colors per pixel
- 5 V operating voltage
- Draws approximately 50 mA at 5 V with red, green, and blue at full brightness
- Color ordering: red, green, blue
- Example code available for Arduino, AVR, and mbed
Using the LED
The LED has 4 pins, as shown in the diagram below:
The pins can be identified by the length of the leads or by looking for the flat side of the LED.
Connecting the LEDs
The DIN pin is the input signal pin. The DIN pin of the first LED in the chain should be connected to an I/O line of a microcontroller.
The 5V pin supplies power to the LED, and should be connected to a suitable 5 V power supply. The power supply should be capable of supplying enough current for all the LEDs it is powering. Each LED draws approximately 50 mA with all three channels at full brightness.
The GND pin should be connected to the ground pin of the microcontroller that is controlling the LEDs and also the negative terminal of the power supply.
The DOUT pin is optional and allows you to chain multiple LEDs together. It can be connected directly to the DIN pin of the next LED in the chain.
Pololu recommend taking several precautions to protect these LEDs from damage:
- Never supply more than 5 V to the LED.
- Connect a capacitor of at least 10 μF between the ground and power lines.
- Avoid making or changing connections while the circuit is powered.
- Minimize the length of the wires connecting your microcontroller to the LED.
- Follow generally good engineering practices, such as taking precautions against electrostatic discharge (ESD).
- Consider adding a 100 Ω to 1000 Ω resistor between your microcontroller’s data output and the LED to reduce the noise on that line and to avoid accidentally powering the LED through its data input.
Warning: These LEDs can explode if they are pushed beyond their limits. For example, Pololu were able to make an 8 mm LED explode by powering at 6 V and setting it to full brightness for about a minute (though Pololu could not subsequently replicate that result). Pololu strongly recommend you avoid powering these LEDs at voltages over 5 V.
After power is applied to these LEDs, they will emit bright blue light until the first color command is received.
These LEDs can be chained with each other and also with other LED products that have a similar protocol. In particular, they can be chained with any of our WS281x-Based Addressable RGB LEDs. Even though these LEDs use a different color ordering than the WS2812B (RGB instead of GRB), they can still be chained to WS2812B-based products.
These LEDs are controlled by a simple, high-speed one-wire protocol on the input signal line. The protocol is documented below.
The default, idle state of the signal line is low. To update the LED colors, you need to transmit a series of high pulses on the signal line. Each high pulse encodes one bit: a short pulse (0.35 μs) represents a zero, while a long pulse (0.9 μs) represents a one. The time between consecutive rising edges should be 1.25μs. After the bits are sent, the signal line should be held low for 50 μs to send a reset command, which makes the new color data take effect.
|WS281x RGB data timing diagram.|
The color of each LED is encoded as three LED brightness values, which must be sent in RGB (red-green-blue) order. Each brightness value is encoded as a series of 8 bits, with the most significant bit being transmitted first, so each LED color takes 24 bits. The first color transmitted applies to the LED that is closest to the control source, while the second color transmitted applies to the next LED in the chain, and so on.
|24 bits in RGB order represent the color of one LED.|
To update all the LEDs in the chain, you should send all the colors at once with no pauses. If you send fewer colors than the number of LEDs in the chain, then some LEDs near the end will not be updated. For example, to update 10 LEDs wired in a chain, you would send 240 bits encoded as high pulses and then hold the signal line low for 50 μs.
The high-speed protocol of the driver allows for fast updates; Pololu's library for the Arduino below takes about 1.1 ms to update 30 LEDs. However, constant updates are not necessary; the LED can hold its state indefinitely as long as power remains connected.
Documentation and Resources:
We deliver Australia-wide with these options:
- $3 for Small Items (4-6 days, not tracked, only available on selected small items)
- $6.95 for Standard Post (2-4 days, tracked)
- $8.95 for Express Post (1-2 days, tracked)
- Pickup - Free! Only available to customers who live in the Newcastle region (only after we email you to notify your order is ready)
International Orders - the following rates are for New Zealand and will vary for other countries:
- $11.49 for Pack and Track (3+ days, tracked)
- $16.50 for Express International (2-5 days, tracked)
If you order lots of gear, the postage amount might increment based on the weight of your order.
Our physical address:
Unit 18, 132 Garden Grove Parade
Please checkout our customer service page if you have other frequently asked questions such as "do we do purchase orders" (yes!) or "are prices GST inclusive" (yes they are!). We're here to help - get in touch with us to talk shop.