TapHome

Shelly BLU TRV

Packet Parser → HTTP
Autor
Posljednje ažuriranje: 04. 2026

Potreban je vanjski pristupnik (gateway)

Shelly BLU Gateway Gen3 — stranica proizvoda

Ovaj uređaj podržava mDNS

Umjesto IP adrese uređaju možete pristupiti na adresi:

shellyblugwg3-{MAC}.local

Zamijenite {MAC} MAC adresom svog uređaja (velika slova, bez dvotočaka).

TapHome podržava mDNS. Naziv računala (hostname) pouzdaniji je od statične IP adrese.

Shelly BLU TRV

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
ParametarOpisKako ga dobitiPrimjer
IpAddressIP adresa pristupnika u lokalnoj mrežiAplikacija Shelly Smart Control → Gateway → Settings → Network ili tablica DHCP zakupa u usmjerivaču192.168.0.42
IDID komponente BluTrv ove glave na pristupnikuWeb-sučelje pristupnika (http://<gateway-ip>) → popis Components → kopirajte brojčani ID dodijeljen ovoj glavi200

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

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

StanjeRazina baterijeIkona
Kritična< 25 %Baterija gotovo prazna
Niska25–50 %Slaba baterija
Normalna50–75 %Baterija napola puna
Puna> 75 %Puna baterija
PunjenjePunjenje (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.

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

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:

1

shelly<model>-<MAC>.local

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

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

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

Shelly BLU TRV Modul
Servisni atributi
Jačina primljenog signalaJačina signala Bluetooth LE veze između pristupnika i glave TRV (dBm)
Servisne radnje
Ponovno pokretanje
KalibrirajPokreće kalibraciju koračnog motora (do 10 sekundi); potrebna je nakon prve ugradnje ili zamjene adaptera
Prilagođene varijable
ID (numeric) = IDID 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

Shelly BLU TRV

Čitanje (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
Servisni atributi
Received signal strength
PARSEJSON(Status, "$.rssi")
Servisne radnje
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));
Baterija Prekidač s više vrijednosti Samo za čitanje

Pokazatelj stanja baterije — Kritična (<25 %), Niska (25–50 %), Normalna (50–75 %), Puna (>75 %), Punjenje

numeric Jedinica: % numeric
Vrijednosti / stanja: Critical · Low · Normal · Full · Charging

Baterija

Čitanje stanja sklopke
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 [%]
PARSEJSON(Status, "$.battery");
Termostat Termostat

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)

Termostat

Čitanje temperature
PARSEJSON(RemoteStatus, "$.status.trv:0.current_C")
Čitanje željene temperature
PARSEJSON(RemoteStatus, "$.status.trv:0.target_C")
Zapis željene temperature
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} [%]
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.

Izvori

Pronašli ste problem s ovim predloškom uređaja?

Recite nam što ne radi, što nedostaje ili kako bi se predložak trebao ponašati. Vaše povratne informacije pomažu nam da katalog bude točan.

Provjerio TapHome

Želite ovo koristiti u svojoj centralnoj jedinici TapHome Core?

Otvorite ovaj predložak na portalu Customer Portal kako biste ga primijenili na jedan od svojih domova ili predložili poboljšanje i poslali ga natrag u katalog.

Otvorite na portalu