---
title: "Shelly Dimmer 2"
description: "Wi-Fi stmívač Shelly Dimmer 2 v TapHome přes lokální HTTP: jas s plynulým přechodem, zapnutí a vypnutí, okamžitý výkon a celková spotřeba. Bez cloudu."
url: "https://taphome.com/cs/compatibility/shelly-dimmer2/"
language: cs
lastmod: 2026-03-29
generator: hugo
ai:
  topics: ["http","lighting","wifi","dimmer","power-metering"]
  questions: ["Jak integrovat Shelly Dimmer 2 s TapHome?","Co ovládá TapHome šablona pro Shelly Dimmer 2?","Jak připojit Shelly Dimmer 2 přes HTTP k TapHome?","Jak nastavit plynulý přechod jasu na Shelly Dimmer 2?","Jaká je minimální zátěž pro Shelly Dimmer 2?","Proč Shelly Dimmer 2 bliká při nízkém jasu?"]
---

# Shelly Dimmer 2

Komunikace: Packet Parser → HTTP

- [Shelly Dimmer 2 — stránka produktu](https://kb.shelly.cloud/knowledge-base/shelly-dimmer-2)

> Adresa v síti
> 
> TapHome komunikuje se zařízením na adrese zadané při importu. Dejte zařízení stálou adresu — rezervaci IP v routeru, nebo jeho mDNS jméno, pokud ho podporuje —, jinak integrace přestane fungovat, když router adresu změní.
> 
> [Příprava sítě](https://taphome.com/cs/docs/setup/network-preparation/)

## Návod na integraci

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

> [!WARNING]
> 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

> [!WARNING]
> 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](https://www.shelly.com/en/support/shelly-app) (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**

> [!NOTE]
> 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ě

> [!TIP]
> 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í

> [!NOTE]
> 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í 3

Tato zařízení se po importu zobrazí v TapHome.

Shelly Dimmer2 Modul

Servisní atributy

|      |
|------|
| WiFi |

Servisní atributy

Wifi

```taphome
 VAR response := SENDHTTPREQUEST("/settings");
 IF response.IsSuccess
  VAR content := response.Content;
  RETURN(PARSEJSON(content, "$.wifi_sta.ssid"));
  End
```

Jas Stmívač Čtení i zápis

Ú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 |

Čtení úrovně

```taphome
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ě

```taphome
VAR response := SENDHTTPREQUEST("/light/0?brightness=" + Le*100);
IF response.IsSuccess = false
 ADDERROR(response.StatusCode);
 END
```

Servisní atributy

Transition

```taphome
 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)

```taphome
 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

Čtení celkové spotřeby

```taphome
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

```taphome
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č Čtení i zápis

boolean

Hodnoty / Stavy: ON · OFF

Čtení stavu přepínače

```taphome
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

```taphome
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 • Hostname: `shellydimmer2-{MAC}.local`

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)

## Parametry importu

Tyto hodnoty zadáte při importu XML.

| Ptá se v aplikaci | Výchozí       |
|-------------------|---------------|
| IP adresa         | `192.168.0.1` |

## Zdroje

- Shelly Gen1 API Reference
  
  [shelly-api-docs.shelly.cloud](https://shelly-api-docs.shelly.cloud/gen1/) 2026-03-12
- Home Assistant Shelly Integration
  
  [www.home-assistant.io](https://www.home-assistant.io/integrations/shelly/) 2026-03-12
- Shelly Dimmer 2 Knowledge Base
  
  [kb.shelly.cloud](https://kb.shelly.cloud/knowledge-base/shelly-dimmer-2) 2026-03-29
- Shelly Dimmer 2 API Reference (Gen1)
  
  [shelly-api-docs.shelly.cloud](https://shelly-api-docs.shelly.cloud/gen1/#shelly-dimmer-dimmer2) 2026-03-29

## Související dokumentace

- [Integrace Packet Parser](https://taphome.com/cs/compatibility/packet-parser-guide/)
- [Packet Parser (HTTP, TCP, UDP, FTP, MQTT)](https://taphome.com/cs/docs/integration/packet-parser/)
- [Funkce Packet parser](https://taphome.com/cs/docs/script/packet-parser/)
- [Funkce pro parsování](https://taphome.com/cs/docs/script/parsing-functions/)