TapHome

Shelly PM Mini Gen3

Packet Parser → HTTP
Inviato da
Ultimo aggiornamento: 03. 2026
Shelly PM Mini Gen3

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).

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.

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).

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

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 (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 PM Mini Gen3 Modulo
Variabili personalizzate
Corrente Variabile Solo lettura
numeric Unità: A

Corrente

Lettura
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

Contatore elettrico

Lettura consumo totale
return(parsejson(parsejson(status,"aenergy"), "total")/1000);
Lettura domanda
return(parsejson(status,"apower")/1000);
Lettura (modulo)
var x := (sendhttprequest("/rpc/pm1.GetStatus?id=0"));
status := x.Content;
Attributi di servizio
${current} [a]
return(parsejson(status,"current"));
${electric_voltage} [v]
return(parsejson(status,"voltage"));
Frequenza Variabile Solo lettura
numeric Unità: Hz

Frequenza

Lettura
return(parsejson(status,"freq"));
Tensione Variabile Solo lettura
numeric Unità: V

Tensione

Lettura
parsejson(status,"voltage")
Connessione: Packet Parser → HTTP
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

Fonti