--- title: "Shelly TRV" description: "Shelly TRV v TapHome lokálne cez HTTP, bez brány a cloudu: izbový setpoint 5–30 °C alebo poloha ventilu 0–100 % a stav batérie termohlavice." url: "https://taphome.com/sk/compatibility/shelly-trv/" language: sk lastmod: 2026-04-18 generator: hugo ai: topics: ["http","thermostat","wifi","battery-powered","radiator-valve","mdns"] questions: ["Ako integrovať Shelly TRV s TapHome?","Aký je rozdiel medzi šablónami Shelly TRV thermostat a valve?","Ako kalibrovať Shelly TRV po nasadení na radiátor?","Prečo Shelly TRV odmieta zápis setpointu z TapHome?","Prečo Shelly TRV zobrazuje príliš vysokú izbovú teplotu?","Ako vypnúť týždenný rozvrh, aby setpoint ovládal TapHome?"] --- # Shelly TRV Komunikácia: Packet Parser → HTTP - [Shelly TRV Knowledge Base](https://kb.shelly.cloud/knowledge-base/shelly-trv) - [Dokumentácia Shelly Gen1 API](https://shelly-api-docs.shelly.cloud/gen1/#shelly-trv) > Adresa v sieti > > TapHome komunikuje so zariadením na adrese zadanej pri importe. Dajte zariadeniu stálu adresu — rezerváciu IP v routeri, alebo jeho mDNS meno, ak ho podporuje —, inak integrácia prestane fungovať, keď router adresu zmení. > > [Príprava siete](https://taphome.com/sk/docs/setup/network-preparation/) ## Návod na integráciu 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](https://www.shelly.com/products/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. | > [!WARNING] > 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 1. Uisti sa, že radiátor je vypnutý a vychladnutý. 2. 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. 3. Nasadzí správny adaptér, ak závit ventilu nie je pôvodný M30 × 1,5. 4. 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. 5. Pred úplným dotiahnutím matice natoč displej do požadovanej orientácie. 6. 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ím `AP` na displeji; neúspech zobrazí `E1`. > [!NOTE] > 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 chybou `Device 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í). > [!WARNING] > Počas nabíjania sa telo zariadenia zahrieva a interný teplotný senzor číta nesprávne. Kým `charger` nie je `disconnected`, 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 (stiahne `SHTRV-01_build.gbl` z 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. 1. 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. 2. Spusti service akciu **Calibrate** na module (pošle `/calibrate`). Displej krátko zobrazí `CL`, kým motor beží oboma smermi. 3. Pri úspechu sa `calibrated` stane `true` a zápisy prejdú; neúspech zobrazí na displeji `E1` — 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é 1. Over, že TRV je pripojený k Wi-Fi — podrž **Up + Down** na 5 s a prelistuj parametre stavu; `CO` označuje pripojeného Wi-Fi klienta. 2. Potvrď, že TapHome CCU a TRV sú v rovnakej sieti / VLAN — Shelly Gen1 nerouter štandardne medzi podsieťami. 3. Skús mDNS hostname (`shellytrv-XXXXXX.local`) namiesto IP — DHCP lease sa možno zmenil. 4. Otvor `http://{device-ip}/status` v prehliadači. Ak príde JSON odpoveď, zariadenie je dostupné a problém je v konfigurácii TapHome. > [!WARNING] > 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. > [!NOTE] > 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. ## Ako nainštalovať v TapHome ### Predpoklady - Zariadenie Shelly nainštalované a zapnuté - Lokálna Wi-Fi sieť (2,4 GHz) - TapHome CCU v rovnakej sieti ### Krok 1 — Pripojte Shelly k Wi-Fi **Možnosť A — Aplikácia Shelly (odporúčané):** 1. Stiahnite si [aplikáciu Shelly](https://www.shelly.com/en/support/shelly-app) (iOS / Android) 2. Klepnite na **+** → **Add Device** a postupujte podľa sprievodcu Bluetooth párovaním 3. Po výzve zadajte svoje Wi-Fi prihlasovacie údaje **Možnosť B — AP režim (bez aplikácie):** 1. Pri prvom zapnutí zariadenie vytvorí hotspot: `ShellyXXX-AABBCCDDEE` 2. Pripojte telefón/PC k tomuto hotspotu 3. Otvorte `http://192.168.33.1` → **Internet & Security** → **Wi-Fi Mode - Client** 4. Zadajte SSID a heslo → **Save** > [!NOTE] > Shelly podporuje iba **2,4 GHz** siete. 5 GHz siete sa pri skenovaní nezobrazia. ### Krok 2 — Zistite IP adresu Po pripojení k Wi-Fi zistite priradenú IP adresu jedným z nasledujúcich spôsobov: - **Aplikácia Shelly:** Detail zariadenia → **Device info** → IP adresa - **Webové rozhranie Shelly:** Pripojte sa k AP zariadenia pred nastavením Wi-Fi — IP sa zobrazí po uložení - **DHCP tabuľka routera:** Hľadajte hostname ako `shelly1pm-AABBCCDDEE` - **mDNS:** Pingnite `shelly-.local` (napr. `shelly1pm-AABBCCDDEE.local`) z rovnakej siete > [!TIP] > Priraďte zariadeniu Shelly **statickú IP** (DHCP rezerváciu) vo vašom routeri, aby sa adresa nezmenila po reštarte routera. ### Krok 3 — Konfigurácia v TapHome 1. V TapHome pridajte nový modul **Packet Parser (HTTP)** 2. **IP Address:** zadajte IP z kroku 2 (napr. `192.168.1.50`) 3. **Port:** `80` (predvolený, nie je potrebné meniť) 4. Importujte šablónu — TapHome bude pravidelne čítať `/status` pre zistenie stavu zariadenia > [!NOTE] > HTTP autentifikácia je na zariadeniach Shelly štandardne vypnutá. Ak ste povolili ochranu prihlásením, TapHome momentálne nepodporuje HTTP Basic Auth — pre integráciu s TapHome ponechajte autentifikáciu vypnutú. ## Dostupné zariadenia 2 Tieto zariadenia sa po importe zobrazia v TapHome. Shelly TRV Modul Servisné atribúty | | | |--------------------------|--------------------------------------------------------------------------------------------------------------------------------| | WiFi SSID | | | IP adresa | | | MAC adresa | | | Sila prijímaného signálu | Sila Wi-Fi signálu v dBm — typicky dobrý rozsah -55 až -70 dBm, pod -80 dBm je nespoľahlivá | | Skalibrované | Či je mechanická kalibrácia ventilu dokončená — zápisy setpointu a polohy ventilu sú odmietnuté, kým kalibrácia nie je úspešná | | Rozvrh | Týždenný rozvrh zapnutý/vypnutý — keď je zapnutý, firmware prepíše externe zapísané setpointy pri najbližšej udalosti rozvrhu | | Jas displeja | Úroveň jasu LED displeja (1 = slabý, 7 = silný) | | Otočený displej | Či je LED displej otočený o 180° pre montáž hore nohami | Servisné akcie | | | |-----------------------|--------------------------------------------------------------------------------------------------| | Vypnúť rozvrh | Vypne týždenný rozvrh, aby externé setpointy neboli vrátené pri najbližšej udalosti rozvrhu | | Reštart | | | Kalibrovať | Spustí cyklus mechanickej kalibrácie ventilu — povinné po každom presadení na iné teleso ventilu | | Aktualizovať firmvér | Spustí OTA aktualizáciu firmvéru z oficiálneho Shelly EU firmware servera | | Nastaviť jas displeja | Nastaví jas LED displeja (1 = slabý, 7 = silný) | | Otočiť displej | Prepne otočenie displeja o 180° pre prípady, keď je ventil namontovaný hore nohami | Vlastné premenné Čítanie (modul) ```taphome VAR response := SENDHTTPREQUEST("/status"); IF response.IsSuccess status := response.Content; END response := SENDHTTPREQUEST("/settings"); IF response.IsSuccess settings := response.Content; END if(PARSEJSON(status, "$.thermostats[0].schedule"), adderror("Schedule is enabled")); if(PARSEJSON(status, "$.update.has_update"), addwarning("Firmware update is available")); var bat := PARSEJSON(status, "$.bat.value"); if bat < 25 addwarning("Battery charge is criticaly low"); elseif bat < 50 addwarning("Low battery"); end ``` Servisné atribúty Wifi ```taphome PARSEJSON(status, "$.wifi_sta.ssid") ``` ${ipAddress} ```taphome PARSEJSON(status, "$.wifi_sta.ip") ``` MAC ```taphome PARSEJSON(status, "$.mac") ``` Received signal strength ```taphome PARSEJSON(status, "$.wifi_sta.rssi") ``` Calibrated ```taphome if(PARSEJSON(status, "$.calibrated"), "${detail_deviceSettings_true}", "${detail_deviceSettings_false}") ``` Schedule ```taphome VAR response := SENDHTTPREQUEST("/thermostats/0"); IF response.IsSuccess VAR content := response.Content; VAR responseHeaders := response.Headers; RETURN(SWITCH(PARSEJSON(content, "$.schedule"), true, "On", "Off")); END ``` Display brightness ```taphome PARSEJSON(settings, "$.display.brightness") ``` Display flipped ```taphome if(PARSEJSON(settings, "$.display.flipped"), "${detail_deviceSettings_true}", "${detail_deviceSettings_false}") ``` Servisné akcie Disable schedule ```taphome var response := SENDHTTPREQUEST("/settings/thermostats/0?schedule=false"); if(response.IsSuccess, return("OK"), return(response.Content)); ``` Reboot ```taphome VAR response := SENDHTTPREQUEST("/reboot"); if(response.IsSuccess, return("OK"), return(response.Content)); ``` Calibrate ```taphome VAR response := SENDHTTPREQUEST("/calibrate"); if(response.IsSuccess, return("OK"), return(response.Content)); ``` Update firmware ```taphome VAR response := SENDHTTPREQUEST("/ota?url=http://shelly-api-eu.shelly.cloud/firmware/SHTRV-01_build.gbl"); if(response.IsSuccess, return("OK"), return(response.Content)); ``` Set display brightness Parametre: Brightness (1-7) (1–7 Br) ```taphome var response := SENDHTTPREQUEST("/settings?display_brightness=" + Br); if(response.IsSuccess, return("OK"), return(response.Content)); ``` Flip display ```taphome var response := SENDHTTPREQUEST("/settings?display_flipped=" + if(PARSEJSON(settings, "$.display.flipped"), "false", "true")); if(response.IsSuccess, return("OK"), return(response.Content)); ``` Batéria Viacstavový prepínač Len na čítanie Úroveň nabitia batérie ako prepínač s viacerými hodnotami — Critical (<25 %), Low (25-50 %), Normal (50-75 %), Full (>75 %), Charging (USB-C pripojené). Stav nabíjania má prednosť pred úrovňou numeric Jednotka: % multi-value switch Hodnoty / Stavy: Critical · Low · Normal · Full · Charging Čítanie stavu prepínača ```taphome if PARSEJSON(status, "$.charger") return(4); end var bat := PARSEJSON(status, "$.bat.value"); if bat > 75 return(3); elseif bat > 50 return(2); elseif bat > 25 return(1); else return(0); end ``` Servisné atribúty Value \[%] ```taphome PARSEJSON(status, "$.bat.value"); ``` Voltage \[V] ```taphome PARSEJSON(status, "$.bat.voltage"); ``` Termostat Termostat Čítanie aj zápis Termostat s uzavretou slučkou — zápis cieľovej teploty (5-30 °C), firmware interne riadi ventil pomocou vstavaného alebo externého senzora numeric Jednotka: °C Servisné atribúty | | | |---------------------------------|---------------------------------------------------------------------------------------------------------------------------------| | Teplotný ofset \[°C] | Statický ofset pripočítaný k nameranej izbovej teplote — užitočný, keď vstavaný senzor číta vyššie kvôli blízkosti horúcich rúr | | Poloha ventilu \[%] | Aktuálne otvorenie ventilu v percentách (0 = úplne zatvorený, 100 = úplne otvorený) | | Nútené zatvorenie | Či je ventil nútený úplne zatvorený bez ohľadu na setpoint | | Extra tlak | Či je režim extra tlaku aktívny — aplikuje dodatočnú mechanickú silu na ovládanie tuhých ventilov | | Automatická korekcia kalibrácie | Či je na mechanický zdvih aplikovaná jemná korekcia kalibrácie | Servisné akcie | | | |---------------------------|--------------------------------------------------------------------------------------------------------| | Nastaviť teplotný ofset | Nastaví teplotný ofset senzora (-20 až +20 °C) na kompenzáciu teplotného skreslenia vstavaného senzora | | Prepnúť nútené zatvorenie | Prepne režim núteného zatvorenia — ventil zostáva úplne zatvorený bez ohľadu na setpoint | | Prepnúť extra tlak | Prepne režim extra tlaku — zosilní aktuáciu ventilu pre tuhé ventily | Čítanie teploty ```taphome PARSEJSON(status, "$.thermostats[0].tmp.value") ``` Čítanie (modul) ```taphome if(! PARSEJSON(status, "$.thermostats[0].tmp.is_valid"), adderror("Temperature sensor error")); ``` Čítanie požadovanej teploty ```taphome PARSEJSON(status, "$.thermostats[0].target_t.value") ``` Zápis požadovanej teploty ```taphome if(status = "0", return(Se)); if !PARSEJSON(status, "$.calibrated") ADDERROR("Device is not calibrated"); return(NaN); end VAR response := SENDHTTPREQUEST("/settings/thermostats/0?target_t=" + Se); IF response.IsSuccess = false ADDERROR(response.StatusCode); END ``` Servisné atribúty Temperature offset \[°C] ```taphome PARSEJSON(settings, "$.thermostats[0].temperature_offset") ``` ${device\_variable\_valvestate} \[%] ```taphome PARSEJSON(status, "$.thermostats[0].pos") ``` Force close ```taphome if(PARSEJSON(settings, "$.thermostats[0].force_close"), "${detail_deviceSettings_true}", "${detail_deviceSettings_false}") ``` Extra pressure ```taphome if(PARSEJSON(settings, "$.thermostats[0].extra_pressure"), "${detail_deviceSettings_true}", "${detail_deviceSettings_false}") ``` Automatic calibration correction ```taphome if(PARSEJSON(settings, "$.thermostats[0].calibration_correction"), "${detail_deviceSettings_true}", "${detail_deviceSettings_false}") ``` Servisné akcie Set temperature offset Parametre: Offset (-20–20 C) ```taphome VAR response := SENDHTTPREQUEST("/settings/thermostats/0?temperature_offset=" + C); if(response.IsSuccess, return("OK"), return(response.Content)); ``` Toggle force close ```taphome var response := SENDHTTPREQUEST("/settings/thermostats/0?force_close=" + if(PARSEJSON(settings, "$.thermostats[0].force_close"), "false", "true")); if(response.IsSuccess, return("OK"), return(response.Content)); ``` Toggle extra pressure ```taphome var response := SENDHTTPREQUEST("/settings/thermostats/0?extra_pressure=" + if(PARSEJSON(settings, "$.thermostats[0].extra_pressure"), "false", "true")); if(response.IsSuccess, return("OK"), return(response.Content)); ``` **Pripojenie:** Packet Parser → HTTP • Hostname: `shellytrv-{MAC}.local` Možné vylepšenia (14) - Active schedule profile — Currently active profile index (0-4) when scheduling is enabled. Could be added as a multi-value indicator - Scheduled setpoint — Setpoint that the firmware would apply on the next schedule event - Boost remaining — Remaining boost time in minutes; pairs with /thermostats/0?boost\_minutes=N write - Trigger boost — Temporary heating boost action — not currently exposed as service action - Internal thermal state — Electronics thermal state (Normal / High / Very High); early warning for overheating - Firmware update availability — Currently surfaced only as warning in module readscript — could be a service attribute - Open window detection — Passive open-window detection based on temperature drop; publishes 'state: open|closed' and MQTT topic shellies/{id}/window - Force open — Forces valve 100% open — symmetrical counterpart to force\_close which IS implemented - Window-open auto-close delay — Delay (1-3600 s) before closing the valve after open-window detection - Fallback ambient temperature — Fallback setpoint (0-27 °C, 0 = disabled) used when no active setpoint exists - Child lock — Locks the physical Up/Down buttons on the device - Schedule rules configuration — Up to 18 rules/profile, 5 named profiles. Complex config — usually managed via Shelly Cloud app - CoIoT push updates — Optional multicast push (CoAP) — TapHome uses pull polling, not required - MQTT control — Gen1 MQTT alternative transport — enabling MQTT irreversibly disables Shelly Cloud ## Parametre importu Tieto hodnoty zadáte pri importe XML. | Pýta sa v aplikácii | Predvolené | |---------------------|---------------| | IP adresa | `192.168.0.1` | ## Zdroje - Shelly Gen1 API Reference [shelly-api-docs.shelly.cloud](https://shelly-api-docs.shelly.cloud/gen1/) 2026-03-12 - Home Assistant Shelly Integration [www.home-assistant.io](https://www.home-assistant.io/integrations/shelly/) 2026-03-12 - Shelly TRV — HTTP API (TRV-specific endpoints) [shelly-api-docs.shelly.cloud](https://shelly-api-docs.shelly.cloud/gen1/#shelly-trv) 2026-04-16 - Shelly TRV — Knowledge Base [kb.shelly.cloud](https://kb.shelly.cloud/knowledge-base/shelly-trv) 2026-04-16 - Shelly TRV — Multilingual User & Safety Guide [kb.shelly.cloud](https://kb.shelly.cloud/knowledge-base/shelly-trv) 2026-04-16 [PDF](https://taphome.com/compatibility/devices/shelly-trv/manufacturer/user-guide.pdf) - Peyanski — Home Assistant and Shelly TRV [peyanski.com](https://peyanski.com/home-assistant-and-shelly-trv/) 2026-04-16 Dokumenty výrobcov sú © ich príslušných vlastníkov. Poskytujeme ich tak, ako ich zverejnil výrobca, len na informačné účely. ## Súvisiaca dokumentácia - [Integrácia Packet Parser](https://taphome.com/sk/compatibility/packet-parser-guide/) - [Packet Parser (HTTP, TCP, UDP, FTP, MQTT)](https://taphome.com/sk/docs/integration/packet-parser/) - [Funkcie Packet parsera](https://taphome.com/sk/docs/script/packet-parser/) - [Parsovacie funkcie](https://taphome.com/sk/docs/script/parsing-functions/)