TapHome

Shelly BLU TRV

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

Külső átjáró szükséges

Shelly BLU Gateway Gen3 — termékoldal

Shelly BLU TRV

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éterLeírásHogyan találhatóPélda
IpAddressA gateway IP-címe a helyi hálózatonShelly Smart Control alkalmazás → Gateway → Settings → Network, vagy a router DHCP-bérleti táblázata192.168.0.42
IDAz adott TRV BluTrv komponens-azonosítója a gateway-enGateway web UI (http://<gateway-ip>) → komponenslista → másolja ki a TRV-hez rendelt számazonosítót200

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

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:

ÁllapotTöltöttségi szintIkon
Kritikus< 25 %Akkumulátor szinte lemerült
Alacsony25–50 %Akkumulátor alacsony
Normál50–75 %Akkumulátor közepes
Teljes> 75 %Akkumulátor tele
TöltésTö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://<gateway-ip>/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-<MAC>.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.

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 (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 BLU TRV Modul
Szerviz attribútumok
Vett jelerősségBluetooth LE jelerősség a gateway és a TRV között (dBm)
Szerviz műveletek
Újraindítás
KalibrálásElindí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) = IDA 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

Shelly BLU TRV

Olvasás (modul)
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
PARSEJSON(Status, "$.rssi")
Szerviz műveletek
Reboot
VAR response := SENDHTTPREQUEST("rpc/BluTrv.Call?id=" + ID + "&method=\"Shelly.Reboot\"&params={\"id\":0}");
if(response.IsSuccess, return("OK"), return(response.Content));
Calibrate
VAR response := SENDHTTPREQUEST("rpc/BluTrv.Call?id=" + ID + "&method=\"TRV.Calibrate\"&params={\"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

Akkumulátor

Kapcsoló állapot olvasása
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 [%]
PARSEJSON(Status, "$.battery");
Termosztát Termosztát

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)

Termosztát

Hőmérséklet olvasása
PARSEJSON(RemoteStatus, "$.status.trv:0.current_C")
Kívánt hőmérséklet olvasása
PARSEJSON(RemoteStatus, "$.status.trv:0.target_C")
Kívánt hőmérséklet írása
VAR response := SENDHTTPREQUEST("rpc/BluTrv.Call?id=" + ID + "&method=\"TRV.SetTarget\"&params={\"id\":0,\"target_C\":" + Se + "}");
IF response.IsSuccess = false
  ADDERROR(response.StatusCode);
END
Szerviz attribútumok
${device_variable_valvestate} [%]
PARSEJSON(RemoteStatus, "$.status.trv:0.pos")
Kapcsolat: Packet Parser → HTTP
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.

Források