WS2812B com ESP32 e WLED: ligações, alimentação e configuração

Do que você precisa

Valores de resistor e capacitor como no guia NeoPixel da Adafruit e na nossa calculadora; o limiar da entrada de dados vem do datasheet do WS2812B da Worldsemi.

WS2812B em 5 V ou WS2815 em 12 V?

O WS2815 tem seus três LEDs em série e funciona em 12 V, então, com o mesmo número de pixels, puxa muito menos corrente. Para 5 m com 60 LEDs por metro, a nossa calculadora dá:

Resultados da nossa calculadora de fonte para fita de LED para as duas fitas (versão WS2815).

Dimensionar a alimentação

Um pixel WS2812B puxa até cerca de 60 mA no branco total. Cinco metros com 60 LEDs por metro são 300 LEDs: 18 A no branco total, então a calculadora pede uma fonte de 5 V de pelo menos 21,6 A, com 20% de folga. Se a fonte for dimensionada para efeitos típicos, que consomem cerca de um terço disso, 7,2 A bastariam, mas aí o limitador de brilho do WLED precisa manter a fita abaixo desse valor.

Escolha a sua fita e informe o comprimento e a densidade: a calculadora dá a fonte, os pontos de alimentação, o fusível e o cabo de cada ponto e o limite para o WLED.Abrir a calculadora de fita de LED

Em 5 V, é a queda de tensão ao longo da fita que decide a cada quantos metros é preciso injetar a alimentação de novo. Para esta fita, a calculadora prevê 4 pontos de alimentação a cada 1,67 m, pontas incluídas, cada um com até 6 A. Cada ponto tem o seu próprio par de fios saindo da fonte e o seu próprio fusível de 7,5 A; para 2 m de cabo com 5% de queda, a calculadora de bitola de cabo indica 2,5 mm².

As ligações

• Terra. Tudo compartilha um só terra: fonte, fita e controlador. Se o controlador tiver fonte própria, ligue os dois terras. Sem terra comum, o sinal de dados fica sem referência e a fita pisca.
• Dados. GPIO → conversor de nível (VCC em 5 V) → resistor → DIN do primeiro LED. Mantenha curto o fio entre o controlador e o primeiro LED e coloque o resistor do lado da fita. Siga as setas impressas na fita: os dados só vão num sentido.
• Alimentação. Um par de fios separado da fonte até cada ponto, cada um com o seu fusível, em vez de um único cabo emendado ao longo da fita.
• Capacitor. Entre + e − onde a alimentação entra primeiro na fita, respeitando a polaridade.
• Ordem. Ligue primeiro o terra, depois a alimentação e por último os dados, e energize os LEDs antes do controlador.

O WS2815 se liga do mesmo jeito, em 12 V. Com um WS2815B-V1, o sinal de dados de 3,3 V do ESP32 costuma funcionar direto, então muitas vezes dá para dispensar o conversor de nível; acrescente-o se os primeiros LEDs piscarem ou mostrarem cores erradas. O controlador, porém, precisa da sua própria alimentação de 5 V, vinda de um pequeno conversor step-down de 12 V para 5 V, porque o pino de 5 V de uma placa de desenvolvimento foi feito para 5 V.

Segurança

• Fontes ligadas à rede elétrica, sempre numa caixa. As fontes abertas para LED têm os bornes da rede elétrica expostos. Monte-as numa caixa fechada, com prensa-cabo em cada cabo e o terra ligado, e deixe as ligações à rede elétrica com um profissional habilitado quando as normas exigirem.
• Um fusível por ramal. Dimensione cada fusível pelo cabo dele, como a calculadora faz, para que um curto no fim da fita também o queime.
• Uma só alimentação por vez para a placa. No esquema, o ESP32 recebe os 5 V da fonte da fita pelo pino de 5 V. O guia da Espressif para a DevKitC diz que a placa deve ser alimentada por uma única fonte; caso contrário, a placa ou a fonte podem ser danificadas. Grave o WLED e faça a primeira configuração pelo USB antes de ligar esse fio de 5 V, e desligue-o sempre que conectar o USB depois; o fio de terra pode continuar ligado.
• Nunca alimente a fita pela placa. O pino de 5 V de uma placa de desenvolvimento passa a corrente do USB por trilhas finas; a própria documentação do WLED diz para manter o limite abaixo de 1 A se os LEDs forem alimentados por ali. Alimente a fita direto da fonte.
• Calor. No branco total as fitas esquentam: em trechos longos, monte-as num perfil de alumínio e confira se a fonte está ventilada.

Instalar o WLED

Abra o instalador web em install.wled.me num navegador com Web Serial: Chrome, Edge, Opera no desktop, ou Firefox a partir da versão 151. Safari e navegadores de celular não funcionam. Conecte a placa com um cabo USB de dados, escolha a versão (a 16.0.1 é a última estável, de julho de 2026), clique em Install e selecione a porta serial da placa. Faça isso sem o fio de 5 V que liga a placa à fonte da fita: uma só alimentação por vez.

• Nenhuma porta na lista? Teste outro cabo e depois instale o driver do chip USB da placa: CH34x (WCH) ou CP210x.
• Ainda nada? Segure o botão BOOT da placa enquanto conecta o cabo.
• Depois da gravação, o instalador pode oferecer a configuração do Wi-Fi na hora. Se não oferecer, use o ponto de acesso descrito abaixo.

As atualizações seguintes dispensam o cabo: Config → Security & Updates aceita um firmware novo pelo Wi-Fi. Antes, na mesma página, faça backup da configuração e dos presets.

Primeira configuração

1. Sem Wi-Fi configurado, o WLED abre um ponto de acesso chamado WLED-AP. Conecte-se com a senha wled1234.
2. Abra 4.3.2.1 no navegador se a página de configuração não aparecer sozinha.
3. Vá em WiFi settings, procure ou digite o nome da sua rede e a senha dela. A rede precisa ser de 2,4 GHz.
4. Dê a ele um nome mDNS, por exemplo mesa, para achá-lo depois em mesa.local, e troque a senha do ponto de acesso, que por padrão é wled1234.
5. Clique em Save & Connect. O WLED entra na sua rede; encontre-o pelo nome mDNS ou pelo roteador.

Os ajustes dos LEDs

Abra Config → LED & Hardware antes de qualquer coisa: o WLED não conhece a sua fita até você dizer.

• Type: WS281x, tanto para um WS2812B quanto para um WS2815.
• GPIO: o pino de dados, veja a tabela abaixo; Config → Pin Info lista todos os pinos e o que está usando cada um.
• Length: o número de LEDs, 300 no nosso exemplo.
• Color Order: GRB, o padrão, para a maioria das fitas WS2812B. Se o vermelho sair verde, teste as outras opções.
• Limitador automático de brilho (Enable automatic brightness limiter): deixe ativado. Em Maximum PSU Current, coloque o valor da nossa calculadora de fonte para fita de LED: 18.000 mA com a fonte do nosso exemplo, dimensionada para branco total, ou 6.000 mA com uma dimensionada para efeitos típicos; o WLED aceita de 250 a 65.000 mA. Ajuste também mA/LED como a calculadora indica: Custom com 60 mA para um WS2812B, ou a opção “12mA (WS2815)”.
• Os segmentos dividem a fita em partes com efeito e cor próprios; os presets guardam um efeito com cores e brilho, e Apply preset at boot escolhe com qual a fita liga.

Pinos de strapping e reservados das nossas páginas de pinagem do ESP32, da ESP32-C3 SuperMini, do ESP32-S3 e da D1 mini; pinos do ESP8266 da documentação do WLED.

Home Assistant

O Home Assistant costuma descobrir o WLED na rede: ele aparece em Configurações → Dispositivos & Serviços, na seção Descoberto. Se não aparecer, clique em Adicionar integração, escolha WLED e digite o nome do host ou o endereço IP. A integração precisa do WLED 0.14 ou mais recente.

A integração cria uma entidade de luz para a fita; com dois ou mais segmentos, uma por segmento mais uma luz principal para ligar e controlar o brilho geral. Há entidades de seleção para presets, playlists e paletas, entidades numéricas para velocidade e intensidade dos efeitos e uma entidade de atualização de firmware que oferece as versões estáveis do WLED.

Resolução de problemas

O tom rosa ou laranja no fim da fita é o sinal típico de poucos pontos de alimentação.