As configurações do WLED explicadas: corrente máxima, saídas de LED, sincronização e segurança pelo celular
O que as configurações importantes do WLED fazem, com números reais: corrente máxima e por LED, saídas de LED e GPIO, interfaces de sincronização e a trava de OTA.
Uma fita novinha de 300 LEDs que parece estranhamente fraca normalmente não está com defeito. O limitador de brilho do WLED começa em 850 mA, que é mais ou menos o que um carregador de celular fornece, então ele abaixa tudo para ficar abaixo disso. Muitos “bugs” do WLED são assim: uma configuração fazendo o trabalho dela com um número que ninguém mudou.
Todas as configurações abaixo estão na interface web do WLED, e a tabela mostra onde a mesma coisa fica no WLED Max.
Primeiro o sintoma
| O que você vê | Normalmente |
|---|---|
| Fita fraca, ou o branco total parece fraco | Corrente máxima baixa demais para a sua fonte |
| Só os primeiros LEDs acendem | Quantidade de LEDs baixa demais, ou o GPIO de dados errado |
| Vermelho e verde trocados | Ordem das cores |
| O branco total fica laranja na ponta mais distante | queda de tensão (injete energia; uma corrente máxima mais baixa disfarça) |
| A luz reinicia em branco total | fonte sobrecarregada, abaixe a corrente máxima |
| Tremulação aleatória mais adiante na fita | sinal de dados ou terra, não uma configuração |
Esse último pega muita gente. Adicione um terra comum, encurte o primeiro fio de dados ou use um conversor de nível. Nenhuma caixa de seleção resolve isso.
Onde fica cada coisa
| Interface web do WLED (Config) | Configurações do dispositivo no WLED Max | O que tem lá |
|---|---|---|
| WiFi & Network (WiFi Setup no 0.14 e no 0.15) | Configuração do Wi-Fi | rede, IP fixo, ponto de acesso |
| LED & Hardware (LED Preferences no 0.14 e no 0.15) | Preferências de LED | saídas, tipo de LED, quantidade, GPIO, limite de corrente, ordem das cores, padrões de inicialização, padrões do nightlight |
| 2D Configuration | Configuração 2D | painéis de matriz, disposição |
| User Interface | Interface do usuário | descrição do servidor (Device Name no WLED 16). No WLED Max esta seção também guarda o nome na Alexa, os botões, o controle remoto IR e o relé, que a interface web deixa em Sync Interfaces e LED & Hardware |
| Sync Interfaces | Interfaces de sincronização | UDP sync, Alexa, MQTT, E1.31/DMX/Art-Net, Philips Hue, Serial/Adalight |
| Time & Macros | Horário e macros, Agendamentos | NTP, fuso horário, localização, temporizadores |
| Usermods | Usermods | extensões como o AudioReactive |
| Security & Updates | Segurança e atualizações | trava de OTA, senha, reinício (os backups ficam nesta página web; no app ficam em Backup e restauração) |
No WLED Max, abra uma luz, toque no menu e escolha Configurações do dispositivo. O topo mostra as informações do dispositivo: IP, firmware, endereço MAC, quantidade de LEDs e nome mDNS, mais Abrir interface web. Algumas coisas existem só na web, entre elas o reset de fábrica e algumas opções avançadas, e o app avisa quando você chega numa delas.


Corrente máxima e corrente por LED
O limitador automático de brilho (ABL) estima quanta corrente os LEDs puxam e abaixa o brilho para manter o total abaixo do seu limite. Ele precisa de dois números.
Corrente máxima (mA) é o que a sua fonte consegue fornecer, menos uma margem. Uma fonte de 5 V e 10 A fornece 10.000 mA, então coloque uns 8.500 para sobrar folga para o controlador e as perdas.
Corrente por LED (mA) é o que um LED puxa em branco total. O WLED tem valores prontos para isso: 55 mA (WS281x típico de 5 V), 35 mA (WS2812 econômico), 30 mA (típico de 12 V), 12 mA (WS2815) e 15 mA (pixels seed ou fairy). Você também pode digitar o seu.
Um exemplo com números. 300 LEDs WS2812B a 55 mA podem puxar 16,5 A em branco total. Com uma fonte de 10 A e Corrente máxima em 8.500 mA, o WLED limita o branco total a mais ou menos metade do brilho. Cores puxam menos, então podem ficar mais brilhantes. Isso é o limitador funcionando, não um defeito. Não coloque a corrente máxima acima do que a fonte e a fiação aguentam. Em fitas de 5 V, injete energia a cada 100 a 150 LEDs e coloque um fusível em cada trecho. Planejando um beiral inteiro? O guia de energia para beiral e área externa calcula a fonte, os pontos de alimentação e a bitola do fio.
No WLED Max os dois campos ficam em Preferências de LED > Energia e desempenho. O FPS desejado também fica lá. 42 serve para a maioria das fitas, e ir mais alto só ajuda em trechos curtos.


Saídas de LED e GPIO
Uma saída é uma linha de dados do controlador até uma fita. Para cada uma você define:
- Tipo de LED (WS281x, SK6812 RGBW, APA102 e assim por diante)
- GPIO de dados, mais o GPIO de clock para fitas de 4 fios
- Início e Comprimento (a quantidade de LEDs nesta saída)
- Ordem das cores (GRB é o mais comum para WS2812B)
- Invertido e Pular primeiros LEDs (para um primeiro pixel de sacrifício usado como conversor de nível)


Uma segunda fita em outro pino quer dizer uma segunda saída. A interface web tem um botão ”+” em LED & Hardware. O WLED Max tem Adicionar saída e Remover saída ali, e ele confere antes os limites que o seu firmware informa: quantas saídas, quais GPIOs estão livres, quanta memória de LED sobra. Se não conseguir adicionar uma, ele diz por quê. Isso importa mais no ESP8266, que aguenta bem menos LEDs e saídas que um ESP32.
Na interface web, o WLED aplica as novas configurações de saída assim que você salva. O WLED Max pede para você tocar em Salvar e reiniciar, e a luz reinicia com as novas configurações de hardware.
Sync Interfaces
O UDP sync (WLED Sync) mantém várias luzes WLED no mesmo efeito. Send numa, Receive nas outras. Como controlar vários dispositivos WLED vai mais fundo.
O Receive UDP realtime deixa ferramentas controlarem os pixels diretamente por um tempo: Hyperion, xLights, um script do Home Assistant ou os Alertas de Luz do WLED Max. Deixe ligado, a não ser que alguma coisa fique sequestrando a luz. Se isso acontecer, o WLED Max mostra na aba Controle com um botão Assumir o controle, e WLED preso no modo em tempo real explica o resto.


E1.31, Art-Net, DDP são para software de iluminação e shows. O universo e o endereço inicial ficam aqui. MQTT e Alexa cobrem automação residencial fora da própria integração do Home Assistant.
Security & Updates
A trava de OTA (na interface web: “Lock wireless (OTA) software update”; no app: Bloquear atualizações OTA) bloqueia envios de firmware, e só a sua senha a desliga de novo. Bloquear configurações de Wi-Fi protege as configurações de rede do mesmo jeito. Vale a pena numa casa compartilhada ou numa loja. O ArduinoOTA, a restrição de atualização pela mesma sub-rede e o Reiniciar também ficam aqui, e no app o Desbloquear e reiniciar. O processo de atualização em si está em atualização OTA do WLED no ESP8266 e no ESP02.

Luzes em que o app não grava configurações
Desde a versão 1.1.4, o WLED Max não muda configurações numa luz ESP32 que tem pinos I2C definidos, ou em que ele não consegue ler esses pinos. Normalmente são compilações com sensores, telas ou placas de áudio ligadas, e uma mudança de configuração pelo app poderia bagunçar essa montagem. Você vai ver “Esta luz usa hardware extra, então mude isso na página de configurações da própria luz.” com o endereço da luz para abrir no navegador. Se as configurações da luz estiverem travadas com um PIN, o app avisa, pede para você destravar primeiro na interface web do WLED e não muda nada.
Uma mudança em Configuração do Wi-Fi pode levar a luz para um endereço novo, ou para fora da sua rede. Faça backup antes.
Uma última coisa que pega muita gente: uma mudança em Configuração do Wi-Fi (IP fixo, outra rede) pode fazer a luz mudar de endereço. Se ela sumir depois de salvar, confira a lista de clientes do roteador, ou espere o ponto de acesso WLED-AP aparecer. E faça backup da configuração antes de mudanças grandes.