TapHome

Shelly 2.5

Packet Parser → HTTP
Beküldő
Utoljára frissítve: 03. 2026
Shelly 2.5

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).

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á.

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.

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

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

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

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

Shelly 2.5 Modul
Szerviz attribútumok
Üzemmód
Szerviz műveletek
Üzemmód

Shelly2.5

Szerviz attribútumok
Mode
 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
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

Villamos mérő — 1. csatorna

Összes fogyasztás olvasása
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
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
 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

Villamos mérő — 2. csatorna

Összes fogyasztás olvasása
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
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
 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ó
boolean
Értékek / Állapotok: ON · OFF

Relé — 1. csatorna

Kapcsoló állapot olvasása
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
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
 VAR response := SENDHTTPREQUEST("/relay/0");
 IF response.IsSuccess
  VAR content := response.Content;
  RETURN(IF(PARSEJSON(content, "overpower"),"Yes", "No"));
 END
Overtemperature
 VAR response := SENDHTTPREQUEST("/relay/0");
 IF response.IsSuccess
  VAR content := response.Content;
  RETURN(IF(PARSEJSON(content, "overtemperature"),"Yes", "No"));
 END
Power Meter
 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ó
boolean
Értékek / Állapotok: ON · OFF

Relé — 2. csatorna

Kapcsoló állapot olvasása
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
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
 VAR response := SENDHTTPREQUEST("/relay/1");
 IF response.IsSuccess
  VAR content := response.Content;
  RETURN(IF(PARSEJSON(content, "overpower"),"Yes", "No"));
 END
Overtemperature
 VAR response := SENDHTTPREQUEST("/relay/1");
 IF response.IsSuccess
  VAR content := response.Content;
  RETURN(IF(PARSEJSON(content, "overtemperature"),"Yes", "No"));
 END
Power Meter
 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
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

Források