---
title: "Shelly RGBW2 White"
description: "Shelly RGBW2 v režimu White: čtyři nezávislé bílé LED stmívací kanály s měřením spotřeby pro každý kanál. Lokální HTTP integrace s TapHome."
url: "https://taphome.com/cs/compatibility/shelly-rgbw2-white/"
language: cs
lastmod: 2026-04-24
generator: hugo
ai:
  topics: ["http","lighting","wifi","dimmer","led-controller","shelly","gen1"]
  questions: ["Jak integrovat Shelly RGBW2 v režimu White s TapHome?","Jak přepnout Shelly RGBW2 z režimu Color do režimu White?","Mohu ovládat čtyři samostatné bílé LED pásky jedním Shelly RGBW2?","Proč Shelly RGBW2 White zobrazuje chybu „Mode is not supported\"?","Jaký je maximální výkon na kanál u Shelly RGBW2?","Je Shelly RGBW2 stále dostupný, nebo byl vyřazen z výroby?"]
---

# Shelly RGBW2 White

Komunikace: Packet Parser → HTTP

- [Produktová stránka Shelly RGBW2](https://www.shelly.com/en/products/shop/shelly-rgbw2)
- [Dokumentace API Shelly RGBW2 (režim White)](https://shelly-api-docs.shelly.cloud/gen1/#shelly-rgbw2-white-mode)
- [Shelly RGBW2 Knowledge Base](https://kb.shelly.cloud/knowledge-base/shelly-rgbw2)

> 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 RGBW2 je Wi-Fi ovladač LED pásku se čtyřmi PWM výstupy (12/24 V DC). V **režimu White** se čtyři výstupy — běžně používané pro R, G, B a W kanál RGBW pásku — mění na čtyři nezávislé jednobarevné stmívací kanály. Každý kanál dokáže napájet svůj vlastní bílý LED pásek, LED žárovku nebo skupinu bodových svítidel. TapHome komunikuje se zařízením přes HTTP v lokální síti; připojení do cloudu není potřeba.

Tato šablona je White-mode protějšek šablony [Shelly RGBW2](https://taphome.com/cs/compatibility/shelly-rgbw2/) pro Color mode. Obě šablony sdílejí stejný hardware, ale firmware pracuje ve vzájemně se vylučujících režimech nastavených v nastavení zařízení. Před importem této šablony musí být zařízení nakonfigurováno v režimu White — šablona při každém dotazování kontroluje režim a zobrazí chybu, pokud je zařízení nastaveno na Color.

> [!NOTE]
> Shelly označil RGBW2 jako **vyřazený** — Shelly Group jej již nevyrábí ani neprodává. Existující kusy dále fungují a dostávají aktualizace firmwaru.

## Zapojení

Shelly RGBW2 je napájen ze zdroje 12 V nebo 24 V DC (V+ / GND). Každý ze čtyř výstupů (označených R, G, B, W na zařízení) napájí jednu bílou LED zátěž. Typické varianty zapojení pro režim White:

- **Čtyři nezávislé bílé LED pásky nebo žárovky** — každý kanál ovládá jeden pásek/žárovku, společná anoda (+) na V+
- **Více bodových svítidel na kanál** — několik 12/24 V bodovek zapojených paralelně na jeden výstup
- **Dva bílé pásky s dvojnásobným výkonem** — dva kanály spárované paralelně na jeden pásek pro zdvojnásobení výstupního výkonu

Limity zátěže na kanál (podle specifikace Shelly) jsou **45 W při 12 V** a **90 W při 24 V**. Celková zátěž všech čtyř kanálů nesmí překročit 144 W při 12 V nebo 288 W při 24 V.

## Konfigurace

Šablona se připojuje přes Wi-Fi. Během importu šablony v TapHome zadejte IP adresu zařízení (výchozí placeholder `192.168.0.1`) a volitelný transition time v milisekundách (výchozí `300`).

Transition time určuje, jak rychle každý kanál přechází mezi úrovněmi jasu. Odesílá se s každým zápisem a zároveň definuje debounce okno — šablona ignoruje dotazované hodnoty jasu po dobu `transitionTime + 500 ms` po každém zápisu, aby se zabránilo zastaralým odečtům během přechodu.

## Přepnutí režimu

Pokud je zařízení aktuálně v režimu Color, přepněte jej do režimu White před importem této šablony. Buď:

- Otevřete webové rozhraní Shelly na `http://{device-ip}` a změňte provozní režim v nastavení, nebo
- Pošlete přímo `GET /settings?mode=white`, nebo
- Importujte dočasně Color-mode šablonu a použijte její akci **Set mode White**, poté znovu importujte tuto White-mode šablonu

Změna režimu vyžaduje restart zařízení. Po restartu zařízení znovu importujte White-mode šablonu v TapHome.

## Schopnosti zařízení

### Čtyři nezávislé stmívače

Šablona vystavuje čtyři nezávislé stmívací kanály, jeden na každý PWM výstup:

| Kanál | Výstupní pin | Endpoint     | Interval dotazování |
|-------|--------------|--------------|---------------------|
| Ch1   | R            | `/light/0`   | 2,5 s               |
| Ch2   | G            | `/light/1`   | 2,5 s               |
| Ch3   | B            | `/light/2`   | 2,5 s               |
| Ch4   | W            | `/light/3`   | 2,5 s               |

Každý stmívač čte `lights[N].ison` a `lights[N].brightness` (0 – 100, normalizované na 0 – 1) z odpovědi `/status`. Zápis používá `/light/N?turn=on|off&brightness=VALUE&transition=T`. Šablona používá starší endpoint `/light/{idx}`, který firmware Shelly akceptuje jako alias aktuálního endpointu `/white/{idx}`.

### Měření spotřeby pro každý kanál

Každý kanál má vlastní elektroměr — **Electric Meter Ch1** až **Electric Meter Ch4** — který čte z `meters[0]` až `meters[3]`:

- **Okamžitý výkon** — `meters[N].power` ve wattech, konvertovaný na kW
- **Celková spotřeba** — `meters[N].total` ve watt-minutách, konvertovaná na kWh

Kanál 1 se dotazuje každých 2,5 s společně se svým stmívačem; kanály 2 – 4 se dotazují v intervalech 15 s, aby se snížila zátěž HTTP stacku Gen1 (který snese pouze dvě souběžná spojení).

### Servisní diagnostika

Šablona vystavuje 10 servisních atributů pro monitorování zařízení:

- **Síť** — IP adresa, MAC adresa (formátovaná s dvojtečkami), síla Wi-Fi signálu (dB)
- **Konektivita** — cloud povolen/připojen, MQTT připojen
- **Informace o zařízení** — čas zařízení, doba provozu (formátovaná jako dny/hodiny/minuty), využití paměti RAM
- **Firmware** — dostupná aktualizace firmwaru

### Servisní akce

K dispozici jsou tři servisní akce:

- **Povolit cloud** — povolí nebo zakáže připojení k Shelly Cloudu
- **Restart** — spustí restart zařízení
- **Nastavit režim White** — zapisuje `/settings?mode=white` pro vynucení provozního režimu White (užitečné po tovární reset nebo pokud někdo změnil režim přes Shelly aplikaci)

Shelly Cloud API **není** touto šablonou používáno — komunikace probíhá pouze lokálním HTTP dotazováním.

## Ř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 (`shellyrgbw2-AABBCCDDEE.local`) namísto IP adresy — IP se mohla změnit po obnovení DHCP
3. Otevřete `http://{device-ip}/shelly` v prohlížeči — pokud odpovídá, zařízení je dostupné
4. Zkontrolujte, že TapHome CCU a Shelly jsou ve stejné síti / VLAN

### Chyba „Mode White is not supported"

Tato chyba znamená, že zařízení je aktuálně nastaveno na režim Color. Řešení:

1. Otevřete webové rozhraní Shelly na `http://{device-ip}` a přepněte provozní režim na White, nebo
2. Pošlete přímo `GET /settings?mode=white` z prohlížeče nebo curl, nebo
3. Pokud máte importovanou Color-mode šablonu, spusťte z ní servisní akci **Nastavit režim White**
4. Zařízení se musí po změně režimu restartovat — počkejte několik sekund a obnovte TapHome

### Odečty výkonu zobrazují nulu

1. Ověřte, že bílé LED jsou připojeny k příslušnému výstupu Shelly RGBW2 (pin R, G, B nebo W)
2. Otevřete Shelly aplikaci nebo webové rozhraní a ověřte, že model zařízení je nakonfigurován v Settings -> Device Model — bez toho elektroměr vrací nulu
3. Zkontrolujte, že kanál je zapnutý — elektroměr čte pouze při protékání proudu výstupem
4. Dotazujte `/status` manuálně a ověřte, že `meters[N].power` vrací nenulovou hodnotu pro daný kanál

### Kanál se nestmívá plynule

1. Zkontrolujte, že parametr transition time odpovídá očekávanému chování — výchozích 300 ms je krátký přechod; delší hodnoty (např. 1500 ms) produkují pomalejší přechody
2. Pamatujte, že debounce okno se rovná `transitionTime + 500 ms` — změny odeslané rychleji mohou být sloučeny
3. Ověřte, že LED zátěž je stmívatelná (některé drivery nejsou kompatibilní s PWM) a že zdroj poskytuje stabilních 12/24 V DC

> [!WARNING]
> Gen1 Shelly zařízení podporují pouze **2 souběžná HTTP spojení**. Pokud TapHome a jiný systém (např. Home Assistant) dotazují stejné zařízení současně, komunikace může být nespolehlivá. Udržujte interval dotazování na 10 – 30 sekundách pro každého dalšího klienta.

## 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í 8

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

Shelly RGBW2 White Modul

Servisní atributy

|                         |                                                                                                    |
|-------------------------|----------------------------------------------------------------------------------------------------|
| IP adresa               | Aktuální IP adresa přiřazená zařízení (čte /status -&gt; wifi\_sta.ip)                             |
| MAC adresa              | MAC adresa zařízení formátovaná s dvojtečkami (čte /status -&gt; mac)                              |
| WiFi signál             | Síla Wi-Fi signálu v dB (čte /status -&gt; wifi\_sta.rssi)                                         |
| Cloud povolen           | Zda je Shelly Cloud povolen na zařízení (čte /status -&gt; cloud.enabled)                          |
| Cloud připojen          | Zda je zařízení aktuálně připojeno k Shelly Cloudu (čte /status -&gt; cloud.connected)             |
| MQTT připojen           | Zda je zařízení aktuálně připojeno k MQTT brokeru (čte /status -&gt; mqtt.connected)               |
| Čas zařízení            | Aktuální čas reportovaný zařízením (čte /status -&gt; time)                                        |
| Dostupná aktualizace FW | True, pokud je dostupná aktualizace firmwaru pro zařízení (čte /status -&gt; has\_update)          |
| Doba provozu            | Čas uplynulý od posledního restartu, formátovaný jako dny/hodiny/minuty (čte /status -&gt; uptime) |
| RAM                     | Celková a volná paměť RAM v bajtech (čte /status -&gt; ram\_total, ram\_free)                      |

Servisní akce

|                      |                                                                                                                                         |
|----------------------|-----------------------------------------------------------------------------------------------------------------------------------------|
| Povolit cloud        | Povolit nebo zakázat připojení k Shelly Cloudu (zapisuje /settings/cloud?enabled=...)                                                   |
| Restart              | Okamžitě restartovat zařízení (zapisuje /reboot)                                                                                        |
| Nastavit režim White | Přepnout zařízení do provozního režimu White; před aktivací nového režimu je vyžadován restart zařízení (zapisuje /settings?mode=white) |

Vlastní proměnné

|                                             |                                                                                                                                                                                                    |
|---------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `transitionTime` (numeric) = TransitionTime | Doba přechodu světla v milisekundách (importní parametr, výchozí 300 ms). Zároveň definuje debounce okno (transitionTime + 500 ms), během kterého se po každém zápisu ignorují dotazované hodnoty. |

Čtení (modul)

```taphome
VAR now := NOW();

IF now.Ticks < debounceTimestamp
    RETURN(0);
END

VAR response := SENDHTTPREQUEST("/status");

IF response.IsSuccess
    jsonStatus := response.Content;
    
    if PARSEJSON(jsonStatus, "$.mode", 1) = "color"
    adderror("Mode Color is not supported");
    end
ELSE
    jsonStatus := NULL;
END
```

Servisní atributy

IP Address

```taphome
VAR response := SENDHTTPREQUEST("/status");

IF response.IsSuccess
    jsonStatus := response.Content;
ELSE
    jsonStatus := NULL;
END

VAR address := PARSEJSON(jsonStatus, "$.wifi_sta.ip", 1);
IF (ISNULL(address), "-", address)
```

MAC Address

```taphome
VAR value := PARSEJSON(jsonStatus, "$.mac", 1);
IF ISNULL(value)
    RETURN("-");
END;

STRING mac;
INT i := 0;
INT len := LENGTH(value);

WHILE i < len
    mac += GETAT(value, i);
    i += 1;
    
    IF MOD(i, 2) = 0 AND i < len
        mac += ":";
    END
LOOP

mac
```

WIFI signal

```taphome
VAR signal := PARSEJSON(jsonStatus, "$.wifi_sta.rssi", 1);
IF (ISNULL(signal), "-", signal + "db");
```

Cloud enabled

```taphome
VAR value := PARSEJSON(jsonStatus, "$.cloud.enabled", 1);
IF (ISNULL(value), "-", value)
```

Cloud connected

```taphome
VAR value := PARSEJSON(jsonStatus, "$.cloud.connected", 1);
IF (ISNULL(value), "-", value)
```

MQTT connected

```taphome
VAR value := PARSEJSON(jsonStatus, "$.mqtt.connected", 1);
IF (ISNULL(value), "-", value)
```

Device time

```taphome
VAR value := PARSEJSON(jsonStatus, "$.time", 1);
IF (ISNULL(value), "-", value)
```

FW update available

```taphome
VAR value := PARSEJSON(jsonStatus, "$.has_update");
IF (ISNULL(value), "-", value)
```

Uptime

```taphome
VAR value := PARSEJSON(jsonStatus, "$.uptime", 1);
IF ISNULL(value)
    RETURN("-");
END

VAR days := FLOOR(value/86400, 1);
value := MOD(value, 86400);
VAR hours := FLOOR(value/3600, 1);
value := MOD(value, 3600);
VAR minutes := FLOOR(value/60, 1);

days + "day(s) " + hours + "h " + minutes + "m"
```

RAM

```taphome
VAR ramFree := PARSEJSON(jsonStatus, "$.ram_free", 1);
VAR ramTotal := PARSEJSON(jsonStatus, "$.ram_total", 1);

IF ISNULL(ramFree) OR ISNULL(ramTotal)
    RETURN("-");
END

ramFree + " bytes free of " + ramTotal
```

Servisní akce

Enable cloud

Parametry: Enable (Enable / Disable)

```taphome
VAR response := SENDHTTPREQUEST("/settings/cloud?enabled=" + enable);
VAR contentJson := response.Content;
VAR wasEnabled := PARSEJSON(contentJson, "enabled");

IF(wasEnabled, "Cloud enabled", "Cloud disabled");
```

Reboot

```taphome
VAR response := SENDHTTPREQUEST("/reboot");
VAR contentJson := response.Content;
VAR wasRebooted := PARSEJSON(contentJson, "ok");

IF(wasRebooted, "Reboot successful", "Error");
```

Set mode White

```taphome
VAR response := SENDHTTPREQUEST("/settings?mode=white");
IF(response.isSuccess, "White mode is set", "Error");
```

Elektroměr Ch1 Elektroměr Pouze ke čtení

Spotřeba kanálu 1 (pin R) — okamžitý výkon (kW) a celková spotřeba (kWh)

numeric Jednotka: W / kWh

Čtení celkové spotřeby

```taphome
IF LENGTH(jsonStatus) = 0
    RETURN(NaN);
END

VAR power := PARSEJSON(jsonStatus, "$.meters[0].power");
VAR total := PARSEJSON(jsonStatus, "$.meters[0].total");
BOOL isOn := PARSEJSON(jsonStatus, "$.lights[0].ison");

IF ISNULL(power) OR ISNULL(total) OR (ison AND power=0)
    ADDWARNING("To enable power monitoring, open device settings in Shelly app or web browser and configure device model in Settings->Device Model");
    
    RETURN(NaN);
END

total / 60000.0
```

Čtení odběru

```taphome
IF LENGTH(jsonStatus) = 0
    RETURN(NaN);
END

VAR power := PARSEJSON(jsonStatus, "$.meters[0].power", 1);

IF ISNULL(power)
    RETURN(NaN);
END

power / 1000.0
```

Stmívač Ch1 (R) Stmívač Čtení i zápis

Bílý stmívač kanálu 1 (výstup R pin) — jas 0-100 % přes endpoint /light/0

numeric Jednotka: 0–1

Čtení úrovně

```taphome
IF LENGTH(jsonStatus) = 0
    RETURN(NaN);
END

VAR now := NOW();
var tmp := now.Ticks - debounceTimestamp;
if now.Ticks > debounceTimestamp
    BOOL isOn := PARSEJSON(jsonStatus, "$.lights[0].ison");
    var brightness := PARSEJSON(jsonStatus, "$.lights[0].brightness");

    if isOn
        return(brightness / 100);
    else
        return(0);
    end
else
    return(le);
end
```

Zápis úrovně

```taphome
IF St > 0.5
    SENDHTTPREQUEST("light/0?turn=on&transition=" + transitionTime + "&brightness=" + ROUND(Le*100.0));
ELSE
    SENDHTTPREQUEST("light/0?turn=off&transition=" + transitionTime);
END

VAR now := NOW();
debounceTimestamp := now.Ticks + transitionTime + 500;
```

Elektroměr Ch2 Elektroměr Pouze ke čtení

Spotřeba kanálu 2 (pin G) — okamžitý výkon (kW) a celková spotřeba (kWh)

numeric Jednotka: W / kWh

Čtení celkové spotřeby

```taphome
IF LENGTH(jsonStatus) = 0
    RETURN(NaN);
END

VAR power := PARSEJSON(jsonStatus, "$.meters[1].power");
VAR total := PARSEJSON(jsonStatus, "$.meters[1].total");
BOOL isOn := PARSEJSON(jsonStatus, "$.lights[1].ison");

IF ISNULL(power) OR ISNULL(total) OR (ison AND power=0)
    ADDWARNING("To enable power monitoring, open device settings in Shelly app or web browser and configure device model in Settings->Device Model");
    
    RETURN(NaN);
END

total / 60000.0
```

Čtení odběru

```taphome
IF LENGTH(jsonStatus) = 0
    RETURN(NaN);
END

VAR power := PARSEJSON(jsonStatus, "$.meters[1].power", 1);

IF ISNULL(power)
    RETURN(NaN);
END

power / 1000.0
```

Stmívač Ch2 (G) Stmívač Čtení i zápis

Bílý stmívač kanálu 2 (výstup G pin) — jas 0-100 % přes endpoint /light/1

numeric Jednotka: 0–1

Čtení úrovně

```taphome
IF LENGTH(jsonStatus) = 0
    RETURN(NaN);
END

VAR now := NOW();
var tmp := now.Ticks - debounceTimestamp;
if now.Ticks > debounceTimestamp
    BOOL isOn := PARSEJSON(jsonStatus, "$.lights[1].ison");
    var brightness := PARSEJSON(jsonStatus, "$.lights[1].brightness");

    if isOn
        return(brightness / 100);
    else
        return(0);
    end
else
    return(le);
end
```

Zápis úrovně

```taphome
IF St > 0.5
    SENDHTTPREQUEST("light/1?turn=on&transition=" + transitionTime + "&brightness=" + ROUND(Le*100.0));
ELSE
    SENDHTTPREQUEST("light/1?turn=off&transition=" + transitionTime);
END

VAR now := NOW();
debounceTimestamp := now.Ticks + transitionTime + 500;
```

Elektroměr Ch3 Elektroměr Pouze ke čtení

Spotřeba kanálu 3 (pin B) — okamžitý výkon (kW) a celková spotřeba (kWh)

numeric Jednotka: W / kWh

Čtení celkové spotřeby

```taphome
IF LENGTH(jsonStatus) = 0
    RETURN(NaN);
END

VAR power := PARSEJSON(jsonStatus, "$.meters[2].power");
VAR total := PARSEJSON(jsonStatus, "$.meters[2].total");
BOOL isOn := PARSEJSON(jsonStatus, "$.lights[2].ison");

IF ISNULL(power) OR ISNULL(total) OR (ison AND power=0)
    ADDWARNING("To enable power monitoring, open device settings in Shelly app or web browser and configure device model in Settings->Device Model");
    
    RETURN(NaN);
END

total / 60000.0
```

Čtení odběru

```taphome
IF LENGTH(jsonStatus) = 0
    RETURN(NaN);
END

VAR power := PARSEJSON(jsonStatus, "$.meters[2].power", 1);

IF ISNULL(power)
    RETURN(NaN);
END

power / 1000.0
```

Stmívač Ch3 (B) Stmívač Čtení i zápis

Bílý stmívač kanálu 3 (výstup B pin) — jas 0-100 % přes endpoint /light/2

numeric Jednotka: 0–1

Čtení úrovně

```taphome
IF LENGTH(jsonStatus) = 0
    RETURN(NaN);
END

VAR now := NOW();
var tmp := now.Ticks - debounceTimestamp;
if now.Ticks > debounceTimestamp
    BOOL isOn := PARSEJSON(jsonStatus, "$.lights[2].ison");
    var brightness := PARSEJSON(jsonStatus, "$.lights[2].brightness");

    if isOn
        return(brightness / 100);
    else
        return(0);
    end
else
    return(le);
end
```

Zápis úrovně

```taphome
IF St > 0.5
    SENDHTTPREQUEST("light/2?turn=on&transition=" + transitionTime + "&brightness=" + ROUND(Le*100.0));
ELSE
    SENDHTTPREQUEST("light/2?turn=off&transition=" + transitionTime);
END

VAR now := NOW();
debounceTimestamp := now.Ticks + transitionTime + 500;
```

Elektroměr Ch4 Elektroměr Pouze ke čtení

Spotřeba kanálu 4 (pin W) — okamžitý výkon (kW) a celková spotřeba (kWh)

numeric Jednotka: W / kWh

Čtení celkové spotřeby

```taphome
IF LENGTH(jsonStatus) = 0
    RETURN(NaN);
END

VAR power := PARSEJSON(jsonStatus, "$.meters[3].power");
VAR total := PARSEJSON(jsonStatus, "$.meters[3].total");
BOOL isOn := PARSEJSON(jsonStatus, "$.lights[3].ison");

IF ISNULL(power) OR ISNULL(total) OR (ison AND power=0)
    ADDWARNING("To enable power monitoring, open device settings in Shelly app or web browser and configure device model in Settings->Device Model");
    
    RETURN(NaN);
END

total / 60000.0
```

Čtení odběru

```taphome
IF LENGTH(jsonStatus) = 0
    RETURN(NaN);
END

VAR power := PARSEJSON(jsonStatus, "$.meters[3].power", 1);

IF ISNULL(power)
    RETURN(NaN);
END

power / 1000.0
```

Stmívač Ch4 (W) Stmívač Čtení i zápis

Bílý stmívač kanálu 4 (výstup W pin) — jas 0-100 % přes endpoint /light/3

numeric Jednotka: 0–1

Čtení úrovně

```taphome
IF LENGTH(jsonStatus) = 0
    RETURN(NaN);
END

VAR now := NOW();
var tmp := now.Ticks - debounceTimestamp;
if now.Ticks > debounceTimestamp
    BOOL isOn := PARSEJSON(jsonStatus, "$.lights[3].ison");
    var brightness := PARSEJSON(jsonStatus, "$.lights[3].brightness");

    if isOn
        return(brightness / 100);
    else
        return(0);
    end
else
    return(le);
end
```

Zápis úrovně

```taphome
IF St > 0.5
    SENDHTTPREQUEST("light/3?turn=on&transition=" + transitionTime + "&brightness=" + ROUND(Le*100.0));
ELSE
    SENDHTTPREQUEST("light/3?turn=off&transition=" + transitionTime);
END

VAR now := NOW();
debounceTimestamp := now.Ticks + transitionTime + 500;
```

**Připojení:** Packet Parser → HTTP • Hostname: `shellyrgbw2-{MAC}.local`

Možná vylepšení (10)

- Auto-off timer per channel — Each /white/{idx} (or legacy /light/{idx}) accepts a timer=N parameter for auto-off countdown; timer\_remaining is readable from /status
- Per-channel default state & auto-on/auto-off — Per-channel settings (default\_state off/on/last, auto\_on, auto\_off, name) — not exposed as service action
- Night mode (per channel) — Time-window auto-dim (enabled, start\_time, end\_time, brightness) per white channel — fw v1.12.0+
- Input State — Physical button/switch input state (0/1), available in /status response
- WiFi RSSI (numeric) — WiFi RSSI in dBm as numeric value — template reads it only as a formatted string with 'db' suffix
- Power protection — Max power setting in Watts, available in /settings; read + write possible via /settings?max\_power=N
- OTA firmware update — Trigger OTA firmware update via /ota?update=true
- Internal device temperature — Internal temperature in °C, available in /status response (Gen1 devices)
- Overheated — Overtemperature flag, boolean, available in /status response
- Set mode Color — Switch back to Color mode — template only exposes Set mode White; inverse action omitted (by design, this template is White-only)

## Parametry importu

Tyto hodnoty zadáte při importu XML.

| Ptá se v aplikaci    | Výchozí       |
|----------------------|---------------|
| IP adresa            | `192.168.0.1` |
| Transition time (ms) | `300`         |

## 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 RGBW2 API — Color & White Mode Endpoints
  
  [shelly-api-docs.shelly.cloud](https://shelly-api-docs.shelly.cloud/gen1/#shelly-rgbw2-white-mode) 2026-03-30
- Shelly RGBW2 Knowledge Base
  
  [kb.shelly.cloud](https://kb.shelly.cloud/knowledge-base/shelly-rgbw2) 2026-03-30

## 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/)