Codes d'erreur WLED : ce que veulent dire les erreurs 7, 8, 9, 12, 19 et 91 et comment les corriger
Tous les codes d'erreur de WLED, de 1 à 101 : le sens du message de l'interface web, ce qui le déclenche et la solution. Plus « issue loading your presets ».
Écrit par Jamie Conde, qui développe WLED Max chez MeowScript. WLED Max est une app indépendante, sans lien avec le projet officiel WLED, qui ne la soutient ni ne l'approuve.
WLED affiche ses erreurs dans un petit bandeau rouge en bas de la page web, par exemple Error 8: Effect RAM depleted! Le numéro vient d’une liste du firmware (wled00/const.h), et le texte à côté est la seule explication fournie. Cette page passe en revue chaque code de cette liste, ce qui le déclenche vraiment et ce qu’il faut faire.
Les codes les plus recherchés viennent en premier. Le tableau complet se trouve plus bas.
Le bandeau ne s'affiche qu'une fois. WLED transmet l'erreur à la première page ou à la première app qui demande son état à la lumière, puis l'efface. Si Home Assistant ou une app sur téléphone interroge la lumière en continu, elle peut récupérer l'erreur avant vous, et votre navigateur ne l'affiche jamais. Rechargez la page juste après le problème si vous voulez voir le code.
Erreur 7 : No RAM for buffer
WLED 16 uniquement. La lumière a essayé de réserver de la mémoire pour les pixels d’un segment et il n’y en avait pas assez. WLED désactive alors ce segment, c’est pourquoi on signale souvent ce problème sous la forme « mon segment a disparu ».
Les causes :
- Trop de LED pour la puce, en général un ESP8266 ou une grande matrice 2D.
- De nombreux segments, chacun avec son propre tampon.
- Une image ou un GIF sur une matrice 2D, sur les versions qui savent les lire. Les images consomment aussi de la mémoire.
La solution : réduisez le nombre de LED, fusionnez les segments inutiles ou passez les grosses installations sur un ESP32. Les cartes avec PSRAM (beaucoup de cartes ESP32-S3 et les modules ESP32 WROVER) ont bien plus de place, car WLED 16 place les tampons de pixels dans la PSRAM quand c’est possible.
Erreur 8 : Effect RAM depleted
WLED 0.15 et 16. Un effet a demandé de la mémoire de travail (l’espace temporaire qu’utilisent des effets comme Fire 2012 ou les effets de particules) et ne l’a pas obtenue. WLED plafonne la mémoire totale des effets sur l’ensemble des segments (en 0.15 sur toutes les cartes, en 16 seulement sur les cartes sans PSRAM). Un effet gourmand sur chacun de plusieurs segments peut donc atteindre ce plafond, même quand la lumière semble au repos.
WLED 16 utilise le même code pour deux autres situations, et les deux sont utiles à connaître :
- La mémoire est restée basse pendant 15 secondes. WLED passe tous les segments sur Solid pour libérer de la mémoire et affiche l’erreur 8. Si la mémoire reste basse pendant 30 secondes, il supprime tous les segments sauf un, et au bout de 45 secondes il reconstruit entièrement le ruban LED et se reconnecte au Wi-Fi.
- Une sortie LED demande plus de mémoire que WLED n’en autorise. Cette sortie est ajoutée comme simple emplacement réservé, et les LED qui y sont branchées restent éteintes. Vous voyez l’erreur 8 après avoir enregistré les réglages LED.
La solution : choisissez des effets plus légers (Solid, Solid Pattern et Breathe n’utilisent aucune mémoire d’effet), faites tourner moins de segments avec des effets lourds en même temps, ou mettez moins de LED par sortie. Si vos segments repassent tout seuls sur Solid, c’est presque toujours pour cette raison.
Erreur 9 : JSON parsing error
Toutes les versions (le texte du bandeau apparaît à partir de la 0.15). Quelque chose a envoyé à la lumière du JSON qu’elle n’a pas pu lire, et la requête a été refusée avec un HTTP 400. Rien n’a changé sur la lumière.
Les raisons habituelles :
- Les guillemets typographiques. Vous avez copié une commande depuis une app de notes ou une conversation, et
"est devenu“et”. Les iPhone le font par défaut avec la ponctuation intelligente. Collez d’abord le texte dans un éditeur de texte brut, ou retapez les guillemets. - Une virgule en trop à la fin, des guillemets simples ou un commentaire. Le JSON n’accepte rien de tout cela.
- La requête est trop grosse. Le tampon JSON fait environ 10 Ko sur un ESP8266 et 24 à 32 Ko sur un ESP32. Un préréglage avec beaucoup de segments ou une longue liste de couleurs de LED individuelles peut dépasser cette taille et échouer à l’analyse.
- Sur une connexion WebSocket, un message qui arrive découpé en plusieurs paquets. WLED ne les rassemble pas et répond par l’erreur 9.
Si vous saisissez un préréglage à la main dans l’interface web, l’éditeur de préréglages attrape la plupart de ces erreurs avant qu’elles n’atteignent la lumière : vous obtenez « Syntax error in custom JSON API command » au lieu de l’erreur 9.
Erreur 12 : Preset not found
Toutes les versions. Quelque chose a demandé à la lumière de charger un emplacement de préréglage qui n’existe pas. Cela arrive très souvent après avoir supprimé ou renuméroté des préréglages, car rien dans WLED ne met à jour ce qui pointe vers eux :
- Apply preset at boot dans Config›LED & Hardware (LED Preferences en 0.14 et 0.15).
- Les minuteurs, les actions des boutons et les préréglages Alexa dans Config > Time & Macros.
- Les entrées d’une liste de lecture.
- Les automatisations, les scripts Home Assistant ou une télécommande qui envoient
{"ps":N}.
Cherchez le numéro d’emplacement de l’erreur à chacun de ces endroits. Si l’emplacement existe et que l’erreur 12 persiste, le fichier de préréglages lui-même est peut-être abîmé : voir « issue loading your presets » plus bas.
Pour en savoir plus sur les préréglages de démarrage et les emplacements, lisez Les préréglages WLED et le préréglage de démarrage.
Erreur 19 : A filesystem error has occurred
Toutes les versions. Une panne générale du système de fichiers. Dans le code actuel, elle n’a qu’une origine : WLED essaie de créer un presets.json vide (au démarrage, ou quand vous enregistrez un préréglage alors que le fichier a disparu) et le fichier n’a pas pu être écrit. En 0.14 et 0.15, sur les versions compilées avec la prise en charge de l’EEPROM, elle peut aussi apparaître quand d’anciens préréglages d’un tout premier WLED (l’époque de l’EEPROM) échouent à la conversion.
L’erreur 19 veut donc dire que la mémoire flash ne peut pas être écrite. En général elle est pleine, parfois le système de fichiers est abîmé après une coupure de courant pendant une écriture.
Ce qu’il faut essayer, dans l’ordre :
- Sauvegardez ce que vous pouvez : Config > Security & Updates > Backup configuration, et Backup presets si cela fonctionne.
- Libérez de la place en supprimant des préréglages ou des fichiers que vous avez envoyés (ledmaps, images, palettes personnalisées).
- Si l’erreur revient, faites une réinitialisation d’usine (même page, cochez Factory reset et enregistrez, ce qui efface tous les réglages et préréglages) ou reflashez depuis install.wled.me, puis restaurez vos sauvegardes.
Erreur 91 : Brownout Restart
WLED 16, cartes ESP32 uniquement. La puce a redémarré parce que sa tension d’alimentation est tombée trop bas. WLED lit la raison du redémarrage au lancement et affiche 91 au chargement suivant de la page. Sur un ESP8266, une baisse de tension ressemble à n’importe quelle coupure de courant, vous n’y verrez donc jamais le 91, et les versions 0.14 et 0.15 ne le signalent pas du tout.
Avec des rubans LED, la cause est presque toujours l’alimentation :
- L’alimentation est trop faible pour les LED à la luminosité que vous utilisez. Le blanc à fond est le pire cas.
- Des fils fins ou longs entre l’alimentation et le contrôleur, si bien que la tension chute quand les LED montent en luminosité.
- Le contrôleur est alimenté par le port USB d’un ordinateur portable ou par un chargeur de téléphone trop faible.
- Aucune limite de luminosité n’est réglée.
La solution : réglez Maximum PSU Current (Maximum Current en 0.14) sur la page des réglages LED pour que WLED limite la luminosité à ce que votre alimentation peut fournir, injectez du courant aux deux extrémités des longs tronçons et prenez une alimentation avec de la marge (environ 20 % au-dessus de votre calcul). Les chiffres et les captures d’écran se trouvent dans Les réglages WLED depuis votre téléphone. Si votre lumière décroche aussi du réseau de temps en temps, lisez également Pourquoi WLED passe hors ligne.
Erreur 90 : Unexpected Restart
WLED 16. La lumière a planté ou son watchdog l’a réinitialisée, et elle le signale après le redémarrage. Un 90 de temps en temps ne mérite pas qu’on s’y attarde.
Si elle plante encore et encore, WLED 16 (et 0.15.5) intervient de lui-même. Après 5 plantages, chacun moins de deux minutes après le précédent, il considère qu’il s’agit d’une boucle de démarrage et essaie, une étape par boucle : restaurer la dernière bonne sauvegarde de configuration, puis réinitialiser la configuration, puis (ESP32 uniquement) démarrer le firmware installé avant la dernière mise à jour. Si vos réglages ont changé après une série de redémarrages, voilà pourquoi.
Les déclencheurs fréquents sont un effet ou un module utilisateur trop lourd pour la carte, de mauvais réglages LED (broches, type ou nombre) et des problèmes d’alimentation qui ne comptent pas tout à fait comme une baisse de tension. Si le problème a commencé juste après une mise à jour du firmware, voyez Mettre à jour WLED sans fil.
« Sorry, there was an issue loading your presets! »
Celui-ci n’a pas de numéro. L’interface web l’affiche dans l’onglet Presets quand elle ne peut pas lire presets.json, soit parce que la lumière n’a pas répondu, soit parce que le fichier n’est plus du JSON valide (une coupure de courant pendant un enregistrement peut provoquer cela).
- Ouvrez
http://<your-light-ip>/presets.jsondans un navigateur. Si vous voyez vos préréglages, le fichier est intact et il s’agissait d’un raté de connexion. Rechargez la page. - Si le navigateur que vous utilisez d’habitude a déjà affiché vos préréglages, le message indique aussi « Here is a backup of the last known good state » avec un bouton Copy to clipboard (et un bouton Restore à partir de la 0.15). Cette sauvegarde est stockée dans le navigateur, pas sur la lumière. Copiez-la d’abord en lieu sûr, puis restaurez.
- Sinon, restaurez un
presets.jsonenregistré via Config > Security & Updates > Restore presets. Cela remplace tout le contenu du fichier.
Prendre l’habitude de sauvegarder la configuration et les préréglages transforme une mauvaise soirée en une correction de deux minutes.
Tous les codes d’erreur WLED
| Code | Texte de l’interface web | Signification | Versions |
|---|---|---|---|
| 1 | Denied! | Une modification des réglages a été refusée parce qu’un code PIN de réglages est défini et n’a pas été saisi | toutes (texte à partir de 0.15) |
| 2 | (aucun) | 0.14 : un ancien code EEPROM, inutilisé. 0.15 et 16 : « concurrency », défini mais jamais déclenché | aucune en pratique |
| 3 | Buffer locked! | La lumière était occupée par une autre requête JSON | toutes |
| 4 | (vide) | Non implémenté : une adresse /json/... que la lumière ne connaît pas, ou en 16 un effet réservé à la 2D sur un ruban 1D, un effet de particules 1D sur un segment d’une seule LED, ou un fichier de police abîmé pour le texte défilant | 0.15, 16 |
| 7 | No RAM for buffer! | Pas assez de mémoire pour les pixels d’un segment | 16 |
| 8 | Effect RAM depleted! | Pas assez de mémoire pour un effet, ou (16) mémoire basse ou sortie LED trop grande | 0.15, 16 |
| 9 | JSON parsing error! | La lumière a reçu du JSON qu’elle n’a pas pu lire | toutes |
| 10 | Could not mount filesystem! | Le système de fichiers de la mémoire flash n’a pas démarré | toutes |
| 11 | Not enough space to save preset! | Le système de fichiers est plein | toutes |
| 12 | Preset not found. | Un emplacement de préréglage inexistant a été demandé | toutes |
| 13 | Missing ir.json. | Une télécommande IR réglée en mode JSON a envoyé un code, mais ir.json n’est pas sur la lumière | toutes |
| 14 | (aucun) | remote.json manquant ; la vérification est commentée, elle ne se déclenche donc jamais | aucune en pratique |
| 19 | A filesystem error has occured. | Panne générale du système de fichiers, en général lors de la création de presets.json | toutes |
| 30, 31, 32 | (aucun) | Surchauffe, surintensité, sous-tension. Marqués « not implemented » dans le code | aucune en pratique |
| 33 à 37 | (aucun) | Codes de mémoire basse définis en 16 mais pas encore déclenchés (leur texte dans l’interface web est commenté) | aucune en pratique |
| 90 | Unexpected Restart. | La lumière a redémarré après un plantage ou une réinitialisation par le watchdog | 16 |
| 91 | Brownout Restart. | La lumière a redémarré parce que sa tension d’alimentation a chuté | 16, ESP32 |
| 100 | Note 100: Please reboot WLED to activate changed settings. | Un réglage matériel demande un redémarrage (en 16.0.1 : modifications de panneau HUB75 sur ESP32-S3) | 16 |
| 101 | Note 101: Please switch your device off and back on. | Un réglage matériel demande de couper puis rétablir l’alimentation ; défini, pas encore utilisé en 16.0.1 | 16 |
En 0.14, l’interface web n’a de texte que pour 10, 11, 12, 13 et 19, donc tout autre code s’affiche sous la forme « Error N: » sans rien derrière. C’est aussi le cas de l’erreur 4 sur les versions plus récentes. La faute dans « occured » vient du firmware.
Les autres, en bref
Erreur 1 (Denied). Vous avez défini un code PIN dans Config > Security & Updates et quelque chose a essayé de modifier les réglages sans lui. Saisissez le code PIN dans l’interface web, ou dans l’app ou le script qui écrit les réglages.
Erreur 3 (Buffer locked). WLED traite une seule requête JSON à la fois. En 0.15, une deuxième requête qui arrive entre-temps reçoit un HTTP 503 avec l’erreur 3 (en 0.14, seules les lectures le reçoivent ; une écriture ne reçoit simplement pas de réponse). WLED 16 fait patienter les requêtes HTTP à la place, mais les clients WebSocket peuvent encore recevoir l’erreur 3. Si vous la voyez souvent, quelque chose interroge la lumière de manière intensive : une intégration Home Assistant, plusieurs onglets de navigateur ouverts et une app en même temps. Fermez ce dont vous n’avez pas besoin.
Erreur 10 (Could not mount filesystem). En général, le firmware a été flashé avec une mauvaise disposition de mémoire flash pour la carte, ou la puce flash est en train de lâcher. Reflashez avec l’installateur web et laissez-le d’abord effacer la carte. Vous perdez les réglages et les préréglages, restaurez-les donc depuis une sauvegarde. En pratique, un montage raté apparaît plutôt sous la forme de l’erreur 19, car WLED essaie aussitôt de créer presets.json et cela échoue aussi.
Erreur 11 (Not enough space). WLED n’enregistre un préréglage que s’il reste de la place pour une copie complète du fichier plus environ 9 Ko. Un ESP8266 avec beaucoup de préréglages qui stockent des dispositions de segments est le premier à manquer de place. Supprimez les préréglages inutilisés ou les fichiers envoyés dont vous n’avez plus besoin.
Erreur 13 (Missing ir.json). Le récepteur IR est réglé sur le type « JSON remote » dans Config > LED & Hardware (LED Preferences en 0.14 et 0.15), mais aucun ir.json n’a été envoyé. Envoyez-en un, ou choisissez le modèle de votre télécommande dans la liste.
Messages des apps
Les apps n’affichent pas les numéros de WLED. Elles ont leurs propres formulations, et deux messages de WLED Max (iOS et Android) viennent directement d’états du firmware :
- « L’appareil est occupé et n’a pas accepté la modification. » La lumière a répondu à plusieurs reprises par l’erreur 3, et l’app a abandonné après plusieurs essais. Attendez quelques secondes, réessayez, et cherchez ce qui interroge aussi la lumière.
- « L’appareil a envoyé une réponse inattendue. Il utilise peut-être une version de firmware incompatible. » La lumière a répondu, mais avec une erreur HTTP ou une réponse que l’app ne pouvait pas exploiter. Il peut s’agir d’un WLED très ancien, d’un tout autre firmware ou d’une lumière qui a redémarré au milieu de la requête.
L’app vérifie aussi presets.json avant de le modifier. Si le fichier est abîmé, elle ne l’écrase pas et propose à la place d’enregistrer une copie du fichier brut (iOS : Enregistrer une copie du fichier ; Android : Sauvegarder le fichier brut dans l’avertissement, ou Enregistrer une copie du fichier dans l’onglet Préréglages).
Si la lumière ne répond pas du tout, c’est un problème de réseau et non une erreur WLED, et L’app WLED ne trouve pas vos lumières passe en revue les causes.
FAQ
Où se trouve la liste des codes d’erreur WLED ? Dans wled00/const.h du code source de WLED, à côté des noms ERR_. Le texte de l’interface web pour chacun se trouve dans wled00/data/index.js.
Une erreur veut-elle dire que ma carte est cassée ? Rarement. La plupart des codes concernent la mémoire (7, 8), les préréglages (12) ou l’alimentation (91). Ce sont les erreurs 10 et 19 qui reviennent après un reflash qui désignent le matériel.
Pourquoi l’erreur disparaît-elle quand je recharge la page ? WLED efface l’erreur après l’avoir signalée une fois. Elle ne revient que si le problème se reproduit.