
A Shelly DUO RGBW (modell SHCB-1) egy Gen1 Wi-Fi okos LED izzó, E27 és GU10 formátumban kapható. Teljes RGB színeket és állítható fehéret (CCT 3000–6500 K) támogat sima átmeneti effektusokkal. Ez a TapHome integráció MQTT változata — a sablon a helyi hálózaton lévő megosztott MQTT brokeren keresztül kommunikál az izzókkal. Egyetlen izzós összeállításokhoz HTTP változat is elérhető.
A sablon modulonként akár 5 Shelly DUO RGBW izzót támogat. Minden izzópéldányt egy bulbNtopic egyéni változó különböztet meg, amely az izzó MQTT Device ID-jára mutat. Minden izzó egy RGBW lámpát és egy villamos mérőt biztosít — összesen 10 eszköz.
Konfiguráció
Device ID
Minden Shelly DUO RGBW izzónak egyedi MQTT Device ID-ja van shellycolorbulb-<DEVICEID> formátumban, ahol a <DEVICEID> a MAC címből származik (pl. shellycolorbulb-B929CC).
A Device ID megtalálható:
- Az eszköz csomagolásán vagy címkéjén (MAC cím)
- A Shelly webes felületen: Settings → Device Info
- API-n keresztül:
GET http://<device-ip>/settings→mqtt.idmező
Modulváltozók
A sablon importálása után a TapHome-ban konfigurálja az izzó topic változókat:
| Változó | Alapértelmezett | Leírás |
|---|---|---|
bulb1topic | shellycolorbulb-deviceid1 | MQTT Device ID az 1. izzóhoz |
bulb2topic | shellycolorbulb-deviceid2 | MQTT Device ID a 2. izzóhoz |
bulb3topic | shellycolorbulb-deviceid3 | MQTT Device ID a 3. izzóhoz |
bulb4topic | shellycolorbulb-deviceid4 | MQTT Device ID a 4. izzóhoz |
bulb5topic | shellycolorbulb-deviceid5 | MQTT Device ID az 5. izzóhoz |
Cserélje le az alapértelmezett helyőrzőt az egyes izzók tényleges Device ID-jára (pl. shellycolorbulb-B929CC). Csak a ténylegesen használt slotokat konfigurálja — az alapértelmezett helyőrzővel rendelkező nem használt slotok hibaüzenetet jelenítenek meg a helyes topic beállítására.
A modul feliratkozik a shellies/# topicra (QoS 0, port 1883), és a listener szkriptek az egyes izzókhoz konfigurált topic prefix alapján szűrik az üzeneteket.
Gen1 Shelly eszközökön az MQTT engedélyezése kikapcsolja a Shelly Cloudot. A kettő nem futhat egyidejűleg.
Eszközfunkciók
Fényerő-szabályozás
Minden izzó HSB Light eszközként van leképezve a TapHome-ban. Az izzó két kölcsönösen kizáró módban működik:
- Színes mód — teljes RGB vezérlés piros, zöld és kék csatornán (egyenként 0–255) plusz gain (0–100 %). A TapHome az RGB-t belsőleg HSV-re konvertálja — az árnyalat (0–360°), telítettség és fényerő vezérlési tulajdonságként érhető el. Az árnyalat vagy telítettség beállítása
color/0/setJSON payloadot küld"mode":"color"értékkel. - Fehér mód — állítható fehér színhőmérséklet (3000–6500 K) és fényerő (0–100 %) révén. A CCT érték beállítása a TapHome-ban automatikusan fehér módra kapcsolja az izzót
"mode":"white"publikálásával a hőmérséklettel és fényerővel.
Minden írási parancs konfigurálható átmeneti időt tartalmaz (alapértelmezett 300 ms) a sima halványítás érdekében. A debounce mechanizmus megakadályozza az elavult adatok olvasását az átmenetek során — a sablon figyelmen kívül hagyja a bejövő MQTT állapotüzeneteket transitionTime + 3000 ms időtartamra minden írási parancs után.
Fogyasztásmérés
Minden izzópéldány tartalmaz egy villamos mérőt, amely két értéket olvas:
- Pillanatnyi teljesítmény — a
shellies/{id}/light/0/powertopicból, wattban jelentve, kW-ra konvertálva (payload / 1000) - Összes fogyasztás — a
shellies/{id}/light/0/energytopicból, wattperben jelentve, kWh-ra konvertálva (payload / 60 000)
A fogyasztásmérés megköveteli az eszközmodell konfigurálását a Shelly alkalmazásban vagy webes felületen a Settings > Device Model alatt. E nélkül a fogyasztási értékek nullán maradnak.
További funkciók
A Shelly DUO RGBW támogatja továbbá a fényeffektusokat (meteor shower, gradual change, breath, flash, on/off gradual, red/green change), egy dedikált fehér LED csatornát (0–255) színes módban, MQTT kapcsolat állapotot LWT topicon keresztül, és teljes JSON állapotjelentést (firmware ≥1.8.0) Wi-Fi RSSI, uptime és hőmérsékleti adatokkal. Ezek a funkciók egy jövőbeli sablonfrissítésben adhatók hozzá.
Hibaelhárítás
Az izzók nem reagálnak
- Ellenőrizze, hogy az MQTT engedélyezve van minden izzó webes felületén (Internet & Security > Advanced — MQTT)
- Győződjön meg arról, hogy a broker címe és portja helyes mind a Shelly eszközbeállításokban, mind a TapHome modulkonfigurációban
- Ellenőrizze, hogy minden
bulbNtopicegyéni változó pontosan megegyezik az izzó Device ID-jával (pl.shellycolorbulb-B929CC) - Használjon MQTT klienst (pl. MQTT Explorer), iratkozzon fel a
shellies/#topicra és ellenőrizze, hogy minden izzó publikál üzeneteket
A színek helytelenül jelennek meg
- Ellenőrizze, hogy az izzó színes módban van — az RGB színek csak színes módban működnek, fehér módban nem
- Győződjön meg arról, hogy a telítettség nagyobb mint nulla — a 0 telítettség az árnyalattól függetlenül fehér fényt produkál
- Ellenőrizze, hogy a gain (fényerő színes módban) nincs nullára állítva
A fogyasztási értékek nullát mutatnak
- Győződjön meg arról, hogy az eszközmodell konfigurálva van a Shelly alkalmazásban vagy webes felületen (Settings > Device Model)
- Ellenőrizze, hogy az izzó be van kapcsolva — a mérő csak akkor olvas, ha az izzó áramot vesz fel
A Gen1 Shelly eszközök nem támogatják az MQTT-t TLS-en keresztül. Az izzók és az MQTT broker közötti kommunikáció titkosítatlan (plain MQTT, port 1883). Győződjön meg arról, hogy az MQTT broker megbízható helyi hálózaton üzemel.