WLED-Fehlercodes: Was Fehler 7, 8, 9, 12, 19 und 91 bedeuten und wie Sie sie beheben
Jeder Fehlercode, den WLED definiert, von 1 bis 101: was die Meldung in der Weboberfläche bedeutet, was sie in der Firmware auslöst und wie Sie den Fehler beheben. Außerdem die Meldung "issue loading your presets".
Geschrieben von Jamie Conde, die WLED Max bei MeowScript entwickelt. WLED Max ist eine unabhängige App, die mit dem offiziellen WLED-Projekt weder verbunden ist noch von ihm empfohlen wird.
WLED zeigt Fehler als kurzes rotes Banner am unteren Rand der Webseite, zum Beispiel Error 8: Effect RAM depleted! Die Nummer stammt aus einer Liste in der Firmware (wled00/const.h), und der Text daneben ist die ganze Erklärung, die Sie bekommen. Diese Seite geht jeden Code dieser Liste durch: was ihn wirklich auslöst und was Sie dagegen tun können.
Die Codes, nach denen am häufigsten gesucht wird, kommen zuerst. Die vollständige Tabelle steht weiter unten.
Das Banner erscheint einmal. WLED übergibt den Fehler an die erste Seite oder App, die das Licht nach seinem Zustand fragt, und löscht ihn dann. Wenn Home Assistant oder eine Handy-App das Licht abfragt, kann sie den Fehler zuerst abholen, und Ihr Browser zeigt ihn nie an. Laden Sie die Seite direkt nach dem Problem neu, wenn Sie den Code sehen wollen.
Fehler 7: No RAM for buffer
Nur WLED 16. Das Licht wollte Speicher für die Pixel eines Segments reservieren, und es war nicht genug da. WLED schaltet dieses Segment dann ab. Deshalb melden viele den Fehler als "mein Segment ist verschwunden".
Ursachen:
- Zu viele LEDs für den Chip, meist ein ESP8266 oder eine große 2D-Matrix.
- Viele Segmente, jedes mit eigenem Puffer.
- Ein Bild oder GIF auf einer 2D-Matrix, bei Firmware-Varianten, die sie abspielen können. Bilder brauchen ebenfalls Speicher.
Die Lösung: LED-Anzahl verringern, nicht benötigte Segmente zusammenlegen oder große Installationen auf einen ESP32 umziehen. Boards mit PSRAM (viele ESP32-S3-Boards und ESP32-WROVER-Module) haben deutlich mehr Platz, weil WLED 16 Pixelpuffer nach Möglichkeit im PSRAM ablegt.
Fehler 8: Effect RAM depleted
WLED 0.15 und 16. Ein Effekt hat Arbeitsspeicher angefordert (den Zwischenspeicher, den Effekte wie Fire 2012 oder die Partikeleffekte nutzen) und nicht bekommen. WLED begrenzt den gesamten Effektspeicher über alle Segmente (auf 0.15 auf jedem Board, auf 16 nur auf Boards ohne PSRAM). Ein speicherhungriger Effekt auf mehreren Segmenten gleichzeitig kann die Grenze also auch dann erreichen, wenn das Licht ruhig wirkt.
WLED 16 verwendet denselben Code für zwei weitere Situationen, und beide sollten Sie kennen:
- Der Speicher blieb 15 Sekunden lang knapp. WLED schaltet jedes Segment auf Solid, um Speicher freizugeben, und zeigt Fehler 8. Bleibt der Speicher 30 Sekunden knapp, entfernt es alle Segmente bis auf eines, und nach 45 Sekunden baut es den LED-Streifen komplett neu auf und verbindet sich neu mit dem WLAN.
- Ein LED-Ausgang braucht mehr Speicher, als WLED zulässt. Dieser Ausgang wird als Platzhalter angelegt, die LEDs daran bleiben dunkel. Sie sehen Fehler 8 nach dem Speichern der LED-Einstellungen.
Die Lösung: leichtere Effekte verwenden (Solid, Solid Pattern und Breathe brauchen gar keinen Effektspeicher), weniger Segmente gleichzeitig mit speicherhungrigen Effekten oder weniger LEDs pro Ausgang. Wenn Ihre Segmente immer wieder von selbst zu Solid werden, ist das fast immer der Grund.
Fehler 9: JSON parsing error
Alle Versionen (der Bannertext erscheint ab 0.15). Etwas hat dem Licht JSON geschickt, das es nicht lesen konnte, und die Anfrage wurde mit HTTP 400 abgelehnt. Am Licht hat sich nichts geändert.
Die üblichen Gründe:
- Typografische Anführungszeichen. Sie haben einen Befehl aus einer Notizen-App oder einem Chat kopiert, und aus
"wurde“und”. iPhones machen das standardmäßig mit der Einstellung "Intelligente Interpunktion". Fügen Sie den Text zuerst in einen reinen Texteditor ein oder tippen Sie die Anführungszeichen neu. - Ein Komma am Ende, einfache Anführungszeichen oder ein Kommentar. JSON erlaubt nichts davon.
- Die Anfrage ist zu groß. Der JSON-Puffer hat auf dem ESP8266 etwa 10 KB und auf dem ESP32 24 bis 32 KB. Eine Szene mit vielen Segmenten oder einer langen Liste einzelner LED-Farben kann darüber hinausgehen und lässt sich dann nicht verarbeiten.
- Bei WebSocket-Verbindungen eine Nachricht, die in mehreren Paketen ankommt. WLED setzt sie nicht wieder zusammen und antwortet mit Fehler 9.
Wenn Sie eine Szene in der Weboberfläche von Hand eintippen, fängt der Szeneneditor die meisten dieser Fälle ab, bevor sie das Licht erreichen: Sie bekommen "Syntax error in custom JSON API command" statt Fehler 9.
Fehler 12: Preset not found
Alle Versionen. Etwas hat das Licht aufgefordert, einen Szenenplatz zu laden, der nicht existiert. Das passiert häufig, nachdem Sie Szenen gelöscht oder umnummeriert haben, weil nichts in WLED die Stellen aktualisiert, die auf sie verweisen:
- Apply preset at boot in Config›LED & Hardware (LED Preferences auf 0.14 und 0.15).
- Timer, Tastenaktionen und die Alexa-Szenen unter Config > Time & Macros.
- Einträge in einer Szenenfolge.
- Home-Assistant-Automatisierungen, Skripte oder eine Fernbedienung, die
{"ps":N}senden.
Prüfen Sie jede dieser Stellen auf die Platznummer aus der Fehlermeldung. Wenn der Platz existiert und Sie trotzdem Fehler 12 bekommen, ist vielleicht die Szenendatei selbst beschädigt, siehe "issue loading your presets" weiter unten.
Mehr zu Einschaltszenen und Plätzen in WLED-Szenen und die Einschaltszene.
Fehler 19: A filesystem error has occurred
Alle Versionen. Ein allgemeiner Dateisystemfehler. Im aktuellen Quellcode kommt er von einer einzigen Stelle: WLED versucht, eine leere presets.json anzulegen (beim Start oder wenn Sie eine Szene speichern und die Datei fehlt), und die Datei konnte nicht geschrieben werden. Auf 0.14 und 0.15 mit EEPROM-Unterstützung kann er auch auftauchen, wenn sich alte Szenen aus einem sehr frühen WLED (der EEPROM-Zeit) nicht umwandeln lassen.
Fehler 19 bedeutet also, dass der Flash nicht beschrieben werden kann. Meist ist er voll, manchmal ist das Dateisystem nach einem Stromausfall während eines Schreibvorgangs beschädigt.
Was Sie versuchen können, in dieser Reihenfolge:
- Sichern Sie, was geht: Config > Security & Updates > Backup configuration, und Backup presets, falls es funktioniert.
- Schaffen Sie Platz, indem Sie Szenen oder hochgeladene Dateien löschen (Ledmaps, Bilder, eigene Paletten).
- Kommt der Fehler immer wieder, machen Sie einen Werksreset (gleiche Seite, Factory reset anhaken und speichern, das löscht alle Einstellungen und Szenen) oder flashen Sie über install.wled.me neu und stellen Sie danach Ihre Sicherungen wieder her.
Fehler 91: Brownout Restart
WLED 16, nur ESP32-Boards. Der Chip ist neu gestartet, weil seine Versorgungsspannung zu weit abgesunken ist. WLED liest beim Start den Reset-Grund aus und zeigt beim nächsten Laden der Seite 91 an. Auf einem ESP8266 sieht ein Brownout wie jeder andere Stromausfall aus, dort werden Sie 91 nie sehen, und 0.14 und 0.15 melden ihn gar nicht.
Bei LED-Streifen liegt es fast immer an der Stromversorgung:
- Das Netzteil ist zu klein für die LEDs bei der Helligkeit, die Sie nutzen. Vollweiß ist der schlimmste Fall.
- Dünne oder lange Kabel zwischen Netzteil und Controller, sodass die Spannung einbricht, wenn die LEDs hell werden.
- Der Controller läuft an einem Laptop-USB-Port oder einem schwachen Handy-Ladegerät.
- Es ist keine Helligkeitsgrenze gesetzt.
Die Lösung: Stellen Sie Maximum PSU Current (Maximum Current auf 0.14) auf der LED-Einstellungsseite ein, damit WLED die Helligkeit auf das begrenzt, was Ihr Netzteil liefern kann, speisen Sie bei langen Strecken an beiden Enden Strom ein und verwenden Sie ein Netzteil mit etwas Reserve (etwa 20 % über dem berechneten Wert). Zahlen und Screenshots finden Sie in WLED-Einstellungen vom Handy aus. Wenn Ihr Licht außerdem gelegentlich aus dem Netzwerk fällt, lesen Sie auch Warum WLED offline geht.
Fehler 90: Unexpected Restart
WLED 16. Das Licht ist abgestürzt oder sein Watchdog hat es zurückgesetzt, und es meldet das nach dem Neustart. Einer einzelnen 90 hin und wieder müssen Sie nicht nachgehen.
Stürzt es immer wieder ab, greift WLED 16 (und 0.15.5) selbst ein. Nach 5 Abstürzen, jeder innerhalb von zwei Minuten nach dem vorherigen, wertet es das als Boot-Schleife und versucht pro Durchlauf einen Schritt: die letzte funktionierende Sicherung der Konfiguration wiederherstellen, dann die Konfiguration zurücksetzen, dann (nur ESP32) die Firmware starten, die vor dem letzten Update installiert war. Wenn Ihre Einstellungen nach einer Reihe von Neustarts also anders aussehen, ist das der Grund.
Häufige Auslöser sind ein Effekt oder ein Benutzermodul, das das Board überfordert, falsche LED-Einstellungen (Pins, Typ oder Anzahl) und Stromprobleme, die nicht ganz als Brownout zählen. Wenn es direkt nach einem Firmware-Update begonnen hat, lesen Sie WLED per OTA aktualisieren.
"Sorry, there was an issue loading your presets!"
Diese Meldung hat keine Nummer. Die Weboberfläche zeigt sie in ihrem Tab Presets, wenn sie presets.json nicht lesen kann, entweder weil das Licht nicht geantwortet hat oder weil die Datei kein gültiges JSON mehr ist (ein Stromausfall während des Speicherns kann das verursachen).
- Öffnen Sie
http://<your-light-ip>/presets.jsonin einem Browser. Wenn Sie Ihre Szenen sehen, ist die Datei in Ordnung und es war ein Verbindungsaussetzer. Laden Sie die Seite neu. - Wenn der Browser, den Sie normalerweise verwenden, Ihre Szenen schon einmal gesehen hat, zeigt die Meldung auch "Here is a backup of the last known good state" mit einer Schaltfläche Copy to clipboard (und ab 0.15 einer Schaltfläche Restore). Diese Sicherung liegt im Browser, nicht auf dem Licht. Kopieren Sie sie zuerst an einen sicheren Ort, dann stellen Sie wieder her.
- Andernfalls stellen Sie eine gespeicherte
presets.jsonunter Config > Security & Updates > Restore presets wieder her. Das ersetzt den gesamten Inhalt der Datei.
Wenn Sie sich angewöhnen, Konfiguration und Szenen zu sichern, wird aus einem verlorenen Abend eine Sache von zwei Minuten.
Alle WLED-Fehlercodes
| Code | Text der Weboberfläche | Bedeutung | Versionen |
|---|---|---|---|
| 1 | Denied! | Eine Einstellungsänderung wurde abgelehnt, weil eine Einstellungs-PIN gesetzt ist und nicht eingegeben wurde | alle (Text ab 0.15) |
| 2 | (keiner) | 0.14: ein alter EEPROM-Code, ungenutzt. 0.15 und 16: "concurrency", definiert, aber nie ausgelöst | in der Praxis keine |
| 3 | Buffer locked! | Das Licht war mit einer anderen JSON-Anfrage beschäftigt | alle |
| 4 | (leer) | Nicht implementiert: eine /json/...-Adresse, die das Licht nicht kennt, oder auf 16 ein reiner 2D-Effekt auf einem 1D-Streifen bzw. ein 1D-Partikeleffekt auf einem Segment mit einer LED, oder eine defekte Schriftdatei für Lauftext | 0.15, 16 |
| 7 | No RAM for buffer! | Nicht genug Speicher für die Pixel eines Segments | 16 |
| 8 | Effect RAM depleted! | Nicht genug Speicher für einen Effekt, oder (16) knapper Speicher oder ein zu großer LED-Ausgang | 0.15, 16 |
| 9 | JSON parsing error! | Das Licht hat JSON empfangen, das es nicht lesen konnte | alle |
| 10 | Could not mount filesystem! | Das Flash-Dateisystem ist nicht gestartet | alle |
| 11 | Not enough space to save preset! | Das Dateisystem ist voll | alle |
| 12 | Preset not found. | Ein Szenenplatz wurde angefordert, der nicht existiert | alle |
| 13 | Missing ir.json. | Eine IR-Fernbedienung im JSON-Modus hat einen Code gesendet, aber ir.json liegt nicht auf dem Licht | alle |
| 14 | (keiner) | Fehlende remote.json; die Prüfung ist auskommentiert, sie löst also nie aus | in der Praxis keine |
| 19 | A filesystem error has occured. | Allgemeiner Dateisystemfehler, meist beim Anlegen von presets.json | alle |
| 30, 31, 32 | (keiner) | Übertemperatur, Überstrom, Unterspannung. Im Quellcode als "not implemented" markiert | in der Praxis keine |
| 33 bis 37 | (keiner) | Codes für knappen Speicher, in 16 definiert, aber noch nicht ausgelöst (ihr Text in der Weboberfläche ist auskommentiert) | in der Praxis keine |
| 90 | Unexpected Restart. | Das Licht ist nach einem Absturz oder Watchdog-Reset neu gestartet | 16 |
| 91 | Brownout Restart. | Das Licht ist neu gestartet, weil seine Versorgungsspannung eingebrochen ist | 16, ESP32 |
| 100 | Note 100: Please reboot WLED to activate changed settings. | Eine Hardware-Einstellung braucht einen Neustart (auf 16.0.1: HUB75-Panel-Änderungen auf dem ESP32-S3) | 16 |
| 101 | Note 101: Please switch your device off and back on. | Eine Hardware-Einstellung braucht ein Aus- und Einschalten; definiert, in 16.0.1 noch nicht genutzt | 16 |
Die Weboberfläche von 0.14 hat nur Text für 10, 11, 12, 13 und 19, jeder andere Code erscheint dort als "Error N:" ohne etwas dahinter. Dasselbe passiert bei Fehler 4 auf neueren Versionen. Der Tippfehler in "occured" steckt in der Firmware.
Der Rest in Kürze
Fehler 1 (Denied). Sie haben unter Config > Security & Updates eine PIN gesetzt, und etwas wollte Einstellungen ohne sie ändern. Geben Sie die PIN in der Weboberfläche ein oder hinterlegen Sie sie in der App bzw. dem Skript, das die Einstellungen schreibt.
Fehler 3 (Buffer locked). WLED verarbeitet eine JSON-Anfrage nach der anderen. Auf 0.15 bekommt eine zweite Anfrage, die währenddessen eintrifft, HTTP 503 mit Fehler 3 (auf 0.14 nur Leseanfragen, eine Schreibanfrage bekommt einfach keine Antwort). WLED 16 lässt HTTP-Anfragen stattdessen warten, aber WebSocket-Clients können weiterhin Fehler 3 bekommen. Wenn Sie ihn oft sehen, fragt etwas das Licht sehr häufig ab: eine Home-Assistant-Integration, mehrere offene Browser-Tabs und gleichzeitig eine App. Schließen Sie, was Sie nicht brauchen.
Fehler 10 (Could not mount filesystem). Meist wurde die Firmware mit dem falschen Flash-Layout für das Board geflasht, oder der Flash-Chip geht kaputt. Flashen Sie mit dem Web-Installer neu und lassen Sie das Board vorher löschen. Einstellungen und Szenen gehen dabei verloren, stellen Sie sie aus einer Sicherung wieder her. In der Praxis zeigt sich ein fehlgeschlagenes Einhängen meist als Fehler 19, weil WLED sofort versucht, presets.json anzulegen, und das ebenfalls scheitert.
Fehler 11 (Not enough space). WLED speichert eine Szene nur, wenn Platz für eine vollständige Kopie der Datei plus etwa 9 KB vorhanden ist. Ein ESP8266 mit vielen Szenen, die Segmentaufteilungen speichern, ist zuerst voll. Löschen Sie Szenen, die Sie nicht nutzen, oder entfernen Sie hochgeladene Dateien, die Sie nicht mehr brauchen.
Fehler 13 (Missing ir.json). Der IR-Empfänger ist unter Config > LED & Hardware (LED Preferences auf 0.14 und 0.15) auf den Typ "JSON remote" gestellt, aber es wurde keine ir.json hochgeladen. Laden Sie eine hoch oder wählen Sie das Modell Ihrer Fernbedienung aus der Liste.
Meldungen aus Apps
Apps zeigen die Fehlernummern von WLED nicht an. Sie haben ihre eigenen Formulierungen, und zwei Meldungen in WLED Max (iOS und Android) gehen direkt auf Firmware-Zustände zurück:
- "Das Gerät ist beschäftigt und hat die Änderung nicht übernommen." (iOS) bzw. "Das Gerät ist beschäftigt und hat die Änderung nicht angenommen." (Android). Das Licht hat immer wieder mit Fehler 3 geantwortet, und die App hat nach mehreren Versuchen aufgegeben. Warten Sie ein paar Sekunden und versuchen Sie es erneut. Prüfen Sie auch, ob noch etwas anderes das Licht ständig abfragt.
- "Das Gerät hat unerwartet geantwortet. Möglicherweise läuft eine inkompatible Firmware-Version." Das Licht hat geantwortet, aber mit einem HTTP-Fehler oder einer Antwort, mit der die App nichts anfangen konnte. Das kann ein sehr altes WLED sein, eine ganz andere Firmware oder ein Licht, das mitten in der Anfrage neu gestartet ist.
Die App prüft außerdem presets.json, bevor sie die Datei ändert. Ist die Datei beschädigt, überschreibt sie sie nicht und bietet stattdessen an, eine Kopie der Rohdatei zu speichern (iOS: Kopie der Datei speichern; Android: Rohdatei sichern in der Warnung oder Kopie der Datei speichern im Tab Szenen).
Antwortet das Licht gar nicht, ist das ein Netzwerkproblem und kein WLED-Fehler. Die WLED-App findet Ihre Lichter nicht geht die Ursachen durch.
FAQ
Wo finde ich die Liste der WLED-Fehlercodes? In wled00/const.h im WLED-Quellcode, neben den ERR_-Namen. Der Text der Weboberfläche zu jedem Code steht in wled00/data/index.js.
Bedeutet ein Fehler, dass mein Board defekt ist? Selten. Die meisten Codes betreffen Speicher (7, 8), Szenen (12) oder die Stromversorgung (91). Fehler 10 und 19, die nach einem Neuflashen immer wiederkommen, sind die, die auf die Hardware deuten.
Warum verschwindet der Fehler, wenn ich die Seite neu lade? WLED löscht den Fehler, nachdem es ihn einmal gemeldet hat. Er kommt nur zurück, wenn das Problem erneut auftritt.