---
title: "Shelly BLU TRV"
description: "Integrace termostatického ventilu přes HTTP a Shelly BLU Gateway Gen3 — cílová a aktuální teplota, poloha ventilu, baterie, RSSI."
url: "https://taphome.com/cs/compatibility/shelly-blu-trv/"
language: cs
lastmod: 2026-04-15
generator: hugo
ai:
  topics: ["http","thermostat","ble","gateway","battery-powered","heating"]
  questions: ["Jak integrovat Shelly BLU TRV s TapHome?","Jak TapHome komunikuje se Shelly BLU TRV přes Gateway Gen3?","Kolik zařízení Shelly BLU TRV lze spárovat s jednou BLU Gateway Gen3?","Jak zjistit ID komponenty Shelly BLU TRV na bráně?","Kdy je potřeba kalibrovat Shelly BLU TRV?","Proč Shelly BLU TRV hlásí v TapHome upozornění na nízkou baterii?"]
---

# Shelly BLU TRV

Komunikace: 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 síti
> 
> TapHome komunikuje se zařízením na adrese zadané při importu. Dejte zařízení stálou adresu — rezervaci IP v routeru, nebo jeho mDNS jméno, pokud ho podporuje —, jinak integrace přestane fungovat, když router adresu změní.
> 
> [Příprava sítě](https://taphome.com/cs/docs/setup/network-preparation/)

## Návod na integraci

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

| Parametr | Popis | Jak získat | Příklad |
|----------|-------|------------|---------|
| `IpAddress` | IP adresa brány v lokální síti | Aplikace Shelly Smart Control → Gateway → Settings → Network nebo tabulka DHCP leasů routeru | `192.168.0.42` |
| `ID` | ID 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 ventilu | `200` |

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

> [!WARNING]
> 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ň baterie | Ikona |
|------|----------------|-------|
| **Kritická** | &lt; 25 % | Baterie téměř vybitá |
| **Nízká** | 25–50 % | Baterie nízká |
| **Normální** | 50–75 % | Baterie střední |
| **Plná** | &gt; 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.

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

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

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

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

Tato zařízení se po importu zobrazí v TapHome.

Shelly BLU TRV Modul

Servisní atributy

|                          |                                                   |
|--------------------------|---------------------------------------------------|
| Síla přijímaného signálu | Síla Bluetooth LE signálu mezi bránou a TRV (dBm) |

Servisní akce

|            |                                                                                                 |
|------------|-------------------------------------------------------------------------------------------------|
| Restart    |                                                                                                 |
| Kalibrovat | Spustí kalibraci krokového motoru (až 10 sekund); nutná po prvním nasazení nebo výměně adaptéru |

Vlastní proměnné

`ID` (numeric) = ID ID 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

Čtení (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í atributy

Received signal strength

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

Servisní akce

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

Baterie Vícestavový přepínač Pouze ke čtení

Indikátor stavu baterie — Kritická (&lt;25 %), Nízká (25–50 %), Normální (50–75 %), Plná (&gt;75 %), Nabíjení

numeric Jednotka: % numeric

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

Čtení stavu přepínače

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

Value \[%]

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

Termostat Termostat Čtení i zápis

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

Čtení teploty

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

Čtení požadované teploty

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

Zápis požadované 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í atributy

${device\_variable\_valvestate} \[%]

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

**Připojení:** Packet Parser → HTTP • Hostname: `shellyblugwg3-{MAC}.local`

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.

## Parametry importu

Tyto hodnoty zadáte při importu XML.

| Ptá se v aplikaci | Výchozí       |
|-------------------|---------------|
| 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

## Související dokumentace

- [Integrace Packet Parser](https://taphome.com/cs/compatibility/packet-parser-guide/)
- [Packet Parser (HTTP, TCP, UDP, FTP, MQTT)](https://taphome.com/cs/docs/integration/packet-parser/)
- [Funkce Packet parser](https://taphome.com/cs/docs/script/packet-parser/)
- [Funkce pro parsování](https://taphome.com/cs/docs/script/parsing-functions/)