---
title: "Shelly RGBW2"
description: "Shelly RGBW2 Wi-Fi RGBW LED ovladač se dvěma provozními režimy. Ovládejte RGB barevné pásy nebo čtyři nezávislé bílé kanály přes HTTP z TapHome."
url: "https://taphome.com/cs/compatibility/shelly-rgbw2/"
language: cs
lastmod: 2026-10-08
generator: hugo
ai:
  topics: ["http","lighting","wifi","rgbw","led-controller","dimmer"]
  questions: ["Jak integrovat Shelly RGBW2 s TapHome?","Jaký je rozdíl mezi režimem Color a White na Shelly RGBW2?","Jak ovládat RGB LED pásy přes TapHome?","Jak stmívat čtyři nezávislé bílé kanály se Shelly RGBW2 v TapHome?","Proč šablona Shelly RGBW2 zobrazuje chybu režimu v TapHome?","Jak nastavit čas přechodu pro změny světla Shelly RGBW2?"]
---

# Shelly RGBW2

Komunikace: Packet Parser → HTTP

- [Produktová stránka Shelly RGBW2](https://www.shelly.com/en/products/shop/shelly-rgbw2)
- [API dokumentace Shelly RGBW2](https://shelly-api-docs.shelly.cloud/gen1/#shelly-rgbw2-color-mode)

> 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 RGBW LED pásový ovladač se čtyřmi PWM výstupy (12/24 V DC). Podporuje dva vzájemně výlučné provozní režimy — Color a White — přičemž každý vyžaduje vlastní TapHome šablonu. TapHome komunikuje se zařízením přes HTTP v lokální síti; cloudové připojení není potřeba.

V **režimu Color** čtyři výstupy ovládají RGBW LED pás jako jedno barevné světlo s odstínem, sytostí, jasem a volitelným bílým (CCT) kanálem. V **režimu White** čtyři výstupy fungují jako nezávislé stmívače, přičemž každý ovládá samostatný bílý LED pás nebo zónu.

Provozní režim musíte zvolit ve webovém rozhraní Shelly (nebo přes API) před importem odpovídající šablony. Každá šablona validuje aktuální režim při každém dotazování a zobrazí chybu, pokud je zařízení nastaveno na nesprávný režim.

## Konfigurace

Obě šablony se připojují přes Wi-Fi. Během importu TapHome šablony zadejte IP adresu zařízení (výchozí placeholder `192.168.0.1`) a volitelný čas přechodu v milisekundách (výchozí `300`).

Parametr čas přechodu ovládá, jak rychle světlo přechází mezi úrovněmi jasu. Vztahuje se na všechny příkazy zápisu (zapnutí/vypnutí, jas, změny barev) a ovlivňuje debounce okno — šablona ignoruje dotazované hodnoty po dobu `transitionTime + 500 ms` po každém zápisu, aby zabránila zastaralým čtením během přechodů.

## Šablona režimu Color

### Barevné světlo

Šablona vystavuje RGBW pás jako jedno HSB barevné světlo se dvěma podrežimy:

- **RGB barva** — odstín a sytost ovládají barvu pásu. Šablona konvertuje mezi RGB hodnotami Shelly API (červená, zelená, modrá 0-255) a HSB modelem TapHome. Jas se ovládá parametrem `gain` (0-100).
- **Bílá (CCT)** — když se nastaví korelovaná teplota chromatičnosti, šablona přepne na ovládání bílého kanálu. Rozsah CCT je 3000-6500 K. Jas se ovládá parametrem `white` (0-100).

Stav světla se čte z odpovědi `/status` (`lights[0]`) a ovládá přes endpoint `/light/0`. Zapnutí odešle `turn=on` s aktuálními hodnotami barvy nebo bílé; vypnutí odešle `turn=off`. Všechny příkazy zápisu obsahují parametr čas přechodu.

### Měření spotřeby (Color)

Šablona Color obsahuje jeden elektroměr, který čte z `meters[0]`:

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

Pokud je světlo zapnuté, ale výkon ukazuje nulu, šablona zobrazí varování s návrhem nakonfigurovat model zařízení v nastavení aplikace Shelly.

## Šablona režimu White

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

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

| Kanál | Výstup | Endpoint | Interval dotazování |
|-------|--------|----------|---------------------|
| Ch1 | R (Red) | `/light/0` | 2,5 s |
| Ch2 | G (Green) | `/light/1` | 2,5 s |
| Ch3 | B (Blue) | `/light/2` | 2,5 s |
| Ch4 | W (White) | `/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`. Příkazy zápisu používají `/light/N?turn=on|off&brightness=VALUE`. Všechny kanály používají stejný čas přechodu a debounce logiku.

### Měření spotřeby (White)

Každý kanál má vlastní elektroměr, který čte z `meters[0]` až `meters[3]`. První kanál dotazuje každé 2,5 sekundy; kanály 2-4 dotazují v 15sekundových intervalech. Každý elektroměr poskytuje okamžitý výkon (W na kW) a kumulativní energii (watt-minuty na kWh).

## Servisní diagnostika

Obě šablony vystavují 10 servisních atributů pro monitorování zařízení:

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

## Servisní akce

Obě šablony sdílejí tři servisní akce:

- **Povolit cloud** — zapne nebo vypne připojení Shelly Cloud
- **Restart** — spustí restart zařízení
- **Nastavit režim** — šablona Color obsahuje „Set mode Color" (`/settings?mode=color`) a šablona White obsahuje „Set mode White" (`/settings?mode=white`). Tyto akce přepínají provozní režim zařízení přes API.

### Další funkce

Shelly RGBW2 také vystavuje světelné efekty (režim Color, index efektu 0-3), stav fyzického vstupu, interní teplotu, příznak přehřátí a nastavení ochrany výkonu ve svém API. Tyto funkce 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 (`shellyrgbw2-AABBCCDDEE.local`) mí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/Color is not supported"

Tato chyba znamená, že zařízení je nastaveno na nesprávný provozní režim pro importovanou šablonu. Řešení:

1. Otevřete webové rozhraní Shelly na `http://{device-ip}`
2. Přepněte provozní režim tak, aby odpovídal šabloně (Color nebo White)
3. Případně použijte servisní akci „Set mode Color" nebo „Set mode White" z druhé šablony pro přepnutí režimu přes API, poté reimportujte správnou šablonu

### Výkon ukazuje nulu

1. Potvrďte, že LED jsou připojeny k výstupům Shelly RGBW2
2. Otevřete aplikaci Shelly nebo webové rozhraní a ověřte, že model zařízení je nakonfigurován v části Settings -> Device Model
3. Zkontrolujte, že světlo je zapnuté — elektroměr měří pouze když protéká proud výstupy
4. Dotažte `/status` manuálně a ověřte, že `meters[0].power` vrací nenulovou hodnotu

### Barevné světlo se nemění

1. Ověřte, že zařízení je v režimu Color (zkontrolujte odpověď `/status` — `mode` by mělo být `"color"`)
2. Ujistěte se, že světlo je zapnuté před změnou odstínu nebo sytosti
3. Pokud jsou `gain` i `white` nenulové, šablona je automaticky vynuluje a vypne světlo — tím se zabrání nedefinovanému chování, kdy RGB a bílé kanály soutěží

> [!WARNING]
> Zařízení Shelly Gen1 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á. Pokud zařízení dotazuje i jiný systém, prodlužte intervaly dotazování v šabloně (výchozí 2,5 s pro světelné kanály), abyste snížili konkurenci připojení.

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

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

Shelly RGBW2 Color Modul

Servisní atributy

|                         |
|-------------------------|
| IP adresa               |
| MAC adresa              |
| WiFi signál             |
| Cloud povolen           |
| Cloud připojen          |
| MQTT připojen           |
| Čas zařízení            |
| Dostupná aktualizace FW |
| Doba provozu            |
| RAM                     |

Servisní akce

|                      |
|----------------------|
| Povolit cloud        |
| Restart              |
| Nastavit režim Color |

Vlastní proměnné

|                                             |                                                                          |
|---------------------------------------------|--------------------------------------------------------------------------|
| `transitionTime` (numeric) = TransitionTime | Doba přechodu světla v milisekundách (importní parametr, výchozí 300 ms) |

Č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) = "white"
    adderror("Mode White 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 Color

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

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

Barevné světlo HSB světlo Čtení i zápis

RGBW barevné světlo s HSB ovládáním — odstín, sytost, jas a volitelný CCT bílý kanál (3000–6500 K)

hsb

Čtení (modul)

```taphome
if PARSEJSON(jsonStatus, "$.lights[0].white", 1) > 0 and PARSEJSON(jsonStatus, "$.lights[0].gain", 1)
    SENDHTTPREQUEST("light/0?gain=0&white=0");
    SENDHTTPREQUEST("light/0?turn=off");
end
```

Čtení jasu

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

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

INT value;
IF !ISNAN(Ct)
    value := PARSEJSON(jsonStatus, "$.lights[0].white", 1);
ELSE
    value := PARSEJSON(jsonStatus, "$.lights[0].gain", 1);
END

IF ISNULL(value)
    RETURN(NaN);
END

BOOL isOn := PARSEJSON(jsonStatus, "$.lights[0].ison", 1);

IF ISNULL(isOn)
    RETURN(NaN);
END

IF(isOn, value/100.0, 0);
```

Zápis jasu

```taphome
IF St > 0.5
    IF !ISNAN(Ct)
    SENDHTTPREQUEST("light/0?turn=on&transition=" + transitionTime + "&gain=0&white=" + ROUND(Hb*100.0));
    ELSE
    SENDHTTPREQUEST("light/0?turn=on&transition=" + transitionTime + "&white=0&gain=" + ROUND(Hb*100.0));
    END
ELSE
    SENDHTTPREQUEST("light/0?turn=off&transition=" + transitionTime);
END

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

Čtení odstínu

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

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

INT r := PARSEJSON(jsonStatus, "$.lights[0].red", 1);
INT g := PARSEJSON(jsonStatus, "$.lights[0].green", 1);
INT b := PARSEJSON(jsonStatus, "$.lights[0].blue", 1);

VAR HSVColor := RGBTOHSV(r, g, b);
ROUND(HSVColor.Hue);
```

Zápis odstínu

```taphome
IF !ISNAN(Ct)
    RETURN(0);
END

VAR color := HSVTORGB(Hd, Sa, 1);

SENDHTTPREQUEST("light/0?mode=color&transition=" + transitionTime + "&gain=" + ROUND(Hb*100) + "&red=" + color.RED + "&green=" + color.GREEN + "&blue=" + color.BLUE + "&white=0");


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

Čtení saturace

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

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

INT r := PARSEJSON(jsonStatus, "$.lights[0].red", 1);
INT g := PARSEJSON(jsonStatus, "$.lights[0].green", 1);
INT b := PARSEJSON(jsonStatus, "$.lights[0].blue", 1);
 
VAR HSVColor := RGBTOHSV(r, g, b);
ROUND(HSVColor.Saturation * 100.0) / 100.0;
```

Zápis saturace

```taphome
IF !ISNAN(Ct)
    RETURN(0);
END

VAR color := HSVTORGB(Hd, Sa, 1);

SENDHTTPREQUEST("light/0?mode=color&transition=" + transitionTime + "&gain=" + ROUND(Hb*100) + "&red=" + color.RED + "&green=" + color.GREEN + "&blue=" + color.BLUE + "&white=0");


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

Čtení barevné teploty

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

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

INT value := PARSEJSON(jsonStatus, "$.lights[0].temp", 1);
IF PARSEJSON(jsonStatus, "$.lights[0].white", 1) = 0
    RETURN(NaN);
END
 
Ct
```

Zápis barevné teploty

```taphome
IF ISNAN(Ct)
    RETURN(0);
END

VAR temp := MIN(Ct, 6500);
temp := MAX(temp, 3000);

SENDHTTPREQUEST("light/0?transition=" + transitionTime + "&white=" + ROUND(Hb*100) + "&gain=0");

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

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

Možná vylepšení (7)

- Light effect — Color mode: effect index (0=off, 1–3=predefined effects), settable via /light/0?effect=N
- Input State — Physical input state (0/1), available in /status response
- WiFi RSSI (numeric) — WiFi RSSI in dBm as numeric value — template reads it as 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

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