--- title: "Shelly 1PM" description: "Relay Wi-Fi Shelly 1PM con misurazione della potenza. Controlla un singolo circuito e monitora il consumo energetico in tempo reale tramite HTTP da." url: "https://taphome.com/it/compatibility/shelly-1pm/" language: it lastmod: 2026-03-12 generator: hugo ai: topics: ["http","electric-meter","wifi","relay","power-metering"] questions: ["Come integrare Shelly 1PM con TapHome?","Cosa misura il template TapHome per Shelly 1PM?","Come connettere Shelly 1PM a TapHome tramite HTTP?","Perché Shelly 1PM mostra valori di potenza pari a zero?","Come impostare il limite di protezione della potenza su Shelly 1PM tramite TapHome?","Quali informazioni diagnostiche sono disponibili per Shelly 1PM in TapHome?"] --- # Shelly 1PM Comunicazione: Packet Parser → HTTP - [Pagina prodotto Shelly 1PM](https://www.shelly.com/en/products/shop/shelly-1pm) - [Documentazione API Shelly 1PM](https://shelly-api-docs.shelly.cloud/gen1/#shelly1-1pm) Lo Shelly 1PM è un relè Wi-Fi compatto con misurazione della potenza integrata. Si installa dietro un normale interruttore a parete e può controllare un circuito fino a 16 A (3500 W a 230 V). TapHome comunica con il dispositivo tramite HTTP sulla rete locale — non è richiesta alcuna connessione cloud. Il template fornisce il controllo del relè e un contatore di energia che legge il consumo di potenza in tempo reale e l'energia cumulativa utilizzata. ## Configurazione Lo Shelly 1PM si connette tramite Wi-Fi. Durante l'importazione del template TapHome, inserire l'indirizzo IP del dispositivo (segnaposto predefinito `192.168.0.1`). ## Capacità del dispositivo ### Controllo relè Il template espone il relè come dispositivo interruttore. Lo stato del relè viene letto dalla risposta `/status` (`relays[0].ison`) e controllato tramite l'endpoint `/relay/0` con `turn=on` o `turn=off`. ### Misurazione della potenza Il contatore di energia integrato legge due valori dalla risposta `/status`: - **Potenza in tempo reale** — `meters[0].power` riportata in watt, convertita in kW dal template - **Consumo totale** — `meters[0].total` riportato in watt-minuti, convertito in kWh dal template Il contatore è di sola lettura — si aggiorna automaticamente a ogni ciclo di polling. ### Diagnostica di servizio Il template espone 13 attributi di servizio per il monitoraggio del dispositivo: - **Informazioni dispositivo** — nome host, indirizzo MAC, ora del dispositivo, uptime, utilizzo RAM - **Protezione termica** — temperatura interna (°C), stato temperatura (Normale / Alta / Molto Alta), flag di sovratemperatura - **Connettività** — cloud abilitato/connesso, MQTT connesso, aggiornamento firmware disponibile - **Protezione di potenza** — limite di potenza massima corrente (letto da `/settings`) ### Azioni di servizio Sono disponibili tre azioni di servizio: - **Imposta protezione di potenza** — imposta il limite di potenza massima (1–3500 W). Il relè si spegne automaticamente se il consumo supera questo valore. - **Abilita cloud** — abilita o disabilita la connettività Shelly Cloud - **Riavvia** — avvia il riavvio del dispositivo ### Capacità aggiuntive Lo Shelly 1PM espone anche la tensione di linea, la potenza reattiva, lo stato dell'ingresso fisico e la potenza del segnale Wi-Fi nella risposta `/status`. Un timer di spegnimento automatico è disponibile sull'endpoint del relè. Queste funzionalità potranno essere aggiunte in un futuro aggiornamento del template. ## Risoluzione dei problemi ### Il dispositivo non risponde 1. Verificare che lo Shelly sia connesso al Wi-Fi e abbia un indirizzo IP valido 2. Provare a usare il nome host mDNS (`shelly1pm-AABBCCDDEE.local`) al posto dell'indirizzo IP — l'IP potrebbe essere cambiato dopo un rinnovo DHCP 3. Aprire `http://{device-ip}/shelly` in un browser — se risponde, il dispositivo è raggiungibile 4. Verificare che TapHome CCU e Shelly siano sulla stessa rete / VLAN ### Le letture di potenza mostrano zero 1. Verificare che il carico sia collegato attraverso il relè Shelly (non bypassato) 2. Verificare che il relè sia acceso — il contatore legge solo quando la corrente scorre attraverso il relè 3. Eseguire il polling manuale di `/status` e verificare che `meters[0].power` restituisca un valore diverso da zero ### Avviso di sovratemperatura Lo Shelly 1PM dispone di una protezione termica interna. Se la temperatura del dispositivo supera i limiti di sicurezza, `temperature_status` cambia in "High" o "Very High" e `overtemperature` diventa `true`. Assicurarsi una ventilazione adeguata attorno al dispositivo, specialmente quando si gestiscono carichi elevati. > [!WARNING] > I dispositivi Shelly Gen1 supportano solo **2 connessioni HTTP contemporanee**. Se TapHome e un altro sistema (ad es. Home Assistant) eseguono il polling dello stesso dispositivo contemporaneamente, la comunicazione potrebbe diventare inaffidabile. Usare 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-.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 1PM Modulo Attributi di servizio | | |---------------------------------| | Protezione potenza | | Nome host | | Indirizzo MAC | | Ora del dispositivo | | Tempo di attività | | RAM | | Temperatura interna dispositivo | | Stato temperatura | | Aggiornamento FW | | Cloud abilitato | | Cloud connesso | | MQTT connesso | | Surriscaldato | Azioni di servizio | | |----------------------------| | Imposta protezione potenza | | Abilita cloud | | Riavvio | Variabili personalizzate Interruttore Interruttore boolean Valori / Stati: ON · OFF Contatore elettrico Contatore elettrico Solo lettura Misurazione consumo energetico — potenza istantanea (kW) ed energia cumulativa (kWh) numeric Unità: W / kWh **Connessione:** Packet Parser → HTTP • Hostname: `shelly1pm-{MAC}.local` Possibili miglioramenti (5) - Voltage — Line voltage in V, available in /status response - Reactive Power — Reactive power in VAR, available in /status response - Input State — Physical input state (0/1), available in /status response - 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 or switch parameter ## Fonti - Shelly Gen1 API Reference [shelly-api-docs.shelly.cloud](https://shelly-api-docs.shelly.cloud/gen1/) 2026-03-12 ## 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/)