Beginner Guide – WLED auf ESP2622 mit WS2815
Dieser Artikel zeigt die ersten Schritte, um einen Einstieg in das Projekt WLED zu finden. Dazu wird ein ESP8266 und ein LED-Streifen WS2815 mit einzeln adressierbaren LED's verwendet.
Bei WLED handelt es sich genau genommen um Open-Source-Software.
In der Maker-Scene hat sie einen wichtigen Meilenstein bei kabelloser RGB Lichtsteuerung gesetzt. Der Entwickler Aircoookie hat mit seiner Software die RGB Steuerung vom Kabelsalat entwirrt und WLAN ins Spiel gebracht. Mittlerweile finden sich zahlreiche Beispielprojekte in der Maker-Szene.
Die Anweisungen in diesem Artikel sind bewusst auf das Minimale beschränkt, um ein WLED-Setup zum Laufen zu bringen. Um eine runde Sache aus dem Projekt zu machen, werden ganz individuell weitere Schritte notwendig sein.
Checkliste für Materialien
- ESP12e Mode MCU. Allerdings ist auch ein anderer ESP möglich.
- WS2815 LED Modul. Auch hier sind weitere Varianten von WS28xx möglich.
- Breadboard und Steckleitungen zum Verkabeln.
- 12 V Netzteil.
- 5V Spannungswandler L4940V5 oder L7805CV
- 5A Sicherung (optional)
ESP2622 NodeMCU als Plattform
Ein wesentlicher Beitrag zum Erfolg von WLED muss den preiswerten ESP-Chips zugesprochen werden. Die Module sind mit WLAN ausgestattet und lassen sich frei programmieren. Für den Beispielaufbau braucht es keinerlei Programmierkenntnisse, nur ein bisschen Geschicklichkeit im Verkabeln der Hardware.
In diesem Fall wird ein ESP12e ModeMCU verwendet. Die NodeMCU ist ein Board mit ESP8266 und Programmierschnittstelle über Micro-USB.
Im Vergleich zu anderen ESP Varianten, ohne integrierte Programmiermöglichkeiten, entfällt damit auch Arbeit beim Setup zum Flashen der Software.
Die entsprechende Software befindet sich fertig compiliert in einer Binary-Datei mit der Dateinamenserweiterung .bin. Zum Flashen kann das ESP Home Flasher Tool genutzt werden. Für ESP32 wird das hauseigene Flashing-Tool von Espressif empfohlen.
- Falls noch nicht geschehen: ESP-Firmware (CH340 Driver) installieren.
- Die Binary-Datei WLED_x.xx.x_ESP8266.bin herunterladen. (Vorsicht! Binary-Dateien mit der Bezeichnung WLED_x.xx.x-bx_ESP8266.bin sind Beta-Releases, die eventuell Bugs enthalten.)
- NodeMCU per USB anschließen.
- ESP Home Flasher Tool herunterladen und öffnen.
- Die Firmware flashen.
NodeMCU und WS2815 Verbindung
WS2815 müssen mit 12V betrieben werden. Die Leistungsaufnahme muss berücksichtigt werden. Das folgende Bild zeigt die Verbindungen zwischen NodeMCU und WS2815. Da NodeMCU 5V und WS2815 12V benötigen, wird ein Spannungsregler (L4940V5 oder L7805CV) verwendet. Als Sicherheitsmaßnahme wird eine 5A Sicherung genutzt.
Bei WS2815 entspricht der D Pin der Datenleitung. Der B Pin wird auf Masse gelegt.
Achtung: Der Pfeil auf dem LED-Streifen zeigt die Übertragungsrichtung der Daten an. Der D Pin muss von der richtigen Seite angeschossen werden!
WLED Setup
Nachdem die Software auf der NodeMCU installiert und der Schaltkreis aufgebaut ist, kann die individuelle Konfiguration erfolgen.
Der ESP8266 öffnet einen WLAN-Hotspot mit dem Namen WLED-AP<code>. Damit muss man sich über die WLAN-Einstellungen verbinden. Das initiale Passwort ist </code>wled1234
Öffnet man nun den Browser, kann man über die Domäne http://4.3.2.1 auf den ESP zugreifen und ihn steuern.
- Im WiFi setup gibt man nun unter SSID und Passwort seine WLAN-Zugangsdaten bei ein.
- Vor dem Speichern sollte man sich die mDNS address merken (z.B.
http://http://wled-80f399.local
In LED Preferences müssen Konfigurationen vorgenommen werden. Hier wird die Anzahl der LED's im LED-Streifen angegeben. Möglicherweise müssen bei der Color Order Änderungen vorgenommen werden, damit die LED's mit der richtigen Farbe angesteuert werden. Für WS2815 muss RGB gewählt werden.
Nachdem die Konfiguration erfolgt und gespeichert ist, kann der LED-Streifen über die WLED-App (Android, iOS) gesteuert werden.
Der LED-Streifen wird jetzt von home-assistant.io bei den Integrationen erkannt.