
Shelly RGBW2 je Wi-Fi ovladač LED pásku se čtyřmi PWM výstupy (12/24 V DC). V režimu White se čtyři výstupy — běžně používané pro R, G, B a W kanál RGBW pásku — mění na čtyři nezávislé jednobarevné stmívací kanály. Každý kanál dokáže napájet svůj vlastní bílý LED pásek, LED žárovku nebo skupinu bodových svítidel. TapHome komunikuje se zařízením přes HTTP v lokální síti; připojení do cloudu není potřeba.
Tato šablona je White-mode protějšek šablony Shelly RGBW2 pro Color mode. Obě šablony sdílejí stejný hardware, ale firmware pracuje ve vzájemně se vylučujících režimech nastavených v nastavení zařízení. Před importem této šablony musí být zařízení nakonfigurováno v režimu White — šablona při každém dotazování kontroluje režim a zobrazí chybu, pokud je zařízení nastaveno na Color.
Shelly označil RGBW2 jako vyřazený — Shelly Group jej již nevyrábí ani neprodává. Existující kusy dále fungují a dostávají aktualizace firmwaru.
Zapojení
Shelly RGBW2 je napájen ze zdroje 12 V nebo 24 V DC (V+ / GND). Každý ze čtyř výstupů (označených R, G, B, W na zařízení) napájí jednu bílou LED zátěž. Typické varianty zapojení pro režim White:
- Čtyři nezávislé bílé LED pásky nebo žárovky — každý kanál ovládá jeden pásek/žárovku, společná anoda (+) na V+
- Více bodových svítidel na kanál — několik 12/24 V bodovek zapojených paralelně na jeden výstup
- Dva bílé pásky s dvojnásobným výkonem — dva kanály spárované paralelně na jeden pásek pro zdvojnásobení výstupního výkonu
Limity zátěže na kanál (podle specifikace Shelly) jsou 45 W při 12 V a 90 W při 24 V. Celková zátěž všech čtyř kanálů nesmí překročit 144 W při 12 V nebo 288 W při 24 V.
Konfigurace
Šablona se připojuje přes Wi-Fi. Během importu šablony v TapHome zadejte IP adresu zařízení (výchozí placeholder 192.168.0.1) a volitelný transition time v milisekundách (výchozí 300).
Transition time určuje, jak rychle každý kanál přechází mezi úrovněmi jasu. Odesílá se s každým zápisem a zároveň definuje debounce okno — šablona ignoruje dotazované hodnoty jasu po dobu transitionTime + 500 ms po každém zápisu, aby se zabránilo zastaralým odečtům během přechodu.
Přepnutí režimu
Pokud je zařízení aktuálně v režimu Color, přepněte jej do režimu White před importem této šablony. Buď:
- Otevřete webové rozhraní Shelly na
http://{device-ip}a změňte provozní režim v nastavení, nebo - Pošlete přímo
GET /settings?mode=white, nebo - Importujte dočasně Color-mode šablonu a použijte její akci Set mode White, poté znovu importujte tuto White-mode šablonu
Změna režimu vyžaduje restart zařízení. Po restartu zařízení znovu importujte White-mode šablonu v TapHome.
Schopnosti zařízení
Čtyři nezávislé stmívače
Šablona vystavuje čtyři nezávislé stmívací kanály, jeden na každý PWM výstup:
| Kanál | Výstupní pin | Endpoint | Interval dotazování |
|---|---|---|---|
| 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ždý stmívač čte lights[N].ison a lights[N].brightness (0 – 100, normalizované na 0 – 1) z odpovědi /status. Zápis používá /light/N?turn=on|off&brightness=VALUE&transition=T. Šablona používá starší endpoint /light/{idx}, který firmware Shelly akceptuje jako alias aktuálního endpointu /white/{idx}.
Měření spotřeby pro každý kanál
Každý kanál má vlastní elektroměr — Electric Meter Ch1 až Electric Meter Ch4 — který čte z meters[0] až meters[3]:
- Okamžitý výkon —
meters[N].powerve wattech, konvertovaný na kW - Celková spotřeba —
meters[N].totalve watt-minutách, konvertovaná na kWh
Kanál 1 se dotazuje každých 2,5 s společně se svým stmívačem; kanály 2 – 4 se dotazují v intervalech 15 s, aby se snížila zátěž HTTP stacku Gen1 (který snese pouze dvě souběžná spojení).
Servisní diagnostika
Šablona vystavuje 10 servisních atributů pro monitorování zařízení:
- Síť — IP adresa, MAC adresa (formátovaná s dvojtečkami), síla Wi-Fi signálu (dB)
- Konektivita — cloud povolen/připojen, MQTT připojen
- Informace o zařízení — čas zařízení, doba provozu (formátovaná jako dny/hodiny/minuty), využití paměti RAM
- Firmware — dostupná aktualizace firmwaru
Servisní akce
K dispozici jsou tři servisní akce:
- Povolit cloud — povolí nebo zakáže připojení k Shelly Cloudu
- Restart — spustí restart zařízení
- Nastavit režim White — zapisuje
/settings?mode=whitepro vynucení provozního režimu White (užitečné po tovární reset nebo pokud někdo změnil režim přes Shelly aplikaci)
Shelly Cloud API není touto šablonou používáno — komunikace probíhá pouze lokálním HTTP dotazováním.
Řešení problémů
Zařízení neodpovídá
- Ověřte, že Shelly je připojen k Wi-Fi a má platnou IP adresu
- Zkuste použít mDNS hostname (
shellyrgbw2-AABBCCDDEE.local) namísto IP adresy — IP se mohla změnit po obnovení DHCP - Otevřete
http://{device-ip}/shellyv prohlížeči — pokud odpovídá, zařízení je dostupné - Zkontrolujte, že TapHome CCU a Shelly jsou ve stejné síti / VLAN
Chyba „Mode White is not supported"
Tato chyba znamená, že zařízení je aktuálně nastaveno na režim Color. Řešení:
- Otevřete webové rozhraní Shelly na
http://{device-ip}a přepněte provozní režim na White, nebo - Pošlete přímo
GET /settings?mode=whitez prohlížeče nebo curl, nebo - Pokud máte importovanou Color-mode šablonu, spusťte z ní servisní akci Nastavit režim White
- Zařízení se musí po změně režimu restartovat — počkejte několik sekund a obnovte TapHome
Odečty výkonu zobrazují nulu
- Ověřte, že bílé LED jsou připojeny k příslušnému výstupu Shelly RGBW2 (pin R, G, B nebo W)
- Otevřete Shelly aplikaci nebo webové rozhraní a ověřte, že model zařízení je nakonfigurován v Settings -> Device Model — bez toho elektroměr vrací nulu
- Zkontrolujte, že kanál je zapnutý — elektroměr čte pouze při protékání proudu výstupem
- Dotazujte
/statusmanuálně a ověřte, žemeters[N].powervrací nenulovou hodnotu pro daný kanál
Kanál se nestmívá plynule
- Zkontrolujte, že parametr transition time odpovídá očekávanému chování — výchozích 300 ms je krátký přechod; delší hodnoty (např. 1500 ms) produkují pomalejší přechody
- Pamatujte, že debounce okno se rovná
transitionTime + 500 ms— změny odeslané rychleji mohou být sloučeny - Ověřte, že LED zátěž je stmívatelná (některé drivery nejsou kompatibilní s PWM) a že zdroj poskytuje stabilních 12/24 V DC
Gen1 Shelly zařízení podporují pouze 2 souběžná HTTP spojení. Pokud TapHome a jiný systém (např. Home Assistant) dotazují stejné zařízení současně, komunikace může být nespolehlivá. Udržujte interval dotazování na 10 – 30 sekundách pro každého dalšího klienta.