---
title: "Shelly BLU TRV"
description: "Cap termostatic pentru calorifer, prin HTTP cu ajutorul Shelly BLU Gateway Gen3 — temperatura dorită/curentă, poziția robinetului, bateria, RSSI."
url: "https://taphome.com/ro/compatibility/shelly-blu-trv/"
language: ro
lastmod: 2026-04-15
generator: hugo
ai:
  topics: ["http","thermostat","ble","gateway","battery-powered","heating"]
  questions: ["Cum integrez Shelly BLU TRV cu TapHome?","Cum comunică TapHome cu Shelly BLU TRV prin Gateway Gen3?","Câte capete termostatice Shelly BLU TRV pot fi împerecheate cu un singur BLU Gateway Gen3?","Cum găsesc ID-ul componentei Shelly BLU TRV pe gateway?","Când trebuie calibrat Shelly BLU TRV?","De ce Shelly BLU TRV raportează în TapHome o avertizare de baterie slabă?"]
---

# Shelly BLU TRV

Comunicație: Packet Parser → HTTP

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

> Adresa în rețea
> 
> TapHome comunică cu dispozitivul la adresa introdusă la import. Atribuiți dispozitivului o adresă fixă — o rezervare IP în router sau numele său mDNS, dacă îl acceptă —, altfel integrarea nu mai funcționează când routerul schimbă adresa.
> 
> [Pregătirea rețelei](https://taphome.com/ro/docs/setup/network-preparation/)

## Ghid de integrare

Shelly BLU TRV (model SBTR-001AEU) este un cap termostatic pentru calorifer, alimentat de la baterii, cu conectivitate Bluetooth LE 5 și Zigbee 802.15.4. Nu comunică direct prin Wi-Fi sau HTTP — TapHome comunică prin HTTP cu un **Shelly BLU Gateway Gen3**, care transmite apelurile JSON-RPC din spațiul de nume `BluTrv` către TRV-ul împerecheat, prin BLE.

Un singur Shelly BLU Gateway Gen3 poate gestiona **mai multe BLU TRV** ca periferice, fiecare fiind o componentă a gateway-ului (Shelly vinde pachete cu unul, două sau trei capete termostatice și un gateway). Fiecare TRV este identificat prin ID-ul său de componentă pe gateway (de obicei 200, 201, 202). Șablonul TapHome se importă o dată pentru fiecare TRV, cu aceeași adresă IP a gateway-ului și un alt ID de componentă.

## De ce aveți nevoie

- **Shelly BLU TRV** (SBTR-001AEU) — capul termostatic, include 2 baterii AA de 1,5 V și un adaptor de montare pentru filet M28 × 1,5
- **Shelly BLU Gateway Gen3** (SBGT-3B-001) — gateway Wi-Fi alimentat prin USB-A, care face legătura între perifericele BLE și HTTP RPC; se vinde și în kituri de pornire împreună cu TRV
- **Alimentare** — TRV-ul funcționează cu 2 baterii AA de 1,5 V (durată de viață tipică a bateriilor de până la 2 ani); gateway-ul se conectează la orice port USB-A (încărcător de telefon, router, hub alimentat)
- **Rețea** — conectivitate LAN / Wi-Fi pentru gateway; TRV-ul însuși nu se conectează la rețeaua Wi-Fi
- **Filetul robinetului** — montare directă pe robinete M30 × 1,5 sau cu adaptorul furnizat pentru Danfoss RA/RAV/RAVL, Caleffi, Giacomini și filete M28 × 1,5

## Împerecherea TRV cu gateway-ul

Împerecheați fiecare TRV cu gateway-ul **înainte** de importul șablonului în TapHome — ID-ul de componentă se atribuie doar după o împerechere reușită.

1. Conectați Shelly BLU Gateway Gen3 la un port USB-A și așteptați să se conecteze la rețeaua locală
2. Apăsați **butonul de împerechere** de pe gateway — LED-ul indică faptul că modul de împerechere este activ timp de 30 de secunde
3. În decurs de 30 de secunde, scoateți banda de izolare a bateriei dintr-un TRV nou sau apăsați o dată **butonul Reset** al unui TRV aflat deja în funcțiune
4. Afișajul TRV-ului clipește și afișează o animație de confirmare după împerecherea reușită
5. Adăugați gateway-ul în aplicația Shelly Smart Control — TRV-ul nou împerecheat apare ca o componentă subordonată a gateway-ului, cu un ID de componentă atribuit

Repetați pașii 2–4 pentru fiecare TRV suplimentar. Fiecare împerechere generează un nou ID de componentă (200, 201, 202…).

## Configurare

Șablonul TapHome se conectează la **adresa IP a gateway-ului** (nu la TRV) și se adresează unui singur TRV prin ID-ul său de componentă de pe gateway.

### Parametrii de import

| Parametru | Descriere | Cum se obține | Exemplu |
|-----------|-----------|---------------|---------|
| `IpAddress` | Adresa IP a gateway-ului în rețeaua locală | Aplicația Shelly Smart Control → Gateway → Settings → Network sau tabelul de alocări DHCP din router | `192.168.0.42` |
| `ID` | ID-ul componentei BluTrv a acestui TRV pe gateway | Interfața web a gateway-ului (`http://<gateway-ip>`) → lista Components → copiați ID-ul numeric atribuit acestui TRV | `200` |

Fiecare TRV necesită un import separat al șablonului. Pentru trei TRV împerecheate cu același gateway, importați șablonul de trei ori cu aceeași valoare `IpAddress` și cu valorile `ID` `200`, `201` și `202` (ID-urile sunt vizibile în interfața web a gateway-ului).

> [!WARNING]
> Pentru ca TapHome să poată accesa endpointurile `/rpc/*`, autentificarea HTTP Digest pe gateway trebuie să fie **dezactivată** — aceeași restricție ca la celelalte dispozitive Shelly Gen2+/Gen3.

## Funcțiile dispozitivului

### Termostat

Șablonul oferă TRV-ul ca dispozitiv de tip termostat. Temperatura curentă se citește din `$.status.trv:0.current_C`, iar valoarea setată din `$.status.trv:0.target_C` (ambele interogate din `BluTrv.GetRemoteStatus`). La scrierea unei noi valori setate se trimite `TRV.SetTarget` prin `BluTrv.Call`, în intervalul 4–31 °C acceptat de dispozitiv.

Atributul de service **Stare robinet** raportează deschiderea curentă a robinetului în procente (`$.status.trv:0.pos`), unde 0 % înseamnă complet închis și 100 % complet deschis. Poziția robinetului este comandată de bucla de reglare internă a TRV-ului-ului — șablonul doar o citește.

### Baterie

Nivelul de încărcare al bateriei este afișat ca indicator cu 5 stări, derivat din procentul brut (`$.battery`):

| Stare | Nivelul bateriei | Pictogramă |
|-------|------------------|------------|
| **Critic** | &lt; 25 % | Baterie aproape descărcată |
| **Slab** | 25–50 % | Baterie slabă |
| **Normal** | 50–75 % | Baterie la nivel mediu |
| **Plin** | &gt; 75 % | Baterie plină |
| **Încărcare** | Încărcare (neobișnuit pentru elementele AA) | Pictogramă de încărcare |

Atributul de service **Valoare [%]** oferă citirea brută a bateriei, 0–100 %. Avertizările la nivelul modulului se generează automat când bateria scade sub 50 % (Low battery) și sub 25 % (Critically low battery).

### Diagnosticare și acțiuni

Semnale la nivelul modulului:

- **Puterea semnalului recepționat** — RSSI-ul legăturii BLE (dBm) dintre gateway și TRV (`$.rssi`)
- Avertizare automată când este setat `$.update.has_update` (actualizare de firmware disponibilă prin Shelly Smart Control)
- Eroare automată cu conținutul `$.trv[0].errors` atunci când TRV-ul raportează o problemă

La nivelul modulului sunt disponibile două acțiuni de service:

- **Repornire** — repornește TRV-ul împerecheat prin `Shelly.Reboot`, transmis prin `BluTrv.Call`
- **Calibrare** — efectuează calibrarea motorului pas cu pas (`TRV.Calibrate`) prin gateway. Calibrarea durează până la 10 secunde, timp în care TRV-ul nu răspunde. Este necesară după prima montare sau după schimbarea adaptorului robinetului.

## Rezolvarea problemelor

### Gateway-ul nu este accesibil

1. Verificați dacă gateway-ul este alimentat (LED-ul USB-A aprins) și s-a conectat la Wi-Fi / LAN (vizibil în aplicația Shelly Smart Control)
2. Deschideți `http://<gateway-ip>/rpc/Shelly.GetDeviceInfo` în browser — un răspuns JSON confirmă că gateway-ul este accesibil
3. Dacă adresa IP s-a schimbat după reînnoirea alocării DHCP, încercați numele de gazdă mDNS `shellyblugwg3-<MAC>.local` (gateway-ul se anunță ca `_http._tcp.local.`)
4. Verificați dacă HTTP Digest Auth este dezactivată pe gateway (`Settings → Authentication`)

### Erori TRV raportate în TapHome

Șablonul afișează `$.trv[0].errors` ca text de eroare generic. Indicatori frecvenți și remedieri:

- `not_calibrated` — rulați acțiunea de service **Calibrare**; calibrarea trebuie să se încheie în 10 secunde, fără intervenție manuală asupra robinetului
- `not_mounted` — capacul din spate al TRV-ului este deschis sau corpul robinetului nu este așezat corect; montați din nou TRV-ul pe robinet și închideți compartimentul bateriilor
- `battery_low` — înlocuiți cele 2 elemente AA; avertizările privind bateria se generează și automat când nivelul scade sub 50 % / 25 %
- `ext_temp_missing` — pe TRV a fost configurat un senzor extern care nu mai raportează; împerecheați din nou senzorul sau ștergeți citirea externă

### Modificarea temperaturii dorite nu se aplică

1. Verificați atributul de service pentru starea robinetului — dacă este la 0 %, deși temperatura dorită este setată peste temperatura curentă, robinetul poate necesita o nouă calibrare
2. Verificați dacă nu este activă o comandă manuală (prin inelul rotativ, aplicația Shelly sau `TRV.SetPosition` de la alt client) — scrierea unei temperaturi dorite prin termostatul TapHome reactivează reglarea automată, dar orice rotire locală a inelului de pe TRV are imediat prioritate
3. Verificați calitatea legăturii BLE — un RSSI sub −85 dBm cauzează adesea o latență suplimentară de 1–3 s și pierderea ocazională a comenzilor; luați în considerare amplasarea gateway-ului mai aproape de TRV (raza de acțiune în interior ≤ 10 m)

### Avertizare de actualizare a firmware-ului

Șablonul generează o avertizare de actualizare a firmware-ului când `$.update.has_update` este `true`. Actualizările de firmware pentru BLU TRV trebuie efectuate prin aplicația **Shelly Smart Control** — nu sunt disponibile prin RPC local.

> [!TIP]
> Latența BLE dus-întors dintre gateway și TRV este de obicei de 1–3 secunde. Șablonul interoghează gateway-ul la fiecare 3000 ms, un interval deja apropiat de minimul practic — reducerea lui în continuare mărește coliziunile BLE fără a îmbunătăți timpul de răspuns.

## Cum se instalează în TapHome

### Cerințe preliminare

- Dispozitiv Shelly instalat și pornit
- Rețea Wi-Fi locală (2,4 GHz)
- TapHome CCU în aceeași rețea

### Pasul 1 — Conectați dispozitivul Shelly la Wi-Fi

**Varianta A — aplicația Shelly (recomandat):**

1. Descărcați [aplicația Shelly](https://www.shelly.com/en/support/shelly-app) (iOS / Android)
2. Atingeți **+** → **Add Device** și urmați asistentul de împerechere prin Bluetooth
3. Introduceți datele de conectare la Wi-Fi când vi se solicită

**Varianta B — modul AP (fără aplicație):**

1. La prima pornire, dispozitivul creează un hotspot: `ShellyXXX-AABBCCDDEE`
2. Conectați telefonul/PC-ul la acest hotspot
3. Deschideți `http://192.168.33.1` → **Internet & Security** → **Wi-Fi Mode - Client**
4. Introduceți SSID-ul și parola → **Save**

> [!NOTE]
> Shelly acceptă doar rețele de **2,4 GHz**. Rețelele de 5 GHz nu vor apărea la scanare.

### Pasul 2 — Găsiți adresa dispozitivului

Dispozitivele Shelly Gen1 acceptă **mDNS** (Zeroconf). Puteți accesa dispozitivul folosind un nume de gazdă în locul adresei IP:

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

De exemplu: `shelly1pm-AABBCCDDEE.local` (adresa MAC în hexazecimal cu majuscule, fără două puncte).

> [!TIP]
> **Recomandat: folosiți Scanner IP din TapHome.** Deschideți aplicația TapHome și folosiți **Scanner IP** (Setări → Rețea → Scanare). Scannerul descoperă dispozitivele din rețea și afișează atât adresa IP, cât și numele de gazdă mDNS. Pentru o conexiune mai fiabilă folosiți **numele de gazdă** în locul adresei IP — acesta rămâne același chiar dacă adresa IP a dispozitivului se schimbă după o repornire a routerului.

**Metode alternative** pentru aflarea adresei IP:

- **Aplicația Shelly:** detaliile dispozitivului → **Device info** → adresa IP
- **Interfața web Shelly:** conectați-vă la AP-ul dispozitivului înainte de configurarea Wi-Fi — adresa IP se afișează după salvare
- **Tabelul DHCP al routerului:** căutați un nume de gazdă de forma `shelly1pm-AABBCCDDEE`

### Pasul 3 — Configurați dispozitivul în TapHome

1. În TapHome adăugați un nou modul **Packet Parser (HTTP)**
2. **Address:** introduceți numele de gazdă mDNS (de ex. `shelly1pm-AABBCCDDEE.local`) sau adresa IP de la pasul 2
3. **Port:** `80` (implicit, nu este necesară nicio modificare)
4. Importați șablonul — TapHome va interoga periodic `/status` pentru a citi starea dispozitivului

> [!NOTE]
> Autentificarea HTTP este dezactivată implicit pe dispozitivele Shelly. Dacă ați activat protecția prin autentificare, rețineți că TapHome nu acceptă momentan HTTP Basic Auth — pentru integrarea cu TapHome lăsați autentificarea dezactivată.

## Dispozitive disponibile 2

Aceste dispozitive apar în TapHome după import.

Shelly BLU TRV Modul

Atribute de service

|                                |                                                                       |
|--------------------------------|-----------------------------------------------------------------------|
| Puterea semnalului recepționat | Puterea semnalului legăturii Bluetooth LE dintre gateway și TRV (dBm) |

Acțiuni de service

|           |                                                                                                                              |
|-----------|------------------------------------------------------------------------------------------------------------------------------|
| Repornire |                                                                                                                              |
| Calibrare | Efectuează calibrarea motorului pas cu pas (până la 10 secunde); necesară după prima montare sau după schimbarea adaptorului |

Variabile personalizate

`ID` (numeric) = ID ID-ul componentei BLU TRV pe gateway (atribuit la împerechere, de obicei 200+)

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

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

Atribute de service

Received signal strength

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

Acțiuni de service

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 Comutator cu mai multe valori Doar citire

Indicator de stare a bateriei — Critic (&lt;25 %), Slab (25-50 %), Normal (50-75 %), Plin (&gt;75 %), Încărcare

numeric Unitate: % numeric

Valori / Stări: Critical · Low · Normal · Full · Charging

Citirea stării comutatorului

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

Atribute de service

Value \[%]

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

Termostat Termostat Citire și scriere

Cap termostatic pentru calorifer — citește temperatura curentă și scrie valoarea setată (4-31 °C) prin BLU Gateway Gen3

numeric Unitate: °C

Atribute de service

|                    |                                                                                     |
|--------------------|-------------------------------------------------------------------------------------|
| Stare robinet \[%] | Poziția curentă de deschidere a robinetului (0 % = închis, 100 % = complet deschis) |

Citirea temperaturii

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

Citirea temperaturii dorite

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

Scrierea temperaturii dorite

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

Atribute de service

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

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

**Conexiune:** Packet Parser → HTTP • Nume gazdă: `shellyblugwg3-{MAC}.local`

Îmbunătățiri posibile (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 de import

Introduceți aceste valori când importați XML-ul.

| Solicitat în aplicație | Implicit      |
|------------------------|---------------|
| Adresă IP              | `192.168.0.1` |
| Id                     | `200`         |

## Surse

- 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

## Documentație asociată

- [Packet Parser Integration](https://taphome.com/ro/compatibility/packet-parser-guide/)
- [Packet Parser (HTTP, TCP, UDP, FTP, MQTT)](https://taphome.com/ro/docs/integration/packet-parser/)
- [Funcții Packet parser](https://taphome.com/ro/docs/script/packet-parser/)
- [Funcții de parsare](https://taphome.com/ro/docs/script/parsing-functions/)

