TapHome

Shelly Plus 1PM

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

A Shelly Plus 1PM egy kompakt Gen2+ Wi-Fi relés kapcsoló beépített teljesítményméréssel. Elfér egy szabványos fali kapcsoló mögött, és egyetlen áramkört képes vezérelni 16 A-ig (3500 W 230 V AC mellett) vagy 10 A-ig (30 V DC). A készülék 110-240 VAC vagy 24-30 VDC tápfeszültséget támogat, így hálózati és kisfeszültségű telepítésekhez egyaránt alkalmas. A TapHome lokálisan kommunikál az eszközzel Wi-Fi-n keresztül — felhőkapcsolat nem szükséges.

Két TapHome sablon érhető el: egy HTTP sablon, amely az eszköz Gen2+ RPC API-ját kérdezi le, és egy MQTT sablon, amely MQTT brokeren keresztül fogadja az adatokat. Mindkettő ugyanazt a két eszközt teszi elérhetővé — egy energiamérőt és egy relés kapcsolót.

Konfiguráció

HTTP sablon

A HTTP sablon csak az eszköz IP-címét igényli (alapértelmezett: 192.168.0.1). A TapHome a /rpc/Switch.GetStatus?id=0 végpontot kérdezi le a relé állapotához és a teljesítménymérési adatokhoz. A modul a JSON választ egy status változóban tárolja, így az egyes eszközszkriptek redundáns HTTP hívások nélkül elemezhetik az adatokat.

MQTT sablon

Az MQTT sablon importáláskor három paramétert igényel:

  • MQTT broker IP — az MQTT broker IP-címe (nem magáé a Shelly eszközé)
  • MQTT broker port — alapértelmezett 1883
  • Shelly MQTT Client ID — formátum shellyplus1pm-{deviceid}, a Shelly webes felületén található: Settings > MQTT Settings > Client ID

Az MQTT aktiválása után a Shelly Plus 1PM-en (Settings > MQTT) a TapHome feliratkozik a shellyplus1pm-{deviceid}/status/switch:0 témára, és vezérlő parancsokat küld a shellyplus1pm-{deviceid}/command/switch:0 témára.

Eszközképességek

Relévezérlés

A sablon a relét kapcsolóeszközként teszi elérhetővé. A relé állapota az output mezőből olvasható (boolean), és a /rpc/Switch.Set?id=0 végponton on=true vagy on=false paraméterrel (HTTP), vagy on/off publikálásával a parancs témára (MQTT) vezérelhető.

A HTTP sablon 2,5 másodperces intervallumban kérdezi le a relét, ami közel valós idejű állapotvisszajelzést biztosít. Az MQTT sablon a frissítéseket folyamatosan fogadja a listener szkripten keresztül.

Teljesítménymérés

A beépített energiamérő két értéket olvas a Switch.GetStatus válaszából:

  • Pillanatnyi teljesítmény — apower wattban, a sablon kW-ra konvertálja (osztás 1000-rel)
  • Összesített energiafogyasztás — aenergy.total wattórában, a sablon kWh-ra konvertálja (osztás 1000-rel)

A mérő csak olvasható — automatikusan frissül minden lekérdezési ciklussal (HTTP) vagy minden MQTT állapotüzenettel.

A HTTP sablon az energiamérőn három szervizattribútumot is elérhetővé tesz:

AttribútumEgységLeírás
ÁramAPillanatnyi áramfelvétel
FeszültségVEffektív hálózati feszültség
Hőmérséklet°CBelső eszközhőmérséklet

Az MQTT sablon a belső hőmérsékletet, feszültséget és áramot modulszintű szervizattribútumként teszi elérhetővé, azonos adatokkal, amelyeket az MQTT állapotüzenetből elemez.

További képességek

A Shelly Plus 1PM az RPC API-n keresztül elérhetővé teszi a teljesítménytényezőt, hálózati frekvenciát, visszatáplált energiát (kétirányú méréshez), fizikai bemeneti állapotot, Wi-Fi jelerősséget, MAC-címet, üzemidőt, RAM-kihasználtságot és eszközidőt is. Firmware-frissítés, eszközújraindítás, automatikus kikapcsolási időzítő, energiaszámláló-visszaállítás és túlterhelés-védelem konfigurálása szintén elérhető. Ezek a képességek egy jövőbeli sablonfrissítésben adhatók hozzá.

Hibaelhárítás

Az eszköz nem válaszol (HTTP)
  1. Ellenőrizze, hogy a Shelly csatlakozik a Wi-Fi-hez és érvényes IP-címmel rendelkezik
  2. Próbálja meg az mDNS hosztnevet (shellyplus1pm-AABBCCDDEE.local) az IP-cím helyett — az IP megváltozhatott DHCP-megújítás után
  3. Nyissa meg a http://{eszkoz-ip}/rpc/Shelly.GetDeviceInfo címet böngészőben — ha JSON-nal válaszol, az eszköz elérhető
  4. Ellenőrizze, hogy a TapHome CCU és a Shelly azonos hálózaton / VLAN-on vannak
  5. Győződjön meg róla, hogy a HTTP Digest hitelesítés ki van kapcsolva a Shelly webes felületén — a TapHome nem támogatja a hitelesített kéréseket
MQTT üzenetek nem érkeznek
  1. Ellenőrizze, hogy az MQTT engedélyezve van a Shelly webes felületén (Settings > MQTT)
  2. Erősítse meg, hogy a broker címe és portja helyes a Shelly eszközben és a TapHome modulbeállításokban egyaránt
  3. Ellenőrizze, hogy a plug1topic egyéni változó pontosan megegyezik a Shelly eszköz MQTT Client ID-jával (pl. shellyplus1pm-AABBCCDDEE)
  4. Használjon MQTT klienst (pl. MQTT Explorer) a shellyplus1pm-# feliratkozásához, és ellenőrizze, hogy az eszköz küld-e üzeneteket
Teljesítményértékek nullát mutatnak
  1. Erősítse meg, hogy a terhelés a Shelly relén keresztül van csatlakoztatva (nem áthidalva)
  2. Ellenőrizze, hogy a relé be van kapcsolva — a mérő csak akkor mér, ha áram folyik a relén át
  3. Kérdezze le manuálisan a /rpc/Switch.GetStatus?id=0 végpontot, és ellenőrizze, hogy az apower nem nullás értéket ad
Lassú válasz vagy időtúllépések
  1. A Gen2+ eszközök legfeljebb 6 egyidejű HTTP-kapcsolatot támogatnak (a Gen1 2-jével szemben) — de kerülje a túlzott lekérdezést több rendszerből
  2. Kapcsolja ki az ECO módot a Shelly webes felületén, ha engedélyezve van — alvó módba helyezi az eszközt a lekérdezések között, ami rövid lekérdezési intervallumoknál időtúllépéseket okozhat
  3. Használjon statikus IP-t vagy DHCP-foglalást a címváltozások elkerülésére
  4. Fontolja meg az MQTT sablonra való áttérést több rendszeres környezetben — az MQTT teljesen megkerüli a kapcsolatlimit problémáját

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 Plus 1PM Modul
Egyéni változók
Villamos mérő Villanyóra Csak olvasható

Pillanatnyi teljesítmény (kW) és összesített energia (kWh) áram-, feszültség- és hőmérséklet-diagnosztikával

numeric Egység: kW / kWh
Szerviz attribútumok
Áram
Feszültség
Hőmérséklet

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/Switch.GetStatus?id=0"));
status := x.Content;
Szerviz attribútumok
${current} [a]
return(parsejson(status,"current"));
${electric_voltage} [v]
return(parsejson(status,"voltage"));
${temp} [C]
return(parsejson(parsejson(status,"temperature"), "tC"));
Kapcsoló Kapcsoló
boolean
Értékek / Állapotok: ON · OFF

Kapcsoló

Kapcsoló állapot olvasása
var x := (sendhttprequest("/rpc/Switch.GetStatus?id=0"));
status := x.Content;
return(PARSEJSON(status, "$.output", true));
Kapcsoló állapot írása
VAR response := SENDHTTPREQUEST("rpc/Switch.Set?id=0&on=" + if(St,"true","false"));
IF response.IsSuccess = false
  ADDERROR(response.StatusCode);
END
Kapcsolat: Packet Parser → HTTP
Lehetséges fejlesztések (16)
  • Power Factor — Power factor value, available in Switch.GetStatus response for metered devices
  • Network Frequency — AC network frequency in Hz, available in Switch.GetStatus response
  • Returned Energy — Returned/exported energy in Wh, for bi-directional metering scenarios
  • Input State — Physical switch/button input state, available via /rpc/Input.GetStatus?id=0
  • WiFi SSID — Connected WiFi network name, available via /rpc/WiFi.GetStatus
  • WiFi Signal Strength — WiFi RSSI in dBm, available via /rpc/WiFi.GetStatus
  • IP Address — Device IP address, available via /rpc/WiFi.GetStatus
  • MAC Address — Device MAC address, available via /rpc/Sys.GetStatus
  • 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
  • Firmware Update — Trigger firmware update to stable channel, available via Shelly.Update RPC method
  • Reboot — Reboot the device, available via Shelly.Reboot RPC method
  • Auto-off Timer — Auto-reset timer in seconds via toggle_after parameter, could be added as switch parameter
  • Reset Energy Counters — Resets energy measurement counters (aenergy, ret_aenergy)
  • Overpower Protection — Configurable power limit threshold in Watts, relay turns off when exceeded

Források