TapHome

Shelly BLU TRV

Packet Parser → HTTP
Pridal
Posledná aktualizácia: 04. 2026

Vyžaduje externú bránu

Shelly BLU Gateway Gen3 — stránka produktu

Shelly BLU TRV

Shelly BLU TRV (model SBTR-001AEU) je batériou napájaný termostatický ventil radiátora s konektivitou Bluetooth LE 5 a Zigbee 802.15.4. Nekomunikuje priamo cez Wi-Fi ani HTTP — TapHome sa k ventilu pripája cez HTTP k Shelly BLU Gateway Gen3, ktorý sprostredkováva JSON-RPC volania z namespace BluTrv do spárovaného ventilu cez BLE.

Jedna Shelly BLU Gateway Gen3 dokáže hostiť viacero BLU TRV ako periférne komponenty (Shelly predáva jednobalenia, dvojbalenia a trojbalenia s jednou bránou). Každý ventil je identifikovaný podľa ID komponentu na bráne (typicky 200, 201, 202). TapHome šablóna sa importuje raz pre každý ventil s rovnakou IP adresou brány a s iným ID komponentu.

Čo potrebujete

  • Shelly BLU TRV (SBTR-001AEU) — ventilová hlavica, obsahuje 2× AA 1,5 V batérie a montážny adaptér pre závity M28 × 1,5
  • Shelly BLU Gateway Gen3 (SBGT-3B-001) — Wi-Fi brána napájaná cez USB-A, ktorá prekladá BLE periférie na HTTP RPC; predáva sa aj v štartovacích balíkoch s ventilom
  • Napájanie — TRV beží na 2× AA 1,5 V (typická výdrž batérie až 2 roky); brána sa pripája do ľubovoľného USB-A portu (nabíjačka telefónu, router, napájaný hub)
  • Sieť — LAN/Wi-Fi konektivita pre bránu; samotný ventil sa do Wi-Fi siete nepripája
  • Závit ventilu — priame osadenie na ventily M30 × 1,5 alebo použitie dodaného adaptéra pre Danfoss RA/RAV/RAVL, Caleffi, Giacomini a závity M28 × 1,5

Spárovanie ventilu s bránou

Každý ventil spárujte s bránou skôr, než šablónu naimportujete do TapHome — ID komponentu sa pridelí až po úspešnom spárovaní.

  1. Zapojte Shelly BLU Gateway Gen3 do USB-A portu a počkajte, kým sa pripojí k lokálnej sieti
  2. Stlačte tlačidlo párovania na bráne — LED indikuje aktívny režim párovania počas 30 sekúnd
  3. V priebehu 30 sekúnd buď odstráňte izolačný pásik batérie z úplne nového ventilu, alebo krátko stlačte Reset na už bežiacom ventile
  4. Displej ventilu zabliká a zobrazí potvrdzujúcu animáciu po úspešnom spárovaní
  5. Pridajte bránu do aplikácie Shelly Smart Control — novo spárovaný ventil sa objaví ako podriadený komponent brány s prideleným ID komponentu

Kroky 2–4 zopakujte pre každý ďalší ventil. Každé spárovanie vytvorí nové ID komponentu (200, 201, 202…).

Konfigurácia

TapHome šablóna sa pripája na IP adresu brány (nie na samotný ventil) a cieli na konkrétny ventil podľa jeho ID komponentu na bráne.

Parametre importu
ParameterPopisAko získaťPríklad
IpAddressIP adresa brány v lokálnej sietiAplikácia Shelly Smart Control → Gateway → Settings → Network, alebo tabuľka DHCP leasov routera192.168.0.42
IDID komponentu BluTrv konkrétneho ventilu na bráneWebové rozhranie brány (http://<gateway-ip>) → zoznam komponentov → skopírujte číselné ID priradené tomuto ventilu200

Každý ventil vyžaduje vlastný import šablóny. Pre tri ventily spárované s rovnakou bránou importujte šablónu trikrát s rovnakou hodnotou IpAddress a s hodnotami ID 200, 201 a 202 (ID sú viditeľné vo webovom rozhraní brány).

HTTP Digest Authentication musí byť na bráne vypnutá, aby sa TapHome dostalo na endpointy /rpc/* — rovnaká podmienka ako pri ostatných Shelly Gen2+/Gen3 zariadeniach.

Možnosti zariadenia

Termostat

Šablóna vystavuje ventil ako termostatické zariadenie. Aktuálna teplota sa číta z $.status.trv:0.current_C a cieľová hodnota z $.status.trv:0.target_C (obe sa získavajú cez BluTrv.GetRemoteStatus). Zápis novej cieľovej hodnoty pošle TRV.SetTarget cez BluTrv.Call v rozsahu 4–31 °C, ktorý zariadenie podporuje.

Service attribute stav ventilu zobrazuje aktuálne otvorenie ventilu v percentách ($.status.trv:0.pos), kde 0 % znamená úplne zatvorený a 100 % úplne otvorený. Polohu ventilu riadi interná regulačná slučka TRV — šablóna ju len číta.

Batéria

Stav nabitia batérie je vystavený ako 5-stavový indikátor namapovaný z surovej percentuálnej hodnoty ($.battery):

StavÚroveň batérieIkona
Kritická< 25 %Batéria takmer vybitá
Nízka25–50 %Batéria nízka
Normálna50–75 %Batéria stredná
Plná> 75 %Batéria plná
NabíjanieNabíja sa (pre AA články netypické)Ikona nabíjania

Service attribute Hodnota [%] poskytuje surový údaj batérie v rozsahu 0–100 %. Na úrovni modulu sa automaticky generujú upozornenia, keď batéria klesne pod 50 % (Slabá batéria) a pod 25 % (Kriticky nízky stav batérie).

Diagnostika a akcie

Signály na úrovni modulu:

  • Sila prijímaného signálu — RSSI BLE linky (dBm) medzi bránou a ventilom ($.rssi)
  • Automatické upozornenie pri $.update.has_update (dostupná aktualizácia firmvéru cez Shelly Smart Control)
  • Automatická chyba s obsahom $.trv[0].errors, keď TRV hlási problém

Sú dostupné dve akcie na úrovni modulu:

  • Reštart — reštartuje spárovaný ventil cez Shelly.Reboot sprostredkovaný cez BluTrv.Call
  • Kalibrácia — spustí kalibráciu krokového motora (TRV.Calibrate) cez bránu. Kalibrácia trvá až 10 sekúnd, počas ktorých ventil nereaguje. Potrebná po prvom nasadení alebo po výmene adaptéra ventilu.

Riešenie problémov

Brána je nedostupná
  1. Skontrolujte, či je brána napájaná (svieti LED USB-A) a pripojená k Wi-Fi/LAN (viditeľná v aplikácii Shelly Smart Control)
  2. Otvorte v prehliadači http://<gateway-ip>/rpc/Shelly.GetDeviceInfo — JSON odpoveď potvrdí dostupnosť brány
  3. Ak sa IP po obnove DHCP leasu zmenila, skúste mDNS hostname shellyblugwg3-<MAC>.local (brána ohlasuje _http._tcp.local.)
  4. Overte, že je na bráne vypnuté HTTP Digest Auth (Settings → Authentication)
Chyby TRV hlásené v TapHome

Šablóna preposiela $.trv[0].errors ako všeobecný chybový reťazec. Bežné flagy a opravy:

  • not_calibrated — spustite akciu Kalibrovať; kalibrácia musí prebehnúť do 10 sekúnd bez manuálneho zásahu do ventilu
  • not_mounted — zadný kryt TRV je otvorený alebo telo ventilu nie je správne nasadené; TRV znovu osadite na ventil a zatvorte priestor pre batérie
  • battery_low — vymeňte 2× AA články; upozornenia na batériu sa automaticky generujú aj pri poklese pod 50 % / 25 %
  • ext_temp_missing — externý senzor bol v TRV nakonfigurovaný, ale prestal hlásiť hodnoty; buď senzor znovu spárujte alebo externé čítanie vymažte
Zmena cieľovej teploty sa neaplikuje
  1. Skontrolujte service attribute stavu ventilu — ak je na 0 % a cieľová teplota je vyššia ako aktuálna, ventil pravdepodobne potrebuje novú kalibráciu
  2. Overte, že nie je aktívny manuálny override (cez otočný krúžok, Shelly aplikáciu alebo TRV.SetPosition z iného klienta) — zápis cieľovej hodnoty z termostatu TapHome obnoví automatickú reguláciu, ale akékoľvek lokálne pootočenie krúžku na TRV má okamžitú prednosť
  3. Potvrďte kvalitu BLE linky — RSSI pod −85 dBm často spôsobuje oneskorenie 1–3 s a občasné stratené príkazy; skúste umiestniť bránu bližšie k TRV (vnútorný dosah ≤ 10 m)
Upozornenie na aktualizáciu firmvéru

Šablóna generuje upozornenie na aktualizáciu firmvéru, keď $.update.has_update je true. Aktualizácie firmvéru pre BLU TRV sa musia vykonať cez aplikáciu Shelly Smart Control — nie sú vystavené cez lokálne RPC.

Latencia BLE odozvy medzi bránou a TRV je typicky 1–3 sekundy. Šablóna pollne každých 3000 ms, čo je už blízko praktického minima — ďalšie zníženie tejto hodnoty zvýši BLE kolízie bez zlepšenia reakčnosti.

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

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

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

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

Shelly BLU TRV Modul
Servisné atribúty
Sila prijímaného signáluSila Bluetooth LE signálu medzi bránou a TRV (dBm)
Servisné akcie
Reštart
KalibrovaťSpustí kalibráciu krokového motora (až 10 sekúnd); potrebná po prvom nasadení alebo výmene adaptéra
Vlastné premenné
ID (numeric) = IDID komponentu BLU TRV na bráne (nastaví sa pri párovaní, typicky 200+)
Open the Shelly BLU Gateway Gen3 web UI → paired devices → copy the component ID assigned to this TRV

Shelly BLU TRV

Čítanie (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
Servisné atribúty
Received signal strength
PARSEJSON(Status, "$.rssi")
Servisné akcie
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));
Batéria Viacstavový prepínač Len na čítanie

Indikátor stavu batérie — Kritická (<25 %), Nízka (25–50 %), Normálna (50–75 %), Plná (>75 %), Nabíjanie

numeric Jednotka: % numeric
Hodnoty / Stavy: Critical · Low · Normal · Full · Charging

Batéria

Čítanie stavu prepínača
var battery := PARSEJSON(Status, "$.battery");
if battery > 75
    return(3);
elseif battery > 50
    return(2);
elseif battery > 25
    return(1);
else
    return(0);
end
Servisné atribúty
Value [%]
PARSEJSON(Status, "$.battery");
Termostat Termostat

Termostat radiátorového ventilu — číta aktuálnu teplotu a zapisuje cieľovú hodnotu (4–31 °C) cez BLU Gateway Gen3

numeric Jednotka: °C
Servisné atribúty
Stav ventilu [%]Aktuálna poloha otvorenia ventilu (0 % = zatvorený, 100 % = úplne otvorený)

Termostat

Čítanie teploty
PARSEJSON(RemoteStatus, "$.status.trv:0.current_C")
Čítanie požadovanej teploty
PARSEJSON(RemoteStatus, "$.status.trv:0.target_C")
Zápis požadovanej teploty
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
Servisné atribúty
${device_variable_valvestate} [%]
PARSEJSON(RemoteStatus, "$.status.trv:0.pos")
Pripojenie: Packet Parser → HTTP
Možné vylepšenia (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.

Zdroje