Predefinições do WLED, a predefinição ao ligar e como copiá-las
Como o WLED guarda as predefinições (presets.json, 250 posições), como carregar uma ao ligar a luz e como copiar predefinições para outro controlador.
Se a sua luz WLED acende em laranja depois de cada queda de energia, isso é o padrão de inicialização, e a solução leva mais ou menos um minuto. Salve o visual que você quer como predefinição e depois diga para a luz carregar essa predefinição quando ligar. Tudo abaixo funciona na interface web do WLED, e os passos no app vêm depois.
Predefinição ao ligar
- Salve o visual como predefinição e anote o número dela.
- Na interface web, abra Config›LED & Hardware (chamado LED Preferences no 0.14 e no 0.15).
- Coloque esse número em Apply preset X at boot. 0 quer dizer “usar os padrões”.
- Salve.
Se você quer que a luz chegue a acender depois de uma queda de energia, marque também Turn LEDs on after power up/reset na mesma seção.

Uma armadilha: se você apagar essa predefinição depois, a luz continua apontando para a posição vazia e volta para os padrões. Troque ou desative a predefinição ao ligar sempre que apagar a predefinição que ela usa.
O que uma predefinição guarda de verdade
Uma predefinição é um estado salvo, gravado no presets.json da luz, numa posição numerada de 1 a 250. A janela de salvar da interface web dá algumas opções:
- Name e um Quick load label opcional (um rótulo curto ou emoji para os botões de carregamento rápido no topo da interface).
- Include brightness: se carregar a predefinição também define o brilho.
- Save segment bounds: se a divisão em segmentos (início e fim de cada segmento) faz parte da predefinição. Deixe desligado para predefinições que só devem mudar efeitos e cores na divisão que já estiver lá. Ligue para predefinições que montam zonas.
- Use current state: ligado por padrão. Desligue para salvar um comando da API em vez do estado, por exemplo
{"on":false}para uma predefinição “desligar” que os agendamentos podem chamar.

Você carrega uma predefinição tocando nela, ou pela API mandando {"ps":5} para /json/state.
As posições de 1 a 250 são suas, mas algumas ferramentas guardam coisas nos números altos. O Modo Circadiano do WLED Max, por exemplo, usa as posições 230 a 237 quando roda na luz, e até a 245 no WLED 16. Mantenha as predefinições do dia a dia nos números baixos.
Copiando predefinições para outra luz
Na interface web, as predefinições são um arquivo só, então copiar é fazer backup numa luz e restaurar na outra:
- Na luz de origem, abra Config > Security & Updates e use Backup presets. O navegador baixa o
presets.json. - Na luz de destino, na mesma página, Restore presets, escolha o arquivo.
- Agora o destino tem as mesmas predefinições nas mesmas posições.

Isso substitui todas as predefinições do destino. Predefinições que guardam os limites dos segmentos podem não servir numa fita de outro comprimento, então confira essas depois de copiar.
No WLED Max existe um caminho direto. Vá em Ajustes > Backup e restauração (no Android, Configurações > Backup e restauração) e, em Migração, toque em Copiar predefinições entre dispositivos:

- Escolha a luz de origem em De.
- Escolha a luz de destino em Até (iOS) ou Para (Android).
- Toque em Copiar predefinições. Todas as predefinições do destino são sobrescritas, então faça backup dessa luz antes se ela tiver algo que você quer guardar.
O app precisa de duas ou mais luzes conectadas para isso (no iOS a tela avisa). Vale a pena fazer isso antes de usar Aplicar em vários dispositivos numa predefinição do dispositivo, porque aplicar a predefinição 5 a várias luzes carrega a posição 5 de cada luz, seja lá o que estiver nela. Copiar exige duas luzes, então na prática exige a versão ilimitada. Mais sobre usar várias luzes em controlar vários dispositivos WLED ao mesmo tempo.
A aba Predefinições no WLED Max
A aba Predefinições lê o presets.json da luz e lista predefinições e sequências. Você pode:
- Salvar estado atual numa posição nova, com um nome e um Rótulo de carregamento rápido opcional.
- Tocar e segurar uma predefinição para Editar parâmetros (mudar a velocidade, a intensidade e os controles guardados sem carregar e salvar de novo), Salvar estado atual nesta predefinição para sobrescrever, Aplicar em…, Aplicar em vários dispositivos, Mudar ícone e Apagar predefinição (no Android, Excluir predefinição).
- Usar como predefinição ao ligar, que faz dela a predefinição ao ligar com um toque.


Desde a versão 1.1.4, apagar a predefinição ao ligar no app também desfaz a configuração de inicialização, então a luz não fica apontando para uma posição vazia.
Desde a versão 1.1.9 a aba Controle também mostra qual predefinição está rodando. O nome da predefinição fica numa linha própria embaixo da faixa de prévia ao vivo no cabeçalho, com um pequeno ícone de predefinição, e um nome comprido rola para o lado para nada ficar cortado. O nome vem da própria luz, então some assim que você muda qualquer coisa na mão. Enquanto uma sequência roda, essa linha mostra o nome da sequência em vez da predefinição que está rodando dentro dela.
Se o arquivo de predefinições da luz estiver danificado, o app não sobrescreve o arquivo sem avisar. Ele oferece salvar antes uma cópia do arquivo bruto (iOS: Salvar uma cópia do arquivo, Android: Fazer backup do arquivo bruto).
Em luzes com WLED 16, o app também avisa sobre predefinições que usam o efeito 77, porque “Na v16, o efeito 77 virou Copy Segment (antes era Meteor Smooth)”. Ele não consegue corrigir isso por você, então salve essas predefinições de novo com o efeito que você quer.

Cada predefinição pode ter um ícone na lista, também novo na 1.1.4. No cartão Ícone ao salvar, ou com Mudar ícone no menu de tocar e segurar, escolha Automático (“Usa a cor principal da predefinição.”), Cor ou Emoji. Embaixo do ícone você escolhe um Número da predefinição e o que incluir em Incluir (Brilho e Disposição das seções).
Predefinições que ficam no celular
As predefinições do dispositivo pertencem a uma luz. As Predefinições Globais pertencem ao seu celular: “Salvo no seu celular e disponível para todos os controladores. Aplique em qualquer dispositivo quando quiser.” Elas são boas para visuais que você quer em todo lugar, como uma cena de branco quente para a noite, e você pode aplicar uma numa luz só, num grupo ou em todos os dispositivos. As Predefinições Globais podem ser renomeadas (as do dispositivo não). No iOS elas seguem o Sincronizar com o iCloud se você ligar, então também aparecem no seu iPad.

Quando você personaliza um efeito, Salvar como predefinição no fim do painel oferece as duas opções: Salvar no dispositivo ou Salvar na nuvem no iOS (Salvar na nuvem cria uma Predefinição Global), e Salvar no dispositivo ou Salvar como Predefinição Global no Android. Aplicar só mantém o visual na luz e fecha o painel.
Predefinição ao ligar ignorada, predefinições sumidas
A luz acende laranja depois de uma queda de energia. Não há predefinição ao ligar definida, ou ela aponta para uma posição apagada. Configure o Apply preset at boot (ou o Usar como predefinição ao ligar no app).
A minha predefinição não salva. O sistema de arquivos de um ESP8266 é pequeno, e um presets.json grande (muitas predefinições com divisão de segmentos) pode não conseguir salvar. Apague as predefinições que você não usa.
Carregar uma predefinição bagunça os meus segmentos. Ela foi salva com os limites de segmentos de outra divisão. Salve de novo com a divisão atual, ou com os limites de segmentos desligados.
As predefinições ficam diferentes em outra luz. Quantidades de LEDs, versões de firmware ou ordens de cores diferentes. Os efeitos se ajustam ao comprimento, e o WLED 16 mudou alguns efeitos.
O brilho pula quando carrego uma predefinição. Essa predefinição inclui o brilho. Salve de novo sem o Include brightness.
Quantas dá para guardar? 250 posições, embora num ESP8266 normalmente o espaço na flash acabe antes.
Predefinições que não salvam ou erro 12
Duas faixas de erro na interface web tratam de predefinições, e elas querem dizer coisas diferentes.
Erro 11, “Not enough space to save preset!” (sem espaço para salvar a predefinição). A flash está cheia. O WLED só salva quando há espaço para uma cópia inteira do presets.json mais uns 9 KB, então num ESP8266 um arquivo com muitas predefinições que guardam a divisão dos segmentos chega ao limite antes do que você imagina. Apague predefinições que você não usa, ou salve as novas com Save segment bounds desligado, o que deixa as predefinições pequenas.
Erro 12, “Preset not found.” (predefinição não encontrada). Alguma coisa pediu uma posição que está vazia. Depois de apagar ou renumerar predefinições, confira tudo o que aponta para números de posição: o Apply preset at boot, os temporizadores e as ações de botão em Time & Macros, os itens dentro das suas sequências e qualquer automação que mande {"ps":N}.
Se as predefinições somem depois de salvar, ou a aba Presets da interface web diz “Sorry, there was an issue loading your presets!”, o próprio arquivo pode estar danificado. Restaure um backup do presets.json, ou use o backup que a interface web guarda no seu navegador (ele aparece junto com essa mensagem). Cada código está explicado na lista de códigos de erro do WLED.
Baixe predefinições prontas
Predefinições são só JSON, então dá para compartilhar. Montamos dois conjuntos, cada um com efeitos, cores e uma sequência:
- Natal: bengala doce, vermelho e verde, cintilações estilo C9, branco quente, velas e uma sequência. Na página de padrões de Natal.
- Halloween: Halloween Eyes, raios, velas de abóbora, gosma escorrendo e uma sequência. Na página de Halloween.
Restaurar um arquivo baixado substitui todas as predefinições da luz, então faça backup antes ou cole as predefinições uma por uma com Use current state desmarcado, como explicado nessas páginas.
O próximo passo, se você quer que as predefinições se revezem sozinhas: sequências e Shuffle no WLED. Para backups completos da configuração, veja backup e restauração da configuração do WLED.