RGB LED HAT
| ||
Introduction
True color RGB LED HAT for Raspberry Pi, colorful display
| More |
Interfaces
- For Raspberry Pi, you only need to insert the product into the corresponding interface on the Pi;
- For other devices, you'd better solder the pin headers to the pads of 5V, GND, DIN, and DOUT for wiring.
| Symbols | Pin descriptions |
|---|---|
| 5V | 5V power supply |
| GND | Ground |
| DIN | Control signal input |
| DOUT | Control signal output |
Description
WS2812B is an intelligent LED controller in which the control circuit and the RGB chip are integrated into a package of 5050 components. It internally includes an intelligent digital port, a data latch, and a signal-reshaping amplification drive circuit. To ensure the color brightness consistent with the pixel light, it also contains a precision internal oscillator and a 12V voltage programmable constant current control part.
Its data transfer protocol uses a single NZR communication mode. After the pixel is powered on and reset, the DIN port receives the data from the controller. The first 24-bit data is collected by the first pixel and then sent to the internal data latch. The other data are reshaped by the internal signal reshaping amplification circuit and sent to the next cascade pixel through the DO port. After the transmission for all pixels, the signal may be reduced to 24 bits. The pixel adopts auto-reshaping transmit technology, which allows the pixel cascade number to be up to the speed of the signal transmission but not bound by the signal transmission restriction. For more information about auto reshaping transmits technology, please refer to the section on data transfer protocol.
Sequence chart
- Data transfer time( TH+TL=1.25µs±600ns)
| T0H | 0 code, high voltage time | 0.4µs | ±150ns |
| T1H | 1 code, high voltage time | 0.8µs | ±150ns |
| T0L | 0 code, low voltage time | 0.85µs | ±150ns |
| T1L | 1 code, low voltage time | 0.45 µs | ±150ns |
| RES | The unit of frame, low voltage time | Above 50µs |
Data transmission method
Note: The data of D1 is sent by MCU, and D2, D3, and D4 are transmitted through pixel internal reshaping amplification.
Color Formats
The color formats are divided into many kinds, the common ones are RGB888, RGB565, etc.; the
RGB888 means: R:Red(Red), G:Green(Green), B:Blue(Blue). It indicates that it accounts for 8 bits of data. Therefore transmitting complete color data takes 24 bits.
For WS2812B, he uses this format, but the color data he sends is G-R-B, so we need to convert our RGB to GRB when we send it again.
| G7 | G6 | G5 | G4 | G3 | G2 | G1 | G0 |
| R7 | R6 | R5 | R4 | R3 | R2 | R1 | R0 |
| B7 | B6 | B5 | B4 | B3 | B2 | B1 | B0 |
Note: High first, send data in the order of GRB.
How to use
Libraries installation
Install the libraries with the following commands:
sudo apt-get install python3-pip -y sudo pip3 install rpi_ws281x -y
For the latest libraries, you can visit the website: https://github.com/jgarff/rpi_ws281x
Download the examples and run them for a try
wget https://files.waveshare.com/upload/b/b2/RGB_LED_HAT.zip unzip RGB_LED_HAT.zip sudo chmod 777 -R RGB_LED_HAT cd RGB_LED_HAT sudo python3 ws2812.py
- If the library is installed successfully, you can see the RGB LED flickering.
- If the LED displays the wrong color, please add the lines below into the file /boot/config.txt, and restart the Pi to take the effect.
- RGB LED adopts DMA control, which may occupy the video output DMA channel on the Raspberry Pi. Therefore, adding these lines may make the earphone connector unusable.
hdmi_force_hotplug=1 hdmi_force_edid_audio=1
Web control with Bottle
Make sure that the basic use is possible, then execute the following command:
sudo apt-get install python3-bottle cd RGB_LED_HAT/web/ sudo python3 main.py
If you are using RGB LED HAT (B), you need to modify main.py to change the LED_COUNT to 64.
As shown above, enter the Raspberry Pi IP address and port number 8000 in the address bar of your mobile browser, and the RGB LED will display different colors by clicking different positions of the color palette. "static", "breath" and "flash" correspond to three display modes respectively.
Take RGB LED HAT as an example, and the actual demonstration effect:
Problem
1: If there is an error RuntimeError: "ws2811_init failed with code -3 (Hardware revision is not supported)" <div class="tabbertab" title="resources" id="myresources"
A: Uninstall rpi_ws281x, download the source code manually, and compile and install.
sudo pip uninstall rpi_ws281x git clone --recurse-submodules https://github.com/rpi-ws281x/rpi-ws281x-python cd rpi-ws281x-python/library/， sudo python setup.py install If it is python3, change pip to pip3 and python to python3. If you still get this error after updating, you can refer https://github.com/jgarff/rpi_ws281x/issues/483
Resources
Documentation
Software
Others
Support
Technical Support
If you need technical support or have any feedback/review, please click the Submit Now button to submit a ticket, Our support team will check and reply to you within 1 to 2 working days. Please be patient as we make every effort to help you to resolve the issue.
Working Time: 9 AM - 6 PM GMT+8 (Monday to Friday)