--- title: "Shelly Plug S" description: "Shelly Plug S inteligentna wtyczka Wi-Fi z pomiarem energii. Monitoruj zużycie prądu i steruj urządzeniami zdalnie przez HTTP z TapHome." url: "https://taphome.com/pl/compatibility/shelly-plug-s/" language: pl lastmod: 2026-10-08 generator: hugo ai: topics: ["http","smart-plug","electric-meter","wifi","relay","power-metering"] questions: ["Jak zintegrować Shelly Plug S z TapHome?","Co mierzy szablon Shelly Plug S w TapHome?","Jak podłączyć Shelly Plug S przez HTTP do TapHome?","Dlaczego Shelly Plug S pokazuje zerową moc?","Czy TapHome może monitorować temperaturę wewnętrzną Shelly Plug S?","Co się stanie, gdy Shelly Plug S się przegrzeje?"] --- # Shelly Plug S Komunikacja: Packet Parser → HTTP - [Baza wiedzy Shelly Plug S](https://kb.shelly.cloud/knowledge-base/shelly-plug-s) Shelly Plug S to kompaktowa inteligentna wtyczka Wi-Fi z wbudowanym miernikiem mocy. Podłącza się bezpośrednio do gniazdka i obsługuje obciążenia do 10 A (2300 W przy 230 V). TapHome komunikuje się z urządzeniem przez HTTP w sieci lokalnej — połączenie z chmurą nie jest wymagane. Szablon zapewnia sterowanie przekaźnikiem (włącz/wyłącz), licznik energii odczytujący chwilowe zużycie mocy i skumulowane zużycie energii oraz monitorowanie temperatury wewnętrznej. ## Możliwości urządzenia ### Sterowanie przekaźnikiem Szablon udostępnia przekaźnik wtyczki jako przełącznik. Stan przekaźnika jest odczytywany z `/settings/relay/0` (pole `ison`) i sterowany przez endpoint `/relay/0` z parametrem `turn=on` lub `turn=off`. Interwał pollingu dla przełącznika wynosi 1 sekundę. > [!NOTE] > Szablon odczytuje stan przełącznika z `/settings/relay/0` (konfiguracja trwała), a nie z `/status` (stan na żywo). W normalnych warunkach oba zwracają tę samą wartość, ale `/settings` może zawierać nieznacznie przestarzałe dane po szybkim przełączaniu. ### Pomiar mocy Wbudowany licznik energii odczytuje dwie wartości z endpointu `/meter/0`: - **Moc chwilowa** — pole `power` w watach, konwertowane przez szablon na kW - **Całkowite zużycie** — pole `total` w watominutach, konwertowane przez szablon na kWh Licznik jest tylko do odczytu i aktualizuje się co 15 sekund (konfigurowalny interwał pollingu). ### Monitorowanie temperatury Urządzenie przełącznika zawiera atrybut serwisowy, który odczytuje temperaturę wewnętrzną wtyczki z endpointu `/status`. Umożliwia to monitorowanie temperatury urządzenia bezpośrednio w TapHome bez dodatkowej konfiguracji. ## Niezaimplementowane funkcje API Shelly Plug S udostępnia dodatkowe możliwości, które nie są zawarte w bieżącym szablonie: - **Flaga przegrzania** — automatyczne wyłączenie przekaźnika przy ~95 °C (`overtemperature` w `/status`) - **Sterowanie LED** — włączanie/wyłączanie diody LED statusu przez `/settings` - **Próg ochrony przed przeciążeniem** — konfigurowalny limit maksymalnej mocy (domyślnie 2300 W) - **Czasomierz automatycznego wyłączenia** — automatyczne wyłączenie przekaźnika po upływie ustawionego czasu - **Siła sygnału Wi-Fi** — wartość RSSI w dBm z `/status` - **Restart** — ponowne uruchomienie urządzenia przez endpoint `/reboot` Funkcje te można dodać w przyszłej aktualizacji szablonu jako atrybuty serwisowe lub akcje serwisowe. ## 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. Otwórz `http://{device-ip}/shelly` w przeglądarce — jeśli odpowie, urządzenie jest dostępne 3. Sprawdź, czy TapHome CCU i Shelly są w tej samej sieci / VLAN ### Pomiar mocy pokazuje zero 1. Upewnij się, że urządzenie podłączone do Shelly Plug S jest włączone 2. Sprawdź, czy przekaźnik jest włączony — licznik mierzy tylko przy przepływie prądu 3. Ręcznie odpytaj `/meter/0` i sprawdź, czy pole `power` zwraca wartość różną od zera ### Wyłączenie z powodu przegrzania Shelly Plug S posiada wewnętrzną ochronę termiczną. Jeśli temperatura urządzenia przekroczy ~95 °C, przekaźnik automatycznie się wyłączy. Zapewnij odpowiednią wentylację wokół wtyczki, szczególnie przy podłączaniu urządzeń o wysokim poborze mocy. > [!WARNING] > Urządzenia Shelly Gen1 obsługują tylko **2 jednoczesne połączenia HTTP**. Jeśli TapHome i inny system (np. Home Assistant) odpytują to samo urządzenie jednocześnie, komunikacja może stać się zawodna. Jeśli urządzenie odpytuje także inny system, zwiększ interwały odpytywania w szablonie (domyślnie 1 s dla przełącznika, 15 s dla licznika), aby zmniejszyć rywalizację o połączenia. ## 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 Shelly Plug S Moduł Zmienne niestandardowe Licznik energii Licznik energii Tylko do odczytu Pomiar zużycia energii — moc chwilowa (kW) i energia skumulowana (kWh) numeric Jednostka: kW / kWh Przełącznik Przełącznik boolean Wartości / Stany: ON · OFF **Połączenie:** Packet Parser → HTTP • Hostname: `shellyplug-s-{MAC}.local` Możliwe ulepszenia (7) - Live relay state — Template reads from /settings/relay/0 instead of /status — /status has real-time state - Overtemperature flag — Boolean flag in /status, triggers automatic relay shutdown at ~95°C - LED control — Enable/disable status LED via settings endpoint - Overpower protection threshold — Configurable maximum power limit (default 2300W), could be a service action - Auto-off timer — Auto-off timer in seconds, could be added as switch parameter - WiFi signal strength — WiFi RSSI in dBm, available in /status response - Reboot — Device reboot endpoint, could be added as service action ## Źródła - Shelly Gen1 API Reference [shelly-api-docs.shelly.cloud](https://shelly-api-docs.shelly.cloud/gen1/) 2026-03-12 - Shelly Gen1 General Setup [kb.shelly.cloud](https://kb.shelly.cloud/knowledge-base/shelly-devices-general-setup) 2026-03-12 - Shelly Gen1 HTTP Integration [kb.shelly.cloud](https://kb.shelly.cloud/knowledge-base/shelly-http-integration) 2026-03-12 - Shelly Plug S Knowledge Base [kb.shelly.cloud](https://kb.shelly.cloud/knowledge-base/shelly-plug-s) 2026-03-13 - Shelly Plug S API Endpoints [shelly-api-docs.shelly.cloud](https://shelly-api-docs.shelly.cloud/gen1/#shelly-plug-plugs) 2026-03-13 ## 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/)