TapHome

Shelly Dimmer 2

Packet Parser → HTTP
Inviato da
Ultimo aggiornamento: 03. 2026
Shelly Dimmer 2

Lo Shelly Dimmer 2 è un modulo dimmer Wi-Fi compatto progettato per l’installazione dietro l’interruttore. Supporta LED dimmerabili (10 – 200 W), lampadine a incandescenza/alogene (10 – 220 W) e trasformatori ferromagnetici. TapHome comunica con il dispositivo tramite HTTP sulla rete locale — non è necessaria alcuna connessione cloud.

Il template fornisce controllo della luminosità con transizione graduale configurabile, un interruttore luce e un misuratore di energia che legge la potenza istantanea e il consumo totale.

Configurazione

Lo Shelly Dimmer 2 si connette tramite Wi-Fi. Durante l’importazione del template in TapHome, inserisci l’indirizzo IP del dispositivo (segnaposto predefinito 192.168.0.1).

Il dispositivo supporta quattro configurazioni di cablaggio:

  • Con neutro — installazione standard utilizzando i morsetti N, L, SW1, SW2, O
  • Senza neutro, carico minimo 10 W — senza collegamento del neutro, richiede almeno 10 W di carico
  • Senza neutro + Shelly Bypass — per carichi inferiori a 10 W è necessario il modulo Shelly Bypass
  • Neutro commutato — cablaggio alternativo con linea di neutro commutata

Al di sotto del carico minimo (10 W con neutro, 20 W senza), il dimmer potrebbe sfarfallare o non accendersi. Per carichi a bassa potenza senza neutro, utilizza il modulo Shelly Bypass.

Funzionalità del dispositivo

Controllo della luminosità

Il template espone un dispositivo dimmer che legge il livello di luminosità da /light/0 (campo brightness, 0 – 100 %) e lo imposta tramite /light/0?brightness={valore}. Il valore viene normalizzato internamente — l’API usa 0 – 100 % mentre TapHome lavora con l’intervallo 0,0 – 1,0.

L’attributo di servizio Transition mostra la durata attuale della transizione in millisecondi. L’azione di servizio Transition consente di impostare una transizione graduale della luminosità (0 – 5000 ms) per singoli comandi tramite /light/0?transition={ms}.

Interruttore luce

Lo stato on/off della luce viene controllato indipendentemente dal livello di luminosità. Il template legge ison da /light/0 e scrive tramite /light/0?turn=on o /light/0?turn=off. Il dispositivo ha il flag di capacità lighting — in TapHome appare come interruttore luce, non come relè generico.

Misurazione della potenza

Il misuratore di energia integrato legge due valori dalla risposta /status:

  • Potenza istantanea — meters[0].power in watt, convertita in kW dal template
  • Consumo totale — meters[0].total in watt-minuti, convertito in kWh dal template

Il misuratore è in sola lettura e si aggiorna automaticamente ad ogni ciclo di polling (intervallo di 15 secondi).

Diagnostica di servizio

L’attributo di servizio WiFi a livello di modulo legge l’SSID connesso da /settings.

Funzionalità aggiuntive

Lo Shelly Dimmer 2 fornisce nella risposta /status anche la temperatura interna, lo stato della protezione da surriscaldamento, la validità della misurazione, l’intensità del segnale WiFi e due ingressi fisici per interruttori (SW1, SW2). Tramite API sono disponibili una modalità notturna con limitazione programmata della luminosità e un dimming incrementale a gradini. Per i singoli comandi è possibile impostare un timer di spegnimento automatico. Queste funzionalità potranno essere aggiunte in un futuro aggiornamento del template.

Risoluzione dei problemi

Il dispositivo non risponde
  1. Verifica che lo Shelly sia connesso al Wi-Fi e abbia un indirizzo IP valido
  2. Prova a utilizzare l’hostname mDNS (shellydimmer2-AABBCCDDEE.local) al posto dell’indirizzo IP — l’IP potrebbe essere cambiato dopo un rinnovo DHCP
  3. Apri http://{ip-dispositivo}/shelly nel browser — se risponde, il dispositivo è raggiungibile
  4. Controlla che TapHome CCU e Shelly siano sulla stessa rete / VLAN
Sfarfallio o dimming instabile
  1. Verifica che il carico collegato soddisfi il requisito di potenza minima (10 W con neutro, 20 W senza)
  2. Controlla che il tipo di carico sia supportato — non tutti i driver LED sono compatibili con i dimmer a taglio di fase posteriore
  3. Regola l’impostazione min_brightness tramite /settings/light/0 se la luce sfarfalla a livelli bassi
  4. Aumenta il tempo di warm_up (0 – 1000 ms) in /settings/light/0 per carichi che necessitano di un periodo di avvio
La misurazione della potenza mostra zero
  1. Verifica che il carico sia collegato attraverso il dimmer (non bypassato)
  2. Controlla che la luce sia accesa — il misuratore rileva solo quando scorre corrente
  3. Esegui manualmente una richiesta a /status e verifica che meters[0].power restituisca un valore diverso da zero

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 potrebbe diventare inaffidabile. Usa un intervallo di polling di 10 – 30 secondi.

Come installare in TapHome

Prerequisiti

  • Dispositivo Shelly installato e acceso
  • Rete Wi-Fi locale (2,4 GHz)
  • TapHome CCU sulla stessa rete

Passaggio 1 — Collegare Shelly al Wi-Fi

Opzione A — App Shelly (consigliata):

  1. Scarica l’app Shelly (iOS / Android)
  2. Tocca + → Add Device e segui la procedura guidata di associazione Bluetooth
  3. Inserisci le credenziali Wi-Fi quando richiesto

Opzione B — Modalità AP (senza app):

  1. Al primo avvio il dispositivo crea un hotspot: ShellyXXX-AABBCCDDEE
  2. Collega il tuo telefono/PC a questo hotspot
  3. Apri http://192.168.33.1 → Internet & Security → Wi-Fi Mode - Client
  4. Inserisci SSID e password → Save

Shelly supporta solo reti a 2,4 GHz. Le reti a 5 GHz non appariranno nella scansione.

Passaggio 2 — Trovare l’indirizzo IP

Dopo la connessione al Wi-Fi, trova l’indirizzo IP assegnato tramite uno di questi metodi:

  • App Shelly: Dettaglio dispositivo → Device info → Indirizzo IP
  • Interfaccia web Shelly: Connettiti all’AP del dispositivo prima della configurazione Wi-Fi — l’IP viene mostrato dopo il salvataggio
  • Tabella DHCP del router: Cerca un hostname come shelly1pm-AABBCCDDEE
  • mDNS: Esegui il ping di shelly<model>-<mac>.local (es. shelly1pm-AABBCCDDEE.local) dalla stessa rete

Assegna un IP statico (prenotazione DHCP) nel tuo router per il dispositivo Shelly per evitare che l’indirizzo cambi dopo un riavvio del router.

Passaggio 3 — Configurazione in TapHome

  1. In TapHome, aggiungi un nuovo modulo Packet Parser (HTTP)
  2. IP Address: inserisci l’IP dal passaggio 2 (es. 192.168.1.50)
  3. Port: 80 (predefinito, nessuna modifica necessaria)
  4. Importa il template — TapHome interrogherà periodicamente /status per leggere lo stato del dispositivo

L’autenticazione HTTP è disabilitata per impostazione predefinita sui dispositivi Shelly. Se hai abilitato la protezione con accesso, TapHome attualmente non supporta HTTP Basic Auth — mantieni l’autenticazione disabilitata per l’integrazione con TapHome.

Dispositivi disponibili

Shelly Dimmer2 Modulo
Attributi di servizio
WiFi

Shelly Dimmer2

Attributi di servizio
Wifi
 VAR response := SENDHTTPREQUEST("/settings");
 IF response.IsSuccess
  VAR content := response.Content;
  RETURN(PARSEJSON(content, "$.wifi_sta.ssid"));
  End
Luminosità Dimmer

Livello dimmer 0 – 100 % con transizione graduale configurabile (0 – 5000 ms)

numeric Unità: %
Attributi di servizio
Transizione
Azioni di servizio
Transizione

Luminosità

Lettura livello
VAR response := SENDHTTPREQUEST("/light/0");
 IF response.IsSuccess
  VAR content := response.Content;
  RETURN(PARSEJSON(content, "brightness")/100);
 ELSE
  ADDERROR(response.StatusCode + " (" + response.ReasonPhrase + ")");
  RETURN(NaN);
 END
Scrittura livello
VAR response := SENDHTTPREQUEST("/light/0?brightness=" + Le*100);
IF response.IsSuccess = false
 ADDERROR(response.StatusCode);
 END
Attributi di servizio
Transition
 VAR response := SENDHTTPREQUEST("/light/0");
 IF response.IsSuccess
  VAR content := response.Content;
  RETURN(PARSEJSON(content, "transition") + " ms");
 END
Azioni di servizio
Transition
Parametri: Transition time [ms] (0–5000 G)
 VAR response := SENDHTTPREQUEST("/light/0?transition=" + G);
Contatore elettrico Contatore elettrico Solo lettura

Misurazione consumo energetico — potenza istantanea (kW) ed energia cumulativa (kWh)

numeric Unità: W / kWh

Contatore elettrico

Lettura consumo totale
VAR response := SENDHTTPREQUEST("/status");
 IF response.IsSuccess
  VAR content := response.Content;
 VAR responseHeaders := response.Headers;
 RETURN(PARSEJSON(content, "$..meters..total")/60000);
 ELSE 
 ADDERROR(response.StatusCode + " (" + response.ReasonPhrase + ")");
  RETURN(NaN);
 END
Lettura domanda
VAR response := SENDHTTPREQUEST("/status");
 IF response.IsSuccess
  VAR content := response.Content;
 VAR responseHeaders := response.Headers;
 RETURN(PARSEJSON(content, "$..meters..power")/1000);
 ELSE 
 ADDERROR(response.StatusCode + " (" + response.ReasonPhrase + ")");
  RETURN(NaN);
 END
Luce Interruttore
boolean
Valori / Stati: ON · OFF

Luce

Lettura stato interruttore
VAR response := SENDHTTPREQUEST("/light/0");
 IF response.IsSuccess
  VAR content := response.Content;
  RETURN(PARSEJSON(content, "ison"));
 ELSE
  ADDERROR(response.StatusCode + " (" + response.ReasonPhrase + ")");
  RETURN(NaN);
 END
Scrittura stato interruttore
var Ru := Switch(St, 1, "on", "off");
 VAR response := SENDHTTPREQUEST("/light/0?turn=" + Ru);
 IF response.IsSuccess = false
  ADDERROR(response.StatusCode);
 END
Connessione: Packet Parser → HTTP
Possibili miglioramenti (9)
  • Brightness (via /status) — Current brightness also available in /status → lights[0].brightness; template uses /light/0 instead
  • Meter Validity — Measurement validity flag, available in /status response
  • Internal Temperature — Internal device temperature in °C, available in /status response
  • Overtemperature Protection — Overtemperature protection triggered flag, threshold 95°C
  • Night Mode — Night mode with start/end time and max brightness — configurable via /settings/night_mode
  • Switch Inputs (SW1, SW2) — Two physical switch inputs available in /status → inputs[0].input and inputs[1].input
  • WiFi Signal Strength — WiFi RSSI in dBm, available in /status response
  • Auto-off Timer — Auto-off timer in seconds, could be added as service action parameter
  • Incremental Dimming — Step-based dimming (dim up/down/stop with configurable step size 1-100)

Fonti