TapHome

Shelly Pro 4PM

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

A Shelly Pro 4PM egy DIN sínre szerelhető 4 csatornás okos relé beépített csatornánkénti teljesítményméréssel. A négy független kimenet mindegyike legfeljebb 16 A-t kapcsolhat (összesen 40 A), így alkalmas világítási áramkörök, készülékek vagy elosztótáblai terhelések vezérlésére csatornánkénti egyedi energiamonitorozással. A TapHome HTTP-n kommunikál az eszközzel a helyi hálózaton — felhőkapcsolat nem szükséges.

A sablon vegyes API-megközelítést használ: Gen2+ RPC végpontokat (/rpc/Switch.GetStatus?id=N) az energiamérés olvasásához, és Gen1 végpontokat (/relay/N?turn=on|off) a relévezérlés írásához. Mindkét API-generációt a Pro 4PM támogatja a visszafelé kompatibilitás érdekében. Az eszköz WiFi-n vagy Etherneten (RJ45) csatlakozik, és 1,8 hüvelykes színes LCD kijelzővel rendelkezik a helyi állapotfigyeléshez.

Konfiguráció

A Shelly Pro 4PM WiFi-n vagy Etherneten csatlakozik. A TapHome sablon importálásakor adja 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 eszközök által használt HTTP Digest Auth hitelesítést. Nyissa meg a Shelly webes felületét (http://{eszkoz-ip}) → Settings → Authentication, és győződjön meg róla, hogy ki van kapcsolva.

A LAN kábelt csak kikapcsolt eszköznél szabad bedugni vagy kihúzni. Az Ethernet kábel menet közbeni csatlakoztatása problémákat okozhat.

Ha az ECO mód engedélyezve van a Shelly eszközön, kommunikációs időtúllépéseket okozhat a sablon gyors lekérdezési intervallumai (2,5–15 másodperc) miatt. Kapcsolja ki az ECO módot a Shelly webes felületén, ha időszakos csatlakozási problémákat tapasztal.

Eszközképességek

Energiamérés

A sablon négy független energiamérő eszközt tesz elérhetővé, csatornánként egyet. Minden mérő a /rpc/Switch.GetStatus?id=N végpontról olvas (ahol N 0–3):

  • 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

Az 1. csatorna 2,5 másodpercenként kérdez le a gyorsabb visszajelzésért. A 2–4. csatornák 15 másodpercenként kérdeznek le.

A mérők csak olvashatók — automatikusan frissülnek minden lekérdezési ciklussal.

Relévezérlés

A sablon négy relés kapcsolóeszközt tesz elérhetővé, csatornánként egyet. Minden relé a Gen1 /relay/N?turn=on|off végponton vezérelhető (ahol N 0–3).

A relés kapcsolók csak írhatók — a sablon nem olvassa vissza a relé állapotát az eszközről. A relé aktuális állapota a megfelelő energiamérőből következtethető ki: ha a csatorna nem nullás fogyasztást jelent, a relé be van kapcsolva. Egy jövőbeli sablonfrissítés hozzáadhatja a relé állapotvisszajelzést a Gen2+ /rpc/Switch.GetStatus?id=N → output mező segítségével.

Teljesítményérzékelő

Egy önálló teljesítményérzékelő eszköz az 1. csatorna nyers aktív teljesítményét teszi elérhetővé wattban (a /rpc/Switch.GetStatus?id=0 → apower mezőből olvasva). Az energiamérővel ellentétben, amely kW-ra konvertál, ez az érzékelő konverzió nélkül jelenti az értéket wattban, ami hasznos a watt szintű pontosságot igénylő automatizálásokhoz.

Szerviz diagnosztika

A sablon 13 szervizattribútumot tesz elérhetővé az eszközfigyeléshez:

  • Eszközinformáció — hosztnév, MAC-cím, eszközidő, üzemidő, RAM-kihasználtság
  • Hővédelem — belső hőmérséklet (°C), hőmérséklet állapot (Normal / High / Very High), túlmelegedés jelző
  • Kapcsolat — felhő engedélyezve/csatlakoztatva, MQTT csatlakoztatva, firmware frissítés elérhető
  • Teljesítményvédelem — aktuális maximális teljesítménykorlát (a /settings végpontról olvasva)
Szerviz műveletek

Három szerviz művelet érhető el:

  • Teljesítményvédelem beállítása — beállítja a maximális teljesítménykorlátot (1–3500 W). A relé automatikusan kikapcsol, ha a fogyasztás meghaladja ezt az értéket.
  • Felhő engedélyezése — engedélyezi vagy letiltja a Shelly Cloud kapcsolatot
  • Újraindítás — elindítja az eszköz újraindítását
További képességek

A Shelly Pro 4PM csatornánkénti feszültséget, áramot, teljesítménytényezőt, frekvenciát és belső hőmérsékletet is elérhetővé tesz a /rpc/Switch.GetStatus válaszában. Fizikai kapcsoló/gomb bemeneti állapotok (S1–S4), Ethernet állapot, WiFi RSSI és natív Gen2+ relévezérlés automatikus kikapcsolási időzítővel az RPC API-n keresztül érhetők el. 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
  1. Ellenőrizze, hogy a Shelly csatlakozik WiFi-hez vagy Ethernethez, és érvényes IP-címmel rendelkezik
  2. Próbálja meg az mDNS hosztnevet (shellypro4pm-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 Core és a Shelly azonos hálózaton / VLAN-on vannak
  5. Győződjön meg róla, hogy a hitelesítés ki van kapcsolva a Shelly eszközön
Teljesítményértékek nullát mutatnak
  1. Erősítse meg, hogy a terhelés a Shelly relékimeneten (O1–O4) 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
  4. Ellenőrizze a helyes csatorna-azonosítót (id=0 az 1. kimenethez, id=1 a 2. kimenethez stb.)
Ismeretlen relé állapot

A sablon relés kapcsolói csak írhatók — be-/kikapcsolási parancsokat küldenek, de nem olvassák vissza a relé állapotát. A tényleges relé állapot ellenőrzéséhez:

  1. Ellenőrizze a megfelelő energiamérőt — nem nullás teljesítmény azt jelenti, hogy a relé be van kapcsolva
  2. Nézze meg a relé LED jelzőit az eszköz előlapján
  3. Tesztelje manuálisan böngészőn keresztül: http://{eszkoz-ip}/relay/0 visszaadja az aktuális relé állapotot JSON-ban
Túlmelegedési figyelmeztetés

A Shelly Pro 4PM belső hővédelemmel rendelkezik. Ha az eszköz hőmérséklete meghaladja a biztonságos határértékeket, a temperature_status “High” vagy “Very High” értékre változik, és az overtemperature true lesz. Biztosítson megfelelő szellőzést az elosztószekrényben, különösen nagy terhelések egyidejű kapcsolásakor több csatornán.

V1 vs V2 hardver

Mindkét verzió ugyanazt a firmware-t és API-t használja. A V2 (SPSW-104PE16EU) továbbfejlesztett csatlakozókkal rendelkezik — öt különálló csavaros sorkapocs négy darab 2 pólusú csatlakozóblokk helyett — és jobb LAN elektromos szigeteléssel. A verziók között nincs szükség sablonváltoztatásra.

A Gen2 Shelly eszközök legfeljebb 6 egyidejű HTTP-kapcsolatot támogatnak. A Shelly Pro 4PM sablon lekérdezési ciklusonként legfeljebb 5 egyidejű végpontot használ (4 energiamérő + modul állapot), ami korlátozott mozgásteret hagy. Kerülje a túl sok rendszerből történő egyidejű lekérdezé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 Pro 4PM Modul
Szerviz műveletek
Teljesítményvédelem beállításaMaximális teljesítménykorlát beállítása (1–3500 W) — a relé automatikusan kikapcsol, ha a fogyasztás meghaladja
Cloud engedélyezéseShelly Cloud kapcsolat engedélyezése vagy letiltása
ÚjraindításEszköz újraindítás indítása
Egyéni változók
StatusJson (string)
SettingsJson (string)
status (string) = 0

Shelly 4 Pro

Olvasás (modul)
VAR response := SENDHTTPREQUEST("/status", "GET");
StatusJson := response.Content;
Szerviz műveletek
Set power protection
Paraméterek: Maximum power (1–3500 Watts)
VAR response := SENDHTTPREQUEST("settings?max_power=" + Watts);
VAR contentJson := response.Content;
VAR limitSet := PARSEJSON(contentJson, "max_power");

"Power limit set to " + limitSet + "W"
Enable cloud
Paraméterek: Enable (Enable / Disable)
VAR response := SENDHTTPREQUEST("/settings/cloud?enabled=" + enable);
VAR contentJson := response.Content;
VAR wasEnabled := PARSEJSON(contentJson, "enabled");

IF(wasEnabled, "Cloud enabled", "Cloud disabled");
Reboot
VAR response := SENDHTTPREQUEST("/reboot");
VAR contentJson := response.Content;
VAR wasRebooted := PARSEJSON(contentJson, "ok");

IF(wasRebooted, "Reboot successful", "Error");
1. csatorna villamos mérő Villanyóra Csak olvasható

Csatornánkénti teljesítmény- és energiamérés az 1. kimenethez — pillanatnyi teljesítmény (kW) és összesített energia (kWh)

numeric Egység: W / kWh

1. csatorna 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;
2. csatorna villamos mérő Villanyóra Csak olvasható

Csatornánkénti teljesítmény- és energiamérés a 2. kimenethez — pillanatnyi teljesítmény (kW) és összesített energia (kWh)

numeric Egység: W / kWh

2. csatorna 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=1"));
status := x.Content;
3. csatorna villamos mérő Villanyóra Csak olvasható

Csatornánkénti teljesítmény- és energiamérés a 3. kimenethez — pillanatnyi teljesítmény (kW) és összesített energia (kWh)

numeric Egység: W / kWh

3. csatorna 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=2"));
status := x.Content;
4. csatorna villamos mérő Villanyóra Csak olvasható

Csatornánkénti teljesítmény- és energiamérés a 4. kimenethez — pillanatnyi teljesítmény (kW) és összesített energia (kWh)

numeric Egység: W / kWh

4. csatorna 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=3"));
status := x.Content;
2. csatorna relé Kapcsoló

Csak írható relévezérlés a 2. kimenethez — állapot nem olvasható vissza, a villamos mérőből következtethető

boolean
Értékek / Állapotok: ON · OFF

2. csatorna relé

Kapcsoló állapot írása
VAR path := "relay/1?turn=" + SWITCH(St, 0, "off", 1, "on","off");
SENDHTTPREQUEST(path);
1. csatorna relé Kapcsoló

Csak írható relévezérlés az 1. kimenethez — állapot nem olvasható vissza, a villamos mérőből következtethető

boolean
Értékek / Állapotok: ON · OFF

1. csatorna relé

Kapcsoló állapot írása
VAR path := "relay/0?turn=" + SWITCH(St, 0, "off", 1, "on","off");
SENDHTTPREQUEST(path);
1. csatorna teljesítményszenzor Változó Csak olvasható

Nyers hatásos teljesítmény wattban az 1. csatornához — önálló szenzorérték kW konverzió nélkül

numeric Egység: W

1. csatorna teljesítményszenzor

Olvasás
return(parsejson(status,"apower"));
Olvasás (modul)
var x := (sendhttprequest("/rpc/Switch.GetStatus?id=0"));
status := x.Content;
3. csatorna relé Kapcsoló

Csak írható relévezérlés a 3. kimenethez — állapot nem olvasható vissza, a villamos mérőből következtethető

boolean
Értékek / Állapotok: ON · OFF

3. csatorna relé

Kapcsoló állapot írása
VAR path := "relay/2?turn=" + SWITCH(St, 0, "off", 1, "on","off");
SENDHTTPREQUEST(path);
4. csatorna relé Kapcsoló

Csak írható relévezérlés a 4. kimenethez — állapot nem olvasható vissza, a villamos mérőből következtethető

boolean
Értékek / Állapotok: ON · OFF

4. csatorna relé

Kapcsoló állapot írása
VAR path := "relay/3?turn=" + SWITCH(St, 0, "off", 1, "on","off");
SENDHTTPREQUEST(path);
Kapcsolat: Packet Parser → HTTP
Lehetséges fejlesztések (10)
  • Relay State Read — Switches have no readswitchstate script — relay state is not read back. Gen2+ /rpc/Switch.GetStatus?id=N provides output (boolean) for state feedback.
  • Voltage — Per-channel line voltage in V, available in /rpc/Switch.GetStatus response
  • Current — Per-channel load current in A, available in /rpc/Switch.GetStatus response
  • Power Factor — Per-channel power factor, available in /rpc/Switch.GetStatus response
  • Frequency — Network frequency in Hz, available in /rpc/Switch.GetStatus response
  • Per-Channel Temperature — Internal temperature in °C per switch component, available in /rpc/Switch.GetStatus response
  • Input States (S1-S4) — 4 physical switch/button inputs, available via /rpc/Input.GetStatus?id=0..3
  • Gen2+ Relay Control — Native Gen2+ relay control with toggle_after timer support. Template uses Gen1 /relay/N instead.
  • WiFi Status (SSID, IP, RSSI) — WiFi status including signal strength, available via Gen2+ RPC
  • Ethernet Status — Pro 4PM has RJ45 LAN port; Ethernet status (IP, link) available via /rpc/Ethernet.GetStatus

Források