TapHome

Shelly Dimmer 2

Packet Parser → HTTP
Autor
Posljednje ažuriranje: 03. 2026

Ovaj uređaj podržava mDNS

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

shellydimmer2-{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.

Shelly Dimmer 2

Shelly Dimmer 2 kompaktni je Wi-Fi modul dimera za ugradnju iza zidnog prekidača. Podržava prigušive LED žarulje (10–200 W), žarulje sa žarnom niti i halogene žarulje (10–220 W) te feromagnetske transformatore. TapHome s uređajem komunicira preko HTTP-a u lokalnoj mreži, pa veza s oblakom nije potrebna.

Predložak omogućuje upravljanje svjetlinom s podesivim postupnim prijelazom, daje sklopku svjetla za uključivanje i isključivanje te brojilo energije koje očitava trenutačnu snagu i ukupnu potrošenu energiju.

Konfiguracija

Shelly Dimmer 2 spaja se 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).

Uređaj podržava četiri načina spajanja:

  • S neutralnim vodičem: standardna ugradnja sa stezaljkama N, L, SW1, SW2 i O
  • Bez neutralnog vodiča, najmanje opterećenje 10 W: bez spajanja neutralnog vodiča, potrebno je opterećenje od najmanje 10 W
  • Bez neutralnog vodiča + Shelly Bypass: za opterećenja manja od 10 W potreban je dodatak Shelly Bypass
  • Prekidani neutralni vodič: alternativno spajanje s prekidanim neutralnim vodičem

Ispod najmanjeg opterećenja (10 W s neutralnim vodičem, 20 W bez neutralnog vodiča) dimer može treperiti ili se ne uključiti. Za trošila male snage bez neutralnog vodiča koristite dodatak Shelly Bypass.

Mogućnosti uređaja

Upravljanje svjetlinom

Predložak daje uređaj dimera koji čita razinu svjetline iz /light/0 (polje brightness, 0–100 %) i postavlja je preko /light/0?brightness={value}. Vrijednost se interno normalizira: API koristi 0–100 %, a TapHome radi s rasponom 0,0–1,0.

Servisni atribut Prijelaz prikazuje trenutačno trajanje postupnog prijelaza u milisekundama. Servisna radnja Prijelaz omogućuje postavljanje postupnog prijelaza svjetline (0–5000 ms) za pojedine naredbe preko /light/0?transition={ms}.

Sklopka svjetla

Uključivanjem i isključivanjem svjetla upravlja se neovisno o razini svjetline. Predložak čita ison iz /light/0 i upisuje preko /light/0?turn=on ili /light/0?turn=off. Uređaj ima oznaku mogućnosti lighting, pa se u sustavu TapHome prikazuje kao sklopka svjetla, a ne kao obični relej.

Mjerenje snage

Ugrađeno brojilo energije čita dvije vrijednosti iz odgovora /status:

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

Brojilo je samo za čitanje i automatski se osvježava pri svakom ciklusu očitavanja (interval od 15 sekundi).

Servisna dijagnostika

Servisni atribut Wi-Fi na razini modula čita SSID povezane mreže iz /settings.

Dodatne mogućnosti

Shelly Dimmer 2 u odgovoru /status daje i unutarnju temperaturu, stanje zaštite od pregrijavanja, valjanost brojila, jačinu Wi-Fi signala i dva fizička ulaza za prekidače (SW1, SW2). Preko API-ja dostupni su noćni način s vremenski raspoređenim ograničenjem svjetline i postupno prigušivanje u koracima. Timer za automatsko isključivanje može se postaviti za svaku naredbu. 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 (shellydimmer2-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
Treperenje ili nestabilno prigušivanje
  1. Provjerite zadovoljava li spojeno trošilo zahtjev za najmanju snagu (10 W s neutralnim vodičem, 20 W bez njega)
  2. Provjerite je li vrsta trošila podržana: nisu svi LED upravljački sklopovi kompatibilni s dimerima s rezom na silaznom bridu (trailing edge)
  3. Ako svjetlo treperi pri niskim razinama, prilagodite postavku min_brightness preko /settings/light/0
  4. Za trošila kojima je potrebno postupno uključivanje povećajte vrijeme warm_up (0–1000 ms) u /settings/light/0
Očitanje snage je nula
  1. Provjerite je li trošilo spojeno preko dimera (a ne premošteno)
  2. Provjerite je li svjetlo uključeno: brojilo mjeri samo kada teče struja
  3. Ručno pošaljite upit /status i provjerite vraća li meters[0].power vrijednost različitu od nule

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. Koristite interval očitavanja od 10–30 sekundi.

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

Shelly Dimmer2 Modul
Servisni atributi
Wi-Fi

Shelly Dimmer2

Servisni atributi
Wifi
 VAR response := SENDHTTPREQUEST("/settings");
 IF response.IsSuccess
  VAR content := response.Content;
  RETURN(PARSEJSON(content, "$.wifi_sta.ssid"));
  End
Svjetlina Dimer

Razina svjetline 0–100 % s podesivim postupnim prijelazom (0–5000 ms)

numeric Jedinica: %
Servisni atributi
Prijelaz
Servisne radnje
Prijelaz

Svjetlina

Čitanje razine
VAR response := SENDHTTPREQUEST("/light/0");
 IF response.IsSuccess
  VAR content := response.Content;
  RETURN(PARSEJSON(content, "brightness")/100);
 ELSE
  ADDERROR(response.StatusCode + " (" + response.ReasonPhrase + ")");
  RETURN(NaN);
 END
Zapis razine
VAR response := SENDHTTPREQUEST("/light/0?brightness=" + Le*100);
IF response.IsSuccess = false
 ADDERROR(response.StatusCode);
 END
Servisni atributi
Transition
 VAR response := SENDHTTPREQUEST("/light/0");
 IF response.IsSuccess
  VAR content := response.Content;
  RETURN(PARSEJSON(content, "transition") + " ms");
 END
Servisne radnje
Transition
Parametri: Transition time [ms] (0–5000 G)
 VAR response := SENDHTTPREQUEST("/light/0?transition=" + G);
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
VAR response := SENDHTTPREQUEST("/status");
 IF response.IsSuccess
  VAR content := response.Content;
 VAR responseHeaders := response.Headers;
 RETURN(PARSEJSON(content, "$..meters..total")/60000);
 ELSE 
 ADDERROR(response.StatusCode + " (" + response.ReasonPhrase + ")");
  RETURN(NaN);
 END
Čitanje zahtjeva
VAR response := SENDHTTPREQUEST("/status");
 IF response.IsSuccess
  VAR content := response.Content;
 VAR responseHeaders := response.Headers;
 RETURN(PARSEJSON(content, "$..meters..power")/1000);
 ELSE 
 ADDERROR(response.StatusCode + " (" + response.ReasonPhrase + ")");
  RETURN(NaN);
 END
Svjetlo Sklopka
boolean
Vrijednosti / stanja: ON · OFF

Svjetlo

Čitanje stanja sklopke
VAR response := SENDHTTPREQUEST("/light/0");
 IF response.IsSuccess
  VAR content := response.Content;
  RETURN(PARSEJSON(content, "ison"));
 ELSE
  ADDERROR(response.StatusCode + " (" + response.ReasonPhrase + ")");
  RETURN(NaN);
 END
Zapis stanja sklopke
var Ru := Switch(St, 1, "on", "off");
 VAR response := SENDHTTPREQUEST("/light/0?turn=" + Ru);
 IF response.IsSuccess = false
  ADDERROR(response.StatusCode);
 END
Povezivanje: Packet Parser → HTTP • Naziv računala (hostname): shellydimmer2-{MAC}.local
Moguća poboljšanja (9)
  • Brightness (via /status) — Current brightness also available in /status → lights[0].brightness; template uses /light/0 instead
  • Meter Validity — Measurement validity flag, available in /status response
  • Internal Temperature — Internal device temperature in °C, available in /status response
  • Overtemperature Protection — Overtemperature protection triggered flag, threshold 95°C
  • Night Mode — Night mode with start/end time and max brightness — configurable via /settings/night_mode
  • Switch Inputs (SW1, SW2) — Two physical switch inputs available in /status → inputs[0].input and inputs[1].input
  • WiFi Signal Strength — WiFi RSSI in dBm, available in /status response
  • Auto-off Timer — Auto-off timer in seconds, could be added as service action parameter
  • Incremental Dimming — Step-based dimming (dim up/down/stop with configurable step size 1-100)

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.

Provjerio TapHome

Želite ovo koristiti u svojoj centralnoj jedinici TapHome Core?

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.

Otvorite na portalu