TapHome

Shelly 3EM Gen3

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

A Shelly 3EM Gen3 egy DIN-sínre szerelhető háromfázisú energiamérő beépített áramváltókkal (fázisonként legfeljebb 63 A). Wi-Fi-n csatlakozik a helyi hálózathoz, és a Gen2+/Gen3 HTTP RPC API-n keresztül biztosítja a valós idejű méréseket. A TapHome HTTP-n, a 80-as porton kérdezi le az eszközt — felhőkapcsolat nem szükséges.

A sablon négy energiamérő eszközt tartalmaz: egy összesített mérőt és három egyedi fázismérőt (A, B, C). Minden mérő a pillanatnyi hatásos teljesítményt és a kumulatív energiafogyasztást mutatja, a fázismérők emellett a feszültséget, áramot, teljesítménytényezőt és hálózati frekvenciát is megjelenítik szervizattribútumként.

Hardveres csatlakoztatás

A Shelly 3EM Gen3 két változatban kapható — 3EM-63W (vezetékes modell) és 3EM-63T (lapos csatlakozós modell). Mindkettő a DIN-sínen lévő kismegszakítók fölé vagy alá szerelhető.

Az eszköz Y (csillag) 4-vezetékes bekötést igényel:

  • LA, LB, LC — három fázisbemenet, fázisonként egy
  • N — nullavezető
  • A tápellátás az LA fázis és a nullavezető között történik (220-240 V~ 50/60 Hz)

A külső védelem 63 A-es, B vagy C karakterisztikájú, 6 kA névleges megszakítási teljesítményű legyen.

A maximális biztonságos üzemi feszültség 280 V fázisonként. Az áramtartomány 0-63 A, 130 A telítéssel. Ezen határértékek túllépése károsíthatja az eszközt.

Konfiguráció

A Shelly 3EM Gen3 Wi-Fi-n csatlakozik. A TapHome sablonimportálás során add 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 Authenticationt. A TapHome-hoz való hozzáadás előtt győződj meg róla, hogy a hitelesítés ki van kapcsolva a Shelly eszközön. Ez a Shelly webes felületén, a Settings → Authentication menüpontban állítható be.

Profilválasztás

A Shelly 3EM Gen3 két profilt támogat — Triphase (alapértelmezett) és Monophase. A TapHome sablon a Triphase profilhoz készült, amely egyetlen EM komponenst (em:0) tesz elérhetővé fázisonkénti és összesített mérésekkel. Győződj meg róla, hogy az eszköz a Triphase profilra van beállítva (gyári alapértelmezés).

ECO mód

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

Eszközfunkciók

Összesített energiamérés

Az Összesített energiamérő eszköz mindhárom fázis összesített nézetét mutatja:

  • Hatásos teljesítmény — total_act_power az EM.GetStatus-ból, W-ról kW-ra átváltva (osztva 1000-rel)
  • Kumulatív energia — total_act az EMData.GetStatus-ból, Wh-ról kWh-ra átváltva (osztva 1000-rel)
  • Összesített áram (szervizattribútum) — az áram összege mindhárom fázison
Fázisonkénti energiamérés

Három egyedi fázismérő (A fázis, B fázis, C fázis) részletes méréseket biztosít fázisonként. Minden fázismérő mutatja:

  • Hatásos teljesítmény — pillanatnyi teljesítmény kW-ban (W-ról átváltva)
  • Kumulatív energia — teljes energiafogyasztás kWh-ban (Wh-ról átváltva)

Minden fázismérő négy szervizattribútumot is megjelenít:

  • Elektromos áram — fázisáram A-ban
  • Elektromos feszültség — fázisfeszültség V-ban
  • Teljesítménytényező — a hatásos és látszólagos teljesítmény dimenziómentes aránya
  • Hálózati frekvencia — hálózati frekvencia Hz-ben

A fázismérők 15 másodperces lekérdezési intervallumot használnak (a modul 3 másodperces intervallumával szemben), ami az energiafigyeléshez elegendő.

Moduldiagnosztika

A sablon négy szervizattribútumot tesz elérhetővé modulszinten:

  • Wifi — a csatlakoztatott Wi-Fi hálózat SSID-je
  • IP-cím — az eszköz IP-címe a helyi hálózaton
  • Jelerősség — Wi-Fi RSSI dBm-ben
  • MAC — az eszköz MAC-címe

Két szervizakció érhető el:

  • FW frissítése — firmware frissítést indít a legújabb stabil verzióra
  • Újraindítás — az eszköz újraindítását indítja el

A modul olvasó szkriptje az elérhető firmware-frissítéseket és a függőben lévő újraindítási igényeket is ellenőrzi, és figyelmeztetést jelenít meg a TapHome-ban, ha bármelyik feltétel teljesül.

További funkciók

A Shelly 3EM Gen3 fázisonkénti és összesített látszólagos teljesítményt, nullavezetői áramot és visszatáplált (hálózatba betáplált) energiaszámlálókat is biztosít fázisonként és összesítve. A fázissorrend-hiba észlelése és az 1 perces felbontású historikus adattárolás natívan elérhető. Ezek a funkciók egy jövőbeli sablonfrissítésben adhatók hozzá.

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 meg az mDNS hosztnevet (Shelly3EM63G3-XXXXXXXXXXXX.local) használni az IP-cím helyett — az IP-cím megváltozhatott egy DHCP-megújítás után
  3. Nyisd meg a http://{device-ip}/rpc/Shelly.GetDeviceInfo URL-t 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 van
ct_type_not_set hiba

Ha az EM komponens ct_type_not_set hibát jelez, az áramváltó típusa nincs beállítva. Állítsd be a CT típusát a Shelly webes felületén vagy az EM.SetConfig hívásával a megfelelő ct_type értékkel. Használd az EM.GetCTTypes parancsot a támogatott típusok listázásához.

Fázissorrend-hiba

Ha a phase_sequence hiba jelenik meg az EM.GetStatus-ban, a fázisok fordított sorrendben vannak bekötve (A-C-B az A-B-C helyett). Vagy kösd be a fázisokat a helyes sorrendben, vagy engedélyezd a monitor_phase_sequence opciót az EM konfigurációban a hiba elnyomásához, ha a fordított sorrend szándékos.

A Shelly Gen2+/Gen3 eszközök legfeljebb 6 egyidejű HTTP-kapcsolatot támogatnak. Ez több, mint a Gen1 eszközöknél (2 kapcsolat), de vedd figyelembe, hogy minden lekérdező rendszer (TapHome, Home Assistant stb.) kapcsolatokat használ. Kerüld a túl sok integráció egyidejű futtatását 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 3EM Gen3 Modul
Szerviz attribútumok
Wifi
IP-cím
Jelerősség
MAC
Szerviz műveletek
FW frissítéseFirmware frissítést indít a legújabb stabil verzióra
Újraindítás
Egyéni változók

Shelly 3EM Gen3

Olvasás (modul)
VAR response := SENDHTTPREQUEST("/rpc/Sys.GetStatus");
IF response.IsSuccess
    Sys.GetStatus := response.Content;
END

response := SENDHTTPREQUEST("/rpc/Sys.GetConfig");
IF response.IsSuccess
    Sys.GetConfig := response.Content;
END

response := SENDHTTPREQUEST("/rpc/WiFi.GetStatus");
IF response.IsSuccess
    WiFi.GetStatus := response.Content;
END

response := SENDHTTPREQUEST("/rpc/EM.GetStatus?id=0");
IF response.IsSuccess
    EM.GetStatus := response.Content;
END

response := SENDHTTPREQUEST("/rpc/EMData.GetStatus?id=0");
IF response.IsSuccess
    EMData.GetStatus := response.Content;
END

if ! ISNULL(parsejson(Sys.GetStatus, "available_updates.stable", true))
    addwarning("New firmware update is available");
end

if parsejson(Sys.GetStatus, "restart_required", true)
    addwarning("Restart required");
end
Szerviz attribútumok
Wifi
PARSEJSON(WiFi.GetStatus, "ssid")
${ipAddress}
PARSEJSON(WiFi.GetStatus, "sta_ip")
${xml_signal_strength} [dB]
PARSEJSON(WiFi.GetStatus, "rssi")
MAC
PARSEJSON(Sys.GetStatus, "mac")
Szerviz műveletek
${xml_update_fw}
VAR response := SENDHTTPREQUEST("/rpc/Shelly.Update?stage=\"stable\"");
IF response.IsSuccess
    return("OK");
else
    return("Error");
END
Reboot
VAR response := SENDHTTPREQUEST("/rpc/Shelly.Reboot");
IF response.IsSuccess
    return("OK");
else
    return("Error");
END
Összesített energiamérő Villanyóra Csak olvasható

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

numeric Egység: kW / kWh json_path
Szerviz attribútumok
Elektromos áramAz áram összege mindhárom fázison
Változó: EM.GetStatus

Összesített energiamérő

Összes fogyasztás olvasása
return(parsejson(EMData.GetStatus,"total_act")/1000);
Igény olvasása
return(parsejson(EM.GetStatus,"total_act_power")/1000);
Szerviz attribútumok
${electric_current} [A]
return(parsejson(EM.GetStatus,"total_current"));
A fázis energiamérő Villanyóra Csak olvasható

A fázis hatásos teljesítmény (kW), kumulatív energia (kWh), feszültség, áram, teljesítménytényező és frekvencia

numeric Egység: kW / kWh json_path
Szerviz attribútumok
Elektromos áram
Elektromos feszültség
Teljesítménytényező
Hálózati frekvencia

A fázis energiamérő

Összes fogyasztás olvasása
return(parsejson(EMData.GetStatus,"a_total_act_energy")/1000);
Igény olvasása
return(parsejson(EM.GetStatus,"a_act_power")/1000);
Szerviz attribútumok
${electric_current} [A]
return(parsejson(EM.GetStatus,"a_current"));
${electric_voltage} [V]
return(parsejson(EM.GetStatus,"a_voltage"));
${power_factor}
return(parsejson(EM.GetStatus,"a_pf"));
${grid_frequency} [Hz]
return(parsejson(EM.GetStatus,"a_freq"));
B fázis energiamérő Villanyóra Csak olvasható

B fázis hatásos teljesítmény (kW), kumulatív energia (kWh), feszültség, áram, teljesítménytényező és frekvencia

numeric Egység: kW / kWh json_path
Szerviz attribútumok
Elektromos áram
Elektromos feszültség
Teljesítménytényező
Hálózati frekvencia

B fázis energiamérő

Összes fogyasztás olvasása
return(parsejson(EMData.GetStatus,"b_total_act_energy")/1000);
Igény olvasása
return(parsejson(EM.GetStatus,"b_act_power")/1000);
Szerviz attribútumok
${electric_current} [A]
return(parsejson(EM.GetStatus,"b_current"));
${electric_voltage} [V]
return(parsejson(EM.GetStatus,"b_voltage"));
${power_factor}
return(parsejson(EM.GetStatus,"b_pf"));
${grid_frequency} [Hz]
return(parsejson(EM.GetStatus,"b_freq"));
C fázis energiamérő Villanyóra Csak olvasható

C fázis hatásos teljesítmény (kW), kumulatív energia (kWh), feszültség, áram, teljesítménytényező és frekvencia

numeric Egység: kW / kWh json_path
Szerviz attribútumok
Elektromos áram
Elektromos feszültség
Teljesítménytényező
Hálózati frekvencia

C fázis energiamérő

Összes fogyasztás olvasása
return(parsejson(EMData.GetStatus,"c_total_act_energy")/1000);
Igény olvasása
return(parsejson(EM.GetStatus,"c_act_power")/1000);
Szerviz attribútumok
${electric_current} [A]
return(parsejson(EM.GetStatus,"c_current"));
${electric_voltage} [V]
return(parsejson(EM.GetStatus,"c_voltage"));
${power_factor}
return(parsejson(EM.GetStatus,"c_pf"));
${grid_frequency} [Hz]
return(parsejson(EM.GetStatus,"c_freq"));
Kapcsolat: Packet Parser → HTTP
Lehetséges fejlesztések (8)
  • 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]
  • Total Returned Energy — Total active returned energy [Wh] — relevant for solar/grid feed-in
  • Phase A Returned Energy — Per-phase returned energy [Wh] — same available for B and C
  • Uptime — Seconds since last reboot, available in Sys.GetStatus
  • Free RAM — Available RAM in bytes
  • Phase Sequence Monitoring — Enable/disable phase sequence error detection via EM.SetConfig

Források