--- title: "Shelly BLU TRV" description: "Shelly BLU TRV radiátorszelep a TapHome-ban HTTP-n a Shelly BLU Gateway Gen3-on át: célhőmérséklet, aktuális hőmérséklet, szelepállás, akkumulátor." url: "https://taphome.com/hu/compatibility/shelly-blu-trv/" language: hu lastmod: 2026-04-15 generator: hugo ai: topics: ["http","thermostat","ble","gateway","battery-powered","heating"] questions: ["Hogyan integrálható a Shelly BLU TRV a TapHome-mal?","Hogyan kommunikál a TapHome a Shelly BLU TRV-vel a Gateway Gen3-on keresztül?","Hány Shelly BLU TRV párosítható egy BLU Gateway Gen3-mal?","Hogyan lehet megtalálni a Shelly BLU TRV komponens-azonosítóját a gateway-en?","Mikor szükséges kalibrálni a Shelly BLU TRV-t?","Miért jelez a Shelly BLU TRV alacsony akkumulátor figyelmeztetést a TapHome-ban?"] --- # Shelly BLU TRV Kommunikáció: Packet Parser → HTTP - [Shelly BLU TRV termékoldal](https://www.shelly.com/products/shelly-blu-trv-single-pack) - [Shelly BLU Gateway Gen3 termékoldal](https://www.shelly.com/products/shelly-blu-gateway-gen3) > 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 BLU TRV (SBTR-001AEU modell) egy akkumulátoros termosztatikus radiátorszelep Bluetooth LE 5 és Zigbee 802.15.4 kapcsolattal. Nem beszél közvetlenül Wi-Fi-t vagy HTTP-t — a TapHome HTTP-n át egy **Shelly BLU Gateway Gen3**-on keresztül éri el a szelepet, amely a `BluTrv` névtér JSON-RPC hívásait BLE-n át továbbítja a párosított szelephez. Egyetlen Shelly BLU Gateway Gen3 **több BLU TRV** perifériás komponens kezelésére képes (a Shelly egyes-, kettes- és hármascsomagokat kínál egy gateway-jel). Minden szelepet a gateway-en lévő komponens-azonosítója jelöl (jellemzően 200, 201, 202). A TapHome sablon szelepenként egyszer importálandó — ugyanazzal a gateway IP-vel és eltérő komponens-azonosítóval. ## Mire van szükség - **Shelly BLU TRV** (SBTR-001AEU) — a szelepfej, 2× AA 1,5 V elemmel és M28 × 1,5 menetű szerelőadapterrel - **Shelly BLU Gateway Gen3** (SBGT-3B-001) — USB-A-ról táplált Wi-Fi gateway, amely a BLE perifériákat HTTP RPC-re fordítja; a szeleppel együtt kezdőcsomagokban is kapható - **Tápellátás** — a TRV 2× AA 1,5 V elemmel üzemel (tipikus elemélettartam akár 2 év); a gateway bármely USB-A aljzatba bedugható (telefontöltő, router, tápellátású hub) - **Hálózat** — LAN/Wi-Fi kapcsolat a gateway számára; a szelep maga nem csatlakozik a Wi-Fi hálózathoz - **Szelepmenet** — közvetlen szerelés M30 × 1,5-ös szelepekre, vagy a mellékelt adapter használata Danfoss RA/RAV/RAVL, Caleffi, Giacomini és M28 × 1,5-ös menetekhez ## A TRV párosítása a gateway-jel Minden TRV-t **a TapHome sablon importálása előtt** párosítson a gateway-jel — a komponens-azonosító csak sikeres párosítás után kerül kiosztásra. 1. Csatlakoztassa a Shelly BLU Gateway Gen3-at egy USB-A aljzathoz, és várjon, amíg csatlakozik a helyi hálózathoz 2. Nyomja meg a gateway **párosító gombját** — a LED 30 másodpercig jelzi az aktív párosítási módot 3. 30 másodpercen belül vagy távolítsa el a vadonatúj TRV elemszigetelő csíkját, vagy nyomja meg röviden a **Reset** gombot egy már működő TRV-n 4. A TRV kijelzője villog, majd sikeres párosítás után megerősítő animációt mutat 5. Adja hozzá a gateway-t a Shelly Smart Control alkalmazáshoz — a frissen párosított TRV a gateway alárendelt komponenseként jelenik meg a hozzárendelt komponens-azonosítóval Minden további TRV-nél ismételje meg a 2–4. lépéseket. Minden párosítás új komponens-azonosítót hoz létre (200, 201, 202…). ## Konfiguráció A TapHome sablon a **gateway IP-címére** csatlakozik (nem magára a TRV-re), és a gateway-en lévő komponens-azonosító alapján éri el az adott szelepet. ### Importálási paraméterek | Paraméter | Leírás | Hogyan található | Példa | |-----------|--------|------------------|-------| | `IpAddress` | A gateway IP-címe a helyi hálózaton | Shelly Smart Control alkalmazás → Gateway → Settings → Network, vagy a router DHCP-bérleti táblázata | `192.168.0.42` | | `ID` | Az adott TRV BluTrv komponens-azonosítója a gateway-en | Gateway web UI (`http://`) → komponenslista → másolja ki a TRV-hez rendelt számazonosítót | `200` | Minden TRV-hez külön sablonimport szükséges. Ha három TRV van ugyanahhoz a gateway-hez párosítva, importálja a sablont háromszor ugyanazzal az `IpAddress` értékkel, és `ID` értékekkel 200, 201 és 202 (az ID-k a gateway webes felületén láthatók). > [!WARNING] > A HTTP Digest Authentication-t a gateway-en **ki kell kapcsolni**, hogy a TapHome el tudja érni a `/rpc/*` végpontokat — ugyanaz a feltétel, mint más Shelly Gen2+/Gen3 eszközöknél. ## Eszköz képességei ### Termosztát A sablon a szelepet termosztát eszközként teszi elérhetővé. Az aktuális hőmérsékletet a `$.status.trv:0.current_C`, a célértéket a `$.status.trv:0.target_C` adja (mindkettő a `BluTrv.GetRemoteStatus` lekérdezésből érkezik). Új célérték írásakor a `TRV.SetTarget` hívás megy a `BluTrv.Call`-on keresztül, az eszköz által támogatott 4–31 °C tartományban. Egy **szelep állapota** service attribute a szelep aktuális nyitási mértékét mutatja százalékban (`$.status.trv:0.pos`), ahol 0 % a teljesen zárt, 100 % a teljesen nyitott állapot. A szelep helyzetét a TRV belső szabályozó köre vezérli — a sablon csak kiolvassa. ### Akkumulátor Az akkumulátor töltöttsége 5 állapotú jelzőként van kitéve, a nyers százalékos értékből (`$.battery`) leképezve: | Állapot | Töltöttségi szint | Ikon | |---------|-------------------|------| | **Kritikus** | < 25 % | Akkumulátor szinte lemerült | | **Alacsony** | 25–50 % | Akkumulátor alacsony | | **Normál** | 50–75 % | Akkumulátor közepes | | **Teljes** | > 75 % | Akkumulátor tele | | **Töltés** | Töltés (AA elemeknél nem jellemző) | Töltés ikon | Egy **Érték [%]** service attribute a nyers 0–100 %-os akkumulátoradatot adja vissza. Modul szintű figyelmeztetések automatikusan keletkeznek, ha a töltöttség 50 % (Alacsony töltöttség) és 25 % (Kritikusan alacsony töltöttség) alá csökken. ### Diagnosztika és műveletek Modul szintű jelzések: - **Vett jelerősség** — a BLE kapcsolat RSSI értéke (dBm) a gateway és a TRV között (`$.rssi`) - Automatikus figyelmeztetés, amikor `$.update.has_update` igaz (firmware-frissítés érhető el a Shelly Smart Control-on keresztül) - Automatikus hiba a `$.trv[0].errors` tartalmával, ha a TRV problémát jelent Két modul szintű service művelet érhető el: - **Újraindítás** — újraindítja a párosított TRV-t `Shelly.Reboot` segítségével, a `BluTrv.Call`-on keresztül - **Kalibrálás** — a gateway-en át elindítja a léptetőmotor kalibrációját (`TRV.Calibrate`). A kalibráció akár 10 másodpercig tart, ez alatt a TRV nem reagál. Első felszerelés vagy adaptercsere után szükséges. ## Hibaelhárítás ### A gateway nem érhető el 1. Ellenőrizze, hogy a gateway tápellátás alatt van-e (a USB-A LED világít) és csatlakozott-e Wi-Fi/LAN-ra (a Shelly Smart Control alkalmazásban látható) 2. Nyissa meg böngészőben a `http:///rpc/Shelly.GetDeviceInfo` címet — a JSON-válasz megerősíti a gateway elérhetőségét 3. Ha a DHCP-bérlet megújítása után megváltozott az IP, próbálja meg a `shellyblugwg3-.local` mDNS hostnevet (a gateway `_http._tcp.local.`-t hirdet) 4. Erősítse meg, hogy a HTTP Digest Auth ki van kapcsolva a gateway-en (`Settings → Authentication`) ### TRV hibák a TapHome-ban A sablon a `$.trv[0].errors` értékét általános hibakarakterláncként továbbítja. Gyakori flag-ek és javítások: - `not_calibrated` — futtassa a **Kalibrálás** műveletet; a kalibrációnak 10 másodpercen belül, a szelep manuális megzavarása nélkül be kell fejeződnie - `not_mounted` — a TRV hátlapja nyitva van, vagy a szelep teste nincs megfelelően felhelyezve; helyezze újra a TRV-t a szelepre, és zárja vissza az elemtartó rekeszt - `battery_low` — cserélje ki a 2× AA cellát; akkumulátor figyelmeztetések 50 % / 25 % alá csökkenéskor automatikusan is keletkeznek - `ext_temp_missing` — külső szenzor lett konfigurálva a TRV-n, de már nem küld adatot; párosítsa újra a szenzort, vagy törölje a külső értéket ### A célhőmérséklet-változás nem érvényesül 1. Nézze meg a szelep állapota service attribute-ot — ha 0 %-on áll, miközben a célhőmérséklet az aktuális fölött van, a szelepet valószínűleg újra kell kalibrálni 2. Ellenőrizze, hogy nincs aktív manuális felülírás (forgógyűrű, Shelly alkalmazás vagy `TRV.SetPosition` egy másik klienstől) — egy célérték-parancs a TapHome termosztátból visszaállítja az automatikus szabályozást, de bármilyen helyi gyűrűforgatás a TRV-n azonnali elsőbbséget élvez 3. Erősítse meg a BLE kapcsolat minőségét — a −85 dBm alatti RSSI gyakran 1–3 s többlet-késleltetést és alkalmi elveszett parancsokat okoz; helyezze a gateway-t közelebb a TRV-hez (beltéri hatótáv ≤ 10 m) ### Firmware-frissítési figyelmeztetés A sablon firmware-frissítési figyelmeztetést ad, ha a `$.update.has_update` igaz. A BLU TRV firmware-frissítéseit a **Shelly Smart Control** alkalmazásban kell elvégezni — a helyi RPC-n keresztül nem érhetők el. > [!TIP] > A BLE válaszideje a gateway és a TRV között jellemzően 1–3 másodperc. A sablon 3000 ms-onként pollol, ami már közel van a gyakorlati minimumhoz — ennél alacsonyabb érték csak növeli a BLE ütközéseket anélkül, hogy javítana a reagáláson. ## 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-.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 2 Ezek az eszközök az importálás után jelennek meg a TapHome-ban. Shelly BLU TRV Modul Szerviz attribútumok | | | |-----------------|---------------------------------------------------------| | Vett jelerősség | Bluetooth LE jelerősség a gateway és a TRV között (dBm) | Szerviz műveletek | | | |-------------|------------------------------------------------------------------------------------------------------------------------| | Újraindítás | | | Kalibrálás | Elindítja a léptetőmotor kalibrációját (legfeljebb 10 másodperc); az első felszerelés vagy adaptercsere után szükséges | Egyéni változók `ID` (numeric) = ID A BLU TRV komponens azonosítója a gateway-en (párosításkor kerül beállításra, jellemzően 200+) Open the Shelly BLU Gateway Gen3 web UI → paired devices → copy the component ID assigned to this TRV Olvasás (modul) ```taphome VAR response := SENDHTTPREQUEST("/rpc/BluTrv.GetStatus?id=" + ID); IF response.IsSuccess Status := response.Content; END response := SENDHTTPREQUEST("/rpc/BluTrv.GetConfig?id=" + ID); IF response.IsSuccess Config := response.Content; END response := SENDHTTPREQUEST("/rpc/BluTrv.GetRemoteStatus?id=" + ID); IF response.IsSuccess RemoteStatus := response.Content; END response := SENDHTTPREQUEST("/rpc/BluTrv.GetRemoteConfig?id=" + ID); IF response.IsSuccess RemoteConfig := response.Content; END if(PARSEJSON(RemoteStatus, "$.trv[0].errors", true), adderror("Error: " + PARSEJSON(RemoteStatus, "$.trv[0].errors"))); if(PARSEJSON(Status, "$.update.has_update", true), addwarning("Firmware update is available")); var battery := PARSEJSON(Status, "$.battery"); if battery < 25 addwarning("Battery charge is criticaly low"); elseif battery < 50 addwarning("Low battery"); end ``` Szerviz attribútumok Received signal strength ```taphome PARSEJSON(Status, "$.rssi") ``` Szerviz műveletek Reboot ```taphome VAR response := SENDHTTPREQUEST("rpc/BluTrv.Call?id=" + ID + "&method=\"Shelly.Reboot\"¶ms={\"id\":0}"); if(response.IsSuccess, return("OK"), return(response.Content)); ``` Calibrate ```taphome VAR response := SENDHTTPREQUEST("rpc/BluTrv.Call?id=" + ID + "&method=\"TRV.Calibrate\"¶ms={\"id\":0}"); if(response.IsSuccess, return("OK"), return(response.Content)); ``` Akkumulátor Többértékű kapcsoló Csak olvasható Akkumulátor állapotjelző — Kritikus (<25 %), Alacsony (25–50 %), Normál (50–75 %), Teljes (>75 %), Töltés numeric Egység: % numeric Értékek / Állapotok: Critical · Low · Normal · Full · Charging Kapcsoló állapot olvasása ```taphome var battery := PARSEJSON(Status, "$.battery"); if battery > 75 return(3); elseif battery > 50 return(2); elseif battery > 25 return(1); else return(0); end ``` Szerviz attribútumok Value \[%] ```taphome PARSEJSON(Status, "$.battery"); ``` Termosztát Termosztát Olvasás és írás Radiátorszelep termosztát — aktuális hőmérsékletet olvas és célhőmérsékletet ír (4–31 °C) a BLU Gateway Gen3-on keresztül numeric Egység: °C Szerviz attribútumok | | | |----------------------|---------------------------------------------------------------------------| | Szelep állapota \[%] | A szelep aktuális nyitási helyzete (0 % = zárt, 100 % = teljesen nyitott) | Hőmérséklet olvasása ```taphome PARSEJSON(RemoteStatus, "$.status.trv:0.current_C") ``` Kívánt hőmérséklet olvasása ```taphome PARSEJSON(RemoteStatus, "$.status.trv:0.target_C") ``` Kívánt hőmérséklet írása ```taphome VAR response := SENDHTTPREQUEST("rpc/BluTrv.Call?id=" + ID + "&method=\"TRV.SetTarget\"¶ms={\"id\":0,\"target_C\":" + Se + "}"); IF response.IsSuccess = false ADDERROR(response.StatusCode); END ``` Szerviz attribútumok ${device\_variable\_valvestate} \[%] ```taphome PARSEJSON(RemoteStatus, "$.status.trv:0.pos") ``` **Kapcsolat:** Packet Parser → HTTP • Hostname: `shellyblugwg3-{MAC}.local` Lehetséges fejlesztések (14) - Manual valve position — Sets the valve to a fixed opening percentage (0-100%); disables automatic regulation until TRV.SetTarget is written again. Could be added as a service action. - Boost mode — Temporarily opens the valve fully for rapid room warm-up; accepts an optional duration (seconds). Could be exposed as a service action. - Clear boost — Terminates an active boost and restores the normal target temperature. - Temporary override — Temporarily overrides the target for a given duration (seconds); auto-expires back to the scheduled target. - Clear override — Terminates an active override and restores the regular target. - External temperature input — Supplies a temperature reading from an external sensor (e.g. room sensor) to the TRV regulation loop. - TRV flags (floor\_heating, accel, auto\_calibrate, anticlog, silent\_mode, power\_save) — Toggle operating flags that affect regulation behaviour (e.g. floor-heating mode keeps valve from fully closing). - Boost / override state — Object with started\_at and duration when boost or override is active; currently not surfaced as a service attribute. - Error / state flags (not\_calibrated, not\_mounted, battery\_low, ext\_temp\_missing) — Template only forwards $.trv\[0].errors as a generic error string; individual flags are not exposed as discrete sensors. - Local schedule rules (up to 10) — Shelly Cron-formatted daily/weekly rules stored on the TRV. TapHome normally drives scheduling externally via smart rules, so this is not exposed. - Display message — Shows up to 10 characters of scrolling text on the TRV 7-segment display. - Factory reset — Resets configuration to defaults; pairing information is preserved. - System diagnostics — Uptime, RAM and clock information from the paired TRV system status; not surfaced in the template. - Humidity sensor — BLU TRV can ingest humidity from paired BLU H&T peripherals; the template contains an empty ReadHumidityScriptPacketParser so this capability is not 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` | | Id | `200` | ## Források - Shelly Gen2+/Gen3 RPC API Reference [shelly-api-docs.shelly.cloud](https://shelly-api-docs.shelly.cloud/gen2/) 2026-04-15 - Shelly Gen2+ System (Sys) Component API [shelly-api-docs.shelly.cloud](https://shelly-api-docs.shelly.cloud/gen2/ComponentsAndServices/Sys/) 2026-04-15 - Shelly Gen2+ WiFi Component API [shelly-api-docs.shelly.cloud](https://shelly-api-docs.shelly.cloud/gen2/ComponentsAndServices/WiFi/) 2026-04-15 - Shelly BLU TRV RPC API (BluTrv / TRV.* methods) [shelly-api-docs.shelly.cloud](https://shelly-api-docs.shelly.cloud/docs-ble/Devices/BLU_ZB/trv/) 2026-04-15 - Shelly BLU TRV Product Page [www.shelly.com](https://www.shelly.com/products/shelly-blu-trv-single-pack) 2026-04-15 - Shelly BLU Gateway Gen3 API Reference [shelly-api-docs.shelly.cloud](https://shelly-api-docs.shelly.cloud/gen2/Devices/Gen3/ShellyBluGwG3/) 2026-04-15 - How to pair BLU TRV with BLU Gateway Gen3 [kb.shelly.cloud](https://kb.shelly.cloud/knowledge-base/how-to-pair-blu-trv-with-blu-gateway-gen3) 2026-04-15 - Home Assistant Shelly Integration (BLU TRV support) [www.home-assistant.io](https://www.home-assistant.io/integrations/shelly/) 2026-04-15 ## 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/)