Was der Usermod kann
WLED ist eine freie Firmware für ESP-Mikrocontroller, die adressierbare LED-Streifen steuert. Der Usermod „Animated Staircase“ macht daraus laut README ein Treppenlauflicht:
- Je ein Sensor oben und unten, wahlweise Bewegungsmelder (PIR) oder Ultraschall (HC-SR04).
- Die Stufen gehen in deiner Gehrichtung an und hinter dir in Richtung der letzten Bewegung wieder aus.
- Er schaltet bei jeder Erkennung ein, auch während eine Animation noch läuft, und kommt mit mehreren Personen auf der Treppe zurecht.
- Solange ein Sensor noch Bewegung meldet, bleibt das Licht an; erst danach läuft die Leuchtdauer ab (so steht es im Quellcode).
- Steuern lässt er sich auch über die JSON-Schnittstelle von WLED und per MQTT.
Gegenüber einer fertigen Lauflicht-Steuerung bekommst du Farben und Effekte von WLED, dafür ist der Aufwand höher. Fertige Systeme ohne Löten zeigt die Seite Lauflicht für die Treppe, alle Smart-Home-Wege im Vergleich die Übersicht Smart Home an der Treppe.
Das brauchst du
- ESP32, als Entwicklungsboard oder fertiger WLED-Controller. Er schafft laut WLED-Doku 32 Segmente, also 32 Stufen.
- Adressierbarer LED-Streifen für jede Stufe. WLED unterstützt laut Doku unter anderem WS2812B mit 5 Volt, WS2815 mit 12 Volt und WS2814 mit 12 oder 24 Volt. In diesem Beispiel: 12 Volt.
- Netzteil mit der Spannung des Streifens. Am Ende der Lichtwelle leuchten alle Stufen zugleich.
- Zwei PIR-Sensoren, zum Beispiel HC-SR501 (laut WLED-Doku Signal mit 3,3 Volt, Versorgung 5 bis 12 Volt), oder Ultraschallsensoren HC-SR04.
- Pegelwandler (die WLED-Doku nennt den SN74AHCT125), wenn die Datenleitung vom ESP32 zur ersten Stufe nicht kurz bleibt. Fertige Controller haben oft schon einen eingebaut.
- Abwärtswandler auf 5 Volt für den ESP32, wenn der Streifen mit 12 oder 24 Volt läuft und du nur ein Netzteil willst.
- Leitungen: dünne Datenleitungen von Stufe zu Stufe, kräftige Einspeiseleitungen (laut README mindestens 2,5 mm²), Profile für die Streifen, eventuell Widerstände mit 10 Kiloohm als Pull-down für die Sensoreingänge.
Verdrahtung
Die Datenleitung läuft wie eine Kette durch alle Stufen: Datenpin des ESP32 an den Dateneingang der untersten Stufe, deren Datenausgang an den Eingang der nächsten Stufe und so weiter. So entsteht laut README ein langer virtueller Streifen. Die Stromversorgung läuft dagegen nicht durch die Streifen hindurch, jede Stufe bekommt von einer Seite ihre eigene Einspeisung.
Netzteil 12 V (Stecker-Netzteil)
+12 V und GND ---> Einspeisung Stufe 1 (eine Seite)
+12 V und GND ---> Einspeisung Stufe 2
+12 V und GND ---> Einspeisung Stufe 3, usw. bis zur obersten Stufe
+12 V und GND ---> Abwärtswandler 12 V auf 5 V ---> ESP32 (5V, GND)
ESP32 GPIO16 ---> Pegelwandler ---> DIN Stufe 1
DOUT Stufe 1 ---> DIN Stufe 2
DOUT Stufe 2 ---> DIN Stufe 3, usw.
PIR unten: Versorgung, GND, Signal ---> ESP32 GPIO18
PIR oben: Versorgung, GND, Signal ---> ESP32 GPIO19
GND von Netzteil, ESP32, Streifen und Sensoren miteinander verbinden
Zwei Punkte, an denen es oft hakt:
- Datenpin: Das README nennt den Pin D2 des ESP32, die Einstiegsseite der WLED-Doku empfiehlt GPIO16 und nennt GPIO 4, 13 und 16 bis 33 als geeignet. Entscheidend ist, dass der Pin in WLED mit dem tatsächlich verdrahteten übereinstimmt.
- Masse: ESP32 und Streifen brauchen laut WLED-Doku eine gemeinsame Masse, auch wenn zwei Netzteile im Spiel sind.
Die Sensor-Pins GPIO18 und GPIO19 sind eine Annahme; du trägst sie später in den Usermod-Einstellungen ein.
Firmware mit dem Usermod bauen
Die fertigen Dateien des Releases v16.0.1 sind nach Chip benannt (ESP32, ESP8266 und weitere), eine Variante mit dem Treppen-Usermod fehlt. Laut README musst du WLED selbst kompilieren. Die WLED-Doku nennt dafür zwei Wege.
Weg 1: inoffizieller Web-Compiler. Im Browser wählst du Release, Controller-Typ und Usermods, startest den Build und lädst die Datei herunter oder spielst sie per USB auf. Ob Animated_Staircase in der Liste steht, siehst du dort.
Weg 2: PlatformIO. Die WLED-Doku empfiehlt Visual Studio Code mit der Erweiterung PlatformIO. Du lädst den Quellcode, installierst die Abhängigkeiten und legst im WLED-Ordner neben der platformio.ini eine Datei platformio_override.ini an:
git clone --branch v16.0.1 https://github.com/wled/WLED.git
cd WLED
npm install
; platformio_override.ini im WLED-Ordner, neben der platformio.ini
[platformio]
default_envs = esp32dev_treppe
[env:esp32dev_treppe]
extends = env:esp32dev
custom_usermods = ${env:esp32dev.custom_usermods} Animated_Staircase
Die eigene Umgebung übernimmt alles von der Standard-Umgebung esp32dev und hängt den Usermod an deren Usermods an. Der Name Animated_Staircase stammt aus der library.json des Usermods. Mit dem Häkchen in der blauen Leiste von PlatformIO baust du, mit dem Pfeil baust du und spielst per USB auf. Die fertige Datei liegt laut Doku im Ordner build_output/firmware.
WLED einrichten: LEDs und Segmente
Nach dem ersten Start öffnet WLED laut Doku ein eigenes Funknetz namens WLED-AP (Standardpasswort wled1234), darüber verbindest du den Controller mit deinem WLAN. Danach:
- LED-Einstellungen: Datenpin (hier GPIO16), LED-Typ und Farbreihenfolge passend zum Streifen, Gesamtzahl der LEDs aller Stufen.
- Strombegrenzung prüfen: Ab Werk begrenzt WLED laut Doku auf 850 mA. Bei einer ganzen Treppe bleiben die LEDs dann dunkel, flackern oder leuchten schwach. Stell die Grenze passend zu Netzteil und Leitungen ein.
- Segmente anlegen: je Stufe ein Segment. Die unterste Stufe bekommt laut README die niedrigste Segment-ID. Wichtig: Die Stopp-LED gehört laut Doku nicht mehr zum Segment, das nächste Segment beginnt also genau bei dieser Nummer.
- Als Preset speichern und dieses Preset in den LED-Einstellungen unter „apply preset at boot“ eintragen, damit die Segmente nach einem Neustart wieder da sind.
Beispiel: 14 Stufen mit je 60 LEDs, LEDs gesamt 840
Segment 0 Stufe 1 (unten) Start 0 Stopp 60
Segment 1 Stufe 2 Start 60 Stopp 120
Segment 2 Stufe 3 Start 120 Stopp 180
usw.
Segment 13 Stufe 14 (oben) Start 780 Stopp 840
60 LEDs je Stufe sind eine Annahme: 1 m Streifen mit 60 LEDs pro Meter, wie in der Rechnung unten.
Usermod-Einstellungen
In der Firmware mit dem Usermod gibt es unter den Einstellungen eine Seite für Usermods. Dort erscheinen die Felder des Treppen-Usermods. Die Feldnamen und Standardwerte stammen aus dem Quellcode:
| Feld | Wofür | Beispielwert |
|---|---|---|
| enabled | schaltet den Usermod ein, im Code ab Werk aus | an |
| segment-delay-ms | Zeit zwischen zwei Stufen in Millisekunden, Standard 150 | 150 |
| on-time-s | Leuchtdauer in Sekunden nach der letzten Auslösung, Standard 30 | 30 |
| bottomPIRorTrigger_pin | GPIO des unteren Sensors | 18 |
| topPIRorTrigger_pin | GPIO des oberen Sensors | 19 |
| bottomEcho_pin, topEcho_pin | nur für Ultraschall, bei PIR laut README -1 | -1 |
| useBottomUltrasoundSensor, useTopUltrasoundSensor | Ultraschall statt PIR | aus |
| bottomPIRorTrigger_pin_invert, topPIRorTrigger_pin_invert | kehrt das Sensorsignal um | aus |
| bottom-dist-cm, top-dist-cm | größte Messdistanz für Ultraschall, Standard 50 | nur bei Ultraschall |
| toggle-on-off | schaltet WLED mit dem Lauflicht ein und aus | nach Wunsch |
Stell die Haltezeit am PIR-Sensor kurz ein, beim HC-SR501 laut WLED-Doku am Linksanschlag etwa 3 bis 5 Sekunden. Weil das Licht anbleibt, solange ein Sensor aktiv ist, bestimmt sonst der Sensor die Leuchtdauer.
Zum Testen ohne Treppensteigen löst du den unteren Sensor über die JSON-Schnittstelle aus. Die Adresse ist ein Platzhalter für die IP deines Controllers:
curl -X POST -H "Content-Type: application/json" -d '{"staircase":{"bottom-sensor":true}}' http://192.168.178.50/json/state
Für Home Assistant gibt es eine eigene WLED-Integration; per MQTT meldet der Usermod laut Quellcode Bewegung unten unter motion/1 und oben unter motion/0 des Gerätethemas. Wie eine Automation mit zwei Meldern aussieht, zeigt die Anleitung Treppenlicht mit Home Assistant.
Einspeisung und Querschnitt
Ein adressierbarer Streifen verliert entlang seiner Länge Spannung. Darum speist du laut README jede Stufe einzeln ein, mit mindestens 2,5 mm², und führst die Versorgung nicht wie die Datenleitung von Stufe zu Stufe durch.
QuinLED, ein Anbieter von Controller-Platinen für adressierbare Streifen, nennt als Richtwerte: Eine Einspeisung am Ende eines Streifens bringt höchstens etwa 4 A in den Streifen, eine in der Mitte etwa 8 A. Eine Einspeiseleitung sollte nicht mehr als 10 Prozent Spannungsfall haben. Bei 5 Volt brauchst du deshalb schnell viele Einspeisepunkte.
Die WLED-Doku warnt: Zu dünne Leitungen können überhitzen und einen Brand auslösen, Leitungen und Sicherungen müssen zum Strom passen. Netzteil und Leistung rechnest du mit dem Rechner unter dieser Anleitung aus, Profile und Montage erklärt die Seite LED-Streifen an der Treppe.
Sicherheit
Der ganze Aufbau hinter dem Netzteil arbeitet mit Niedervolt. Streifen, Datenleitungen, Sensoren und ESP32 an einem Stecker-Netzteil darfst du selbst anschließen.
Laut WLED-Doku kommt Flackern bei adressierbaren Streifen manchmal von minderwertigen Netzteilen; Brummen oder Pfeifen ist ein Warnzeichen.
Häufige Fehler
- Standard-Firmware aufgespielt. Dann fehlen die Felder des Treppen-Usermods. Prüfe, ob du die eigene Datei mit Animated_Staircase aufgespielt hast.
- Usermod nicht eingeschaltet. Im Code ist enabled ab Werk aus. Haken setzen und speichern.
- Streifen von der falschen Seite angeschlossen. Die Datenleitung kommt laut WLED-Doku an die Seite, an der die kleinen Pfeile auf dem Streifen beginnen.
- Falscher GPIO. Board-Beschriftungen wie D2 sind nicht immer GPIO-Nummern, in WLED zählt die GPIO-Nummer.
- Strombegrenzung auf 850 mA. Die Treppe bleibt dunkel oder leuchtet schwach, obwohl alles richtig verdrahtet ist.
- Falscher LED-Typ oder Farbreihenfolge. Laut WLED-Doku muss zum Beispiel ein WS2814-Streifen als SK6812 eingestellt werden.
- Lücke zwischen Segmenten. Die Stopp-LED gehört nicht zum Segment. Beginnt das nächste Segment eine LED später, bleibt eine LED dunkel.
- Zu viele Stufen. Mehr als 32 Segmente schafft ein ESP32 ohne PSRAM nicht.
- Ultraschall mit großer Reichweite. Laut README ruckelt dann die Animation und die Oberfläche reagiert träge.
- Einspeisung nur am Anfang. Die oberen Stufen werden schwächer oder verfärben sich.
Ob ein WLED-Lauflicht oder eine einfachere Lösung zu deiner Treppe passt, zeigt der Treppenlicht-Planer mit Stückliste.
Häufige Fragen
- Ist der Usermod Animated Staircase in WLED schon enthalten?
- Nein. Laut README musst du WLED dafür selbst aus dem Quellcode bauen. Die Release-Dateien von v16.0.1 sind nach Chip benannt und enthalten keine Variante mit diesem Usermod. Den Build erledigst du mit PlatformIO oder dem inoffiziellen Web-Compiler, den die WLED-Doku nennt.
- Wie viele Stufen schafft WLED?
- Der Usermod nutzt ein Segment je Stufe. Laut WLED-Doku sind auf dem ESP8266 16 Segmente möglich, auf dem ESP32 32 und mit PSRAM bis zu 64.
- 5, 12 oder 24 Volt: Welcher Streifen passt an die Treppe?
- WLED unterstützt laut Doku Streifen mit 5 Volt wie WS2812B, mit 12 Volt wie WS2815 und mit 12 oder 24 Volt wie WS2814. Bei gleicher Leistung fließt bei 12 oder 24 Volt deutlich weniger Strom als bei 5 Volt. Das spart Einspeisepunkte und dicke Leitungen.
- Kann ich PIR-Sensoren direkt an den ESP32 anschließen?
- Laut WLED-Doku liefert ein Sensor vom Typ HC-SR501 sein Signal mit 3,3 Volt und lässt sich direkt an einen GPIO anschließen; versorgt wird er mit 5 bis 12 Volt. Je nach Sensor kann laut README ein Pull-down-Widerstand mit 10 Kiloohm am Eingang nötig sein.
- Funktioniert das Lauflicht auch ohne WLAN?
- Die Sensoren hängen direkt am ESP32, der Usermod liest sie selbst aus. Für das Lauflicht braucht es also weder Router noch Zentrale. WLAN brauchst du zum Einrichten und wenn du WLED in Home Assistant oder per MQTT einbinden willst.