---
title: "Shelly DUO RGBW"
description: "Potpuno upravljanje RGB bojama i CCT, postupni prijelazi i mjerenje snage za žarulju Shelly DUO RGBW GU10. HTTP i MQTT predlošci za TapHome."
url: "https://taphome.com/hr/compatibility/shelly-duo-rgbw/"
language: hr
lastmod: 2026-10-08
generator: hugo
ai:
  topics: ["http","mqtt","lighting","wifi","rgbw","color-temperature","power-metering"]
  questions: ["Kako integrirati Shelly DUO RGBW sa sustavom TapHome?","Kako preko sustava TapHome upravljati bojom i svjetlinom žarulje Shelly DUO RGBW?","Kako spojiti Shelly DUO RGBW preko HTTP-a na TapHome?","Kako preko MQTT-a spojiti više žarulja Shelly DUO RGBW na TapHome?","Zašto Shelly DUO RGBW prikazuje nultu snagu?","Kako Shelly DUO RGBW prebaciti iz načina boje u bijeli način i obratno?"]
---

# Shelly DUO RGBW

Komunikacija: Packet Parser → HTTP

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

> Adresa u mreži
> 
> TapHome komunicira s uređajem na adresi unesenoj pri uvozu. Dodijelite uređaju stalnu adresu — rezervaciju IP adrese u usmjerivaču ili njegovo mDNS ime ako ga podržava — inače integracija prestaje raditi kada usmjerivač promijeni adresu.
> 
> [Priprema mreže](https://taphome.com/hr/docs/setup/network-preparation/)

## Upute za integraciju

Shelly DUO RGBW je pametna Wi-Fi LED žarulja Gen1 u izvedbi GU10. Podržava pune RGB boje i podesivo bijelo svjetlo (CCT 3000–6500 K) s postupnim prijelazima. TapHome s uređajem komunicira preko lokalne mreže, pa veza s oblakom nije potrebna.

Dostupna su dva predloška TapHome: **HTTP predložak** za upravljanje jednom žaruljom preko REST API-ja i **MQTT predložak** koji preko zajedničkog MQTT brokera podržava do **5 žarulja**. Oba predloška daju potpuno upravljanje svjetlom i mjerenje snage.

## Konfiguracija

### HTTP predložak

HTTP predložak zahtijeva IP adresu žarulje (u predlošku je unaprijed upisan primjer `192.168.0.1`) i neobavezno vrijeme prijelaza u milisekundama (zadano 300 ms). TapHome svakih 2,5 sekunde očitava krajnju točku `/status` i čita stanje svjetla, vrijednosti boja i podatke o mjerenju energije.

Skripta za čitanje na razini modula sprema odgovor `/status` u korisničku varijablu `jsonStatus`, pa skripte pojedinih uređaja mogu raščlaniti podatke bez suvišnih HTTP poziva.

### MQTT predložak

MQTT predložak zahtijeva podatke za vezu s brokerom i jedan ili više **Device ID-eva**, po jedan za svaku žarulju. Device ID svake žarulje postavlja se u korisničkoj varijabli `bulbNtopic` (oblik: `shellycolorbulb-DEVICEID`). Device ID možete pronaći u web-sučelju Shelly pod **Settings** > **Device Info**.

Predložak podržava do 5 žarulja istodobno. Konfigurirajte samo varijable `bulbNtopic` za žarulje koje stvarno imate, a neiskorištena mjesta mogu ostati na zadanim vrijednostima.

Nakon uključivanja MQTT-a na žarulji Shelly DUO RGBW (Internet & Security > Advanced — MQTT) TapHome se pretplaćuje na `shellies/#` i poruke prema prefiksu teme usmjerava odgovarajućoj žarulji.

> [!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

Ž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, svjetlina 0–100 %). TapHome to prikazuje kao HSB svjetlo: nijansa (0–360), zasićenost (0,0–1,0) i svjetlina (0,0–1,0) pretvaraju se iz RGB-a funkcijom `RGBTOHSV`.
- **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.

Način se mijenja automatski, ovisno o svojstvu koje postavite:
- Postavljanje nijanse ili zasićenosti šalje naredbu `/light/0?mode=color` (HTTP) ili JSON poruku `color/0/set` s `"mode":"color"` (MQTT)
- Postavljanje temperature boje šalje naredbu `/light/0?mode=white` (HTTP) ili poruku s `"mode":"white"` (MQTT)

Sve naredbe upisa sadrže postavljeni parametar `transitionTime` za postupan prijelaz između stanja. Mehanizam zaštite od odskakivanja (debounce) sprječava zastarjela očitanja tijekom prijelaza: predložak nakon svakog upisa kratko vrijeme zanemaruje odgovore `/status`.

> [!NOTE]
> U MQTT predlošku razdoblje zaštite od odskakivanja nakon svakog upisa traje vrijeme prijelaza plus 3 sekunde (dulje nego u HTTP predlošku) zbog kašnjenja u isporuci MQTT poruka.

### Mjerenje snage

Oba predloška daju brojilo energije koje čita dvije vrijednosti:

- **Trenutačna snaga**: javlja se u vatima, pretvara se u kW dijeljenjem s 1000
- **Ukupna potrošnja**: javlja se u vat-minutama, pretvara se u kWh dijeljenjem sa 60 000

HTTP predložak čita `meters[0].power` i `meters[0].total` iz odgovora `/status`. MQTT predložak za svaku žarulju zasebno prati teme `shellies/{id}/light/0/power` i `shellies/{id}/light/0/energy`.

> [!TIP]
> Za mjerenje snage u aplikaciji ili web-sučelju Shelly mora biti postavljen model uređaja pod **Settings** > **Device Model**. Ako model nije postavljen, a žarulja je uključena i snaga je nula, predložak prikazuje upozorenje.

### Servisna dijagnostika (samo HTTP)

HTTP predložak daje 10 servisnih atributa za praćenje uređaja:

- **Podaci o mreži**: IP adresa, MAC adresa, jačina Wi-Fi signala (dBm)
- **Povezivost**: oblak omogućen / spojeno na oblak, spojeno na MQTT
- **Sustav**: vrijeme uređaja, dostupno ažuriranje firmvera, vrijeme rada, zauzeće RAM-a

### Servisne radnje (samo HTTP)

U HTTP predlošku dostupne su dvije servisne radnje:

- **Omogući oblak**: omogućuje ili onemogućuje vezu sa Shelly Cloudom
- **Ponovno pokretanje**: ponovno pokreće uređaj

### 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 u načinu boje i stanje MQTT veze (LWT). Te se mogućnosti mogu dodati u budućem ažuriranju predloška.

## Rješavanje problema

### Žarulja ne odgovara (HTTP)

1. Provjerite je li žarulja spojena na Wi-Fi i ima li valjanu IP adresu
2. Umjesto IP adrese pokušajte koristiti mDNS naziv hosta (`shellycolorbulb-AABBCCDDEE.local`): IP adresa se možda promijenila nakon obnove DHCP zakupa
3. U pregledniku otvorite `http://{device-ip}/shelly`: ako odgovori, uređaj je dostupan
4. Provjerite jesu li centralna jedinica TapHome (CCU) i žarulja u istoj mreži / VLAN-u

### Boje izgledaju pogrešno

1. Provjerite je li žarulja u ispravnom načinu: RGB boje rade samo u načinu boje, a ne u bijelom načinu
2. Kada boju postavljate iz sustava TapHome, 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
3. Ručno pošaljite upit `/status` i provjerite vraća li `meters[0].power` vrijednost različitu od nule

### MQTT ž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 uređaju Shelly i u postavkama 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

> [!WARNING]
> Uređaji Shelly Gen1 podržavaju samo **2 istodobne HTTP veze**. Ako TapHome i drugi sustav (npr. Home Assistant) istodobno očitavaju istu žarulju, komunikacija može postati nepouzdana. U okruženjima s više sustava razmislite o prelasku na MQTT predložak.

## Kako ga instalirati u TapHome

### Preduvjeti

- Uređaj Shelly ugrađen i uključen
- Lokalna Wi-Fi mreža (2,4 GHz)
- TapHome CCU u istoj mreži

### Korak 1 — Spojite Shelly na Wi-Fi

**Opcija A — aplikacija Shelly (preporučeno):**

1. Preuzmite [aplikaciju Shelly](https://www.shelly.com/en/support/shelly-app) (iOS / Android)
2. Dodirnite **+** → **Add Device** i slijedite čarobnjak za uparivanje preko Bluetootha
3. Kada se to zatraži, unesite podatke za prijavu na Wi-Fi

**Opcija B — način rada AP (bez aplikacije):**

1. Pri prvom uključivanju uređaj stvara pristupnu točku: `ShellyXXX-AABBCCDDEE`
2. Spojite telefon ili računalo na tu pristupnu točku
3. Otvorite `http://192.168.33.1` → **Internet & Security** → **Wi-Fi Mode - Client**
4. Unesite SSID i lozinku → **Save**

> [!NOTE]
> Shelly podržava samo mreže od **2,4 GHz**. Mreže od 5 GHz neće se prikazati pri skeniranju.

### Korak 2 — Pronađite adresu uređaja

Uređaji Shelly Gen1 podržavaju **mDNS** (Zeroconf). Uređaju možete pristupiti preko naziva hosta umjesto IP adrese:

```
shelly<model>-<MAC>.local
```

Na primjer: `shelly1pm-AABBCCDDEE.local` (MAC adresa velikim slovima u heksadecimalnom zapisu, bez dvotočaka).

> [!TIP]
> **Preporučeno: koristite IP skener TapHome.** Otvorite aplikaciju TapHome i pokrenite **IP skener** (Postavke → Mreža → Skeniranje). Skener pronalazi uređaje u vašoj mreži i prikazuje IP adresu i mDNS naziv hosta. Za pouzdaniju vezu koristite **naziv hosta** umjesto IP adrese, jer ostaje isti i kada se IP adresa uređaja promijeni nakon ponovnog pokretanja usmjerivača.

**Drugi načini** za pronalaženje IP adrese:

- **Aplikacija Shelly:** detalji uređaja → **Device info** → IP adresa
- **Web-sučelje Shelly:** spojite se na AP uređaja prije postavljanja Wi-Fi mreže — IP adresa prikazuje se nakon spremanja
- **DHCP tablica usmjerivača:** potražite naziv hosta poput `shelly1pm-AABBCCDDEE`

### Korak 3 — Konfiguracija u sustavu TapHome

1. U sustavu TapHome dodajte novi modul **Packet Parser (HTTP)**
2. **Adresa:** unesite mDNS naziv hosta (npr. `shelly1pm-AABBCCDDEE.local`) ili IP adresu iz koraka 2
3. **Port:** `80` (zadano, nije potrebno mijenjati)
4. Uvezite predložak — TapHome će čitati `/status` kako bi očitao stanje uređaja

> [!NOTE]
> HTTP autentifikacija na uređajima Shelly zadano je isključena. Ako ste uključili zaštitu prijavom, TapHome trenutačno ne podržava HTTP Basic Auth — za integraciju sa sustavom TapHome ostavite autentifikaciju isključenom.

## Dostupni uređaji 2

Ovi se uređaji pojavljuju u TapHomeu nakon uvoza.

Shelly DUO RGBW Modul

Servisni atributi

|                              |
|------------------------------|
| IP adresa                    |
| MAC adresa                   |
| Wi-Fi signal                 |
| Oblak omogućen               |
| Spojeno na oblak             |
| Spojeno na MQTT              |
| Vrijeme uređaja              |
| Dostupno ažuriranje firmvera |
| Vrijeme rada                 |
| RAM                          |

Servisne radnje

|                    |
|--------------------|
| Omogući oblak      |
| Ponovno pokretanje |

Prilagođene varijable

|                                             |                                                                              |
|---------------------------------------------|------------------------------------------------------------------------------|
| `transitionTime` (numeric) = TransitionTime | Light transition duration in milliseconds (import parameter, default 300 ms) |

Čitanje (modul)

```taphome
VAR now := NOW();

IF now.Ticks < debounceTimestamp
    RETURN(0);
END

VAR response := SENDHTTPREQUEST("/status");

IF response.IsSuccess
    jsonStatus := response.Content;
ELSE
    jsonStatus := NULL;
END
```

Servisni atributi

IP Address

```taphome
VAR response := SENDHTTPREQUEST("/status");

IF response.IsSuccess
    jsonStatus := response.Content;
ELSE
    jsonStatus := NULL;
END

VAR address := PARSEJSON(jsonStatus, "$.wifi_sta.ip", 1);
IF (ISNULL(address), "-", address)
```

MAC Address

```taphome
VAR value := PARSEJSON(jsonStatus, "$.mac", 1);
IF ISNULL(value)
    RETURN("-");
END;

STRING mac;
INT i := 0;
INT len := LENGTH(value);

WHILE i < len
    mac += GETAT(value, i);
    i += 1;
    
    IF MOD(i, 2) = 0 AND i < len
        mac += ":";
    END
LOOP

mac
```

WIFI signal

```taphome
VAR signal := PARSEJSON(jsonStatus, "$.wifi_sta.rssi", 1);
IF (ISNULL(signal), "-", signal + "db");
```

Cloud enabled

```taphome
VAR value := PARSEJSON(jsonStatus, "$.cloud.enabled", 1);
IF (ISNULL(value), "-", value)
```

Cloud connected

```taphome
VAR value := PARSEJSON(jsonStatus, "$.cloud.connected", 1);
IF (ISNULL(value), "-", value)
```

MQTT connected

```taphome
VAR value := PARSEJSON(jsonStatus, "$.mqtt.connected", 1);
IF (ISNULL(value), "-", value)
```

Device time

```taphome
VAR value := PARSEJSON(jsonStatus, "$.time", 1);
IF (ISNULL(value), "-", value)
```

FW update available

```taphome
VAR value := PARSEJSON(jsonStatus, "$.has_update");
IF (ISNULL(value), "-", value)
```

Uptime

```taphome
VAR value := PARSEJSON(jsonStatus, "$.uptime", 1);
IF ISNULL(value)
    RETURN("-");
END

VAR days := FLOOR(value/86400, 1);
value := MOD(value, 86400);
VAR hours := FLOOR(value/3600, 1);
value := MOD(value, 3600);
VAR minutes := FLOOR(value/60, 1);

days + "day(s) " + hours + "h " + minutes + "m"
```

RAM

```taphome
VAR ramFree := PARSEJSON(jsonStatus, "$.ram_free", 1);
VAR ramTotal := PARSEJSON(jsonStatus, "$.ram_total", 1);

IF ISNULL(ramFree) OR ISNULL(ramTotal)
    RETURN("-");
END

ramFree + " bytes free of " + ramTotal
```

Servisne radnje

Enable cloud

Parametri: Enable (Enable / Disable)

```taphome
VAR response := SENDHTTPREQUEST("/settings/cloud?enabled=" + enable);
VAR contentJson := response.Content;
VAR wasEnabled := PARSEJSON(contentJson, "enabled");

IF(wasEnabled, "Cloud enabled", "Cloud disabled");
```

Reboot

```taphome
VAR response := SENDHTTPREQUEST("/reboot");
VAR contentJson := response.Content;
VAR wasRebooted := PARSEJSON(contentJson, "ok");

IF(wasRebooted, "Reboot successful", "Error");
```

RGBW svjetlo HSB svjetlo Čitanje i pisanje

Pune RGB boje + podesivo bijelo svjetlo (CCT 3000–6500 K) s postupnim prijelazima i upravljanjem svjetlinom ovisno o načinu

HSB

Čitanje svjetline

```taphome
VAR now := NOW();

IF now.Ticks < debounceTimestamp
    RETURN(Hb);
END

INT value;
VAR mode := PARSEJSON(jsonStatus, "$.lights[0].mode", 1);

IF mode = "white"
    value := PARSEJSON(jsonStatus, "$.lights[0].brightness", 1);
ELSE
    value := PARSEJSON(jsonStatus, "$.lights[0].gain", 1);
END

IF ISNULL(value)
    RETURN(NaN);
END

BOOL isOn := PARSEJSON(jsonStatus, "$.lights[0].ison", 1);

IF ISNULL(isOn)
    RETURN(NaN);
END

IF(isOn, value/100.0, 0);
```

Zapis svjetline

```taphome
IF St > 0.5
    VAR mode := PARSEJSON(jsonStatus, "$.lights[0].mode", 1);
    
    IF mode = "white"
        SENDHTTPREQUEST("light/0?turn=on&transition=" + transitionTime + "&brightness=" + ROUND(Hb*100.0));
    ELSE
        SENDHTTPREQUEST("light/0?turn=on&transition=" + transitionTime + "&gain=" + ROUND(Hb*100.0));
    END
ELSE
    SENDHTTPREQUEST("light/0?turn=off&transition=" + transitionTime);
END

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

Čitanje nijanse

```taphome
VAR now := NOW();

IF now.Ticks < debounceTimestamp
    RETURN(Hd);
END

INT r := PARSEJSON(jsonStatus, "$.lights[0].red", 1);
INT g := PARSEJSON(jsonStatus, "$.lights[0].green", 1);
INT b := PARSEJSON(jsonStatus, "$.lights[0].blue", 1);
 
VAR HSVColor := RGBTOHSV(r, g, b);
ROUND(HSVColor.Hue);
```

Zapis nijanse

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

VAR color := HSVTORGB(Hd, Sa, 1);

SENDHTTPREQUEST("light/0?mode=color&transition=" + transitionTime + "&gain=" + ROUND(Hb*100) + "&red=" + color.RED + "&green=" + color.GREEN + "&blue=" + color.BLUE);


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

Čitanje zasićenosti

```taphome
VAR now := NOW();

IF now.Ticks < debounceTimestamp
    RETURN(Sa);
END

INT r := PARSEJSON(jsonStatus, "$.lights[0].red", 1);
INT g := PARSEJSON(jsonStatus, "$.lights[0].green", 1);
INT b := PARSEJSON(jsonStatus, "$.lights[0].blue", 1);
 
VAR HSVColor := RGBTOHSV(r, g, b);
ROUND(HSVColor.Saturation * 100.0) / 100.0;
```

Zapis zasićenosti

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

VAR color := HSVTORGB(Hd, Sa, 1);

SENDHTTPREQUEST("light/0?mode=color&transition=" + transitionTime + "&gain=" + ROUND(Hb*100) + "&red=" + color.RED + "&green=" + color.GREEN + "&blue=" + color.BLUE);


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

Čitanje temperature boje

```taphome
VAR now := NOW();

IF now.Ticks < debounceTimestamp
    RETURN(Ct);
END

INT value := PARSEJSON(jsonStatus, "$.lights[0].temp", 1);
STRING mode := PARSEJSON(jsonStatus, "$.lights[0].mode", 1);

IF ISNULL(value) OR mode != "white"
    RETURN(NaN);
END
 
value
```

Zapis temperature boje

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

VAR temp := MIN(Ct, 6500);
temp := MAX(temp, 3000);

SENDHTTPREQUEST("light/0?mode=white&transition=" + transitionTime + "&brightness=" + ROUND(Hb*100) + "&temp=" + temp);

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

Brojilo energije Brojilo električne energije Samo za čitanje

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

numeric Jedinica: W / kWh

Čitanje ukupne potrošnje

```taphome
IF LENGTH(jsonStatus) = 0
    RETURN(NaN);
END

VAR power := PARSEJSON(jsonStatus, "$.meters[0].power");
VAR total := PARSEJSON(jsonStatus, "$.meters[0].total");
BOOL isOn := PARSEJSON(jsonStatus, "$.lights[0].ison");

IF ISNULL(power) OR ISNULL(total) OR (ison AND power=0)
	ADDWARNING("To enable power monitoring, open device settings in Shelly app or web browser and configure device model in Settings->Device Model");
	
    RETURN(NaN);
END

total / 60000.0
```

Čitanje zahtjeva

```taphome
IF LENGTH(jsonStatus) = 0
    RETURN(NaN);
END

VAR power := PARSEJSON(jsonStatus, "$.meters[0].power", 1);

IF ISNULL(power)
    RETURN(NaN);
END

power / 1000.0
```

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

Moguća poboljšanja (4)

- Light Effect — Effect index (0=Off, 1=Meteor Shower, 2=Gradual Change, 3=Breath, 4=Flash, 5=On/Off Gradual, 6=Red/Green Change). Available in both /light/0 and MQTT color/0/set.
- WiFi Signal Strength — WiFi RSSI in dBm, available in /status response (HTTP only; MQTT template reads it as service attribute already)
- White Channel — Dedicated white LED channel (0–255) in color mode, separate from CCT. Available in /light/0?white=N.
- Connection Status (MQTT) — LWT topic — true on connect, false on disconnect. Could detect offline bulbs.

## Parametri uvoza

Ove vrijednosti unosite pri uvozu XML-a.

| Pitanje u aplikaciji | Zadano        |
|----------------------|---------------|
| IP adresa            | `192.168.0.1` |
| 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 — Device-Specific API
  
  [shelly-api-docs.shelly.cloud](https://shelly-api-docs.shelly.cloud/gen1/#shelly-bulb-rgbw) 2026-03-30
- Shelly DUO RGBW — Knowledge Base
  
  [kb.shelly.cloud](https://kb.shelly.cloud/knowledge-base/shelly-bulb-duo-rgbw) 2026-03-30

## Povezana dokumentacija

- [Packet Parser Integration](https://taphome.com/hr/compatibility/packet-parser-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/)

