
Shelly TRV (SHTRV-01) je Wi-Fi termostatska radijatorska glava na baterije tvrtke Allterco Robotics. Postavlja se izravno na tijelo standardnog radijatorskog ventila za toplu vodu i regulira sobnu temperaturu tako da unutarnjim motorom pomiče iglu ventila. TapHome s uređajem komunicira preko HTTP-a u lokalnoj mreži, bez pristupnika, bez oblaka i bez MQTT brokera.
Shelly TRV se više ne proizvodi, a naslijedila ga je glava Shelly BLU TRV s Bluetooth vezom. Postojeći uređaji i dalje rade i ovaj predložak ostaje u potpunosti podržan; za nove projekte razmislite o nasljedniku.
Za isti fizički uređaj dostupna su dva alternativna predloška. Odaberite jedan prema željenom načinu upravljanja.
| Predložak | Prikazuje | Primjena |
|---|---|---|
| Shelly TRV (glavni) | Baterija + termostat sa zatvorenom regulacijskom petljom | Korisničko upravljanje sobnom temperaturom preko zadane temperature (5–30 °C). Ventilom interno upravlja firmver. |
| Shelly TRV (valve) | Baterija + dimer ventila + termostat (varijanta za zadanu temperaturu) | Smart rules kojima treba izravno preuzimanje upravljanja ventilom: položaj ventila prikazuje se kao dimer 0,0–1,0. |
Ne uvozite oba predloška za isti fizički uređaj. Oba se vežu na istu krajnju točku pa bi se ciklusi očitavanja sudarali: upisi bi bili u sukobu, a ponašanje ventila postalo bi nepredvidivo.
Ugradnja uređaja
Shelly TRV nema ožičenje. To je mehanička radijatorska glava s unutarnjom elektronikom, napajana unutarnjom Li-ion baterijom (Panasonic NCR18650BD, 3,7 V / 6500 mAh). Postavlja se izravno na tijelo radijatorskog ventila pomoću metalnog pričvrsnog prstena.
Kompatibilna tijela ventila
Izvorni navoj: M30 × 1,5. U prodajnom pakiranju nalaze se ovi adapteri:
- Danfoss — RA, RAV, RAVL
- Caleffi
- Giacomini
- M28 × 1,5 — Sam, Slovarm, Comap, TA, Herz, MMA, Remagg
- Pont à Mousson
Adapteri drugih proizvođača (nisu priloženi) proširuju kompatibilnost na Gampper, Ista, Meges, Ondal, Oventrop, Rossweiner, Vaillant i druge.
Postupak ugradnje
- Provjerite je li radijator isključen i ohlađen.
- Postojeću ručnu glavu ventila okrenite suprotno od kazaljke na satu do potpunog otvaranja, a zatim odvijte metalni pričvrsni prsten i skinite je.
- Ako navoj ventila nije izvorni M30 × 1,5, postavite odgovarajući adapter.
- Postavite Shelly TRV na tijelo ventila i metalni prsten zategnite u smjeru kazaljke na satu, čvrsto, ali ne prejako. Kalibracija ne uspijeva ni kad je prsten prelabavo ni kad je prečvrsto zategnut.
- Prije konačnog zatezanja prstena okrenite zaslon u željeni položaj.
- Kratko pritisnite tipkalo Reset (na stražnjoj strani uređaja). Na zaslonu se prikazuje
CL(kalibracija), a unutarnji motor pomiče se u oba smjera. Uspješna kalibracija završava prikazomAPna zaslonu, a neuspješna prikazujeE1.
Kalibraciju treba provesti nakon svakog ponovnog postavljanja na drugo tijelo ventila. Dok nije
calibrated=true, upisi zadane temperature i položaja ventila iz sustava TapHome odbijaju se uz porukuDevice is not calibrated.
Punjenje
Uređaj se puni preko USB-C priključka (kabel je priložen, adapter nije). Punjač USB-C od najmanje 1 A napuni praznu bateriju do kraja za približno 5 sati. Tipično trajanje baterije je oko 2 godine (oko 5 mjeseci neprekidne sezone grijanja pri uobičajenoj upotrebi).
Tijekom punjenja kućište uređaja se zagrijava, a unutarnji senzor temperature mjeri netočno. Očekujte iskrivljene vrijednosti sobne temperature sve dok
chargernijedisconnected.
Konfiguracija
Uvoz u TapHome
Pri uvozu predloška TapHome traži samo jedan parametar:
| Parametar | Opis | Zadano |
|---|---|---|
IpAddress | Lokalna IP adresa ili mDNS naziv hosta uređaja | 192.168.0.1 |
Port 80 je fiksan. Gen1 ne podržava HTTPS. HTTP Basic Auth na uređaju mora biti isključena, jer TapHome HTTP zahtjeve prema uređajima Shelly Gen1 ne autentificira.
Kad god je moguće, koristite mDNS naziv hosta (shellytrv-XXXXXX.local), jer je otporan na promjene DHCP zakupa. IP Scanner u sustavu TapHome (Settings → Network → Scan) pronalazi i IP adresu i mDNS naziv hosta.
Isključivanje tjednog rasporeda
Shelly TRV ima ugrađeni tjedni raspored (5 profila, do 18 planiranih promjena tjedno po profilu). Kada je raspored uključen, firmver pri sljedećem planiranom događaju prepisuje svaku izvana upisanu zadanu temperaturu, pa se zadane temperature iz sustava TapHome bez upozorenja vraćaju.
Predložak to prikazuje kao upozorenje (Schedule is enabled). Prije nego što uređaj predate na upravljanje sustavu TapHome:
- pokrenite servisnu radnju Isključi raspored na modulu (šalje
/settings/thermostats/0?schedule=false) ili - odaberite profil Disable u aplikaciji Shelly Cloud ili u web-sučelju uređaja.
Vanjski sobni senzor (preporučeno)
Ugrađeni senzor temperature fizički je blizu vruće cijevi radijatora i obično pokazuje 1–3 °C više od stvarne sobne temperature. Dostupna su dva načina korekcije:
- Vanjski senzor — uparite zaseban Wi-Fi termometar (npr. Shelly H&T) preko web-sučelja uređaja → Sensor Settings → Enable external temperature corrections endpoint. Vanjski senzor tada šalje (POST) temperaturu prostorije glavi.
- Statički pomak — servisnom radnjom Postavi pomak temperature na uređaju Termostat (raspon ±20 °C) kompenzirajte stalno odstupanje.
Za najbolju toplinsku ugodnost kombinirajte pouzdan vanjski senzor s malim statičkim pomakom kao rezervom.
Mogućnosti uređaja
Glavni predložak prikazuje uređaj kao pokazatelj baterije i termostat sa zatvorenom regulacijskom petljom. Predložak za ventil zadržava isti modul i bateriju, ali položaj ventila prikazuje kao dimer i koristi varijantu za zadanu temperaturu koja pri upisu isključuje automatsku PID regulaciju. Dijagnostika i radnje na razini modula jednake su u oba predloška.
Stanje baterije
Baterija se prikazuje kao prekidač s više vrijednosti izveden iz javljene razine napunjenosti i stanja USB-C punjača. Stanje punjača ima prednost pred razinom:
| Stanje | Uvjet |
|---|---|
| Kritična | bat.value < 25 |
| Niska | bat.value 25-50 |
| Normalna | bat.value 50-75 |
| Puna | bat.value > 75 |
| Punjenje | charger != disconnected |
Dva dodatna servisna atributa javljaju neobrađenu vrijednost napunjenosti baterije (%) i napon ćelije (V, nazivno oko 3,7 V, tipični raspon 2,6–4,2 V). Predložak javlja Low battery ispod 50 % i Battery charge is critically low ispod 25 %.
Termostat (glavni predložak)
Sobni termostat sa zatvorenom regulacijskom petljom: TapHome upisuje zadanu temperaturu, a firmver glave interno upravlja položajem ventila na temelju ugrađenog (ili vanjskog) senzora temperature.
- Čitanje: izmjerena sobna temperatura (
thermostats[0].tmp.value) i aktivna zadana temperatura (thermostats[0].target_t.value) - Upis: zadana temperatura 5–30 °C preko
/settings/thermostats/0?target_t={Se}
Dodatni atributi termostata su Pomak temperature [°C], Položaj ventila [%] (samo za čitanje, za uvid u izlaz PID regulatora), Prisilno zatvaranje, Dodatni pritisak i Automatska korekcija kalibracije. Odgovarajuće servisne radnje omogućuju sustavu TapHome postavljanje pomaka, uključivanje i isključivanje načina prisilnog zatvaranja (ventil ostaje potpuno zatvoren bez obzira na zadanu temperaturu) i načina dodatnog pritiska (pojačava pokretanje krutih ventila).
Upisi zadane temperature ne uspijevaju s porukom Device is not calibrated dok je calibrated=false, a predložak dodaje upozorenje kada je tjedni raspored uključen (jer će firmver pri sljedećem događaju rasporeda prepisati vanjske upise).
Dimer ventila (predložak za ventil)
Alternativni predložak prikazuje pogon ventila izravno kao dimer (0,0–1,0 → 0–100 %). TapHome upisuje položaj preko /thermostats/0?pos={Le*100}. Firmver pomiče motor u traženi položaj i pritom implicitno isključuje automatsku regulaciju prema zadanoj temperaturi.
Predložak za ventil na uređaju ventila dodaje servisne atribute Force close, Extra pressure i Automatic calibration correction (uz odgovarajuće radnje za uključivanje i isključivanje), tako da autori smart rules mogu izravno upravljati motorom u scenarijima kao što su hitno zatvaranje, ručno predgrijavanje ili pojačano grijanje (boost).
Termostat (varijanta predloška za ventil)
Predložak za ventil i dalje prikazuje termostat, kako bi se zadana temperatura mogla upisivati iz iste grupe uređaja TapHome, ali njegova skripta upisa šalje i target_t i target_t_enabled=false, kako PID regulacija u firmveru ne bi ometala ručno upravljanje ventilom. Skup servisnih atributa sveden je na Pomak temperature [°C] (atributi tijela ventila kao što su force_close i valve_state premješteni su na uređaj ventila). Predložak upozorava kada uoči target_t.enabled=true, jer to znači sukob između dimera ventila i automatske regulacije.
Dijagnostika i radnje modula
Modul (glava) očitava /status i /settings svake 3 sekunde i prikazuje dijagnostiku i radnje za cijeli uređaj:
- Dijagnostika: Wi-Fi SSID, IP adresa, MAC, jačina primljenog signala (RSSI u dBm), stanje kalibracije, raspored uključen/isključen, svjetlina zaslona (1–7) i stanje okrenutog zaslona.
- Radnje: Isključi raspored, Ponovno pokretanje, Kalibriraj (pokreće
/calibrate), Ažuriraj firmver (preuzimaSHTRV-01_build.gblsa službenog poslužitelja firmvera Shelly EU), Postavi svjetlinu zaslona i Okreni zaslon.
Dodatne mogućnosti
Uređaj nudi još nekoliko funkcija Gen1 koje trenutačni predlošci još ne prikazuju: pasivno prepoznavanje otvorenog prozora (/window), simetričnu radnju Force open, rezervnu temperaturu prostorije (auto_temp), zaštitu od djece, odgodu automatskog zatvaranja pri otvorenom prozoru, senzor planirane zadane temperature (schedule_t), indeks aktivnog profila, preostale minute pojačanog grijanja i radnju Trigger boost (/thermostats/0?boost_minutes=N), toplinsko stanje unutarnje elektronike (tmp_state) te dostupnost ažuriranja firmvera kao senzor. CoIoT push i MQTT prijenos podržani su na razini uređaja, ali se ne koriste: TapHome umjesto toga očitava /status svake 3 s. Te se funkcije mogu dodati u budućem ažuriranju predloška.
Rješavanje problema
Device is not calibrated
Svaki upis zadane temperature i položaja ventila vraća Device is not calibrated sve dok glava ne završi uspješan ciklus kalibracije.
- Provjerite sjedi li uređaj čvrsto na tijelu ventila. Pričvrsni prsten mora biti dovoljno zategnut da motor može pritisnuti iglu ventila, ali ne toliko da se deformira.
- Pokrenite servisnu radnju Kalibriraj na modulu (šalje
/calibrate). Na zaslonu se nakratko prikazujeCLdok se motor pomiče u oba smjera. - Nakon uspjeha
calibratedpostajetruei upisi uspijevaju. Neuspjeh se prikazuje kaoE1na zaslonu i obično znači neispravnu ugradnju.
Zadana temperatura se vraća svakih nekoliko sati
To tjedni raspored prepisuje vanjske upise. Provjerite servisni atribut Raspored: ako je uključen, pokrenite radnju Isključi raspored na modulu ili isključite aktivni profil u aplikaciji Shelly Cloud.
Sobna temperatura je previsoka
Dva česta uzroka:
- Spojen punjač. Očitanja sobne temperature nisu valjana dok je
charger != disconnected. Odspojite USB-C i pustite uređaj da se ohladi. - Odstupanje ugrađenog senzora. Senzor je blizu vrućih cijevi i obično pokazuje 1–3 °C više. Uključite krajnju točku za vanjske korekcije temperature i uparite Shelly H&T (ili kompatibilan Wi-Fi termometar) u istoj prostoriji ili postavite statički pomak radnjom Postavi pomak temperature (npr.
-1.5 °C).
Zaslon prikazuje E1 / E2
E1 — problem s kalibracijom. Ponovno postavite uređaj, pažljivo zategnite prsten i pokrenite novi ciklus kalibracije.
E2 — problem sa senzorom temperature. tmp.is_valid u /status postaje false, a predložak dodaje grešku Temperature sensor error. Ako problem ostane i nakon ponovnog pokretanja, senzor je vjerojatno neispravan; obratite se podršci tvrtke Shelly.
Uređaj nije dostupan
- Provjerite je li glava spojena na Wi-Fi: držite Up + Down 5 s i prođite kroz parametre stanja;
COznači spojen Wi-Fi klijent. - Provjerite jesu li centralna jedinica TapHome (CCU) i glava u istoj mreži / VLAN-u, jer Shelly Gen1 prema zadanim postavkama ne usmjerava promet između podmreža.
- Umjesto IP adrese pokušajte s mDNS nazivom hosta (
shellytrv-XXXXXX.local), jer se DHCP zakup možda promijenio. - U pregledniku otvorite
http://{device-ip}/status. Ako stigne JSON odgovor, uređaj je dostupan, a problem je u konfiguraciji sustava TapHome.
Uređaji Shelly Gen1 prihvaćaju samo 2 istodobne HTTP veze. Ako TapHome i drugi sustav (Home Assistant, Node-RED) istodobno očitavaju isti uređaj, komunikacija postaje nepouzdana. Interval očitavanja ostavite na zadanoj vrijednosti predloška (3 s) i izbjegavajte dodatna očitavanja iz drugih sustava.
Uključivanje MQTT-a na uređajima Shelly Gen1 nepovratno isključuje Shelly Cloud. TapHome koristi samo HTTP; MQTT ostavite isključen, osim ako izričito ne želite prijeći sa Shelly Clouda.