
Shelly DUO (model SHBDUO-1) je pametna Wi-Fi LED žarulja Gen1, dostupna u izvedbama E27 i GU10. Osnovni DUO ima samo bijelo svjetlo s podesivom temperaturom boje i mogućnošću prigušivanja, bez RGB kanala (izvedba s RGB-om je DUO RGBW / shellycolorbulb- i koristi zaseban predložak). Ovo je MQTT varijanta integracije TapHome; za instalacije s jednom žaruljom dostupna je i HTTP varijanta.
Predložak podržava do 5 žarulja DUO po modulu preko zajedničkog MQTT brokera u lokalnoj mreži. Svaka se žarulja prepoznaje po varijabli modula bulbNtopic koja upućuje na MQTT Device ID žarulje. Za svaku žarulju predložak daje uređaj bijelog svjetla i brojilo energije, ukupno 10 uređaja.
Konfiguracija
MQTT broker
Predložak zahtijeva MQTT broker dostupan u lokalnoj mreži. Odgovara bilo koji standardni broker (Mosquitto, EMQX ili broker ugrađen u Home Assistant). Broker radi na portu 1883 bez TLS-a (hardver Shelly Gen1 ne podržava MQTT preko TLS-a), pa ga držite u pouzdanom dijelu mreže.
Nakon uvoza predloška postavite vezu s brokerom u parametrima uvoza modula:
| Parametar | Zadano | Opis |
|---|---|---|
MQTT Broker IP (IpAddress) | 192.168.0.1 | Adresa brokera u lokalnoj mreži |
MQTT Broker port (Port) | 1883 | Standardni MQTT port (bez TLS-a) |
Transition time (TransitionTime) | 300 | Zadano trajanje postupnog prijelaza za svaku žarulju u milisekundama |
Uključivanje MQTT-a na žarulji
Na svakoj žarulji Shelly DUO treba postaviti vezu s brokerom prije nego što počne objavljivati poruke ili primati naredbe:
- Otvorite web-sučelje žarulje na
http://<bulb-ip>(IP adresu pronađite u DHCP tablici usmjerivača ili u aplikaciji Shelly) - Otvorite Internet & Security → Advanced — MQTT i uključite MQTT
- Unesite server brokera (IP adresu i port, npr.
192.168.0.10:1883), a username / password ostavite prazno (predložak TapHome ne nudi autentifikaciju na brokeru) - Po želji prilagodite MQTT prefix ako ne želite zadani
shellies/ShellyBulbDuo-<MAC6> - Spremite postavke i ponovno pokrenite žarulju: kada se ponovno spoji, počinje objavljivati na
shellies/ShellyBulbDuo-<id>/light/0/status
Device ID (bulbNtopic)
Svaki Shelly DUO ima jedinstveni MQTT Device ID u obliku ShellyBulbDuo-<MAC6>, gdje je <MAC6> zadnjih 6 heksadecimalnih znakova MAC adrese (npr. ShellyBulbDuo-B929CC). Ista je vrijednost i mDNS naziv hosta žarulje (ShellyBulbDuo-<MAC6>.local).
Device ID možete pronaći:
- U web-sučelju Shelly: Settings → Device Info → polje
mqtt.id - Preko HTTP-a:
GET http://<bulb-ip>/settings→mqtt.id - Na naljepnici uređaja ili ambalaži (zadnjih 6 znakova MAC adrese, malim slovima u heksadecimalnom zapisu)
- Kao mDNS naziv hosta, npr.
ShellyBulbDuo-b929cc.local
U sustavu TapHome otvorite modul Shelly DUO MQTT i ispunite varijable teme za svaku žarulju koju želite koristiti:
| Varijabla | Zadano | Opis |
|---|---|---|
bulb1topic | ShellyBulbDuo-deviceid1 | MQTT Device ID prve žarulje DUO |
bulb2topic | ShellyBulbDuo-deviceid2 | MQTT Device ID druge žarulje DUO |
bulb3topic | ShellyBulbDuo-deviceid3 | MQTT Device ID treće žarulje DUO |
bulb4topic | ShellyBulbDuo-deviceid4 | MQTT Device ID četvrte žarulje DUO |
bulb5topic | ShellyBulbDuo-deviceid5 | MQTT Device ID pete žarulje DUO |
Zamijenite zadanu vrijednost stvarnim Device ID-em svake žarulje kojom želite upravljati (npr. ShellyBulbDuo-B929CC). Modul se pretplaćuje na shellies/#, a skripte za primanje poruka pojedinih žarulja filtriraju poruke prema prefiksu teme. Mjesta koja su još na zadanoj vrijednosti javljaju pogrešku u sustavu TapHome dok ih ne konfigurirate ili ne uklonite iz predloška.
Vrijeme prijelaza za pojedinu žarulju
Svaki uređaj Svjetlo ima korisničku varijablu transitionTime (u milisekundama, raspon 0–5000 ms) čija je zadana vrijednost parametar uvoza modula TransitionTime. Promijenite je na pojedinim žaruljama ako želite različito trajanje postupnog prijelaza. Vrijednost se pri svakoj promjeni svjetline ili temperature boje šalje kao polje transition u JSON poruci na /light/0/set.
Uključivanje MQTT-a na uređaju Shelly Gen1 isključuje Shelly Cloud: MQTT i Shelly Cloud ne mogu raditi istodobno. HTTP REST i CoIoT ostaju dostupni, pa je žarulja i dalje dostupna iz lokalne mreže.
Mogućnosti uređaja
Predložak po modulu daje 10 uređaja: 5 svjetala s podesivim bijelim svjetlom i 5 brojila energije, po jedan par za svaku fizičku žarulju. Svih 5 parova funkcionalno je jednako, a razlikuju se samo po varijabli bulbNtopic koju prate.
Upravljanje svjetlom
Svaki uređaj Svjetlo u sustavu TapHome prikazan je kao White Light (podesivo bijelo svjetlo) s dva svojstva kojima se upravlja:
- Svjetlina: čita se iz polja
$.brightness(0–100) JSON porukelight/0/status, preračunava se u raspon 0,0–1,0 koji koristi TapHome; upisuje se prekolight/0/sets"turn":"on", "brightness":N, "transition":<ms> - Temperatura boje: čita se iz
$.temp(3000–6500 K), upisuje se prekolight/0/sets"temp":K, "transition":<ms>
Za isključivanje svjetla koristi se zasebna tema light/0/command s porukom off, što je brže od slaganja JSON poruke set. Promjene svjetline i temperature boje uvijek sadrže polje transition, pa žarulja svjetlo mijenja postupno umjesto naglo.
Mjerenje snage
Svaki uređaj Brojilo energije pretplaćen je na dvije teme s pojedinačnim vrijednostima koje žarulja objavljuje otprilike jednom u sekundi:
| Vrijednost u sustavu TapHome | Izvorna tema | Izvorna jedinica | Pretvorba | Prikazana jedinica |
|---|---|---|---|---|
| Trenutačna snaga | shellies/ShellyBulbDuo-<id>/light/0/power | W | ÷ 1000 | kW |
| Ukupna potrošnja | shellies/ShellyBulbDuo-<id>/light/0/energy | vat-minute | ÷ 60000 | kWh |
Pretvorba vat-minuta u kWh potrebna je jer firmver Shelly Gen1 ukupnu energiju javlja u W·min, a ne u W·h.
Mjerenje snage bez upozorenja pokazuje nulu dok se u aplikaciji ili web-sučelju Shelly ne postavi Settings → Device Model (E27 ili GU10). Skripta TapHome pri prvom čitanju prikazuje informativnu poruku koja vas na to podsjeća. Čim je model postavljen, žarulja odmah počinje javljati vrijednosti
power/energyrazličite od nule.
Rješavanje problema
Žarulja ne odgovara
- Provjerite je li žarulja spojena na Wi-Fi i dostupna u lokalnoj mreži: otvorite
http://<bulb-ip>/shelly. Odgovor koji sadrži"type":"SHBDUO-1"potvrđuje uređaj. - Umjesto IP adrese pokušajte mDNS naziv hosta (
ShellyBulbDuo-<MAC6>.local): obnova DHCP zakupa ili ponovno pokretanje usmjerivača može promijeniti IP adresu. - Provjerite je li MQTT uključen u postavkama žarulje Internet & Security → Advanced — MQTT i odgovaraju li IP adresa i port brokera parametrima uvoza u sustavu TapHome.
- MQTT klijentom (npr. MQTT Explorer ili
mosquitto_sub -h <broker> -t 'shellies/#' -v) provjerite objavljuje li žarulja poruke nashellies/ShellyBulbDuo-<id>/....
Pogreška „Set correct ‘bulbNtopic’ value”
Skripta javlja ovu pogrešku kada je bulbNtopic još postavljen na zadanu vrijednost (ShellyBulbDuo-deviceid). Za to mjesto upišite stvarni Device ID ili uklonite neiskorištene uređaje iz predloška ako imate samo nekoliko žarulja.
Snaga i energija ostaju na nuli
- Otvorite aplikaciju Shelly (ili web-sučelje) → Settings → Device Model i odaberite odgovarajući podmodel (Shelly Bulb DUO E27 ili Shelly Bulb DUO GU10). Žarulja izračunava
power/energytek kada je model poznat. - Provjerite je li žarulja stvarno uključena: brojilo se ažurira samo dok teče struja.
- MQTT klijentom se izravno pretplatite na
shellies/ShellyBulbDuo-<id>/light/0/poweri provjerite objavljuje li žarulja vrijednost različitu od nule.
Najtoplija temperatura boje je samo 3000 K
XML predložak TapHome ograničava temperaturu boje na 3000–6500 K u skladu s rasponom koji se navodi za E27. Sam hardver podržava 2700–6500 K kod podmodela GU10 i preko izravnog API-ja /light/0/set, pa najtoplijih 300 K raspona žarulje GU10 nije dostupno preko predloška TapHome.
Prijelazi svjetla nisu glatki
Povećajte korisničku varijablu transitionTime pojedine žarulje (ili zadanu vrijednost TransitionTime na razini modula). 300 ms je dovoljno za male korake prigušivanja, ali kod velikih promjena svjetline ili temperature boje prijelaz može izgledati stepenasto. Za glađi prijelaz pokušajte 800–1500 ms.
Uređaji Shelly Gen1 koriste obični MQTT na portu 1883, bez podrške za TLS. Predložak TapHome ne nudi ni
username/passwordza broker, pa koristite broker bez autentifikacije u pouzdanoj lokalnoj mreži ili VLAN-u.