TapHome

Shelly Dimmer 2

Packet Parser → HTTP
Přidal
Poslední aktualizace: 06. 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

Našli jste problém s touto šablonou zařízení?

Napište nám, co nefunguje, co chybí, nebo jak by se měla šablona chovat. Vaše zpětná vazba nám pomáhá udržet katalog přesný.

Ověřeno TapHome

Chcete to použít ve svém TapHome jádře?

Otevřete tuto šablonu v zákaznickém portálu a použijte ji ve svém domově, nebo navrhněte úpravu a odešlete ji zpět do katalogu.

Otevřít v portálu