
A Shelly RGBW2 egy Wi-Fi LED szalag vezérlő négy PWM kimenettel (12/24 V DC). White üzemmódban a négy kimenet — amelyeket általában egy RGBW szalag R, G, B és W csatornájához használnak — négy független egyszínű fényerőszabályzó csatornává alakul. Minden csatorna önálló fehér LED szalagot, LED izzót vagy spotlámpa-csoportot képes hajtani. A TapHome HTTP-n keresztül kommunikál az eszközzel a helyi hálózaton; felhős kapcsolat nem szükséges.
Ez a sablon a Shelly RGBW2 Color üzemmódú sablon White üzemmódú megfelelője. Mindkét sablon ugyanazt a hardvert használja, de a firmware kölcsönösen kizáró módokban működik, amelyeket az eszköz beállításaiban lehet kiválasztani. A sablon importálása előtt az eszközt White üzemmódra kell konfigurálni — a sablon minden lekérdezéskor ellenőrzi a módot, és hibát jelez, ha az eszköz Color módra van állítva.
A Shelly a RGBW2-t kivezetettként jelölte meg — a Shelly Group már nem gyártja és nem árulja. A meglévő egységek továbbra is működnek, és firmware-frissítéseket kapnak.
Bekötés
A Shelly RGBW2 12 V vagy 24 V DC tápfeszültségről (V+ / GND) működik. A négy kimenet (az eszközön R, G, B, W jelölésű) mindegyike egy fehér LED terhelést hajt. Tipikus White üzemmódú bekötési elrendezések:
- Négy független fehér LED szalag vagy izzó — minden csatorna egy szalagot/izzót vezérel, közös anód (+) a V+-ra
- Több spotlámpa csatornánként — több 12/24 V-os spotlámpa párhuzamosan egy kimeneten
- Két fehér szalag duplázott teljesítménnyel — két csatorna párhuzamosan egy szalagra kötve a kimeneti teljesítmény megduplázása érdekében
A csatornánkénti terhelési korlátok (a Shelly specifikációja szerint) 45 W 12 V-on és 90 W 24 V-on. A négy csatorna együttes terhelése nem haladhatja meg a 144 W-ot 12 V-on és a 288 W-ot 24 V-on.
Konfiguráció
A sablon Wi-Fi-n keresztül csatlakozik. A TapHome sablon importálásakor adja meg az eszköz IP-címét (alapértelmezett placeholder 192.168.0.1) és egy opcionális transition time értéket ezredmásodpercben (alapértelmezett 300).
A transition time határozza meg, milyen gyorsan vált át az egyes csatornák a fényerő-szintek között. Minden írási parancsnál elküldődik, és egyben meghatározza a debounce ablakot is — a sablon a lekérdezett fényerő-értékeket transitionTime + 500 ms ideig figyelmen kívül hagyja minden írás után, hogy elkerülje az átmenet közbeni elavult olvasásokat.
Üzemmódváltás
Ha az eszköz jelenleg Color üzemmódban van, a sablon importálása előtt váltsa át White üzemmódba. Vagy:
- Nyissa meg a Shelly webes felületét a
http://{device-ip}címen, és módosítsa az üzemmódot a beállításokban, vagy - Küldjön közvetlenül
GET /settings?mode=whitekérést, vagy - Importálja ideiglenesen a Color üzemmódú sablont, használja a Set mode White szervizakcióját, majd importálja újra ezt a White üzemmódú sablont
Az üzemmód módosításához az eszköz újraindítása szükséges. Az eszköz újraindulása után importálja újra a White üzemmódú sablont a TapHome-ban.
Eszközképességek
Négy független dimmer
A sablon négy független fényerőszabályzó csatornát tesz elérhetővé, egyet-egyet minden PWM kimenetre:
| Csatorna | Kimenet pin | Végpont | Lekérdezési intervallum |
|---|---|---|---|
| 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 |
Minden dimmer a lights[N].ison és lights[N].brightness értékeket olvassa (0–100, 0–1-re normalizálva) a /status válaszból. Az írási parancsok a /light/N?turn=on|off&brightness=VALUE&transition=T formátumot használják. A sablon a régi /light/{idx} végpontot használja, amelyet a Shelly firmware a jelenlegi /white/{idx} végpont aliasaként fogad el.
Csatornánkénti energiamérés
Minden csatornának saját energiamérője van — Electric Meter Ch1 és Electric Meter Ch4 között — amelyek a meters[0]-tól meters[3]-ig olvasnak:
- Pillanatnyi teljesítmény —
meters[N].powerwattban, kW-ra konvertálva - Teljes fogyasztás —
meters[N].totalwatt-percben, kWh-ra konvertálva
Az 1. csatornát 2,5 s-onként kérdezik le a dimmerével együtt; a 2–4. csatornákat 15 s-os időközönként, hogy csökkentsék a Gen1 HTTP stack terhelését (amely csak két egyidejű kapcsolatot visel el).
Szervizdiagnosztika
A sablon 10 szervizattribútumot tesz elérhetővé eszközmonitorozáshoz:
- Hálózat — IP-cím, MAC-cím (kettőspontokkal formázva), Wi-Fi jelerősség (dB)
- Kapcsolat — cloud engedélyezve/csatlakoztatva, MQTT csatlakoztatva
- Eszközinformációk — eszköz ideje, üzemidő (nap/óra/perc formátumban), RAM használat
- Firmware — firmware frissítés elérhető
Szervizakciók
Három szervizakció érhető el:
- Cloud engedélyezése — engedélyezi vagy letiltja a Shelly Cloud kapcsolatot
- Újraindítás — eszköz újraindítását indítja
- White üzemmód beállítása — beírja a
/settings?mode=white-ot a White üzemmód kikényszerítéséhez (hasznos gyári visszaállítás után vagy ha valaki megváltoztatta az üzemmódot a Shelly alkalmazáson keresztül)
A Shelly Cloud API-t ez a sablon nem használja — a kommunikáció kizárólag helyi HTTP lekérdezéssel történik.
Hibaelhárítás
Az eszköz nem válaszol
- Ellenőrizze, hogy a Shelly csatlakozik a Wi-Fi-hez, és érvényes IP-címe van
- Próbálja az mDNS hostnevet (
shellyrgbw2-AABBCCDDEE.local) az IP-cím helyett — az IP megváltozhatott a DHCP megújítása után - Nyissa meg a
http://{device-ip}/shellycímet egy böngészőben — ha válaszol, az eszköz elérhető - Ellenőrizze, hogy a TapHome CCU és a Shelly ugyanazon a hálózaton / VLAN-on vannak
„Mode White is not supported" hiba
Ez a hiba azt jelenti, hogy az eszköz jelenleg Color üzemmódra van állítva. Megoldás:
- Nyissa meg a Shelly webes felületét a
http://{device-ip}címen, és váltsa át az üzemmódot White-ra, vagy - Küldjön közvetlenül
GET /settings?mode=whitekérést böngészőből vagy curl-ből, vagy - Ha van importálva Color üzemmódú sablon, futtassa onnan a White üzemmód beállítása szervizakciót
- Az eszközt az üzemmódváltás után újra kell indítani — várjon néhány másodpercet, és frissítse a TapHome-ot
A teljesítményolvasás nullát mutat
- Ellenőrizze, hogy a fehér LED-ek a megfelelő Shelly RGBW2 kimenetre vannak kötve (R, G, B vagy W pin)
- Nyissa meg a Shelly alkalmazást vagy webes felületet, és ellenőrizze, hogy az eszközmodell a Settings -> Device Model alatt be van-e állítva — enélkül a mérő nullát ad vissza
- Ellenőrizze, hogy a csatorna be van kapcsolva — a mérő csak akkor olvas, amikor áram folyik a kimeneten
- Kérdezze le kézzel a
/status-t, és ellenőrizze, hogy ameters[N].powernullától eltérő értéket ad vissza az adott csatornára
A csatorna nem tompít simán
- Ellenőrizze, hogy a transition time paraméter az elvárt viselkedést tükrözi-e — az alapértelmezett 300 ms rövid átmenet; hosszabb értékek (pl. 1500 ms) lassabb átmeneteket hoznak létre
- Ne feledje, hogy a debounce ablak egyenlő
transitionTime + 500 ms-vel — a gyorsabban küldött változásokat a rendszer összevonhatja - Ellenőrizze, hogy a LED terhelés dimmelhető-e (néhány driver nem PWM-kompatibilis), és hogy a tápegység stabil 12/24 V DC-t biztosít
A Gen1 Shelly eszközök csak 2 egyidejű HTTP kapcsolatot támogatnak. Ha a TapHome és egy másik rendszer (pl. Home Assistant) egyidejűleg kérdezi le ugyanazt az eszközt, a kommunikáció megbízhatatlanná válhat. Tartsa a lekérdezési intervallumot 10–30 másodpercen minden további klienshez.