TapHome

Shelly 3EM Gen3

Packet Parser → HTTP
Přidal
Poslední aktualizace: 03. 2026
Shelly 3EM Gen3

Shelly 3EM Gen3 je třífázový elektroměr na DIN lištu s integrovanými proudovými transformátory (do 63 A na fázi). Připojuje se k lokální síti přes Wi-Fi a poskytuje měření v reálném čase prostřednictvím HTTP RPC API Gen2+/Gen3. TapHome zařízení dotazuje přes HTTP na portu 80 — připojení do cloudu není potřeba.

Šablona poskytuje čtyři zařízení typu elektroměr: jeden celkový měřič a tři měřiče jednotlivých fází (A, B, C). Každý měřič zobrazuje okamžitý činný výkon a kumulativní spotřebu energie, přičemž měřiče jednotlivých fází navíc poskytují napětí, proud, účiník a frekvenci sítě jako servisní atributy.

Hardwarové zapojení

Shelly 3EM Gen3 je dostupný ve dvou variantách — 3EM-63W (kabelový model) a 3EM-63T (model s plochými svorkami). Oba se montují nad nebo pod jističe na DIN lištu.

Zařízení vyžaduje zapojení Y (hvězda) se 4 vodiči:

  • LA, LB, LC — tři fázové vstupy, jeden na fázi
  • N — nulový vodič
  • Napájení je odebíráno mezi fází LA a nulovým vodičem (220-240 V~ 50/60 Hz)

Externí ochrana by měla být dimenzována na 63 A s charakteristikou B nebo C a jmenovitým vypínacím proudem 6 kA.

Maximální bezpečné provozní napětí je 280 V na fázi. Rozsah proudu je 0-63 A se saturací 130 A. Překročení těchto limitů může poškodit zařízení.

Konfigurace

Shelly 3EM Gen3 se připojuje přes Wi-Fi. Během importu šablony v TapHome zadejte IP adresu zařízení (výchozí zástupný text 192.168.0.1).

Autentizace

TapHome nepodporuje HTTP Digest Authentication. Před přidáním zařízení do TapHome se ujistěte, že autentizace je na zařízení Shelly vypnutá. Toto nastavení najdete ve webovém rozhraní Shelly v části Settings → Authentication.

Výběr profilu

Shelly 3EM Gen3 podporuje dva profily — Triphase (výchozí) a Monophase. Šablona TapHome je navržena pro profil Triphase, který poskytuje jeden EM komponent (em:0) s měřeními pro každou fázi i celkovými hodnotami. Ujistěte se, že zařízení je nastaveno na profil Triphase (tovární výchozí).

ECO režim

Pokud je na zařízení Shelly povolen ECO režim, může způsobovat výpadky komunikace kvůli 3sekundovému intervalu dotazování modulu v TapHome. Pro spolehlivý provoz ECO režim vypněte.

Možnosti zařízení

Celkové měření energie

Zařízení Celkový elektroměr poskytuje souhrnný pohled na všechny tři fáze:

  • Činný výkon — total_act_power z EM.GetStatus, převedený z W na kW (děleno 1000)
  • Kumulativní energie — total_act z EMData.GetStatus, převedená z Wh na kWh (děleno 1000)
  • Celkový proud (servisní atribut) — součet proudů na všech třech fázích
Měření energie po fázích

Tři individuální měřiče fází (Fáze A, Fáze B, Fáze C) poskytují detailní měření pro každou fázi. Každý měřič fáze zobrazuje:

  • Činný výkon — okamžitý výkon v kW (převedený z W)
  • Kumulativní energie — celková spotřeba energie v kWh (převedená z Wh)

Každý měřič fáze navíc poskytuje čtyři servisní atributy:

  • Elektrický proud — fázový proud v A
  • Elektrické napětí — fázové napětí ve V
  • Účiník — bezrozměrný poměr činného a zdánlivého výkonu
  • Frekvence sítě — frekvence sítě v Hz

Měřiče fází používají 15sekundový interval dotazování (oproti 3sekundovému intervalu modulu), což je dostatečné pro účely monitorování energie.

Diagnostika modulu

Šablona poskytuje čtyři servisní atributy na úrovni modulu:

  • Wifi — SSID připojené Wi-Fi sítě
  • IP adresa — IP adresa zařízení v lokální síti
  • Síla signálu — Wi-Fi RSSI v dBm
  • MAC — MAC adresa zařízení

K dispozici jsou dvě servisní akce:

  • Aktualizace FW — spustí aktualizaci firmwaru na nejnovější stabilní verzi
  • Restart — spustí restart zařízení

Čtecí skript modulu také kontroluje dostupné aktualizace firmwaru a požadavky na restart, přičemž v TapHome zobrazí varování, pokud je zjištěna některá z těchto podmínek.

Další možnosti

Shelly 3EM Gen3 také poskytuje zdánlivý výkon na fázi i celkový, proud na nulovém vodiči a počítadla vrácené (dodané do sítě) energie na fázi i celkově. K dispozici je nativní detekce chyb sledu fází a ukládání historických dat s 1minutovým rozlišením. Tyto možnosti mohou být přidány v budoucí aktualizaci šablony.

Řešení problémů

Zařízení neodpovídá
  1. Ověřte, že Shelly je připojen k Wi-Fi a má platnou IP adresu
  2. Zkuste použít mDNS hostname (Shelly3EM63G3-XXXXXXXXXXXX.local) místo IP adresy — IP adresa se mohla změnit po obnovení DHCP
  3. Otevřete http://{device-ip}/rpc/Shelly.GetDeviceInfo v prohlížeči — pokud odpoví JSON, zařízení je dostupné
  4. Zkontrolujte, že TapHome Core a Shelly jsou ve stejné síti / VLAN
Chyba ct_type_not_set

Pokud EM komponent hlásí chybu ct_type_not_set, typ proudového transformátoru nebyl nakonfigurován. Nastavte typ CT přes webové rozhraní Shelly nebo voláním EM.SetConfig s příslušnou hodnotou ct_type. Použijte EM.GetCTTypes pro zobrazení podporovaných typů.

Chyba sledu fází

Pokud se v EM.GetStatus objeví chyba phase_sequence, fáze jsou zapojeny v opačném pořadí (A-C-B místo A-B-C). Buď předrátujte fáze ve správném pořadí, nebo povolte monitor_phase_sequence v konfiguraci EM pro potlačení chyby, pokud je obrácené pořadí záměrné.

Zařízení Shelly Gen2+/Gen3 podporují až 6 souběžných HTTP připojení. To je více než zařízení Gen1 (2 připojení), ale mějte na paměti, že každý systém dotazování (TapHome, Home Assistant apod.) spotřebovává připojení. Vyhněte se současnému používání příliš mnoha integrací na jednom zařízení.

Jak nainstalovat v TapHome

Předpoklady

  • Zařízení Shelly nainstalované a zapnuté
  • Lokální Wi-Fi síť (2,4 GHz)
  • TapHome CCU ve stejné síti

Krok 1 — Připojte Shelly k Wi-Fi

Možnost A — Aplikace Shelly (doporučeno):

  1. Stáhněte si aplikaci Shelly (iOS / Android)
  2. Klepněte na + → Add Device a postupujte podle průvodce Bluetooth párováním
  3. Po výzvě zadejte své Wi-Fi přihlašovací údaje

Možnost B — AP režim (bez aplikace):

  1. Při prvním zapnutí zařízení vytvoří hotspot: ShellyXXX-AABBCCDDEE
  2. Připojte telefon/PC k tomuto hotspotu
  3. Otevřete http://192.168.33.1 → Internet & Security → Wi-Fi Mode - Client
  4. Zadejte SSID a heslo → Save

Shelly podporuje pouze 2,4 GHz sítě. 5 GHz sítě se při skenování nezobrazí.

Krok 2 — Zjistěte IP adresu

Po připojení k Wi-Fi zjistěte přiřazenou IP adresu jedním z následujících způsobů:

  • Aplikace Shelly: Detail zařízení → Device info → IP adresa
  • Webové rozhraní Shelly: Připojte se k AP zařízení před nastavením Wi-Fi — IP se zobrazí po uložení
  • DHCP tabulka routeru: Hledejte hostname jako shelly1pm-AABBCCDDEE
  • mDNS: Pingněte shelly<model>-<mac>.local (např. shelly1pm-AABBCCDDEE.local) ze stejné sítě

Přiřaďte zařízení Shelly statickou IP (DHCP rezervaci) ve vašem routeru, aby se adresa nezměnila po restartu routeru.

Krok 3 — Konfigurace v TapHome

  1. V TapHome přidejte nový modul Packet Parser (HTTP)
  2. IP Address: zadejte IP z kroku 2 (např. 192.168.1.50)
  3. Port: 80 (výchozí, není potřeba měnit)
  4. Importujte šablonu — TapHome bude pravidelně číst /status pro zjištění stavu zařízení

HTTP autentifikace je na zařízeních Shelly standardně vypnutá. Pokud jste povolili ochranu přihlášením, TapHome momentálně nepodporuje HTTP Basic Auth — pro integraci s TapHome ponechte autentifikaci vypnutou.

Dostupná zařízení

Shelly 3EM Gen3 Modul
Servisní atributy
Wifi
IP adresa
Síla signálu
MAC
Servisní akce
Aktualizace FWSpustí aktualizaci firmwaru na nejnovější stabilní verzi
Restart
Vlastní proměnné

Shelly 3EM Gen3

Čtení (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í atributy
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í akce
${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ý elektroměr Elektroměr Pouze ke čtení

Kombinovaný třífázový činný výkon (kW) a celková kumulativní spotřeba energie (kWh)

numeric Jednotka: kW / kWh json_path
Servisní atributy
Elektrický proudSoučet proudů na všech třech fázích
Proměnná: EM.GetStatus

Celkový elektroměr

Čtení celkové spotřeby
return(parsejson(EMData.GetStatus,"total_act")/1000);
Čtení odběru
return(parsejson(EM.GetStatus,"total_act_power")/1000);
Servisní atributy
${electric_current} [A]
return(parsejson(EM.GetStatus,"total_current"));
Elektroměr fáze A Elektroměr Pouze ke čtení

Činný výkon fáze A (kW), kumulativní energie (kWh), napětí, proud, účiník a frekvence

numeric Jednotka: kW / kWh json_path
Servisní atributy
Elektrický proud
Elektrické napětí
Účiník
Frekvence sítě

Elektroměr fáze A

Čtení celkové spotřeby
return(parsejson(EMData.GetStatus,"a_total_act_energy")/1000);
Čtení odběru
return(parsejson(EM.GetStatus,"a_act_power")/1000);
Servisní atributy
${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"));
Elektroměr fáze B Elektroměr Pouze ke čtení

Činný výkon fáze B (kW), kumulativní energie (kWh), napětí, proud, účiník a frekvence

numeric Jednotka: kW / kWh json_path
Servisní atributy
Elektrický proud
Elektrické napětí
Účiník
Frekvence sítě

Elektroměr fáze B

Čtení celkové spotřeby
return(parsejson(EMData.GetStatus,"b_total_act_energy")/1000);
Čtení odběru
return(parsejson(EM.GetStatus,"b_act_power")/1000);
Servisní atributy
${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"));
Elektroměr fáze C Elektroměr Pouze ke čtení

Činný výkon fáze C (kW), kumulativní energie (kWh), napětí, proud, účiník a frekvence

numeric Jednotka: kW / kWh json_path
Servisní atributy
Elektrický proud
Elektrické napětí
Účiník
Frekvence sítě

Elektroměr fáze C

Čtení celkové spotřeby
return(parsejson(EMData.GetStatus,"c_total_act_energy")/1000);
Čtení odběru
return(parsejson(EM.GetStatus,"c_act_power")/1000);
Servisní atributy
${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"));
Připojení: Packet Parser → HTTP
Možná vylepšení (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