WS2812B con ESP32 e WLED: collegamenti, alimentazione e configurazione

Cosa ti serve

Valori di resistenza e condensatore come nella guida NeoPixel di Adafruit e nel nostro calcolatore; la soglia del segnale dati dal datasheet Worldsemi del WS2812B.

WS2812B a 5 V o WS2815 a 12 V?

Il WS2815 mette i suoi tre LED in serie a 12 V, quindi a parità di pixel assorbe molta meno corrente. Per 5 m a 60 LED al metro il nostro calcolatore dà:

Il nostro calcolatore per strisce LED per le due strisce (versione WS2815).

Dimensionare l’alimentazione

Un pixel WS2812B assorbe fino a circa 60 mA a bianco pieno. Cinque metri a 60 LED al metro fanno 300 LED: 18 A a bianco pieno, quindi il calcolatore chiede un alimentatore a 5 V da almeno 21,6 A con il 20 % di margine. Se lo dimensioni per gli effetti tipici, che assorbono circa un terzo, bastano 7,2 A, ma allora il limitatore di luminosità di WLED deve tenere la striscia entro quel valore.

Inserisci la tua striscia, con lunghezza e densità: il calcolatore ti dà l’alimentatore, i punti di alimentazione con fusibile e cavo per ciascuno, e il limite per WLED.Apri il calcolatore per strisce LED

A 5 V è la caduta di tensione lungo la striscia a decidere ogni quanto va riportata l’alimentazione. Per questa striscia il calcolatore prevede 4 punti di alimentazione a 1,67 m l’uno dall’altro, estremità comprese, e ciascuno porta fino a 6 A. Ogni punto ha la sua coppia di cavi dall’alimentatore e il suo fusibile da 7,5 A; per 2 m di cavo con il 5 % di caduta il calcolatore della sezione dei cavi indica 2,5 mm².

I collegamenti

• Massa. Tutto condivide una sola massa: alimentatore, striscia e controller. Se il controller ha un alimentatore suo, unisci le due masse. Senza massa comune il segnale dati non ha riferimento e la striscia sfarfalla.
• Dati. GPIO → level shifter (VCC a 5 V) → resistenza → DIN del primo LED. Tieni corto il filo tra controller e primo LED e metti la resistenza dal lato della striscia. Segui le frecce stampate sulla striscia: i dati vanno in un solo verso.
• Alimentazione. Una coppia di cavi per ogni punto, che parte direttamente dall’alimentatore, ognuna con il suo fusibile, invece di un unico cavo che corre lungo la striscia.
• Condensatore. Tra + e − dove l’alimentazione entra per prima nella striscia, rispettando la polarità.
• Ordine. Collega prima la massa, poi l’alimentazione, poi i dati, e dai tensione ai LED prima che al controller.

Il WS2815 si collega allo stesso modo a 12 V. Con un WS2815B-V1 il segnale dati a 3,3 V dell’ESP32 di solito funziona direttamente, quindi spesso si può fare a meno del level shifter; aggiungilo se i primi LED sfarfallano o mostrano colori sbagliati. Il controller però ha bisogno di una sua alimentazione a 5 V, da un piccolo convertitore da 12 a 5 V, perché il pin 5 V di una scheda di sviluppo accetta solo 5 V.

Sicurezza

• Alimentatori da rete in un contenitore. Gli alimentatori a giorno per LED hanno i morsetti della rete scoperti. Montali in una scatola chiusa, con un fermacavo su ogni cavo e la terra collegata, e lascia i collegamenti alla rete a una persona qualificata dove le norme lo richiedono.
• Un fusibile per ramo. Dimensiona ogni fusibile sul suo cavo, come fa il calcolatore, così anche un corto in fondo alla striscia lo fa saltare.
• Una sola alimentazione alla volta per la scheda. Nello schema l’ESP32 prende i 5 V dall’alimentatore della striscia attraverso il suo pin 5 V. La guida di Espressif alla DevKitC dice che la scheda va alimentata da una sola fonte, altrimenti la scheda o la fonte possono danneggiarsi. Carica WLED e fai la prima configurazione via USB prima di collegare quel filo dei 5 V, e scollegalo ogni volta che in seguito colleghi l’USB; il filo di massa può restare collegato.
• Mai alimentare la striscia attraverso la scheda. Il pin 5 V di una scheda di sviluppo porta la corrente dell’USB su piste sottili; la documentazione di WLED stessa dice di tenere il limite sotto 1 A se i LED si alimentano da lì. Alimenta la striscia direttamente dall’alimentatore.
• Calore. A bianco pieno le strisce si scaldano: per tratti lunghi montale su un profilo in alluminio e controlla che l’alimentatore sia ventilato.

Installare WLED

Apri l’installer web su install.wled.me in un browser con Web Serial: Chrome, Edge, Opera su desktop, oppure Firefox dalla versione 151. Safari e i browser per smartphone non funzionano. Collega la scheda con un cavo USB per dati, scegli la versione (la 16.0.1 è l’ultima stabile, di luglio 2026), clicca Install e scegli la porta seriale della scheda. Fallo senza il filo dei 5 V che collega la scheda all’alimentatore della striscia: una sola alimentazione alla volta.

• Nessuna porta in elenco? Prova un altro cavo, poi installa il driver del chip USB della scheda: CH34x (WCH) o CP210x.
• Ancora niente? Tieni premuto il pulsante BOOT della scheda mentre la colleghi.
• Dopo il flash l’installer può proporti di configurare subito il Wi-Fi. Se non lo fa, usa l’hotspot descritto qui sotto.

Gli aggiornamenti successivi non richiedono il cavo: Config → Security & Updates accetta un nuovo firmware via Wi-Fi. Prima, dalla stessa pagina, fai un backup della configurazione e dei preset.

Prima configurazione

1. Senza Wi-Fi configurato, WLED apre un hotspot chiamato WLED-AP. Collegati con la password wled1234.
2. Apri 4.3.2.1 nel browser se la pagina di configurazione non compare da sola.
3. Clicca WiFi settings, cerca o scrivi il nome della tua rete e inserisci la password. La rete deve essere a 2,4 GHz.
4. Dagli un nome mDNS, per esempio scrivania, così poi lo trovi su scrivania.local, e cambia la password dell’hotspot, che di default è wled1234.
5. Clicca Save & Connect. WLED si collega alla tua rete; lo ritrovi con il nome mDNS o dalla pagina del router.

Le impostazioni dei LED

Apri Config → LED & Hardware prima di tutto: WLED non conosce la tua striscia finché non gliela descrivi.

• Type: WS281x, sia per un WS2812B sia per un WS2815.
• GPIO: il pin dei dati, vedi la tabella qui sotto; Config → Pin Info elenca tutti i pin e cosa li sta usando.
• Length: il numero di LED, 300 nel nostro esempio.
• Color Order: GRB, il valore predefinito, per la maggior parte delle strisce WS2812B. Se il rosso esce verde, prova gli altri.
• Limitatore automatico di luminosità: lascialo attivo. In Maximum PSU Current metti il valore del nostro calcolatore per strisce LED: 18.000 mA per l’alimentatore dimensionato per il bianco pieno del nostro esempio, o 6000 mA per uno dimensionato per gli effetti tipici; WLED accetta da 250 a 65.000 mA. Imposta anche mA/LED come indica il calcolatore: Custom con 60 mA per un WS2812B, o la voce “12mA (WS2815)”.
• I segmenti dividono la striscia in parti con effetto e colore propri; i preset salvano una scena, e Apply preset at boot sceglie il preset da caricare all’accensione.

Pin di strapping e riservati secondo le nostre pagine sui pinout di ESP32, ESP32-C3 SuperMini, ESP32-S3 e D1 mini; pin dell’ESP8266 dalla documentazione di WLED.

Home Assistant

Di solito Home Assistant scopre WLED in rete da solo: compare in Impostazioni → Dispositivi e servizi tra i Rilevati. Altrimenti clicca Aggiungi integrazione, scegli WLED e inserisci il nome host o l’indirizzo IP. L’integrazione richiede WLED 0.14 o successivo.

Avrai un’entità luce per la striscia; con due o più segmenti, una per segmento più una luce principale per accensione e luminosità generale. Ci sono entità di selezione per preset, playlist e palette, entità numeriche per velocità e intensità degli effetti e un’entità di aggiornamento del firmware che propone le versioni stabili di WLED.

Risolvere i problemi

La tinta rosa o arancione in fondo alla striscia è il segno tipico di troppo pochi punti di alimentazione.