WLED installieren: Adressierbare LEDs mit ESP32 ohne Code

WLED installieren ist der schnellste Weg, einen ESP32 ohne eine einzige Codezeile in einen WLAN-gesteuerten LED-Controller zu verwandeln. WLED ist eine kostenlose Open-Source-Firmware für adressierbare LED-Streifen, -Ringe und -Matrizen wie den WS2812B. Sie wird mit wenigen Klicks über den Browser aufgespielt; danach wählst du am Handy oder Computer aus über 100 Effekten, Dutzenden Farbpaletten, Timern und musikgesteuerten Animationen. TV-Hintergrundlicht, Regalbeleuchtung, Treppenlicht oder Weihnachtsdeko laufen alle mit demselben Aufbau.

In dieser Anleitung siehst du Schritt für Schritt, wie du ESP32, LED-Streifen und Netzteil richtig verbindest, WLED mit dem Web-Installer aufspielst, das WLAN einrichtest und LED-Anzahl, Datenpin und Farbreihenfolge einstellst. Danach lernst du Effekte, Paletten, Segmente und Presets kennen, berechnest die Stromversorgung langer Streifen samt Einspeisung, synchronisierst das Licht mit einem I2S-Mikrofon zur Musik und bindest alles in Home Assistant ein. Zum Schluss folgen zwei kurze Programme, die WLED über die JSON-API von einem anderen ESP32 und einem Raspberry Pi Pico W steuern, und Lösungen für die häufigsten Probleme.

Was ist WLED und was kann es?

Normalerweise schreibst du für adressierbare LEDs in der Arduino IDE Code mit Adafruit NeoPixel oder FastLED und programmierst das Board für jede Änderung neu. WLED dreht das komplett um: Das Board wird einmal programmiert, und alle Einstellungen, Effekte und Zeitpläne erledigst du über die eigene Weboberfläche des Boards. Der ESP32 verbindet sich mit dem Heim-WLAN, betreibt einen Webserver, und jedes Gerät im selben Netz erreicht ihn per Browser oder App. Da die Einstellungen im Flash des Boards liegen, machen die Lichter nach einem Stromausfall dort weiter, wo sie aufgehört haben.

• Unterstützte LEDs: WS2812B, WS2811, WS2813, WS2815, SK6812 (auch RGBW), TM1814 und getaktete LEDs wie APA102 und SK9822.
• Effekte und Paletten: Über 100 eingebaute Effekte und mehr als 70 Farbpaletten; jeder Effekt lässt sich über Regler für Tempo und Intensität anpassen.
• Segmente: Teile einen einzelnen Streifen in Abschnitte und gib jedem einen eigenen Effekt und eine eigene Farbe.
• Presets und Playlists: Speichere Lieblingseinstellungen, ruf sie mit einem Tipp ab oder lass sie in einer Liste nacheinander wechseln.
• Timer: Licht, das zu festen Zeiten, bei Sonnenaufgang oder Sonnenuntergang an- und ausgeht, dazu ein Einschlaf-Timer.
• Integration: Spricht über Home Assistant, MQTT, Alexa, E1.31 und Art-Net mit anderen Systemen im Netz.

Was du brauchst

Hinweis zur Kompatibilität: WLED läuft auch auf Boards mit ESP8266 (NodeMCU, Wemos D1 mini); wegen des knapperen Speichers und der geringeren Rechenleistung steuern sie aber weniger LEDs, und die Musiksteuerung gibt es nur beim ESP32. Für neue Projekte empfehlen wir deshalb den ESP32, und die gesamte Anleitung bezieht sich darauf. Der Raspberry Pi Pico kann WLED nicht ausführen; mit einem Pico steuerst du adressierbare LEDs über das neopixel-Modul von MicroPython oder, wie im JSON-API-Beispiel unten, einen ESP32 mit WLED aus der Ferne über einen Pico W.

Verdrahtung: ESP32, LED-Streifen und Netzteil

WLED mit dem Web-Installer aufspielen

Für WLED brauchst du weder die Arduino IDE noch ein anderes Programm. Der offizielle Web-Installer (install.wled.me) verbindet sich über die Web-Serial-Funktion des Browsers direkt mit dem ESP32, erkennt den Chip und schreibt die passende Firmware. Das funktioniert in Chromium-basierten Desktop-Browsern wie Chrome, Edge und Opera; Firefox und Safari unterstützen Web Serial derzeit nicht. Damit das Board am Computer als serieller Port erscheint, muss der CP210x- oder CH340-Treiber installiert sein.

1. Verbinde den ESP32 mit einem datenfähigen USB-Kabel mit dem Computer. Den LED-Streifen musst du jetzt noch nicht anschließen.
2. Öffne den WLED-Web-Installer in Chrome oder Edge. Wähle in der Versionsliste die neueste stabile Version (stable); Betaversionen sind zum Testen gedacht.
3. Klicke auf Install. Wähle im Fenster den Port deines Boards (unter Windows z. B. COM3, unter macOS cu.usbserial... oder cu.wchusbserial...) und klicke auf Connect.
4. Hat der Installer den Chip erkannt, bestätige Install WLED. Wurde das Board vorher mit einem anderen Programm genutzt, verhindert "Erase device", dass sich alte Einstellungen einmischen.
5. Das Schreiben dauert etwa eine Minute. Startet der Upload nicht, halte die BOOT-Taste des ESP32 gedrückt und versuche es erneut.
6. Nach der Installation fragt der Installer nach den WLAN-Daten. Gib Netzwerkname und Passwort ein, klicke auf Connect und öffne danach über den Link Visit Device die WLED-Oberfläche.

Erste WLAN-Einrichtung

Hast du den WLAN-Schritt im Installer übersprungen oder kommt das Board nicht ins Netz, öffnet WLED einen eigenen Access Point. Verbinde dein Handy mit dem Netz WLED-AP; das Standardpasswort lautet wled1234. Auf den meisten Handys öffnet sich die Einstellungsseite von selbst, sonst gibst du im Browser 4.3.2.1 ein. Trage auf der Seite WiFi Setup Name und Passwort deines Heimnetzes ein, speichere und warte, bis das Board neu startet. Der ESP32 unterstützt nur WLAN mit 2,4 GHz; nutzt der Router denselben Namen für 2,4 und 5 GHz, klappt es meist trotzdem, in ein reines 5-GHz-Netz kommt er aber nicht. Die IP-Adresse des Boards findest du danach in der Geräteliste des Routers oder über die automatische Suche der WLED-App. Ändere auf derselben Seite aus Sicherheitsgründen auch das Passwort des Access Points.

LED-Anzahl, Datenpin und Farbreihenfolge

1. Öffne in der WLED-Oberfläche das Menü Config (Zahnrad) und dort LED Preferences.
2. Wähle unter LED outputs den LED-Typ: "WS281x" für WS2812B, "SK6812/WS2814 RGBW" für RGBW-Streifen.
3. Stelle Color Order beim WS2812B auf GRB; stimmen die Farben nicht, probierst du hier die richtige Reihenfolge aus.
4. Trage bei Length die Anzahl der LEDs ein (z. B. 60 für 1 m Streifen mit 60 LEDs/m).
5. Trage bei GPIO den Pin der Datenleitung ein (in dieser Anleitung 16). GPIO 6–11 sind für den Flash reserviert, 34–39 sind reine Eingänge; nutze sie nicht.
6. Trage bei Maximum Current (automatischer Helligkeitsbegrenzer) etwa 80 % des Netzteilstroms in mA ein; bei 5 V 4 A also 3200.
7. Klicke unten auf Save. Wähle auf dem Hauptbildschirm eine Farbe; der ganze Streifen sollte in dieser Farbe leuchten.

Effekte, Paletten, Segmente und Presets

Der Hauptbildschirm von WLED hat drei Teile: oben Farbwähler und Helligkeit, in der Mitte die Effektliste, daneben die Palettenliste. Wählst du einen Effekt (z. B. Rainbow, Fire 2012, Twinkle), änderst du mit den Reglern Speed und Intensity darunter Tempo und Dichte. Die Palette bestimmt, welche Farbfamilie der Effekt nutzt: Derselbe Effekt "Colorwaves" wirkt mit der Palette "Ocean" wie blaue Wellen, mit "Lava" wie rote Flammen. Soll ein Effekt deine gewählten Farben verwenden, nimm Paletten wie "Default" oder "Color 1".

• Segmente: Teile den Streifen im Bereich Segments auf; zum Beispiel atmen LEDs 0–29 in Blau, während über 30–59 ein Regenbogen läuft. Jedes Segment hat eigenen Effekt, eigene Palette, Helligkeit und Richtung.
• Presets: Benenne und speichere im Bereich Presets eine Einstellung, die dir gefällt. Ein Preset merkt sich Effekt, Farbe, Segmente und Helligkeit auf einmal und holt sie mit einem Tipp zurück.
• Playlists: Erstelle eine Liste, die mehrere Presets nacheinander für festgelegte Zeiten abspielt; ideal für Schaufenster oder Partylicht.
• Timer: Stelle unter Config > Time & Macros die Zeitzone ein und starte Presets zu festen Zeiten, bei Sonnenaufgang oder Sonnenuntergang.
• Nachtlicht: Die Mond-Taste dimmt das Licht über eine wählbare Zeit langsam herunter und schaltet es ab; praktisch fürs Kinderzimmer.
• Synchronisation: Mehrere WLED-Geräte im selben Netz koppeln sich per UDP und spielen denselben Effekt gleichzeitig.

Die Handy-App

Die Oberfläche läuft in jedem Browser, im Alltag ist aber die kostenlose WLED-App für iOS und Android bequemer. Sie findet WLED-Geräte im selben Netz automatisch, listet sie auf und öffnet beim Antippen die Oberfläche des Boards. Hast du mehrere Geräte (z. B. Wohnzimmer, Küche und Treppe), steuerst du alle von einem Bildschirm aus. Erscheint ein Gerät nicht, prüfe, ob Handy und ESP32 im selben Netz sind, oder füge die IP-Adresse von Hand hinzu. Da die App nur eine Oberfläche ist, muss das Handy für die Lichter nicht eingeschaltet bleiben; Timer und Presets laufen im ESP32 weiter.

Strombedarf und Einspeisung

Eine WS2812B-LED enthält drei winzige LEDs in Rot, Grün und Blau, die bei voller Helligkeit je etwa 20 mA ziehen. Ein einzelnes Pixel braucht bei vollem Weiß also rund 60 mA. Das ist der ungünstigste Fall; bei farbigen Effekten und mittlerer Helligkeit liegt der tatsächliche Verbrauch oft bei einem Drittel davon. Die WLED-Einstellung Maximum Current (automatischer Helligkeitsbegrenzer) berechnet für jedes Bild den Strom und senkt die Helligkeit selbstständig, wenn die Grenze überschritten würde. So betreibst du einen Streifen mit 300 LEDs sicher an einem 5-V-10-A-Netzteil; nur volles Weiß wird etwas dunkler. Der Standardwert ist niedrig, damit das Board am USB sicher bleibt, also passe ihn beim Wechsel auf ein externes Netzteil unbedingt an.

• Spannungsabfall: Die Kupferbahnen von 5-V-Streifen sind dünn; mit steigendem Strom sinkt die Spannung zum Streifenende hin, und Weiß wirkt gelblich oder rosa. Das beginnt meist nach 1–2 Metern (60–120 LEDs).
• Einspeisung: Führe vom Netzteil zu jedem 1–2-Meter-Abschnitt eigene 5-V- und GND-Leitungen und löte sie auf die Kupferpads des Streifens. Bei langen Streifen hilft es auch, beide Enden zu versorgen. Die Datenleitung kommt nur am Anfang hinein, Einspeiseleitungen führen nur 5 V und GND.
• Leitungsquerschnitt: Für einige Ampere mindestens 0,75–1 mm² (etwa 18 AWG), ab 10 A 1,5 mm²; die dünnen Anschlusslitzen des Streifens taugen nur für kurze Längen.
• Sicherung: Setze zwischen Netzteil und Streifen in jeden Versorgungsstrang eine Sicherung, passend zur Belastbarkeit der Leitung; sie verhindert bei Kurzschluss, dass das Kabel verschmort.
• 12-V-Variante: Bei sehr langen Installationen ziehen 12-V-Streifen wie der WS2815 für dieselbe Leistung nur ein Drittel des Stroms und leiden viel weniger unter Spannungsabfall.
• Rechner: Baust du etwas Mobiles mit Akku oder Powerbank, ermittelst du die Laufzeit mit dem Akkulaufzeit-Rechner.

Musikgesteuertes Licht mit Mikrofon

In den WLED-Versionen für den ESP32 ist die Erweiterung AudioReactive bereits enthalten; schließt du ein Mikrofon an und änderst ein paar Einstellungen, bewegen sich die Effekte mit Rhythmus und Frequenzen der Musik. Die besten Ergebnisse liefert das digitale I2S-Mikrofon INMP441: Da es das Signal digital überträgt, gibt es keine Rausch- und Verstärkungsprobleme wie bei analogen Mikrofonen. Analoge Module wie MAX9814 oder MAX4466 funktionieren an einem ADC1-Pin (z. B. GPIO 36) ebenfalls, brauchen aber mehr Feinabstimmung. Schallsensoren wie der KY-038 melden nur, ob Geräusch da ist, und eignen sich dafür nicht.

Aktiviere danach auf der Seite Config > Usermods den Abschnitt AudioReactive, wähle als Mikrofontyp "Generic I2S" und trage die Pins SD, WS und SCK wie in der Tabelle ein. Nach Speichern und Neustart sind die tonabhängigen Effekte in der Effektliste hervorgehoben; GEQ, Gravimeter und Waterfall eignen sich gut zum Einstieg. Zuckt das Licht ohne Ton, erhöhe Squelch (Rauschschwelle); reagiert es zu schwach auf Musik, erhöhe Gain. Am ausgewogensten wird es, wenn das Mikrofon den Raum hört und nicht direkt vor dem Lautsprecher sitzt.

Einbindung in Home Assistant

Home Assistant bringt eine eingebaute WLED-Integration mit und findet WLED-Geräte im selben Netz meist von selbst. Erscheint die Meldung "Neues Gerät gefunden", musst du nur bestätigen; sonst wählst du unter Einstellungen > Geräte & Dienste > Integration hinzufügen WLED aus und gibst die IP-Adresse ein. Die Integration legt den Streifen und jedes Segment als eigene Lampe an, Presets, Playlists und Paletten als Auswahlfelder sowie Tempo und Intensität als Schieberegler. So baust du mit wenigen Klicks Automationen wie "bei Sonnenuntergang Wohnzimmerstreifen auf Warmweiß" oder "Flur einschalten, wenn die Tür aufgeht". Bevorzugst du MQTT, verbindet sich WLED über die Seite Sync Interfaces auch mit einem MQTT-Broker; wie MQTT mit Home Assistant funktioniert, steht im Artikel ESP32, MQTT und Home Assistant.

WLED per Code steuern: die JSON-API

WLED läuft ohne Code, aber soll ein anderes Gerät es steuern, genügt eine einfache HTTP-Anfrage. Eine JSON-Nachricht an die Adresse /json/state des Geräts ändert den Zustand: {"on":"t"} schaltet um, {"bri":128} setzt halbe Helligkeit, {"ps":2} startet Preset Nummer 2. Hängst du "v":true an, antwortet WLED mit dem aktuellen Zustand. Das erste Programm unten wechselt mit einem Taster an einem separaten ESP32 zwischen den ersten drei Presets; das zweite erledigt dasselbe mit einem Raspberry Pi Pico W und MicroPython. In beiden trägst du deine Netzwerkdaten und die IP-Adresse des WLED-Geräts ein.

1// İkinci bir ESP32'den WLED preset değiştirme (JSON API) / Switch WLED presets from a second ESP32 (JSON API)
2// Buton: GPIO 4 -> GND (dahili pull-up) / button: GPIO 4 -> GND (internal pull-up)
3#include <WiFi.h>
4#include <HTTPClient.h>
5
6const char* WIFI_SSID = "AgAdi";                           // ağ adı / network name
7const char* WIFI_PASS = "Sifre";                           // ağ şifresi / network password
8const char* WLED_URL = "http://192.168.1.50/json/state";   // WLED cihazının IP'si / IP of the WLED device
9const int BUTTON_PIN = 4;
10
11int preset = 1;
12bool lastState = HIGH;
13
14int sendJson(const String& body) {
15  HTTPClient http;
16  http.begin(WLED_URL);
17  http.addHeader("Content-Type", "application/json");
18  int code = http.POST(body);                              // 200 = başarılı / success
19  http.end();
20  return code;
21}
22
23void setup() {
24  Serial.begin(115200);
25  pinMode(BUTTON_PIN, INPUT_PULLUP);
26  WiFi.begin(WIFI_SSID, WIFI_PASS);
27  while (WiFi.status() != WL_CONNECTED) {
28    delay(300);
29    Serial.print('.');
30  }
31  Serial.print("\nIP: ");
32  Serial.println(WiFi.localIP());
33}
34
35void loop() {
36  bool state = digitalRead(BUTTON_PIN);
37  if (lastState == HIGH && state == LOW) {                 // butona basıldı / button pressed
38    String body = "{\"on\":true,\"ps\":" + String(preset) + "}";
39    int code = sendJson(body);
40    Serial.printf("Preset %d -> HTTP %d\n", preset, code);
41    preset = preset % 3 + 1;                               // 1 -> 2 -> 3 -> 1
42    delay(50);                                             // basit debounce / simple debounce
43  }
44  lastState = state;
45}

1# Raspberry Pi Pico W: butonla WLED aç/kapat (JSON API) / toggle WLED with a button (JSON API)
2# Buton: GP14 -> GND (dahili pull-up) / button: GP14 -> GND (internal pull-up)
3import network
4import time
5import urequests
6from machine import Pin
7
8SSID = "AgAdi"                                  # ağ adı / network name
9PASSWORD = "Sifre"                              # ağ şifresi / network password
10WLED_URL = "http://192.168.1.50/json/state"     # WLED cihazının IP'si / IP of the WLED device
11
12button = Pin(14, Pin.IN, Pin.PULL_UP)
13
14wlan = network.WLAN(network.STA_IF)
15wlan.active(True)
16wlan.connect(SSID, PASSWORD)
17while not wlan.isconnected():
18    time.sleep(0.3)
19print("IP:", wlan.ifconfig()[0])
20
21last = 1
22while True:
23    now = button.value()
24    if last == 1 and now == 0:                  # butona basıldı / button pressed
25        r = urequests.post(WLED_URL, json={"on": "t", "v": True})
26        state = r.json()                        # güncel durum / current state
27        r.close()
28        print("Acik / On:", state["on"], " Parlaklik / Brightness:", state["bri"])
29        time.sleep_ms(50)                       # basit debounce / simple debounce
30    last = now
31    time.sleep_ms(10)

In beiden Programmen wird der aktuelle mit dem vorherigen Zustand verglichen, damit ein Tastendruck nur eine Anfrage auslöst; die 50 ms Wartezeit filtern das Prellen des Tasters. In einem echten Projekt solltest du dem WLED-Gerät im Router eine feste IP geben oder den mDNS-Namen aus der WLED-Oberfläche nutzen, denn nach einem Stromausfall und Neustart des Routers kann sich die IP ändern. Nach demselben Prinzip schaltest du das Treppenlicht ein, wenn ein Bewegungsmelder auslöst, wechselst zum Nacht-Preset, wenn ein LDR Dunkelheit meldet, oder änderst die Farbe des Streifens je nach Temperatur.

Häufige Probleme und Lösungen

WLED ist eine der schönsten Arten, mit adressierbaren LEDs zu arbeiten: Die Einrichtung dauert wenige Minuten, du bekommst professionell wirkende Effekte ohne Code und kannst es bei Bedarf über die JSON-API in eigene Projekte einbinden. Willst du lernen, wie LEDs per Code angesteuert werden, baust du in der BlueGrays-App das Projekt "ESP32-WS2812B-NeoPixel-Streifensteuerung" sowie Lauflicht, Knight Rider und Polizeilicht mit WS2812B Schritt für Schritt mit Schaltplan und fertigem Code nach.