TapHome

Shelly Pro 3EM

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

Shelly Pro 3EM je profesionální třífázový elektroměr na DIN lištu určený pro použití s externími proudovými transformátory. Je dostupný ve třech variantách — Pro 3EM (CT 120 A), Pro 3EM-400 (CT 400 A) a Pro 3EM-3CT63 (integrované CT 63 A). Zařízení se připojuje do lokální sítě přes Wi-Fi nebo Ethernet (RJ45) a poskytuje měření v reálném čase prostřednictvím Gen2+ HTTP RPC API. TapHome posílá HTTP požadavky na port 80 — cloudové připojení není potřeba.

Šablona obsahuje jedenáct zařízení organizovaných do obousměrného měření energie: snímače proudu na každou fázi (L1, L2, L3), elektroměry From Grid a To Grid pro každou fázi a celkové elektroměry From Grid a To Grid. Zařízení From Grid sledují energii odebíranou ze sítě, zařízení To Grid sledují energii dodávanou zpět (např. ze solárních panelů) — hodnota výkonu je invertována, aby se export zobrazoval jako kladné číslo.

Hardwarové zapojení

Shelly Pro 3EM se montuje na standardní DIN lištu (94 × 19 × 69 mm). Vyžaduje čtyři vstupní napěťové svorky (tři fázové vodiče + nulový vodič) a čtyři vstupy pro externí CT (tři fáze + nulový vodič). Napájení je mezi libovolnou fází a nulovým vodičem (100–260 V AC, 50/60 Hz).

Hlavní pokyny pro zapojení:

  • Napěťové vstupy: LA, LB, LC (po jednom na každou fázi) + N (nulový vodič)
  • Vstupy CT: Tři fázové CT + jeden nulový CT, zapojené do příslušných konektorů CT
  • Ethernet: Jeden konektor RJ45 pro LAN (před zasunutím nebo vytažením LAN kabelu odpojte napájení)
  • Průřez vodiče: 0,5–2,5 mm² (20–14 AWG), odizolování 6–7 mm, max. krouticí moment 0,4 Nm

Externí ochrana musí být dimenzována na max. 16 A s charakteristikou B nebo C a minimální vypínací kapacitou 6 kA. Provozní napětí je 100–260 V na fázi.

Konfigurace

Shelly Pro 3EM se připojuje přes Wi-Fi nebo Ethernet. Při importu šablony TapHome zadejte IP adresu zařízení (výchozí placeholder 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 vypnuta. Nastavení najdete ve webovém rozhraní Shelly pod Nastavení → Autentizace.

Výběr typu CT

Po připojení proudových transformátorů nastavte typ CT přes webové rozhraní Shelly nebo voláním EM.SetConfig s příslušnou hodnotou ct_type. Pomocí EM.GetCTTypes zobrazíte podporované typy (obvykle 120A a 400A). Pokud typ CT není nastaven, zařízení hlásí chybu ct_type_not_set a měření nebudou dostupná.

Kalibrace mezi fázemi

Pro 3EM podporuje kalibraci mezi kanály pro zlepšení přesnosti měření. Kalibrace vyžaduje minimální zátěž 500 W na kanál a trvá přibližně 5 sekund. Použijte EM.PhaseToPhaseCalib pro kalibraci a EM.PhaseToPhaseCalibReset pro obnovení továrního nastavení.

ECO režim

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

Možnosti zařízení

Měření proudu na fázi

Tři snímače proudu (L1 Current, L2 Current, L3 Current) zobrazují okamžitou hodnotu proudu v ampérech pro každou fázi, načítanou přímo z polí a_current, b_current a c_current v EM.GetStatus. Jde o jednoduché hodnoty bez konverze jednotek.

Obousměrné měření energie na fázi

Každá fáze má dvě zařízení — From Grid a To Grid:

  • L1/L2/L3 From Grid — činný výkon odebíraný ze sítě (W, konvertovaný na kW) a kumulativní spotřeba ze sítě (Wh, konvertovaná na kWh). Každé zařízení From Grid také obsahuje čtyři servisní atributy: Účiník, Proud [A], Napětí [V] a Celková vrácená energie [kWh].
  • L1/L2/L3 To Grid — činný výkon dodávaný do sítě (W, dělený −1000, aby se export zobrazoval jako kladné kW) a kumulativní vrácená energie (Wh, konvertovaná na kWh). Zařízení To Grid nemají servisní atributy.

Servisní atributy zařízení From Grid poskytují kompletní přehled na fázi: okamžitý proud a napětí, účiník pro hodnocení kvality energie a počítadlo vrácené energie pro sledování kumulativního exportu vedle počítadla spotřeby From Grid.

Celkové obousměrné měření energie

Dvě souhrnná zařízení sumarizují všechny tři fáze:

  • Total From Grid — kombinovaný třífázový činný výkon (kW) a celková kumulativní spotřeba ze sítě (kWh)
  • Total To Grid — kombinovaný třífázový vrácený výkon (kW, invertovaný) a celková kumulativní energie dodaná do sítě (kWh)

Všechna zařízení používají 3sekundový interval dotazů odpovídající cyklu čtení modulu.

Další možnosti

Shelly Pro 3EM nativně poskytuje také zdánlivý výkon na fázi a celkový, měření proudu nulového vodiče (unikátní vlastnost modelu Pro — není dostupná na 3EM Gen3), frekvenci sítě na fázi, celkový proud přes všechny fáze a diagnostiku modulu (Wi-Fi SSID, IP adresa, síla signálu, MAC adresa). Aktualizace firmwaru a restart jsou rovněž dostupné přes RPC API. Detekce chyby sledu fází a až 60 dní záznamu dat s minutovým rozlišením s exportem do CSV/JSON jsou podporovány nativně. Tyto možnosti lze přidat v budoucí aktualizaci šablony.

Řešení problémů

Zařízení nereaguje
  1. Ověřte, že Shelly je připojeno k Wi-Fi nebo LAN a má platnou IP adresu
  2. Zkuste použít mDNS hostname (ShellyPro3EM-XXXXXXXXXXXX.local) místo IP adresy — IP adresa se mohla změnit po obnově DHCP
  3. Otevřete http://{ip-zarízení}/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 komponenta EM nebo EMData hlásí chybu ct_type_not_set, typ proudového transformátoru nebyl nastaven. Nastavte typ CT přes webové rozhraní Shelly nebo voláním EM.SetConfig s příslušnou hodnotou ct_type. Pomocí EM.GetCTTypes zobrazíte podporované typy.

Chyba sledu fází

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

Záporné nebo nulové hodnoty na zařízeních To Grid

Zařízení To Grid používají invertovanou konverzi (dělení −1000), aby zobrazovala export do sítě jako kladné číslo. Pokud žádný export neprobíhá (systém pouze spotřebovává), hodnota výkonu To Grid bude nulová nebo záporná. Toto je očekávané chování — zařízení From Grid sleduje spotřebu, zařízení To Grid sleduje export.

Zařízení Shelly Gen2+/Gen3 podporují až 6 souběžných HTTP připojení. Každý systém dotazování (TapHome, Home Assistant atd.) spotřebovává připojení. Vyhněte se spouštění příliš mnoha integrací na stejném zařízení současně.

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 Pro 3 EM Modul
Vlastní proměnné

Shelly Pro 3 EM

Čtení (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 Proud Proměnná Pouze ke čtení
numeric Jednotka: A json_path

L1 Proud

Čtení
todouble(PARSEjson(EMStatus, "a_current"))
L1 From Grid Elektroměr Pouze ke čtení

Činný výkon fáze A (kW) a kumulativní spotřeba ze sítě (kWh), s napětím, proudem, účiníkem a vrácenou energií

numeric Jednotka: kW / kWh json_path
Servisní atributy
Účiník
Proud
Napětí
Celková vrácená energieKumulativní vrácená (exportovaná) energie fáze A v kWh

L1 From Grid

Čtení celkové spotřeby
todouble(PARSEjson(EMDataStatus, "a_total_act_energy"))/1000
Čtení odběru
todouble(PARSEjson(EMStatus, "a_act_power"))/1000
Servisní atributy
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 Elektroměr Pouze ke čtení

Vrácený výkon fáze A (kW, invertovaný) a kumulativní energie dodaná do sítě (kWh)

numeric Jednotka: kW / kWh json_path

L1 To Grid

Čtení celkové spotřeby
todouble(PARSEjson(EMDataStatus, "a_total_act_ret_energy"))/1000
Čtení odběru
todouble(PARSEjson(EMStatus, "a_act_power"))/-1000
L2 Proud Proměnná Pouze ke čtení
numeric Jednotka: A json_path

L2 Proud

Čtení
todouble(PARSEjson(EMStatus, "b_current"))
L2 From Grid Elektroměr Pouze ke čtení

Činný výkon fáze B (kW) a kumulativní spotřeba ze sítě (kWh), s napětím, proudem, účiníkem a vrácenou energií

numeric Jednotka: kW / kWh json_path
Servisní atributy
Účiník
Proud
Napětí
Celková vrácená energieKumulativní vrácená (exportovaná) energie fáze B v kWh

L2 From Grid

Čtení celkové spotřeby
todouble(PARSEjson(EMDataStatus, "b_total_act_energy"))/1000
Čtení odběru
todouble(PARSEjson(EMStatus, "b_act_power"))/1000
Servisní atributy
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 Elektroměr Pouze ke čtení

Vrácený výkon fáze B (kW, invertovaný) a kumulativní energie dodaná do sítě (kWh)

numeric Jednotka: kW / kWh json_path

L2 To Grid

Čtení celkové spotřeby
todouble(PARSEjson(EMDataStatus, "b_total_act_ret_energy"))/1000
Čtení odběru
todouble(PARSEjson(EMStatus, "b_act_power"))/-1000
L3 Proud Proměnná Pouze ke čtení
numeric Jednotka: A json_path

L3 Proud

Čtení
todouble(PARSEjson(EMStatus, "c_current"))
L3 From Grid Elektroměr Pouze ke čtení

Činný výkon fáze C (kW) a kumulativní spotřeba ze sítě (kWh), s napětím, proudem, účiníkem a vrácenou energií

numeric Jednotka: kW / kWh json_path
Servisní atributy
Účiník
Proud
Napětí
Celková vrácená energieKumulativní vrácená (exportovaná) energie fáze C v kWh

L3 From Grid

Čtení celkové spotřeby
todouble(PARSEjson(EMDataStatus, "c_total_act_energy"))/1000
Čtení odběru
todouble(PARSEjson(EMStatus, "c_act_power"))/1000
Servisní atributy
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 Elektroměr Pouze ke čtení

Vrácený výkon fáze C (kW, invertovaný) a kumulativní energie dodaná do sítě (kWh)

numeric Jednotka: kW / kWh json_path

L3 To Grid

Čtení celkové spotřeby
todouble(PARSEjson(EMDataStatus, "c_total_act_ret_energy"))/1000
Čtení odběru
todouble(PARSEjson(EMStatus, "c_act_power"))/-1000
Total From Grid Elektroměr Pouze ke čtení

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

numeric Jednotka: kW / kWh json_path

Total From Grid

Čtení celkové spotřeby
todouble(PARSEjson(EMDataStatus, "total_act"))/1000
Čtení odběru
todouble(PARSEjson(EMStatus, "total_act_power"))/1000
Total To Grid Elektroměr Pouze ke čtení

Kombinovaný třífázový vrácený výkon (kW, invertovaný) a celková kumulativní energie dodaná do sítě (kWh)

numeric Jednotka: kW / kWh json_path

Total To Grid

Čtení celkové spotřeby
todouble(PARSEjson(EMDataStatus, "total_act_ret"))/1000
Čtení odběru
todouble(PARSEjson(EMStatus, "total_act_power"))/-1000
Připojení: Packet Parser → HTTP
Možná vylepšení (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

Zdroje