--- title: "Shelly Plug S" description: "Shelly Plug S presa intelligente Wi-Fi con misurazione dell'energia. Monitora i consumi elettrici e controlla i dispositivi da remoto via HTTP da TapHome." url: "https://taphome.com/it/compatibility/shelly-plug-s/" language: it lastmod: 2026-10-08 generator: hugo ai: topics: ["http","smart-plug","electric-meter","wifi","relay","power-metering"] questions: ["Come integrare Shelly Plug S con TapHome?","Cosa misura il template Shelly Plug S in TapHome?","Come collegare Shelly Plug S via HTTP a TapHome?","Perché Shelly Plug S mostra potenza zero?","TapHome può monitorare la temperatura interna di Shelly Plug S?","Cosa succede quando Shelly Plug S si surriscalda?"] --- # Shelly Plug S Comunicazione: Packet Parser → HTTP - [Knowledge base Shelly Plug S](https://kb.shelly.cloud/knowledge-base/shelly-plug-s) Shelly Plug S è una presa intelligente Wi-Fi compatta con misuratore di potenza integrato. Si inserisce direttamente in una presa a muro e può commutare carichi fino a 10 A (2300 W a 230 V). TapHome comunica con il dispositivo via HTTP sulla rete locale — non è richiesta nessuna connessione cloud. Il template fornisce il controllo on/off del relè, un misuratore di energia che legge la potenza in tempo reale e il consumo cumulativo, e il monitoraggio della temperatura interna. ## Funzionalità del dispositivo ### Controllo relè Il template espone il relè della presa come un interruttore. Lo stato del relè viene letto da `/settings/relay/0` (campo `ison`) e controllato tramite l'endpoint `/relay/0` con `turn=on` o `turn=off`. L'intervallo di polling per l'interruttore è 1 secondo. > [!NOTE] > Il template legge lo stato dell'interruttore da `/settings/relay/0` (configurazione persistente) anziché da `/status` (stato in tempo reale). In condizioni normali entrambi restituiscono lo stesso valore, ma `/settings` può avere dati leggermente in ritardo dopo commutazioni rapide. ### Misurazione della potenza Il misuratore di energia integrato legge due valori dall'endpoint `/meter/0`: - **Potenza in tempo reale** — campo `power` in watt, convertito in kW dal template - **Consumo totale** — campo `total` in watt-minuti, convertito in kWh dal template Il misuratore è in sola lettura e si aggiorna ogni 15 secondi (intervallo di polling configurabile). ### Monitoraggio della temperatura Il dispositivo interruttore include un attributo di servizio che legge la temperatura interna della presa dall'endpoint `/status`. Questo permette di monitorare la temperatura del dispositivo direttamente in TapHome senza configurazione aggiuntiva. ## Funzioni non implementate L'API di Shelly Plug S espone funzionalità aggiuntive non incluse nel template attuale: - **Flag surriscaldamento** — spegnimento automatico del relè a ~95 °C (`overtemperature` in `/status`) - **Controllo LED** — abilitazione/disabilitazione del LED di stato tramite `/settings` - **Soglia di protezione da sovraccarico** — limite di potenza massima configurabile (predefinito 2300 W) - **Timer di spegnimento automatico** — spegnimento automatico del relè dopo un tempo impostato - **Intensità segnale Wi-Fi** — valore RSSI in dBm da `/status` - **Riavvio** — riavvio del dispositivo tramite l'endpoint `/reboot` Queste funzioni possono essere aggiunte in un futuro aggiornamento del template come attributi o azioni di servizio. ## Risoluzione dei problemi ### Il dispositivo non risponde 1. Verificare che lo Shelly sia connesso al Wi-Fi e abbia un indirizzo IP valido 2. Aprire `http://{device-ip}/shelly` nel browser — se risponde, il dispositivo è raggiungibile 3. Verificare che TapHome CCU e Shelly siano sulla stessa rete / VLAN ### La misurazione della potenza mostra zero 1. Confermare che il dispositivo collegato allo Shelly Plug S sia acceso 2. Verificare che il relè sia attivato — il misuratore legge solo quando scorre corrente 3. Interrogare manualmente `/meter/0` e verificare che il campo `power` restituisca un valore diverso da zero ### Spegnimento per surriscaldamento Lo Shelly Plug S dispone di protezione termica interna. Se la temperatura del dispositivo supera ~95 °C, il relè si spegne automaticamente. Assicurare una ventilazione adeguata intorno alla presa, specialmente quando si commutano dispositivi ad alto assorbimento. > [!WARNING] > I dispositivi Shelly Gen1 supportano solo **2 connessioni HTTP contemporanee**. Se TapHome e un altro sistema (es. Home Assistant) interrogano lo stesso dispositivo simultaneamente, la comunicazione potrebbe diventare inaffidabile. Se anche un altro sistema interroga il dispositivo, aumentare gli intervalli di polling del template (per default 1 s per l'interruttore, 15 s per il contatore) per ridurre la contesa delle connessioni. ## 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 Plug S Modulo Variabili personalizzate Contatore elettrico Contatore elettrico Solo lettura Misurazione consumo energetico — potenza istantanea (kW) ed energia cumulativa (kWh) numeric Unità: kW / kWh Interruttore Interruttore boolean Valori / Stati: ON · OFF **Connessione:** Packet Parser → HTTP • Hostname: `shellyplug-s-{MAC}.local` Possibili miglioramenti (7) - Live relay state — Template reads from /settings/relay/0 instead of /status — /status has real-time state - Overtemperature flag — Boolean flag in /status, triggers automatic relay shutdown at ~95°C - LED control — Enable/disable status LED via settings endpoint - Overpower protection threshold — Configurable maximum power limit (default 2300W), could be a service action - Auto-off timer — Auto-off timer in seconds, could be added as switch parameter - WiFi signal strength — WiFi RSSI in dBm, available in /status response - Reboot — Device reboot endpoint, could be added as service action ## Fonti - Shelly Gen1 API Reference [shelly-api-docs.shelly.cloud](https://shelly-api-docs.shelly.cloud/gen1/) 2026-03-12 - Shelly Gen1 General Setup [kb.shelly.cloud](https://kb.shelly.cloud/knowledge-base/shelly-devices-general-setup) 2026-03-12 - Shelly Gen1 HTTP Integration [kb.shelly.cloud](https://kb.shelly.cloud/knowledge-base/shelly-http-integration) 2026-03-12 - Shelly Plug S Knowledge Base [kb.shelly.cloud](https://kb.shelly.cloud/knowledge-base/shelly-plug-s) 2026-03-13 - Shelly Plug S API Endpoints [shelly-api-docs.shelly.cloud](https://shelly-api-docs.shelly.cloud/gen1/#shelly-plug-plugs) 2026-03-13 ## 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/)