TapHome

Shelly Dimmer 2

Packet Parser → HTTP
Pridal
Posledná aktualizácia: 05. 2026
Shelly Dimmer 2

Shelly Dimmer 2 je kompaktný Wi-Fi stmievací modul určený na inštaláciu za vypínač. Podporuje stmievateľné LED (10 – 200 W), žiarovky/halogénky (10 – 220 W) a feromagnetické transformátory. TapHome komunikuje so zariadením cez HTTP v lokálnej sieti — cloudové pripojenie nie je potrebné.

Šablóna poskytuje ovládanie jasu s nastaviteľným plynulým prechodom, spínač svetla a merač energie, ktorý číta okamžitý výkon a celkovú spotrebu.

Konfigurácia

Shelly Dimmer 2 sa pripája cez Wi-Fi. Počas importu šablóny do TapHome zadajte IP adresu zariadenia (predvolený zástupný symbol 192.168.0.1).

Zariadenie podporuje štyri spôsoby zapojenia:

  • S nulovým vodičom — štandardná inštalácia s použitím svoriek N, L, SW1, SW2, O
  • Bez nulového vodiča, minimálna záťaž 10 W — bez pripojenia nulového vodiča, vyžaduje aspoň 10 W záťaž
  • Bez nulového vodiča + Shelly Bypass — pre záťaže pod 10 W je potrebný modul Shelly Bypass
  • Spínaný nulový vodič — alternatívne zapojenie so spínanou nulovou linkou

Pod minimálnou záťažou (10 W s nulovým vodičom, 20 W bez neho) môže stmievač blikať alebo sa nemusí zapnúť. Pre záťaže s nízkym výkonom bez nulového vodiča použite modul Shelly Bypass.

Možnosti zariadenia

Ovládanie jasu

Šablóna poskytuje stmievač, ktorý číta úroveň jasu z /light/0 (pole brightness, 0 – 100 %) a nastavuje ho cez /light/0?brightness={hodnota}. Hodnota sa interne normalizuje — API používa 0 – 100 %, zatiaľ čo TapHome pracuje s rozsahom 0,0 – 1,0.

Servisný atribút Transition zobrazuje aktuálnu dobu prechodu v milisekundách. Servisná akcia Transition umožňuje nastaviť plynulý prechod jasu (0 – 5000 ms) pre jednotlivé príkazy cez /light/0?transition={ms}.

Spínač svetla

Stav zapnutia/vypnutia svetla sa ovláda nezávisle od úrovne jasu. Šablóna číta ison z /light/0 a zapisuje cez /light/0?turn=on alebo /light/0?turn=off. Zariadenie má príznak schopnosti lighting — v TapHome sa zobrazuje ako spínač svetla, nie ako generické relé.

Meranie spotreby

Vstavaný merač energie číta dve hodnoty z odpovede /status:

  • Okamžitý výkon — meters[0].power v wattoch, šablóna konvertuje na kW
  • Celková spotreba — meters[0].total vo watt-minútach, šablóna konvertuje na kWh

Merač je len na čítanie a aktualizuje sa automaticky pri každom cykle dopytovania (15-sekundový interval).

Servisná diagnostika

Servisný atribút WiFi na úrovni modulu číta pripojené SSID z /settings.

Ďalšie možnosti

Shelly Dimmer 2 tiež poskytuje vnútornú teplotu, stav ochrany proti prehriatiu, validitu merania, silu signálu WiFi a dva fyzické vstupy prepínačov (SW1, SW2) v odpovedi /status. Nočný režim s plánovaným obmedzením jasu a postupné stmievanie po krokoch sú dostupné cez API. Pre jednotlivé príkazy je možné nastaviť časovač automatického vypnutia. Tieto schopnosti môžu byť pridané v budúcej aktualizácii šablóny.

Riešenie problémov

Zariadenie neodpovedá
  1. Overte, že Shelly je pripojený k Wi-Fi a má platnú IP adresu
  2. Skúste použiť mDNS hostname (shellydimmer2-AABBCCDDEE.local) namiesto IP adresy — IP sa mohla zmeniť po obnovení DHCP
  3. Otvorte http://{ip-zariadenia}/shelly v prehliadači — ak odpovie, zariadenie je dostupné
  4. Skontrolujte, že TapHome CCU a Shelly sú na rovnakej sieti / VLAN
Blikanie alebo nestabilné stmievanie
  1. Potvrďte, že pripojená záťaž spĺňa požiadavku na minimálny výkon (10 W s nulovým vodičom, 20 W bez neho)
  2. Skontrolujte, či je typ záťaže podporovaný — nie všetky LED drivery sú kompatibilné so stmievačmi s odrezávaním zadnej hrany
  3. Upravte nastavenie min_brightness cez /settings/light/0, ak svetlo bliká pri nízkych úrovniach
  4. Zvýšte čas warm_up (0 – 1000 ms) v /settings/light/0 pre záťaže, ktoré vyžadujú dobu nábehu
Meranie spotreby ukazuje nulu
  1. Potvrďte, že záťaž je pripojená cez stmievač (nie obídená)
  2. Skontrolujte, že svetlo je zapnuté — merač meria len pri prietoku prúdu
  3. Manuálne odošlite požiadavku na /status a overte, že meters[0].power vracia nenulovú hodnotu

Gen1 Shelly zariadenia podporujú len 2 súčasné HTTP pripojenia. Ak TapHome a iný systém (napr. Home Assistant) dopytujú rovnaké zariadenie súčasne, komunikácia môže byť nespoľahlivá. Použite interval dopytovania 10 – 30 sekúnd.

Ako nainštalovať v TapHome

Predpoklady

  • Zariadenie Shelly nainštalované a zapnuté
  • Lokálna Wi-Fi sieť (2,4 GHz)
  • TapHome CCU v rovnakej sieti

Krok 1 — Pripojte Shelly k Wi-Fi

Možnosť A — Aplikácia Shelly (odporúčané):

  1. Stiahnite si aplikáciu Shelly (iOS / Android)
  2. Klepnite na + → Add Device a postupujte podľa sprievodcu Bluetooth párovaním
  3. Po výzve zadajte svoje Wi-Fi prihlasovacie údaje

Možnosť B — AP režim (bez aplikácie):

  1. Pri prvom zapnutí zariadenie vytvorí hotspot: ShellyXXX-AABBCCDDEE
  2. Pripojte telefón/PC k tomuto hotspotu
  3. Otvorte http://192.168.33.1 → Internet & Security → Wi-Fi Mode - Client
  4. Zadajte SSID a heslo → Save

Shelly podporuje iba 2,4 GHz siete. 5 GHz siete sa pri skenovaní nezobrazia.

Krok 2 — Zistite IP adresu

Po pripojení k Wi-Fi zistite priradenú IP adresu jedným z nasledujúcich spôsobov:

  • Aplikácia Shelly: Detail zariadenia → Device info → IP adresa
  • Webové rozhranie Shelly: Pripojte sa k AP zariadenia pred nastavením Wi-Fi — IP sa zobrazí po uložení
  • DHCP tabuľka routera: Hľadajte hostname ako shelly1pm-AABBCCDDEE
  • mDNS: Pingnite shelly<model>-<mac>.local (napr. shelly1pm-AABBCCDDEE.local) z rovnakej siete

Priraďte zariadeniu Shelly statickú IP (DHCP rezerváciu) vo vašom routeri, aby sa adresa nezmenila po reštarte routera.

Krok 3 — Konfigurácia v TapHome

  1. V TapHome pridajte nový modul Packet Parser (HTTP)
  2. IP Address: zadajte IP z kroku 2 (napr. 192.168.1.50)
  3. Port: 80 (predvolený, nie je potrebné meniť)
  4. Importujte šablónu — TapHome bude pravidelne čítať /status pre zistenie stavu zariadenia

HTTP autentifikácia je na zariadeniach Shelly štandardne vypnutá. Ak ste povolili ochranu prihlásením, TapHome momentálne nepodporuje HTTP Basic Auth — pre integráciu s TapHome ponechajte autentifikáciu vypnutú.

Dostupné zariadenia

Shelly Dimmer2 Modul
Servisné atribúty
WiFi

Shelly Dimmer2

Servisné atribúty
Wifi
 VAR response := SENDHTTPREQUEST("/settings");
 IF response.IsSuccess
  VAR content := response.Content;
  RETURN(PARSEJSON(content, "$.wifi_sta.ssid"));
  End
Jas Stmievač

Úroveň stmievania 0 – 100 % s nastaviteľným plynulým prechodom (0 – 5000 ms)

numeric Jednotka: %
Servisné atribúty
Prechod
Servisné akcie
Prechod

Jas

Čítanie úrovne
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
Zápis úrovne
VAR response := SENDHTTPREQUEST("/light/0?brightness=" + Le*100);
IF response.IsSuccess = false
 ADDERROR(response.StatusCode);
 END
Servisné atribúty
Transition
 VAR response := SENDHTTPREQUEST("/light/0");
 IF response.IsSuccess
  VAR content := response.Content;
  RETURN(PARSEJSON(content, "transition") + " ms");
 END
Servisné akcie
Transition
Parametre: Transition time [ms] (0–5000 G)
 VAR response := SENDHTTPREQUEST("/light/0?transition=" + G);
Elektromer Elektromer Len na čítanie

Meranie spotreby energie — okamžitý výkon (kW) a celková spotreba (kWh)

numeric Jednotka: W / kWh

Elektromer

Čítanie celkovej spotreby
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
Čítanie odberu
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
Svetlo Prepínač
boolean
Hodnoty / Stavy: ON · OFF

Svetlo

Čítanie stavu prepínača
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
Zápis stavu prepínača
var Ru := Switch(St, 1, "on", "off");
 VAR response := SENDHTTPREQUEST("/light/0?turn=" + Ru);
 IF response.IsSuccess = false
  ADDERROR(response.StatusCode);
 END
Pripojenie: Packet Parser → HTTP
Možné vylepšenia (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)

Zdroje

Našli ste problém s touto šablónou zariadenia?

Napíšte nám, čo nefunguje, čo chýba, alebo ako by sa mala šablóna správať. Vaša spätná väzba nám pomáha udržiavať katalóg presný.

Overené TapHomom

Chcete to použiť vo svojom TapHome jadre?

Otvorte túto šablónu v Customer Portali a aplikujte ju na svoj domov, alebo navrhnite zmenu a odošlite ju späť do katalógu.

Otvoriť v portáli