
Shelly RGBW2 è un controller Wi-Fi per strisce LED con quattro uscite PWM (12/24 V DC). In modalità White, le quattro uscite — normalmente usate per i canali R, G, B e W di una striscia RGBW — diventano quattro canali dimmer monocromatici indipendenti. Ogni canale può pilotare la propria striscia LED bianca, lampadina LED o gruppo di faretti. TapHome comunica con il dispositivo via HTTP sulla rete locale; non è richiesta alcuna connessione cloud.
Questo template è il corrispettivo in modalità White del template Shelly RGBW2 in modalità Color. Entrambi i template condividono lo stesso hardware ma il firmware opera in modalità mutualmente esclusive selezionate dalle impostazioni del dispositivo. Prima di importare questo template, il dispositivo deve essere configurato in modalità White — il template valida la modalità a ogni interrogazione e mostra un errore se il dispositivo è impostato su Color.
Shelly ha contrassegnato RGBW2 come dismesso — non è più prodotto né venduto dal Gruppo Shelly. Le unità esistenti continuano a funzionare e ricevono aggiornamenti firmware.
Cablaggio
Shelly RGBW2 è alimentato da una fonte 12 V o 24 V DC (V+ / GND). Ognuna delle quattro uscite (contrassegnate R, G, B, W sul dispositivo) pilota un carico LED bianco. Schemi di cablaggio tipici per la modalità White:
- Quattro strisce LED o lampadine bianche indipendenti — ogni canale controlla una striscia/lampadina, anodo comune (+) su V+
- Più faretti per canale — diversi faretti 12/24 V cablati in parallelo per uscita
- Due strisce bianche con potenza raddoppiata — due canali abbinati per striscia (in parallelo) per raddoppiare la potenza in uscita
I limiti di carico per canale (dalla specifica Shelly) sono 45 W a 12 V e 90 W a 24 V. Il carico combinato su tutti e quattro i canali non deve superare 144 W a 12 V o 288 W a 24 V.
Configurazione
Il template si connette via Wi-Fi. Durante l’importazione del template in TapHome, inserire l’indirizzo IP del dispositivo (placeholder predefinito 192.168.0.1) e un transition time opzionale in millisecondi (predefinito 300).
Il transition time controlla la velocità con cui ogni canale transita tra i livelli di luminosità. Viene inviato con ogni comando di scrittura e definisce anche la finestra di debounce — il template ignora i valori di luminosità interrogati per transitionTime + 500 ms dopo ogni scrittura per evitare letture obsolete durante una transizione.
Cambio di modalità
Se il dispositivo è attualmente in modalità Color, passarlo in modalità White prima di importare questo template. Oppure:
- Aprire l’interfaccia web Shelly su
http://{device-ip}e modificare la modalità operativa nelle impostazioni, oppure - Inviare direttamente
GET /settings?mode=white, oppure - Importare temporaneamente il template Color, utilizzare la sua service action Set mode White, quindi reimportare questo template White
Il cambio di modalità richiede un riavvio del dispositivo. Dopo il riavvio, reimportare il template White in TapHome.
Funzionalità del dispositivo
Quattro dimmer indipendenti
Il template espone quattro canali dimmer indipendenti, uno per ciascuna uscita PWM:
| Canale | Pin di uscita | Endpoint | Intervallo polling |
|---|---|---|---|
| Ch1 | R | /light/0 | 2,5 s |
| Ch2 | G | /light/1 | 2,5 s |
| Ch3 | B | /light/2 | 2,5 s |
| Ch4 | W | /light/3 | 2,5 s |
Ogni dimmer legge lights[N].ison e lights[N].brightness (0–100, normalizzati su 0–1) dalla risposta /status. I comandi di scrittura usano /light/N?turn=on|off&brightness=VALUE&transition=T. Il template usa l’endpoint legacy /light/{idx}, che il firmware Shelly accetta come alias dell’endpoint attuale /white/{idx}.
Misurazione energetica per canale
Ogni canale ha un proprio contatore energetico — da Electric Meter Ch1 a Electric Meter Ch4 — che legge da meters[0] a meters[3]:
- Potenza istantanea —
meters[N].powerin watt, convertita in kW - Consumo totale —
meters[N].totalin watt-minuti, convertito in kWh
Il canale 1 viene interrogato ogni 2,5 s insieme al suo dimmer; i canali 2–4 vengono interrogati a intervalli di 15 s per ridurre il carico sullo stack HTTP Gen1 (che tollera solo due connessioni simultanee).
Diagnostica di servizio
Il template espone 10 attributi di servizio per il monitoraggio del dispositivo:
- Rete — indirizzo IP, indirizzo MAC (formattato con due punti), intensità del segnale Wi-Fi (dB)
- Connettività — cloud abilitato/connesso, MQTT connesso
- Info dispositivo — ora del dispositivo, tempo di attività (formattato come giorni/ore/minuti), utilizzo RAM
- Firmware — aggiornamento firmware disponibile
Service action
Sono disponibili tre service action:
- Abilita cloud — abilita o disabilita la connettività Shelly Cloud
- Riavvio — attiva un riavvio del dispositivo
- Imposta modalità White — scrive
/settings?mode=whiteper forzare la modalità operativa White (utile dopo un ripristino di fabbrica o se qualcuno ha cambiato la modalità tramite l’app Shelly)
L’API Shelly Cloud non è utilizzata da questo template — la comunicazione avviene esclusivamente tramite polling HTTP locale.
Risoluzione problemi
Il dispositivo non risponde
- Verificare che Shelly sia connesso al Wi-Fi e abbia un indirizzo IP valido
- Provare a usare l’hostname mDNS (
shellyrgbw2-AABBCCDDEE.local) invece dell’indirizzo IP — l’IP potrebbe essere cambiato dopo un rinnovo DHCP - Aprire
http://{device-ip}/shellyin un browser — se risponde, il dispositivo è raggiungibile - Verificare che TapHome CCU e Shelly siano sulla stessa rete / VLAN
Errore „Mode White is not supported"
Questo errore indica che il dispositivo è attualmente impostato in modalità Color. Per risolvere:
- Aprire l’interfaccia web Shelly su
http://{device-ip}e passare la modalità operativa a White, oppure - Inviare direttamente
GET /settings?mode=whiteda un browser o curl, oppure - Se è stato importato il template in modalità Color, eseguire la service action Imposta modalità White da lì
- Il dispositivo deve riavviarsi dopo un cambio di modalità — attendere qualche secondo e ricaricare TapHome
Le letture di potenza mostrano zero
- Confermare che le LED bianche siano collegate all’uscita Shelly RGBW2 pertinente (pin R, G, B o W)
- Aprire l’app Shelly o l’interfaccia web e verificare che il modello del dispositivo sia configurato in Settings -> Device Model — senza di esso il contatore restituisce zero
- Verificare che il canale sia acceso — il contatore legge solo quando scorre corrente attraverso l’uscita
- Interrogare manualmente
/statuse confermare chemeters[N].powerrestituisca un valore diverso da zero per il canale in questione
Il canale non dimmera in modo fluido
- Verificare che il parametro transition time corrisponda al comportamento atteso — il valore predefinito di 300 ms è una dissolvenza breve; valori più lunghi (es. 1500 ms) producono transizioni più lente
- Ricordare che la finestra di debounce è uguale a
transitionTime + 500 ms— le modifiche inviate più velocemente possono essere accorpate - Verificare che il carico LED sia dimmerabile (alcuni driver non sono compatibili con PWM) e che l’alimentazione fornisca un 12/24 V DC stabile
I dispositivi Shelly Gen1 supportano solo 2 connessioni HTTP simultanee. Se TapHome e un altro sistema (es. Home Assistant) interrogano lo stesso dispositivo contemporaneamente, la comunicazione può diventare inaffidabile. Mantenere l’intervallo di polling a 10–30 secondi per ogni client aggiuntivo.