---
title: "Shelly Plus 1"
description: "Shelly Plus 1 Gen2+ przekaźnik Wi-Fi z bezpotencjałowymi stykami. Jednokanałowe sterowanie przez RPC API po HTTP z TapHome."
url: "https://taphome.com/pl/compatibility/shelly-plus-1/"
language: pl
lastmod: 2026-03-29
generator: hugo
ai:
  topics: ["http","i/o-module","wifi","relay","switch","gen2plus"]
  questions: ["Jak zintegrować Shelly Plus 1 z TapHome?","Jak podłączyć Shelly Plus 1 przez HTTP do TapHome?","Czy Shelly Plus 1 obsługuje pomiar mocy w TapHome?","Jaka jest różnica między Shelly Plus 1 a Plus 1PM w TapHome?","Czy Shelly Plus 1 może przełączać obciążenia DC przez TapHome?","Jak rozwiązać problem, gdy Shelly Plus 1 nie odpowiada w TapHome?"]
---

# Shelly Plus 1

Komunikacja: Packet Parser → HTTP

- [Shelly Plus 1 strona produktu](https://www.shelly.com/en/products/shop/shelly-plus-1)
- [Shelly Plus 1 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 1 to kompaktowy przekaźnik Wi-Fi z bezpotencjałowymi stykami. 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 szeroki zakres zasilania — 110-240 VAC, 24-48 VDC lub 12 VDC — dzięki czemu nadaje się zarówno do instalacji sieciowych, jak i niskonapięciowych. TapHome komunikuje się z urządzeniem przez HTTP za pomocą Gen2+ RPC API w sieci lokalnej — połączenie z chmurą nie jest wymagane.

Szablon udostępnia jeden przekaźnik. W odróżnieniu od Plus 1PM, to urządzenie nie posiada wbudowanego pomiaru mocy.

## Konfiguracja

Shelly Plus 1 łączy się przez Wi-Fi. Podczas importu szablonu w TapHome podaj adres IP urządzenia (wartość domyślna `192.168.0.1`).

Urządzenie wykorzystuje Gen2+ JSON-RPC API. Cała komunikacja odbywa się przez żądania HTTP GET do punktów końcowych `/rpc/` na porcie 80.

## 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 odpowiedzi `/rpc/Switch.GetStatus?id=0` (pole `output`, boolean) i sterowany przez `/rpc/Switch.Set?id=0` z parametrem `on=true` lub `on=false`.

Interwał odpytywania wynosi 2,5 sekundy, co zapewnia niemal natychmiastową informację o stanie w TapHome.

### Dodatkowe możliwości

Shelly Plus 1 udostępnia przez RPC API również wewnętrzną temperaturę przekaźnika, stan fizycznego wejścia, adres MAC urządzenia, czas pracy, wykorzystanie RAM, czas urządzenia, adres IP, nazwę sieci Wi-Fi i siłę sygnału Wi-Fi. Dostępny jest też timer automatycznego wyłączenia (parametr `toggle_after`) oraz akcje restartu urządzenia / aktualizacji firmware. Te możliwości mogą zostać dodane w przyszłej aktualizacji szablonu.

> [!NOTE]
> Shelly Plus 1 **nie posiada** pomiaru mocy. Jeśli potrzebujesz monitorowania energii, użyj zamiast tego Shelly Plus 1PM — ma ten sam format i te same możliwości przekaźnika, ale dodatkowo oferuje pomiar mocy chwilowej, napięcia, prądu i skumulowanego zużycia energii.

## 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 (`shellyplus1-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

### Przekaźnik się nie przełącza

1. Sprawdź tryb wejścia w interfejsie webowym Shelly (ustawienie `in_mode`) — jeśli ustawiony na `detached`, fizyczny włącznik nie wpływa na przekaźnik, ale komendy HTTP powinny nadal działać
2. Ręcznie odpytaj `/rpc/Switch.GetStatus?id=0` i sprawdź, czy pole `output` zmienia się przy przełączaniu
3. Sprawdź pole `source` w odpowiedzi statusu, aby zobaczyć, co ostatnio sterowało przekaźnikiem

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

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

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

Shelly Plus 1 Moduł

Zmienne niestandardowe

|                   |
|-------------------|
| `status` (string) |

Przełącznik Przełącznik Odczyt i zapis

Jednokanałowe sterowanie przekaźnikiem — włączanie/wyłączanie przez RPC API

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: `shellyplus1-{MAC}.local`

Możliwe ulepszenia (12)

- Switch Temperature — Internal relay temperature in °C, available in Switch.GetStatus response
- Input State — Physical switch/button input state, available via /rpc/Input.GetStatus?id=0
- MAC Address — Device MAC address, available in Sys.GetStatus response
- 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
- IP Address — Device station IP address, available in WiFi.GetStatus response
- WiFi SSID — Connected WiFi network name, available in WiFi.GetStatus response
- WiFi Signal Strength — WiFi RSSI in dBm, available in WiFi.GetStatus response
- Auto-off Timer — Auto-reset timer in seconds via toggle\_after parameter, could be added as switch parameter
- Reboot — Triggers device reboot, could be added as service action
- Firmware Update — Initiates OTA firmware update to stable or beta channel

## 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-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 Component API
  
  [shelly-api-docs.shelly.cloud](https://shelly-api-docs.shelly.cloud/gen2/ComponentsAndServices/Shelly/) 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
- Home Assistant Shelly Integration
  
  [www.home-assistant.io](https://www.home-assistant.io/integrations/shelly/) 2026-03-29
- Shelly Plus 1 Knowledge Base
  
  [kb.shelly.cloud](https://kb.shelly.cloud/knowledge-base/shelly-plus-1) 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/)