TapHome

Shelly PM Mini Gen3

Packet Parser → HTTP
Beküldő
Utoljára frissítve: 03. 2026
Shelly PM Mini Gen3

A Shelly PM Mini Gen3 egy ultrakompakt Wi-Fi teljesítménymérő (29 × 34 × 16 mm), amely passzívan méri az elektromos fogyasztást 16 A / 3840 W-ig 240 VAC-nál. A Shelly 1PM Gen3-mal ellentétben a PM Mini Gen3-nak nincs reléje — nem tud terhelést kapcsolni. A felügyelt áramkörbe sorosan telepítendő, és a kapcsain átfolyó áramot méri.

A TapHome HTTP-n kommunikál az eszközzel a Gen2+/Gen3 JSON-RPC 2.0 API-n keresztül a helyi hálózaton — felhőkapcsolat nem szükséges. A sablon a PM1 komponens végpontját (/rpc/pm1.GetStatus?id=0) kérdezi le minden teljesítménymérési adatért.

Konfiguráció

A Shelly PM Mini Gen3 Wi-Fi-n csatlakozik. A TapHome sablonimport során add meg az eszköz IP-címét (alapértelmezett helyőrző: 192.168.0.1).

A hitelesítést ki kell kapcsolni a Shelly eszközön a TapHome integrációhoz. A TapHome nem támogatja a Gen2+/Gen3 eszközök által használt HTTP Digest Auth hitelesítést. Nyisd meg a Shelly webes felületét (http://{device-ip}) → Settings → Authentication, és győződj meg róla, hogy ki van kapcsolva.

Ha az ECO mód be van kapcsolva a Shelly eszközön, kommunikációs időtúllépéseket okozhat a sablon gyors lekérdezési intervallumai (1–1,5 másodperc) miatt. Kapcsold ki az ECO módot a Shelly webes felületén, ha időszakos kapcsolódási problémákat tapasztalsz.

Eszközképességek

Teljesítménymérés

A beépített villamos mérő két értéket olvas a /rpc/pm1.GetStatus?id=0 válaszából:

  • Valós idejű teljesítmény — apower wattban, a sablon kW-ra konvertálja
  • Összes fogyasztás — aenergy.total wattórában, a sablon kWh-ra konvertálja

A villamos mérő két szervizattribútumot is biztosít:

  • Elektromos áram — terhelési áram amperben (current mező)
  • Elektromos feszültség — tápfeszültség voltban (voltage mező)
Egyedi szenzorok

A sablon három önálló szenzoreszközt biztosít, amelyeket ugyanarról a PM1 végpontról olvas:

  • Áram [A] — effektív áram amperben
  • Feszültség [V] — effektív feszültség voltban
  • Frekvencia [Hz] — AC hálózati frekvencia hertzben

Minden szenzor csak olvasható, és automatikusan frissül minden lekérdezési ciklussal (1,5 másodperces intervallum az egyedi szenzoroknak, 1 másodperces a villamos mérőnek).

A PM1 komponens nem biztosít teljesítménytényezőt (pf) és belső hőmérsékletet — ellentétben a Switch komponenssel, amelyet relés modelleknél használnak, mint a Shelly 1PM Gen3.

További képességek

A Shelly PM Mini Gen3 percenkénti energiaadatokat (aenergy.by_minute), WiFi diagnosztikát (SSID, IP, RSSI), eszköz MAC-címet, üzemidőt, RAM-használatot és eszközidőt is szolgáltat az RPC-válaszaiban. A firmware frissíthető a /rpc/Shelly.Update végponton, és az eszköz újraindítható a /rpc/Shelly.Reboot végponton. Az eszköz BLE Gateway-ként is működik, összekapcsolva a Shelly BLU szenzorokat a helyi hálózattal. Ezek a képességek egy jövőbeli sablonfrissítésben kerülhetnek hozzáadásra.

Hibaelhárítás

Az eszköz nem válaszol
  1. Ellenőrizd, hogy a Shelly csatlakozik a Wi-Fi-hez és érvényes IP-címe van
  2. Próbáld az mDNS hosztnevet (shellypmmig3-AABBCCDDEE.local) az IP-cím helyett — az IP megváltozhatott DHCP-megújítás után
  3. Nyisd meg a http://{device-ip}/rpc/Shelly.GetDeviceInfo címet a böngészőben — ha JSON-nal válaszol, az eszköz elérhető
  4. Ellenőrizd, hogy a TapHome Core és a Shelly ugyanazon a hálózaton / VLAN-on vannak
  5. Győződj meg róla, hogy a hitelesítés ki van kapcsolva a Shelly eszközön
A teljesítményértékek nullát mutatnak
  1. Győződj meg róla, hogy a terhelés a PM Mini Gen3-on keresztül van csatlakoztatva (az áramnak az eszköz kapcsain kell átfolynia)
  2. Ellenőrizd, hogy az áramkör feszültség alatt van — a PM Mini Gen3-nak nincs reléje, csak azt figyeli, ami átfolyik a vezetéken
  3. Kérdezd le a /rpc/pm1.GetStatus?id=0 végpontot manuálisan a böngészőben, és ellenőrizd, hogy az apower nem nulla értéket ad vissza
  4. Ellenőrizd, hogy a terhelés valóban fogyaszt — készenléti eszköz közel nulla értékeket mutathat

A Shelly Gen2+/Gen3 eszközök legfeljebb 6 egyidejű HTTP-kapcsolatot támogatnak. Bár ez jelentős javulás a Gen1-hez képest (2 kapcsolat), kerüld a túl sok rendszerből történő egyidejű lekérdezést (TapHome, Home Assistant, egyéni szkriptek), hogy elkerüld a kapcsolatkimerülést.

Telepítés a TapHome-ban

Előfeltételek

  • Shelly eszköz telepítve és bekapcsolva
  • Helyi Wi-Fi hálózat (2,4 GHz)
  • TapHome CCU ugyanazon a hálózaton

1. lépés — Shelly csatlakoztatása a Wi-Fi-hez

A lehetőség — Shelly alkalmazás (ajánlott):

  1. Töltse le a Shelly alkalmazást (iOS / Android)
  2. Érintse meg a + → Add Device gombot, és kövesse a Bluetooth párosítási varázslót
  3. Adja meg Wi-Fi hitelesítő adatait, amikor a rendszer kéri

B lehetőség — AP mód (alkalmazás nélkül):

  1. Első bekapcsoláskor az eszköz létrehoz egy hotspotot: ShellyXXX-AABBCCDDEE
  2. Csatlakoztassa telefonját/PC-jét ehhez a hotspothoz
  3. Nyissa meg a http://192.168.33.1 címet → Internet & Security → Wi-Fi Mode - Client
  4. Adja meg az SSID-t és a jelszót → Save

A Shelly csak 2,4 GHz-es hálózatokat támogat. Az 5 GHz-es hálózatok nem jelennek meg a keresésben.

2. lépés — IP-cím megkeresése

A Wi-Fi-hez való csatlakozás után az alábbi módszerek egyikével keresse meg a hozzárendelt IP-címet:

  • Shelly alkalmazás: Eszköz részletei → Device info → IP-cím
  • Shelly webes felület: Csatlakozzon az eszköz AP-jához a Wi-Fi beállítás előtt — az IP a mentés után jelenik meg
  • Router DHCP tábla: Keressen egy hasonló hosztnevet: shelly1pm-AABBCCDDEE
  • mDNS: Pingelje a shelly<model>-<mac>.local címet (pl. shelly1pm-AABBCCDDEE.local) ugyanarról a hálózatról

Rendeljen statikus IP-t (DHCP foglalást) a Shelly eszközhöz a routerben, hogy a cím ne változzon a router újraindítása után.

3. lépés — Konfigurálás a TapHome-ban

  1. A TapHome-ban adjon hozzá egy új Packet Parser (HTTP) modult
  2. IP Address: adja meg a 2. lépésben kapott IP-t (pl. 192.168.1.50)
  3. Port: 80 (alapértelmezett, nem kell módosítani)
  4. Importálja a sablont — a TapHome rendszeresen lekérdezi a /status végpontot az eszköz állapotának olvasásához

A HTTP hitelesítés a Shelly eszközökön alapértelmezetten ki van kapcsolva. Ha engedélyezte a bejelentkezésvédelmet, a TapHome jelenleg nem támogatja a HTTP Basic Auth-ot — a TapHome integrációhoz hagyja kikapcsolva a hitelesítést.

Elérhető eszközök

Shelly PM Mini Gen3 Modul
Egyéni változók
Áram Változó Csak olvasható
numeric Egység: A

Áram

Olvasás
return(parsejson(status,"current"));
Villamos mérő Villanyóra Csak olvasható

Energiafogyasztás mérés — pillanatnyi teljesítmény (kW) és összesített energia (kWh) áram- és feszültségméréssel

numeric Egység: kW / kWh
Szerviz attribútumok
Elektromos áram
Elektromos feszültség

Villamos mérő

Összes fogyasztás olvasása
return(parsejson(parsejson(status,"aenergy"), "total")/1000);
Igény olvasása
return(parsejson(status,"apower")/1000);
Olvasás (modul)
var x := (sendhttprequest("/rpc/pm1.GetStatus?id=0"));
status := x.Content;
Szerviz attribútumok
${current} [a]
return(parsejson(status,"current"));
${electric_voltage} [v]
return(parsejson(status,"voltage"));
Frekvencia Változó Csak olvasható
numeric Egység: Hz

Frekvencia

Olvasás
return(parsejson(status,"freq"));
Feszültség Változó Csak olvasható
numeric Egység: V

Feszültség

Olvasás
parsejson(status,"voltage")
Kapcsolat: Packet Parser → HTTP
Lehetséges fejlesztések (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

Források