---
title: "Shelly 3EM Gen3"
description: "Shelly 3EM Gen3 trójfazowy licznik energii z Wi-Fi. Monitoruj moc, napięcie, prąd i energię na wszystkich trzech fazach przez HTTP z TapHome."
url: "https://taphome.com/pl/compatibility/shelly-3em-gen3/"
language: pl
lastmod: 2026-10-08
generator: hugo
ai:
  topics: ["http","electric-meter","3-phase","wifi","energy-metering","mdns"]
  questions: ["Jak zintegrować Shelly 3EM Gen3 z TapHome?","Co mierzy szablon Shelly 3EM Gen3 w TapHome?","Jak podłączyć Shelly 3EM Gen3 przez HTTP do TapHome?","Czy TapHome może monitorować poszczególne fazy z Shelly 3EM Gen3?","Jak użyć nazwy hosta mDNS dla Shelly 3EM Gen3 w TapHome?","Dlaczego Shelly 3EM Gen3 wyświetla błąd ct_type_not_set?"]
---

# Shelly 3EM Gen3

Komunikacja: Packet Parser → HTTP

- [Strona produktu Shelly 3EM Gen3](https://www.shelly.com/en/products/shop/shelly-3em-gen3)

> 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 3EM Gen3 to trójfazowy licznik energii na szynę DIN ze zintegrowanymi przekładnikami prądowymi (do 63 A na fazę). Łączy się z siecią lokalną przez Wi-Fi i udostępnia pomiary w czasie rzeczywistym za pośrednictwem HTTP RPC API Gen2+/Gen3. TapHome odpytuje urządzenie przez HTTP na porcie 80 — połączenie z chmurą nie jest wymagane.

Szablon udostępnia cztery urządzenia typu licznik energii: jeden zbiorczy licznik całkowity i trzy liczniki poszczególnych faz (A, B, C). Każdy licznik wyświetla chwilową moc czynną i skumulowane zużycie energii, a liczniki poszczególnych faz dodatkowo udostępniają napięcie, prąd, współczynnik mocy i częstotliwość sieci jako atrybuty serwisowe.

## Podłączenie sprzętowe

Shelly 3EM Gen3 jest dostępny w dwóch wariantach — 3EM-63W (model kablowy) i 3EM-63T (model z płaskimi zaciskami). Oba montuje się nad lub pod wyłącznikami na szynie DIN.

Urządzenie wymaga podłączenia Y (gwiazda) z 4 przewodami:

- **LA, LB, LC** — trzy wejścia fazowe, jedno na fazę
- **N** — przewód neutralny
- Zasilanie pobierane jest między fazą LA a przewodem neutralnym (220-240 V~ 50/60 Hz)

Zabezpieczenie zewnętrzne powinno być dobrane na 63 A z charakterystyką B lub C i zdolnością zwarciową 6 kA.

> [!WARNING]
> Maksymalne bezpieczne napięcie robocze to 280 V na fazę. Zakres prądu wynosi 0-63 A z nasyceniem 130 A. Przekroczenie tych limitów może uszkodzić urządzenie.

## Konfiguracja

Shelly 3EM Gen3 łączy się przez Wi-Fi. Podczas importu szablonu w TapHome wprowadź adres IP urządzenia (domyślny symbol zastępczy `192.168.0.1`).

### Uwierzytelnianie

TapHome nie obsługuje HTTP Digest Authentication. Upewnij się, że uwierzytelnianie jest **wyłączone** na urządzeniu Shelly przed dodaniem go do TapHome. Można to skonfigurować w interfejsie webowym Shelly w sekcji Settings → Authentication.

### Wybór profilu

Shelly 3EM Gen3 obsługuje dwa profile — **Triphase** (domyślny) i **Monophase**. Szablon TapHome jest zaprojektowany dla profilu Triphase, który udostępnia jeden komponent EM (`em:0`) z pomiarami dla każdej fazy oraz wartościami całkowitymi. Upewnij się, że urządzenie jest ustawione na profil Triphase (domyślne ustawienie fabryczne).

### Tryb ECO

Jeśli tryb ECO jest włączony na urządzeniu Shelly, może powodować przekroczenia czasu komunikacji z powodu 3-sekundowego interwału odpytywania modułu TapHome. Wyłącz tryb ECO dla niezawodnej pracy.

## Funkcje urządzenia

### Całkowity pomiar energii

Urządzenie Całkowity licznik energii zapewnia zbiorczy widok wszystkich trzech faz:

- **Moc czynna** — `total_act_power` z `EM.GetStatus`, przeliczona z W na kW (podzielone przez 1000)
- **Energia skumulowana** — `total_act` z `EMData.GetStatus`, przeliczona z Wh na kWh (podzielone przez 1000)
- **Prąd elektryczny** (atrybut serwisowy) — suma prądu na wszystkich trzech fazach

### Pomiar energii na fazę

Trzy indywidualne liczniki faz (Faza A, Faza B, Faza C) zapewniają szczegółowe pomiary dla każdej fazy. Każdy licznik fazy wyświetla:

- **Moc czynna** — moc chwilowa w kW (przeliczona z W)
- **Energia skumulowana** — całkowite zużycie energii w kWh (przeliczone z Wh)

Każdy licznik fazy udostępnia również cztery atrybuty serwisowe:

- **Prąd elektryczny** — prąd fazowy w A
- **Napięcie elektryczne** — napięcie fazowe w V
- **Współczynnik mocy** — bezwymiarowy stosunek mocy czynnej do pozornej
- **Częstotliwość sieci** — częstotliwość sieci w Hz

Liczniki faz używają 15-sekundowego interwału odpytywania (w porównaniu z 3-sekundowym interwałem modułu), co jest wystarczające do monitorowania energii.

### Diagnostyka modułu

Szablon udostępnia cztery atrybuty serwisowe na poziomie modułu:

- **Wifi** — SSID połączonej sieci Wi-Fi
- **Adres IP** — adres IP urządzenia w sieci lokalnej
- **Siła sygnału** — Wi-Fi RSSI w dBm
- **MAC** — adres MAC urządzenia

Dostępne są dwie akcje serwisowe:

- **Aktualizacja FW** — uruchamia aktualizację firmware do najnowszej stabilnej wersji
- **Restart** — uruchamia restart urządzenia

Skrypt odczytu modułu sprawdza również dostępne aktualizacje firmware i oczekujące wymagania restartu, wyświetlając ostrzeżenia w TapHome po wykryciu któregokolwiek z tych warunków.

### Dodatkowe funkcje

Shelly 3EM Gen3 udostępnia również moc pozorną na fazę i całkowitą, prąd przewodu neutralnego oraz liczniki energii zwróconej (oddanej do sieci) na fazę i całkowite. Wykrywanie błędów kolejności faz i przechowywanie danych historycznych z rozdzielczością 1 minuty są dostępne natywnie. Te funkcje mogą zostać dodane w przyszłej aktualizacji szablonu.

## Rozwiązywanie problemów

### Urządzenie nie odpowiada

1. Sprawdź, czy Shelly jest połączony z Wi-Fi i ma prawidłowy adres IP
2. Spróbuj użyć nazwy hosta mDNS (`Shelly3EM63G3-XXXXXXXXXXXX.local`) zamiast adresu IP — adres IP mógł się zmienić po odnowieniu DHCP
3. Otwórz `http://{device-ip}/rpc/Shelly.GetDeviceInfo` w przeglądarce — jeśli odpowiada JSON, urządzenie jest osiągalne
4. Sprawdź, czy TapHome Core i Shelly są w tej samej sieci / VLAN

### Błąd ct_type_not_set

Jeśli komponent EM 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ć obsługiwane typy.

### 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). Podłącz fazy w prawidłowej kolejności lub wyłącz `monitor_phase_sequence` w konfiguracji EM, aby ukryć błąd, jeśli odwrotna kolejność jest zamierzona.

> [!NOTE]
> Urządzenia Shelly Gen2+/Gen3 obsługują do **6 jednoczesnych połączeń HTTP**. To więcej niż urządzenia Gen1 (2 połączenia), ale pamiętaj, że każdy system odpytywania (TapHome, Home Assistant itp.) zużywa połączenia. Unikaj uruchamiania zbyt wielu integracji jednocześnie na tym samym urządzeniu.

## 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<model>-<mac>.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 4

Te urządzenia pojawią się w TapHome po imporcie.

Shelly 3EM Gen3 Moduł

Atrybuty serwisowe

|              |
|--------------|
| Wifi         |
| Adres IP     |
| Siła sygnału |
| MAC          |

Akcje serwisowe

|                 |                                                                |
|-----------------|----------------------------------------------------------------|
| Aktualizacja FW | Uruchamia aktualizację firmware do najnowszej stabilnej wersji |
| Restart         |                                                                |

Zmienne niestandardowe

Odczyt (moduł)

```taphome
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
```

Atrybuty serwisowe

Wifi

```taphome
PARSEJSON(WiFi.GetStatus, "ssid")
```

${ipAddress}

```taphome
PARSEJSON(WiFi.GetStatus, "sta_ip")
```

${xml\_signal\_strength} \[dB]

```taphome
PARSEJSON(WiFi.GetStatus, "rssi")
```

MAC

```taphome
PARSEJSON(Sys.GetStatus, "mac")
```

Akcje serwisowe

${xml\_update\_fw}

```taphome
VAR response := SENDHTTPREQUEST("/rpc/Shelly.Update?stage=\"stable\"");
IF response.IsSuccess
    return("OK");
else
    return("Error");
END

```

Reboot

```taphome
VAR response := SENDHTTPREQUEST("/rpc/Shelly.Reboot");
IF response.IsSuccess
    return("OK");
else
    return("Error");
END
```

Całkowity licznik energii Licznik energii Tylko do odczytu

Łączna trójfazowa moc czynna (kW) i całkowite skumulowane zużycie energii (kWh)

numeric Jednostka: kW / kWh json\_path

Atrybuty serwisowe

|                  |                                        |
|------------------|----------------------------------------|
| Prąd elektryczny | Suma prądu na wszystkich trzech fazach |

Zmienna: `EM.GetStatus`

Odczyt całkowitego zużycia

```taphome
return(parsejson(EMData.GetStatus,"total_act")/1000);
```

Odczyt zapotrzebowania

```taphome
return(parsejson(EM.GetStatus,"total_act_power")/1000);
```

Atrybuty serwisowe

${electric\_current} \[A]

```taphome
return(parsejson(EM.GetStatus,"total_current"));
```

Licznik energii fazy A Licznik energii Tylko do odczytu

Moc czynna fazy A (kW), energia skumulowana (kWh), napięcie, prąd, współczynnik mocy i częstotliwość

numeric Jednostka: kW / kWh json\_path

Atrybuty serwisowe

|                      |
|----------------------|
| Prąd elektryczny     |
| Napięcie elektryczne |
| Współczynnik mocy    |
| Częstotliwość sieci  |

Odczyt całkowitego zużycia

```taphome
return(parsejson(EMData.GetStatus,"a_total_act_energy")/1000);
```

Odczyt zapotrzebowania

```taphome
return(parsejson(EM.GetStatus,"a_act_power")/1000);
```

Atrybuty serwisowe

${electric\_current} \[A]

```taphome
return(parsejson(EM.GetStatus,"a_current"));
```

${electric\_voltage} \[V]

```taphome
return(parsejson(EM.GetStatus,"a_voltage"));
```

${power\_factor}

```taphome
return(parsejson(EM.GetStatus,"a_pf"));
```

${grid\_frequency} \[Hz]

```taphome
return(parsejson(EM.GetStatus,"a_freq"));
```

Licznik energii fazy B Licznik energii Tylko do odczytu

Moc czynna fazy B (kW), energia skumulowana (kWh), napięcie, prąd, współczynnik mocy i częstotliwość

numeric Jednostka: kW / kWh json\_path

Atrybuty serwisowe

|                      |
|----------------------|
| Prąd elektryczny     |
| Napięcie elektryczne |
| Współczynnik mocy    |
| Częstotliwość sieci  |

Odczyt całkowitego zużycia

```taphome
return(parsejson(EMData.GetStatus,"b_total_act_energy")/1000);
```

Odczyt zapotrzebowania

```taphome
return(parsejson(EM.GetStatus,"b_act_power")/1000);
```

Atrybuty serwisowe

${electric\_current} \[A]

```taphome
return(parsejson(EM.GetStatus,"b_current"));
```

${electric\_voltage} \[V]

```taphome
return(parsejson(EM.GetStatus,"b_voltage"));
```

${power\_factor}

```taphome
return(parsejson(EM.GetStatus,"b_pf"));
```

${grid\_frequency} \[Hz]

```taphome
return(parsejson(EM.GetStatus,"b_freq"));
```

Licznik energii fazy C Licznik energii Tylko do odczytu

Moc czynna fazy C (kW), energia skumulowana (kWh), napięcie, prąd, współczynnik mocy i częstotliwość

numeric Jednostka: kW / kWh json\_path

Atrybuty serwisowe

|                      |
|----------------------|
| Prąd elektryczny     |
| Napięcie elektryczne |
| Współczynnik mocy    |
| Częstotliwość sieci  |

Odczyt całkowitego zużycia

```taphome
return(parsejson(EMData.GetStatus,"c_total_act_energy")/1000);
```

Odczyt zapotrzebowania

```taphome
return(parsejson(EM.GetStatus,"c_act_power")/1000);
```

Atrybuty serwisowe

${electric\_current} \[A]

```taphome
return(parsejson(EM.GetStatus,"c_current"));
```

${electric\_voltage} \[V]

```taphome
return(parsejson(EM.GetStatus,"c_voltage"));
```

${power\_factor}

```taphome
return(parsejson(EM.GetStatus,"c_pf"));
```

${grid\_frequency} \[Hz]

```taphome
return(parsejson(EM.GetStatus,"c_freq"));
```

**Połączenie:** Packet Parser → HTTP • Hostname: `Shelly3EM63G3-{MAC}.local`

Możliwe ulepszenia (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

## 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-27
- Shelly Gen2+ Sys Component API
  
  [shelly-api-docs.shelly.cloud](https://shelly-api-docs.shelly.cloud/gen2/ComponentsAndServices/Sys/) 2026-03-27
- Shelly Gen2+ WiFi Component API
  
  [shelly-api-docs.shelly.cloud](https://shelly-api-docs.shelly.cloud/gen2/ComponentsAndServices/WiFi/) 2026-03-27
- Home Assistant Shelly Integration (Gen2+)
  
  [www.home-assistant.io](https://www.home-assistant.io/integrations/shelly/) 2026-03-27
- Shelly 3EM-63 Gen3 Knowledge Base
  
  [kb.shelly.cloud](https://kb.shelly.cloud/knowledge-base/shelly-3em-63-gen3) 2026-03-27
- Shelly Gen2+ EM Component API
  
  [shelly-api-docs.shelly.cloud](https://shelly-api-docs.shelly.cloud/gen2/ComponentsAndServices/EM/) 2026-03-27
- Shelly Gen2+ EMData Component API
  
  [shelly-api-docs.shelly.cloud](https://shelly-api-docs.shelly.cloud/gen2/ComponentsAndServices/EMData/) 2026-03-27

## 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/)