TapHome

Shelly BLU TRV

Packet Parser → HTTP
Přidal
Poslední aktualizace: 04. 2026

Vyžaduje externí bránu

Shelly BLU Gateway Gen3 — stránka produktu

Shelly BLU TRV

Shelly BLU TRV (model SBTR-001AEU) je bateriově napájený termostatický ventil radiátoru s konektivitou Bluetooth LE 5 a Zigbee 802.15.4. Nekomunikuje přímo přes Wi-Fi ani HTTP — TapHome se k ventilu připojuje přes HTTP ke Shelly BLU Gateway Gen3, která zprostředkovává JSON-RPC volání z namespace BluTrv do spárovaného ventilu přes BLE.

Jedna Shelly BLU Gateway Gen3 dokáže hostit více BLU TRV jako periferní komponenty (Shelly prodává jednotlivá balení, dvojbalení a trojbalení s jednou bránou). Každý ventil je identifikován podle ID komponenty na bráně (typicky 200, 201, 202). TapHome šablona se importuje jednou pro každý ventil se stejnou IP adresou brány a s jiným ID komponenty.

Co potřebujete

  • Shelly BLU TRV (SBTR-001AEU) — ventilová hlavice, obsahuje 2× AA 1,5 V baterie a montážní adaptér pro závity M28 × 1,5
  • Shelly BLU Gateway Gen3 (SBGT-3B-001) — Wi-Fi brána napájená přes USB-A, která překládá BLE periferie na HTTP RPC; prodává se také ve startovacích balíčcích s ventilem
  • Napájení — TRV běží na 2× AA 1,5 V (typická výdrž baterie až 2 roky); brána se zapojuje do libovolného USB-A portu (nabíječka telefonu, router, napájený hub)
  • Síť — LAN/Wi-Fi konektivita pro bránu; samotný ventil se do Wi-Fi sítě nepřipojuje
  • Závit ventilu — přímé osazení na ventily M30 × 1,5 nebo použití dodaného adaptéru pro Danfoss RA/RAV/RAVL, Caleffi, Giacomini a závity M28 × 1,5

Spárování ventilu s bránou

Každý ventil spárujte s bránou dříve, než šablonu naimportujete do TapHome — ID komponenty se přidělí až po úspěšném spárování.

  1. Zapojte Shelly BLU Gateway Gen3 do USB-A portu a počkejte, až se připojí k lokální síti
  2. Stiskněte tlačítko párování na bráně — LED indikuje aktivní režim párování po dobu 30 sekund
  3. Během 30 sekund buď odstraňte izolační pásek baterie z úplně nového ventilu, nebo krátce stiskněte Reset na již běžícím ventilu
  4. Displej ventilu zabliká a zobrazí potvrzovací animaci po úspěšném spárování
  5. Přidejte bránu do aplikace Shelly Smart Control — nově spárovaný ventil se objeví jako podřízená komponenta brány s přiděleným ID komponenty

Kroky 2–4 zopakujte pro každý další ventil. Každé spárování vytvoří nové ID komponenty (200, 201, 202…).

Konfigurace

TapHome šablona se připojuje na IP adresu brány (nikoli na samotný ventil) a cílí na konkrétní ventil podle jeho ID komponenty na bráně.

Parametry importu
ParametrPopisJak získatPříklad
IpAddressIP adresa brány v lokální sítiAplikace Shelly Smart Control → Gateway → Settings → Network nebo tabulka DHCP leasů routeru192.168.0.42
IDID komponenty BluTrv konkrétního ventilu na bráněWebové rozhraní brány (http://<gateway-ip>) → seznam komponent → zkopírujte číselné ID přiřazené tomuto ventilu200

Každý ventil vyžaduje vlastní import šablony. Pro tři ventily spárované se stejnou bránou importujte šablonu třikrát se stejnou hodnotou IpAddress a s hodnotami ID 200, 201 a 202 (ID jsou viditelná ve webovém rozhraní brány).

HTTP Digest Authentication musí být na bráně vypnuté, aby se TapHome dostalo na endpointy /rpc/* — stejná podmínka jako u ostatních zařízení Shelly Gen2+/Gen3.

Možnosti zařízení

Termostat

Šablona vystavuje ventil jako termostatové zařízení. Aktuální teplota se čte z $.status.trv:0.current_C a cílová hodnota z $.status.trv:0.target_C (obojí se získává přes BluTrv.GetRemoteStatus). Zápis nové cílové hodnoty pošle TRV.SetTarget přes BluTrv.Call v rozsahu 4–31 °C, který zařízení podporuje.

Service attribute stav ventilu zobrazuje aktuální otevření ventilu v procentech ($.status.trv:0.pos), kde 0 % znamená zcela zavřený a 100 % zcela otevřený. Polohu ventilu řídí interní regulační smyčka TRV — šablona ji pouze čte.

Baterie

Stav nabití baterie je vystaven jako 5-stavový indikátor mapovaný ze surové procentuální hodnoty ($.battery):

StavÚroveň baterieIkona
Kritická< 25 %Baterie téměř vybitá
Nízká25–50 %Baterie nízká
Normální50–75 %Baterie střední
Plná> 75 %Baterie plná
NabíjeníNabíjí se (pro AA články netypické)Ikona nabíjení

Service attribute Hodnota [%] poskytuje surový údaj baterie v rozsahu 0–100 %. Na úrovni modulu se automaticky generují upozornění, když baterie klesne pod 50 % (Slabá baterie) a pod 25 % (Kriticky nízký stav baterie).

Diagnostika a akce

Signály na úrovni modulu:

  • Síla přijímaného signálu — RSSI BLE linky (dBm) mezi bránou a ventilem ($.rssi)
  • Automatické upozornění při $.update.has_update (dostupná aktualizace firmwaru přes Shelly Smart Control)
  • Automatická chyba s obsahem $.trv[0].errors, když TRV hlásí problém

Jsou k dispozici dvě akce na úrovni modulu:

  • Restart — restartuje spárovaný ventil přes Shelly.Reboot zprostředkovaný přes BluTrv.Call
  • Kalibrace — spustí kalibraci krokového motoru (TRV.Calibrate) přes bránu. Kalibrace trvá až 10 sekund, během kterých ventil nereaguje. Nutná po prvním nasazení nebo po výměně adaptéru ventilu.

Řešení problémů

Brána je nedostupná
  1. Zkontrolujte, zda je brána napájena (svítí LED USB-A) a připojena k Wi-Fi/LAN (viditelná v aplikaci Shelly Smart Control)
  2. Otevřete v prohlížeči http://<gateway-ip>/rpc/Shelly.GetDeviceInfo — JSON odpověď potvrdí dostupnost brány
  3. Pokud se IP po obnově DHCP leasu změnila, zkuste mDNS hostname shellyblugwg3-<MAC>.local (brána ohlašuje _http._tcp.local.)
  4. Ověřte, že je na bráně vypnuté HTTP Digest Auth (Settings → Authentication)
Chyby TRV hlášené v TapHome

Šablona přeposílá $.trv[0].errors jako obecný chybový řetězec. Běžné flagy a opravy:

  • not_calibrated — spusťte akci Kalibrovat; kalibrace musí proběhnout do 10 sekund bez manuálního zásahu do ventilu
  • not_mounted — zadní kryt TRV je otevřený nebo tělo ventilu není správně nasazené; TRV znovu osaďte na ventil a zavřete prostor pro baterie
  • battery_low — vyměňte 2× AA články; upozornění na baterii se automaticky generují i při poklesu pod 50 % / 25 %
  • ext_temp_missing — externí senzor byl v TRV nakonfigurován, ale přestal hlásit hodnoty; buď senzor znovu spárujte nebo externí čtení vymažte
Změna cílové teploty se neaplikuje
  1. Zkontrolujte service attribute stavu ventilu — pokud je na 0 % a cílová teplota je vyšší než aktuální, ventil pravděpodobně potřebuje novou kalibraci
  2. Ověřte, že není aktivní manuální override (přes otočný kroužek, Shelly aplikaci nebo TRV.SetPosition z jiného klienta) — zápis cílové hodnoty z termostatu TapHome obnoví automatickou regulaci, ale jakékoli lokální pootočení kroužku na TRV má okamžitou přednost
  3. Potvrďte kvalitu BLE linky — RSSI pod −85 dBm často způsobuje zpoždění 1–3 s a občasné ztracené příkazy; zkuste umístit bránu blíže k TRV (vnitřní dosah ≤ 10 m)
Upozornění na aktualizaci firmwaru

Šablona generuje upozornění na aktualizaci firmwaru, když je $.update.has_update nastaveno na true. Aktualizace firmwaru pro BLU TRV se musí provádět přes aplikaci Shelly Smart Control — nejsou vystaveny přes lokální RPC.

Latence BLE odezvy mezi bránou a TRV je typicky 1–3 sekundy. Šablona pollne každých 3000 ms, což je již blízko praktickému minimu — další snížení této hodnoty zvýší BLE kolize bez zlepšení odezvy.

Jak nainstalovat v TapHome

Předpoklady

  • Zařízení Shelly nainstalované a zapnuté
  • Lokální Wi-Fi síť (2,4 GHz)
  • TapHome CCU ve stejné síti

Krok 1 — Připojte Shelly k Wi-Fi

Možnost A — Aplikace Shelly (doporučeno):

  1. Stáhněte si aplikaci Shelly (iOS / Android)
  2. Klepněte na + → Add Device a postupujte podle průvodce Bluetooth párováním
  3. Po výzvě zadejte své Wi-Fi přihlašovací údaje

Možnost B — AP režim (bez aplikace):

  1. Při prvním zapnutí zařízení vytvoří hotspot: ShellyXXX-AABBCCDDEE
  2. Připojte telefon/PC k tomuto hotspotu
  3. Otevřete http://192.168.33.1 → Internet & Security → Wi-Fi Mode - Client
  4. Zadejte SSID a heslo → Save

Shelly podporuje pouze 2,4 GHz sítě. 5 GHz sítě se při skenování nezobrazí.

Krok 2 — Zjistěte IP adresu

Po připojení k Wi-Fi zjistěte přiřazenou IP adresu jedním z následujících způsobů:

  • Aplikace Shelly: Detail zařízení → Device info → IP adresa
  • Webové rozhraní Shelly: Připojte se k AP zařízení před nastavením Wi-Fi — IP se zobrazí po uložení
  • DHCP tabulka routeru: Hledejte hostname jako shelly1pm-AABBCCDDEE
  • mDNS: Pingněte shelly<model>-<mac>.local (např. shelly1pm-AABBCCDDEE.local) ze stejné sítě

Přiřaďte zařízení Shelly statickou IP (DHCP rezervaci) ve vašem routeru, aby se adresa nezměnila po restartu routeru.

Krok 3 — Konfigurace v TapHome

  1. V TapHome přidejte nový modul Packet Parser (HTTP)
  2. IP Address: zadejte IP z kroku 2 (např. 192.168.1.50)
  3. Port: 80 (výchozí, není potřeba měnit)
  4. Importujte šablonu — TapHome bude pravidelně číst /status pro zjištění stavu zařízení

HTTP autentifikace je na zařízeních Shelly standardně vypnutá. Pokud jste povolili ochranu přihlášením, TapHome momentálně nepodporuje HTTP Basic Auth — pro integraci s TapHome ponechte autentifikaci vypnutou.

Dostupná zařízení

Shelly BLU TRV Modul
Servisní atributy
Síla přijímaného signáluSíla Bluetooth LE signálu mezi bránou a TRV (dBm)
Servisní akce
Restart
KalibrovatSpustí kalibraci krokového motoru (až 10 sekund); nutná po prvním nasazení nebo výměně adaptéru
Vlastní proměnné
ID (numeric) = IDID komponenty BLU TRV na bráně (nastaví se při párování, typicky 200+)
Open the Shelly BLU Gateway Gen3 web UI → paired devices → copy the component ID assigned to this TRV

Shelly BLU TRV

Čtení (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í atributy
Received signal strength
PARSEJSON(Status, "$.rssi")
Servisní akce
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));
Baterie Vícestavový přepínač Pouze ke čtení

Indikátor stavu baterie — Kritická (<25 %), Nízká (25–50 %), Normální (50–75 %), Plná (>75 %), Nabíjení

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

Baterie

Čtení stavu přepínače
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í atributy
Value [%]
PARSEJSON(Status, "$.battery");
Termostat Termostat

Termostat radiátorového ventilu — čte aktuální teplotu a zapisuje cílovou hodnotu (4–31 °C) přes BLU Gateway Gen3

numeric Jednotka: °C
Servisní atributy
Stav ventilu [%]Aktuální poloha otevření ventilu (0 % = zavřený, 100 % = plně otevřený)

Termostat

Čtení teploty
PARSEJSON(RemoteStatus, "$.status.trv:0.current_C")
Čtení požadované teploty
PARSEJSON(RemoteStatus, "$.status.trv:0.target_C")
Zápis požadované 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í atributy
${device_variable_valvestate} [%]
PARSEJSON(RemoteStatus, "$.status.trv:0.pos")
Připojení: Packet Parser → HTTP
Možná vylepšení (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