--- title: "Shelly Plus 1" description: "Shelly Plus 1 in TapHome via HTTP RPC API Gen2+ sulla rete locale, senza cloud: un relè a contatti puliti fino a 16 A. Basta l'indirizzo IP." url: "https://taphome.com/it/compatibility/shelly-plus-1/" language: it lastmod: 2026-03-29 generator: hugo ai: topics: ["http","i/o-module","wifi","relay","switch","gen2plus"] questions: ["Come integrare Shelly Plus 1 con TapHome?","Come collegare Shelly Plus 1 tramite HTTP a TapHome?","Shelly Plus 1 supporta il monitoraggio della potenza in TapHome?","Qual è la differenza tra Shelly Plus 1 e Plus 1PM in TapHome?","Shelly Plus 1 può commutare carichi DC tramite TapHome?","Come risolvere il problema quando Shelly Plus 1 non risponde in TapHome?"] --- # Shelly Plus 1 Comunicazione: Packet Parser → HTTP - [Shelly Plus 1 pagina prodotto](https://www.shelly.com/en/products/shop/shelly-plus-1) - [Shelly Plus 1 documentazione API](https://shelly-api-docs.shelly.cloud/gen2/) Lo Shelly Plus 1 è un interruttore relè Wi-Fi compatto con contatti puliti. Si installa dietro un interruttore a parete standard e può controllare un circuito fino a 16 A (3500 W a 230 V AC) o 10 A (30 V DC). Il dispositivo supporta un'ampia gamma di alimentazione — 110-240 VAC, 24-48 VDC o 12 VDC — rendendolo adatto sia per installazioni a tensione di rete che a bassa tensione. TapHome comunica con il dispositivo via HTTP utilizzando l'API RPC Gen2+ sulla rete locale — non è richiesta alcuna connessione cloud. Il template fornisce un singolo interruttore relè. A differenza del Plus 1PM, questo dispositivo non dispone di misurazione della potenza integrata. ## Configurazione Lo Shelly Plus 1 si connette tramite Wi-Fi. Durante l'importazione del template in TapHome, inserisci l'indirizzo IP del dispositivo (valore predefinito `192.168.0.1`). Il dispositivo utilizza l'API JSON-RPC Gen2+. Tutta la comunicazione avviene tramite richieste HTTP GET agli endpoint `/rpc/` sulla porta 80. ## Funzionalità del dispositivo ### Controllo relè Il template espone il relè come dispositivo interruttore. Lo stato del relè viene letto dalla risposta di `/rpc/Switch.GetStatus?id=0` (campo `output`, boolean) e controllato tramite `/rpc/Switch.Set?id=0` con `on=true` o `on=false`. L'intervallo di polling è di 2,5 secondi, fornendo un feedback dello stato quasi in tempo reale in TapHome. ### Funzionalità aggiuntive Lo Shelly Plus 1 espone tramite l'API RPC anche la temperatura interna del relè, lo stato dell'ingresso fisico, l'indirizzo MAC del dispositivo, il tempo di attività, l'utilizzo RAM, l'ora del dispositivo, l'indirizzo IP, il nome della rete Wi-Fi e l'intensità del segnale Wi-Fi. Sono disponibili anche un timer di spegnimento automatico (parametro `toggle_after`) e azioni di riavvio dispositivo/aggiornamento firmware. Queste funzionalità potranno essere aggiunte in un futuro aggiornamento del template. > [!NOTE] > Lo Shelly Plus 1 **non** dispone di misurazione della potenza. Se hai bisogno del monitoraggio energetico, utilizza invece lo Shelly Plus 1PM — ha lo stesso fattore di forma e le stesse capacità relè, ma aggiunge misurazione di potenza istantanea, tensione, corrente ed energia cumulativa. ## 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 (`shellyplus1-AABBCCDDEE.local`) invece dell'indirizzo IP — l'IP potrebbe essere cambiato dopo un rinnovo DHCP 3. Apri `http://{ip-dispositivo}/rpc/Shelly.GetDeviceInfo` nel browser — se risponde con JSON, il dispositivo è raggiungibile 4. Verifica che TapHome CCU e Shelly siano sulla stessa rete / VLAN 5. Assicurati che l'autenticazione HTTP Digest sia disabilitata nell'interfaccia web dello Shelly — TapHome non supporta richieste autenticate ### Il relè non commuta 1. Controlla la modalità di ingresso nell'interfaccia web dello Shelly (impostazione `in_mode`) — se impostato su `detached`, l'interruttore fisico non influenza il relè, ma i comandi HTTP dovrebbero comunque funzionare 2. Interroga manualmente `/rpc/Switch.GetStatus?id=0` e verifica che il campo `output` cambi durante la commutazione 3. Controlla il campo `source` nella risposta di stato per vedere cosa ha controllato il relè per ultimo ### Risposta lenta o timeout 1. I dispositivi Gen2+ supportano fino a 6 connessioni HTTP simultanee (contro 2 su Gen1) — evita però il polling eccessivo da più sistemi 2. Disabilita la modalità ECO nell'interfaccia web dello Shelly se abilitata — mette il dispositivo in modalità sleep tra i polling e può causare timeout con intervalli di polling brevi 3. Utilizza un IP statico o una prenotazione DHCP per evitare cambi di indirizzo ## 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-.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 Shelly Plus 1 Modulo Variabili personalizzate | | |-------------------| | `status` (string) | Interruttore Interruttore Controllo relè a canale singolo — commutazione on/off tramite API RPC boolean Valori / Stati: ON · OFF **Connessione:** Packet Parser → HTTP • Hostname: `shellyplus1-{MAC}.local` Possibili miglioramenti (12) - Switch Temperature — Internal relay temperature in °C, available in Switch.GetStatus response - Input State — Physical switch/button input state, available via /rpc/Input.GetStatus?id=0 - MAC Address — Device MAC address, available in Sys.GetStatus response - Uptime — Seconds since last reboot, available in Sys.GetStatus response - RAM Usage — Total and free RAM in bytes, available in Sys.GetStatus response - Device Time — Current device time in HH:MM format, available in Sys.GetStatus response - IP Address — Device station IP address, available in WiFi.GetStatus response - WiFi SSID — Connected WiFi network name, available in WiFi.GetStatus response - WiFi Signal Strength — WiFi RSSI in dBm, available in WiFi.GetStatus response - Auto-off Timer — Auto-reset timer in seconds via toggle\_after parameter, could be added as switch parameter - Reboot — Triggers device reboot, could be added as service action - Firmware Update — Initiates OTA firmware update to stable or beta channel ## Fonti - Shelly Gen2+ RPC API Reference [shelly-api-docs.shelly.cloud](https://shelly-api-docs.shelly.cloud/gen2/) 2026-03-29 - Shelly Gen2+ Switch Component API [shelly-api-docs.shelly.cloud](https://shelly-api-docs.shelly.cloud/gen2/ComponentsAndServices/Switch/) 2026-03-29 - Shelly Gen2+ System Component API [shelly-api-docs.shelly.cloud](https://shelly-api-docs.shelly.cloud/gen2/ComponentsAndServices/Shelly/) 2026-03-29 - Shelly Gen2+ WiFi Component API [shelly-api-docs.shelly.cloud](https://shelly-api-docs.shelly.cloud/gen2/ComponentsAndServices/Wifi/) 2026-03-29 - Shelly Plus 1 Knowledge Base [kb.shelly.cloud](https://kb.shelly.cloud/knowledge-base/shelly-plus-1) 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/)