TapHome

Shelly 3EM Gen3

Packet Parser → HTTP
Pridal
Posledná aktualizácia: 03. 2026
Shelly 3EM Gen3

Shelly 3EM Gen3 je trojfázový elektromer na DIN lištu so zabudovanými prúdovými transformátormi (do 63 A na fázu). Pripája sa k lokálnej sieti cez Wi-Fi a poskytuje merania v reálnom čase prostredníctvom HTTP RPC API Gen2+/Gen3. TapHome zariadenie dopytuje cez HTTP na porte 80 — pripojenie do cloudu nie je potrebné.

Šablóna poskytuje štyri zariadenia typu elektromer: jeden celkový merač a tri merače jednotlivých fáz (A, B, C). Každý merač zobrazuje okamžitý činný výkon a kumulatívnu spotrebu energie, pričom merače jednotlivých fáz navyše poskytujú napätie, prúd, účinník a frekvenciu siete ako servisné atribúty.

Hardvérové zapojenie

Shelly 3EM Gen3 je dostupný v dvoch variantoch — 3EM-63W (káblový model) a 3EM-63T (model s plochými svorkami). Oba sa montujú nad alebo pod ističe na DIN lištu.

Zariadenie vyžaduje zapojenie Y (hviezda) so 4 vodičmi:

  • LA, LB, LC — tri fázové vstupy, jeden na fázu
  • N — nulový vodič
  • Napájanie je odoberané medzi fázou LA a nulovým vodičom (220-240 V~ 50/60 Hz)

Externá ochrana by mala byť dimenzovaná na 63 A s charakteristikou B alebo C a menovitým vypínacím prúdom 6 kA.

Maximálne bezpečné prevádzkové napätie je 280 V na fázu. Rozsah prúdu je 0-63 A so saturáciou 130 A. Prekročenie týchto limitov môže poškodiť zariadenie.

Konfigurácia

Shelly 3EM Gen3 sa pripája cez Wi-Fi. Počas importu šablóny v TapHome zadajte IP adresu zariadenia (predvolený zástupný text 192.168.0.1).

Autentifikácia

TapHome nepodporuje HTTP Digest Authentication. Pred pridaním zariadenia do TapHome sa uistite, že autentifikácia je na zariadení Shelly vypnutá. Toto nastavenie nájdete vo webovom rozhraní Shelly v časti Settings → Authentication.

Výber profilu

Shelly 3EM Gen3 podporuje dva profily — Triphase (predvolený) a Monophase. Šablóna TapHome je navrhnutá pre profil Triphase, ktorý poskytuje jeden EM komponent (em:0) s meraniami pre každú fázu aj celkovými hodnotami. Uistite sa, že zariadenie je nastavené na profil Triphase (továrenský predvolený).

ECO režim

Ak je na zariadení Shelly povolený ECO režim, môže spôsobovať výpadky komunikácie kvôli 3-sekundovému intervalu dopytovania modulu v TapHome. Pre spoľahlivú prevádzku ECO režim vypnite.

Možnosti zariadenia

Celkové meranie energie

Zariadenie Celkový elektromer poskytuje súhrnný pohľad na všetky tri fázy:

  • Činný výkon — total_act_power z EM.GetStatus, prevedený z W na kW (delené 1000)
  • Kumulatívna energia — total_act z EMData.GetStatus, prevedená z Wh na kWh (delené 1000)
  • Celkový prúd (servisný atribút) — súčet prúdov na všetkých troch fázach
Meranie energie po fázach

Tri individuálne merače fáz (Fáza A, Fáza B, Fáza C) poskytujú detailné merania pre každú fázu. Každý merač fázy zobrazuje:

  • Činný výkon — okamžitý výkon v kW (prevedený z W)
  • Kumulatívna energia — celková spotreba energie v kWh (prevedená z Wh)

Každý merač fázy navyše poskytuje štyri servisné atribúty:

  • Elektrický prúd — fázový prúd v A
  • Elektrické napätie — fázové napätie vo V
  • Účinník — bezrozmerný pomer činného a zdanlivého výkonu
  • Frekvencia siete — frekvencia siete v Hz

Merače fáz používajú 15-sekundový interval dopytovania (v porovnaní s 3-sekundovým intervalom modulu), čo je dostatočné pre účely monitorovania energie.

Diagnostika modulu

Šablóna poskytuje štyri servisné atribúty na úrovni modulu:

  • Wifi — SSID pripojenej Wi-Fi siete
  • IP adresa — IP adresa zariadenia v lokálnej sieti
  • Sila signálu — Wi-Fi RSSI v dBm
  • MAC — MAC adresa zariadenia

K dispozícii sú dve servisné akcie:

  • Aktualizácia FW — spustí aktualizáciu firmvéru na najnovšiu stabilnú verziu
  • Reštart — spustí reštart zariadenia

Čítací skript modulu tiež kontroluje dostupné aktualizácie firmvéru a požiadavky na reštart, pričom v TapHome zobrazí varovanie, ak je zistená niektorá z týchto podmienok.

Ďalšie možnosti

Shelly 3EM Gen3 tiež poskytuje zdanlivý výkon na fázu aj celkový, prúd na nulovom vodiči a počítadlá vrátenej (dodanej do siete) energie na fázu aj celkovo. K dispozícii je natívna detekcia chýb sledu fáz a ukladanie historických dát s 1-minútovým rozlíšením. Tieto možnosti môžu byť pridané v budúcej aktualizácii šablóny.

Riešenie problémov

Zariadenie neodpovedá
  1. Overte, že Shelly je pripojený k Wi-Fi a má platnú IP adresu
  2. Skúste použiť mDNS hostname (Shelly3EM63G3-XXXXXXXXXXXX.local) namiesto IP adresy — IP adresa sa mohla zmeniť po obnovení DHCP
  3. Otvorte http://{device-ip}/rpc/Shelly.GetDeviceInfo v prehliadači — ak odpovie JSON, zariadenie je dostupné
  4. Skontrolujte, že TapHome Core a Shelly sú v rovnakej sieti / VLAN
Chyba ct_type_not_set

Ak EM komponent hlási chybu ct_type_not_set, typ prúdového transformátora nebol nakonfigurovaný. Nastavte typ CT cez webové rozhranie Shelly alebo volaním EM.SetConfig s príslušnou hodnotou ct_type. Použite EM.GetCTTypes na zobrazenie podporovaných typov.

Chyba sledu fáz

Ak sa v EM.GetStatus objaví chyba phase_sequence, fázy sú zapojené v opačnom poradí (A-C-B namiesto A-B-C). Buď predrôtujte fázy v správnom poradí, alebo povoľte monitor_phase_sequence v konfigurácii EM na potlačenie chyby, ak je obrátené poradie zámerné.

Zariadenia Shelly Gen2+/Gen3 podporujú až 6 súbežných HTTP pripojení. To je viac ako zariadenia Gen1 (2 pripojenia), ale majte na pamäti, že každý systém dopytovania (TapHome, Home Assistant a pod.) spotrebúva pripojenia. Vyhnite sa súčasnému používaniu príliš veľa integrácií na jednom zariadení.

Ako nainštalovať v TapHome

Predpoklady

  • Zariadenie Shelly nainštalované a zapnuté
  • Lokálna Wi-Fi sieť (2,4 GHz)
  • TapHome CCU v rovnakej sieti

Krok 1 — Pripojte Shelly k Wi-Fi

Možnosť A — Aplikácia Shelly (odporúčané):

  1. Stiahnite si aplikáciu Shelly (iOS / Android)
  2. Klepnite na + → Add Device a postupujte podľa sprievodcu Bluetooth párovaním
  3. Po výzve zadajte svoje Wi-Fi prihlasovacie údaje

Možnosť B — AP režim (bez aplikácie):

  1. Pri prvom zapnutí zariadenie vytvorí hotspot: ShellyXXX-AABBCCDDEE
  2. Pripojte telefón/PC k tomuto hotspotu
  3. Otvorte http://192.168.33.1 → Internet & Security → Wi-Fi Mode - Client
  4. Zadajte SSID a heslo → Save

Shelly podporuje iba 2,4 GHz siete. 5 GHz siete sa pri skenovaní nezobrazia.

Krok 2 — Zistite IP adresu

Po pripojení k Wi-Fi zistite priradenú IP adresu jedným z nasledujúcich spôsobov:

  • Aplikácia Shelly: Detail zariadenia → Device info → IP adresa
  • Webové rozhranie Shelly: Pripojte sa k AP zariadenia pred nastavením Wi-Fi — IP sa zobrazí po uložení
  • DHCP tabuľka routera: Hľadajte hostname ako shelly1pm-AABBCCDDEE
  • mDNS: Pingnite shelly<model>-<mac>.local (napr. shelly1pm-AABBCCDDEE.local) z rovnakej siete

Priraďte zariadeniu Shelly statickú IP (DHCP rezerváciu) vo vašom routeri, aby sa adresa nezmenila po reštarte routera.

Krok 3 — Konfigurácia v TapHome

  1. V TapHome pridajte nový modul Packet Parser (HTTP)
  2. IP Address: zadajte IP z kroku 2 (napr. 192.168.1.50)
  3. Port: 80 (predvolený, nie je potrebné meniť)
  4. Importujte šablónu — TapHome bude pravidelne čítať /status pre zistenie stavu zariadenia

HTTP autentifikácia je na zariadeniach Shelly štandardne vypnutá. Ak ste povolili ochranu prihlásením, TapHome momentálne nepodporuje HTTP Basic Auth — pre integráciu s TapHome ponechajte autentifikáciu vypnutú.

Dostupné zariadenia

Shelly 3EM Gen3 Modul
Servisné atribúty
Wifi
IP adresa
Sila signálu
MAC
Servisné akcie
Aktualizácia FWSpustí aktualizáciu firmvéru na najnovšiu stabilnú verziu
Reštart
Vlastné premenné

Shelly 3EM Gen3

Čítanie (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
Servisné atribúty
Wifi
PARSEJSON(WiFi.GetStatus, "ssid")
${ipAddress}
PARSEJSON(WiFi.GetStatus, "sta_ip")
${xml_signal_strength} [dB]
PARSEJSON(WiFi.GetStatus, "rssi")
MAC
PARSEJSON(Sys.GetStatus, "mac")
Servisné akcie
${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
Celkový elektromer Elektromer Len na čítanie

Kombinovaný trojfázový činný výkon (kW) a celková kumulatívna spotreba energie (kWh)

numeric Jednotka: kW / kWh json_path
Servisné atribúty
Elektrický prúdSúčet prúdov na všetkých troch fázach
Premenná: EM.GetStatus

Celkový elektromer

Čítanie celkovej spotreby
return(parsejson(EMData.GetStatus,"total_act")/1000);
Čítanie odberu
return(parsejson(EM.GetStatus,"total_act_power")/1000);
Servisné atribúty
${electric_current} [A]
return(parsejson(EM.GetStatus,"total_current"));
Elektromer fázy A Elektromer Len na čítanie

Činný výkon fázy A (kW), kumulatívna energia (kWh), napätie, prúd, účinník a frekvencia

numeric Jednotka: kW / kWh json_path
Servisné atribúty
Elektrický prúd
Elektrické napätie
Účinník
Frekvencia siete

Elektromer fázy A

Čítanie celkovej spotreby
return(parsejson(EMData.GetStatus,"a_total_act_energy")/1000);
Čítanie odberu
return(parsejson(EM.GetStatus,"a_act_power")/1000);
Servisné atribúty
${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"));
Elektromer fázy B Elektromer Len na čítanie

Činný výkon fázy B (kW), kumulatívna energia (kWh), napätie, prúd, účinník a frekvencia

numeric Jednotka: kW / kWh json_path
Servisné atribúty
Elektrický prúd
Elektrické napätie
Účinník
Frekvencia siete

Elektromer fázy B

Čítanie celkovej spotreby
return(parsejson(EMData.GetStatus,"b_total_act_energy")/1000);
Čítanie odberu
return(parsejson(EM.GetStatus,"b_act_power")/1000);
Servisné atribúty
${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"));
Elektromer fázy C Elektromer Len na čítanie

Činný výkon fázy C (kW), kumulatívna energia (kWh), napätie, prúd, účinník a frekvencia

numeric Jednotka: kW / kWh json_path
Servisné atribúty
Elektrický prúd
Elektrické napätie
Účinník
Frekvencia siete

Elektromer fázy C

Čítanie celkovej spotreby
return(parsejson(EMData.GetStatus,"c_total_act_energy")/1000);
Čítanie odberu
return(parsejson(EM.GetStatus,"c_act_power")/1000);
Servisné atribúty
${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"));
Pripojenie: Packet Parser → HTTP
Možné vylepšenia (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

Zdroje