TapHome

Shelly Plus 1

Packet Parser → HTTP
Dodane przez
Ostatnia aktualizacja: 03. 2026
Shelly Plus 1

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.

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

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

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

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 Plus 1 Moduł
Zmienne niestandardowe
status (string)
Przełącznik Przełącznik

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

boolean
Wartości / Stany: ON · OFF

Przełącznik

Odczyt stanu przełącznika
var x := (sendhttprequest("/rpc/Switch.GetStatus?id=0"));
status := x.Content;
return(PARSEJSON(status, "$.output", true));
Zapis stanu przełącznika
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
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

Źródła