
Shelly RGBW2 je Wi-Fi ovládač LED pásu so štyrmi PWM výstupmi (12/24 V DC). V režime White sa štyri výstupy — bežne používané pre R, G, B a W kanál RGBW pásu — menia na štyri nezávislé jednofarebné stmievacie kanály. Každý kanál dokáže napájať svoj vlastný biely LED pás, LED žiarovku alebo skupinu bodových svietidiel. TapHome komunikuje so zariadením cez HTTP v lokálnej sieti; pripojenie do cloudu nie je potrebné.
Táto šablóna je White-mode náprotivok šablóny Shelly RGBW2 pre Color mode. Obe šablóny zdieľajú rovnaký hardvér, ale firmvér pracuje vo vzájomne sa vylučujúcich režimoch nastavených v nastaveniach zariadenia. Pred importom tejto šablóny musí byť zariadenie nakonfigurované v režime White — šablóna pri každom dotazovaní kontroluje režim a zobrazí chybu, ak je zariadenie nastavené na Color.
Shelly označil RGBW2 ako vyradené — Shelly Group ho už nevyrába ani nepredáva. Existujúce kusy naďalej fungujú a dostávajú aktualizácie firmvéru.
Zapojenie
Shelly RGBW2 sa napája zo zdroja 12 V alebo 24 V DC (V+ / GND). Každý zo štyroch výstupov (označených R, G, B, W na zariadení) napája jednu bielu LED záťaž. Typické varianty zapojenia pre režim White:
- Štyri nezávislé biele LED pásy alebo žiarovky — každý kanál ovláda jeden pás/žiarovku, spoločná anóda (+) na V+
- Viac bodových svietidiel na kanál — niekoľko 12/24 V bodoviek zapojených paralelne na jeden výstup
- Dva biele pásy s dvojnásobným výkonom — dva kanály spárované paralelne na jeden pás pre zdvojnásobenie výstupného výkonu
Limity záťaže na kanál (podľa špecifikácie Shelly) sú 45 W pri 12 V a 90 W pri 24 V. Celková záťaž všetkých štyroch kanálov nesmie presiahnuť 144 W pri 12 V alebo 288 W pri 24 V.
Konfigurácia
Šablóna sa pripája cez Wi-Fi. Počas importu šablóny v TapHome zadajte IP adresu zariadenia (predvolený placeholder 192.168.0.1) a voliteľný transition time v milisekundách (predvolene 300).
Transition time určuje, ako rýchlo každý kanál prechádza medzi úrovňami jasu. Odosiela sa s každým zápisom a zároveň definuje debounce okno — šablóna ignoruje dotazované hodnoty jasu po dobu transitionTime + 500 ms po každom zápise, aby sa zabránilo zastaraným odčítaniam počas prechodu.
Prepnutie režimu
Ak je zariadenie aktuálne v režime Color, prepnite ho do režimu White pred importom tejto šablóny. Buď:
- Otvorte webové rozhranie Shelly na
http://{device-ip}a zmeňte prevádzkový režim v nastaveniach, alebo - Pošlite priamo
GET /settings?mode=white, alebo - Importujte dočasne Color-mode šablónu a použite jej akciu Set mode White, potom znovu importujte túto White-mode šablónu
Zmena režimu vyžaduje reštart zariadenia. Po reštarte zariadenia znovu importujte White-mode šablónu v TapHome.
Schopnosti zariadenia
Štyri nezávislé stmievače
Šablóna vystavuje štyri nezávislé stmievacie kanály, jeden na každý PWM výstup:
| Kanál | Výstupný pin | Endpoint | Interval dotazovania |
|---|---|---|---|
| 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ý stmievač číta lights[N].ison a lights[N].brightness (0 – 100, normalizované na 0 – 1) z odpovede /status. Zápis používa /light/N?turn=on|off&brightness=VALUE&transition=T. Šablóna používa starší endpoint /light/{idx}, ktorý firmvér Shelly akceptuje ako alias aktuálneho endpointu /white/{idx}.
Meranie spotreby pre každý kanál
Každý kanál má vlastný elektromer — Electric Meter Ch1 až Electric Meter Ch4 — ktorý číta z meters[0] až meters[3]:
- Okamžitý výkon —
meters[N].powervo wattoch, konvertovaný na kW - Celková spotreba —
meters[N].totalvo watt-minútach, konvertovaná na kWh
Kanál 1 sa dotazuje každých 2,5 s spolu so svojím stmievačom; kanály 2 – 4 sa dotazujú v intervaloch 15 s, aby sa znížila záťaž HTTP stacku Gen1 (ktorý znesie iba dve súbežné spojenia).
Servisná diagnostika
Šablóna vystavuje 10 servisných atribútov pre monitorovanie zariadenia:
- Sieť — IP adresa, MAC adresa (formátovaná s dvojbodkami), sila Wi-Fi signálu (dB)
- Konektivita — cloud povolený/pripojený, MQTT pripojený
- Informácie o zariadení — čas zariadenia, doba prevádzky (formátovaná ako dni/hodiny/minúty), využitie pamäte RAM
- Firmvér — dostupná aktualizácia firmvéru
Servisné akcie
K dispozícii sú tri servisné akcie:
- Povoliť cloud — povolí alebo zakáže pripojenie k Shelly Cloudu
- Reštart — spustí reštart zariadenia
- Nastaviť režim White — zapisuje
/settings?mode=white, aby vynútila prevádzkový režim White (užitočné po továrenskom resete alebo ak niekto zmenil režim cez Shelly aplikáciu)
Shelly Cloud API nie je používané touto šablónou — komunikácia prebieha iba lokálnym HTTP dotazovaním.
Riešenie problémov
Zariadenie neodpovedá
- Overte, že Shelly je pripojený k Wi-Fi a má platnú IP adresu
- Skúste použiť mDNS hostname (
shellyrgbw2-AABBCCDDEE.local) namiesto IP adresy — IP sa mohla zmeniť po obnove DHCP - Otvorte
http://{device-ip}/shellyv prehliadači — ak odpovedá, zariadenie je dostupné - Skontrolujte, že TapHome CCU a Shelly sú v rovnakej sieti / VLAN
Chyba „Mode White is not supported"
Táto chyba znamená, že zariadenie je aktuálne nastavené na režim Color. Riešenie:
- Otvorte webové rozhranie Shelly na
http://{device-ip}a prepnite prevádzkový režim na White, alebo - Pošlite priamo
GET /settings?mode=whitez prehliadača alebo curl, alebo - Ak máte importovanú Color-mode šablónu, spustite z nej servisnú akciu Nastaviť režim White
- Zariadenie sa musí po zmene režimu reštartovať — počkajte niekoľko sekúnd a obnovte TapHome
Odčítania výkonu zobrazujú nulu
- Overte, že biele LED sú pripojené k príslušnému výstupu Shelly RGBW2 (pin R, G, B alebo W)
- Otvorte Shelly aplikáciu alebo webové rozhranie a overte, že model zariadenia je nakonfigurovaný v Settings -> Device Model — bez toho elektromer vracia nulu
- Skontrolujte, že kanál je zapnutý — elektromer číta iba pri pretekaní prúdu výstupom
- Dotazujte
/statusmanuálne a overte, žemeters[N].powervracia nenulovú hodnotu pre daný kanál
Kanál sa nestmieva plynulo
- Skontrolujte, že parameter transition time zodpovedá očakávanému správaniu — predvolených 300 ms je krátke prelínanie; dlhšie hodnoty (napr. 1500 ms) produkujú pomalšie prechody
- Pamätajte, že debounce okno sa rovná
transitionTime + 500 ms— zmeny odoslané rýchlejšie môžu byť zlúčené - Overte, že LED záťaž je stmievateľná (niektoré drivery nie sú kompatibilné s PWM) a že zdroj poskytuje stabilných 12/24 V DC
Gen1 Shelly zariadenia podporujú iba 2 súbežné HTTP spojenia. Ak TapHome a iný systém (napr. Home Assistant) dotazujú rovnaké zariadenie súčasne, komunikácia môže byť nespoľahlivá. Udržujte interval dotazovania na 10 – 30 sekúnd pre každého ďalšieho klienta.