TapHome

Shelly Dimmer 2

Packet Parser → HTTP
Beküldő
Utoljára frissítve: 03. 2026
Shelly Dimmer 2

A Shelly Dimmer 2 egy kompakt Wi-Fi fényerőszabályzó modul, amelyet kapcsoló mögé történő beépítésre terveztek. Támogatja a dimmelhető LED-eket (10 – 200 W), izzókat/halogéneket (10 – 220 W) és ferromágneses transzformátorokat. A TapHome HTTP-n keresztül kommunikál az eszközzel a helyi hálózaton — felhőkapcsolat nem szükséges.

A sablon fényerő-szabályozást biztosít beállítható fokozatos átmenettel, egy világításkapcsolót és egy energiamérőt, amely az azonnali teljesítményt és az összesített fogyasztást olvassa ki.

Konfiguráció

A Shelly Dimmer 2 Wi-Fi-n keresztül csatlakozik. A TapHome sablonimportálás során add meg az eszköz IP-címét (alapértelmezett helyőrző 192.168.0.1).

Az eszköz négy bekötési módot támogat:

  • Nullavezetékkel — szabványos telepítés N, L, SW1, SW2, O kapcsokkal
  • Nullavezeték nélkül, minimum 10 W terhelés — nullavezeték csatlakoztatása nélkül, legalább 10 W terhelés szükséges
  • Nullavezeték nélkül + Shelly Bypass — 10 W alatti terhelésekhez a Shelly Bypass modul szükséges
  • Kapcsolt nullavezeték — alternatív bekötés kapcsolt nullavezetékkel

A minimális terhelés alatt (10 W nullavezetékkel, 20 W anélkül) a fényerőszabályzó villoghat vagy nem kapcsol be. Alacsony teljesítményű terhelésekhez nullavezeték nélkül használd a Shelly Bypass modult.

Eszközfunkciók

Fényerő-szabályozás

A sablon egy fényerőszabályzó eszközt biztosít, amely a fényerőszintet a /light/0 végpontról olvassa (a brightness mező, 0 – 100 %) és a /light/0?brightness={érték} címen állítja be. Az értéket a rendszer belsőleg normalizálja — az API 0 – 100 %-ot használ, míg a TapHome 0,0 – 1,0 tartományban dolgozik.

A Transition szervizattribútum az aktuális átmeneti időt mutatja ezredmásodpercben. A Transition szervizakció lehetővé teszi fokozatos fényerő-átmenet beállítását (0 – 5000 ms) az egyes parancsokhoz a /light/0?transition={ms} címen.

Világításkapcsoló

A világítás be-/kikapcsolt állapota a fényerőszinttől függetlenül vezérelhető. A sablon az ison mezőt olvassa a /light/0 végpontról, és a /light/0?turn=on vagy /light/0?turn=off címen ír. Az eszköz rendelkezik a lighting képesség jelzővel — a TapHome-ban világításkapcsolóként jelenik meg, nem általános reléként.

Teljesítménymérés

A beépített energiamérő két értéket olvas a /status válaszból:

  • Azonnali teljesítmény — meters[0].power wattban, a sablon kW-ra konvertálja
  • Összesített fogyasztás — meters[0].total watt-percben, a sablon kWh-ra konvertálja

A mérő csak olvasható, és minden lekérdezési ciklusban automatikusan frissül (15 másodperces intervallum).

Szervizdiagnosztika

A modul szintű WiFi szervizattribútum a csatlakoztatott SSID-t olvassa a /settings végpontról.

További funkciók

A Shelly Dimmer 2 a /status válaszban a belső hőmérsékletet, a túlmelegedés-védelem állapotát, a mérés érvényességét, a WiFi jelerősséget és két fizikai kapcsolóbemenetet (SW1, SW2) is biztosít. Az API-n keresztül elérhető éjszakai mód ütemezett fényerő-korlátozással és lépésenkénti fényerőszabályozás. Az egyes parancsokhoz automatikus kikapcsolási időzítő állítható be. Ezek a funkciók egy jövőbeli sablonfrissítésben adhatók hozzá.

Hibaelhárítás

Az eszköz nem válaszol
  1. Ellenőrizd, hogy a Shelly csatlakozik a Wi-Fi-hez és érvényes IP-címmel rendelkezik
  2. Próbáld meg az mDNS hosztnevet (shellydimmer2-AABBCCDDEE.local) az IP-cím helyett — az IP megváltozhatott a DHCP megújítás után
  3. Nyisd meg a http://{eszkoz-ip}/shelly címet a böngészőben — ha válaszol, az eszköz elérhető
  4. Ellenőrizd, hogy a TapHome CCU és a Shelly ugyanazon a hálózaton / VLAN-on vannak
Villogás vagy instabil fényerőszabályozás
  1. Győződj meg arról, hogy a csatlakoztatott terhelés megfelel a minimális teljesítménykövetelménynek (10 W nullavezetékkel, 20 W anélkül)
  2. Ellenőrizd, hogy a terhelés típusa támogatott-e — nem minden LED-meghajtó kompatibilis a hátsó élvágásos fényerőszabályzókkal
  3. Módosítsd a min_brightness beállítást a /settings/light/0 címen, ha a fény alacsony szinteken villog
  4. Növeld a warm_up időt (0 – 1000 ms) a /settings/light/0 címen az indulási időt igénylő terhelésekhez
A teljesítménymérés nullát mutat
  1. Győződj meg arról, hogy a terhelés a fényerőszabályzón keresztül csatlakozik (nem megkerülve)
  2. Ellenőrizd, hogy a fény be van kapcsolva — a mérő csak áramáramlás esetén mér
  3. Kérdezd le manuálisan a /status végpontot és ellenőrizd, hogy a meters[0].power nem nulla értéket ad vissza

A Gen1 Shelly eszközök csak 2 egyidejű HTTP-kapcsolatot támogatnak. Ha a TapHome és egy másik rendszer (pl. Home Assistant) egyidejűleg kérdezi le ugyanazt az eszközt, a kommunikáció megbízhatatlanná válhat. Használj 10 – 30 másodperces lekérdezési intervallumot.

Telepítés a TapHome-ban

Előfeltételek

  • Shelly eszköz telepítve és bekapcsolva
  • Helyi Wi-Fi hálózat (2,4 GHz)
  • TapHome CCU ugyanazon a hálózaton

1. lépés — Shelly csatlakoztatása a Wi-Fi-hez

A lehetőség — Shelly alkalmazás (ajánlott):

  1. Töltse le a Shelly alkalmazást (iOS / Android)
  2. Érintse meg a + → Add Device gombot, és kövesse a Bluetooth párosítási varázslót
  3. Adja meg Wi-Fi hitelesítő adatait, amikor a rendszer kéri

B lehetőség — AP mód (alkalmazás nélkül):

  1. Első bekapcsoláskor az eszköz létrehoz egy hotspotot: ShellyXXX-AABBCCDDEE
  2. Csatlakoztassa telefonját/PC-jét ehhez a hotspothoz
  3. Nyissa meg a http://192.168.33.1 címet → Internet & Security → Wi-Fi Mode - Client
  4. Adja meg az SSID-t és a jelszót → Save

A Shelly csak 2,4 GHz-es hálózatokat támogat. Az 5 GHz-es hálózatok nem jelennek meg a keresésben.

2. lépés — IP-cím megkeresése

A Wi-Fi-hez való csatlakozás után az alábbi módszerek egyikével keresse meg a hozzárendelt IP-címet:

  • Shelly alkalmazás: Eszköz részletei → Device info → IP-cím
  • Shelly webes felület: Csatlakozzon az eszköz AP-jához a Wi-Fi beállítás előtt — az IP a mentés után jelenik meg
  • Router DHCP tábla: Keressen egy hasonló hosztnevet: shelly1pm-AABBCCDDEE
  • mDNS: Pingelje a shelly<model>-<mac>.local címet (pl. shelly1pm-AABBCCDDEE.local) ugyanarról a hálózatról

Rendeljen statikus IP-t (DHCP foglalást) a Shelly eszközhöz a routerben, hogy a cím ne változzon a router újraindítása után.

3. lépés — Konfigurálás a TapHome-ban

  1. A TapHome-ban adjon hozzá egy új Packet Parser (HTTP) modult
  2. IP Address: adja meg a 2. lépésben kapott IP-t (pl. 192.168.1.50)
  3. Port: 80 (alapértelmezett, nem kell módosítani)
  4. Importálja a sablont — a TapHome rendszeresen lekérdezi a /status végpontot az eszköz állapotának olvasásához

A HTTP hitelesítés a Shelly eszközökön alapértelmezetten ki van kapcsolva. Ha engedélyezte a bejelentkezésvédelmet, a TapHome jelenleg nem támogatja a HTTP Basic Auth-ot — a TapHome integrációhoz hagyja kikapcsolva a hitelesítést.

Elérhető eszközök

Shelly Dimmer2 Modul
Szerviz attribútumok
WiFi

Shelly Dimmer2

Szerviz attribútumok
Wifi
 VAR response := SENDHTTPREQUEST("/settings");
 IF response.IsSuccess
  VAR content := response.Content;
  RETURN(PARSEJSON(content, "$.wifi_sta.ssid"));
  End
Fényerő Fényerőszabályzó

Fényerőszint 0 – 100 % állítható fokozatos átmenettel (0 – 5000 ms)

numeric Egység: %
Szerviz attribútumok
Átmenet
Szerviz műveletek
Átmenet

Fényerő

Szint olvasása
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
Szint írása
VAR response := SENDHTTPREQUEST("/light/0?brightness=" + Le*100);
IF response.IsSuccess = false
 ADDERROR(response.StatusCode);
 END
Szerviz attribútumok
Transition
 VAR response := SENDHTTPREQUEST("/light/0");
 IF response.IsSuccess
  VAR content := response.Content;
  RETURN(PARSEJSON(content, "transition") + " ms");
 END
Szerviz műveletek
Transition
Paraméterek: Transition time [ms] (0–5000 G)
 VAR response := SENDHTTPREQUEST("/light/0?transition=" + G);
Villamos mérő Villanyóra Csak olvasható

Energiafogyasztás mérés — pillanatnyi teljesítmény (kW) és összesített energia (kWh)

numeric Egység: W / kWh

Villamos mérő

Összes fogyasztás olvasása
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
Igény olvasása
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
Világítás Kapcsoló
boolean
Értékek / Állapotok: ON · OFF

Világítás

Kapcsoló állapot olvasása
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
Kapcsoló állapot írása
var Ru := Switch(St, 1, "on", "off");
 VAR response := SENDHTTPREQUEST("/light/0?turn=" + Ru);
 IF response.IsSuccess = false
  ADDERROR(response.StatusCode);
 END
Kapcsolat: Packet Parser → HTTP
Lehetséges fejlesztések (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)

Források