TapHome

Shelly PM Mini Gen3

Packet Parser → HTTP
Trimis de
Ultima actualizare: 03. 2026

Acest dispozitiv acceptă mDNS

În loc să folosiți o adresă IP, puteți accesa dispozitivul la:

shellypmmig3-{MAC}.local

Înlocuiți {MAC} cu adresa MAC a dispozitivului dvs. (majuscule, fără două puncte).

TapHome acceptă mDNS — folosirea unui nume de gazdă este mai fiabilă decât un IP static.

Shelly PM Mini Gen3

Shelly PM Mini Gen3 este un monitor de putere Wi-Fi ultracompact (29 x 34 x 16 mm) care măsoară pasiv consumul electric de până la 16 A / 3840 W la 240 V AC. Spre deosebire de Shelly 1PM Gen3, PM Mini Gen3 nu are releu — nu poate comuta sarcini. Se montează în serie cu circuitul monitorizat și măsoară curentul care trece prin bornele sale.

TapHome comunică cu dispozitivul prin HTTP, folosind API-ul JSON-RPC 2.0 Gen2+/Gen3 în rețeaua locală — nu este necesară conexiunea la cloud. Șablonul interoghează endpointul componentei PM1 (/rpc/pm1.GetStatus?id=0) pentru toate datele de măsurare a puterii.

Configurare

Shelly PM Mini Gen3 se conectează prin Wi-Fi. La importul șablonului în TapHome, introduceți adresa IP a dispozitivului (valoarea implicită: 192.168.0.1).

Pentru integrarea cu TapHome, autentificarea pe dispozitivul Shelly trebuie să fie dezactivată. TapHome nu acceptă HTTP Digest Auth, folosită de dispozitivele Gen2+/Gen3. Deschideți interfața web Shelly (http://{device-ip}) → Settings → Authentication și asigurați-vă că este dezactivată.

Dacă pe dispozitivul Shelly este activat modul ECO, pot apărea erori de timeout ale comunicării din cauza intervalelor scurte de interogare folosite de șablon (1–1,5 secunde). Dacă întâmpinați probleme intermitente de conectivitate, dezactivați modul ECO în interfața web Shelly.

Funcțiile dispozitivului

Măsurarea puterii

Contorul electric integrat citește două valori din răspunsul /rpc/pm1.GetStatus?id=0:

  • Putere în timp real — apower raportată în wați, convertită de șablon în kW
  • Consum total — aenergy.total raportat în wați-oră, convertit de șablon în kWh

Contorul oferă și două atribute de service:

  • Curent electric — curentul sarcinii în amperi (câmpul current)
  • Tensiune electrică — tensiunea de alimentare în volți (câmpul voltage)
Senzori individuali

Șablonul oferă trei dispozitive senzor independente, citite din același endpoint PM1:

  • Curent [A] — curentul RMS în amperi
  • Tensiune [V] — tensiunea RMS în volți
  • Frecvență [Hz] — frecvența rețelei de curent alternativ în herți

Toți senzorii sunt doar pentru citire și se actualizează automat la fiecare ciclu de interogare (interval de 1,5 secunde pentru senzorii individuali, 1 secundă pentru contorul electric).

Componenta PM1 nu oferă factorul de putere (pf) și nici temperatura internă — spre deosebire de componenta Switch folosită la modelele cu releu, cum este Shelly 1PM Gen3.

Funcții suplimentare

În răspunsurile RPC, Shelly PM Mini Gen3 oferă și date despre energie pe fiecare minut (aenergy.by_minute), diagnosticarea Wi-Fi (SSID, IP, RSSI), adresa MAC a dispozitivului, timpul de funcționare, utilizarea memoriei RAM și ora dispozitivului. Firmware-ul se poate actualiza prin /rpc/Shelly.Update, iar dispozitivul se poate reporni prin /rpc/Shelly.Reboot. Dispozitivul funcționează și ca BLE Gateway, conectând senzorii Shelly BLU la rețeaua locală. Aceste funcții pot fi adăugate într-o actualizare viitoare a șablonului.

Rezolvarea problemelor

Dispozitivul nu răspunde
  1. Verificați dacă dispozitivul Shelly este conectat la Wi-Fi și are o adresă IP validă
  2. Încercați numele de gazdă mDNS (shellypmmig3-AABBCCDDEE.local) în locul adresei IP — adresa IP s-ar fi putut schimba după reînnoirea DHCP
  3. Deschideți http://{device-ip}/rpc/Shelly.GetDeviceInfo într-un browser — dacă răspunde cu JSON, dispozitivul este accesibil
  4. Verificați dacă TapHome Core și dispozitivul Shelly se află în aceeași rețea / VLAN
  5. Verificați dacă autentificarea este dezactivată pe dispozitivul Shelly
Valorile puterii sunt zero
  1. Verificați dacă sarcina este conectată prin PM Mini Gen3 (curentul trebuie să treacă prin bornele dispozitivului)
  2. Verificați dacă circuitul este sub tensiune — PM Mini Gen3 nu are releu, deci măsoară orice curent care trece prin conductor
  3. Interogați manual /rpc/pm1.GetStatus?id=0 într-un browser și verificați dacă apower returnează o valoare diferită de zero
  4. Verificați dacă sarcina consumă efectiv energie — un aparat în standby poate afișa valori apropiate de zero

Dispozitivele Shelly Gen2+/Gen3 acceptă până la 6 conexiuni HTTP simultane. Deși aceasta este o îmbunătățire semnificativă față de Gen1 (2 conexiuni), evitați interogarea din prea multe sisteme în același timp (TapHome, Home Assistant, scripturi personalizate), pentru a nu epuiza conexiunile disponibile.

Cum se instalează în TapHome

Cerințe preliminare

  • Dispozitiv Shelly instalat și pornit
  • Rețea Wi-Fi locală (2,4 GHz)
  • TapHome CCU în aceeași rețea

Pasul 1 — Conectați dispozitivul Shelly la Wi-Fi

Varianta A — aplicația Shelly (recomandat):

  1. Descărcați aplicația Shelly (iOS / Android)
  2. Atingeți + → Add Device și urmați asistentul de împerechere prin Bluetooth
  3. Introduceți datele de conectare la Wi-Fi când vi se solicită

Varianta B — modul AP (fără aplicație):

  1. La prima pornire, dispozitivul creează un hotspot: ShellyXXX-AABBCCDDEE
  2. Conectați telefonul/PC-ul la acest hotspot
  3. Deschideți http://192.168.33.1 → Internet & Security → Wi-Fi Mode - Client
  4. Introduceți SSID-ul și parola → Save

Shelly acceptă doar rețele de 2,4 GHz. Rețelele de 5 GHz nu vor apărea la scanare.

Pasul 2 — Găsiți adresa dispozitivului

Dispozitivele Shelly Gen1 acceptă mDNS (Zeroconf). Puteți accesa dispozitivul folosind un nume de gazdă în locul adresei IP:

1

shelly<model>-<MAC>.local

De exemplu: shelly1pm-AABBCCDDEE.local (adresa MAC în hexazecimal cu majuscule, fără două puncte).

Recomandat: folosiți Scanner IP din TapHome. Deschideți aplicația TapHome și folosiți Scanner IP (Setări → Rețea → Scanare). Scannerul descoperă dispozitivele din rețea și afișează atât adresa IP, cât și numele de gazdă mDNS. Pentru o conexiune mai fiabilă folosiți numele de gazdă în locul adresei IP — acesta rămâne același chiar dacă adresa IP a dispozitivului se schimbă după o repornire a routerului.

Metode alternative pentru aflarea adresei IP:

  • Aplicația Shelly: detaliile dispozitivului → Device info → adresa IP
  • Interfața web Shelly: conectați-vă la AP-ul dispozitivului înainte de configurarea Wi-Fi — adresa IP se afișează după salvare
  • Tabelul DHCP al routerului: căutați un nume de gazdă de forma shelly1pm-AABBCCDDEE

Pasul 3 — Configurați dispozitivul în TapHome

  1. În TapHome adăugați un nou modul Packet Parser (HTTP)
  2. Address: introduceți numele de gazdă mDNS (de ex. shelly1pm-AABBCCDDEE.local) sau adresa IP de la pasul 2
  3. Port: 80 (implicit, nu este necesară nicio modificare)
  4. Importați șablonul — TapHome va interoga periodic /status pentru a citi starea dispozitivului

Autentificarea HTTP este dezactivată implicit pe dispozitivele Shelly. Dacă ați activat protecția prin autentificare, rețineți că TapHome nu acceptă momentan HTTP Basic Auth — pentru integrarea cu TapHome lăsați autentificarea dezactivată.

Dispozitive disponibile

Shelly PM Mini Gen3 Modul
Variabile personalizate
Curent Variabilă Doar citire
numeric Unitate: A

Curent

Citire
return(parsejson(status,"current"));
Contor electric Contor electric Doar citire

Măsurarea consumului de putere și de energie — putere instantanee (kW) și energie cumulată (kWh), cu citirea curentului și a tensiunii

numeric Unitate: kW / kWh
Atribute de service
Curent electric
Tensiune electrică

Contor electric

Citirea consumului total
return(parsejson(parsejson(status,"aenergy"), "total")/1000);
Citirea cererii
return(parsejson(status,"apower")/1000);
Citire (modul)
var x := (sendhttprequest("/rpc/pm1.GetStatus?id=0"));
status := x.Content;
Atribute de service
${current} [a]
return(parsejson(status,"current"));
${electric_voltage} [v]
return(parsejson(status,"voltage"));
Frecvență Variabilă Doar citire
numeric Unitate: Hz

Frecvență

Citire
return(parsejson(status,"freq"));
Tensiune Variabilă Doar citire
numeric Unitate: V

Tensiune

Citire
parsejson(status,"voltage")
Conexiune: Packet Parser → HTTP • Nume gazdă: shellypmmig3-{MAC}.local
Îmbunătățiri posibile (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

Surse

Ați găsit o problemă la acest șablon de dispozitiv?

Spuneți-ne ce nu funcționează, ce lipsește sau cum ar trebui să se comporte șablonul. Feedbackul dvs. ne ajută să păstrăm catalogul corect.

Verificat de TapHome

Doriți să folosiți acest șablon în TapHome Core?

Deschideți acest șablon în Customer Portal pentru a-l aplica într-una dintre locuințele dvs. sau pentru a propune o îmbunătățire și a o trimite înapoi în catalog.

Deschideți în portal