Shelly TRV (SHTRV-01) je bateriově napájená Wi-Fi termostatická radiátorová hlavice od Allterco Robotics. Nasazuje se přímo na těleso ventilu běžného teplovodního radiátoru a průtok teplé vody radiátorem mění pohybem kolíku ventilu přes vestavěný motor. TapHome komunikuje se zařízením přes HTTP na lokální síti — bez brány, bez cloudu, bez MQTT brokera.
Tato šablona vystavuje polohu ventilu jako samostatné zařízení Valve state, aby ventil mohl přímo řídit smart rule v TapHome. Vlastní regulace teploty zařízení je vypnutá: každý setpoint zapsaný z TapHome se odesílá spolu s target_t_enabled=false, takže firmware už ventilem sám nepohybuje.
Shelly TRV je ukončený produkt a nahradila ho Bluetooth verze Shelly BLU TRV. Stávající kusy fungují dál a tato šablona zůstává plně podporovaná; pro nové projekty zvažte nástupce.
Pro totéž fyzické zařízení jsou k dispozici dvě alternativní šablony — vyberte podle zamýšleného způsobu řízení.
| Šablona | Vystavuje | Použití |
|---|---|---|
| Shelly TRV (hlavní) | Baterii + termostat s uzavřenou smyčkou | Řízení pokojové teploty koncovým uživatelem přes setpoint (5-30 °C). Firmware řídí ventil interně. |
| Shelly TRV (valve) (tato šablona) | Baterii + dimmer ventilu + termostat (varianta pro setpoint) | Smart rules, které potřebují přímo řídit ventil — poloha ventilu je vystavena jako dimmer 0-100 %, automatická regulace je vypnutá. |
Neimportujte obě šablony pro totéž fyzické zařízení. Obě se váží na stejný endpoint a smyčky pollingu budou kolidovat — zápisy se budou navzájem rušit a chování ventilu bude nepředvídatelné.
Instalace hardwaru
Shelly TRV nemá žádné zapojení — jde o mechanickou radiátorovou hlavici s interní elektronikou, napájenou vestavěnou nabíjecí baterií (Panasonic NCR18650BD, 3,6 V / 6500 mAh). Na těleso ventilu radiátoru se nasazuje přes kovovou přídržnou matici. Zařízení je určeno pouze pro vnitřní použití a musí být chráněno před nečistotami, vlhkostí a stříkající vodou.
Kompatibilní tělesa ventilů
Pokud má radiátor už termostatickou hlavici (typicky otočný ovladač s čísly 1 až 5), těleso ventilu je s největší pravděpodobností kompatibilní. Radiátory s malými ručními ventily — běžné tam, kde je nainstalovaný samostatný pokojový nebo centrální termostat — kompatibilní nejsou.
Původní závit: M30 × 1,5. V balení jsou následující adaptéry:
- Danfoss — RA, RAV, RAVL
- Caleffi
- Giacomini
- M28 × 1,5 — Sam, Slovarm, Comap, TA, Herz, MMA, Remagg
- Pont à Mousson
Adaptéry třetích stran (nejsou v balení) rozšiřují kompatibilitu na Gampper, Ista, Meges, Ondal, Oventrop, Rossweiner, Vaillant a další.
Postup montáže
- Ujistěte se, že radiátor je vypnutý a vychladlý.
- Otočte stávající hlavici ventilu proti směru hodinových ručiček, dokud není ventil zcela otevřený, poté odšroubujte kovovou matici proti směru hodinových ručiček a hlavici sejměte.
- Pokud závit ventilu není původní M30 × 1,5, nasaďte správný adaptér.
- Nasaďte Shelly TRV na těleso ventilu otáčením kovové matice ve směru hodinových ručiček — zatím ji úplně nedotahujte.
- Natočte displej do požadované orientace a poté kovovou matici úplně dotáhněte.
Po úplném dotažení kovové matice se zařízením nezkoušejte otáčet — můžete ho poškodit.
Nabíjení
Zařízení se nabíjí přes USB-C nabíječkou kompatibilní s USB-C s proudem alespoň 1 A. Před prvním použitím ho nabíjejte doplna přibližně 7 hodin. Během nabíjení bliká na displeji čárka úrovně baterie a tečka u spodního řádku označuje připojenou nabíječku. Výdrž baterie je až 2 roky v závislosti na tom, jak často se ventil pohybuje, a na kvalitě Wi-Fi signálu.
Během nabíjení se tělo zařízení zahřívá a vnitřní teplotní senzor měří nesprávně. Dokud je nabíječka připojená, počítejte se zkreslenými hodnotami pokojové teploty.
Kalibrace
Kalibrace naučí motor zdvih konkrétního tělesa ventilu. Bez ní TapHome nedokáže polohu ventilu číst ani zapisovat.
- Krátce stiskněte Reset (zadní strana zařízení). Displej zobrazí
CLa vnitřní motor se otáčí oběma směry. - Úspěšná kalibrace končí zobrazením
APna displeji — zařízení je připravené k připojení k Wi-Fi. E1znamená, že kalibrace selhala: matice není dostatečně dotažená nebo zařízení není správně usazené. Dotáhněte matici nebo zařízení znovu nasaďte, poté podržte Up nebo Down 3 sekundy a několikrát stiskněte Down, čímž spustíte novou kalibraci.
Když je zařízení v TapHome, nový kalibrační cyklus lze spustit také servisní akcí Calibrate na modulu.
Kalibraci zopakujte po každém přesazení na jiné těleso ventilu. Dokud zařízení nehlásí
calibrated=true, zařízení Valve state zobrazujeDevice is not calibrateda TapHome odmítá zápis polohy ventilu i setpointu.
Nastavení sítě
Shelly TRV používá Wi-Fi 2,4 GHz (802.11 b/g/n) s dosahem až 30 m v závislosti na konstrukci budovy. Po kalibraci se spustí v režimu Access Point (AP na displeji).
Pokud zařízení do 3 minut nepřidáte do Wi-Fi sítě, vypne se. Znovu ho spustíte krátkým stisknutím Reset.
Připojení k Wi-Fi
Zařízení lze připojit přes mobilní aplikaci Shelly Cloud nebo ručně přes jeho vestavěné webové rozhraní:
- Připojte telefon nebo počítač k Wi-Fi síti, kterou vytvořilo zařízení, a otevřete
http://192.168.33.1. - Klikněte na Internet & Security a vyberte WIFI MODE - CLIENT.
- Zaškrtněte Connect the Shelly device to an existing WiFi Network, zadejte název sítě a heslo a stiskněte SAVE.
- Najděte IP adresu zařízení v lokální síti (seznam klientů v routeru nebo nástroj Shelly device finder pro Windows či macOS).
Zapnutím režimu Client se režim Access Point vypne. Do režimu Access Point se vrátíte podržením Reset na 5 sekund.
Rezervace DHCP pro zařízení v routeru udrží IP adresu, kterou používá TapHome, stabilní.
Autentizace
Šablona posílá HTTP požadavky bez přihlašovacích údajů na portu 80; HTTPS zařízení Gen1 nepodporují. Pokud je ve webovém rozhraní zařízení zapnutá ochrana přihlášením, vypněte ji — jinak TapHome zařízení nedokáže číst ani ovládat.
Konfigurace
V TapHome importujte šablonu a jako jediný parametr importu zadejte IP adresu zařízení, poté vytvořte smart rule, který řídí zařízení Valve state.
Vypnutí týdenního rozvrhu
Shelly TRV má vestavěný týdenní plánovač (5 profilů, až 20 změn teploty na profil). Když je rozvrh aktivní, firmware při nejbližší plánované změně přepíše jakýkoli externě zapsaný setpoint.
Šablona to hlásí jako chybu modulu (Schedule is enabled). Před předáním zařízení pod řízení TapHome buď:
- spusťte servisní akci Disable schedule na modulu (odešle
/settings/thermostats/0?schedule=false), nebo - ve webovém rozhraní zařízení nebo v aplikaci Shelly Cloud vyberte v části Weekly schedule profil Disable.
Automatické řízení ventilu
Zařízení Valve state i zařízení Thermostat zobrazují varování Automatic valve control is on vždy, když zařízení hlásí svou vlastní regulaci teploty jako aktivní, protože může kolidovat s činností smart rule. Zápis setpointu ze zařízení Thermostat ji znovu vypne (target_t_enabled=false).
Externí pokojový senzor (doporučeno)
Každý termostat namontovaný na radiátoru měří blízko radiátoru, takže vestavěný senzor se odchyluje od skutečné pokojové teploty. K dispozici jsou dvě cesty korekce:
- Externí senzor — Shelly H&T nebo kompatibilní senzor v místnosti může posílat okolní teplotu do TRV. Zapněte to ve webovém rozhraní zařízení → Sensor Settings → TEMPERATURE OFFSET → Enable external temperature corrections endpoint.
- Statický offset — ke kompenzaci konstantní odchylky použijte servisní akci Set temperature offset na zařízení Thermostat (rozsah ±20 °C).
Možnosti zařízení
Šablona vystavuje zařízení jako indikátor baterie, dimmer polohy ventilu a termostat. Diagnostika a akce na úrovni modulu jsou stejné jako v hlavní šabloně.
Valve state
Aktuátor ventilu je vystaven jako dimmer (0-100 %). TapHome čte polohu z thermostats[0].pos a zapisuje ji přes /thermostats/0?pos={0-100}; firmware přesune motor do požadované polohy. Záporná poloha znamená, že ventil není zkalibrovaný, a zařízení zobrazí Device is not calibrated.
Servisní atributy hlásí Force close, Extra pressure a Automatic calibration correction. Servisní akce přepínají režim nuceného zavření (ventil zůstane zcela zavřený) a režim extra tlaku (silnější ovládání pro tuhé ventily), aby smart rules zvládly scénáře jako nouzové zavření, předehřev nebo boost sekvence.
Thermostat
Termostat čte naměřenou pokojovou teplotu (thermostats[0].tmp.value) a uložený cíl (thermostats[0].target_t.value). Zápis setpointu posílá obě hodnoty target_t i target_t_enabled=false na /settings/thermostats/0, takže firmware ventilem sám nepohybuje — setpoint slouží jako referenční hodnota pro smart rule, který řídí zařízení Valve state.
Jediný servisní atribut je Temperature offset [°C] s odpovídající akcí Set temperature offset. Když je hodnota ze senzoru neplatná, zařízení přidá chybu Temperature sensor error.
Stav baterie
Baterie je vystavena jako přepínač s více hodnotami odvozený z hlášené úrovně nabití a stavu nabíječky. Stav nabíječky má přednost před úrovní:
| Stav | Podmínka |
|---|---|
| Critical | bat.value 25 % nebo méně |
| Low | bat.value 26-50 % |
| Normal | bat.value 51-75 % |
| Full | bat.value nad 75 % |
| Charging | nabíječka připojena |
Dva servisní atributy hlásí surové nabití baterie (%) a napětí (V). Modul vyvolá Low battery pod 50 % a Battery charge is criticaly low pod 25 %.
Diagnostika a akce modulu
Modul polluje /status a /settings každé 3 sekundy a vystavuje diagnostiku a akce pro celé zařízení:
- Diagnostika: Wi-Fi SSID, IP adresa, MAC, síla přijímaného signálu, stav kalibrace, zapnutí/vypnutí rozvrhu, jas displeje (1-7) a stav otočení displeje. Když je k dispozici aktualizace firmwaru, zobrazí se varování.
- Akce: Disable schedule, Reboot, Calibrate (spouští
/calibrate), Update firmware (stáhneSHTRV-01_build.gblz oficiálního firmwarového serveru Shelly EU), Set display brightness a Flip display.
Řešení problémů
Device is not calibrated
Zápisy polohy ventilu a setpointu jsou odmítány s Device is not calibrated, dokud TRV nedokončí úspěšný kalibrační cyklus.
- Ujistěte se, že zařízení je pevně usazené na tělese ventilu — matice musí být dostatečně dotažená, aby motor mohl tlačit proti kolíku ventilu.
- Spusťte servisní akci Calibrate na modulu nebo spusťte kalibraci na zařízení (podržte Up nebo Down 3 sekundy, poté několikrát stiskněte Down). Dokud se motor pohybuje oběma směry, displej zobrazuje
CL. - Při úspěchu se atribut Calibrated změní na
Yes;E1na displeji obvykle signalizuje nesprávnou montáž.
Ventil se pohybuje, i když ho žádný smart rule nezměnil
Aktivní je vlastní regulace zařízení nebo týdenní rozvrh. Zkontrolujte varování Automatic valve control is on a atribut modulu Schedule — zapište setpoint ze zařízení Thermostat, čímž vypnete automatické řízení, a pokud je rozvrh zapnutý, spusťte Disable schedule.
Pokojová teplota je příliš vysoká
- Připojená nabíječka. Během nabíjení jsou hodnoty pokojové teploty neplatné. Odpojte USB-C a nechte zařízení vychladnout.
- Odchylka vestavěného senzoru. Senzor je blízko radiátoru. Zapněte endpoint externích korekcí teploty a spárujte Shelly H&T (nebo kompatibilní senzor) ve stejné místnosti, nebo použijte statický Set temperature offset.
Displej zobrazuje E1 / E2
Stav zkontrolujete tak, že současně podržíte Up a Down 5 sekund a listujete tlačítky Up nebo Down.
E1— problém s kalibrací. Zařízení znovu nasaďte, opatrně dotáhněte matici a spusťte nový kalibrační cyklus.E2— problém s teplotním senzorem. Šablona přidá na zařízení Thermostat chybuTemperature sensor error. Pokud problém přetrvává i po restartu, kontaktujte podporu Shelly.
Zařízení je nedostupné
- Ověřte, že TRV je připojený k Wi-Fi — podržte Up a Down 5 sekund a prolistujte parametry stavu;
COoznačuje připojení k Wi-Fi síti,APznamená, že zařízení je stále v režimu Access Point. - Ověřte, že TapHome Core a TRV jsou ve stejné síti / VLAN.
- Zkuste místo IP adresy mDNS hostname (
shellytrv-XXXXXX.local) — DHCP lease se mohl změnit. - Otevřete v prohlížeči
http://{device-ip}/status. Pokud přijde JSON odpověď, zařízení je dostupné a problém je v konfiguraci TapHome.
Zařízení Shelly Gen1 přijímají pouze 2 souběžná HTTP spojení. Pokud TapHome a jiný systém pollují totéž zařízení současně, komunikace bude nespolehlivá. Interval pollingu nechte na výchozí hodnotě šablony (3 s) a vyhněte se dalším pollerům.
Zapnutí MQTT na zařízeních Shelly Gen1 vypne připojení k Shelly Cloud. TapHome používá pouze HTTP — MQTT nechte vypnuté.