Skip to content

Commit 89fef60

Browse files
added a wiring plan of the WS2813 strip because it is different to the other WS281X strips. This strip has an additonal backup line which needs to be connected to ground.
1 parent f04628f commit 89fef60

File tree

3 files changed

+17
-1
lines changed

3 files changed

+17
-1
lines changed

README.md

+17-1
Original file line numberDiff line numberDiff line change
@@ -3,6 +3,8 @@ The aim of this project is to provide a script that controls an WS2801 or WS281X
33

44
The strip can be controlled either via hardware or software spi. The preferred mode is hardware spi because the timing is very sensitive.
55

6+
**If you want to use an WS281X strip like i.e. WS2812B you can not use the build in sound output of the Raspberry Pi because both machnism use PWM. The installation guide will show you how to disable the kernel module of the on-board sound card!**
7+
68
## Wiring ##
79
The strip uses 5V spi lanes but the Raspberry uses 3.3V. We need to use an level converter to get rid of this problem. Connecting the strip directly to the Pi may cause harm to it.
810

@@ -14,7 +16,13 @@ This example uses the hardware spi pins to connect the led strip.
1416

1517
![alt text](https://github.com/Tom-Hirschberger/PythonLedControl/raw/master/ledcontrol-WS2801.png "Wiring WS2801")
1618

17-
### Wiring WS281X ###
19+
20+
### Wiring WS2813 ###
21+
This example uses the GPIO21. 10, 12 and 18 are supported, also.
22+
23+
![alt text](https://github.com/Tom-Hirschberger/PythonLedControl/raw/master/ledcontrol-WS2813.png "Wiring WS281X")
24+
25+
### Wiring WS281X (except WS2813)###
1826
This example uses the GPIO21. 10, 12 and 18 are supported, also.
1927

2028
![alt text](https://github.com/Tom-Hirschberger/PythonLedControl/raw/master/ledcontrol-WS281X.png "Wiring WS281X")
@@ -54,6 +62,14 @@ Make sure the root user is in the gpio group:
5462
sudo usermod -a -G gpio root
5563
```
5664

65+
Make sure to disable the on-board sound card because both the strip and the sound card need to use PWM:
66+
```
67+
sudo sed -i "s/^dtparam=audio=on/#dtparam=audio=on/g" /boot/config.txt
68+
sudo sed -i "s/^snd_bcm2835\s*$/#snd_bcm2835/g" /etc/modules
69+
echo 'blacklist snd_bcm2835' | sudo tee /etc/modprobe.d/blacklist-snd_bcm2835.conf
70+
sudo chmod u=rw,g=r,o=r /etc/modprobe.d/blacklist-snd_bcm2835.conf
71+
```
72+
5773
## Configuration ##
5874
Open the file /home/pi/ledcontrol/ledcontrol.env in your favorit editor. In example:
5975

ledcontrol-WS2813.fzz

40.8 KB
Binary file not shown.

ledcontrol-WS2813.png

222 KB
Loading

0 commit comments

Comments
 (0)