--- title: "Shelly Pro 3EM" description: "Shelly Pro 3EM trójfazowy licznik energii z przekładnikami. Monitoruj moc, prąd, napięcie i energię dwukierunkową na fazach przez HTTP w TapHome." url: "https://taphome.com/pl/compatibility/shelly-pro-3-em/" language: pl lastmod: 2026-10-08 generator: hugo ai: topics: ["http","electric-meter","3-phase","wifi","energy-metering","mdns","bidirectional"] questions: ["Jak zintegrować Shelly Pro 3EM z TapHome?","Co mierzy szablon Shelly Pro 3EM w TapHome?","Jak podłączyć Shelly Pro 3EM przez HTTP do TapHome?","Czy TapHome może osobno monitorować pobór z sieci i oddawanie energii do sieci ze Shelly Pro 3EM?","Jaka jest różnica między Shelly Pro 3EM a 3EM Gen3 w TapHome?","Jak używać nazwy hosta mDNS dla Shelly Pro 3EM w TapHome?"] --- # Shelly Pro 3EM Komunikacja: Packet Parser → HTTP - [Strona produktu Shelly Pro 3EM](https://www.shelly.com/en/products/shop/shelly-pro-3-em) > Adres w sieci > > TapHome łączy się z urządzeniem pod adresem podanym przy imporcie. Nadaj urządzeniu stały adres — rezerwację IP w routerze albo jego nazwę mDNS, jeśli ją obsługuje — inaczej integracja przestanie działać, gdy router zmieni adres. > > [Przygotowanie sieci](https://taphome.com/pl/docs/setup/network-preparation/) ## Poradnik integracji Shelly Pro 3EM to profesjonalny trójfazowy licznik energii na szynę DIN, przeznaczony do współpracy z zewnętrznymi przekładnikami prądowymi. Dostępny jest w trzech wariantach — Pro 3EM (CT 120 A), Pro 3EM-400 (CT 400 A) i Pro 3EM-3CT63 (zintegrowane CT 63 A). Urządzenie łączy się z siecią lokalną przez Wi-Fi lub Ethernet (RJ45) i udostępnia pomiary w czasie rzeczywistym przez API HTTP RPC Gen2+. TapHome odpytuje urządzenie przez HTTP na porcie 80 — połączenie z chmurą nie jest wymagane. Szablon zawiera jedenaście urządzeń zorganizowanych w dwukierunkowy pomiar energii: czujniki prądu na każdą fazę (L1, L2, L3), liczniki energii From Grid i To Grid dla każdej fazy oraz całkowite liczniki From Grid i To Grid. Urządzenia From Grid śledzą energię pobieraną z sieci, urządzenia To Grid śledzą energię oddawaną z powrotem (np. z paneli fotowoltaicznych) — wartość mocy jest odwrócona, aby eksport był wyświetlany jako liczba dodatnia. ## Podłączenie sprzętowe Shelly Pro 3EM montuje się na standardowej szynie DIN (94 × 19 × 69 mm). Wymaga czterech wejść napięciowych (trzy przewody fazowe + przewód neutralny) przez zaciski śrubowe oraz czterech wejść dla zewnętrznych CT (trzy fazy + neutralny). Zasilanie odbywa się między dowolną fazą a przewodem neutralnym (100–260 V AC, 50/60 Hz). Główne wskazówki dotyczące okablowania: - **Wejścia napięciowe:** LA, LB, LC (po jednym na fazę) + N (przewód neutralny) - **Wejścia CT:** Trzy CT fazowe + jeden CT neutralny, podłączone do odpowiednich gniazd wejściowych CT - **Ethernet:** Jedno złącze RJ45 do połączenia LAN (przed podłączeniem/odłączeniem kabla LAN odłączyć zasilanie) - **Przekrój przewodu:** 0,5–2,5 mm² (20–14 AWG), długość ściągania izolacji 6–7 mm, maks. moment dokręcania 0,4 Nm > [!WARNING] > Zewnętrzna ochrona powinna być zaprojektowana na maks. 16 A z charakterystyką B lub C i minimalną zdolnością wyłączania 6 kA. Zakres napięcia roboczego wynosi 100–260 V na fazę. ## Konfiguracja Shelly Pro 3EM łączy się przez Wi-Fi lub Ethernet. Podczas importowania szablonu TapHome wprowadź adres IP urządzenia (domyślny symbol zastępczy `192.168.0.1`). ### Uwierzytelnianie TapHome nie obsługuje uwierzytelniania HTTP Digest. Przed dodaniem urządzenia do TapHome upewnij się, że uwierzytelnianie jest **wyłączone** na urządzeniu Shelly. Można to skonfigurować w interfejsie webowym Shelly w menu Ustawienia → Uwierzytelnianie. ### Wybór typu CT Po podłączeniu przekładników prądowych skonfiguruj typ CT przez interfejs webowy Shelly lub wywołując `EM.SetConfig` z odpowiednią wartością `ct_type`. Użyj `EM.GetCTTypes`, aby wyświetlić listę obsługiwanych typów (zazwyczaj `120A` i `400A`). Jeśli typ CT nie jest ustawiony, urządzenie zgłasza błąd `ct_type_not_set` i pomiary nie będą dostępne. ### Kalibracja faza-faza Pro 3EM obsługuje kalibrację kanał-kanał w celu poprawy dokładności pomiaru między fazami. Kalibracja wymaga minimalnego obciążenia 500 W na kanał i trwa około 5 sekund. Użyj `EM.PhaseToPhaseCalib` do kalibracji i `EM.PhaseToPhaseCalibReset` do przywrócenia ustawień fabrycznych. ### Tryb ECO Jeśli tryb ECO jest włączony na urządzeniu Shelly, może to powodować przekroczenia limitu czasu komunikacji z powodu 3-sekundowego interwału odpytywania stosowanego przez TapHome. Wyłącz tryb ECO dla niezawodnego działania. ## Możliwości urządzenia ### Monitorowanie prądu na fazę Trzy czujniki prądu (L1 Current, L2 Current, L3 Current) raportują chwilową wartość prądu w amperach dla każdej fazy, odczytaną bezpośrednio z pól `a_current`, `b_current` i `c_current` w `EM.GetStatus`. Są to proste wartości czujnika bez przeliczania jednostek. ### Dwukierunkowy pomiar energii na fazę Każda faza ma dwa urządzenia licznikowe — From Grid i To Grid: - **L1/L2/L3 From Grid** — moc czynna pobierana z sieci (W, przeliczona na kW) i skumulowana energia pobrana z sieci (Wh, przeliczona na kWh). Każde urządzenie From Grid udostępnia również cztery atrybuty serwisowe: Współczynnik mocy, Prąd [A], Napięcie [V] i Łączna energia oddana do sieci [kWh]. - **L1/L2/L3 To Grid** — moc czynna oddawana do sieci (W, podzielona przez −1000, aby eksport był wyświetlany jako dodatnie kW) i skumulowana energia zwrócona (Wh, przeliczona na kWh). Urządzenia To Grid nie mają atrybutów serwisowych. Atrybuty serwisowe urządzeń From Grid zapewniają kompletny obraz na fazę: chwilowy prąd i napięcie, współczynnik mocy do oceny jakości energii oraz licznik energii zwróconej do śledzenia skumulowanego eksportu obok licznika zużycia From Grid. ### Całkowity dwukierunkowy pomiar energii Dwa urządzenia agregujące podsumowują wszystkie trzy fazy: - **Total From Grid** — łączna trójfazowa moc czynna (kW) i całkowita skumulowana energia pobrana z sieci (kWh) - **Total To Grid** — łączna trójfazowa moc zwrócona (kW, odwrócona) i całkowita skumulowana energia oddana do sieci (kWh) Wszystkie urządzenia używają 3-sekundowego interwału odpytywania odpowiadającego cyklowi odczytu modułu. ### Dodatkowe możliwości Shelly Pro 3EM natywnie udostępnia również moc pozorną na fazę i łączną, pomiar prądu przewodu neutralnego (unikalna cecha modelu Pro — niedostępna w 3EM Gen3), częstotliwość sieci na fazę, łączny prąd we wszystkich fazach oraz diagnostykę modułu (Wi-Fi SSID, adres IP, siła sygnału, adres MAC). Aktualizacja oprogramowania sprzętowego i restart są również dostępne przez API RPC. Wykrywanie błędów kolejności faz i do 60 dni rejestrowania danych z rozdzielczością 1-minutową z eksportem CSV/JSON są obsługiwane natywnie. Te możliwości można dodać w przyszłej aktualizacji szablonu. ## Rozwiązywanie problemów ### Urządzenie nie odpowiada 1. Sprawdź, czy Shelly jest podłączone do Wi-Fi lub LAN i ma prawidłowy adres IP 2. Spróbuj użyć nazwy hosta mDNS (`ShellyPro3EM-XXXXXXXXXXXX.local`) zamiast adresu IP — adres IP mógł ulec zmianie po odnowieniu DHCP 3. Otwórz `http://{adres-ip-urządzenia}/rpc/Shelly.GetDeviceInfo` w przeglądarce — jeśli odpowiada JSON-em, urządzenie jest dostępne 4. Sprawdź, czy TapHome Core i Shelly są w tej samej sieci / VLAN ### Błąd ct_type_not_set Jeśli komponent EM lub EMData zgłasza błąd `ct_type_not_set`, typ przekładnika prądowego nie został skonfigurowany. Ustaw typ CT przez interfejs webowy Shelly lub wywołując `EM.SetConfig` z odpowiednią wartością `ct_type`. Użyj `EM.GetCTTypes`, aby wyświetlić listę obsługiwanych typów. ### Błąd kolejności faz Jeśli błąd `phase_sequence` pojawia się w `EM.GetStatus`, fazy są podłączone w odwrotnej kolejności (A-C-B zamiast A-B-C). Należy albo podłączyć fazy w prawidłowej kolejności, albo wyłączyć `monitor_phase_sequence` w konfiguracji EM, jeśli odwrócona kolejność jest zamierzona. ### Ujemne lub zerowe wartości w urządzeniach To Grid Urządzenia To Grid używają odwróconego przeliczenia (podział przez −1000), aby reprezentować eksport do sieci jako liczbę dodatnią. Jeśli nie ma eksportu (system tylko pobiera energię), wartość mocy To Grid będzie wynosić zero lub będzie ujemna. Jest to oczekiwane zachowanie — urządzenie From Grid śledzi zużycie, urządzenie To Grid śledzi eksport. > [!NOTE] > Urządzenia Shelly Gen2+/Gen3 obsługują do **6 równoczesnych połączeń HTTP**. Każdy system odpytywania (TapHome, Home Assistant itp.) zajmuje połączenia. Unikaj uruchamiania zbyt wielu integracji na tym samym urządzeniu jednocześnie. ## Jak zainstalować w TapHome ### Wymagania wstępne - Urządzenie Shelly zainstalowane i włączone - Lokalna sieć Wi-Fi (2,4 GHz) - TapHome CCU w tej samej sieci ### Krok 1 — Podłącz Shelly do Wi-Fi **Opcja A — Aplikacja Shelly (zalecana):** 1. Pobierz [aplikację Shelly](https://www.shelly.com/en/support/shelly-app) (iOS / Android) 2. Dotknij **+** → **Add Device** i postępuj zgodnie z kreatorem parowania Bluetooth 3. Wprowadź dane logowania Wi-Fi, gdy zostaniesz o to poproszony **Opcja B — Tryb AP (bez aplikacji):** 1. Przy pierwszym uruchomieniu urządzenie tworzy hotspot: `ShellyXXX-AABBCCDDEE` 2. Połącz telefon/PC z tym hotspotem 3. Otwórz `http://192.168.33.1` → **Internet & Security** → **Wi-Fi Mode - Client** 4. Wprowadź SSID i hasło → **Save** > [!NOTE] > Shelly obsługuje tylko sieci **2,4 GHz**. Sieci 5 GHz nie pojawią się podczas skanowania. ### Krok 2 — Znajdź adres IP Po połączeniu z Wi-Fi znajdź przypisany adres IP za pomocą jednej z poniższych metod: - **Aplikacja Shelly:** Szczegóły urządzenia → **Device info** → Adres IP - **Interfejs webowy Shelly:** Połącz się z AP urządzenia przed konfiguracją Wi-Fi — IP zostanie wyświetlone po zapisaniu - **Tabela DHCP routera:** Szukaj nazwy hosta takiej jak `shelly1pm-AABBCCDDEE` - **mDNS:** Pinguj `shelly-.local` (np. `shelly1pm-AABBCCDDEE.local`) z tej samej sieci > [!TIP] > Przypisz urządzeniu Shelly **statyczny IP** (rezerwację DHCP) w routerze, aby adres nie zmieniał się po ponownym uruchomieniu routera. ### Krok 3 — Konfiguracja w TapHome 1. W TapHome dodaj nowy moduł **Packet Parser (HTTP)** 2. **IP Address:** wprowadź IP z kroku 2 (np. `192.168.1.50`) 3. **Port:** `80` (domyślny, nie wymaga zmiany) 4. Zaimportuj szablon — TapHome będzie okresowo odpytywać `/status` w celu odczytu stanu urządzenia > [!NOTE] > Uwierzytelnianie HTTP jest domyślnie wyłączone na urządzeniach Shelly. Jeśli włączyłeś ochronę logowaniem, TapHome obecnie nie obsługuje HTTP Basic Auth — pozostaw uwierzytelnianie wyłączone dla integracji z TapHome. ## Dostępne urządzenia 11 Te urządzenia pojawią się w TapHome po imporcie. Shelly Pro 3 EM Moduł Zmienne niestandardowe Odczyt (moduł) ```taphome 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 Prąd Zmienna Tylko do odczytu numeric Jednostka: A json\_path Odczyt ```taphome todouble(PARSEjson(EMStatus, "a_current")) ``` L1 From Grid Licznik energii Tylko do odczytu Moc czynna fazy A (kW) i skumulowana energia pobrana z sieci (kWh), z napięciem, prądem, współczynnikiem mocy i energią oddaną numeric Jednostka: kW / kWh json\_path Atrybuty serwisowe | | | |--------------------------------|----------------------------------------------------------| | Współczynnik mocy | | | Prąd | | | Napięcie | | | Łączna energia oddana do sieci | Skumulowana energia zwrócona (eksportowana) fazy A w kWh | Odczyt całkowitego zużycia ```taphome todouble(PARSEjson(EMDataStatus, "a_total_act_energy"))/1000 ``` Odczyt zapotrzebowania ```taphome todouble(PARSEjson(EMStatus, "a_act_power"))/1000 ``` Atrybuty serwisowe power factor ```taphome RETURN(todouble(PARSEjson(EMStatus, "a_pf"))); ``` Current \[A] ```taphome RETURN(todouble(PARSEjson(EMStatus, "a_current"))); ``` voltage \[V] ```taphome RETURN(todouble(PARSEjson(EMStatus, "a_voltage"))); ``` Total returned energy \[kWh] ```taphome RETURN(todouble(PARSEjson(EMDataStatus, "a_total_act_ret_energy"))/1000); ``` L1 To Grid Licznik energii Tylko do odczytu Moc zwrócona fazy A (kW, odwrócona) i skumulowana energia oddana do sieci (kWh) numeric Jednostka: kW / kWh json\_path Odczyt całkowitego zużycia ```taphome todouble(PARSEjson(EMDataStatus, "a_total_act_ret_energy"))/1000 ``` Odczyt zapotrzebowania ```taphome todouble(PARSEjson(EMStatus, "a_act_power"))/-1000 ``` L2 Prąd Zmienna Tylko do odczytu numeric Jednostka: A json\_path Odczyt ```taphome todouble(PARSEjson(EMStatus, "b_current")) ``` L2 From Grid Licznik energii Tylko do odczytu Moc czynna fazy B (kW) i skumulowana energia pobrana z sieci (kWh), z napięciem, prądem, współczynnikiem mocy i energią oddaną numeric Jednostka: kW / kWh json\_path Atrybuty serwisowe | | | |--------------------------------|----------------------------------------------------------| | Współczynnik mocy | | | Prąd | | | Napięcie | | | Łączna energia oddana do sieci | Skumulowana energia zwrócona (eksportowana) fazy B w kWh | Odczyt całkowitego zużycia ```taphome todouble(PARSEjson(EMDataStatus, "b_total_act_energy"))/1000 ``` Odczyt zapotrzebowania ```taphome todouble(PARSEjson(EMStatus, "b_act_power"))/1000 ``` Atrybuty serwisowe power factor ```taphome RETURN(todouble(PARSEjson(EMStatus, "b_pf"))); ``` current [A[ ```taphome RETURN(todouble(PARSEjson(EMStatus, "b_current"))); ``` voltage \[V] ```taphome RETURN(todouble(PARSEjson(EMStatus, "b_voltage"))); ``` total returned energy \[kWh] ```taphome RETURN(todouble(PARSEjson(EMDataStatus, "b_total_act_ret_energy"))/1000); ``` L2 To Grid Licznik energii Tylko do odczytu Moc zwrócona fazy B (kW, odwrócona) i skumulowana energia oddana do sieci (kWh) numeric Jednostka: kW / kWh json\_path Odczyt całkowitego zużycia ```taphome todouble(PARSEjson(EMDataStatus, "b_total_act_ret_energy"))/1000 ``` Odczyt zapotrzebowania ```taphome todouble(PARSEjson(EMStatus, "b_act_power"))/-1000 ``` L3 Prąd Zmienna Tylko do odczytu numeric Jednostka: A json\_path Odczyt ```taphome todouble(PARSEjson(EMStatus, "c_current")) ``` L3 From Grid Licznik energii Tylko do odczytu Moc czynna fazy C (kW) i skumulowana energia pobrana z sieci (kWh), z napięciem, prądem, współczynnikiem mocy i energią oddaną numeric Jednostka: kW / kWh json\_path Atrybuty serwisowe | | | |--------------------------------|----------------------------------------------------------| | Współczynnik mocy | | | Prąd | | | Napięcie | | | Łączna energia oddana do sieci | Skumulowana energia zwrócona (eksportowana) fazy C w kWh | Odczyt całkowitego zużycia ```taphome todouble(PARSEjson(EMDataStatus, "c_total_act_energy"))/1000 ``` Odczyt zapotrzebowania ```taphome todouble(PARSEjson(EMStatus, "c_act_power"))/1000 ``` Atrybuty serwisowe power factor ```taphome RETURN(todouble(PARSEjson(EMStatus, "c_pf"))); ``` current \[A] ```taphome RETURN(todouble(PARSEjson(EMStatus, "c_current"))); ``` voltage \[V] ```taphome RETURN(todouble(PARSEjson(EMStatus, "c_voltage"))); ``` Total returned energy \[kWh] ```taphome RETURN(todouble(PARSEjson(EMDataStatus, "c_total_act_ret_energy"))/1000); ``` L3 To Grid Licznik energii Tylko do odczytu Moc zwrócona fazy C (kW, odwrócona) i skumulowana energia oddana do sieci (kWh) numeric Jednostka: kW / kWh json\_path Odczyt całkowitego zużycia ```taphome todouble(PARSEjson(EMDataStatus, "c_total_act_ret_energy"))/1000 ``` Odczyt zapotrzebowania ```taphome todouble(PARSEjson(EMStatus, "c_act_power"))/-1000 ``` Total From Grid Licznik energii Tylko do odczytu Łączna trójfazowa moc czynna (kW) i całkowita skumulowana energia pobrana z sieci (kWh) numeric Jednostka: kW / kWh json\_path Odczyt całkowitego zużycia ```taphome todouble(PARSEjson(EMDataStatus, "total_act"))/1000 ``` Odczyt zapotrzebowania ```taphome todouble(PARSEjson(EMStatus, "total_act_power"))/1000 ``` Total To Grid Licznik energii Tylko do odczytu Łączna trójfazowa moc zwrócona (kW, odwrócona) i całkowita skumulowana energia oddana do sieci (kWh) numeric Jednostka: kW / kWh json\_path Odczyt całkowitego zużycia ```taphome todouble(PARSEjson(EMDataStatus, "total_act_ret"))/1000 ``` Odczyt zapotrzebowania ```taphome todouble(PARSEjson(EMStatus, "total_act_power"))/-1000 ``` **Połączenie:** Packet Parser → HTTP • Hostname: `ShellyPro3EM-{MAC}.local` Możliwe ulepszenia (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 ## Parametry importu Te wartości podajesz podczas importu pliku XML. | Pytanie w aplikacji | Domyślnie | |---------------------|---------------| | Adres IP | `192.168.0.1` | ## Źródła - Shelly Gen2+ RPC API Reference [shelly-api-docs.shelly.cloud](https://shelly-api-docs.shelly.cloud/gen2/) 2026-03-28 - Shelly Gen2+ Sys Component API [shelly-api-docs.shelly.cloud](https://shelly-api-docs.shelly.cloud/gen2/ComponentsAndServices/Sys/) 2026-03-28 - Shelly Gen2+ WiFi Component API [shelly-api-docs.shelly.cloud](https://shelly-api-docs.shelly.cloud/gen2/ComponentsAndServices/WiFi/) 2026-03-28 - Home Assistant Shelly Integration (Gen2+) [www.home-assistant.io](https://www.home-assistant.io/integrations/shelly/) 2026-03-28 - Shelly Pro 3EM Knowledge Base [kb.shelly.cloud](https://kb.shelly.cloud/knowledge-base/shelly-pro-3em) 2026-03-28 - Shelly Gen2+ EM Component API [shelly-api-docs.shelly.cloud](https://shelly-api-docs.shelly.cloud/gen2/ComponentsAndServices/EM/) 2026-03-28 - Shelly Gen2+ EMData Component API [shelly-api-docs.shelly.cloud](https://shelly-api-docs.shelly.cloud/gen2/ComponentsAndServices/EMData/) 2026-03-28 ## Powiązana dokumentacja - [Integracja Packet Parser](https://taphome.com/pl/compatibility/packet-parser-guide/) - [Packet Parser (HTTP, TCP, UDP, FTP, MQTT)](https://taphome.com/pl/docs/integration/packet-parser/) - [Funkcje Packet parser](https://taphome.com/pl/docs/script/packet-parser/) - [Funkcje parsowania](https://taphome.com/pl/docs/script/parsing-functions/)