---
title: "Shelly Plus 1PM"
description: "Shelly Plus 1PM Gen2+ przekaźnik Wi-Fi z pomiarem mocy. Moc w czasie rzeczywistym (kW), energia (kWh), napięcie, prąd i temperatura przez HTTP lub MQTT."
url: "https://taphome.com/pl/compatibility/shelly-plus-1pm/"
language: pl
lastmod: 2026-03-29
generator: hugo
ai:
  topics: ["http","mqtt","electric-meter","wifi","relay","power-metering","gen2plus"]
  questions: ["Jak zintegrować Shelly Plus 1PM z TapHome?","Co mierzy szablon Shelly Plus 1PM w TapHome?","Jak podłączyć Shelly Plus 1PM przez HTTP do TapHome?","Jak podłączyć Shelly Plus 1PM przez MQTT do TapHome?","Jaka jest różnica między Shelly Plus 1PM a Shelly 1PM w TapHome?","Dlaczego Shelly Plus 1PM pokazuje zerowe odczyty mocy?","Jakie diagnostyki są dostępne dla Shelly Plus 1PM w TapHome?","Czy mogę użyć MQTT zamiast HTTP dla Shelly Plus 1PM?"]
---

# Shelly Plus 1PM

Komunikacja: Packet Parser → HTTP

- [Shelly Plus 1PM strona produktu](https://www.shelly.com/en/products/shop/shelly-plus-1pm)
- [Shelly Plus 1PM dokumentacja API](https://shelly-api-docs.shelly.cloud/gen2/)

> 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 Plus 1PM to kompaktowy przekaźnik Wi-Fi Gen2+ z wbudowanym pomiarem mocy. Mieści się za standardowym włącznikiem ściennym i może sterować jednym obwodem do 16 A (3500 W przy 230 V AC) lub 10 A (30 V DC). Urządzenie obsługuje zasilanie 110-240 VAC lub 24-30 VDC, dzięki czemu nadaje się zarówno do instalacji sieciowych, jak i niskonapięciowych. TapHome komunikuje się z urządzeniem lokalnie przez Wi-Fi — połączenie z chmurą nie jest wymagane.

Dostępne są dwa szablony TapHome: **szablon HTTP**, który odpytuje Gen2+ RPC API urządzenia, oraz **szablon MQTT**, który odbiera dane przez brokera MQTT. Oba udostępniają te same dwa urządzenia — licznik energii i przekaźnik.

## Konfiguracja

### Szablon HTTP

Szablon HTTP wymaga jedynie adresu IP urządzenia (wartość domyślna `192.168.0.1`). TapHome odpytuje punkt końcowy `/rpc/Switch.GetStatus?id=0` zarówno dla stanu przekaźnika, jak i danych pomiaru mocy. Moduł przechowuje odpowiedź JSON w zmiennej `status`, aby poszczególne skrypty urządzeń mogły analizować dane bez zbędnych wywołań HTTP.

### Szablon MQTT

Szablon MQTT wymaga podczas importu trzech parametrów:

- **IP brokera MQTT** — adres IP brokera MQTT (nie samego urządzenia Shelly)
- **Port brokera MQTT** — domyślny `1883`
- **MQTT Client ID urządzenia Shelly** — format `shellyplus1pm-{deviceid}`, znajduje się w interfejsie webowym Shelly w sekcji **Settings** > **MQTT Settings** > **Client ID**

Po włączeniu MQTT na Shelly Plus 1PM (Settings > MQTT) TapHome subskrybuje `shellyplus1pm-{deviceid}/status/switch:0` i publikuje komendy sterujące do `shellyplus1pm-{deviceid}/command/switch:0`.

## Możliwości urządzenia

### Sterowanie przekaźnikiem

Szablon udostępnia przekaźnik jako urządzenie przełączające. Stan przekaźnika odczytywany jest z pola `output` (boolean) i sterowany przez `/rpc/Switch.Set?id=0` z parametrem `on=true` lub `on=false` (HTTP) lub publikowaniem `on`/`off` do tematu komend (MQTT).

Szablon HTTP odpytuje przekaźnik w interwale 2,5 sekundy, zapewniając niemal natychmiastową informację o stanie. Szablon MQTT otrzymuje aktualizacje na bieżąco przez skrypt nasłuchujący.

### Pomiar mocy

Wbudowany licznik energii odczytuje dwie wartości z odpowiedzi Switch.GetStatus:

- **Moc chwilowa** — `apower` w watach, szablon konwertuje na kW (dzielenie przez 1000)
- **Energia skumulowana** — `aenergy.total` w watogodzinach, szablon konwertuje na kWh (dzielenie przez 1000)

Licznik jest tylko do odczytu — aktualizuje się automatycznie z każdym cyklem odpytywania (HTTP) lub z każdą wiadomością statusu MQTT.

Szablon HTTP udostępnia również trzy atrybuty serwisowe na liczniku energii:

| Atrybut | Jednostka | Opis |
|---------|-----------|------|
| Prąd | A | Chwilowy pobór prądu |
| Napięcie | V | Skuteczne napięcie sieciowe |
| Temperatura | °C | Temperatura wewnętrzna urządzenia |

Szablon MQTT udostępnia temperaturę wewnętrzną, napięcie i prąd jako atrybuty serwisowe na poziomie modułu z tymi samymi danymi, analizowanymi z ładunku statusu MQTT.

### Dodatkowe możliwości

Shelly Plus 1PM udostępnia przez RPC API również współczynnik mocy, częstotliwość sieciową, energię zwróconą (do pomiarów dwukierunkowych), stan fizycznego wejścia, siłę sygnału Wi-Fi, adres MAC, czas pracy, wykorzystanie RAM i czas urządzenia. Dostępne są też aktualizacja firmware, restart urządzenia, timer automatycznego wyłączenia, reset licznika energii i konfiguracja ochrony przed przeciążeniem. Te możliwości mogą zostać dodane w przyszłej aktualizacji szablonu.

## Rozwiązywanie problemów

### Urządzenie nie odpowiada (HTTP)

1. Sprawdź, czy Shelly jest połączony z Wi-Fi i ma prawidłowy adres IP
2. Spróbuj użyć nazwy hosta mDNS (`shellyplus1pm-AABBCCDDEE.local`) zamiast adresu IP — IP mógł się zmienić po odnowieniu DHCP
3. Otwórz `http://{ip-urzadzenia}/rpc/Shelly.GetDeviceInfo` w przeglądarce — jeśli odpowiada JSON, urządzenie jest osiągalne
4. Sprawdź, czy TapHome CCU i Shelly są w tej samej sieci / VLAN
5. Upewnij się, że uwierzytelnianie HTTP Digest jest wyłączone w interfejsie webowym Shelly — TapHome nie obsługuje żądań uwierzytelnionych

### Wiadomości MQTT nie docierają

1. Sprawdź, czy MQTT jest włączony w interfejsie webowym Shelly (Settings > MQTT)
2. Potwierdź, że adres i port brokera są poprawne zarówno w urządzeniu Shelly, jak i w ustawieniach modułu TapHome
3. Sprawdź, czy zmienna niestandardowa `plug1topic` dokładnie odpowiada MQTT Client ID urządzenia Shelly (np. `shellyplus1pm-AABBCCDDEE`)
4. Użyj klienta MQTT (np. MQTT Explorer), aby zasubskrybować `shellyplus1pm-#` i sprawdzić, czy urządzenie publikuje wiadomości

### Odczyty mocy pokazują zero

1. Potwierdź, że obciążenie jest podłączone przez przekaźnik Shelly (nie jest obejście)
2. Sprawdź, czy przekaźnik jest włączony — licznik mierzy tylko gdy prąd przepływa przez przekaźnik
3. Ręcznie odpytaj `/rpc/Switch.GetStatus?id=0` i sprawdź, czy `apower` zwraca wartość niezerową

### Wolna odpowiedź lub przekroczenia czasu

1. Urządzenia Gen2+ obsługują do 6 jednoczesnych połączeń HTTP (w porównaniu do 2 w Gen1) — unikaj jednak nadmiernego odpytywania z wielu systemów
2. Wyłącz tryb ECO w interfejsie webowym Shelly, jeśli jest włączony — przełącza urządzenie w tryb uśpienia między odpytywaniami i może powodować przekroczenia czasu przy krótkich interwałach
3. Użyj statycznego IP lub rezerwacji DHCP, aby zapobiec zmianom adresu
4. Rozważ przejście na szablon MQTT w środowiskach wielosystemowych — MQTT całkowicie omija problem limitu połączeń

## 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 2

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

Shelly Plus 1PM Moduł

Zmienne niestandardowe

Licznik energii Licznik energii Tylko do odczytu

Moc chwilowa (kW) i energia skumulowana (kWh) z diagnostyką prądu, napięcia i temperatury

numeric Jednostka: kW / kWh

Atrybuty serwisowe

|             |
|-------------|
| Prąd        |
| Napięcie    |
| Temperatura |

Odczyt całkowitego zużycia

```taphome
return(parsejson(parsejson(status,"aenergy"), "total")/1000);
```

Odczyt zapotrzebowania

```taphome
return(parsejson(status,"apower")/1000);
```

Odczyt (moduł)

```taphome
var x := (sendhttprequest("/rpc/Switch.GetStatus?id=0"));
status := x.Content;
```

Atrybuty serwisowe

${current} \[a]

```taphome
return(parsejson(status,"current"));
```

${electric\_voltage} \[v]

```taphome
return(parsejson(status,"voltage"));
```

${temp} \[C]

```taphome
return(parsejson(parsejson(status,"temperature"), "tC"));
```

Przełącznik Przełącznik Odczyt i zapis

boolean

Wartości / Stany: ON · OFF

Odczyt stanu przełącznika

```taphome
var x := (sendhttprequest("/rpc/Switch.GetStatus?id=0"));
status := x.Content;
return(PARSEJSON(status, "$.output", true));
```

Zapis stanu przełącznika

```taphome
VAR response := SENDHTTPREQUEST("rpc/Switch.Set?id=0&on=" + if(St,"true","false"));
IF response.IsSuccess = false
  ADDERROR(response.StatusCode);
END
```

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

Możliwe ulepszenia (16)

- Power Factor — Power factor value, available in Switch.GetStatus response for metered devices
- Network Frequency — AC network frequency in Hz, available in Switch.GetStatus response
- Returned Energy — Returned/exported energy in Wh, for bi-directional metering scenarios
- Input State — Physical switch/button input state, available via /rpc/Input.GetStatus?id=0
- WiFi SSID — Connected WiFi network name, available via /rpc/WiFi.GetStatus
- WiFi Signal Strength — WiFi RSSI in dBm, available via /rpc/WiFi.GetStatus
- IP Address — Device IP address, available via /rpc/WiFi.GetStatus
- MAC Address — Device MAC address, available via /rpc/Sys.GetStatus
- Uptime — Seconds since last reboot, available in Sys.GetStatus response
- RAM Usage — Total and free RAM in bytes, available in Sys.GetStatus response
- Device Time — Current device time in HH:MM format, available in Sys.GetStatus response
- Firmware Update — Trigger firmware update to stable channel, available via Shelly.Update RPC method
- Reboot — Reboot the device, available via Shelly.Reboot RPC method
- Auto-off Timer — Auto-reset timer in seconds via toggle\_after parameter, could be added as switch parameter
- Reset Energy Counters — Resets energy measurement counters (aenergy, ret\_aenergy)
- Overpower Protection — Configurable power limit threshold in Watts, relay turns off when exceeded

## 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+/Gen3 RPC API Reference
  
  [shelly-api-docs.shelly.cloud](https://shelly-api-docs.shelly.cloud/gen2/) 2026-03-29
- Shelly Gen2+ Switch Component API
  
  [shelly-api-docs.shelly.cloud](https://shelly-api-docs.shelly.cloud/gen2/ComponentsAndServices/Switch/) 2026-03-29
- Shelly Gen2+ System (Sys) Component API
  
  [shelly-api-docs.shelly.cloud](https://shelly-api-docs.shelly.cloud/gen2/ComponentsAndServices/Sys/) 2026-03-29
- Shelly Gen2+ WiFi Component API
  
  [shelly-api-docs.shelly.cloud](https://shelly-api-docs.shelly.cloud/gen2/ComponentsAndServices/WiFi/) 2026-03-29
- Shelly Gen2+ MQTT Component API
  
  [shelly-api-docs.shelly.cloud](https://shelly-api-docs.shelly.cloud/gen2/ComponentsAndServices/Mqtt/) 2026-03-29
- Home Assistant Shelly Integration
  
  [www.home-assistant.io](https://www.home-assistant.io/integrations/shelly/) 2026-03-29
- Shelly Plus 1PM Knowledge Base — specs & wiring
  
  [kb.shelly.cloud](https://kb.shelly.cloud/knowledge-base/shelly-plus-1pm) 2026-03-29

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