
Shelly TRV (SHTRV-01) je batériovo napájaná Wi-Fi termostatická radiátorová hlavica od Allterco Robotics. Nasadzuje sa priamo na teleso bežného ventilu teplovodného radiátora a reguluje izbovú teplotu 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.
Shelly TRV je ukončený produkt a bol nahradený Bluetooth verziou Shelly BLU TRV. Existujúce kusy fungujú naďalej a táto šablóna zostáva plne podporovaná; pre nové projekty zváž nástupcu.
Pre to isté fyzické zariadenie sú k dispozícii dve alternatívne šablóny — vyber podľa želaného spôsobu riadenia.
| Šablóna | Vystavuje | Použitie |
|---|---|---|
| Shelly TRV (main) | 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) | Batériu + dimmer ventilu + termostat (variant pre setpoint) | Smart pravidlá, ktoré potrebujú priame prebitie ventilu — poloha ventilu vystavená ako dimmer 0.0-1.0. |
Neimportuj obe šablóny pre to isté fyzické zariadenie. Obe sa viažu na rovnaký endpoint a polling slučky 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 Li-ion batériou (Panasonic NCR18650BD, 3,7 V / 6500 mAh). Nasadzuje sa priamo na teleso ventilu cez kovovú pridržiavaciu maticu.
Kompatibilné telesá ventilov
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
- Uisti sa, že radiátor je vypnutý a vychladnutý.
- Otoč existujúcu manuálnu hlavicu proti smeru hodinových ručičiek až na doraz (plne otvorené), potom odskrutkuj kovovú pridržiavaciu maticu a zlož hlavicu.
- Nasadzí správny adaptér, ak závit ventilu nie je pôvodný M30 × 1,5.
- Nasaď Shelly TRV na teleso ventilu a dotiahni kovovú maticu v smere hodinových ručičiek — pevne, ale neprešrubovať. Príliš voľné aj príliš pevné utiahnutie spôsobí zlyhanie kalibrácie.
- Pred úplným dotiahnutím matice natoč displej do požadovanej orientácie.
- Krátko stlač Reset (zadná strana zariadenia). Displej zobrazí
CL(kalibrácia) a vnútorný motor sa pohybuje oboma smermi. Úspešná kalibrácia sa ukončí zobrazenímAPna displeji; neúspech zobrazíE1.
Kalibráciu treba vykonať po každom presadení na iné teleso ventilu. Dokým
calibrated=true, TapHome zápisy setpointu a polohy sú odmietané s chybouDevice is not calibrated.
Nabíjanie
Zariadenie sa nabíja cez USB-C (kábel je v balení, adaptér nie). USB-C nabíjačka ≥1 A nabije batériu z prázdnej na plnú približne za 5 hodín. Typická výdrž batérie je ~2 roky (~5 mesiacov súvislej vykurovacej sezóny pri bežnom použití).
Počas nabíjania sa telo zariadenia zahrieva a interný teplotný senzor číta nesprávne. Kým
chargernie jedisconnected, počítaj so skreslenými hodnotami izbovej teploty.
Konfigurácia
TapHome import
Počas importu šablóny TapHome pýta jediný parameter:
| Parameter | Popis | Predvolená |
|---|---|---|
IpAddress | Lokálna IP adresa alebo mDNS hostname zariadenia | 192.168.0.1 |
Port 80 je fixný. HTTPS Gen1 nepodporuje. HTTP Basic Auth musí byť na zariadení vypnutá — TapHome sa voči Gen1 Shelly zariadeniam neautentifikuje.
Kde je to možné, používaj mDNS hostname (shellytrv-XXXXXX.local) — je odolný voči zmene DHCP leasu. TapHome IP Scanner (Nastavenia → Sieť → Sken) objaví aj IP aj mDNS hostname.
Vypnutie týždenného rozvrhu
Shelly TRV má vstavaný týždenný plánovač (5 profilov, až 18 plánovaných zmien za týždeň na profil). Ak je rozvrh zapnutý, firmware prepíše akýkoľvek externe zapísaný setpoint pri najbližšej plánovanej udalosti — TapHome setpointy sú ticho vrátené.
Šablóna túto skutočnosť vystavuje ako upozornenie (Schedule is enabled). Pred prevzatím riadenia TapHome buď:
- spusti akciu Disable schedule na module (pošle
/settings/thermostats/0?schedule=false), alebo - v Shelly Cloud apke alebo Web UI zariadenia vyber profil Disable.
Externý izbový senzor (odporúčané)
Vstavaný teplotný senzor je fyzicky blízko horúcej rúrky radiátora a typicky číta 1-3 °C vyššie než skutočná izbová teplota. K dispozícii sú dve opravné cesty:
- Externý senzor — spáruj samostatný Wi-Fi teplomer (napr. Shelly H&T) cez Web UI zariadenia → Sensor Settings → Enable external temperature corrections endpoint. Externý senzor potom posiela okolitú teplotu POST volaním na TRV.
- Statický ofset — použi akciu Set temperature offset na zariadení Thermostat (rozsah ±20 °C) na kompenzáciu konštantného skreslenia.
Pre najlepší tepelný komfort kombinuj spoľahlivý externý senzor s malým statickým ofsetom ako záloha.
Možnosti zariadenia
Hlavná šablóna vystavuje zariadenie ako indikátor batérie plus termostat s uzavretou slučkou. Valve šablóna zachováva rovnaký modul a batériu, ale vystavuje polohu ventilu ako dimmer a používa variant setpointu, ktorý pri zápise vypne automatickú PID reguláciu. Modulové diagnostiky a akcie sú identické pre obe šablóny.
Stav batérie
Batéria je vystavená ako prepínač s viacerými hodnotami odvodený z nahlásenej úrovne nabitia a stavu USB-C nabíjačky. Stav nabíjačky má prednosť pred úrovňou:
| Stav | Podmienka |
|---|---|
| Critical | bat.value < 25 |
| Low | bat.value 25-50 |
| Normal | bat.value 50-75 |
| Full | bat.value > 75 |
| Charging | charger != disconnected |
Dve doplnkové service atribúty hlásia surovú úroveň nabitia batérie (%) a napätie článku (V, nominálne ~3,7 V, typický rozsah 2,6-4,2 V). Šablóna vyvolá Low battery pri <50 % a Battery charge is critically low pri <25 %.
Termostat (main šablóna)
Termostat s uzavretou slučkou: TapHome zapíše cieľový setpoint a firmware TRV interne riadi polohu ventilu na základe vstavaného (alebo externého) teplotného senzora.
- Čítanie: nameraná izbová teplota (
thermostats[0].tmp.value) a aktívny cieľ (thermostats[0].target_t.value) - Zápis: setpoint 5-30 °C cez
/settings/thermostats/0?target_t={Se}
Doplnkové atribúty termostatu zahŕňajú Temperature offset [°C], Valve position [%] (len na čítanie, pre viditeľnosť PID výstupu), Force close, Extra pressure a Automatic calibration correction. Zodpovedajúce service akcie umožňujú TapHome nastaviť ofset, prepnúť režim núteného zatvorenia (ventil zostane plne zatvorený bez ohľadu na setpoint) a prepnúť režim extra tlaku (zosilňuje aktuáciu pre tuhé ventily).
Zápisy setpointu zlyhávajú s Device is not calibrated, kým calibrated=false, a šablóna pridáva upozornenie, keď je povolený týždenný rozvrh (pretože firmware prepíše externé zápisy pri najbližšej udalosti rozvrhu).
Dimmer ventilu (valve šablóna)
Alternatívna šablóna vystavuje aktuátor ventilu priamo ako dimmer zariadenie (0.0-1.0 → 0-100 %). TapHome zapisuje polohu cez /thermostats/0?pos={Le*100} — firmware presunie motor na požadovanú polohu a implicitne vypne automatické riadenie cieľovej teploty.
Valve šablóna pridáva service atribúty Force close, Extra pressure a Automatic calibration correction (plus zodpovedajúce toggle akcie) na zariadení ventilu, aby autori smart pravidiel mohli priamo riadiť motor pre scenáre ako núdzové zatvorenie, manuálne predhrievanie alebo boost sekvencie.
Termostat (variant valve šablóny)
Valve šablóna stále vystavuje zariadenie termostat, aby bolo možné zapísať setpoint z rovnakej TapHome skupiny zariadení, ale jej zapisovací skript posiela obe target_t a target_t_enabled=false, aby firmware PID nebojoval s manuálne ovládaným ventilom. Sada service atribútov je zredukovaná na Temperature offset [°C] (atribúty telesa ventilu ako force_close a valve_state sa presúvajú na zariadenie ventilu). Šablóna upozorňuje, keď je pozorovaný target_t.enabled=true — to signalizuje konflikt medzi dimmerom ventilu a automatickým riadením.
Modulové diagnostiky a akcie
Modul (head unit) pollne /status a /settings každé 3 sekundy a vystavuje diagnostiky a akcie pre celé zariadenie:
- Diagnostiky: Wi-Fi SSID, IP adresa, MAC, sila signálu (RSSI v dBm), stav kalibrácie, zapnutie/vypnutie rozvrhu, jas displeja (1-7) a stav obráteného displeja.
- Akcie: Disable schedule, Reboot, Calibrate (spúšťa
/calibrate), Update firmware (stiahneSHTRV-01_build.gblz oficiálneho Shelly EU firmware servera), Set display brightness a Flip display.
Dodatočné možnosti
Zariadenie tiež vystavuje — ale aktuálne šablóny ich ešte nepokrývajú — viacero Gen1 funkcií: pasívnu detekciu otvoreného okna (/window), symetrickú akciu Force open, fallback okolitú teplotu (auto_temp), detský zámok, oneskorenie automatického zatvorenia pri otvorenom okne, senzor plánovaného setpointu (schedule_t), index aktívneho profilu, zvyšné boost minúty a akciu Trigger boost (/thermostats/0?boost_minutes=N), tepelný stav vnútornej elektroniky (tmp_state) a dostupnosť firmware aktualizácie ako senzor. CoIoT push a MQTT prenos sú na úrovni zariadenia podporované, ale nevyužité — TapHome namiesto toho pullne /status každé 3 s. Tieto funkcie môžu byť pridané v budúcej aktualizácii šablóny.
Riešenie problémov
Device is not calibrated
Každý zápis setpointu a polohy ventilu vracia Device is not calibrated, kým TRV nedokončí úspešný kalibračný cyklus.
- Uisti sa, že zariadenie je pevne usadené na telese ventilu — pridržiavacia matica musí byť dostatočne utiahnutá, aby motor mal záťaž proti kolíku ventilu, ale nie tak, aby ho deformovala.
- Spusti service akciu Calibrate na module (pošle
/calibrate). Displej krátko zobrazíCL, kým motor beží oboma smermi. - Pri úspechu sa
calibratedstanetruea zápisy prejdú; neúspech zobrazí na displejiE1— zvyčajne signalizuje nesprávne nasadenie.
Setpoint sa každých pár hodín vracia na iné hodnoty
To je týždenný rozvrh prepisujúci externé zápisy. Skontroluj service atribút Schedule — ak je zapnutý, spusti akciu Disable schedule na module alebo vypni aktívny profil v Shelly Cloud apke.
Izbová teplota je príliš vysoká
Dve bežné príčiny:
- Pripojená nabíjačka. Hodnoty izbovej teploty sú neplatné, kým
charger != disconnected. Odpoj USB-C a nechaj zariadenie vychladnúť. - Skreslenie vstavaného senzora. Senzor je blízko horúcich rúr a typicky číta 1-3 °C vyššie. Buď povoľ endpoint externých korekcií teploty a spáruj Shelly H&T (alebo kompatibilný Wi-Fi teplomer) v rovnakej izbe, alebo aplikuj statický Set temperature offset (napr.
-1,5 °C).
Displej zobrazuje E1 / E2
E1 — problém s kalibráciou. Presadí zariadenie, opatrne dotiahni maticu a spusti nový kalibračný cyklus.
E2 — problém s teplotným senzorom. tmp.is_valid sa v /status stane false a šablóna pridá chybu Temperature sensor error. Ak problém pretrváva aj po reštarte, senzor pravdepodobne zlyhal — kontaktuj podporu Shelly.
Zariadenie je nedostupné
- Over, že TRV je pripojený k Wi-Fi — podrž Up + Down na 5 s a prelistuj parametre stavu;
COoznačuje pripojeného Wi-Fi klienta. - Potvrď, že TapHome CCU a TRV sú v rovnakej sieti / VLAN — Shelly Gen1 nerouter štandardne medzi podsieťami.
- Skús mDNS hostname (
shellytrv-XXXXXX.local) namiesto IP — DHCP lease sa možno zmenil. - Otvor
http://{device-ip}/statusv prehliadači. Ak príde JSON odpoveď, zariadenie je dostupné a problém je v konfigurácii TapHome.
Gen1 Shelly zariadenia prijímajú iba 2 súbežné HTTP spojenia. Ak TapHome a iný systém (Home Assistant, Node-RED) pollujú to isté zariadenie naraz, komunikácia bude nespoľahlivá. Pollovací interval nechaj na predvolenej hodnote šablóny (3 s) a vyhni sa ďalším pollerom.
Povolenie MQTT na Gen1 Shelly zariadeniach nezvratne vypne Shelly Cloud. TapHome používa len HTTP — MQTT nechaj vypnuté, pokiaľ sa explicitne nechceš odhlásiť z Shelly Cloudu.