
Shelly Plus Plug S to inteligentne gniazdko Wi-Fi Gen2+ z wbudowanym pomiarem mocy i wielokolorowym pierścieniem LED. Podłącza się do standardowego gniazdka CEE 7/3 (Type-F / Schuko) i może przełączać obciążenia do 12 A / 2760 W przy 230 V. TapHome komunikuje się z urządzeniem lokalnie przez Wi-Fi, korzystając z interfejsu JSON-RPC Gen2+ na porcie 80 — połączenie z chmurą nie jest wymagane.
Szablon udostępnia gniazdko jako sześć urządzeń TapHome: przekaźnik, licznik energii, selektor trybu wskaźnika LED, dwa selektory kolorów LED (dla stanu przekaźnika WŁ. i WYŁ.) oraz ściemniacz jasności dla trybu wskaźnika mocy.
Konfiguracja
Parowanie i konfiguracja sieci
Fabrycznie urządzenie uruchamia się w trybie punktu dostępu z SSID ShellyPlusPlugS-XXXXXX (LED miga na niebiesko). Połącz się z tym SSID, otwórz http://192.168.33.1/ i wybierz swoją sieć domową Wi-Fi w interfejsie webowym. Po dołączeniu do LAN gniazdko jest dostępne na porcie 80 pod swoim adresem IP stacji oraz przez mDNS pod shellyplusplugs-<MAC>.local.
TapHome odpytuje punkty końcowe RPC Gen2+ przez nieszyfrowane HTTP — HTTPS jest domyślnie wyłączone, a uwierzytelnianie HTTP (Shelly.SetAuth) musi pozostać wyłączone, aby szablon działał. Upewnij się, że gniazdko znajduje się w tej samej sieci LAN / VLAN co TapHome Core.
Podczas importu szablonu w TapHome podaj adres IP gniazdka jako parametr IpAddress. Zdecydowanie zalecana jest statyczna rezerwacja DHCP, aby adres nie zmieniał się po restartach.
Możliwości urządzenia
Sterowanie przekaźnikiem
Przekaźnik jest udostępniany jako urządzenie przełączające. Jego stan odczytywany jest z /rpc/Switch.GetStatus?id=0 (boolean output) i sterowany przez /rpc/Switch.Set?id=0&on=true|false. Moduł buforuje pełną odpowiedź Switch.GetStatus, dzięki czemu przekaźnik, licznik i atrybuty serwisowe dzielą jedno wywołanie HTTP na odpytanie.
Pomiar mocy i energii
Wbudowany licznik w komponencie Switch udostępnia:
- Moc chwilowa —
apowerw watach, przeliczana przez szablon na kW (dzielona przez 1000) - Energia skumulowana —
aenergy.totalw watogodzinach, przeliczana na kWh (dzielona przez 1000)
Trzy dodatkowe odczyty są udostępniane jako atrybuty serwisowe na liczniku:
| Atrybut | Jednostka | Pole źródłowe |
|---|---|---|
| Prąd | A | current |
| Napięcie | V | voltage |
| Temperatura wewnętrzna | °C | temperature.tC |
Licznik jest tylko do odczytu i aktualizuje się w każdym cyklu odpytywania.
Tryb wskaźnika LED
Wielokolorowy pierścień LED jest sterowany przez komponent RPC PLUGS_UI specyficzny dla Plus Plug S. TapHome udostępnia selektor trybu z trzema poprawnymi opcjami — mimo że szablon wymienia dziesięć slotów enum, tylko pierwsze trzy odpowiadają rzeczywistym trybom firmware’u:
| Wartość | Zachowanie |
|---|---|
off | Pierścień LED wyłączony (stany diagnostyczne Wi-Fi / AP / firmware są nadal wyświetlane) |
switch | Kolor LED odzwierciedla stan przekaźnika — używa kolorów WYŁ. i WŁ. zdefiniowanych przez użytkownika |
power | Kolor LED odzwierciedla zmierzone obciążenie jako ułamek skonfigurowanego limitu mocy (gradient zielony → żółty → czerwony) |
Przełączanie między trybami to zmiana kosmetyczna i nie wymaga restartu.
Kolory LED (tryb switch)
Dwa niezależne urządzenia HSB pozwalają wybrać kolor pierścienia LED dla każdego stanu przekaźnika:
- Kolor LED (stan WYŁ.) — kolor i jasność przy wyłączonym przekaźniku
- Kolor LED (stan WŁ.) — kolor i jasność przy włączonym przekaźniku
Oba są mapowane na leds.colors.switch:0.{off|on}.{rgb,brightness} w konfiguracji PLUGS_UI. Shelly przechowuje wartości RGB w procentach (0–100 na kanał), a nie 0–255, więc szablon mnoży każdy kanał przez 2,55 podczas konwersji między HSV a natywnym formatem urządzenia. Konwersja jest wewnętrzna — w TapHome urządzenia zachowują się jak każdy inny selektor kolorów HSB.
Jasność LED (tryb power)
Gdy LED jest w trybie power, kolor jest wybierany automatycznie przez firmware na podstawie obciążenia. Tylko jasność jest konfigurowalna przez użytkownika, dlatego szablon udostępnia ją jako ściemniacz (leds.colors.power.brightness, 0–100 % przeskalowane na poziom ściemniacza TapHome 0,0–1,0).
Diagnostyka i akcje modułu
Moduł HTTP udostępnia cztery atrybuty serwisowe parsowane z /rpc/WiFi.GetStatus i /rpc/Sys.GetStatus:
| Atrybut | Źródło |
|---|---|
| SSID Wi-Fi | ssid |
| Adres IP | sta_ip |
| Siła sygnału | rssi (dBm) |
| Adres MAC | mac |
Dostępne są również dwie akcje serwisowe:
- Aktualizacja firmware’u — uruchamia aktualizację OTA z kanału stabilnego (
/rpc/Shelly.Update?stage="stable"). Aktywowana automatycznie, gdySys.GetStatuszgłaszaavailable_updates.stable. - Restart — restartuje urządzenie (
/rpc/Shelly.Reboot), przydatne po zmianach konfiguracji sieci lub w celu usunięcia przejściowych problemów.
Jeśli potrzebujesz tylko przełączania wł./wył. i podstawowego monitorowania energii, zignoruj urządzenia LED — są opcjonalne. Przekaźnik i licznik działają niezależnie od trybu wskaźnika LED.
Rozwiązywanie problemów
Urządzenie nie odpowiada
- Sprawdź, czy gniazdko jest połączone z Wi-Fi — LED nie powinien migać ani świecić na czerwono
- Spróbuj użyć nazwy mDNS
shellyplusplugs-<MAC>.localzamiast adresu IP — dzierżawa DHCP mogła się zmienić - Otwórz
http://{ip-urządzenia}/rpc/Shelly.GetDeviceInfow przeglądarce; jeśli odpowie JSON-em, urządzenie jest osiągalne - Upewnij się, że TapHome Core i gniazdko znajdują się w tej samej sieci LAN / VLAN
- Upewnij się, że uwierzytelnianie HTTP jest wyłączone w interfejsie webowym Shelly — szablon nie obsługuje uwierzytelniania digest
Licznik mocy pokazuje zero
- Sprawdź, czy do Shelly faktycznie podłączone jest obciążenie i czy nie jest pominięte
- Sprawdź, czy przekaźnik jest włączony — licznik pokazuje 0 W, gdy przekaźnik jest rozwarty
- Odpytaj bezpośrednio
/rpc/Switch.GetStatus?id=0w przeglądarce i sprawdź, czyapowerjest niezerowe
LED nie zmienia się po zmianie trybu
- LED odzwierciedla stan runtime tylko w trybach
switchipower; w trybieoffpozostaje ciemny, z wyjątkiem wzorów diagnostyki systemu (tryb AP, ponowne łączenie, OTA) - W trybie
switchupewnij się, że kolory WŁ. i WYŁ. nie są oba ustawione na czarny / 0 % jasności - Wskazania systemowe (niebieskie miganie w trybie AP, czerwone przy problemach z Wi-Fi) zawsze nadpisują konfigurację LED użytkownika — jeśli LED miga na czerwono, gniazdko nie jest w Twojej sieci Wi-Fi
Akcja aktualizacji firmware’u nie uruchamia się
- Szablon uruchamia aktualizację tylko gdy
Sys.GetStatuszgłaszaavailable_updates.stable— wykonaj akcję ręcznie z karty urządzenia lub interfejsu webowego, jeśli gniazdko jest już aktualne - Szablon celuje tylko w kanał stabilny; firmware beta musi być zainstalowany z interfejsu webowego Shelly