TapHome

Shelly Plus 1

Packet Parser → HTTP
Inviato da
Ultimo aggiornamento: 03. 2026
Shelly Plus 1

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.

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 (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 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

Interruttore

Lettura stato interruttore
var x := (sendhttprequest("/rpc/Switch.GetStatus?id=0"));
status := x.Content;
return(PARSEJSON(status, "$.output", true));
Scrittura stato interruttore
VAR response := SENDHTTPREQUEST("rpc/Switch.Set?id=0&on=" + if(St,"true","false"));
IF response.IsSuccess = false
  ADDERROR(response.StatusCode);
END
Connessione: Packet Parser → HTTP
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