Por que uma luz WLED fica caindo da rede, e como ser avisado quando isso acontece
Por que um controlador WLED cai do Wi-Fi (sinal fraco, Wi-Fi sleep, alimentação, DHCP, mDNS), como resolver cada causa e como receber um alerta quando ela fica sem conexão.
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.
Resposta rápida: confira primeiro o sinal de Wi-Fi na página Info da luz. Melhor que -70 dBm está bom, de -70 a -80 dBm está no limite, e abaixo de -80 dBm ela vai cair. Se o sinal está bom, a causa quase sempre é a economia de energia do Wi-Fi, uma fonte de alimentação fraca, um endereço IP que fica mudando ou um app que procura a luz pelo nome numa rede que bloqueia isso.
Nenhuma das soluções aqui precisa de app. São configurações do WLED e do roteador.
Primeiro, ela está mesmo sem conexão?
Abra o endereço IP da luz num navegador. Se a interface web carrega, a luz está bem e o problema é o jeito como o seu app encontra a luz (pule para a parte de mDNS mais abaixo). Se não carrega, faça um ping a partir de um computador:
ping 192.168.1.50
Nenhuma resposta: a luz está fora da rede. Respostas que vêm e vão: Wi-Fi ruim.
Sinal
Na interface web do WLED, toque em Info e veja o sinal de Wi-Fi. Ele aparece em porcentagem e em dBm.
| Sinal | O que esperar |
|---|---|
| melhor que -70 dBm | bom |
| -70 a -80 dBm | no limite, respostas lentas de vez em quando |
| abaixo de -80 dBm | quedas, principalmente com efeitos que mandam muitos dados |
As placas ESP têm antenas minúsculas. Coloque uma numa caixa de metal, atrás de uma TV ou dentro de uma calha e ela perde muito. O que ajuda: mudar o ponto de acesso de lugar ou adicionar um mais perto, usar uma placa com antena externa (muitas placas ESP32 têm conector), tirar o controlador da caixa de metal e manter a ponta da placa com a antena longe da fita e da fonte de alimentação.
O WLED é só 2,4 GHz. Um único nome de rede para 2,4 e 5 GHz normalmente funciona. Alguns sistemas mesh, porém, trocam os clientes de nó com insistência demais, e uma rede separada de 2,4 GHz para aparelhos IoT muitas vezes resolve.
Wi-Fi sleep
Em Config > WiFi & Network (WiFi Setup no 0.14 e no 0.15) tem uma caixa chamada Disable WiFi sleep. Marque essa opção.
Uma caixa perto do fim da página. No WLED Max é a chave Suspensão do Wi-Fi em Configurações do dispositivo, Configuração do Wi-Fi (desligada quer dizer sem sleep).
O modem sleep economiza um pouco de energia, mas a luz responde devagar e, em alguns roteadores, cai de vez. As compilações para ESP32 vêm com isso marcado por padrão. Os de ESP8266, não, e é por isso que as luzes com ESP8266 são as que normalmente precisam disso.
Fica reiniciando: queda de tensão (erro 91)
Ela “cai da rede” sempre que mostra branco forte? Isso é queda de tensão (brownout). Os LEDs puxam corrente demais, o ESP reinicia, e cada reinício tira a luz da rede por alguns segundos. Você vê a luz piscar ou recomeçar o efeito, e a página Info mostra um tempo ligado (uptime) curto.

Uma fonte de alimentação maior resolve, a injeção de energia também, ou um Maximum PSU Current mais baixo em Config > LED & Hardware (Corrente máxima (mA) nas Preferências de LED do WLED Max) para o WLED limitar o brilho. Configurações do WLED explicadas tem os números. Em placas ESP32 com WLED 16, a interface web mostra o erro 91 depois de um reinício desses; códigos de erro do WLED explica.
Sem conexão depois de uma atualização
Uma luz que estava bem antes de uma atualização de firmware e não é encontrada depois normalmente cai num destes casos:
- Ela voltou para o modo WLED-AP. As configurações de Wi-Fi não sobreviveram à atualização. Procure uma rede WLED-AP, entre nela (senha wled1234), configure o Wi-Fi de novo e restaure o seu backup.
- Ela está num endereço IP novo. O reinício pediu um endereço ao roteador e recebeu outro. Encontre a luz na lista de clientes do roteador e adicione uma reserva de DHCP (próxima seção).
- Ela fica reiniciando sem parar. O WLED 0.15.5 e o 16 percebem um loop de inicialização depois de 5 falhas (crashes) rápidas e recuam sozinhos. No ESP32, logo depois de uma atualização, o primeiro passo é voltar ao firmware anterior. Fora isso, eles primeiro restauram a última configuração boa e depois redefinem a configuração. Dê alguns minutos e depois confira se as suas configurações mudaram.
- A compilação errada foi instalada. Uma placa com Ethernet atualizada com uma compilação sem Ethernet, por exemplo, nunca volta pelo cabo. Grave a compilação certa por USB em install.wled.me. Qual .bin usar ajuda a escolher.
Endereço IP que muda
Depois que o roteador reinicia, a luz pode voltar com um IP novo, e os apps que guardaram o antigo não conseguem mais alcançá-la. Crie no roteador uma reserva de DHCP para o endereço MAC dela (o MAC está na página Info), ou defina um IP fixo na página WiFi & Network do WLED. A reserva no roteador é mais fácil de acompanhar.

Encontrada pelo nome (mDNS)
Os apps encontram luzes WLED com mDNS, que por padrão não atravessa VLANs nem redes de convidados e é filtrado por alguns roteadores mesh. Se o navegador alcança a luz e o app não, essa é a causa provável, e o app de WLED não encontra as suas luzes passa pelas soluções, incluindo a permissão “Rede Local” do iPhone.
Sendo avisado quando uma luz cai
O WLED Max tem uma notificação opcional Dispositivo sem conexão (“Receba uma notificação quando uma luz ficar sem conexão por alguns minutos”). Ela é grátis e vem desligada. Você encontra em Ajustes›Preferências do app›Notificações (no Android, Configurações no lugar de Ajustes).
Ela é discreta de propósito. Uma luz precisa parar de responder por alguns minutos enquanto o seu celular está no Wi-Fi, e o app confere mais uma vez antes de dizer qualquer coisa. Aí você recebe uma notificação, como “Porch Lights ficou sem conexão”, e a aba Dispositivos marca a luz. Se você estiver olhando a aba Dispositivos nessa hora, a lista já mostra a queda e nenhuma notificação é enviada. Luzes que caem ao mesmo tempo dividem uma notificação, e você fica sabendo da mesma luz no máximo uma vez por queda e uma vez por dia. Nada é enviado pelos dados móveis, e se a luz voltar a notificação some sozinha. Isso roda enquanto o app está aberto. Não é um monitoramento 24 horas. Para isso, o Home Assistant ou os alertas de dispositivo do seu roteador fazem um trabalho melhor.
A versão 1.1.4 deixou esses alertas mais calmos, então, se você desligou os alertas numa versão antiga porque eram insistentes demais, experimente de novo.
Se nada aqui ajudar, a comunidade do WLED (Discord, Reddit r/WLED, o fórum) já viu praticamente todo controlador instável que existe. Se parece um problema do app, o Fale conosco na aba Ajustes (Configurações no Android) do WLED Max fala com a gente, e as respostas chegam no app.
Checklist
A maioria das luzes instáveis se resolve com as três primeiras linhas. Os itens de rede importam quando o navegador alcança a luz e o app não.
- Sinal melhor que -70 dBm no controlador
- Disable WiFi sleep marcado
- Fonte de alimentação dimensionada para a quantidade de LEDs, Corrente máxima configurada
- Reserva de DHCP para a luz
- Mesma rede do celular (ou um refletor de mDNS)
- Permissão “Rede Local” no iPhone
O firmware também está desatualizado? Atualizar o WLED no ESP8266 e no ESP02 trata disso, e vale a pena fazer backup da configuração antes de mudar qualquer coisa grande.