---
title: "Shelly 2.5"
description: "Kétcsatornás relévezérlés csatornánkénti teljesítményméréssel HTTP-n. TapHome sablon Shelly 2.5-höz (Gen1, relé mód)."
url: "https://taphome.com/hu/compatibility/shelly-2-5/"
language: hu
lastmod: 2026-03-29
generator: hugo
ai:
  topics: ["http","i/o-module","wifi","relay","power-metering","dual-channel"]
  questions: ["Hogyan integrálhatom a Shelly 2.5-öt a TapHome-mal?","Mit mér a Shelly 2.5 TapHome sablon?","Hogyan csatlakoztathatom a Shelly 2.5-öt HTTP-n a TapHome-hoz?","Támogatja a TapHome Shelly 2.5 sablon a redőny módot?","Miért tűnik túl magasnak a Shelly 2.5 1. csatornájának energiaértéke?","Milyen szervizattribútumok érhetők el a Shelly 2.5 reléihez a TapHome-ban?"]
---

# Shelly 2.5

Kommunikáció: Packet Parser → HTTP

- [Shelly 2.5 termékoldal](https://www.shelly.com/en/products/shop/shelly-25)
- [Shelly 2.5 API dokumentáció](https://shelly-api-docs.shelly.cloud/gen1/#shelly2-5)

> Hálózati cím
> 
> A TapHome az importáláskor megadott címen éri el az eszközt. Adjon az eszköznek állandó címet — IP-foglalást a routerben, vagy az mDNS-nevét, ha támogatja —, különben az integráció leáll, amikor a router megváltoztatja a címet.
> 
> [A hálózat előkészítése](https://taphome.com/hu/docs/setup/network-preparation/)

## Integrációs útmutató

A Shelly 2.5 egy kompakt kétcsatornás Wi-Fi relé beépített teljesítményméréssel mindkét csatornán. Elfér egy szabványos fali kapcsoló mögött, és két független áramkört vezérelhet, egyenként legfeljebb 10 A (2300 W 230 V-on), összesen maximum 20 A. Az eszköz két üzemmódot támogat — relé (két független kapcsoló) és redőny (koordinált motorvezérlés) — de a TapHome sablon csak a relé módot valósítja meg. A TapHome HTTP-n kommunikál az eszközzel a helyi hálózaton — nincs szükség felhőkapcsolatra.

A sablon két relékapcsolót és két energiamérőt (csatornánként egyet) biztosít, valamint egy szervizakciót a relé és redőny mód közötti váltáshoz.

## Konfiguráció

A Shelly 2.5 Wi-Fi-n csatlakozik. A TapHome sablon importálásakor add meg az eszköz IP-címét (alapértelmezett helykitöltő `192.168.0.1`).

Az aktuális üzemmód modul szintű szervizattribútumként ("Mode") érhető el, és a "Mode" szervizakcióval módosítható. A relé és redőny mód közötti váltás eszköz újraindítást igényel.

## Eszközképességek

### Relévezérlés

A sablon két független relécsatornát biztosít. Minden relé állapota a megfelelő `/relay/` végpontról olvasódik (`ison` mező), és `turn=on` vagy `turn=off` parancsokkal vezérelhető.

- **1. csatorna** — a `/relay/0` olvasása és vezérlése
- **2. csatorna** — a `/relay/1` olvasása és vezérlése

Minden relé három szervizattribútummal rendelkezik:

- **Overpower** — túlteljesítmény állapot észlelése a csatornán
- **Overtemperature** — az eszköz túllépte a biztonságos üzemi hőmérsékletet
- **Power Meter** — mérési érvényesség (OK vagy Hiba)

### Teljesítménymérés

Minden csatornának dedikált energiamérője van, amely két értéket olvas a `/meter/` végpontról:

- **Valós idejű teljesítmény** — `power` wattban, a sablon kW-ra számítja át
- **Összes fogyasztás** — `total` watt-percben, a sablon kWh-ra számítja át

Minden energiamérő egy "Overpower" szervizattribútumot biztosít, amely a túlteljesítmény küszöbértékét mutatja (wattban, 1000-rel osztva).

A mérők csak olvashatók — minden lekérdezési ciklussal automatikusan frissülnek (15 másodperces intervallum).

> [!WARNING]
> **Ismert probléma — az 1. csatorna energiaértéke 10×-es túl magas.** A sablon a `total` értéket 6000-rel osztja az 1. csatornán 60000 helyett (amit a 2. csatorna helyesen használ). Ez azt jelenti, hogy az 1. csatorna kumulatív energiaértéke körülbelül 10-szer magasabb lesz a tényleges fogyasztásnál. Ez a sablon konverziós képletének hibája.

### További képességek

A Shelly 2.5 natívan támogatja a teljes redőnyvezérlést (nyitás/zárás/megállítás 0–100% pozícióval kalibrálás után), csatornánkénti egyperces gördülő teljesítményátlagokat, fizikai kapcsoló bemeneti állapotokat, belső eszközhőmérsékletet, Wi-Fi jelerősséget és csatornánkénti automatikus kikapcsolási időzítőket. Az eszköz legfeljebb négy kedvenc redőnypozíciót is tárolhat. Ezek a funkciók egy jövőbeli sablonfrissítésben adhatók hozzá.

> [!NOTE]
> A Shelly 1PM sablonhoz képest a Shelly 2.5 sablon nem biztosít eszközdiagnosztikát, mint hostname, MAC-cím, üzemidő, RAM-használat, cloud/MQTT állapot, firmware frissítés elérhetősége vagy belső hőmérséklet. Hiányzik a teljesítményvédelem szervizakció (maximális teljesítménykorlát) és az újraindítás akció is.

## Hibaelhárítás

### Az eszköz nem válaszol

1. Ellenőrizd, hogy a Shelly csatlakozik a Wi-Fi-hez és érvényes IP-címe van
2. Próbáld meg az mDNS hostnevet (`shellyswitch25-AABBCCDDEE.local`) az IP-cím helyett — az IP megváltozhatott DHCP megújítás után
3. Nyisd meg a `http://{device-ip}/shelly` címet böngészőben — ha válaszol, az eszköz elérhető
4. Ellenőrizd, hogy a TapHome CCU és a Shelly ugyanazon a hálózaton / VLAN-on van

### A teljesítményértékek nullát mutatnak

1. Erősítsd meg, hogy a terhelés a Shelly relén keresztül van csatlakoztatva (nincs megkerülve)
2. Ellenőrizd, hogy a relé be van kapcsolva — a mérő csak akkor mér, amikor áram folyik a relén keresztül
3. Manuálisan pollozd a `/meter/0` vagy `/meter/1` végpontot és ellenőrizd, hogy a `power` nem nulla értéket ad vissza

### Az 1. csatorna energiaösszege hibásnak tűnik

A sablon az 1. csatorna összértékét 6000-rel osztja a helyes 60000 helyett (amit a 2. csatorna használ). Ennek eredményeként az 1. csatorna kumulatív energiaértéke 10×-es a ténylegesnél. Jelenleg nincs megoldás a sablonon belül — az átváltási tényező a lekérdezési szkriptbe van beágyazva.

> [!WARNING]
> A Gen1 Shelly eszközök csak **2 egyidejű HTTP kapcsolatot** támogatnak. Ha a TapHome és egy másik rendszer (pl. Home Assistant) egyidejűleg kérdezi le ugyanazt az eszközt, a kommunikáció megbízhatatlanná válhat. A relé végpontok 2,5 másodpercenként, a mérő végpontok 15 másodpercenként kerülnek lekérdezésre.

## Telepítés a TapHome-ban

### Előfeltételek

- Shelly eszköz telepítve és bekapcsolva
- Helyi Wi-Fi hálózat (2,4 GHz)
- TapHome CCU ugyanazon a hálózaton

### 1. lépés — Shelly csatlakoztatása a Wi-Fi-hez

**A lehetőség — Shelly alkalmazás (ajánlott):**

1. Töltse le a [Shelly alkalmazást](https://www.shelly.com/en/support/shelly-app) (iOS / Android)
2. Érintse meg a **+** → **Add Device** gombot, és kövesse a Bluetooth párosítási varázslót
3. Adja meg Wi-Fi hitelesítő adatait, amikor a rendszer kéri

**B lehetőség — AP mód (alkalmazás nélkül):**

1. Első bekapcsoláskor az eszköz létrehoz egy hotspotot: `ShellyXXX-AABBCCDDEE`
2. Csatlakoztassa telefonját/PC-jét ehhez a hotspothoz
3. Nyissa meg a `http://192.168.33.1` címet → **Internet & Security** → **Wi-Fi Mode - Client**
4. Adja meg az SSID-t és a jelszót → **Save**

> [!NOTE]
> A Shelly csak **2,4 GHz**-es hálózatokat támogat. Az 5 GHz-es hálózatok nem jelennek meg a keresésben.

### 2. lépés — IP-cím megkeresése

A Wi-Fi-hez való csatlakozás után az alábbi módszerek egyikével keresse meg a hozzárendelt IP-címet:

- **Shelly alkalmazás:** Eszköz részletei → **Device info** → IP-cím
- **Shelly webes felület:** Csatlakozzon az eszköz AP-jához a Wi-Fi beállítás előtt — az IP a mentés után jelenik meg
- **Router DHCP tábla:** Keressen egy hasonló hosztnevet: `shelly1pm-AABBCCDDEE`
- **mDNS:** Pingelje a `shelly<model>-<mac>.local` címet (pl. `shelly1pm-AABBCCDDEE.local`) ugyanarról a hálózatról

> [!TIP]
> Rendeljen **statikus IP**-t (DHCP foglalást) a Shelly eszközhöz a routerben, hogy a cím ne változzon a router újraindítása után.

### 3. lépés — Konfigurálás a TapHome-ban

1. A TapHome-ban adjon hozzá egy új **Packet Parser (HTTP)** modult
2. **IP Address:** adja meg a 2. lépésben kapott IP-t (pl. `192.168.1.50`)
3. **Port:** `80` (alapértelmezett, nem kell módosítani)
4. Importálja a sablont — a TapHome rendszeresen lekérdezi a `/status` végpontot az eszköz állapotának olvasásához

> [!NOTE]
> A HTTP hitelesítés a Shelly eszközökön alapértelmezetten ki van kapcsolva. Ha engedélyezte a bejelentkezésvédelmet, a TapHome jelenleg nem támogatja a HTTP Basic Auth-ot — a TapHome integrációhoz hagyja kikapcsolva a hitelesítést.

## Elérhető eszközök 4

Ezek az eszközök az importálás után jelennek meg a TapHome-ban.

Shelly 2.5 Modul

Szerviz attribútumok

|         |
|---------|
| Üzemmód |

Szerviz műveletek

|         |
|---------|
| Üzemmód |

Szerviz attribútumok

Mode

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

Szerviz műveletek

Mode

Paraméterek: Mode

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

Villamos mérő — 1. csatorna Villanyóra Csak olvasható

1\. csatorna teljesítmény- és energiamérése — pillanatnyi teljesítmény (kW) és kumulatív energia (kWh). Megjegyzés: az energiaérték 10×-es túl magas a sablon osztó hibája miatt (/6000 helyett /60000)

numeric Egység: W / kWh

Szerviz attribútumok

|                 |
|-----------------|
| Túlteljesítmény |

Összes fogyasztás olvasása

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

Igény olvasása

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

Szerviz attribútumok

Overpower

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

Villamos mérő — 2. csatorna Villanyóra Csak olvasható

2\. csatorna teljesítmény- és energiamérése — pillanatnyi teljesítmény (kW) és kumulatív energia (kWh)

numeric Egység: W / kWh

Szerviz attribútumok

|                 |
|-----------------|
| Túlteljesítmény |

Összes fogyasztás olvasása

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

Igény olvasása

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

Szerviz attribútumok

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é — 1. csatorna Kapcsoló Olvasás és írás

boolean

Értékek / Állapotok: ON · OFF

Kapcsoló állapot olvasása

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

Kapcsoló állapot írása

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

Szerviz attribútumok

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é — 2. csatorna Kapcsoló Olvasás és írás

boolean

Értékek / Állapotok: ON · OFF

Kapcsoló állapot olvasása

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

Kapcsoló állapot írása

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

Szerviz attribútumok

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

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

Lehetséges fejlesztések (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

## Importálási paraméterek

Ezeket az értékeket az XML importálásakor adja meg.

| Az alkalmazás kéri | Alapérték     |
|--------------------|---------------|
| IP-cím             | `192.168.0.1` |

## Források

- 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

## Kapcsolódó dokumentáció

- [Packet Parser integráció](https://taphome.com/hu/compatibility/packet-parser-guide/)
- [Packet Parser (HTTP, TCP, UDP, FTP, MQTT)](https://taphome.com/hu/docs/integration/packet-parser/)
- [Packet parser függvények](https://taphome.com/hu/docs/script/packet-parser/)
- [Elemző függvények](https://taphome.com/hu/docs/script/parsing-functions/)