---
title: "Shelly BLU TRV"
description: "Termostatska radijatorska glava preko HTTP-a putem pristupnika Shelly BLU Gateway Gen3: zadana i trenutačna temperatura, položaj ventila, baterija, RSSI."
url: "https://taphome.com/hr/compatibility/shelly-blu-trv/"
language: hr
lastmod: 2026-04-15
generator: hugo
ai:
  topics: ["http","thermostat","ble","gateway","battery-powered","heating"]
  questions: ["Kako integrirati Shelly BLU TRV sa sustavom TapHome?","Kako TapHome komunicira s uređajem Shelly BLU TRV preko pristupnika Gateway Gen3?","Koliko se glava Shelly BLU TRV može upariti s jednim pristupnikom BLU Gateway Gen3?","Kako na pristupniku pronaći ID komponente glave Shelly BLU TRV?","Kada treba kalibrirati Shelly BLU TRV?","Zašto Shelly BLU TRV u sustavu TapHome javlja upozorenje o slaboj bateriji?"]
---

# Shelly BLU TRV

Komunikacija: Packet Parser → HTTP

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

> Adresa u mreži
> 
> TapHome komunicira s uređajem na adresi unesenoj pri uvozu. Dodijelite uređaju stalnu adresu — rezervaciju IP adrese u usmjerivaču ili njegovo mDNS ime ako ga podržava — inače integracija prestaje raditi kada usmjerivač promijeni adresu.
> 
> [Priprema mreže](https://taphome.com/hr/docs/setup/network-preparation/)

## Upute za integraciju

Shelly BLU TRV (model SBTR-001AEU) termostatska je radijatorska glava na baterije s povezivošću Bluetooth LE 5 i Zigbee 802.15.4. Ne komunicira izravno preko Wi-Fi mreže ni HTTP-a: TapHome glavi pristupa tako da HTTP-om komunicira s **pristupnikom (gateway) Shelly BLU Gateway Gen3**, koji pozive JSON-RPC iz imenskog prostora `BluTrv` prosljeđuje uparenoj glavi preko BLE-a.

Jedan Shelly BLU Gateway Gen3 može kao periferne komponente posluživati **više glava BLU TRV** (Shelly prodaje pakete s jednom, dvije i tri glave i jednim pristupnikom). Svaka se glava prepoznaje po ID-ju komponente na pristupniku (obično 200, 201, 202). Predložak TapHome uvozi se jednom za svaku glavu, s istom IP adresom pristupnika i drugim ID-jem komponente.

## Što vam treba

- **Shelly BLU TRV** (SBTR-001AEU) — termostatska glava, uključuje 2 AA baterije od 1,5 V i adapter za ugradnju na navoje M28 × 1,5
- **Shelly BLU Gateway Gen3** (SBGT-3B-001) — Wi-Fi pristupnik s napajanjem preko USB-A koji povezuje BLE periferne uređaje s HTTP RPC-om; prodaje se i u početnim paketima zajedno s glavom
- **Napajanje** — glava radi na 2 AA baterije od 1,5 V (tipično trajanje baterija do 2 godine); pristupnik se uključuje u bilo koji USB-A priključak (punjač za mobitel, usmjerivač, USB razdjelnik s napajanjem)
- **Mreža** — LAN / Wi-Fi veza za pristupnik; sama glava se ne spaja na Wi-Fi mrežu
- **Navoj ventila** — izravna ugradnja na ventile s navojem M30 × 1,5 ili, s priloženim adapterom, na ventile Danfoss RA/RAV/RAVL, Caleffi, Giacomini i navoje M28 × 1,5

## Uparivanje glave s pristupnikom

Svaku glavu uparite s pristupnikom **prije** uvoza predloška u TapHome, jer se ID komponente dodjeljuje tek nakon uspješnog uparivanja.

1. Uključite Shelly BLU Gateway Gen3 u USB-A priključak i pričekajte da se spoji na lokalnu mrežu
2. Pritisnite **tipku za uparivanje** na pristupniku. LED pokazuje da je način uparivanja aktivan 30 sekundi
3. U roku od 30 sekundi izvucite izolacijsku traku baterije iz potpuno nove glave ili jednom kratko pritisnite **tipku Reset** na glavi koja već radi
4. Zaslon glave zatreperi i nakon uspješnog uparivanja prikaže animaciju potvrde
5. Dodajte pristupnik u aplikaciju Shelly Smart Control. Novouparena glava pojavljuje se kao podređena komponenta pristupnika s dodijeljenim ID-jem komponente

Korake 2–4 ponovite za svaku dodatnu glavu. Svako uparivanje daje novi ID komponente (200, 201, 202…).

## Konfiguracija

Predložak TapHome spaja se na **IP adresu pristupnika** (ne na samu glavu) i preko ID-ja komponente na pristupniku upravlja jednom glavom.

### Parametri uvoza

| Parametar | Opis | Kako ga dobiti | Primjer |
|-----------|-------------|---------------|---------|
| `IpAddress` | IP adresa pristupnika u lokalnoj mreži | Aplikacija Shelly Smart Control → Gateway → Settings → Network ili tablica DHCP zakupa u usmjerivaču | `192.168.0.42` |
| `ID` | ID komponente BluTrv ove glave na pristupniku | Web-sučelje pristupnika (`http://<gateway-ip>`) → popis Components → kopirajte brojčani ID dodijeljen ovoj glavi | `200` |

Svaka glava zahtijeva zaseban uvoz predloška. Za tri glave uparene s istim pristupnikom uvezite predložak tri puta s istom vrijednošću `IpAddress` i vrijednostima `ID` `200`, `201` i `202` (ID-jevi su vidljivi u web-sučelju pristupnika).

> [!WARNING]
> Kako bi TapHome mogao pristupiti krajnjim točkama `/rpc/*`, HTTP Digest Authentication na pristupniku mora biti **isključena**. Isto ograničenje vrijedi i za ostale uređaje Shelly Gen2+/Gen3.

## Mogućnosti uređaja

### Termostat

Predložak daje glavu kao termostat. Trenutačna temperatura čita se iz `$.status.trv:0.current_C`, a zadana temperatura iz `$.status.trv:0.target_C` (obje se očitavaju iz `BluTrv.GetRemoteStatus`). Upis nove zadane temperature šalje `TRV.SetTarget` preko `BluTrv.Call` u rasponu 4–31 °C koji uređaj podržava.

Servisni atribut **stanje ventila** javlja trenutačnu otvorenost ventila u postocima (`$.status.trv:0.pos`), pri čemu je 0 % potpuno zatvoreno, a 100 % potpuno otvoreno. Položajem ventila upravlja unutarnja regulacijska petlja glave, a predložak ga samo čita.

### Baterija

Napunjenost baterije prikazuje se kao pokazatelj s 5 stanja, izveden iz neobrađene vrijednosti u postocima (`$.battery`):

| Stanje | Razina baterije | Ikona |
|-------|---------------|------|
| **Kritična** | &lt; 25 % | Baterija gotovo prazna |
| **Niska** | 25–50 % | Slaba baterija |
| **Normalna** | 50–75 % | Baterija napola puna |
| **Puna** | &gt; 75 % | Puna baterija |
| **Punjenje** | Punjenje (nije uobičajeno za AA baterije) | Ikona punjenja |

Servisni atribut **Vrijednost [%]** daje neobrađeno očitanje baterije 0–100 %. Upozorenja na razini modula prikazuju se automatski kada baterija padne ispod 50 % (Slaba baterija) i ispod 25 % (Kritično slaba baterija).

### Dijagnostika i radnje

Signali na razini modula:

- **Jačina primljenog signala** — RSSI BLE veze (dBm) između pristupnika i glave (`$.rssi`)
- Automatsko upozorenje kada je postavljen `$.update.has_update` (dostupno ažuriranje firmvera preko aplikacije Shelly Smart Control)
- Automatska greška sa sadržajem `$.trv[0].errors` kada glava javi problem

Na razini modula dostupne su dvije servisne radnje:

- **Ponovno pokretanje** — ponovno pokreće uparenu glavu pozivom `Shelly.Reboot` koji se prosljeđuje preko `BluTrv.Call`
- **Kalibriraj** — preko pristupnika pokreće kalibraciju koračnog motora (`TRV.Calibrate`). Kalibracija traje do 10 sekundi i za to vrijeme glava ne reagira. Potrebna je nakon prve ugradnje ili nakon zamjene adaptera ventila.

## Rješavanje problema

### Pristupnik nije dostupan

1. Provjerite ima li pristupnik napajanje (svijetli LED na USB-A) i je li spojen na Wi-Fi / LAN (vidljivo u aplikaciji Shelly Smart Control)
2. U pregledniku otvorite `http://<gateway-ip>/rpc/Shelly.GetDeviceInfo`. Odgovor u formatu JSON potvrđuje da je pristupnik dostupan
3. Ako se IP adresa promijenila nakon obnove DHCP zakupa, pokušajte s mDNS nazivom hosta `shellyblugwg3-<MAC>.local` (pristupnik oglašava `_http._tcp.local.`)
4. Provjerite je li HTTP Digest Auth na pristupniku isključena (`Settings → Authentication`)

### Greške glave prikazane u sustavu TapHome

Predložak prikazuje `$.trv[0].errors` kao opći tekst greške. Česte oznake i rješenja:

- `not_calibrated` — pokrenite servisnu radnju **Kalibriraj**; kalibracija mora završiti u roku od 10 sekundi bez ručnog diranja ventila
- `not_mounted` — stražnji poklopac glave je otvoren ili glava nije ispravno nasjela na ventil; ponovno postavite glavu na ventil i zatvorite pretinac za baterije
- `battery_low` — zamijenite obje AA baterije; upozorenja o bateriji prikazuju se i automatski kada razina padne ispod 50 % / 25 %
- `ext_temp_missing` — za glavu je postavljen vanjski senzor koji više ne šalje podatke; ponovno uparite senzor ili obrišite vanjsko očitanje

### Promjena zadane temperature se ne primjenjuje

1. Provjerite servisni atribut stanja ventila: ako je na 0 %, a zadana temperatura je iznad trenutačne, ventil možda treba ponovno kalibrirati
2. Provjerite da nije aktivno ručno preuzimanje (okretnim prstenom, aplikacijom Shelly ili pozivom `TRV.SetPosition` iz drugog klijenta). Upis zadane temperature preko termostata TapHome ponovno uključuje automatsku regulaciju, ali svako okretanje prstena na samoj glavi odmah ima prednost
3. Provjerite kvalitetu BLE veze: RSSI ispod −85 dBm često uzrokuje dodatno kašnjenje od 1–3 s i povremeno izgubljene naredbe; razmislite o postavljanju pristupnika bliže glavi (domet u zatvorenom ≤ 10 m)

### Upozorenje o ažuriranju firmvera

Predložak prikazuje upozorenje o ažuriranju firmvera kada je `$.update.has_update` `true`. Firmver glave BLU TRV ažurira se preko aplikacije **Shelly Smart Control**, jer ažuriranja nisu dostupna preko lokalnog RPC-a.

> [!TIP]
> Ukupno kašnjenje BLE komunikacije (zahtjev i odgovor) između pristupnika i glave obično je 1–3 sekunde. Predložak očitava svakih 3000 ms, što je već blizu praktičnog minimuma. Daljnje skraćivanje povećava broj BLE kolizija, a ne poboljšava odziv.

## Kako ga instalirati u TapHome

### Preduvjeti

- Uređaj Shelly ugrađen i uključen
- Lokalna Wi-Fi mreža (2,4 GHz)
- TapHome CCU u istoj mreži

### Korak 1 — Spojite Shelly na Wi-Fi

**Opcija A — aplikacija Shelly (preporučeno):**

1. Preuzmite [aplikaciju Shelly](https://www.shelly.com/en/support/shelly-app) (iOS / Android)
2. Dodirnite **+** → **Add Device** i slijedite čarobnjak za uparivanje preko Bluetootha
3. Kada se to zatraži, unesite podatke za prijavu na Wi-Fi

**Opcija B — način rada AP (bez aplikacije):**

1. Pri prvom uključivanju uređaj stvara pristupnu točku: `ShellyXXX-AABBCCDDEE`
2. Spojite telefon ili računalo na tu pristupnu točku
3. Otvorite `http://192.168.33.1` → **Internet & Security** → **Wi-Fi Mode - Client**
4. Unesite SSID i lozinku → **Save**

> [!NOTE]
> Shelly podržava samo mreže od **2,4 GHz**. Mreže od 5 GHz neće se prikazati pri skeniranju.

### Korak 2 — Pronađite adresu uređaja

Uređaji Shelly Gen1 podržavaju **mDNS** (Zeroconf). Uređaju možete pristupiti preko naziva hosta umjesto IP adrese:

```
shelly<model>-<MAC>.local
```

Na primjer: `shelly1pm-AABBCCDDEE.local` (MAC adresa velikim slovima u heksadecimalnom zapisu, bez dvotočaka).

> [!TIP]
> **Preporučeno: koristite IP skener TapHome.** Otvorite aplikaciju TapHome i pokrenite **IP skener** (Postavke → Mreža → Skeniranje). Skener pronalazi uređaje u vašoj mreži i prikazuje IP adresu i mDNS naziv hosta. Za pouzdaniju vezu koristite **naziv hosta** umjesto IP adrese, jer ostaje isti i kada se IP adresa uređaja promijeni nakon ponovnog pokretanja usmjerivača.

**Drugi načini** za pronalaženje IP adrese:

- **Aplikacija Shelly:** detalji uređaja → **Device info** → IP adresa
- **Web-sučelje Shelly:** spojite se na AP uređaja prije postavljanja Wi-Fi mreže — IP adresa prikazuje se nakon spremanja
- **DHCP tablica usmjerivača:** potražite naziv hosta poput `shelly1pm-AABBCCDDEE`

### Korak 3 — Konfiguracija u sustavu TapHome

1. U sustavu TapHome dodajte novi modul **Packet Parser (HTTP)**
2. **Adresa:** unesite mDNS naziv hosta (npr. `shelly1pm-AABBCCDDEE.local`) ili IP adresu iz koraka 2
3. **Port:** `80` (zadano, nije potrebno mijenjati)
4. Uvezite predložak — TapHome će čitati `/status` kako bi očitao stanje uređaja

> [!NOTE]
> HTTP autentifikacija na uređajima Shelly zadano je isključena. Ako ste uključili zaštitu prijavom, TapHome trenutačno ne podržava HTTP Basic Auth — za integraciju sa sustavom TapHome ostavite autentifikaciju isključenom.

## Dostupni uređaji 2

Ovi se uređaji pojavljuju u TapHomeu nakon uvoza.

Shelly BLU TRV Modul

Servisni atributi

|                           |                                                                       |
|---------------------------|-----------------------------------------------------------------------|
| Jačina primljenog signala | Jačina signala Bluetooth LE veze između pristupnika i glave TRV (dBm) |

Servisne radnje

|                    |                                                                                                           |
|--------------------|-----------------------------------------------------------------------------------------------------------|
| Ponovno pokretanje |                                                                                                           |
| Kalibriraj         | Pokreće kalibraciju koračnog motora (do 10 sekundi); potrebna je nakon prve ugradnje ili zamjene adaptera |

Prilagođene varijable

`ID` (numeric) = ID ID komponente glave BLU TRV na pristupniku (dodjeljuje se pri uparivanju, obično 200 i više)

Open the Shelly BLU Gateway Gen3 web UI → paired devices → copy the component ID assigned to this TRV

Čitanje (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
```

Servisni atributi

Received signal strength

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

Servisne radnje

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

Baterija Prekidač s više vrijednosti Samo za čitanje

Pokazatelj stanja baterije — Kritična (&lt;25 %), Niska (25–50 %), Normalna (50–75 %), Puna (&gt;75 %), Punjenje

numeric Jedinica: % numeric

Vrijednosti / stanja: Critical · Low · Normal · Full · Charging

Čitanje stanja sklopke

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

Servisni atributi

Value \[%]

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

Termostat Termostat Čitanje i pisanje

Termostat radijatorskog ventila — čita trenutačnu temperaturu i upisuje zadanu temperaturu (4–31 °C) preko pristupnika BLU Gateway Gen3

numeric Jedinica: °C

Servisni atributi

|                     |                                                                           |
|---------------------|---------------------------------------------------------------------------|
| Stanje ventila \[%] | Trenutačna otvorenost ventila (0 % = zatvoreno, 100 % = potpuno otvoreno) |

Čitanje temperature

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

Čitanje željene temperature

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

Zapis željene temperature

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

Servisni atributi

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

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

**Povezivanje:** Packet Parser → HTTP • Naziv računala (hostname): `shellyblugwg3-{MAC}.local`

Moguća poboljšanja (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.

## Parametri uvoza

Ove vrijednosti unosite pri uvozu XML-a.

| Pitanje u aplikaciji | Zadano        |
|----------------------|---------------|
| IP adresa            | `192.168.0.1` |
| Id                   | `200`         |

## Izvori

- 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

## Povezana dokumentacija

- [Packet Parser Integration](https://taphome.com/hr/compatibility/packet-parser-guide/)
- [Packet Parser (HTTP, TCP, UDP, FTP, MQTT)](https://taphome.com/hr/docs/integration/packet-parser/)
- [Funkcije Packet parsera](https://taphome.com/hr/docs/script/packet-parser/)
- [Funkcije za raščlambu](https://taphome.com/hr/docs/script/parsing-functions/)

