
Shelly RGBW2 to sterownik taśmy LED z Wi-Fi, wyposażony w cztery wyjścia PWM (12/24 V DC). W trybie White cztery wyjścia — zwykle używane dla kanałów R, G, B i W taśmy RGBW — stają się czterema niezależnymi jednobarwnymi kanałami ściemniającymi. Każdy kanał może zasilać własną białą taśmę LED, żarówkę LED lub grupę reflektorów punktowych. TapHome komunikuje się z urządzeniem przez HTTP w sieci lokalnej; połączenie z chmurą nie jest wymagane.
Ten szablon jest odpowiednikiem szablonu Shelly RGBW2 w trybie Color, ale dla trybu White. Oba szablony współdzielą ten sam sprzęt, ale firmware działa we wzajemnie wykluczających się trybach wybieranych w ustawieniach urządzenia. Przed zaimportowaniem tego szablonu urządzenie musi być skonfigurowane w trybie White — szablon sprawdza tryb przy każdym odpytywaniu i wyświetla błąd, jeśli urządzenie jest ustawione na Color.
Shelly oznaczył RGBW2 jako wycofany — nie jest już produkowany ani sprzedawany przez Shelly Group. Istniejące egzemplarze nadal działają i otrzymują aktualizacje firmware.
Okablowanie
Shelly RGBW2 jest zasilany ze źródła 12 V lub 24 V DC (V+ / GND). Każde z czterech wyjść (oznaczonych R, G, B, W na urządzeniu) zasila jedno białe obciążenie LED. Typowe schematy okablowania dla trybu White:
- Cztery niezależne białe taśmy LED lub żarówki — każdy kanał steruje jedną taśmą/żarówką, wspólna anoda (+) do V+
- Kilka reflektorów na kanał — kilka reflektorów 12/24 V podłączonych równolegle na jedno wyjście
- Dwie białe taśmy z podwojoną mocą — dwa kanały sparowane równolegle na jedną taśmę w celu podwojenia mocy wyjściowej
Limity obciążenia na kanał (według specyfikacji Shelly) wynoszą 45 W przy 12 V i 90 W przy 24 V. Łączne obciążenie wszystkich czterech kanałów nie może przekraczać 144 W przy 12 V lub 288 W przy 24 V.
Konfiguracja
Szablon łączy się przez Wi-Fi. Podczas importu szablonu w TapHome wprowadź adres IP urządzenia (domyślny placeholder 192.168.0.1) i opcjonalny transition time w milisekundach (domyślnie 300).
Transition time określa, jak szybko każdy kanał przechodzi między poziomami jasności. Jest wysyłany z każdym poleceniem zapisu i definiuje również okno debounce — szablon ignoruje odpytywane wartości jasności przez transitionTime + 500 ms po każdym zapisie, aby zapobiec nieaktualnym odczytom podczas przejścia.
Przełączanie trybu
Jeśli urządzenie jest obecnie w trybie Color, przełącz je w tryb White przed zaimportowaniem tego szablonu. Albo:
- Otwórz interfejs web Shelly pod adresem
http://{device-ip}i zmień tryb pracy w ustawieniach, albo - Wyślij bezpośrednio
GET /settings?mode=white, albo - Zaimportuj tymczasowo szablon Color i użyj jego akcji serwisowej Set mode White, a następnie ponownie zaimportuj ten szablon White
Zmiana trybu wymaga restartu urządzenia. Po ponownym uruchomieniu urządzenia ponownie zaimportuj szablon White w TapHome.
Możliwości urządzenia
Cztery niezależne ściemniacze
Szablon udostępnia cztery niezależne kanały ściemniające, po jednym na wyjście PWM:
| Kanał | Pin wyjścia | Endpoint | Interwał odpytywania |
|---|---|---|---|
| Ch1 | R | /light/0 | 2,5 s |
| Ch2 | G | /light/1 | 2,5 s |
| Ch3 | B | /light/2 | 2,5 s |
| Ch4 | W | /light/3 | 2,5 s |
Każdy ściemniacz odczytuje lights[N].ison i lights[N].brightness (0–100, znormalizowane do 0–1) z odpowiedzi /status. Polecenia zapisu używają /light/N?turn=on|off&brightness=VALUE&transition=T. Szablon używa starszego endpointu /light/{idx}, który firmware Shelly akceptuje jako alias obecnego endpointu /white/{idx}.
Pomiar energii na kanał
Każdy kanał ma własny licznik energii — od Electric Meter Ch1 do Electric Meter Ch4 — odczytując z meters[0] do meters[3]:
- Moc chwilowa —
meters[N].powerw watach, przeliczana na kW - Całkowite zużycie —
meters[N].totalw wato-minutach, przeliczane na kWh
Kanał 1 jest odpytywany co 2,5 s razem ze swoim ściemniaczem; kanały 2–4 odpytywane są w 15-sekundowych interwałach, aby zmniejszyć obciążenie stosu HTTP Gen1 (który toleruje tylko dwa równoczesne połączenia).
Diagnostyka serwisowa
Szablon udostępnia 10 atrybutów serwisowych do monitorowania urządzenia:
- Sieć — adres IP, adres MAC (sformatowany z dwukropkami), siła sygnału Wi-Fi (dB)
- Łączność — cloud włączona/połączona, MQTT połączona
- Informacje o urządzeniu — czas urządzenia, czas pracy (sformatowany jako dni/godziny/minuty), wykorzystanie RAM
- Firmware — dostępna aktualizacja firmware
Akcje serwisowe
Dostępne są trzy akcje serwisowe:
- Włącz chmurę — włącza lub wyłącza łączność z Shelly Cloud
- Restart — uruchamia restart urządzenia
- Ustaw tryb White — zapisuje
/settings?mode=white, aby wymusić tryb pracy White (przydatne po resecie fabrycznym lub gdy ktoś zmienił tryb przez aplikację Shelly)
Shelly Cloud API nie jest używane przez ten szablon — komunikacja odbywa się wyłącznie lokalnym odpytywaniem HTTP.
Rozwiązywanie problemów
Urządzenie nie odpowiada
- Sprawdź, czy Shelly jest podłączony do Wi-Fi i ma prawidłowy adres IP
- Spróbuj użyć nazwy mDNS (
shellyrgbw2-AABBCCDDEE.local) zamiast adresu IP — IP mogło się zmienić po odnowieniu DHCP - Otwórz
http://{device-ip}/shellyw przeglądarce — jeśli odpowiada, urządzenie jest osiągalne - Sprawdź, czy TapHome CCU i Shelly są w tej samej sieci / VLAN
Błąd „Mode White is not supported"
Ten błąd oznacza, że urządzenie jest obecnie ustawione w tryb Color. Aby rozwiązać:
- Otwórz interfejs web Shelly pod adresem
http://{device-ip}i przełącz tryb pracy na White, albo - Wyślij bezpośrednio
GET /settings?mode=whitez przeglądarki lub curl, albo - Jeśli masz zaimportowany szablon trybu Color, uruchom stamtąd akcję serwisową Ustaw tryb White
- Urządzenie musi się zrestartować po zmianie trybu — poczekaj kilka sekund i odśwież TapHome
Odczyty mocy pokazują zero
- Sprawdź, że białe LED są podłączone do odpowiedniego wyjścia Shelly RGBW2 (pin R, G, B lub W)
- Otwórz aplikację lub interfejs web Shelly i zweryfikuj, czy model urządzenia jest skonfigurowany w Settings -> Device Model — bez tego licznik zwraca zero
- Sprawdź, czy kanał jest włączony — licznik odczytuje tylko, gdy prąd płynie przez wyjście
- Odpytaj
/statusręcznie i sprawdź, czymeters[N].powerzwraca wartość różną od zera dla danego kanału
Kanał nie ściemnia płynnie
- Sprawdź, czy parametr transition time odpowiada oczekiwanemu zachowaniu — domyślne 300 ms to krótkie przejście; dłuższe wartości (np. 1500 ms) dają wolniejsze przejścia
- Pamiętaj, że okno debounce wynosi
transitionTime + 500 ms— zmiany wysyłane szybciej mogą zostać połączone - Sprawdź, czy obciążenie LED jest ściemnialne (niektóre sterowniki nie są kompatybilne z PWM) oraz czy zasilacz zapewnia stabilne 12/24 V DC
Urządzenia Shelly Gen1 obsługują tylko 2 równoczesne 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. Utrzymuj interwał odpytywania na poziomie 10–30 sekund dla każdego dodatkowego klienta.