Shelly TRV (SHTRV-01) je batériovo napájaná Wi-Fi termostatická radiátorová hlavica od Allterco Robotics. Nasadzuje sa priamo na teleso ventilu bežného teplovodného radiátora a prietok teplej vody radiátorom mení pohybom kolíka ventilu cez vstavaný motor. TapHome komunikuje so zariadením cez HTTP na lokálnej sieti — bez brány, bez cloudu, bez MQTT brokera.
Táto šablóna vystavuje polohu ventilu ako samostatné zariadenie Valve state, aby ventil mohol priamo riadiť smart rule v TapHome. Vlastná regulácia teploty zariadenia je vypnutá: každý setpoint zapísaný z TapHome sa odosiela spolu s target_t_enabled=false, takže firmware už ventilom sám nepohybuje.
Shelly TRV je ukončený produkt a nahradila ho Bluetooth verzia Shelly BLU TRV. Existujúce kusy fungujú naďalej a táto šablóna zostáva plne podporovaná; pre nové projekty zvážte nástupcu.
Pre to isté fyzické zariadenie sú k dispozícii dve alternatívne šablóny — vyberte podľa zamýšľaného spôsobu riadenia.
| Šablóna | Vystavuje | Použitie |
|---|---|---|
| Shelly TRV (hlavná) | Batériu + termostat s uzavretou slučkou | Riadenie izbovej teploty koncovým používateľom cez setpoint (5-30 °C). Firmware riadi ventil interne. |
| Shelly TRV (valve) (táto šablóna) | Batériu + dimmer ventilu + termostat (variant pre setpoint) | Smart rules, ktoré potrebujú priamo riadiť ventil — poloha ventilu je vystavená ako dimmer 0-100 %, automatická regulácia je vypnutá. |
Neimportujte obe šablóny pre to isté fyzické zariadenie. Obe sa viažu na rovnaký endpoint a slučky pollingu budú kolidovať — zápisy sa budú navzájom rušiť a správanie ventilu bude nepredvídateľné.
Inštalácia hardvéru
Shelly TRV nemá žiadne zapojenie — je to mechanická radiátorová hlavica s internou elektronikou, napájaná vstavanou nabíjateľnou batériou (Panasonic NCR18650BD, 3,6 V / 6500 mAh). Na teleso ventilu radiátora sa nasadzuje cez kovovú pridržiavaciu maticu. Zariadenie je určené len na použitie vo vnútri a musí byť chránené pred nečistotami, vlhkosťou a striekajúcou vodou.
Kompatibilné telesá ventilov
Ak má radiátor už termostatickú hlavicu (typicky otočný ovládač s číslami 1 až 5), teleso ventilu je s najväčšou pravdepodobnosťou kompatibilné. Radiátory s malými manuálnymi ventilmi — bežné tam, kde je nainštalovaný samostatný izbový alebo centrálny termostat — kompatibilné nie sú.
Pôvodný závit: M30 × 1,5. V balení sú nasledujúce adaptéry:
- Danfoss — RA, RAV, RAVL
- Caleffi
- Giacomini
- M28 × 1,5 — Sam, Slovarm, Comap, TA, Herz, MMA, Remagg
- Pont à Mousson
Adaptéry tretích strán (nie sú v balení) rozširujú kompatibilitu na Gampper, Ista, Meges, Ondal, Oventrop, Rossweiner, Vaillant a ďalšie.
Postup montáže
- Uistite sa, že radiátor je vypnutý a vychladnutý.
- Otočte existujúcu hlavicu ventilu proti smeru hodinových ručičiek, kým nie je ventil úplne otvorený, potom odskrutkujte kovovú maticu proti smeru hodinových ručičiek a hlavicu zložte.
- Ak závit ventilu nie je pôvodný M30 × 1,5, nasaďte správny adaptér.
- Nasaďte Shelly TRV na teleso ventilu otáčaním kovovej matice v smere hodinových ručičiek — zatiaľ ju úplne nedoťahujte.
- Natočte displej do požadovanej orientácie a potom kovovú maticu úplne dotiahnite.
Po úplnom dotiahnutí kovovej matice sa zariadením nepokúšajte otáčať — môžete ho poškodiť.
Nabíjanie
Zariadenie sa nabíja cez USB-C nabíjačkou kompatibilnou s USB-C s prúdom aspoň 1 A. Pred prvým použitím ho nabíjajte do plna približne 7 hodín. Počas nabíjania bliká na displeji čiarka úrovne batérie a bodka pri spodnom riadku označuje pripojenú nabíjačku. Výdrž batérie je až 2 roky v závislosti od toho, ako často sa ventil pohybuje, a od kvality Wi-Fi signálu.
Počas nabíjania sa telo zariadenia zahrieva a interný teplotný senzor meria nesprávne. Kým je nabíjačka pripojená, počítajte so skreslenými hodnotami izbovej teploty.
Kalibrácia
Kalibrácia naučí motor zdvih konkrétneho telesa ventilu. Bez nej TapHome nedokáže polohu ventilu čítať ani zapisovať.
- Krátko stlačte Reset (zadná strana zariadenia). Displej zobrazí
CLa vnútorný motor sa otáča oboma smermi. - Úspešná kalibrácia sa končí zobrazením
APna displeji — zariadenie je pripravené na pripojenie k Wi-Fi. E1znamená, že kalibrácia zlyhala: matica nie je dostatočne dotiahnutá alebo zariadenie nie je správne usadené. Dotiahnite maticu alebo zariadenie znova nasaďte, potom podržte Up alebo Down 3 sekundy a niekoľkokrát stlačte Down, čím spustíte novú kalibráciu.
Keď je zariadenie v TapHome, nový kalibračný cyklus sa dá spustiť aj servisnou akciou Calibrate na module.
Kalibráciu zopakujte po každom presadení na iné teleso ventilu. Kým zariadenie nehlási
calibrated=true, zariadenie Valve state zobrazujeDevice is not calibrateda TapHome odmieta zápis polohy ventilu aj setpointu.
Nastavenie siete
Shelly TRV používa Wi-Fi 2,4 GHz (802.11 b/g/n) s dosahom až 30 m v závislosti od konštrukcie budovy. Po kalibrácii sa spustí v režime Access Point (AP na displeji).
Ak zariadenie do 3 minút nepridáte do Wi-Fi siete, vypne sa. Znova ho spustíte krátkym stlačením Reset.
Pripojenie k Wi-Fi
Zariadenie sa dá pripojiť cez mobilnú aplikáciu Shelly Cloud alebo ručne cez jeho vstavané webové rozhranie:
- Pripojte telefón alebo počítač k Wi-Fi sieti, ktorú vytvorilo zariadenie, a otvorte
http://192.168.33.1. - Kliknite na Internet & Security a vyberte WIFI MODE - CLIENT.
- Zaškrtnite Connect the Shelly device to an existing WiFi Network, zadajte názov siete a heslo a stlačte SAVE.
- Nájdite IP adresu zariadenia v lokálnej sieti (zoznam klientov v routeri alebo nástroj Shelly device finder pre Windows či macOS).
Zapnutím režimu Client sa režim Access Point vypne. Do režimu Access Point sa vrátite podržaním Reset na 5 sekúnd.
Rezervácia DHCP pre zariadenie v routeri udrží IP adresu, ktorú používa TapHome, stabilnú.
Autentifikácia
Šablóna posiela HTTP požiadavky bez prihlasovacích údajov na porte 80; HTTPS zariadenia Gen1 nepodporujú. Ak je vo webovom rozhraní zariadenia zapnutá ochrana prihlásením, vypnite ju — inak TapHome zariadenie nedokáže čítať ani ovládať.
Konfigurácia
V TapHome importujte šablónu a ako jediný parameter importu zadajte IP adresu zariadenia, potom vytvorte smart rule, ktorý riadi zariadenie Valve state.
Vypnutie týždenného rozvrhu
Shelly TRV má vstavaný týždenný plánovač (5 profilov, až 20 zmien teploty na profil). Keď je rozvrh aktívny, firmware pri najbližšej plánovanej zmene prepíše akýkoľvek externe zapísaný setpoint.
Šablóna to hlási ako chybu modulu (Schedule is enabled). Pred odovzdaním zariadenia pod riadenie TapHome buď:
- spustite servisnú akciu Disable schedule na module (pošle
/settings/thermostats/0?schedule=false), alebo - vo webovom rozhraní zariadenia alebo v aplikácii Shelly Cloud vyberte v časti Weekly schedule profil Disable.
Automatické riadenie ventilu
Zariadenie Valve state aj zariadenie Thermostat zobrazujú upozornenie Automatic valve control is on vždy, keď zariadenie hlási svoju vlastnú reguláciu teploty ako aktívnu, pretože môže kolidovať s činnosťou smart rule. Zápis setpointu zo zariadenia Thermostat ju znova vypne (target_t_enabled=false).
Externý izbový senzor (odporúčané)
Každý termostat namontovaný na radiátore meria blízko radiátora, takže vstavaný senzor sa odchyľuje od skutočnej izbovej teploty. K dispozícii sú dve cesty korekcie:
- Externý senzor — Shelly H&T alebo kompatibilný senzor v miestnosti môže posielať okolitú teplotu do TRV. Zapnite to vo webovom rozhraní zariadenia → Sensor Settings → TEMPERATURE OFFSET → Enable external temperature corrections endpoint.
- Statický ofset — na kompenzáciu konštantnej odchýlky použite servisnú akciu Set temperature offset na zariadení Thermostat (rozsah ±20 °C).
Možnosti zariadenia
Šablóna vystavuje zariadenie ako indikátor batérie, dimmer polohy ventilu a termostat. Diagnostika a akcie na úrovni modulu sú rovnaké ako v hlavnej šablóne.
Valve state
Aktuátor ventilu je vystavený ako dimmer (0-100 %). TapHome číta polohu z thermostats[0].pos a zapisuje ju cez /thermostats/0?pos={0-100}; firmware presunie motor do požadovanej polohy. Záporná poloha znamená, že ventil nie je kalibrovaný, a zariadenie zobrazí Device is not calibrated.
Servisné atribúty hlásia Force close, Extra pressure a Automatic calibration correction. Servisné akcie prepínajú režim núteného zatvorenia (ventil zostane úplne zatvorený) a režim extra tlaku (silnejšie ovládanie pre tuhé ventily), aby smart rules zvládli scenáre ako núdzové zatvorenie, predhrievanie alebo boost sekvencie.
Thermostat
Termostat číta nameranú izbovú teplotu (thermostats[0].tmp.value) a uložený cieľ (thermostats[0].target_t.value). Zápis setpointu posiela obe hodnoty target_t aj target_t_enabled=false na /settings/thermostats/0, takže firmware ventilom sám nepohybuje — setpoint slúži ako referenčná hodnota pre smart rule, ktorý riadi zariadenie Valve state.
Jediný servisný atribút je Temperature offset [°C] so zodpovedajúcou akciou Set temperature offset. Keď je hodnota zo senzora neplatná, zariadenie pridá chybu Temperature sensor error.
Stav batérie
Batéria je vystavená ako prepínač s viacerými hodnotami odvodený z hlásenej úrovne nabitia a stavu nabíjačky. Stav nabíjačky má prednosť pred úrovňou:
| Stav | Podmienka |
|---|---|
| Critical | bat.value 25 % alebo menej |
| Low | bat.value 26-50 % |
| Normal | bat.value 51-75 % |
| Full | bat.value nad 75 % |
| Charging | nabíjačka pripojená |
Dva servisné atribúty hlásia surové nabitie batérie (%) a napätie (V). Modul vyvolá Low battery pod 50 % a Battery charge is criticaly low pod 25 %.
Diagnostika a akcie modulu
Modul polluje /status a /settings každé 3 sekundy a vystavuje diagnostiku a akcie pre celé zariadenie:
- Diagnostika: Wi-Fi SSID, IP adresa, MAC, sila prijímaného signálu, stav kalibrácie, zapnutie/vypnutie rozvrhu, jas displeja (1-7) a stav otočenia displeja. Keď je k dispozícii aktualizácia firmvéru, zobrazí sa upozornenie.
- Akcie: Disable schedule, Reboot, Calibrate (spúšťa
/calibrate), Update firmware (stiahneSHTRV-01_build.gblz oficiálneho firmvérového servera Shelly EU), Set display brightness a Flip display.
Riešenie problémov
Device is not calibrated
Zápisy polohy ventilu a setpointu sú odmietané s Device is not calibrated, kým TRV nedokončí úspešný kalibračný cyklus.
- Uistite sa, že zariadenie je pevne usadené na telese ventilu — matica musí byť dostatočne dotiahnutá, aby motor mohol tlačiť proti kolíku ventilu.
- Spustite servisnú akciu Calibrate na module alebo spustite kalibráciu na zariadení (podržte Up alebo Down 3 sekundy, potom niekoľkokrát stlačte Down). Kým sa motor pohybuje oboma smermi, displej zobrazuje
CL. - Pri úspechu sa atribút Calibrated zmení na
Yes;E1na displeji zvyčajne signalizuje nesprávnu montáž.
Ventil sa pohybuje, hoci ho žiadny smart rule nezmenil
Aktívna je vlastná regulácia zariadenia alebo týždenný rozvrh. Skontrolujte upozornenie Automatic valve control is on a atribút modulu Schedule — zapíšte setpoint zo zariadenia Thermostat, čím vypnete automatické riadenie, a ak je rozvrh zapnutý, spustite Disable schedule.
Izbová teplota je príliš vysoká
- Pripojená nabíjačka. Počas nabíjania sú hodnoty izbovej teploty neplatné. Odpojte USB-C a nechajte zariadenie vychladnúť.
- Odchýlka vstavaného senzora. Senzor je blízko radiátora. Zapnite endpoint externých korekcií teploty a spárujte Shelly H&T (alebo kompatibilný senzor) v tej istej miestnosti, alebo použite statický Set temperature offset.
Displej zobrazuje E1 / E2
Stav skontrolujete tak, že naraz podržíte Up a Down 5 sekúnd a listujete tlačidlami Up alebo Down.
E1— problém s kalibráciou. Zariadenie znova nasaďte, opatrne dotiahnite maticu a spustite nový kalibračný cyklus.E2— problém s teplotným senzorom. Šablóna pridá na zariadení Thermostat chybuTemperature sensor error. Ak problém pretrváva aj po reštarte, kontaktujte podporu Shelly.
Zariadenie je nedostupné
- Overte, že TRV je pripojený k Wi-Fi — podržte Up a Down 5 sekúnd a prelistujte parametre stavu;
COoznačuje pripojenie k Wi-Fi sieti,APznamená, že zariadenie je stále v režime Access Point. - Overte, že TapHome Core a TRV sú v rovnakej sieti / VLAN.
- Skúste namiesto IP adresy mDNS hostname (
shellytrv-XXXXXX.local) — DHCP lease sa mohol zmeniť. - Otvorte v prehliadači
http://{device-ip}/status. Ak príde JSON odpoveď, zariadenie je dostupné a problém je v konfigurácii TapHome.
Zariadenia Shelly Gen1 prijímajú iba 2 súbežné HTTP spojenia. Ak TapHome a iný systém pollujú to isté zariadenie naraz, komunikácia bude nespoľahlivá. Interval pollingu nechajte na predvolenej hodnote šablóny (3 s) a vyhnite sa ďalším pollerom.
Zapnutie MQTT na zariadeniach Shelly Gen1 vypne pripojenie k Shelly Cloud. TapHome používa len HTTP — MQTT nechajte vypnuté.