---
title: "Shelly Dimmer 2"
description: "Controllo luminosità, commutazione e misurazione dei consumi tramite HTTP locale. Template TapHome per il dimmer Wi-Fi Shelly Dimmer 2."
url: "https://taphome.com/it/compatibility/shelly-dimmer2/"
language: it
lastmod: 2026-03-29
generator: hugo
ai:
  topics: ["http","lighting","wifi","dimmer","power-metering"]
  questions: ["Come integrare lo Shelly Dimmer 2 con TapHome?","Cosa controlla il template TapHome per lo Shelly Dimmer 2?","Come collegare lo Shelly Dimmer 2 via HTTP a TapHome?","Come impostare una transizione graduale della luminosità sullo Shelly Dimmer 2?","Qual è il carico minimo per lo Shelly Dimmer 2?","Perché lo Shelly Dimmer 2 sfarfalla a bassa luminosità?"]
---

# Shelly Dimmer 2

Comunicazione: Packet Parser → HTTP

- [Shelly Dimmer 2 — pagina prodotto](https://kb.shelly.cloud/knowledge-base/shelly-dimmer-2)

> Indirizzo di rete
> 
> TapHome raggiunge il dispositivo all'indirizzo inserito durante l'importazione. Assegna al dispositivo un indirizzo fisso — una prenotazione IP nel router, oppure il suo nome mDNS se lo supporta —, altrimenti l'integrazione smette di funzionare quando il router cambia l'indirizzo.
> 
> [Preparazione della rete](https://taphome.com/it/docs/setup/network-preparation/)

## Guida all'integrazione

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

> [!WARNING]
> 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

> [!WARNING]
> 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](https://www.shelly.com/en/support/shelly-app) (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**

> [!NOTE]
> 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

> [!TIP]
> 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

> [!NOTE]
> 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 3

Questi dispositivi compaiono in TapHome dopo l'importazione.

Shelly Dimmer2 Modulo

Attributi di servizio

|      |
|------|
| WiFi |

Attributi di servizio

Wifi

```taphome
 VAR response := SENDHTTPREQUEST("/settings");
 IF response.IsSuccess
  VAR content := response.Content;
  RETURN(PARSEJSON(content, "$.wifi_sta.ssid"));
  End
```

Luminosità Dimmer Lettura e scrittura

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

numeric Unità: %

Attributi di servizio

|             |
|-------------|
| Transizione |

Azioni di servizio

|             |
|-------------|
| Transizione |

Lettura livello

```taphome
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

```taphome
VAR response := SENDHTTPREQUEST("/light/0?brightness=" + Le*100);
IF response.IsSuccess = false
 ADDERROR(response.StatusCode);
 END
```

Attributi di servizio

Transition

```taphome
 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)

```taphome
 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

Lettura consumo totale

```taphome
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

```taphome
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 Lettura e scrittura

boolean

Valori / Stati: ON · OFF

Lettura stato interruttore

```taphome
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

```taphome
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 • Hostname: `shellydimmer2-{MAC}.local`

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)

## Parametri di importazione

Inserisci questi valori quando importi l'XML.

| Richiesto nell'app | Predefinito   |
|--------------------|---------------|
| Indirizzo IP       | `192.168.0.1` |

## Fonti

- Shelly Gen1 API Reference
  
  [shelly-api-docs.shelly.cloud](https://shelly-api-docs.shelly.cloud/gen1/) 2026-03-12
- Home Assistant Shelly Integration
  
  [www.home-assistant.io](https://www.home-assistant.io/integrations/shelly/) 2026-03-12
- Shelly Dimmer 2 Knowledge Base
  
  [kb.shelly.cloud](https://kb.shelly.cloud/knowledge-base/shelly-dimmer-2) 2026-03-29
- Shelly Dimmer 2 API Reference (Gen1)
  
  [shelly-api-docs.shelly.cloud](https://shelly-api-docs.shelly.cloud/gen1/#shelly-dimmer-dimmer2) 2026-03-29

## Documentazione correlata

- [Integrazione Packet Parser](https://taphome.com/it/compatibility/packet-parser-guide/)
- [Packet Parser (HTTP, TCP, UDP, FTP, MQTT)](https://taphome.com/it/docs/integration/packet-parser/)
- [Funzioni Packet parser](https://taphome.com/it/docs/script/packet-parser/)
- [Funzioni di parsing](https://taphome.com/it/docs/script/parsing-functions/)