TapHome

Shelly Dimmer 2

Packet Parser → HTTP
Pridal
Posledná aktualizácia: 03. 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