WLED Solução de problemas Erros Passo a passo

Códigos de erro do WLED: o que os erros 7, 8, 9, 12, 19 e 91 significam e como resolver

Todos os códigos de erro do WLED, de 1 a 101: o que a mensagem da interface web quer dizer, o que dispara cada um e a solução. E também o 'issue loading your presets'.

Por

Escrito por Jamie Conde, que desenvolve o WLED Max na MeowScript. O WLED Max é um app independente e não tem afiliação nem endosso do projeto oficial WLED.

O WLED mostra erros como uma faixa vermelha curta na parte de baixo da página web, como Error 8: Effect RAM depleted! O número vem de uma lista no firmware (wled00/const.h), e o texto ao lado é toda a explicação que você recebe. Esta página passa por todos os códigos dessa lista, pelo que de fato dispara cada um e pelo que fazer.

Os códigos mais buscados vêm primeiro. A tabela completa fica mais abaixo.

Bom saber

A faixa aparece uma vez. O WLED entrega o erro para a primeira página ou app que pedir o estado da luz, e depois apaga. Se o Home Assistant ou um app de celular está consultando a luz, ele pode pegar o erro primeiro, e o seu navegador nunca mostra. Recarregue a página logo depois que o problema acontecer se você quiser ver o código.

Erro 7: No RAM for buffer

Só no WLED 16. A luz tentou reservar memória para os pixels de um segmento e não havia o bastante. Aí o WLED desliga esse segmento, e é por isso que as pessoas muitas vezes relatam isso como “meu segmento sumiu”.

O que causa:

  • LEDs demais para o chip, normalmente um ESP8266 ou uma matriz 2D grande.
  • Muitos segmentos, cada um com seu próprio buffer.
  • Uma imagem ou GIF numa matriz 2D, nas compilações que conseguem reproduzi-los. Imagens também precisam de memória.

A solução: diminua a quantidade de LEDs, junte segmentos de que você não precisa, ou passe instalações grandes para um ESP32. Placas com PSRAM (muitas placas ESP32-S3 e os módulos ESP32 WROVER) têm muito mais espaço, porque o WLED 16 coloca os buffers de pixels na PSRAM quando pode.

Erro 8: Effect RAM depleted

WLED 0.15 e 16. Um efeito pediu memória de trabalho (o espaço de rascunho que efeitos como o Fire 2012 ou os efeitos de partículas usam) e não conseguiu. O WLED limita a memória total de efeitos somando todos os segmentos (no 0.15 em todas as placas, no 16 só em placas sem PSRAM), então um efeito pesado em cada um de vários segmentos pode bater no limite mesmo com a luz parecendo parada.

O WLED 16 usa o mesmo código para mais duas situações, e vale a pena conhecer as duas:

  • A memória ficou baixa por 15 segundos. O WLED muda todos os segmentos para Solid para liberar memória e mostra o erro 8. Se a memória continuar baixa por 30 segundos, ele remove todos os segmentos menos um, e aos 45 segundos reconstrói a fita de LED do zero e reconecta o Wi-Fi.
  • Uma saída de LED precisa de mais memória do que o WLED permite. Essa saída é adicionada como um marcador vazio, então os LEDs dela ficam apagados. Você vê o erro 8 depois de salvar as configurações de LED.

A solução: use efeitos mais leves (Solid, Solid Pattern e Breathe não precisam de memória de efeito nenhuma), menos segmentos rodando efeitos pesados ao mesmo tempo, ou menos LEDs por saída. Se os seus segmentos vivem virando Solid sozinhos, quase sempre o motivo é este.

Erro 9: JSON parsing error

Todas as versões (o texto da faixa aparece a partir do 0.15). Alguma coisa mandou para a luz um JSON que ela não conseguiu ler, e o pedido foi recusado com HTTP 400. Nada mudou na luz.

Os motivos de sempre:

  • Aspas curvas. Você copiou um comando de um app de notas ou de um chat, e " virou “ e ”. O iPhone faz isso por padrão com a Pontuação Inteligente. Cole antes num editor de texto simples, ou digite as aspas de novo.
  • Uma vírgula sobrando no fim, aspas simples ou um comentário. O JSON não aceita nenhum deles.
  • O pedido é grande demais. O buffer de JSON tem uns 10 KB no ESP8266 e de 24 a 32 KB no ESP32, e uma predefinição com muitos segmentos ou uma lista longa de cores de LEDs individuais pode passar disso e falhar na leitura.
  • Em conexões WebSocket, uma mensagem que chega dividida em vários pacotes. O WLED não junta os pedaços e responde com o erro 9.

Se você está digitando uma predefinição à mão na interface web, o editor de predefinições pega a maioria desses problemas antes de chegarem à luz: você vê “Syntax error in custom JSON API command” em vez do erro 9.

Erro 12: Preset not found

Todas as versões. Alguma coisa pediu para a luz carregar uma posição de predefinição que não existe. Acontece direto depois que você apaga ou renumera predefinições, porque nada no WLED atualiza o que aponta para eles:

  • Apply preset at boot em Config›LED & Hardware (LED Preferences no 0.14 e no 0.15).
  • Temporizadores, ações de botão e as predefinições da Alexa em Config > Time & Macros.
  • Itens dentro de uma sequência.
  • Automações e scripts do Home Assistant, ou um controle remoto, que mandam {"ps":N}.

Procure em cada um desses o número da posição do erro. Se a posição existe e você continua vendo o erro 12, o próprio arquivo de predefinições pode estar danificado; veja “issue loading your presets” abaixo.

Mais sobre a predefinição ao ligar e as posições em Predefinições do WLED e a predefinição ao ligar.

Erro 19: A filesystem error has occurred

Todas as versões. Uma falha geral do sistema de arquivos. No código atual ele vem de um lugar só: o WLED tenta criar um presets.json vazio (na inicialização, ou quando você salva uma predefinição e o arquivo sumiu), e não conseguiu gravar o arquivo. No 0.14 e no 0.15, em compilações com suporte a EEPROM, ele também pode aparecer quando predefinições antigas de um WLED bem antigo (da época da EEPROM) não conseguem ser convertidos.

Então o erro 19 quer dizer que não dá para gravar na flash. Normalmente ela está cheia, às vezes o sistema de arquivos ficou danificado depois de uma queda de energia durante uma gravação.

O que tentar, nesta ordem:

  1. Faça backup do que der: Config > Security & Updates > Backup configuration, e Backup presets se funcionar.
  2. Libere espaço apagando predefinições ou arquivos que você enviou (ledmaps, imagens, paletas personalizadas).
  3. Se continuar voltando, faça um reset de fábrica (na mesma página, marque Factory reset e salve, o que apaga todas as configurações e predefinições) ou grave de novo pelo install.wled.me, depois restaure os seus backups.

Erro 91: Brownout Restart

WLED 16, só em placas ESP32. O chip reiniciou porque a tensão de alimentação caiu demais. O WLED lê o motivo do reset na inicialização e mostra o 91 na próxima vez que a página carrega. Num ESP8266 uma queda de tensão parece qualquer outra falta de energia, então você nunca vai ver o 91 ali, e o 0.14 e o 0.15 nem informam isso.

Com fitas de LED, a causa quase sempre é a alimentação:

  • A fonte é pequena demais para os LEDs no brilho que você usa. Branco total é o pior caso.
  • Fios finos ou longos entre a fonte e o controlador, então a tensão cai quando os LEDs ficam fortes.
  • O controlador está ligado na porta USB de um notebook ou num carregador de celular fraco.
  • Nenhum limite de brilho está definido.

A solução: defina Maximum PSU Current (Maximum Current no 0.14) na página de configurações de LED para o WLED limitar o brilho ao que a sua fonte aguenta, faça injeção de energia nas duas pontas de trechos longos e use uma fonte com alguma folga (uns 20% acima do que você calcular). Números e capturas de tela estão em configurações do WLED pelo celular. Se a sua luz também cai da rede de vez em quando, leia também por que o WLED fica sem conexão.

Erro 90: Unexpected Restart

WLED 16. A luz travou ou foi reiniciada pelo watchdog, e avisa isso depois de reiniciar. Um 90 de vez em quando não vale a pena investigar.

Se ela trava várias vezes seguidas, o WLED 16 (e o 0.15.5) age sozinho. Depois de 5 falhas (crashes), cada um até dois minutos depois do anterior, ele trata isso como um loop de inicialização e tenta, um passo por loop: restaurar o último backup bom da configuração, depois redefinir a configuração, depois (só no ESP32) iniciar o firmware que estava instalado antes da última atualização. Então, se as suas configurações parecem diferentes depois de uma série de reinícios, é por isso.

Os gatilhos comuns são um efeito ou usermod pesado demais para a placa, configurações de LED erradas (pinos, tipo ou quantidade) e problemas de alimentação que não chegam a contar como queda de tensão. Se começou logo depois de uma atualização de firmware, veja atualizar o WLED sem fio (OTA).

“Sorry, there was an issue loading your presets!”

Este não tem número. A interface web mostra essa mensagem na aba Presets quando não consegue ler o presets.json, seja porque a luz não respondeu, seja porque o arquivo não é mais um JSON válido (uma queda de energia durante uma gravação pode causar isso).

  1. Abra http://<your-light-ip>/presets.json no navegador. Se aparecerem as suas predefinições, o arquivo está bom e foi um soluço na conexão. Recarregue a página.
  2. Se o navegador que você costuma usar já viu as suas predefinições antes, a mensagem também mostra “Here is a backup of the last known good state” com um botão Copy to clipboard (e um botão Restore a partir do 0.15). Esse backup fica no navegador, não na luz. Copie para um lugar seguro primeiro, depois restaure.
  3. Se não, restaure um presets.json salvo em Config > Security & Updates > Restore presets. Isso substitui tudo o que há no arquivo.

Criar o hábito de fazer backup da configuração e das predefinições transforma isso de uma noite perdida num conserto de dois minutos.

Todos os códigos de erro do WLED

CódigoTexto na interface webO que significaVersões
1Denied!Uma mudança de configuração foi recusada porque há um PIN nas configurações e ele não foi digitadotodas (texto a partir do 0.15)
2(nenhum)0.14: um código antigo de EEPROM, sem uso. 0.15 e 16: “concurrency”, definido mas nunca disparadonenhuma na prática
3Buffer locked!A luz estava ocupada com outro pedido JSONtodas
4(em branco)Não implementado: um endereço /json/... que a luz não conhece, ou no 16 um efeito só 2D numa fita 1D ou um efeito de partículas 1D num segmento de um LED só, ou um arquivo de fonte quebrado para texto rolante0.15, 16
7No RAM for buffer!Memória insuficiente para os pixels de um segmento16
8Effect RAM depleted!Memória insuficiente para um efeito, ou (16) memória baixa ou uma saída de LED grande demais0.15, 16
9JSON parsing error!A luz recebeu um JSON que não conseguiu lertodas
10Could not mount filesystem!O sistema de arquivos da flash não inicioutodas
11Not enough space to save preset!O sistema de arquivos está cheiotodas
12Preset not found.Foi pedida uma posição de predefinição que não existetodas
13Missing ir.json.Um controle IR configurado no modo JSON mandou um código, mas o ir.json não está na luztodas
14(nenhum)Falta o remote.json; a verificação está comentada no código, então nunca disparanenhuma na prática
19A filesystem error has occured.Falha geral do sistema de arquivos, normalmente ao criar o presets.jsontodas
30, 31, 32(nenhum)Superaquecimento, sobrecorrente, subtensão. Marcados como “not implemented” no códigonenhuma na prática
33 a 37(nenhum)Códigos de memória baixa definidos no 16 mas ainda não disparados (o texto deles na interface web está comentado)nenhuma na prática
90Unexpected Restart.A luz reiniciou depois de um travamento ou de um reset do watchdog16
91Brownout Restart.A luz reiniciou porque a tensão de alimentação caiu16, ESP32
100Note 100: Please reboot WLED to activate changed settings.Uma configuração de hardware precisa de reinício (no 16.0.1: mudanças de painel HUB75 no ESP32-S3)16
101Note 101: Please switch your device off and back on.Uma configuração de hardware precisa desligar e ligar a alimentação; definido, ainda sem uso no 16.0.116

A interface web do 0.14 só tem texto para 10, 11, 12, 13 e 19, então qualquer outro código aparece como “Error N:” sem nada depois. O mesmo acontece com o erro 4 nas versões mais novas. O erro de digitação em “occured” está no próprio firmware.

O resto, em poucas palavras

Erro 1 (Denied). Você definiu um PIN em Config > Security & Updates e algo tentou mudar configurações sem ele. Digite o PIN na interface web, ou no app ou script que está gravando.

Erro 3 (Buffer locked). O WLED trata um pedido JSON por vez. No 0.15, um segundo pedido que chega nesse meio-tempo recebe HTTP 503 com o erro 3 (no 0.14 só as leituras; uma gravação simplesmente fica sem resposta). O WLED 16 faz os pedidos HTTP esperarem, mas clientes WebSocket ainda podem receber o erro 3. Se você vê isso com frequência, alguma coisa está consultando a luz sem parar: uma integração do Home Assistant, várias abas de navegador abertas e um app ao mesmo tempo. Feche o que você não precisa.

Erro 10 (Could not mount filesystem). Normalmente o firmware foi gravado com a tabela de partições errada para a placa, ou o chip de flash está falhando. Grave de novo com o instalador web e deixe o instalador apagar a placa antes. Você perde configurações e predefinições, então restaure de um backup. Na prática, uma montagem que falha costuma aparecer como erro 19, porque o WLED tenta criar o presets.json na hora e isso também falha.

Erro 11 (Not enough space). O WLED só salva uma predefinição se houver espaço para uma cópia completa do arquivo mais uns 9 KB. Um ESP8266 com muitas predefinições que guardam a disposição dos segmentos fica sem espaço primeiro. Apague as predefinições que você não usa, ou remova arquivos enviados de que não precisa mais.

Erro 13 (Missing ir.json). O receptor IR está configurado como o tipo “JSON remote” em Config > LED & Hardware (LED Preferences no 0.14 e no 0.15), mas nenhum ir.json foi enviado. Envie um, ou escolha o modelo do seu controle na lista.

Mensagens dos apps

Os apps não mostram os números do WLED. Eles têm o próprio texto, e duas mensagens do WLED Max (iOS e Android) vêm direto de estados do firmware:

  • “O dispositivo está ocupado e não aceitou a mudança.” A luz continuou respondendo com o erro 3, e o app desistiu depois de tentar de novo. Espere alguns segundos e tente outra vez, e veja se outra coisa está consultando a luz.
  • “O dispositivo enviou uma resposta inesperada. Ele pode estar com uma versão de firmware incompatível.” A luz respondeu, mas com um erro HTTP ou uma resposta que o app não conseguiu usar. Pode ser um WLED muito antigo, outro firmware totalmente diferente, ou uma luz que reiniciou no meio do pedido.

O app também confere o presets.json antes de mudá-lo. Se o arquivo estiver danificado, ele não grava por cima e oferece salvar uma cópia do arquivo bruto (iOS: Salvar uma cópia do arquivo; Android: Fazer backup do arquivo bruto no aviso, ou Salvar uma cópia do arquivo na aba Predefinições).

Se a luz não responde de jeito nenhum, é um problema de rede e não um erro do WLED, e o app de WLED não encontra as suas luzes passa pelas causas.

Perguntas frequentes

Onde fica a lista de códigos de erro do WLED? Em wled00/const.h no código-fonte do WLED, junto aos nomes ERR_. O texto da interface web para cada um está em wled00/data/index.js.

Um erro quer dizer que a minha placa está com defeito? Raramente. A maioria dos códigos é sobre memória (7, 8), predefinições (12) ou alimentação (91). Os erros 10 e 19 que continuam voltando depois de gravar o firmware de novo são os que apontam para o hardware.

Por que o erro some quando eu recarrego? O WLED apaga o erro depois de informá-lo uma vez. Ele só volta se o problema acontecer de novo.

Todos os recursos do WLED Max, nosso app de WLED para iOS e Android, são grátis para uma luz.