TapHome
Službeni · TapHome Rasvjeta

Shelly RGBW2

Wi-Fi RGBW LED kontroler Shelly RGBW2 s dva načina rada. Upravljanje RGB trakama u boji ili četirima neovisnim bijelim kanalima preko HTTP-a iz sustava TapHome.

ShellyPacket Parser → HTTP2 uređajaRevizija 1.1 Posljednje ažuriranje: 10. studenoga 2026.
Shelly RGBW2

Uvoz u aplikaciju TapHomeHardver › Packet Parser › Dodaj iz predloška

Preuzmite predložak
Na ovoj stranici

Ovaj uređaj podržava mDNS

Umjesto IP adrese uređaju možete pristupiti na adresi:

shellyrgbw2-{MAC}.local

Zamijenite {MAC} MAC adresom svog uređaja (velika slova, bez dvotočaka).

TapHome podržava mDNS. Naziv računala (hostname) pouzdaniji je od statične IP adrese.

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

Upute za integraciju

Shelly RGBW2 je Wi-Fi kontroler RGBW LED traka s četiri PWM izlaza (12/24 V DC). Podržava dva načina rada koji se međusobno isključuju, Color i White, a svaki zahtijeva vlastiti predložak TapHome. TapHome s uređajem komunicira preko HTTP-a u lokalnoj mreži, pa veza s oblakom nije potrebna.

U načinu Color četiri izlaza upravljaju RGBW LED trakom kao jednim svjetlom u boji s nijansom, zasićenošću, svjetlinom i neobaveznim bijelim (CCT) kanalom. U načinu White četiri izlaza rade kao neovisni dimeri, a svaki upravlja zasebnom bijelom LED trakom ili zonom.

Način rada morate odabrati u web-sučelju Shelly (ili preko API-ja) prije uvoza odgovarajućeg predloška. Svaki predložak pri svakom očitavanju provjerava trenutačni način rada i prikazuje pogrešku ako je uređaj postavljen na pogrešan način.

Konfiguracija

Oba se predloška spajaju preko Wi-Fi mreže. Pri uvozu predloška u TapHome unesite IP adresu uređaja (u predlošku je unaprijed upisan primjer 192.168.0.1) i neobavezno vrijeme prijelaza u milisekundama (zadano 300).

Parametar vremena prijelaza određuje koliko brzo svjetlo postupno prelazi između razina svjetline. Primjenjuje se na sve naredbe upisa (uključivanje/isključivanje, svjetlina, promjene boje) i utječe na razdoblje zaštite od odskakivanja (debounce): predložak nakon svakog upisa zanemaruje očitane vrijednosti tijekom transitionTime + 500 ms kako bi spriječio zastarjela očitanja tijekom prijelaza.

Predložak za način Color

Svjetlo u boji

Predložak RGBW traku prikazuje kao jedno HSB svjetlo u boji s dva podnačina:

  • RGB boja: nijansa i zasićenost određuju boju trake. Predložak pretvara RGB vrijednosti iz API-ja Shelly (crvena, zelena, plava 0–255) u model HSB sustava TapHome i obrnuto. Svjetlinom se upravlja parametrom gain (0–100).
  • Bijela (CCT): kada se postavi korelirana temperatura boje, predložak prelazi na upravljanje bijelim kanalom. Raspon CCT je 3000–6500 K. Svjetlinom se upravlja parametrom white (0–100).

Stanje svjetla čita se iz odgovora /status (lights[0]), a svjetlom se upravlja preko krajnje točke /light/0. Uključivanje šalje turn=on s trenutačnim vrijednostima boje ili bijelog kanala, a isključivanje šalje turn=off. Sve naredbe upisa sadrže parametar vremena prijelaza.

Mjerenje snage (Color)

Predložak Color sadrži jedno brojilo energije koje čita iz meters[0]:

  • Trenutačna snaga: meters[0].power u vatima, pretvara se u kW
  • Ukupna potrošnja: meters[0].total u vat-minutama, pretvara se u kWh

Ako je svjetlo uključeno, a snaga je nula, predložak prikazuje upozorenje s prijedlogom da se u postavkama aplikacije Shelly postavi model uređaja.

Predložak za način White

Četiri neovisna dimera

Predložak White daje četiri neovisna kanala dimera, po jedan za svaki PWM izlaz:

KanalIzlazKrajnja točkaInterval očitavanja
Ch1R (crvena)/light/02,5 s
Ch2G (zelena)/light/12,5 s
Ch3B (plava)/light/22,5 s
Ch4W (bijela)/light/32,5 s

Svaki dimer čita lights[N].ison i lights[N].brightness (0–100, normalizirano na 0–1) iz odgovora /status. Naredbe upisa koriste /light/N?turn=on|off&brightness=VALUE. Svi kanali koriste isto vrijeme prijelaza i istu logiku zaštite od odskakivanja.

Mjerenje snage (White)

Svaki kanal ima vlastito brojilo energije koje čita iz meters[0] do meters[3]. Prvi kanal očitava se svake 2,5 sekunde, a kanali 2–4 u intervalima od 15 sekundi. Svako brojilo daje trenutačnu snagu (W u kW) i ukupnu energiju (vat-minute u kWh).

Servisna dijagnostika

Oba predloška daju 10 servisnih atributa za praćenje uređaja:

  • Mreža: IP adresa, MAC adresa (s dvotočkama), jačina Wi-Fi signala (dB)
  • Povezivost: oblak omogućen / spojeno na oblak, spojeno na MQTT
  • Podaci o uređaju: vrijeme uređaja, vrijeme rada (u obliku dana/sati/minuta), zauzeće RAM-a
  • Firmver: dostupno ažuriranje firmvera

Servisne radnje

Oba predloška imaju tri zajedničke servisne radnje:

  • Omogući oblak: omogućuje ili onemogućuje vezu sa Shelly Cloudom
  • Ponovno pokretanje: ponovno pokreće uređaj
  • Postavi način: predložak Color sadrži „Postavi način Color” (/settings?mode=color), a predložak White „Postavi način White” (/settings?mode=white). Te radnje preko API-ja mijenjaju način rada uređaja.

Dodatne mogućnosti

Shelly RGBW2 u svom API-ju daje i svjetlosne efekte (način Color, indeks efekta 0–3), stanje fizičkog ulaza, unutarnju temperaturu, oznaku pregrijavanja i postavke zaštite od prekoračenja snage. Te se mogućnosti mogu dodati u budućem ažuriranju predloška.

Rješavanje problema

Uređaj ne odgovara

  1. Provjerite je li Shelly spojen na Wi-Fi i ima li valjanu IP adresu
  2. Umjesto IP adrese pokušajte koristiti mDNS naziv hosta (shellyrgbw2-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 Shelly u istoj mreži / VLAN-u

Pogreška „Mode White/Color is not supported”

Ova pogreška znači da je uređaj postavljen na način rada koji ne odgovara uvezenom predlošku. Rješenje:

  1. Otvorite web-sučelje Shelly na http://{device-ip}
  2. Prebacite način rada tako da odgovara predlošku (Color ili White)
  3. Druga mogućnost: servisnom radnjom „Postavi način Color” ili „Postavi način White” iz drugog predloška promijenite način preko API-ja, a zatim ponovno uvezite ispravan predložak

Očitanje snage je nula

  1. Provjerite jesu li LED diode spojene na izlaze uređaja Shelly RGBW2
  2. Otvorite aplikaciju ili web-sučelje Shelly i provjerite je li model uređaja postavljen pod Settings -> Device Model
  3. Provjerite je li svjetlo uključeno: brojilo mjeri samo kada kroz izlaze teče struja
  4. Ručno pošaljite upit /status i provjerite vraća li meters[0].power vrijednost različitu od nule

Svjetlo u boji se ne mijenja

  1. Provjerite je li uređaj u načinu Color (u odgovoru /status polje mode treba biti "color")
  2. Prije promjene nijanse ili zasićenosti provjerite je li svjetlo uključeno
  3. Ako su i gain i white različiti od nule, predložak ih automatski vraća na nulu i isključuje svjetlo: tako se sprječava nedefinirano ponašanje u kojem se RGB i bijeli kanali međusobno nadmeću

Uređaji Shelly Gen1 podržavaju samo 2 istodobne HTTP veze. Ako TapHome i drugi sustav (npr. Home Assistant) istodobno očitavaju isti uređaj, komunikacija može postati nepouzdana. Ako uređaj očitava i drugi sustav, produljite intervale očitavanja u predlošku (zadano 2,5 s za svjetlosne kanale) kako biste smanjili sukobe pri istodobnom uspostavljanju veza.

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 (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

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:

1
shelly<model>-<MAC>.local

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

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

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 RGBW2 Color 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
Postavi način Color
Prilagođene varijable
transitionTime (numeric) = TransitionTimeTrajanje prijelaza svjetla u milisekundama (parametar uvoza, zadano 300 ms)

Shelly RGBW2 Color

Čitanje (modul)
VAR now := NOW();

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

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

IF response.IsSuccess
    jsonStatus := response.Content;
    
    if PARSEJSON(jsonStatus, "$.mode", 1) = "white"
    adderror("Mode White is not supported");
    end
ELSE
    jsonStatus := NULL;
END
Servisni atributi
IP Address
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
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
VAR signal := PARSEJSON(jsonStatus, "$.wifi_sta.rssi", 1);
IF (ISNULL(signal), "-", signal + "db");
Cloud enabled
VAR value := PARSEJSON(jsonStatus, "$.cloud.enabled", 1);
IF (ISNULL(value), "-", value)
Cloud connected
VAR value := PARSEJSON(jsonStatus, "$.cloud.connected", 1);
IF (ISNULL(value), "-", value)
MQTT connected
VAR value := PARSEJSON(jsonStatus, "$.mqtt.connected", 1);
IF (ISNULL(value), "-", value)
Device time
VAR value := PARSEJSON(jsonStatus, "$.time", 1);
IF (ISNULL(value), "-", value)
FW update available
VAR value := PARSEJSON(jsonStatus, "$.has_update");
IF (ISNULL(value), "-", value)
Uptime
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
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)
VAR response := SENDHTTPREQUEST("/settings/cloud?enabled=" + enable);
VAR contentJson := response.Content;
VAR wasEnabled := PARSEJSON(contentJson, "enabled");

IF(wasEnabled, "Cloud enabled", "Cloud disabled");
Reboot
VAR response := SENDHTTPREQUEST("/reboot");
VAR contentJson := response.Content;
VAR wasRebooted := PARSEJSON(contentJson, "ok");

IF(wasRebooted, "Reboot successful", "Error");
Set mode Color
VAR response := SENDHTTPREQUEST("/settings?mode=color");
IF(response.isSuccess, "Color mode is set", "Error");
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

Brojilo energije

Čitanje ukupne potrošnje
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
IF LENGTH(jsonStatus) = 0
    RETURN(NaN);
END

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

IF ISNULL(power)
    RETURN(NaN);
END

power / 1000.0
Svjetlo u boji HSB svjetlo Čitanje i pisanje

RGBW svjetlo u boji s HSB upravljanjem — nijansa, zasićenost, svjetlina i neobavezni CCT bijeli kanal (3000–6500 K)

hsb

Svjetlo u boji

Čitanje (modul)
if PARSEJSON(jsonStatus, "$.lights[0].white", 1) > 0 and PARSEJSON(jsonStatus, "$.lights[0].gain", 1)
    SENDHTTPREQUEST("light/0?gain=0&white=0");
    SENDHTTPREQUEST("light/0?turn=off");
end
Čitanje svjetline
VAR now := NOW();

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

INT value;
IF !ISNAN(Ct)
    value := PARSEJSON(jsonStatus, "$.lights[0].white", 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
IF St > 0.5
    IF !ISNAN(Ct)
    SENDHTTPREQUEST("light/0?turn=on&transition=" + transitionTime + "&gain=0&white=" + ROUND(Hb*100.0));
    ELSE
    SENDHTTPREQUEST("light/0?turn=on&transition=" + transitionTime + "&white=0&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
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
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 + "&white=0");


VAR now := NOW();
debounceTimestamp := now.Ticks + transitionTime + 500;
Čitanje zasićenosti
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
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 + "&white=0");


VAR now := NOW();
debounceTimestamp := now.Ticks + transitionTime + 500;
Čitanje temperature boje
VAR now := NOW();

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

INT value := PARSEJSON(jsonStatus, "$.lights[0].temp", 1);
IF PARSEJSON(jsonStatus, "$.lights[0].white", 1) = 0
    RETURN(NaN);
END
 
Ct
Zapis temperature boje
IF ISNAN(Ct)
    RETURN(0);
END

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

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

VAR now := NOW();
debounceTimestamp := now.Ticks + transitionTime + 500;
Povezivanje: Packet Parser → HTTP • Naziv računala (hostname): shellyrgbw2-{MAC}.local
Moguća poboljšanja (7)
  • Light effect — Color mode: effect index (0=off, 1–3=predefined effects), settable via /light/0?effect=N
  • Input State — Physical input state (0/1), available in /status response
  • WiFi RSSI (numeric) — WiFi RSSI in dBm as numeric value — template reads it as string with 'db' suffix
  • Power protection — Max power setting in Watts, available in /settings; read + write possible via /settings?max_power=N
  • OTA firmware update — Trigger OTA firmware update via /ota?update=true
  • Internal device temperature — Internal temperature in C, available in /status response (Gen1 devices)
  • Overheated — Overtemperature flag, boolean, available in /status response

Parametri uvoza

Ove vrijednosti unosite pri uvozu XML-a.

Pitanje u aplikacijiZadano
IP adresa192.168.0.1
Transition time (ms)300

Izvori

Pronašli ste problem s ovim predloškom uređaja?

Recite nam što ne radi, što nedostaje ili kako bi se predložak trebao ponašati. Vaše povratne informacije pomažu nam da katalog bude točan.

Predložak · TapHome portal Shelly RGBW2 Otvorite ovaj predložak na portalu Customer Portal kako biste ga primijenili na jedan od svojih domova ili predložili poboljšanje i poslali ga natrag u katalog. Packet Parser → HTTP Pogledaj u TapHome portalu