TapHome

Shelly Pro 3EM

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

A Shelly Pro 3EM DIN sínre szerelhető professzionális háromfázisú energiamérő, amelyet külső áramváltókkal való használatra terveztek. Három változatban érhető el — Pro 3EM (120 A CT), Pro 3EM-400 (400 A CT) és Pro 3EM-3CT63 (beépített 63 A CT). Az eszköz Wi-Fi-n vagy Etherneten (RJ45) csatlakozik a helyi hálózathoz, és valós idejű méréseket tesz elérhetővé a Gen2+ HTTP RPC API-n keresztül. A TapHome HTTP-n, a 80-as porton kérdezi le az eszközt — nincs szükség felhőkapcsolatra.

A sablon tizenegy eszközt tartalmaz, amelyek kétirányú energiamérésre vannak szervezve: fázisonkénti áramszenzrok (L1, L2, L3), fázisonkénti From Grid és To Grid energiamérők, valamint összesített From Grid és To Grid energiamérők. A From Grid eszközök a hálózatból vett energiát, a To Grid eszközök a visszatáplált energiát (pl. napelemekből) követik nyomon — a teljesítményérték invertálva jelenik meg, hogy a betáplálás pozitív számként szerepeljen.

Hardveres csatlakoztatás

A Shelly Pro 3EM szabványos DIN sínre szerelhető (94 × 19 × 69 mm). Négy feszültségbemenetet igényel (három fázisvezeték + nullavezető) csavaros kapcsok útján, és négy külső CT-bemenetet (három fázis + nullavezető). Az eszközt bármely fázis és a nullavezető között kell táplálni (100–260 V AC, 50/60 Hz).

Fontos bekötési tudnivalók:

  • Feszültségbemenetek: LA, LB, LC (fázisonként egy) + N (nullavezető)
  • CT-bemenetek: Három fázis CT + egy nulla CT, a megfelelő CT-bemeneti csatlakozókhoz csatlakoztatva
  • Ethernet: Egy RJ45 csatlakozó LAN-kapcsolathoz (a LAN-kábel csatlakoztatása/eltávolítása előtt kapcsolja ki a tápellátást)
  • Vezető keresztmetszet: 0,5–2,5 mm² (20–14 AWG), csupaszítási hossz 6–7 mm, max. nyomaték 0,4 Nm

A külső védelmet max. 16 A értékre kell méretezni, B vagy C karakterisztikával és legalább 6 kA megszakítási kapacitással. Az üzemi feszültségtartomány fázisonként 100–260 V.

Konfiguráció

A Shelly Pro 3EM Wi-Fi-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).

Hitelesítés

A TapHome nem támogatja a HTTP Digest Authentication eljárást. Győződjön meg róla, hogy a hitelesítés letiltva van a Shelly eszközön, mielőtt hozzáadja a TapHome-hoz. Ez a Shelly webes felületén a Beállítások → Hitelesítés menüpontban konfigurálható.

CT-típus kiválasztása

Az áramváltók csatlakoztatása után konfigurálja a CT-típust a Shelly webes felületén, vagy az EM.SetConfig hívásával a megfelelő ct_type értékkel. A támogatott típusokat (általában 120A és 400A) az EM.GetCTTypes paranccsal listázhatja. Ha a CT-típus nincs beállítva, az eszköz ct_type_not_set hibát jelez, és a mérések nem lesznek elérhetők.

Fázis-fázis kalibráció

A Pro 3EM csatornák közötti kalibrációt támogat a fázisok közötti mérési pontosság javítása érdekében. A kalibráció csatornánként legalább 500 W terhelést igényel, és körülbelül 5 másodpercig tart. A kalibrációhoz használja az EM.PhaseToPhaseCalib, a gyári beállítások visszaállításához az EM.PhaseToPhaseCalibReset parancsot.

ECO mód

Ha az ECO mód engedélyezve van a Shelly eszközön, a TapHome 3 másodperces lekérdezési intervalluma miatt kommunikációs időtúllépéseket okozhat. A megbízható működéshez tiltsa le az ECO módot.

Eszközfunkciók

Fázisonkénti árammérés

Három áramszenzor (L1 Current, L2 Current, L3 Current) jelenti az azonnali áramerősséget ampérben minden egyes fázisra, közvetlenül az EM.GetStatus a_current, b_current és c_current mezőiből olvasva. Ezek egyszerű szenzorértékek, egységkonverzió nélkül.

Fázisonkénti kétirányú energiamérés

Minden fázishoz két energiamérő eszköz tartozik — From Grid és To Grid:

  • L1/L2/L3 From Grid — a hálózatból vett hatásos teljesítmény (W, kW-ra konvertálva) és a hálózatból kumulatívan fogyasztott energia (Wh, kWh-ra konvertálva). Minden From Grid eszköz négy szervizattribútumot is tartalmaz: Teljesítménytényező, Áram [A], Feszültség [V] és Összesített visszatáplált energia [kWh].
  • L1/L2/L3 To Grid — a hálózatba visszatáplált hatásos teljesítmény (W, −1000-rel osztva, hogy a betáplálás pozitív kW-ként jelenjen meg) és a kumulatívan visszatáplált energia (Wh, kWh-ra konvertálva). A To Grid eszközöknek nincsenek szervizattribútumaik.

A From Grid eszközök szervizattribútumai teljes fázisonkénti képet adnak: valós idejű áram és feszültség, teljesítménytényező az energiaminőség értékeléséhez, valamint visszatáplált energia számláló a kumulatív betáplálás nyomon követéséhez a From Grid fogyasztásszámláló mellett.

Összesített kétirányú energiamérés

Két összesítő eszköz foglalja össze mindhárom fázist:

  • Total From Grid — kombinált háromfázisú hatásos teljesítmény (kW) és a hálózatból összesen kumulatívan fogyasztott energia (kWh)
  • Total To Grid — kombinált háromfázisú visszatáplált teljesítmény (kW, invertálva) és a hálózatba összesen kumulatívan betáplált energia (kWh)

Minden eszköz 3 másodperces lekérdezési intervallumot használ, amely megfelel a modul olvasási ciklusának.

További lehetőségek

A Shelly Pro 3EM natívan elérhetővé teszi még a fázisonkénti és összesített látszólagos teljesítményt, a nullavezető áramának mérését (a Pro modell egyedi funkciója — a 3EM Gen3-on nem elérhető), a hálózati frekvenciát fázisonként, az összes fázis áramát, valamint a modul diagnosztikáját (Wi-Fi SSID, IP-cím, jelerősség, MAC-cím). A firmware frissítése és újraindítás szintén elérhető az RPC API-n keresztül. A fázissorrend-hiba észlelése és legfeljebb 60 napos, 1 perces felbontású adatnaplózás CSV/JSON exporttal natívan támogatott. Ezek a funkciók egy jövőbeli sablon-frissítésben adhatók hozzá.

Hibaelhárítás

Az eszköz nem válaszol
  1. Ellenőrizze, hogy a Shelly csatlakoztatva van-e Wi-Fi-hez vagy LAN-hoz, és rendelkezik-e érvényes IP-címmel
  2. Próbálja meg az mDNS hostnevet (ShellyPro3EM-XXXXXXXXXXXX.local) használni az IP-cím helyett — az IP-cím megváltozhatott egy DHCP-megújítás után
  3. Nyissa meg a http://{eszköz-ip}/rpc/Shelly.GetDeviceInfo címet egy böngészőben — ha JSON-nal válaszol, az eszköz elérhető
  4. Ellenőrizze, hogy a TapHome Core és a Shelly ugyanazon a hálózaton / VLAN-on van-e
ct_type_not_set hiba

Ha az EM vagy EMData komponens ct_type_not_set hibát jelez, az áramváltó típusa nincs konfigurálva. Állítsa be a CT-típust a Shelly webes felületén, vagy az EM.SetConfig hívásával a megfelelő ct_type értékkel. A támogatott típusokat az EM.GetCTTypes paranccsal listázhatja.

Fázissorrend hiba

Ha a phase_sequence hiba megjelenik az EM.GetStatus kimenetben, a fázisok fordított sorrendben vannak bekötve (A-C-B helyett A-B-C). Vagy kösse be a fázisokat a megfelelő sorrendben, vagy engedélyezze a monitor_phase_sequence beállítást az EM konfigurációban, ha a fordított sorrend szándékos.

Negatív vagy nulla értékek a To Grid eszközökön

A To Grid eszközök invertált konverziót (−1000-rel osztás) alkalmaznak, hogy a hálózatba visszatáplált energiát pozitív számként jelenítse meg. Ha nincs betáplálás (a rendszer csak fogyaszt), a To Grid teljesítményérték nullát vagy negatív értéket mutat. Ez az elvárt működés — a From Grid eszköz a fogyasztást, a To Grid az exportot követi nyomon.

A Shelly Gen2+/Gen3 eszközök legfeljebb 6 egyidejű HTTP-kapcsolatot támogatnak. Minden lekérdező rendszer (TapHome, Home Assistant stb.) kapcsolatokat fogyaszt. Kerülje, hogy egyszerre túl sok integrációt futtasson ugyanazon az eszközön.

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 3 EM Modul
Egyéni változók

Shelly Pro 3 EM

Olvasás (modul)
VAR response := SENDHTTPREQUEST("/rpc/EM.GetStatus?id=0");
IF response.IsSuccess
    EMStatus := response.Content;
END;

response := SENDHTTPREQUEST("/rpc/EMData.GetStatus?id=0");
IF response.IsSuccess
    EMDataStatus := response.Content;
END
L1 Áram Változó Csak olvasható
numeric Egység: A json_path

L1 Áram

Olvasás
todouble(PARSEjson(EMStatus, "a_current"))
L1 From Grid Villanyóra Csak olvasható

A fázis hatásos teljesítmény (kW) és kumulatív hálózati fogyasztás (kWh), feszültséggel, árammal, teljesítménytényezővel és visszatáplált energiával

numeric Egység: kW / kWh json_path
Szerviz attribútumok
Teljesítménytényező
Áram
Feszültség
Összesített visszatáplált energiaA fázis kumulatív visszatáplált (betáplált) energia kWh-ban

L1 From Grid

Összes fogyasztás olvasása
todouble(PARSEjson(EMDataStatus, "a_total_act_energy"))/1000
Igény olvasása
todouble(PARSEjson(EMStatus, "a_act_power"))/1000
Szerviz attribútumok
power factor
RETURN(todouble(PARSEjson(EMStatus, "a_pf")));
Current [A]
RETURN(todouble(PARSEjson(EMStatus, "a_current")));
voltage [V]
RETURN(todouble(PARSEjson(EMStatus, "a_voltage")));
Total returned energy [kWh]
RETURN(todouble(PARSEjson(EMDataStatus, "a_total_act_ret_energy"))/1000);
L1 To Grid Villanyóra Csak olvasható

A fázis visszatáplált teljesítmény (kW, invertálva) és a hálózatba kumulatívan betáplált energia (kWh)

numeric Egység: kW / kWh json_path

L1 To Grid

Összes fogyasztás olvasása
todouble(PARSEjson(EMDataStatus, "a_total_act_ret_energy"))/1000
Igény olvasása
todouble(PARSEjson(EMStatus, "a_act_power"))/-1000
L2 Áram Változó Csak olvasható
numeric Egység: A json_path

L2 Áram

Olvasás
todouble(PARSEjson(EMStatus, "b_current"))
L2 From Grid Villanyóra Csak olvasható

B fázis hatásos teljesítmény (kW) és kumulatív hálózati fogyasztás (kWh), feszültséggel, árammal, teljesítménytényezővel és visszatáplált energiával

numeric Egység: kW / kWh json_path
Szerviz attribútumok
Teljesítménytényező
Áram
Feszültség
Összesített visszatáplált energiaB fázis kumulatív visszatáplált (betáplált) energia kWh-ban

L2 From Grid

Összes fogyasztás olvasása
todouble(PARSEjson(EMDataStatus, "b_total_act_energy"))/1000
Igény olvasása
todouble(PARSEjson(EMStatus, "b_act_power"))/1000
Szerviz attribútumok
power factor
RETURN(todouble(PARSEjson(EMStatus, "b_pf")));
current [A[
RETURN(todouble(PARSEjson(EMStatus, "b_current")));
voltage [V]
RETURN(todouble(PARSEjson(EMStatus, "b_voltage")));
total returned energy [kWh]
RETURN(todouble(PARSEjson(EMDataStatus, "b_total_act_ret_energy"))/1000);
L2 To Grid Villanyóra Csak olvasható

B fázis visszatáplált teljesítmény (kW, invertálva) és a hálózatba kumulatívan betáplált energia (kWh)

numeric Egység: kW / kWh json_path

L2 To Grid

Összes fogyasztás olvasása
todouble(PARSEjson(EMDataStatus, "b_total_act_ret_energy"))/1000
Igény olvasása
todouble(PARSEjson(EMStatus, "b_act_power"))/-1000
L3 Áram Változó Csak olvasható
numeric Egység: A json_path

L3 Áram

Olvasás
todouble(PARSEjson(EMStatus, "c_current"))
L3 From Grid Villanyóra Csak olvasható

C fázis hatásos teljesítmény (kW) és kumulatív hálózati fogyasztás (kWh), feszültséggel, árammal, teljesítménytényezővel és visszatáplált energiával

numeric Egység: kW / kWh json_path
Szerviz attribútumok
Teljesítménytényező
Áram
Feszültség
Összesített visszatáplált energiaC fázis kumulatív visszatáplált (betáplált) energia kWh-ban

L3 From Grid

Összes fogyasztás olvasása
todouble(PARSEjson(EMDataStatus, "c_total_act_energy"))/1000
Igény olvasása
todouble(PARSEjson(EMStatus, "c_act_power"))/1000
Szerviz attribútumok
power factor
RETURN(todouble(PARSEjson(EMStatus, "c_pf")));
current [A]
RETURN(todouble(PARSEjson(EMStatus, "c_current")));
voltage [V]
RETURN(todouble(PARSEjson(EMStatus, "c_voltage")));
Total returned energy [kWh]
RETURN(todouble(PARSEjson(EMDataStatus, "c_total_act_ret_energy"))/1000);
L3 To Grid Villanyóra Csak olvasható

C fázis visszatáplált teljesítmény (kW, invertálva) és a hálózatba kumulatívan betáplált energia (kWh)

numeric Egység: kW / kWh json_path

L3 To Grid

Összes fogyasztás olvasása
todouble(PARSEjson(EMDataStatus, "c_total_act_ret_energy"))/1000
Igény olvasása
todouble(PARSEjson(EMStatus, "c_act_power"))/-1000
Total From Grid Villanyóra Csak olvasható

Kombinált háromfázisú hatásos teljesítmény (kW) és összesített kumulatív hálózati fogyasztás (kWh)

numeric Egység: kW / kWh json_path

Total From Grid

Összes fogyasztás olvasása
todouble(PARSEjson(EMDataStatus, "total_act"))/1000
Igény olvasása
todouble(PARSEjson(EMStatus, "total_act_power"))/1000
Total To Grid Villanyóra Csak olvasható

Kombinált háromfázisú visszatáplált teljesítmény (kW, invertálva) és a hálózatba összesen kumulatívan betáplált energia (kWh)

numeric Egység: kW / kWh json_path

Total To Grid

Összes fogyasztás olvasása
todouble(PARSEjson(EMDataStatus, "total_act_ret"))/1000
Igény olvasása
todouble(PARSEjson(EMStatus, "total_act_power"))/-1000
Kapcsolat: Packet Parser → HTTP
Lehetséges fejlesztések (14)
  • Phase A Apparent Power — Apparent power in VA, available per phase — could complement active power
  • Total Apparent Power — Sum of apparent power on all phases [VA]
  • Neutral Current — Current on neutral conductor [A] — Pro 3EM supports this (unlike 3EM Gen3)
  • Grid Frequency — Network frequency in Hz, available per phase — not exposed as device or SA
  • Total Current — Sum of current on all three phases [A]
  • MAC Address — No module-level service attributes in this template (unlike 3EM Gen3)
  • WiFi SSID — No module-level service attributes in this template (unlike 3EM Gen3)
  • Signal Strength — WiFi RSSI in dBm — not polled by module readscript
  • Firmware Update — No module-level service actions in this template (unlike 3EM Gen3)
  • Reboot — No module-level service actions in this template (unlike 3EM Gen3)
  • Uptime — Seconds since last reboot
  • Free RAM — Available RAM in bytes
  • Total Returned Energy (dedicated) — Already implemented as Total To Grid device (readtotalconsumption), listed for completeness
  • Phase Sequence Monitoring — Enable/disable phase sequence error detection via EM.SetConfig

Források