
Shelly RGBW2 este un controler Wi-Fi pentru benzi LED, cu patru ieșiri PWM (12/24 V DC). În modul White, cele patru ieșiri — folosite în mod normal pentru R, G, B și W ale unei benzi RGBW — devin patru canale de dimmer monocolore independente. Fiecare canal poate comanda propria bandă LED albă, un bec LED sau un grup de spoturi. TapHome comunică cu dispozitivul prin HTTP în rețeaua locală; nu este necesară conexiunea la cloud.
Acest șablon este varianta pentru modul White a șablonului Shelly RGBW2 pentru modul Color. Ambele șabloane folosesc același hardware, dar firmware-ul funcționează în moduri care se exclud reciproc, selectate din setările dispozitivului. Înainte de a importa acest șablon, dispozitivul trebuie configurat în modul White — șablonul verifică modul la fiecare interogare și afișează o eroare dacă dispozitivul este setat pe Color.
Shelly a marcat RGBW2 ca scos din producție — Shelly Group nu îl mai produce și nu îl mai vinde. Unitățile existente continuă să funcționeze și primesc în continuare actualizări de firmware.
Cablare
Shelly RGBW2 se alimentează de la o sursă de 12 V sau 24 V DC (V+ / GND). Fiecare dintre cele patru ieșiri (marcate R, G, B, W pe dispozitiv) comandă o sarcină LED albă. Scheme de cablare tipice pentru modul White:
- Patru benzi LED albe sau becuri independente — fiecare canal comandă o bandă/un bec, cu anodul comun (+) la V+
- Mai multe spoturi pe canal — mai multe spoturi de 12/24 V conectate în paralel pe fiecare ieșire
- Două benzi albe cu putere dublă — câte două canale pe bandă (în paralel), pentru a dubla puterea de ieșire
Limitele de sarcină pe canal (conform specificației Shelly) sunt 45 W la 12 V și 90 W la 24 V. Sarcina totală pe toate cele patru canale nu trebuie să depășească 144 W la 12 V sau 288 W la 24 V.
Configurare
Șablonul se conectează prin Wi-Fi. La importul șablonului în TapHome, introduceți adresa IP a dispozitivului (valoarea implicită: 192.168.0.1) și, opțional, timpul de tranziție în milisecunde (implicit 300).
Timpul de tranziție determină cât de repede se schimbă treptat luminozitatea fiecărui canal. Se trimite cu fiecare comandă de scriere și definește și fereastra debounce — după fiecare scriere, șablonul ignoră valorile de luminozitate interogate timp de transitionTime + 500 ms, pentru a preveni citirile neactualizate în timpul unei tranziții graduale.
Comutarea modului
Dacă dispozitivul este în prezent în modul Color, comutați-l în modul White înainte de a importa acest șablon. Aveți următoarele variante:
- Deschideți interfața web Shelly la
http://{device-ip}și schimbați modul de funcționare în setări, sau - Trimiteți direct
GET /settings?mode=white, sau - Importați temporar șablonul pentru modul Color și folosiți acțiunea sa de service Setare mod White, apoi importați din nou acest șablon pentru modul White
Schimbarea modului necesită repornirea dispozitivului. După ce dispozitivul repornește, importați din nou în TapHome șablonul pentru modul White.
Funcțiile dispozitivului
Patru dimmere independente
Șablonul oferă patru canale de dimmer independente, câte unul pentru fiecare ieșire PWM:
| Canal | Pin de ieșire | Endpoint | Interval de interogare |
|---|---|---|---|
| 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 |
Fiecare dimmer citește lights[N].ison și lights[N].brightness (0-100, normalizat la 0-1) din răspunsul /status. Comenzile de scriere folosesc /light/N?turn=on|off&brightness=VALUE&transition=T. Șablonul folosește endpointul mai vechi /light/{idx}, pe care firmware-ul Shelly îl acceptă ca alias al endpointului actual /white/{idx}.
Măsurarea puterii pe fiecare canal
Fiecare canal are propriul contor electric — de la Contor electric Ch1 până la Contor electric Ch4 — care citește din meters[0] până la meters[3]:
- Putere în timp real —
meters[N].powerîn wați, convertită în kW - Consum total —
meters[N].totalîn wați-minut, convertit în kWh
Canalul 1 este interogat la 2,5 s, împreună cu dimmerul său; canalele 2-4 sunt interogate la intervale de 15 s, pentru a reduce încărcarea stivei HTTP Gen1 (care acceptă doar două conexiuni simultane).
Diagnosticare de service
Șablonul oferă 10 atribute de service pentru monitorizarea dispozitivului:
- Rețea — adresa IP, adresa MAC (formatată cu două puncte), puterea semnalului Wi-Fi (dB)
- Conectivitate — cloud activat/conectat, MQTT conectat
- Informații despre dispozitiv — ora dispozitivului, timpul de funcționare (formatat ca zile/ore/minute), utilizarea memoriei RAM
- Firmware — actualizare de firmware disponibilă
Acțiuni de service
Sunt disponibile trei acțiuni de service:
- Activare cloud — activează sau dezactivează conectivitatea Shelly Cloud
- Repornire — declanșează repornirea dispozitivului
- Setare mod White — scrie
/settings?mode=whitepentru a impune modul de funcționare White (util după o resetare la setările din fabrică sau dacă cineva a schimbat modul din aplicația Shelly)
Acest șablon nu folosește Shelly Cloud API — comunicația se face exclusiv prin interogare HTTP locală.
Rezolvarea problemelor
Dispozitivul nu răspunde
- Verificați dacă dispozitivul Shelly este conectat la Wi-Fi și are o adresă IP validă
- Încercați numele de gazdă mDNS (
shellyrgbw2-AABBCCDDEE.local) în locul adresei IP — adresa IP s-ar fi putut schimba după reînnoirea DHCP - Deschideți
http://{device-ip}/shellyîntr-un browser — dacă răspunde, dispozitivul este accesibil - Verificați dacă unitatea de control TapHome (CCU) și dispozitivul Shelly se află în aceeași rețea / VLAN
Eroarea „Mode White is not supported”
Această eroare înseamnă că dispozitivul este setat în prezent pe modul Color. Pentru rezolvare:
- Deschideți interfața web Shelly la
http://{device-ip}și comutați modul de funcționare pe White, sau - Trimiteți direct
GET /settings?mode=whitedintr-un browser sau cu curl, sau - Dacă aveți importat șablonul pentru modul Color, rulați de acolo acțiunea de service Setare mod White
- După schimbarea modului, dispozitivul trebuie să repornească — așteptați câteva secunde și reîncărcați TapHome
Valorile puterii sunt zero
- Verificați dacă LED-urile albe sunt conectate la ieșirea corespunzătoare a Shelly RGBW2 (pinul R, G, B sau W)
- Deschideți aplicația Shelly sau interfața web și verificați dacă modelul dispozitivului este configurat la Settings -> Device Model — fără această setare, contorul returnează zero
- Verificați dacă respectivul canal este pornit — contorul măsoară doar atunci când prin ieșire trece curent
- Interogați manual
/statusși verificați dacămeters[N].powerreturnează o valoare diferită de zero pentru canalul respectiv
Canalul nu reglează intensitatea lin
- Verificați dacă parametrul timpului de tranziție corespunde comportamentului așteptat — valoarea implicită de 300 ms este o tranziție scurtă; valorile mai mari (de ex. 1500 ms) produc tranziții mai lente
- Rețineți că fereastra debounce este egală cu
transitionTime + 500 ms— modificările trimise mai repede de atât pot fi comasate - Verificați dacă sarcina LED este dimabilă (unele drivere nu sunt compatibile cu PWM) și dacă sursa de alimentare furnizează o tensiune stabilă de 12/24 V DC
Dispozitivele Shelly Gen1 acceptă doar 2 conexiuni HTTP simultane. Dacă TapHome și un alt sistem (de ex. Home Assistant) interoghează același dispozitiv în același timp, comunicarea poate deveni instabilă. Păstrați intervalul de interogare la 10-30 de secunde pentru fiecare client suplimentar.