---
title: "Shelly 2.5"
description: "Dvojkanálové ovládanie relé s meraním výkonu na kanál cez HTTP. TapHome šablóna pre Shelly 2.5 (Gen1, režim relé)."
url: "https://taphome.com/sk/compatibility/shelly-2-5/"
language: sk
lastmod: 2026-03-29
generator: hugo
ai:
  topics: ["http","i/o-module","wifi","relay","power-metering","dual-channel"]
  questions: ["Ako integrovať Shelly 2.5 s TapHome?","Čo meria šablóna Shelly 2.5 v TapHome?","Ako pripojiť Shelly 2.5 cez HTTP k TapHome?","Podporuje TapHome šablóna Shelly 2.5 režim rolety?","Prečo je hodnota energie kanálu 1 Shelly 2.5 príliš vysoká?","Aké servisné atribúty sú dostupné pre relé Shelly 2.5 v TapHome?"]
---

# Shelly 2.5

Komunikácia: Packet Parser → HTTP

- [Produktová stránka Shelly 2.5](https://www.shelly.com/en/products/shop/shelly-25)
- [API dokumentácia Shelly 2.5](https://shelly-api-docs.shelly.cloud/gen1/#shelly2-5)

> Adresa v sieti
> 
> TapHome komunikuje so zariadením na adrese zadanej pri importe. Dajte zariadeniu stálu adresu — rezerváciu IP v routeri, alebo jeho mDNS meno, ak ho podporuje —, inak integrácia prestane fungovať, keď router adresu zmení.
> 
> [Príprava siete](https://taphome.com/sk/docs/setup/network-preparation/)

## Návod na integráciu

Shelly 2.5 je kompaktné dvojkanálové Wi-Fi relé so vstavaným meraním výkonu na oboch kanáloch. Zmestí sa za štandardný nástenný vypínač a dokáže ovládať dva nezávislé obvody, každý dimenzovaný do 10 A (2300 W pri 230 V), s celkovým maximom 20 A. Zariadenie podporuje dva prevádzkové režimy — relé (dva nezávislé spínače) a roleta (koordinované ovládanie motora) — ale TapHome šablóna implementuje len režim relé. TapHome komunikuje so zariadením cez HTTP v lokálnej sieti — nie je potrebné cloudové pripojenie.

Šablóna poskytuje dva relé spínače a dva elektromery (jeden na kanál) plus servisnú akciu na prepínanie medzi režimom relé a rolety.

## Konfigurácia

Shelly 2.5 sa pripája cez Wi-Fi. Počas importu TapHome šablóny zadajte IP adresu zariadenia (predvolený placeholder `192.168.0.1`).

Aktuálny prevádzkový režim je sprístupnený ako servisný atribút na úrovni modulu ("Mode") a môže byť zmenený cez servisnú akciu "Mode". Prepnutie medzi režimom relé a rolety vyžaduje reštart zariadenia.

## Možnosti zariadenia

### Ovládanie relé

Šablóna sprístupňuje dva nezávislé relé kanály. Stav každého relé sa číta z príslušného endpointu `/relay/` (pole `ison`) a ovláda sa cez `turn=on` alebo `turn=off`.

- **Kanál 1** — čítanie a ovládanie `/relay/0`
- **Kanál 2** — čítanie a ovládanie `/relay/1`

Každé relé má tri servisné atribúty:

- **Overpower** — či bol na kanáli detekovaný stav nadmerného výkonu
- **Overtemperature** — či zariadenie prekročilo bezpečnú prevádzkovú teplotu
- **Power Meter** — platnosť merania (OK alebo Porucha)

### Meranie výkonu

Každý kanál má vyhradený elektromer, ktorý číta dve hodnoty z endpointu `/meter/`:

- **Výkon v reálnom čase** — `power` vo wattoch, šablónou konvertovaný na kW
- **Celková spotreba** — `total` vo watt-minútach, šablónou konvertovaný na kWh

Každý elektromer sprístupňuje servisný atribút "Overpower" zobrazujúci prahovú hodnotu nadmerného výkonu (vo wattoch, delených 1000).

Elektromery sú len na čítanie — aktualizujú sa automaticky s každým pollovacím cyklom (15-sekundový interval).

> [!WARNING]
> **Známy problém — hodnota energie kanálu 1 je 10× príliš vysoká.** Šablóna delí `total` číslom 6000 pre kanál 1 namiesto 60000 (ktoré kanál 2 používa správne). To znamená, že kumulatívna hodnota energie pre kanál 1 bude približne 10-krát vyššia ako skutočná spotreba. Ide o chybu v konverznom vzorci šablóny.

### Ďalšie možnosti

Shelly 2.5 natívne podporuje plné ovládanie roliet (otvorenie/zatvorenie/zastavenie s 0–100% pozíciou po kalibrácii), pohyblivé jednominútové priemery výkonu na kanál, stavy fyzických vstupných spínačov, vnútornú teplotu zariadenia, silu Wi-Fi signálu a časovače automatického vypnutia na kanál. Zariadenie tiež dokáže uložiť až štyri obľúbené pozície roliet. Tieto funkcie môžu byť pridané v budúcej aktualizácii šablóny.

> [!NOTE]
> V porovnaní so šablónou Shelly 1PM, šablóna Shelly 2.5 nesprístupňuje diagnostiku zariadenia ako hostname, MAC adresa, uptime, využitie RAM, stav cloud/MQTT, dostupnosť aktualizácie firmvéru ani vnútornú teplotu. Chýba tiež servisná akcia ochrany výkonu (limit maximálneho výkonu) a akcia reštartu.

## Riešenie problémov

### Zariadenie neodpovedá

1. Overte, že Shelly je pripojený k Wi-Fi a má platnú IP adresu
2. Skúste použiť mDNS hostname (`shellyswitch25-AABBCCDDEE.local`) namiesto IP adresy — IP sa mohla zmeniť po obnovení DHCP
3. Otvorte `http://{device-ip}/shelly` v prehliadači — ak odpovie, zariadenie je dostupné
4. Skontrolujte, že TapHome CCU a Shelly sú v rovnakej sieti / VLAN

### Hodnoty výkonu ukazujú nulu

1. Potvrďte, že záťaž je pripojená cez Shelly relé (nie obísková)
2. Skontrolujte, že relé je zapnuté — merač meria len keď preteká prúd cez relé
3. Manuálne pollujte `/meter/0` alebo `/meter/1` a overte, že `power` vracia nenulovú hodnotu

### Celková energia kanálu 1 sa zdá nesprávna

Šablóna delí celkovú hodnotu kanálu 1 číslom 6000 namiesto správneho 60000 (ktoré kanál 2 používa). Výsledkom je, že kumulatívna hodnota energie pre kanál 1 je 10× vyššia ako skutočná. V šablóne momentálne neexistuje riešenie — konverzný faktor je vložený v pollovacom skripte.

> [!WARNING]
> Gen1 Shelly zariadenia podporujú len **2 súbežné HTTP pripojenia**. Ak TapHome a iný systém (napr. Home Assistant) pollujú rovnaké zariadenie súčasne, komunikácia môže byť nespoľahlivá. Endpointy relé sa pollujú každých 2,5 sekundy a endpointy meračov každých 15 sekúnd.

## Ako nainštalovať v TapHome

### Predpoklady

- Zariadenie Shelly nainštalované a zapnuté
- Lokálna Wi-Fi sieť (2,4 GHz)
- TapHome CCU v rovnakej sieti

### Krok 1 — Pripojte Shelly k Wi-Fi

**Možnosť A — Aplikácia Shelly (odporúčané):**

1. Stiahnite si [aplikáciu Shelly](https://www.shelly.com/en/support/shelly-app) (iOS / Android)
2. Klepnite na **+** → **Add Device** a postupujte podľa sprievodcu Bluetooth párovaním
3. Po výzve zadajte svoje Wi-Fi prihlasovacie údaje

**Možnosť B — AP režim (bez aplikácie):**

1. Pri prvom zapnutí zariadenie vytvorí hotspot: `ShellyXXX-AABBCCDDEE`
2. Pripojte telefón/PC k tomuto hotspotu
3. Otvorte `http://192.168.33.1` → **Internet & Security** → **Wi-Fi Mode - Client**
4. Zadajte SSID a heslo → **Save**

> [!NOTE]
> Shelly podporuje iba **2,4 GHz** siete. 5 GHz siete sa pri skenovaní nezobrazia.

### Krok 2 — Zistite IP adresu

Po pripojení k Wi-Fi zistite priradenú IP adresu jedným z nasledujúcich spôsobov:

- **Aplikácia Shelly:** Detail zariadenia → **Device info** → IP adresa
- **Webové rozhranie Shelly:** Pripojte sa k AP zariadenia pred nastavením Wi-Fi — IP sa zobrazí po uložení
- **DHCP tabuľka routera:** Hľadajte hostname ako `shelly1pm-AABBCCDDEE`
- **mDNS:** Pingnite `shelly<model>-<mac>.local` (napr. `shelly1pm-AABBCCDDEE.local`) z rovnakej siete

> [!TIP]
> Priraďte zariadeniu Shelly **statickú IP** (DHCP rezerváciu) vo vašom routeri, aby sa adresa nezmenila po reštarte routera.

### Krok 3 — Konfigurácia v TapHome

1. V TapHome pridajte nový modul **Packet Parser (HTTP)**
2. **IP Address:** zadajte IP z kroku 2 (napr. `192.168.1.50`)
3. **Port:** `80` (predvolený, nie je potrebné meniť)
4. Importujte šablónu — TapHome bude pravidelne čítať `/status` pre zistenie stavu zariadenia

> [!NOTE]
> HTTP autentifikácia je na zariadeniach Shelly štandardne vypnutá. Ak ste povolili ochranu prihlásením, TapHome momentálne nepodporuje HTTP Basic Auth — pre integráciu s TapHome ponechajte autentifikáciu vypnutú.

## Dostupné zariadenia 4

Tieto zariadenia sa po importe zobrazia v TapHome.

Shelly 2.5 Modul

Servisné atribúty

|       |
|-------|
| Režim |

Servisné akcie

|       |
|-------|
| Režim |

Servisné atribúty

Mode

```taphome
 VAR response := SENDHTTPREQUEST("/settings");
 IF response.IsSuccess
  VAR content := response.Content;
  VAR responseHeaders := response.Headers;
  RETURN(PARSEJSON(content, "mode"));
 END
```

Servisné akcie

Mode

Parametre: Mode

```taphome
var St := SWITCH(mo, 1, "roller", "relay");
 VAR response := SENDHTTPREQUEST("/settings?mode=" + St);
```

Elektromer — Kanál 1 Elektromer Len na čítanie

Meranie spotreby a energie kanálu 1 — okamžitý výkon (kW) a kumulatívna energia (kWh). Poznámka: hodnota energie je 10× príliš vysoká kvôli chybe deliteľa v šablóne (/6000 namiesto /60000)

numeric Jednotka: W / kWh

Servisné atribúty

|                |
|----------------|
| Nadmerný výkon |

Čítanie celkovej spotreby

```taphome
VAR response := SENDHTTPREQUEST("/meter/0");
 IF response.IsSuccess
  VAR content := response.Content;
 VAR responseHeaders := response.Headers;
 RETURN(PARSEJSON(content, "total")/6000);
 ELSE 
 ADDERROR(response.StatusCode + " (" + response.ReasonPhrase + ")");
  RETURN(NaN);
 END
```

Čítanie odberu

```taphome
VAR response := SENDHTTPREQUEST("/meter/0");
 IF response.IsSuccess
  VAR content := response.Content;
 VAR responseHeaders := response.Headers;
 RETURN(PARSEJSON(content, "power")/1000);
 ELSE 
 ADDERROR(response.StatusCode + " (" + response.ReasonPhrase + ")");
  RETURN(NaN);
 END
```

Servisné atribúty

Overpower

```taphome
 VAR response := SENDHTTPREQUEST("/meter/0");
 IF response.IsSuccess
  VAR content := response.Content;
 RETURN((PARSEJSON(content, "overpower")/1000) + " W");
 END
```

Elektromer — Kanál 2 Elektromer Len na čítanie

Meranie spotreby a energie kanálu 2 — okamžitý výkon (kW) a kumulatívna energia (kWh)

numeric Jednotka: W / kWh

Servisné atribúty

|                |
|----------------|
| Nadmerný výkon |

Čítanie celkovej spotreby

```taphome
VAR response := SENDHTTPREQUEST("/meter/1");
 IF response.IsSuccess
  VAR content := response.Content;
 VAR responseHeaders := response.Headers;
 RETURN(PARSEJSON(content, "total")/60000);
 ELSE 
 ADDERROR(response.StatusCode + " (" + response.ReasonPhrase + ")");
  RETURN(NaN);
 END
```

Čítanie odberu

```taphome
VAR response := SENDHTTPREQUEST("/meter/1");
 IF response.IsSuccess
  VAR content := response.Content;
 VAR responseHeaders := response.Headers;
 RETURN(PARSEJSON(content, "power")/1000);
 ELSE 
 ADDERROR(response.StatusCode + " (" + response.ReasonPhrase + ")");
  RETURN(NaN);
 END
```

Servisné atribúty

Overpower

```taphome
 VAR response := SENDHTTPREQUEST("/meter/1");
 IF response.IsSuccess
  VAR content := response.Content;
 VAR responseHeaders := response.Headers;
 RETURN((PARSEJSON(content, "overpower")/1000) + " W");
 END
```

Relé — Kanál 1 Prepínač Čítanie aj zápis

boolean

Hodnoty / Stavy: ON · OFF

Čítanie stavu prepínača

```taphome
VAR response := SENDHTTPREQUEST("/relay/0");
 IF response.IsSuccess
  VAR content := response.Content;
  VAR responseHeaders := response.Headers;
  RETURN(PARSEJSON(content, "ison"));
 ELSE
  ADDERROR(response.StatusCode + " (" + response.ReasonPhrase + ")");
  RETURN(NaN);
 END
```

Zápis stavu prepínača

```taphome
var turn := Switch(St, 1, "on", "off");
 VAR response := SENDHTTPREQUEST("/relay/0?turn=" + turn);
 IF response.IsSuccess = false
  ADDERROR(response.StatusCode);
 END
```

Servisné atribúty

Overpower

```taphome
 VAR response := SENDHTTPREQUEST("/relay/0");
 IF response.IsSuccess
  VAR content := response.Content;
  RETURN(IF(PARSEJSON(content, "overpower"),"Yes", "No"));
 END
```

Overtemperature

```taphome
 VAR response := SENDHTTPREQUEST("/relay/0");
 IF response.IsSuccess
  VAR content := response.Content;
  RETURN(IF(PARSEJSON(content, "overtemperature"),"Yes", "No"));
 END
```

Power Meter

```taphome
 VAR response := SENDHTTPREQUEST("/relay/0");
 IF response.IsSuccess
  VAR content := response.Content;
  RETURN(IF(PARSEJSON(content, "is_valid"),"OK","Fault"));
 END
```

Relé — Kanál 2 Prepínač Čítanie aj zápis

boolean

Hodnoty / Stavy: ON · OFF

Čítanie stavu prepínača

```taphome
VAR response := SENDHTTPREQUEST("/relay/1");
 IF response.IsSuccess
  VAR content := response.Content;
  VAR responseHeaders := response.Headers;
  RETURN(PARSEJSON(content, "ison"));
 ELSE
  ADDERROR(response.StatusCode + " (" + response.ReasonPhrase + ")");
  RETURN(NaN);
 END
```

Zápis stavu prepínača

```taphome
var turn := Switch(St, 1, "on", "off");
 VAR response := SENDHTTPREQUEST("/relay/1?turn=" + turn);
 IF response.IsSuccess = false
  ADDERROR(response.StatusCode);
 END
```

Servisné atribúty

Overpower

```taphome
 VAR response := SENDHTTPREQUEST("/relay/1");
 IF response.IsSuccess
  VAR content := response.Content;
  RETURN(IF(PARSEJSON(content, "overpower"),"Yes", "No"));
 END
```

Overtemperature

```taphome
 VAR response := SENDHTTPREQUEST("/relay/1");
 IF response.IsSuccess
  VAR content := response.Content;
  RETURN(IF(PARSEJSON(content, "overtemperature"),"Yes", "No"));
 END
```

Power Meter

```taphome
 VAR response := SENDHTTPREQUEST("/relay/1");
 IF response.IsSuccess
  VAR content := response.Content;
  RETURN(IF(PARSEJSON(content, "is_valid"),"OK","Fault"));
 END
```

**Pripojenie:** Packet Parser → HTTP • Hostname: `shellyswitch25-{MAC}.local`

Možné vylepšenia (9)

- Roller Shutter Control — Full roller shutter control (open/close/stop/position 0-100%) — the Shelly 2.5's key dual-mode feature. Template only implements relay mode.
- Roller Position — Current roller position 0-100% (requires calibration). Not available without /roller/ endpoint.
- Roller Calibration — Initiates travel-time calibration procedure for position control.
- Rolling Power Averages — 3 rolling one-minute power averages per channel, available in /meter/ response
- Input States — Physical switch input states (0/1) for both channels, available in /status response
- Internal Device Temperature — Internal temperature in C available in /status response (not exposed as a device, only as relay SA)
- Auto-off Timer — Per-channel auto-off timer in seconds, could be added as service action parameter
- WiFi Signal Strength — WiFi RSSI in dBm, available in /status response
- Favorite Positions (Roller Mode) — Up to 4 saved roller shutter positions — only relevant if roller mode is implemented

## Parametre importu

Tieto hodnoty zadáte pri importe XML.

| Pýta sa v aplikácii | Predvolené    |
|---------------------|---------------|
| 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 2.5 Knowledge Base
  
  [kb.shelly.cloud](https://kb.shelly.cloud/knowledge-base/shelly-2-5) 2026-03-29
- Shelly 2.5 API Reference (Device-Specific)
  
  [shelly-api-docs.shelly.cloud](https://shelly-api-docs.shelly.cloud/gen1/#shelly2-5) 2026-03-29

## Súvisiaca dokumentácia

- [Integrácia Packet Parser](https://taphome.com/sk/compatibility/packet-parser-guide/)
- [Packet Parser (HTTP, TCP, UDP, FTP, MQTT)](https://taphome.com/sk/docs/integration/packet-parser/)
- [Funkcie Packet parsera](https://taphome.com/sk/docs/script/packet-parser/)
- [Parsovacie funkcie](https://taphome.com/sk/docs/script/parsing-functions/)