---
title: "Shelly BLU TRV"
description: "Shelly BLU TRV v TapHome cez HTTP a bránu Shelly BLU Gateway Gen3: cieľová a aktuálna teplota, poloha ventilu a batéria. Viac ventilov na bránu."
url: "https://taphome.com/sk/compatibility/shelly-blu-trv/"
language: sk
lastmod: 2026-04-15
generator: hugo
ai:
  topics: ["http","thermostat","ble","gateway","battery-powered","heating"]
  questions: ["Ako integrovať Shelly BLU TRV s TapHome?","Ako TapHome komunikuje so Shelly BLU TRV cez Gateway Gen3?","Koľko Shelly BLU TRV zariadení sa dá spárovať s jednou BLU Gateway Gen3?","Ako zistiť ID komponentu Shelly BLU TRV na bráne?","Kedy je potrebné kalibrovať Shelly BLU TRV?","Prečo Shelly BLU TRV hlási v TapHome upozornenie na vybitú batériu?"]
---

# Shelly BLU TRV

Komunikácia: Packet Parser → HTTP

- [Produktová stránka Shelly BLU TRV](https://www.shelly.com/products/shelly-blu-trv-single-pack)
- [Produktová stránka Shelly BLU Gateway Gen3](https://www.shelly.com/products/shelly-blu-gateway-gen3)

> Adresa v sieti
> 
> TapHome komunikuje so zariadením na adrese zadanej pri importe. Dajte zariadeniu stálu adresu — rezerváciu IP v routeri, alebo jeho mDNS meno, ak ho podporuje —, inak integrácia prestane fungovať, keď router adresu zmení.
> 
> [Príprava siete](https://taphome.com/sk/docs/setup/network-preparation/)

## Návod na integráciu

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

| Parameter | Popis | Ako získať | Príklad |
|-----------|-------|------------|---------|
| `IpAddress` | IP adresa brány v lokálnej sieti | Aplikácia Shelly Smart Control → Gateway → Settings → Network, alebo tabuľka DHCP leasov routera | `192.168.0.42` |
| `ID` | ID komponentu BluTrv konkrétneho ventilu na bráne | Webové rozhranie brány (`http://<gateway-ip>`) → zoznam komponentov → skopírujte číselné ID priradené tomuto ventilu | `200` |

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

> [!WARNING]
> 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érie | Ikona |
|------|----------------|-------|
| **Kritická** | &lt; 25 % | Batéria takmer vybitá |
| **Nízka** | 25–50 % | Batéria nízka |
| **Normálna** | 50–75 % | Batéria stredná |
| **Plná** | &gt; 75 % | Batéria plná |
| **Nabíjanie** | Nabí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.

> [!TIP]
> 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](https://www.shelly.com/en/support/shelly-app) (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**

> [!NOTE]
> 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

> [!TIP]
> 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

> [!NOTE]
> 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 2

Tieto zariadenia sa po importe zobrazia v TapHome.

Shelly BLU TRV Modul

Servisné atribúty

|                          |                                                    |
|--------------------------|----------------------------------------------------|
| Sila prijímaného signálu | Sila 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) = ID ID 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

Čítanie (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
```

Servisné atribúty

Received signal strength

```taphome
PARSEJSON(Status, "$.rssi")
```

Servisné akcie

Reboot

```taphome
VAR response := SENDHTTPREQUEST("rpc/BluTrv.Call?id=" + ID + "&method=\"Shelly.Reboot\"&params={\"id\":0}");
if(response.IsSuccess, return("OK"), return(response.Content));
```

Calibrate

```taphome
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á (&lt;25 %), Nízka (25–50 %), Normálna (50–75 %), Plná (&gt;75 %), Nabíjanie

numeric Jednotka: % numeric

Hodnoty / Stavy: Critical · Low · Normal · Full · Charging

Čítanie stavu prepínača

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

Servisné atribúty

Value \[%]

```taphome
PARSEJSON(Status, "$.battery");
```

Termostat Termostat Čítanie aj zápis

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

Čítanie teploty

```taphome
PARSEJSON(RemoteStatus, "$.status.trv:0.current_C")
```

Čítanie požadovanej teploty

```taphome
PARSEJSON(RemoteStatus, "$.status.trv:0.target_C")
```

Zápis požadovanej teploty

```taphome
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} \[%]

```taphome
PARSEJSON(RemoteStatus, "$.status.trv:0.pos")
```

**Pripojenie:** Packet Parser → HTTP • Hostname: `shellyblugwg3-{MAC}.local`

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.

## Parametre importu

Tieto hodnoty zadáte pri importe XML.

| Pýta sa v aplikácii | Predvolené    |
|---------------------|---------------|
| IP adresa           | `192.168.0.1` |
| Id                  | `200`         |

## Zdroje

- 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

## Súvisiaca dokumentácia

- [Integrácia Packet Parser](https://taphome.com/sk/compatibility/packet-parser-guide/)
- [Packet Parser (HTTP, TCP, UDP, FTP, MQTT)](https://taphome.com/sk/docs/integration/packet-parser/)
- [Funkcie Packet parsera](https://taphome.com/sk/docs/script/packet-parser/)
- [Parsovacie funkcie](https://taphome.com/sk/docs/script/parsing-functions/)