TapHome

Shelly Dimmer 2

Packet Parser → HTTP
Přidal
Poslední aktualizace: 03. 2026
Shelly Dimmer 2

Shelly Dimmer 2 je kompaktní Wi-Fi stmívací modul určený k instalaci za vypínač. Podporuje stmívatelné LED (10 – 200 W), žárovky/halogenky (10 – 220 W) a feromagnetické transformátory. TapHome komunikuje se zařízením přes HTTP v lokální síti — cloudové připojení není potřeba.

Šablona poskytuje ovládání jasu s nastavitelným plynulým přechodem, spínač světla a měřič energie, který čte okamžitý výkon a celkovou spotřebu.

Konfigurace

Shelly Dimmer 2 se připojuje přes Wi-Fi. Během importu šablony do TapHome zadejte IP adresu zařízení (výchozí zástupný symbol 192.168.0.1).

Zařízení podporuje čtyři způsoby zapojení:

  • S nulovým vodičem — standardní instalace s použitím svorek N, L, SW1, SW2, O
  • Bez nulového vodiče, minimální zátěž 10 W — bez připojení nulového vodiče, vyžaduje alespoň 10 W zátěž
  • Bez nulového vodiče + Shelly Bypass — pro zátěže pod 10 W je nutný modul Shelly Bypass
  • Spínaný nulový vodič — alternativní zapojení se spínanou nulovou linkou

Pod minimální zátěží (10 W s nulovým vodičem, 20 W bez něj) může stmívač blikat nebo se nemusí zapnout. Pro zátěže s nízkým výkonem bez nulového vodiče použijte modul Shelly Bypass.

Možnosti zařízení

Ovládání jasu

Šablona poskytuje stmívač, který čte úroveň jasu z /light/0 (pole brightness, 0 – 100 %) a nastavuje ho přes /light/0?brightness={hodnota}. Hodnota se interně normalizuje — API používá 0 – 100 %, zatímco TapHome pracuje s rozsahem 0,0 – 1,0.

Servisní atribut Transition zobrazuje aktuální dobu přechodu v milisekundách. Servisní akce Transition umožňuje nastavit plynulý přechod jasu (0 – 5000 ms) pro jednotlivé příkazy přes /light/0?transition={ms}.

Spínač světla

Stav zapnutí/vypnutí světla se ovládá nezávisle na úrovni jasu. Šablona čte ison z /light/0 a zapisuje přes /light/0?turn=on nebo /light/0?turn=off. Zařízení má příznak schopnosti lighting — v TapHome se zobrazuje jako spínač světla, nikoli jako generické relé.

Měření spotřeby

Vestavěný měřič energie čte dvě hodnoty z odpovědi /status:

  • Okamžitý výkon — meters[0].power ve wattech, šablona konvertuje na kW
  • Celková spotřeba — meters[0].total ve watt-minutách, šablona konvertuje na kWh

Měřič je pouze ke čtení a aktualizuje se automaticky při každém cyklu dotazování (15sekundový interval).

Servisní diagnostika

Servisní atribut WiFi na úrovni modulu čte připojené SSID z /settings.

Další možnosti

Shelly Dimmer 2 také poskytuje vnitřní teplotu, stav ochrany proti přehřátí, validitu měření, sílu signálu WiFi a dva fyzické vstupy přepínačů (SW1, SW2) v odpovědi /status. Noční režim s plánovaným omezením jasu a postupné stmívání po krocích jsou dostupné přes API. Pro jednotlivé příkazy je možné nastavit časovač automatického vypnutí. Tyto schopnosti mohou být přidány v budoucí aktualizaci šablony.

Řešení problémů

Zařízení neodpovídá
  1. Ověřte, že Shelly je připojený k Wi-Fi a má platnou IP adresu
  2. Zkuste použít mDNS hostname (shellydimmer2-AABBCCDDEE.local) místo IP adresy — IP se mohla změnit po obnovení DHCP
  3. Otevřete http://{ip-zarizeni}/shelly v prohlížeči — pokud odpoví, zařízení je dostupné
  4. Zkontrolujte, že TapHome CCU a Shelly jsou na stejné síti / VLAN
Blikání nebo nestabilní stmívání
  1. Potvrďte, že připojená zátěž splňuje požadavek na minimální výkon (10 W s nulovým vodičem, 20 W bez něj)
  2. Zkontrolujte, zda je typ zátěže podporovaný — ne všechny LED drivery jsou kompatibilní se stmívači s ořezáváním zadní hrany
  3. Upravte nastavení min_brightness přes /settings/light/0, pokud světlo bliká při nízkých úrovních
  4. Zvyšte čas warm_up (0 – 1000 ms) v /settings/light/0 pro zátěže, které vyžadují dobu náběhu
Měření spotřeby ukazuje nulu
  1. Potvrďte, že zátěž je připojena přes stmívač (není obcházena)
  2. Zkontrolujte, že světlo je zapnuto — měřič měří pouze při průtoku proudu
  3. Manuálně odešlete požadavek na /status a ověřte, že meters[0].power vrací nenulovou hodnotu

Gen1 Shelly zařízení podporují pouze 2 souběžná HTTP připojení. Pokud TapHome a jiný systém (např. Home Assistant) dotazují stejné zařízení současně, komunikace může být nespolehlivá. Použijte interval dotazování 10 – 30 sekund.

Jak nainstalovat v TapHome

Předpoklady

  • Zařízení Shelly nainstalované a zapnuté
  • Lokální Wi-Fi síť (2,4 GHz)
  • TapHome CCU ve stejné síti

Krok 1 — Připojte Shelly k Wi-Fi

Možnost A — Aplikace Shelly (doporučeno):

  1. Stáhněte si aplikaci Shelly (iOS / Android)
  2. Klepněte na + → Add Device a postupujte podle průvodce Bluetooth párováním
  3. Po výzvě zadejte své Wi-Fi přihlašovací údaje

Možnost B — AP režim (bez aplikace):

  1. Při prvním zapnutí zařízení vytvoří hotspot: ShellyXXX-AABBCCDDEE
  2. Připojte telefon/PC k tomuto hotspotu
  3. Otevřete http://192.168.33.1 → Internet & Security → Wi-Fi Mode - Client
  4. Zadejte SSID a heslo → Save

Shelly podporuje pouze 2,4 GHz sítě. 5 GHz sítě se při skenování nezobrazí.

Krok 2 — Zjistěte IP adresu

Po připojení k Wi-Fi zjistěte přiřazenou IP adresu jedním z následujících způsobů:

  • Aplikace Shelly: Detail zařízení → Device info → IP adresa
  • Webové rozhraní Shelly: Připojte se k AP zařízení před nastavením Wi-Fi — IP se zobrazí po uložení
  • DHCP tabulka routeru: Hledejte hostname jako shelly1pm-AABBCCDDEE
  • mDNS: Pingněte shelly<model>-<mac>.local (např. shelly1pm-AABBCCDDEE.local) ze stejné sítě

Přiřaďte zařízení Shelly statickou IP (DHCP rezervaci) ve vašem routeru, aby se adresa nezměnila po restartu routeru.

Krok 3 — Konfigurace v TapHome

  1. V TapHome přidejte nový modul Packet Parser (HTTP)
  2. IP Address: zadejte IP z kroku 2 (např. 192.168.1.50)
  3. Port: 80 (výchozí, není potřeba měnit)
  4. Importujte šablonu — TapHome bude pravidelně číst /status pro zjištění stavu zařízení

HTTP autentifikace je na zařízeních Shelly standardně vypnutá. Pokud jste povolili ochranu přihlášením, TapHome momentálně nepodporuje HTTP Basic Auth — pro integraci s TapHome ponechte autentifikaci vypnutou.

Dostupná zařízení

Shelly Dimmer2 Modul
Servisní atributy
WiFi

Shelly Dimmer2

Servisní atributy
Wifi
 VAR response := SENDHTTPREQUEST("/settings");
 IF response.IsSuccess
  VAR content := response.Content;
  RETURN(PARSEJSON(content, "$.wifi_sta.ssid"));
  End
Jas Stmívač

Úroveň stmívání 0 – 100 % s nastavitelným plynulým přechodem (0 – 5000 ms)

numeric Jednotka: %
Servisní atributy
Přechod
Servisní akce
Přechod

Jas

Čtení úrovně
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 úrovně
VAR response := SENDHTTPREQUEST("/light/0?brightness=" + Le*100);
IF response.IsSuccess = false
 ADDERROR(response.StatusCode);
 END
Servisní atributy
Transition
 VAR response := SENDHTTPREQUEST("/light/0");
 IF response.IsSuccess
  VAR content := response.Content;
  RETURN(PARSEJSON(content, "transition") + " ms");
 END
Servisní akce
Transition
Parametry: Transition time [ms] (0–5000 G)
 VAR response := SENDHTTPREQUEST("/light/0?transition=" + G);
Elektroměr Elektroměr Pouze ke čtení

Měření spotřeby energie — okamžitý výkon (kW) a celková spotřeba (kWh)

numeric Jednotka: W / kWh

Elektroměr

Čtení celkové spotřeby
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
Čtení odběru
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
Světlo Přepínač
boolean
Hodnoty / Stavy: ON · OFF

Světlo

Čtení stavu přepínače
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 přepínače
var Ru := Switch(St, 1, "on", "off");
 VAR response := SENDHTTPREQUEST("/light/0?turn=" + Ru);
 IF response.IsSuccess = false
  ADDERROR(response.StatusCode);
 END
Připojení: Packet Parser → HTTP
Možná vylepšení (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