TapHome

Shelly BLU TRV

Packet Parser → HTTP
Trimis de
Ultima actualizare: 04. 2026

Necesită gateway extern

Shelly BLU Gateway Gen3 — pagina produsului

Acest dispozitiv acceptă mDNS

În loc să folosiți o adresă IP, puteți accesa dispozitivul la:

shellyblugwg3-{MAC}.local

Înlocuiți {MAC} cu adresa MAC a dispozitivului dvs. (majuscule, fără două puncte).

TapHome acceptă mDNS — folosirea unui nume de gazdă este mai fiabilă decât un IP static.

Shelly BLU TRV

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
ParametruDescriereCum se obțineExemplu
IpAddressAdresa IP a gateway-ului în rețeaua localăAplicația Shelly Smart Control → Gateway → Settings → Network sau tabelul de alocări DHCP din router192.168.0.42
IDID-ul componentei BluTrv a acestui TRV pe gatewayInterfața web a gateway-ului (http://<gateway-ip>) → lista Components → copiați ID-ul numeric atribuit acestui TRV200

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

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

StareNivelul baterieiPictogramă
Critic< 25 %Baterie aproape descărcată
Slab25–50 %Baterie slabă
Normal50–75 %Baterie la nivel mediu
Plin> 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.

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

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:

1

shelly<model>-<MAC>.local

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

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

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

Shelly BLU TRV Modul
Atribute de service
Puterea semnalului recepționatPuterea semnalului legăturii Bluetooth LE dintre gateway și TRV (dBm)
Acțiuni de service
Repornire
CalibrareEfectuează calibrarea motorului pas cu pas (până la 10 secunde); necesară după prima montare sau după schimbarea adaptorului
Variabile personalizate
ID (numeric) = IDID-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

Shelly BLU TRV

Citire (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
Atribute de service
Received signal strength
PARSEJSON(Status, "$.rssi")
Acțiuni de service
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 Comutator cu mai multe valori Doar citire

Indicator de stare a bateriei — Critic (<25 %), Slab (25-50 %), Normal (50-75 %), Plin (>75 %), Încărcare

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

Baterie

Citirea stării comutatorului
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 [%]
PARSEJSON(Status, "$.battery");
Termostat Termostat

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)

Termostat

Citirea temperaturii
PARSEJSON(RemoteStatus, "$.status.trv:0.current_C")
Citirea temperaturii dorite
PARSEJSON(RemoteStatus, "$.status.trv:0.target_C")
Scrierea temperaturii dorite
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} [%]
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.

Surse

Ați găsit o problemă la acest șablon de dispozitiv?

Spuneți-ne ce nu funcționează, ce lipsește sau cum ar trebui să se comporte șablonul. Feedbackul dvs. ne ajută să păstrăm catalogul corect.

Verificat de TapHome

Doriți să folosiți acest șablon în TapHome Core?

Deschideți acest șablon în Customer Portal pentru a-l aplica într-una dintre locuințele dvs. sau pentru a propune o îmbunătățire și a o trimite înapoi în catalog.

Deschideți în portal