--- title: "Shelly PM Mini Gen3" description: "Shelly PM Mini Gen3 in TapHome via HTTP RPC API locale: potenza, energia, tensione, corrente e frequenza fino a 16 A. Solo misura, nessun relè." url: "https://taphome.com/it/compatibility/shelly-pm-mini-gen3/" language: it lastmod: 2026-03-29 generator: hugo ai: topics: ["http","electric-meter","wifi","power-metering","mdns"] questions: ["Come integrare lo Shelly PM Mini Gen3 con TapHome?","Cosa misura il template Shelly PM Mini Gen3 in TapHome?","Come collegare lo Shelly PM Mini Gen3 via HTTP a TapHome?","Qual è la differenza tra Shelly PM Mini Gen3 e 1PM Gen3 in TapHome?","Perché lo Shelly PM Mini Gen3 mostra valori di potenza a zero?","Lo Shelly PM Mini Gen3 può commutare carichi o è solo un monitor?"] --- # Shelly PM Mini Gen3 Comunicazione: Packet Parser → HTTP - [Pagina prodotto Shelly PM Mini Gen3](https://www.shelly.com/en/products/shop/shelly-pm-mini-gen3) > 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 PM Mini Gen3 è un monitor di potenza Wi-Fi ultracompatto (29 × 34 × 16 mm) che misura passivamente il consumo elettrico fino a 16 A / 3840 W a 240 VAC. A differenza dello Shelly 1PM Gen3, il PM Mini Gen3 **non ha relè** — non può commutare carichi. Si installa in serie con il circuito monitorato e misura la corrente che fluisce attraverso i suoi morsetti. TapHome comunica con il dispositivo via HTTP utilizzando l'API Gen2+/Gen3 JSON-RPC 2.0 sulla rete locale — non è richiesta alcuna connessione cloud. Il template interroga l'endpoint del componente PM1 (`/rpc/pm1.GetStatus?id=0`) per tutti i dati di misurazione della potenza. ## Configurazione Lo Shelly PM Mini Gen3 si connette tramite Wi-Fi. Durante l'importazione del template in TapHome, inserisci l'indirizzo IP del dispositivo (placeholder predefinito `192.168.0.1`). > [!WARNING] > L'autenticazione deve essere **disattivata** sul dispositivo Shelly per l'integrazione con TapHome. TapHome non supporta l'HTTP Digest Auth utilizzata dai dispositivi Gen2+/Gen3. Apri l'interfaccia web Shelly (`http://{device-ip}`) → Settings → Authentication e assicurati che sia disattivata. > [!NOTE] > Se la modalità ECO è attivata sul dispositivo Shelly, può causare timeout di comunicazione a causa degli intervalli di polling rapidi del template (1–1,5 secondi). Disattiva la modalità ECO nell'interfaccia web Shelly se riscontri problemi di connettività intermittente. ## Funzionalità del dispositivo ### Misurazione della potenza Il contatore elettrico integrato legge due valori dalla risposta di `/rpc/pm1.GetStatus?id=0`: - **Potenza in tempo reale** — `apower` riportato in watt, il template converte in kW - **Consumo totale** — `aenergy.total` riportato in wattora, il template converte in kWh Il contatore espone anche due attributi di servizio: - **Corrente elettrica** — corrente di carico in ampere (campo `current`) - **Tensione elettrica** — tensione di alimentazione in volt (campo `voltage`) ### Sensori individuali Il template fornisce tre dispositivi sensore autonomi letti dallo stesso endpoint PM1: - **Corrente [A]** — corrente RMS in ampere - **Tensione [V]** — tensione RMS in volt - **Frequenza [Hz]** — frequenza della rete AC in hertz Tutti i sensori sono di sola lettura e si aggiornano automaticamente ad ogni ciclo di polling (intervallo di 1,5 secondi per i sensori individuali, 1 secondo per il contatore). > [!NOTE] > Il componente PM1 **non** espone il fattore di potenza (`pf`) né la temperatura interna — a differenza del componente Switch utilizzato sui modelli con relè come lo Shelly 1PM Gen3. ### Funzionalità aggiuntive Lo Shelly PM Mini Gen3 espone anche dati energetici al minuto (`aenergy.by_minute`), diagnostica WiFi (SSID, IP, RSSI), indirizzo MAC del dispositivo, uptime, utilizzo RAM e ora del dispositivo nelle sue risposte RPC. Il firmware può essere aggiornato tramite `/rpc/Shelly.Update` e il dispositivo può essere riavviato tramite `/rpc/Shelly.Reboot`. Il dispositivo funziona anche come BLE Gateway, collegando i sensori Shelly BLU alla rete locale. 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 usare l'hostname mDNS (`shellypmmig3-AABBCCDDEE.local`) invece dell'indirizzo IP — l'IP potrebbe essere cambiato dopo un rinnovo DHCP 3. Apri `http://{device-ip}/rpc/Shelly.GetDeviceInfo` nel browser — se risponde con JSON, il dispositivo è raggiungibile 4. Verifica che TapHome Core e Shelly siano nella stessa rete / VLAN 5. Conferma che l'autenticazione è disattivata sul dispositivo Shelly ### I valori di potenza mostrano zero 1. Conferma che il carico è collegato attraverso il PM Mini Gen3 (la corrente deve fluire attraverso i morsetti del dispositivo) 2. Verifica che il circuito sia sotto tensione — il PM Mini Gen3 non ha relè, quindi monitora qualsiasi cosa fluisca attraverso il cavo 3. Interroga `/rpc/pm1.GetStatus?id=0` manualmente nel browser e verifica che `apower` restituisca un valore diverso da zero 4. Verifica che il carico stia effettivamente assorbendo potenza — un dispositivo in standby potrebbe mostrare valori vicini allo zero > [!WARNING] > I dispositivi Shelly Gen2+/Gen3 supportano fino a **6 connessioni HTTP simultanee**. Sebbene questo sia un miglioramento significativo rispetto a Gen1 (2 connessioni), evita il polling da troppi sistemi contemporaneamente (TapHome, Home Assistant, script personalizzati) per prevenire l'esaurimento 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 4 Questi dispositivi compaiono in TapHome dopo l'importazione. Shelly PM Mini Gen3 Modulo Variabili personalizzate Corrente Variabile Solo lettura numeric Unità: A Lettura ```taphome return(parsejson(status,"current")); ``` Contatore elettrico Contatore elettrico Solo lettura Misurazione consumo energetico — potenza istantanea (kW) ed energia cumulativa (kWh) con letture di corrente e tensione numeric Unità: kW / kWh Attributi di servizio | | |--------------------| | Corrente elettrica | | Tensione elettrica | Lettura consumo totale ```taphome return(parsejson(parsejson(status,"aenergy"), "total")/1000); ``` Lettura domanda ```taphome return(parsejson(status,"apower")/1000); ``` Lettura (modulo) ```taphome var x := (sendhttprequest("/rpc/pm1.GetStatus?id=0")); status := x.Content; ``` Attributi di servizio ${current} \[a] ```taphome return(parsejson(status,"current")); ``` ${electric\_voltage} \[v] ```taphome return(parsejson(status,"voltage")); ``` Frequenza Variabile Solo lettura numeric Unità: Hz Lettura ```taphome return(parsejson(status,"freq")); ``` Tensione Variabile Solo lettura numeric Unità: V Lettura ```taphome parsejson(status,"voltage") ``` **Connessione:** Packet Parser → HTTP • Hostname: `shellypmmig3-{MAC}.local` Possibili miglioramenti (8) - Energy by Minute — Energy data array per minute, available in pm1.GetStatus response — useful for detailed consumption graphs - WiFi Status (SSID, IP, Signal) — WiFi connection info; template has no module-level service\_attributes — could be added for diagnostics - MAC Address — Device MAC address from Sys.GetStatus, not polled in current template - 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 - Update Firmware — Firmware update via RPC; template has no module-level service\_actions - Reboot — Device reboot via RPC; template has no module-level service\_actions ## Parametri di importazione Inserisci questi valori quando importi l'XML. | Richiesto nell'app | Predefinito | |--------------------|---------------| | Indirizzo IP | `192.168.0.1` | ## Fonti - Shelly Gen2+/Gen3 RPC API Reference [shelly-api-docs.shelly.cloud](https://shelly-api-docs.shelly.cloud/gen2/) 2026-03-27 - Shelly Gen2+ Switch Component API [shelly-api-docs.shelly.cloud](https://shelly-api-docs.shelly.cloud/gen2/ComponentsAndServices/Switch/) 2026-03-27 - Shelly Gen2+ System (Sys) Component API [shelly-api-docs.shelly.cloud](https://shelly-api-docs.shelly.cloud/gen2/ComponentsAndServices/Sys/) 2026-03-27 - Shelly Gen2+ WiFi Component API [shelly-api-docs.shelly.cloud](https://shelly-api-docs.shelly.cloud/gen2/ComponentsAndServices/WiFi/) 2026-03-27 - Home Assistant Shelly Integration [www.home-assistant.io](https://www.home-assistant.io/integrations/shelly/) 2026-03-27 - Shelly PM Mini Gen3 Knowledge Base [kb.shelly.cloud](https://kb.shelly.cloud/knowledge-base/shelly-pm-mini-gen3) 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/)