WSAL12725 – RGB LED HAT

Dokumentationshinweis: Diese technische Dokumentation wurde aus einer archivierten Lieferantenquelle neu formuliert. Technische Angaben und Befehle müssen vor der Verwendung mit der Produktversion und den Herstellerunterlagen abgeglichen werden.

Zusammenfassung

Der RGB LED HAT ist eine Erweiterung für den Raspberry Pi mit WS2812B-Steuerchip, der über ein einzelnes Datenkabel gesteuert wird.

Zugeordnete Produkte bei JW Tech

• WSAL12725 – True Color RGB LED HAT für Raspberry Pi, farbenfrohe Anzeige

Technische Übersicht

• Anschluss: Auf dem Raspberry Pi direkt in die GPIO-Leiste stecken; auf anderen Geräten werden Pin-Header auf die Pads 5V, GND, DIN und DOUT gelötet.
• Signaldefinitionen: 5V = Versorgungsspannung, GND = Masse, DIN = Steuersignal-Eingang, DOUT = Steuersignal-Ausgang.
• WS2812B vereint Steuerkreis und RGB-Chip in einem 5050-Gehäuse mit digitalem Eingang, Datenlatch und Signalformungs-Stufen.
• Übertragungsprotokoll: Einzelne NZR-Kommunikation; nach Reset empfängt DIN die 24-Bit-Farbdaten des ersten Pixels, weitere Daten werden intern geformt und über DO an das nächste Kaskaden-Pixel weitergeleitet.
• Zeitparameter: TH+TL = 1,25 µs ±600 ns; T0H ≈ 0,4 µs, T1H ≈ 0,8 µs, T0L ≈ 0,85 µs, T1L ≈ 0,45 µs; Frame-Zeit (RES) ≥ 50 µs.
• Farbformat: Standardmäßig RGB888 (je Kanal 8 Bit, insgesamt 24 Bit); beim WS2812B muss die Reihenfolge von RGB auf GRB umgewandelt werden, da der Chip in dieser Reihenfolge sendet.
• Installation der Bibliothek: sudo apt-get install python3-pip -y und sudo pip3 install rpi_ws281x -y.
• Beispielaufruf: Demo-Dateien herunterladen, entpacken, Berechtigungen setzen und mit sudo python3 ws2812.py starten; bei Erfolg blinkt die RGB-LED.
• Websteuerung: Mit Bottle unter /web/ via main.py; Zugriff über Browser auf Port 8000; Modi „static“, „breath“ und „flash“ verfügbar.
• Fehlerfall: Bei „Hardware revision is not supported“ kann die Bibliothek aus dem Quellcode neu kompiliert und installiert werden.

Befehle und Beispiele – vor Ausführung prüfen: 

sudo apt-get install python3-pip -y
sudo pip3 install rpi_ws281x -y
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
hdmi_force_hotplug=1
hdmi_force_edid_audio=1
sudo apt-get install python3-bottle
cd RGB_LED_HAT/web/
sudo python3 main.py
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

Hinweise und Versionsgrenzen

• Die DMA-gesteuerte RGB-LED kann den Videoausgabe-DMA-Kanal belegen; das Einfügen der hdmi_-Zeilen in /boot/config.txt kann den Kopfhörerausgang unbrauchbar machen.
• Bei Verwendung des RGB LED HAT (B) muss in main.py LED_COUNT auf 64 geändert werden.
• Falls nach dem Update weiterhin „Hardware revision is not supported“ erscheint, siehe GitHub-Issue #483.
• Die exakte Kompatibilität mit bestimmten Raspberry-Pi-Hardwarerevisionen ist nicht angegeben und sollte vorab geprüft werden.
• Alle Schritte, die Änderungen an Systemdateien erfordern, sollten von einer Person mit Root-Rechten ausgeführt werden.
• Es werden keine Preise, Lagerbestände, Zertifizierungen oder Garantieinformationen bereitgestellt.

Quelle und Revisionsnachweis

• RGB LED HAT - Waveshare Wiki
• Quellrevision: 79628
• Erfasst: 2026-08-30T03:31:12+00:00
• SHA-256: 91d3c9012494413329a9a2b98fd774c88cb10bcd38a0bc423b1084e3ffa9ed71