---
title: "Shelly DUO RGBW MQTT"
description: "Do 5 žarulja Shelly DUO RGBW preko MQTT-a: RGB boje, podesivo bijelo svjetlo 3000–6500 K, postupni prijelazi i mjerenje snage. Predložak za TapHome."
url: "https://taphome.com/hr/compatibility/shelly-duo-rgbw-mqtt/"
language: hr
lastmod: 2026-03-30
generator: hugo
ai:
  topics: ["mqtt","lighting","wifi","rgbw","color-temperature","power-metering"]
  questions: ["Kako integrirati Shelly DUO RGBW sa sustavom TapHome preko MQTT-a?","Čime upravlja predložak TapHome Shelly DUO RGBW MQTT?","Kako preko MQTT-a spojiti više žarulja Shelly DUO RGBW na TapHome?","Kako pronaći MQTT Device ID žarulje Shelly DUO RGBW?","Zašto moja Shelly DUO RGBW prikazuje nultu snagu?","Kako preko MQTT-a Shelly DUO RGBW prebaciti iz načina boje u bijeli način i obratno?"]
---

# Shelly DUO RGBW MQTT

Komunikacija: Packet Parser → MQTT

- [Stranica proizvoda Shelly DUO RGBW](https://www.shelly.com/en/products/shop/shelly-duo-rgbw-gu10)

> Adresa u mreži
> 
> Kod MQTT brokera ugrađenog u TapHome radi se o jednom brokeru kojem se pristupa s dva mjesta. Predložak radi izravno u jedinici TapHome Core, zato je u TapHomeu adresa brokera `127.0.0.1` (ovo računalo). Uređaj radi drugdje u mreži, zato u uređaju unesite IP adresu jedinice TapHome Core i za Core postavite rezervaciju IP adrese u usmjerivaču — ako se adresa jedinice Core promijeni, uređaj više ne dolazi do brokera.
> 
> [Priprema mreže](https://taphome.com/hr/docs/setup/network-preparation/)

## Upute za integraciju

Shelly DUO RGBW (model SHCB-1) je pametna Wi-Fi LED žarulja Gen1, dostupna u izvedbama E27 i GU10. Podržava pune RGB boje i podesivo bijelo svjetlo (CCT 3000–6500 K) s postupnim prijelazima. Ovo je **MQTT varijanta** integracije TapHome: predložak sa žaruljama komunicira preko zajedničkog MQTT brokera u lokalnoj mreži. Za instalacije s jednom žaruljom dostupna je i [HTTP varijanta](https://taphome.com/hr/compatibility/shelly-duo-rgbw/).

Predložak podržava do **5 žarulja Shelly DUO RGBW** po modulu. Svaka se žarulja razlikuje po korisničkoj varijabli `bulbNtopic` koja upućuje na MQTT Device ID žarulje. Svaka žarulja daje uređaj RGBW svjetla i brojilo energije, ukupno 10 uređaja.

## Konfiguracija

### Device ID

Svaka žarulja Shelly DUO RGBW ima jedinstveni MQTT Device ID u obliku `shellycolorbulb-<DEVICEID>`, gdje se `<DEVICEID>` izvodi iz MAC adrese (npr. `shellycolorbulb-B929CC`).

Device ID možete pronaći:

- Na ambalaži ili naljepnici uređaja (MAC adresa)
- U web-sučelju Shelly: **Settings** → **Device Info**
- Preko API-ja: `GET http://<device-ip>/settings` → polje `mqtt.id`

### Varijable modula

Nakon uvoza predloška u TapHome konfigurirajte varijable tema žarulja:

| Varijabla | Zadano | Opis |
|----------|---------|-------------|
| `bulb1topic` | `shellycolorbulb-deviceid1` | MQTT Device ID žarulje 1 |
| `bulb2topic` | `shellycolorbulb-deviceid2` | MQTT Device ID žarulje 2 |
| `bulb3topic` | `shellycolorbulb-deviceid3` | MQTT Device ID žarulje 3 |
| `bulb4topic` | `shellycolorbulb-deviceid4` | MQTT Device ID žarulje 4 |
| `bulb5topic` | `shellycolorbulb-deviceid5` | MQTT Device ID žarulje 5 |

Zamijenite zadanu vrijednost stvarnim Device ID-em svake žarulje (npr. `shellycolorbulb-B929CC`). Konfigurirajte samo mjesta koja stvarno koristite: neiskorištena mjesta sa zadanom vrijednošću prikazat će poruku o pogrešci s upozorenjem da treba postaviti ispravnu temu.

Modul se pretplaćuje na `shellies/#` (QoS 0, port 1883), a skripte za primanje poruka filtriraju poruke prema postavljenom prefiksu teme za svaku žarulju.

> [!WARNING]
> Kod uređaja Shelly Gen1 uključivanje MQTT-a **isključuje Shelly Cloud**. MQTT i Shelly Cloud ne mogu raditi istodobno.

## Mogućnosti uređaja

### Upravljanje svjetlom

Svaka je žarulja u sustavu TapHome prikazana kao uređaj vrste „HSB svjetlo”. Žarulja radi u dva načina koji se međusobno isključuju:

- **Način boje**: puno RGB upravljanje preko crvenog, zelenog i plavog kanala (svaki 0–255) i pojačanja (gain, 0–100 %). TapHome interno pretvara RGB u HSV, a nijansa (0–360°), zasićenost i svjetlina dostupne su kao svojstva za upravljanje. Postavljanje nijanse ili zasićenosti šalje JSON poruku `color/0/set` s `"mode":"color"`.
- **Bijeli način**: podesivo bijelo svjetlo preko temperature boje (3000–6500 K) i svjetline (0–100 %). Postavljanje temperature boje u sustavu TapHome automatski prebacuje žarulju u bijeli način objavom `"mode":"white"` s temperaturom i svjetlinom.

Sve naredbe upisa sadrže podesivo vrijeme prijelaza (zadano 300 ms) za postupan prijelaz između stanja. Mehanizam zaštite od odskakivanja (debounce) sprječava zastarjela očitanja tijekom prijelaza: predložak nakon svake naredbe upisa zanemaruje dolazne MQTT poruke stanja tijekom `transitionTime + 3000 ms`.

### Mjerenje snage

Svaka žarulja ima brojilo energije koje čita dvije vrijednosti:

- **Trenutačna snaga**: iz `shellies/{id}/light/0/power`, javlja se u vatima, pretvara se u kW (vrijednost iz poruke / 1000)
- **Ukupna potrošnja**: iz `shellies/{id}/light/0/energy`, javlja se u vat-minutama, pretvara se u kWh (vrijednost iz poruke / 60 000)

> [!TIP]
> Za mjerenje snage u aplikaciji ili web-sučelju Shelly mora biti postavljen model uređaja pod **Settings** > **Device Model**. Bez te postavke očitanja snage ostaju na nuli.

### Dodatne mogućnosti

Shelly DUO RGBW podržava i svjetlosne efekte (kiša meteora, postupna promjena, disanje, bljeskanje, postupno uključivanje i isključivanje, izmjena crvene i zelene), zaseban kanal bijele LED diode (0–255) u načinu boje, stanje MQTT veze preko teme LWT i cjelovitu poruku stanja u formatu JSON (firmver ≥1.8.0) s podacima o Wi-Fi RSSI, vremenu rada i temperaturi. Te se mogućnosti mogu dodati u budućem ažuriranju predloška.

## Rješavanje problema

### Žarulje ne odgovaraju

1. Provjerite je li MQTT uključen u web-sučelju svake žarulje (**Internet & Security** > **Advanced — MQTT**)
2. Provjerite jesu li adresa i port brokera ispravni i u postavkama uređaja Shelly i u konfiguraciji modula TapHome
3. Provjerite odgovara li svaka korisnička varijabla `bulbNtopic` točno Device ID-u žarulje (npr. `shellycolorbulb-B929CC`)
4. MQTT klijentom (npr. MQTT Explorer) pretplatite se na `shellies/#` i provjerite objavljuje li svaka žarulja poruke

### Boje izgledaju pogrešno

1. Provjerite je li žarulja u načinu boje: RGB boje rade samo u načinu boje, a ne u bijelom načinu
2. Zasićenost mora biti veća od nule: zasićenost 0 daje bijelo svjetlo bez obzira na nijansu
3. Provjerite da pojačanje (gain, svjetlina u načinu boje) nije postavljeno na nulu

### Očitanje snage je nula

1. Provjerite je li u aplikaciji ili web-sučelju Shelly postavljen model uređaja (**Settings** > **Device Model**)
2. Provjerite je li žarulja uključena: brojilo mjeri samo kada žarulja troši energiju

> [!WARNING]
> Uređaji Shelly Gen1 **ne** podržavaju MQTT preko TLS-a. Komunikacija između žarulja i MQTT brokera nije šifrirana (obični MQTT, port 1883). Pobrinite se da je MQTT broker u pouzdanoj lokalnoj mreži.

## Kako ga instalirati u TapHome

### Preduvjeti

- Uređaj Shelly spojen na Wi-Fi (2,4 GHz), npr. putem aplikacije Shelly ili vlastite pristupne točke uređaja
- MQTT broker koji radi u vašoj lokalnoj mreži (npr. Mosquitto, Home Assistant ili ugrađeni broker TapHome)
- TapHome CCU u istoj mreži kao broker

> [!WARNING]
> Na uređajima **Gen1** uključivanje MQTT-a **isključuje Shelly Cloud**. MQTT i Shelly Cloud ne mogu raditi istodobno. Na uređajima Gen2/Plus to ograničenje ne vrijedi.

### Korak 1 — Uključite MQTT na uređaju Shelly

#### Uređaji Gen1 (Shelly 1, 1PM, 2.5, EM, 3EM, Plug S, RGBW2, Dimmer, TRV…)

1. Otvorite web-sučelje Shelly: `http://<device-ip>/`
2. Idite na **Internet & Security** → **Advanced — MQTT**
3. Uključite **MQTT**
4. Postavite **MQTT Server**: `<broker-ip>:<port>` (npr. `192.168.1.10:1883`)
5. Ako vaš broker zahtijeva autentifikaciju, postavite **MQTT User** i **MQTT Password**
6. Kliknite **Save** — uređaj će se ponovno pokrenuti i spojiti na broker

#### Uređaji Gen2 / Plus (Shelly Plus 1, Plus 1PM, Plus 2PM, Plus Plug S, Plus H&T, Pro 3EM…)

1. Otvorite web-sučelje Shelly: `http://<device-ip>/`
2. Idite na **Settings** → **MQTT**
3. Uključite **MQTT**
4. Postavite **Server**: `<broker-ip>:<port>` (npr. `192.168.1.10:1883`)
5. **Client ID** je unaprijed popunjen ID-jem uređaja (npr. `shellyplus1pm-AABBCCDDEE`) — ostavite ga takvim, osim ako ga iz određenog razloga trebate promijeniti
6. Kliknite **Save** i ponovno pokrenite uređaj

Kod ugrađenog brokera TapHome `<broker-ip>` je IP adresa centralne jedinice TapHome Core. Centralnoj jedinici Core dodijelite rezervaciju IP adrese u usmjerivaču, inače uređaj gubi broker kada usmjerivač promijeni adresu → [Priprema mreže](https://taphome.com/hr/docs/setup/network-preparation/).

> [!TIP]
> Za provjeru rada MQTT-a koristite MQTT klijent (npr. MQTT Explorer) i pretplatite se na `shellies/#` (Gen1) ili `<device-id>/#` (Gen2). Trebali biste vidjeti statusne poruke uređaja.

### Korak 2 — Pronađite Device ID / MQTT Client ID

Neki predlošci zahtijevaju parametar **Device ID** ili **MQTT Client ID**. To je jedinstveni identifikator koji se koristi u MQTT temama (topics).

- **Gen1:** nalazi se na naljepnici kao MAC adresa (npr. `AABBCCDDEE`). Device ID = `shelly<model>-<mac>`, npr. `shelly1pm-AABBCCDDEE`
- **Gen2/Plus:** nalazi se u web-sučelju Shelly pod **Settings** → **Device Info** → **Device ID** ili na naljepnici uređaja

### Korak 3 — Konfiguracija u sustavu TapHome

1. U sustavu TapHome dodajte novi modul **Packet Parser (MQTT)**
2. **IP adresa:** za ugrađeni broker TapHome `127.0.0.1` (centralna jedinica spaja se sama na sebe, adresa se nikada ne mijenja); za vanjski broker njegova IP adresa (npr. `192.168.1.10`)
3. **Port:** `1883` (zadano; za TLS koristite `8883`)
4. **Device ID / MQTT Client ID:** unesite vrijednost iz koraka 2 (ako je predložak zahtijeva)
5. Uvezite predložak — TapHome će se automatski pretplatiti na teme uređaja

## Dostupni uređaji 10

Ovi se uređaji pojavljuju u TapHomeu nakon uvoza.

Shelly DUO RGBW MQTT Modul

Prilagođene varijable

|                                                   |                                                                                                                                                                                         |
|---------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `bulb1topic` (string) = shellycolorbulb-deviceid1 | MQTT Device ID žarulje 1, koji se koristi u temi shellies/&lt;Device ID&gt;/… — oblik je „shellycolorbulb-DEVICEID” (Device ID pronađite u web-sučelju Shelly → Settings → Device Info) |
| `bulb2topic` (string) = shellycolorbulb-deviceid2 | Naziv MQTT teme žarulje 2                                                                                                                                                               |
| `bulb3topic` (string) = shellycolorbulb-deviceid3 | Naziv MQTT teme žarulje 3                                                                                                                                                               |
| `bulb4topic` (string) = shellycolorbulb-deviceid4 | Naziv MQTT teme žarulje 4                                                                                                                                                               |
| `bulb5topic` (string) = shellycolorbulb-deviceid5 | Naziv MQTT teme žarulje 5                                                                                                                                                               |

Brojilo energije 1 Brojilo električne energije Samo za čitanje

Mjerenje potrošnje snage i energije za žarulju 1 — trenutačna snaga (kW) i ukupna energija (kWh)

numeric Jedinica: kW / kWh

Listener

```taphome
ADDINFO("To enable power monitoring, open device settings in Shelly app or web browser and configure device model in Settings->Device Model");

IF(INDEXOF(bulb1topic, "shellycolorbulb-deviceid") = 0)
    ADDERROR("Set correct 'bulb1topic' value in module variables. Topic format is 'shellycolorbulb-<deviceid>'. The Device ID can be found by opening url 'http://shellyIpAddress', in Settings -> Device info.");
    RETURN(-1);
END

IF INDEXOF(RECEIVEDMSG.TOPIC, "shellies/" + bulb1topic + "/light/0/power") = 0
    Ed := TODOUBLE(TOSTRING(RECEIVEDMSG.PAYLOAD)) / 1000.0;
ELSEIF INDEXOF(RECEIVEDMSG.TOPIC, "shellies/" + bulb1topic + "/light/0/energy") = 0
    To := TODOUBLE(TOSTRING(RECEIVEDMSG.PAYLOAD)) / 60000.0;
END
```

RGBW svjetlo 1 HSB svjetlo Čitanje i pisanje

HSB svjetlo s dva načina — pune RGB boje s pojačanjem ili podesivo bijelo svjetlo (3000–6500 K) sa svjetlinom

json JSON (ison, mode, red, green, blue, white, gain, temp, brightness, effect)

Listener

```taphome
IF(INDEXOF(bulb1topic, "shellycolorbulb-deviceid") = 0)
    ADDERROR("Set correct 'bulb1topic' value in module variables. Topic format is 'shellycolorbulb-<deviceid>'. The Device ID can be found by opening url 'http://shellyIpAddress', in Settings -> Device info.");
    RETURN(-1);
END

VAR now := NOW();
IF now.Ticks < debounceTimestamp
    RETURN(0);
END

IF INDEXOF(RECEIVEDMSG.TOPIC, "shellies/" + bulb1topic + "/color/0/status") != 0
    RETURN(0);
END

IF RECEIVEDMSG.PAYLOAD.LENGTH = 0
    RETURN(0);
END

BOOL ison := PARSEJSON(RECEIVEDMSG.PAYLOAD, "$.ison", 1);
VAR mode := PARSEJSON(RECEIVEDMSG.PAYLOAD, "$.mode", 1);

IF ISNULL(mode)
    RETURN(0);
END

INT bright;

IF mode = "color"
    UINT8 red := PARSEJSON(RECEIVEDMSG.PAYLOADStatus, "$.red");
    UINT8 green := PARSEJSON(RECEIVEDMSG.PAYLOADStatus, "$.green");
    UINT8 blue := PARSEJSON(RECEIVEDMSG.PAYLOADStatus, "$.blue");
    bright := PARSEJSON(RECEIVEDMSG.PAYLOADStatus, "$.gain");
    
    VAR hsvColor := RGBTOHSV(red, green, blue);
    
    Hd := ROUND(hsvColor.Hue);
    Sa := ROUND(hsvColor.Saturation * 100.0) / 100.0;
    Ct := NaN;
ELSE
    Ct := PARSEJSON(RECEIVEDMSG.PAYLOADStatus, "$.temp");
    bright := PARSEJSON(RECEIVEDMSG.PAYLOADStatus, "$.brightness");
END

IF ison
    Hb:= bright / 100.0;
    St := isOn;
ELSE
    Hb := 0;
    St := 0;
END
```

Zapis svjetline

```taphome
VAR now := NOW();
debounceTimestamp := now.Ticks + transitionTime + 3000;

IF St > 0.5
    VAR topic := "shellies/" + bulb1topic + "/color/0/set";
    
	IF ISNAN(Ct)
        MQTTPUBLISH(topic, "{\"turn\": \"on\", \"transition\": " + transitionTime + ", \"gain\": " + ROUND(Hb*100.0) + "}");
    ELSE
        MQTTPUBLISH(topic, "{\"turn\": \"on\", \"transition\": " + transitionTime + ", \"brightness\": " + ROUND(Hb*100.0) + "}");
        
    END
ELSE
    MQTTPUBLISH("shellies/" + bulb1topic + "/color/0/command", "off");
END
```

Zapis nijanse

```taphome
IF !ISNAN(Ct)
    RETURN(0);
END

VAR now := NOW();
debounceTimestamp := now.Ticks + transitionTime + 3000;

VAR topic := "shellies/" + bulb1topic + "/color/0/set";
VAR rgbColor := HSVTORGB(Hd, Sa, 1);

VAR data := "{\"mode\": \"color\", \"gain\": " + ROUND(Hb*100.0) + ", \"transition\":" + transitionTime + ",\"red\":" + rgbColor.red + ",\"green\":" + rgbColor.green + ",\"blue\":" + rgbColor.blue + "}";

MQTTPUBLISH(topic, data);
```

Zapis zasićenosti

```taphome
IF !ISNAN(Ct)
    RETURN(0);
END

VAR now := NOW();
debounceTimestamp := now.Ticks + transitionTime + 3000;

VAR topic := "shellies/" + bulb1topic + "/color/0/set";
VAR rgbColor := HSVTORGB(Hd, Sa, 1);

VAR data := "{\"mode\": \"color\", \"gain\": " + ROUND(Hb*100.0) + ", \"transition\":" + transitionTime + ",\"red\":" + rgbColor.red + ",\"green\":" + rgbColor.green + ",\"blue\":" + rgbColor.blue + "}";

MQTTPUBLISH(topic, data);
```

Zapis temperature boje

```taphome
IF ISNAN(Ct)
    RETURN(0);
END

VAR now := NOW();
debounceTimestamp := now.Ticks + transitionTime + 3000;

VAR topic := "shellies/" + bulb1topic + "/color/0/set";

MQTTPUBLISH(topic, "{\"mode\": \"white\", \"brightness\": " + ROUND(Hb*100.0) + ", \"transition\": " + transitionTime + ", \"temp\":" + Ct + "}");
```

Brojilo energije 2 Brojilo električne energije Samo za čitanje

Mjerenje potrošnje energije za žarulju 2 — trenutačna snaga (kW) i ukupna energija (kWh)

numeric Jedinica: kW / kWh

Listener

```taphome
ADDINFO("To enable power monitoring, open device settings in Shelly app or web browser and configure device model in Settings->Device Model");

IF(INDEXOF(bulb2topic, "shellycolorbulb-deviceid") = 0)
    ADDERROR("Set correct 'bulb2topic' value in module variables. Topic format is 'shellycolorbulb-<deviceid>'. The Device ID can be found by opening url 'http://shellyIpAddress', in Settings -> Device info.");
    RETURN(-1);
END

IF INDEXOF(RECEIVEDMSG.TOPIC, "shellies/" + bulb2topic + "/light/0/power") = 0
    Ed := TODOUBLE(TOSTRING(RECEIVEDMSG.PAYLOAD)) / 1000.0;
ELSEIF INDEXOF(RECEIVEDMSG.TOPIC, "shellies/" + bulb2topic + "/light/0/energy") = 0
    To := TODOUBLE(TOSTRING(RECEIVEDMSG.PAYLOAD)) / 60000.0;
END
```

RGBW svjetlo 2 HSB svjetlo Čitanje i pisanje

HSB svjetlo s dva načina — pune RGB boje s pojačanjem ili podesivo bijelo svjetlo (3000–6500 K) sa svjetlinom

json JSON (ison, mode, red, green, blue, white, gain, temp, brightness, effect)

Listener

```taphome
IF(INDEXOF(bulb2topic, "shellycolorbulb-deviceid") = 0)
    ADDERROR("Set correct 'bulb2topic' value in module variables. Topic format is 'shellycolorbulb-<deviceid>'. The Device ID can be found by opening url 'http://shellyIpAddress', in Settings -> Device info.");
    RETURN(-1);
END

VAR now := NOW();
IF now.Ticks < debounceTimestamp
    RETURN(0);
END

IF INDEXOF(RECEIVEDMSG.TOPIC, "shellies/" + bulb2topic + "/color/0/status") != 0
    RETURN(0);
END

IF RECEIVEDMSG.PAYLOAD.LENGTH = 0
    RETURN(0);
END

BOOL ison := PARSEJSON(RECEIVEDMSG.PAYLOAD, "$.ison", 1);
VAR mode := PARSEJSON(RECEIVEDMSG.PAYLOAD, "$.mode", 1);

IF ISNULL(mode)
    RETURN(0);
END

INT bright;

IF mode = "color"
    UINT8 red := PARSEJSON(RECEIVEDMSG.PAYLOADStatus, "$.red");
    UINT8 green := PARSEJSON(RECEIVEDMSG.PAYLOADStatus, "$.green");
    UINT8 blue := PARSEJSON(RECEIVEDMSG.PAYLOADStatus, "$.blue");
    bright := PARSEJSON(RECEIVEDMSG.PAYLOADStatus, "$.gain");
    
    VAR hsvColor := RGBTOHSV(red, green, blue);
    
    Hd := ROUND(hsvColor.Hue);
    Sa := ROUND(hsvColor.Saturation * 100.0) / 100.0;
    Ct := NaN;
ELSE
    Ct := PARSEJSON(RECEIVEDMSG.PAYLOADStatus, "$.temp");
    bright := PARSEJSON(RECEIVEDMSG.PAYLOADStatus, "$.brightness");
END

IF ison
    Hb:= bright / 100.0;
    St := isOn;
ELSE
    Hb := 0;
    St := 0;
END
```

Zapis svjetline

```taphome
VAR now := NOW();
debounceTimestamp := now.Ticks + transitionTime + 3000;

IF St > 0.5
    VAR topic := "shellies/" + bulb2topic + "/color/0/set";
    
	IF ISNAN(Ct)
        MQTTPUBLISH(topic, "{\"turn\": \"on\", \"transition\": " + transitionTime + ", \"gain\": " + ROUND(Hb*100.0) + "}");
    ELSE
        MQTTPUBLISH(topic, "{\"turn\": \"on\", \"transition\": " + transitionTime + ", \"brightness\": " + ROUND(Hb*100.0) + "}");
        
    END
ELSE
    MQTTPUBLISH("shellies/" + bulb2topic + "/color/0/command", "off");
END
```

Zapis nijanse

```taphome
IF !ISNAN(Ct)
    RETURN(0);
END

VAR now := NOW();
debounceTimestamp := now.Ticks + transitionTime + 3000;

VAR topic := "shellies/" + bulb2topic + "/color/0/set";
VAR rgbColor := HSVTORGB(Hd, Sa, 1);

VAR data := "{\"mode\": \"color\", \"gain\": " + ROUND(Hb*100.0) + ", \"transition\":" + transitionTime + ",\"red\":" + rgbColor.red + ",\"green\":" + rgbColor.green + ",\"blue\":" + rgbColor.blue + "}";

MQTTPUBLISH(topic, data);
```

Zapis zasićenosti

```taphome
IF !ISNAN(Ct)
    RETURN(0);
END

VAR now := NOW();
debounceTimestamp := now.Ticks + transitionTime + 3000;

VAR topic := "shellies/" + bulb2topic + "/color/0/set";
VAR rgbColor := HSVTORGB(Hd, Sa, 1);

VAR data := "{\"mode\": \"color\", \"gain\": " + ROUND(Hb*100.0) + ", \"transition\":" + transitionTime + ",\"red\":" + rgbColor.red + ",\"green\":" + rgbColor.green + ",\"blue\":" + rgbColor.blue + "}";

MQTTPUBLISH(topic, data);
```

Zapis temperature boje

```taphome
IF ISNAN(Ct)
    RETURN(0);
END

VAR now := NOW();
debounceTimestamp := now.Ticks + transitionTime + 3000;

VAR topic := "shellies/" + bulb2topic + "/color/0/set";

MQTTPUBLISH(topic, "{\"mode\": \"white\", \"brightness\": " + ROUND(Hb*100.0) + ", \"transition\": " + transitionTime + ", \"temp\":" + Ct + "}");
```

Brojilo energije 3 Brojilo električne energije Samo za čitanje

Mjerenje potrošnje energije za žarulju 3 — trenutačna snaga (kW) i ukupna energija (kWh)

numeric Jedinica: kW / kWh

Listener

```taphome
ADDINFO("To enable power monitoring, open device settings in Shelly app or web browser and configure device model in Settings->Device Model");

IF(INDEXOF(bulb2topic, "shellycolorbulb-deviceid") = 0)
    ADDERROR("Set correct 'bulb3topic' value in module variables. Topic format is 'shellycolorbulb-<deviceid>'. The Device ID can be found by opening url 'http://shellyIpAddress', in Settings -> Device info.");
    RETURN(-1);
END

IF INDEXOF(RECEIVEDMSG.TOPIC, "shellies/" + bulb3topic + "/light/0/power") = 0
    Ed := TODOUBLE(TOSTRING(RECEIVEDMSG.PAYLOAD)) / 1000.0;
ELSEIF INDEXOF(RECEIVEDMSG.TOPIC, "shellies/" + bulb3topic + "/light/0/energy") = 0
    To := TODOUBLE(TOSTRING(RECEIVEDMSG.PAYLOAD)) / 60000.0;
END
```

RGBW svjetlo 3 HSB svjetlo Čitanje i pisanje

HSB svjetlo s dva načina — pune RGB boje s pojačanjem ili podesivo bijelo svjetlo (3000–6500 K) sa svjetlinom

json JSON (ison, mode, red, green, blue, white, gain, temp, brightness, effect)

Listener

```taphome
IF(INDEXOF(bulb3topic, "shellycolorbulb-deviceid") = 0)
    ADDERROR("Set correct 'bulb3topic' value in module variables. Topic format is 'shellycolorbulb-<deviceid>'. The Device ID can be found by opening url 'http://shellyIpAddress', in Settings -> Device info.");
    RETURN(-1);
END

VAR now := NOW();
IF now.Ticks < debounceTimestamp
    RETURN(0);
END

IF INDEXOF(RECEIVEDMSG.TOPIC, "shellies/" + bulb3topic + "/color/0/status") != 0
    RETURN(0);
END

IF RECEIVEDMSG.PAYLOAD.LENGTH = 0
    RETURN(0);
END

BOOL ison := PARSEJSON(RECEIVEDMSG.PAYLOAD, "$.ison", 1);
VAR mode := PARSEJSON(RECEIVEDMSG.PAYLOAD, "$.mode", 1);

IF ISNULL(mode)
    RETURN(0);
END

INT bright;

IF mode = "color"
    UINT8 red := PARSEJSON(RECEIVEDMSG.PAYLOADStatus, "$.red");
    UINT8 green := PARSEJSON(RECEIVEDMSG.PAYLOADStatus, "$.green");
    UINT8 blue := PARSEJSON(RECEIVEDMSG.PAYLOADStatus, "$.blue");
    bright := PARSEJSON(RECEIVEDMSG.PAYLOADStatus, "$.gain");
    
    VAR hsvColor := RGBTOHSV(red, green, blue);
    
    Hd := ROUND(hsvColor.Hue);
    Sa := ROUND(hsvColor.Saturation * 100.0) / 100.0;
    Ct := NaN;
ELSE
    Ct := PARSEJSON(RECEIVEDMSG.PAYLOADStatus, "$.temp");
    bright := PARSEJSON(RECEIVEDMSG.PAYLOADStatus, "$.brightness");
END

IF ison
    Hb:= bright / 100.0;
    St := isOn;
ELSE
    Hb := 0;
    St := 0;
END
```

Zapis svjetline

```taphome
VAR now := NOW();
debounceTimestamp := now.Ticks + transitionTime + 3000;

IF St > 0.5
    VAR topic := "shellies/" + bulb3topic + "/color/0/set";
    
	IF ISNAN(Ct)
        MQTTPUBLISH(topic, "{\"turn\": \"on\", \"transition\": " + transitionTime + ", \"gain\": " + ROUND(Hb*100.0) + "}");
    ELSE
        MQTTPUBLISH(topic, "{\"turn\": \"on\", \"transition\": " + transitionTime + ", \"brightness\": " + ROUND(Hb*100.0) + "}");
        
    END
ELSE
    MQTTPUBLISH("shellies/" + bulb3topic + "/color/0/command", "off");
END
```

Zapis nijanse

```taphome
IF !ISNAN(Ct)
    RETURN(0);
END

VAR now := NOW();
debounceTimestamp := now.Ticks + transitionTime + 3000;

VAR topic := "shellies/" + bulb3topic + "/color/0/set";
VAR rgbColor := HSVTORGB(Hd, Sa, 1);

VAR data := "{\"mode\": \"color\", \"gain\": " + ROUND(Hb*100.0) + ", \"transition\":" + transitionTime + ",\"red\":" + rgbColor.red + ",\"green\":" + rgbColor.green + ",\"blue\":" + rgbColor.blue + "}";

MQTTPUBLISH(topic, data);
```

Zapis zasićenosti

```taphome
IF !ISNAN(Ct)
    RETURN(0);
END

VAR now := NOW();
debounceTimestamp := now.Ticks + transitionTime + 3000;

VAR topic := "shellies/" + bulb3topic + "/color/0/set";
VAR rgbColor := HSVTORGB(Hd, Sa, 1);

VAR data := "{\"mode\": \"color\", \"gain\": " + ROUND(Hb*100.0) + ", \"transition\":" + transitionTime + ",\"red\":" + rgbColor.red + ",\"green\":" + rgbColor.green + ",\"blue\":" + rgbColor.blue + "}";

MQTTPUBLISH(topic, data);
```

Zapis temperature boje

```taphome
IF ISNAN(Ct)
    RETURN(0);
END

VAR now := NOW();
debounceTimestamp := now.Ticks + transitionTime + 3000;

VAR topic := "shellies/" + bulb3topic + "/color/0/set";

MQTTPUBLISH(topic, "{\"mode\": \"white\", \"brightness\": " + ROUND(Hb*100.0) + ", \"transition\": " + transitionTime + ", \"temp\":" + Ct + "}");
```

Brojilo energije 4 Brojilo električne energije Samo za čitanje

Mjerenje potrošnje energije za žarulju 4 — trenutačna snaga (kW) i ukupna energija (kWh)

numeric Jedinica: kW / kWh

Listener

```taphome
ADDINFO("To enable power monitoring, open device settings in Shelly app or web browser and configure device model in Settings->Device Model");

IF(INDEXOF(bulb2topic, "shellycolorbulb-deviceid") = 0)
    ADDERROR("Set correct 'bulb4topic' value in module variables. Topic format is 'shellycolorbulb-<deviceid>'. The Device ID can be found by opening url 'http://shellyIpAddress', in Settings -> Device info.");
    RETURN(-1);
END

IF INDEXOF(RECEIVEDMSG.TOPIC, "shellies/" + bulb4topic + "/light/0/power") = 0
    Ed := TODOUBLE(TOSTRING(RECEIVEDMSG.PAYLOAD)) / 1000.0;
ELSEIF INDEXOF(RECEIVEDMSG.TOPIC, "shellies/" + bulb4topic + "/light/0/energy") = 0
    To := TODOUBLE(TOSTRING(RECEIVEDMSG.PAYLOAD)) / 60000.0;
END
```

RGBW svjetlo 4 HSB svjetlo Čitanje i pisanje

HSB svjetlo s dva načina — pune RGB boje s pojačanjem ili podesivo bijelo svjetlo (3000–6500 K) sa svjetlinom

json JSON (ison, mode, red, green, blue, white, gain, temp, brightness, effect)

Listener

```taphome
IF(INDEXOF(bulb4topic, "shellycolorbulb-deviceid") = 0)
    ADDERROR("Set correct 'bulb4topic' value in module variables. Topic format is 'shellycolorbulb-<deviceid>'. The Device ID can be found by opening url 'http://shellyIpAddress', in Settings -> Device info.");
    RETURN(-1);
END

VAR now := NOW();
IF now.Ticks < debounceTimestamp
    RETURN(0);
END

IF INDEXOF(RECEIVEDMSG.TOPIC, "shellies/" + bulb4topic + "/color/0/status") != 0
    RETURN(0);
END

IF RECEIVEDMSG.PAYLOAD.LENGTH = 0
    RETURN(0);
END

BOOL ison := PARSEJSON(RECEIVEDMSG.PAYLOAD, "$.ison", 1);
VAR mode := PARSEJSON(RECEIVEDMSG.PAYLOAD, "$.mode", 1);

IF ISNULL(mode)
    RETURN(0);
END

INT bright;

IF mode = "color"
    UINT8 red := PARSEJSON(RECEIVEDMSG.PAYLOAD, "$.red");
    UINT8 green := PARSEJSON(RECEIVEDMSG.PAYLOAD, "$.green");
    UINT8 blue := PARSEJSON(RECEIVEDMSG.PAYLOAD, "$.blue");
    bright := PARSEJSON(RECEIVEDMSG.PAYLOAD, "$.gain");
    
    VAR hsvColor := RGBTOHSV(red, green, blue);
    
    Hd := ROUND(hsvColor.Hue);
    Sa := ROUND(hsvColor.Saturation * 100.0) / 100.0;
    Ct := NaN;
ELSE
    Ct := PARSEJSON(RECEIVEDMSG.PAYLOAD, "$.temp");
    bright := PARSEJSON(RECEIVEDMSG.PAYLOAD, "$.brightness");
END

IF ison
    Hb:= bright / 100.0;
    St := isOn;
ELSE
    Hb := 0;
    St := 0;
END
```

Zapis svjetline

```taphome
VAR now := NOW();
debounceTimestamp := now.Ticks + transitionTime + 3000;

IF St > 0.5
    VAR topic := "shellies/" + bulb4topic + "/color/0/set";
    
	IF ISNAN(Ct)
        MQTTPUBLISH(topic, "{\"turn\": \"on\", \"transition\": " + transitionTime + ", \"gain\": " + ROUND(Hb*100.0) + "}");
    ELSE
        MQTTPUBLISH(topic, "{\"turn\": \"on\", \"transition\": " + transitionTime + ", \"brightness\": " + ROUND(Hb*100.0) + "}");
        
    END
ELSE
    MQTTPUBLISH("shellies/" + bulb4topic + "/color/0/command", "off");
END
```

Zapis nijanse

```taphome
IF !ISNAN(Ct)
    RETURN(0);
END

VAR now := NOW();
debounceTimestamp := now.Ticks + transitionTime + 3000;

VAR topic := "shellies/" + bulb4topic + "/color/0/set";
VAR rgbColor := HSVTORGB(Hd, Sa, 1);

VAR data := "{\"mode\": \"color\", \"gain\": " + ROUND(Hb*100.0) + ", \"transition\":" + transitionTime + ",\"red\":" + rgbColor.red + ",\"green\":" + rgbColor.green + ",\"blue\":" + rgbColor.blue + "}";

MQTTPUBLISH(topic, data);
```

Zapis zasićenosti

```taphome
IF !ISNAN(Ct)
    RETURN(0);
END

VAR now := NOW();
debounceTimestamp := now.Ticks + transitionTime + 3000;

VAR topic := "shellies/" + bulb4topic + "/color/0/set";
VAR rgbColor := HSVTORGB(Hd, Sa, 1);

VAR data := "{\"mode\": \"color\", \"gain\": " + ROUND(Hb*100.0) + ", \"transition\":" + transitionTime + ",\"red\":" + rgbColor.red + ",\"green\":" + rgbColor.green + ",\"blue\":" + rgbColor.blue + "}";

MQTTPUBLISH(topic, data);
```

Zapis temperature boje

```taphome
IF ISNAN(Ct)
    RETURN(0);
END

VAR now := NOW();
debounceTimestamp := now.Ticks + transitionTime + 3000;

VAR topic := "shellies/" + bulb4topic + "/color/0/set";

MQTTPUBLISH(topic, "{\"mode\": \"white\", \"brightness\": " + ROUND(Hb*100.0) + ", \"transition\": " + transitionTime + ", \"temp\":" + Ct + "}");
```

Brojilo energije 5 Brojilo električne energije Samo za čitanje

Mjerenje potrošnje energije za žarulju 5 — trenutačna snaga (kW) i ukupna energija (kWh)

numeric Jedinica: kW / kWh

Listener

```taphome
ADDINFO("To enable power monitoring, open device settings in Shelly app or web browser and configure device model in Settings->Device Model");

IF(INDEXOF(bulb2topic, "shellycolorbulb-deviceid") = 0)
    ADDERROR("Set correct 'bulb5topic' value in module variables. Topic format is 'shellycolorbulb-<deviceid>'. The Device ID can be found by opening url 'http://shellyIpAddress', in Settings -> Device info.");
    RETURN(-1);
END

IF INDEXOF(RECEIVEDMSG.TOPIC, "shellies/" + bulb5topic + "/light/0/power") = 0
    Ed := TODOUBLE(TOSTRING(RECEIVEDMSG.PAYLOAD)) / 1000.0;
ELSEIF INDEXOF(RECEIVEDMSG.TOPIC, "shellies/" + bulb5topic + "/light/0/energy") = 0
    To := TODOUBLE(TOSTRING(RECEIVEDMSG.PAYLOAD)) / 60000.0;
END
```

RGBW svjetlo 5 HSB svjetlo Čitanje i pisanje

HSB svjetlo s dva načina — pune RGB boje s pojačanjem ili podesivo bijelo svjetlo (3000–6500 K) sa svjetlinom

json JSON (ison, mode, red, green, blue, white, gain, temp, brightness, effect)

Listener

```taphome
IF(INDEXOF(bulb5topic, "shellycolorbulb-deviceid") = 0)
    ADDERROR("Set correct 'bulb5topic' value in module variables. Topic format is 'shellycolorbulb-<deviceid>'. The Device ID can be found by opening url 'http://shellyIpAddress', in Settings -> Device info.");
    RETURN(-1);
END

VAR now := NOW();
IF now.Ticks < debounceTimestamp
    RETURN(0);
END

IF INDEXOF(RECEIVEDMSG.TOPIC, "shellies/" + bulb5topic + "/color/0/status") != 0
    RETURN(0);
END

IF RECEIVEDMSG.PAYLOAD.LENGTH = 0
    RETURN(0);
END

BOOL ison := PARSEJSON(RECEIVEDMSG.PAYLOAD, "$.ison", 1);
VAR mode := PARSEJSON(RECEIVEDMSG.PAYLOAD, "$.mode", 1);

IF ISNULL(mode)
    RETURN(0);
END

INT bright;

IF mode = "color"
    UINT8 red := PARSEJSON(RECEIVEDMSG.PAYLOAD, "$.red");
    UINT8 green := PARSEJSON(RECEIVEDMSG.PAYLOAD, "$.green");
    UINT8 blue := PARSEJSON(RECEIVEDMSG.PAYLOAD, "$.blue");
    bright := PARSEJSON(RECEIVEDMSG.PAYLOAD, "$.gain");
    
    VAR hsvColor := RGBTOHSV(red, green, blue);

    Hd := ROUND(hsvColor.Hue);
    Sa := ROUND(hsvColor.Saturation * 100.0) / 100.0;
    Ct := NaN;
ELSE
    Ct := PARSEJSON(RECEIVEDMSG.PAYLOAD, "$.temp");
    bright := PARSEJSON(RECEIVEDMSG.PAYLOAD, "$.brightness");
END

IF ison
    Hb:= bright / 100.0;
    St := isOn;
ELSE
    Hb := 0;
    St := 0;
END
```

Zapis svjetline

```taphome
VAR now := NOW();
debounceTimestamp := now.Ticks + transitionTime + 3000;

IF St > 0.5
    VAR topic := "shellies/" + bulb5topic + "/color/0/set";
    
	IF ISNAN(Ct)
        MQTTPUBLISH(topic, "{\"turn\": \"on\", \"transition\": " + transitionTime + ", \"gain\": " + ROUND(Hb*100.0) + "}");
    ELSE
        MQTTPUBLISH(topic, "{\"turn\": \"on\", \"transition\": " + transitionTime + ", \"brightness\": " + ROUND(Hb*100.0) + "}");
        
    END
ELSE
    MQTTPUBLISH("shellies/" + bulb5topic + "/color/0/command", "off");
END
```

Zapis nijanse

```taphome
IF !ISNAN(Ct)
    RETURN(0);
END

VAR now := NOW();
debounceTimestamp := now.Ticks + transitionTime + 3000;

VAR topic := "shellies/" + bulb5topic + "/color/0/set";
VAR rgbColor := HSVTORGB(Hd, Sa, 1);

VAR data := "{\"mode\": \"color\", \"gain\": " + ROUND(Hb*100.0) + ", \"transition\":" + transitionTime + ",\"red\":" + rgbColor.red + ",\"green\":" + rgbColor.green + ",\"blue\":" + rgbColor.blue + "}";

MQTTPUBLISH(topic, data);
```

Zapis zasićenosti

```taphome
IF !ISNAN(Ct)
    RETURN(0);
END

VAR now := NOW();
debounceTimestamp := now.Ticks + transitionTime + 3000;

VAR topic := "shellies/" + bulb5topic + "/color/0/set";
VAR rgbColor := HSVTORGB(Hd, Sa, 1);

VAR data := "{\"mode\": \"color\", \"gain\": " + ROUND(Hb*100.0) + ", \"transition\":" + transitionTime + ",\"red\":" + rgbColor.red + ",\"green\":" + rgbColor.green + ",\"blue\":" + rgbColor.blue + "}";

MQTTPUBLISH(topic, data);
```

Zapis temperature boje

```taphome
IF ISNAN(Ct)
    RETURN(0);
END

VAR now := NOW();
debounceTimestamp := now.Ticks + transitionTime + 3000;

VAR topic := "shellies/" + bulb5topic + "/color/0/set";

MQTTPUBLISH(topic, "{\"mode\": \"white\", \"brightness\": " + ROUND(Hb*100.0) + ", \"transition\": " + transitionTime + ", \"temp\":" + Ct + "}");
```

**Povezivanje:** Packet Parser → MQTT • Naziv računala (hostname): `shellycolorbulb-{MAC}.local`

Moguća poboljšanja (4)

- Connection Status — LWT topic — true on connect, false on disconnect. Could detect offline bulbs.
- Full Status JSON — Complete /status as JSON (fw ≥1.8.0). Could parse wifi\_sta.rssi, uptime, temperature.
- Light Effects — Effect index 0–6: off, meteors, gradual change, breath, flash, on/off gradual, red/green change. Not exposed in template.
- White Channel (RGBW) — Separate white LED channel (0–255) in color mode. Template uses RGB+gain only, white channel not exposed.

## Parametri uvoza

Ove vrijednosti unosite pri uvozu XML-a.

| Pitanje u aplikaciji  | Zadano        |
|-----------------------|---------------|
| Mqtt Broker IP adresa | `192.168.0.1` |
| Mqtt Broker port      | `1883`        |
| Transition time (ms)  | `300`         |

## Izvori

- Shelly Gen1 API Reference
  
  [shelly-api-docs.shelly.cloud](https://shelly-api-docs.shelly.cloud/gen1/) 2026-03-12
- Home Assistant Shelly Integration
  
  [www.home-assistant.io](https://www.home-assistant.io/integrations/shelly/) 2026-03-12
- Shelly DUO RGBW — MQTT Color Bulb API
  
  [shelly-api-docs.shelly.cloud](https://shelly-api-docs.shelly.cloud/gen1/#shelly-color-bulb) 2026-03-30

## Povezana dokumentacija

- [MQTT Integration](https://taphome.com/hr/compatibility/mqtt-guide/)
- [Packet Parser (HTTP, TCP, UDP, FTP, MQTT)](https://taphome.com/hr/docs/integration/packet-parser/)
- [Funkcije Packet parsera](https://taphome.com/hr/docs/script/packet-parser/)
- [Funkcije za raščlambu](https://taphome.com/hr/docs/script/parsing-functions/)
- [MQTT Broker](https://taphome.com/hr/docs/integration/packet-parser/mqtt-broker/)
- [Listener skripte](https://taphome.com/hr/docs/script/listener-scripts/)

