--- title: "Shelly TRV" description: "Řiď pokojový setpoint (5-30 °C) nebo polohu ventilu (0-100 %) bateriové Wi-Fi termohlavice přes HTTP. TapHome šablona pro Shelly TRV." url: "https://taphome.com/cs/compatibility/shelly-trv/" language: cs lastmod: 2026-04-18 generator: hugo ai: topics: ["http","thermostat","wifi","battery-powered","radiator-valve","mdns"] questions: ["Jak integrovat Shelly TRV s TapHome?","Jaký je rozdíl mezi šablonami Shelly TRV thermostat a valve?","Jak kalibrovat Shelly TRV po nasazení na radiátor?","Proč Shelly TRV odmítá zápis setpointu z TapHome?","Proč Shelly TRV ukazuje příliš vysokou pokojovou teplotu?","Jak vypnout týdenní rozvrh, aby setpoint řídil TapHome?"] --- # Shelly TRV Komunikace: Packet Parser → HTTP - [Shelly TRV Knowledge Base](https://kb.shelly.cloud/knowledge-base/shelly-trv) - [Dokumentace Shelly Gen1 API](https://shelly-api-docs.shelly.cloud/gen1/#shelly-trv) > Adresa v síti > > TapHome komunikuje se zařízením na adrese zadané při importu. Dejte zařízení stálou adresu — rezervaci IP v routeru, nebo jeho mDNS jméno, pokud ho podporuje —, jinak integrace přestane fungovat, když router adresu změní. > > [Příprava sítě](https://taphome.com/cs/docs/setup/network-preparation/) ## Návod na integraci Shelly TRV (SHTRV-01) je bateriově napájená Wi-Fi termostatická radiátorová hlavice od Allterco Robotics. Nasazuje se přímo na těleso běžného ventilu teplovodního radiátoru a reguluje pokojovou teplotu 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. Shelly TRV je **ukončený produkt** a byl nahrazen Bluetooth verzí [Shelly BLU TRV](https://www.shelly.com/products/shelly-blu-trv). Existující kusy fungují dál a tato šablona zůstává plně podporovaná; pro nové projekty zvaž nástupce. Pro totéž fyzické zařízení jsou k dispozici dvě alternativní šablony — vyber podle požadovaného způsobu řízení. | Šablona | Vystavuje | Použití | |---------|-----------|---------| | **Shelly TRV** (main) | 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)** | Baterii + dimmer ventilu + termostat (varianta pro setpoint) | Smart pravidla, která potřebují přímé přepsání ventilu — poloha ventilu vystavena jako dimmer 0.0-1.0. | > [!WARNING] > Neimportuj obě šablony pro totéž fyzické zařízení. Obě se váží na stejný endpoint a polling smyčky 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í** — jedná se o mechanickou radiátorovou hlavici s interní elektronikou, napájenou vestavěnou Li-ion baterií (Panasonic NCR18650BD, 3,7 V / 6500 mAh). Nasazuje se přímo na těleso ventilu přes kovovou přídržnou matici. ### Kompatibilní tělesa ventilů 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 1. Ujisti se, že radiátor je vypnutý a vychladlý. 2. Otoč existující manuální hlavici proti směru hodinových ručiček až nadoraz (plně otevřeno), poté odšroubuj kovovou přídržnou matici a sejmi hlavici. 3. Nasaď správný adaptér, pokud závit ventilu není původní M30 × 1,5. 4. Usaď Shelly TRV na těleso ventilu a dotáhni kovovou matici ve směru hodinových ručiček — pevně, ale nepřetáhnout. Příliš volné i příliš silné utažení způsobí selhání kalibrace. 5. Před úplným dotažením matice natoč displej do požadované orientace. 6. Krátce stiskni **Reset** (zadní strana zařízení). Displej zobrazí `CL` (kalibrace) a vnitřní motor se pohybuje oběma směry. Úspěšná kalibrace se ukončí zobrazením `AP` na displeji; neúspěch zobrazí `E1`. > [!NOTE] > Kalibraci je nutné provést po každém přesazení na jiné těleso ventilu. Dokud `calibrated=true`, zápisy setpointu a polohy z TapHome jsou odmítány chybou `Device is not calibrated`. ### Nabíjení Zařízení se nabíjí přes **USB-C** (kabel je v balení, adaptér ne). USB-C nabíječka ≥1 A nabije baterii z prázdné na plnou přibližně za 5 hodin. Typická výdrž baterie je ~2 roky (~5 měsíců souvislé topné sezóny při běžném používání). > [!WARNING] > Během nabíjení se tělo zařízení zahřívá a vnitřní teplotní senzor čte nesprávně. Dokud není `charger` roven `disconnected`, počítej se zkreslenými hodnotami pokojové teploty. ## Konfigurace ### TapHome import Během importu šablony se TapHome ptá na jediný parametr: | Parametr | Popis | Výchozí | |----------|-------|---------| | `IpAddress` | Lokální IP adresa nebo mDNS hostname zařízení | `192.168.0.1` | Port `80` je pevný. HTTPS Gen1 nepodporuje. HTTP Basic Auth musí být na zařízení **vypnuta** — TapHome se vůči Gen1 Shelly zařízením neautentizuje. Kde je to možné, používej mDNS hostname (`shellytrv-XXXXXX.local`) — je odolný vůči změně DHCP leasu. TapHome **IP Scanner** (Nastavení → Síť → Scan) objeví jak IP, tak mDNS hostname. ### Vypnutí týdenního rozvrhu Shelly TRV má vestavěný týdenní plánovač (5 profilů, až 18 plánovaných změn týdně na profil). Je-li rozvrh zapnutý, firmware přepíše jakýkoliv externě zapsaný setpoint při nejbližší plánované události — setpointy z TapHome jsou tiše vráceny. Šablona tuto skutečnost vystavuje jako varování (`Schedule is enabled`). Před převzetím řízení TapHome buď: - spusť akci **Disable schedule** na modulu (odešle `/settings/thermostats/0?schedule=false`), nebo - v aplikaci Shelly Cloud nebo ve Web UI zařízení vyber profil **Disable**. ### Externí pokojový senzor (doporučeno) Vestavěný teplotní senzor je fyzicky blízko horkého potrubí radiátoru a typicky čte **1-3 °C výše než skutečná pokojová teplota**. K dispozici jsou dvě opravné cesty: - **Externí senzor** — spáruj samostatný Wi-Fi teploměr (např. **Shelly H&T**) přes Web UI zařízení → **Sensor Settings** → **Enable external temperature corrections endpoint**. Externí senzor pak posílá okolní teplotu POST voláním na TRV. - **Statický ofset** — použij akci **Set temperature offset** na zařízení Thermostat (rozsah ±20 °C) pro kompenzaci konstantního zkreslení. Pro nejlepší tepelný komfort kombinuj spolehlivý externí senzor s malým statickým ofsetem jako zálohu. ## Možnosti zařízení Hlavní šablona vystavuje zařízení jako indikátor baterie plus termostat s uzavřenou smyčkou. Valve šablona zachovává stejný modul a baterii, ale vystavuje polohu ventilu jako dimmer a používá variantu setpointu, která při zápisu vypne automatickou PID regulaci. Modulové diagnostiky a akce jsou identické pro obě šablony. ### Stav baterie Baterie je vystavena jako **přepínač s více hodnotami** odvozený z hlášené úrovně nabití a stavu USB-C nabíječky. Stav nabíječky má přednost před úrovní: | Stav | Podmínka | |------|----------| | Critical | `bat.value < 25` | | Low | `bat.value 25-50` | | Normal | `bat.value 50-75` | | Full | `bat.value > 75` | | Charging | `charger != disconnected` | Dva doplňkové service atributy hlásí surovou úroveň nabití baterie (`%`) a napětí článku (V, nominálně ~3,7 V, typický rozsah 2,6-4,2 V). Šablona vyvolá `Low battery` při <50 % a `Battery charge is critically low` při <25 %. ### Termostat (main šablona) Termostat s uzavřenou smyčkou: TapHome zapíše cílový setpoint a firmware TRV interně řídí polohu ventilu na základě vestavěného (nebo externího) teplotního senzoru. - **Čtení:** naměřená pokojová teplota (`thermostats[0].tmp.value`) a aktivní cíl (`thermostats[0].target_t.value`) - **Zápis:** setpoint 5-30 °C přes `/settings/thermostats/0?target_t={Se}` Doplňkové atributy termostatu zahrnují **Temperature offset [°C]**, **Valve position [%]** (jen pro čtení, pro viditelnost výstupu PID), **Force close**, **Extra pressure** a **Automatic calibration correction**. Odpovídající service akce umožňují TapHome nastavit ofset, přepnout režim nuceného zavření (ventil zůstane plně zavřen bez ohledu na setpoint) a přepnout režim extra tlaku (posiluje aktuaci pro tuhé ventily). Zápisy setpointu selhávají s `Device is not calibrated`, dokud `calibrated=false`, a šablona přidává varování, když je povolen týdenní rozvrh (protože firmware přepíše externí zápisy při nejbližší události rozvrhu). ### Dimmer ventilu (valve šablona) Alternativní šablona vystavuje aktuátor ventilu přímo jako dimmer zařízení (0.0-1.0 → 0-100 %). TapHome zapisuje polohu přes `/thermostats/0?pos={Le*100}` — firmware přesune motor na požadovanou polohu a implicitně vypne automatické řízení cílové teploty. Valve šablona přidává service atributy `Force close`, `Extra pressure` a `Automatic calibration correction` (plus odpovídající toggle akce) na zařízení ventilu, aby autoři smart pravidel mohli přímo řídit motor pro scénáře jako nouzové zavření, manuální předehřátí nebo boost sekvence. ### Termostat (varianta valve šablony) Valve šablona stále vystavuje zařízení termostat, aby bylo možné zapsat setpoint ze stejné TapHome skupiny zařízení, ale její zapisovací skript posílá **obě** `target_t` a `target_t_enabled=false`, aby firmware PID nebojoval s manuálně ovládaným ventilem. Sada service atributů je zredukována na **Temperature offset [°C]** (atributy tělesa ventilu jako `force_close` a `valve_state` se přesouvají na zařízení ventilu). Šablona varuje, když je pozorováno `target_t.enabled=true` — to signalizuje konflikt mezi dimmerem ventilu a automatickým řízením. ### Modulové diagnostiky a akce Modul (head unit) pollne `/status` a `/settings` každé 3 sekundy a vystavuje diagnostiky a akce pro celé zařízení: - **Diagnostiky:** Wi-Fi SSID, IP adresa, MAC, síla signálu (RSSI v dBm), stav kalibrace, zapnutí/vypnutí rozvrhu, jas displeje (1-7) a stav převráceného displeje. - **Akce:** Disable schedule, Reboot, Calibrate (spouští `/calibrate`), Update firmware (stáhne `SHTRV-01_build.gbl` z oficiálního Shelly EU firmware serveru), Set display brightness a Flip display. ### Další možnosti Zařízení rovněž vystavuje — ale současné šablony je zatím nepokrývají — několik Gen1 funkcí: pasivní detekci otevřeného okna (`/window`), symetrickou akci **Force open**, fallback okolní teplotu (`auto_temp`), dětský zámek, zpoždění automatického zavření při otevřeném okně, senzor plánovaného setpointu (`schedule_t`), index aktivního profilu, zbývající boost minuty a akci **Trigger boost** (`/thermostats/0?boost_minutes=N`), tepelný stav vnitřní elektroniky (`tmp_state`) a dostupnost aktualizace firmware jako senzor. CoIoT push a MQTT přenos jsou na úrovni zařízení podporovány, ale nevyužity — TapHome místo toho pollne `/status` každé 3 s. Tyto funkce mohou být přidány v budoucí aktualizaci šablony. ## Řešení problémů ### Device is not calibrated Každý zápis setpointu a polohy ventilu vrací `Device is not calibrated`, dokud TRV nedokončí úspěšný kalibrační cyklus. 1. Ujisti se, že zařízení je pevně usazeno na tělese ventilu — přídržná matice musí být dostatečně utažena, aby motor měl zátěž proti kolíku ventilu, ale ne tak, aby jej deformovala. 2. Spusť service akci **Calibrate** na modulu (odešle `/calibrate`). Displej krátce zobrazí `CL`, dokud se motor pohybuje oběma směry. 3. Při úspěchu se `calibrated` stane `true` a zápisy projdou; neúspěch zobrazí na displeji `E1` — obvykle signalizuje nesprávné nasazení. ### Setpoint se každých pár hodin vrací na jiné hodnoty To je týdenní rozvrh přepisující externí zápisy. Zkontroluj service atribut **Schedule** — pokud je zapnutý, spusť akci **Disable schedule** na modulu nebo vypni aktivní profil v aplikaci Shelly Cloud. ### Pokojová teplota je příliš vysoká Dvě běžné příčiny: - **Připojená nabíječka.** Hodnoty pokojové teploty jsou neplatné, dokud `charger != disconnected`. Odpoj USB-C a nech zařízení vychladnout. - **Zkreslení vestavěného senzoru.** Senzor sedí blízko horkých trubek a typicky čte 1-3 °C výše. Buď povol endpoint externích korekcí teploty a spáruj Shelly H&T (nebo kompatibilní Wi-Fi teploměr) ve stejné místnosti, nebo aplikuj statický **Set temperature offset** (např. `-1,5 °C`). ### Displej zobrazuje E1 / E2 `E1` — problém s kalibrací. Přesaď zařízení, opatrně dotáhni matici a spusť nový kalibrační cyklus. `E2` — problém s teplotním senzorem. `tmp.is_valid` se v `/status` stane `false` a šablona přidá chybu `Temperature sensor error`. Pokud problém přetrvává i po restartu, senzor pravděpodobně selhal — kontaktuj podporu Shelly. ### Zařízení je nedostupné 1. Ověř, že TRV je připojen k Wi-Fi — podrž **Up + Down** na 5 s a prolistuj parametry stavu; `CO` označuje připojeného Wi-Fi klienta. 2. Potvrď, že TapHome CCU a TRV jsou ve stejné síti / VLAN — Shelly Gen1 standardně neroutuje mezi podsítěmi. 3. Zkus mDNS hostname (`shellytrv-XXXXXX.local`) místo IP — DHCP lease se možná změnil. 4. Otevři `http://{device-ip}/status` v prohlížeči. Pokud přijde JSON odpověď, zařízení je dostupné a problém je v konfiguraci TapHome. > [!WARNING] > Gen1 Shelly zařízení přijímají jen **2 souběžná HTTP spojení**. Pokud TapHome a jiný systém (Home Assistant, Node-RED) pollují totéž zařízení současně, komunikace bude nespolehlivá. Polling interval nechej na výchozí hodnotě šablony (3 s) a vyhni se dalším pollerům. > [!NOTE] > Povolení MQTT na Gen1 Shelly zařízeních **nevratně vypne Shelly Cloud**. TapHome používá jen HTTP — MQTT nechej vypnuté, pokud se explicitně nechceš odhlásit ze Shelly Cloudu. ## Jak nainstalovat v TapHome ### Předpoklady - Zařízení Shelly nainstalované a zapnuté - Lokální Wi-Fi síť (2,4 GHz) - TapHome CCU ve stejné síti ### Krok 1 — Připojte Shelly k Wi-Fi **Možnost A — Aplikace Shelly (doporučeno):** 1. Stáhněte si [aplikaci Shelly](https://www.shelly.com/en/support/shelly-app) (iOS / Android) 2. Klepněte na **+** → **Add Device** a postupujte podle průvodce Bluetooth párováním 3. Po výzvě zadejte své Wi-Fi přihlašovací údaje **Možnost B — AP režim (bez aplikace):** 1. Při prvním zapnutí zařízení vytvoří hotspot: `ShellyXXX-AABBCCDDEE` 2. Připojte telefon/PC k tomuto hotspotu 3. Otevřete `http://192.168.33.1` → **Internet & Security** → **Wi-Fi Mode - Client** 4. Zadejte SSID a heslo → **Save** > [!NOTE] > Shelly podporuje pouze **2,4 GHz** sítě. 5 GHz sítě se při skenování nezobrazí. ### Krok 2 — Zjistěte IP adresu Po připojení k Wi-Fi zjistěte přiřazenou IP adresu jedním z následujících způsobů: - **Aplikace Shelly:** Detail zařízení → **Device info** → IP adresa - **Webové rozhraní Shelly:** Připojte se k AP zařízení před nastavením Wi-Fi — IP se zobrazí po uložení - **DHCP tabulka routeru:** Hledejte hostname jako `shelly1pm-AABBCCDDEE` - **mDNS:** Pingněte `shelly-.local` (např. `shelly1pm-AABBCCDDEE.local`) ze stejné sítě > [!TIP] > Přiřaďte zařízení Shelly **statickou IP** (DHCP rezervaci) ve vašem routeru, aby se adresa nezměnila po restartu routeru. ### Krok 3 — Konfigurace v TapHome 1. V TapHome přidejte nový modul **Packet Parser (HTTP)** 2. **IP Address:** zadejte IP z kroku 2 (např. `192.168.1.50`) 3. **Port:** `80` (výchozí, není potřeba měnit) 4. Importujte šablonu — TapHome bude pravidelně číst `/status` pro zjištění stavu zařízení > [!NOTE] > HTTP autentifikace je na zařízeních Shelly standardně vypnutá. Pokud jste povolili ochranu přihlášením, TapHome momentálně nepodporuje HTTP Basic Auth — pro integraci s TapHome ponechte autentifikaci vypnutou. ## Dostupná zařízení 2 Tato zařízení se po importu zobrazí v TapHome. Shelly TRV Modul Servisní atributy | | | |--------------------------|------------------------------------------------------------------------------------------------------------------------------| | WiFi SSID | | | IP adresa | | | MAC adresa | | | Síla přijímaného signálu | Síla Wi-Fi signálu v dBm — typicky dobrý rozsah -55 až -70 dBm, pod -80 dBm je nespolehlivá | | Zkalibrováno | Zda je mechanická kalibrace ventilu dokončena — zápisy setpointu a polohy ventilu jsou odmítány, dokud kalibrace neuspěje | | Rozvrh | Týdenní rozvrh zapnutý/vypnutý — pokud je zapnutý, firmware přepíše externě zapsané setpointy při nejbližší události rozvrhu | | Jas displeje | Úroveň jasu LED displeje (1 = slabý, 7 = silný) | | Převrácený displej | Zda je LED displej otočen o 180° pro montáž vzhůru nohama | Servisní akce | | | |-----------------------|-----------------------------------------------------------------------------------------------| | Vypnout rozvrh | Vypne týdenní rozvrh, aby externí setpointy nebyly vráceny při nejbližší události rozvrhu | | Restart | | | Kalibrovat | Spustí cyklus mechanické kalibrace ventilu — nutné po každém přesazení na jiné těleso ventilu | | Aktualizovat firmware | Spustí OTA aktualizaci firmwaru z oficiálního Shelly EU firmware serveru | | Nastavit jas displeje | Nastaví jas LED displeje (1 = slabý, 7 = silný) | | Převrátit displej | Přepne otočení displeje o 180° pro případy, kdy je ventil namontován vzhůru nohama | Vlastní proměnné Čtení (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í atributy 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í akce 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 Parametry: 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)); ``` Baterie Vícestavový přepínač Pouze ke čtení Úroveň nabití baterie jako přepínač s více hodnotami — Critical (<25 %), Low (25-50 %), Normal (50-75 %), Full (>75 %), Charging (USB-C připojeno). Stav nabíjení má přednost před úrovní numeric Jednotka: % multi-value switch Hodnoty / Stavy: Critical · Low · Normal · Full · Charging Čtení stavu přepínače ```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í atributy Value \[%] ```taphome PARSEJSON(status, "$.bat.value"); ``` Voltage \[V] ```taphome PARSEJSON(status, "$.bat.voltage"); ``` Termostat Termostat Čtení i zápis Termostat s uzavřenou smyčkou — zápis cílové teploty (5-30 °C), firmware interně řídí ventil pomocí vestavěného nebo externího senzoru numeric Jednotka: °C Servisní atributy | | | |-------------------------------|-------------------------------------------------------------------------------------------------------------------------------| | Teplotní ofset \[°C] | Statický ofset přičtený k naměřené pokojové teplotě — užitečný, když vestavěný senzor čte výše kvůli blízkosti horkých trubek | | Poloha ventilu \[%] | Aktuální otevření ventilu v procentech (0 = plně zavřeno, 100 = plně otevřeno) | | Nucené zavření | Zda je ventil nucen plně zavřen bez ohledu na setpoint | | Extra tlak | Zda je režim extra tlaku aktivní — aplikuje dodatečnou mechanickou sílu pro ovládání tuhých ventilů | | Automatická korekce kalibrace | Zda je na mechanický zdvih aplikována jemná korekce kalibrace | Servisní akce | | | |-------------------------|--------------------------------------------------------------------------------------------------------| | Nastavit teplotní ofset | Nastaví teplotní ofset senzoru (-20 až +20 °C) pro kompenzaci teplotního zkreslení vestavěného senzoru | | Přepnout nucené zavření | Přepne režim nuceného zavření — ventil zůstává plně zavřen bez ohledu na setpoint | | Přepnout extra tlak | Přepne režim extra tlaku — zesílí aktuaci ventilu pro tuhé ventily | Čtení teploty ```taphome PARSEJSON(status, "$.thermostats[0].tmp.value") ``` Čtení (modul) ```taphome if(! PARSEJSON(status, "$.thermostats[0].tmp.is_valid"), adderror("Temperature sensor error")); ``` Čtení požadované teploty ```taphome PARSEJSON(status, "$.thermostats[0].target_t.value") ``` Zápis požadované 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í atributy 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í akce Set temperature offset Parametry: 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)); ``` **Připojení:** Packet Parser → HTTP • Hostname: `shellytrv-{MAC}.local` Možná vylepšení (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 ## Parametry importu Tyto hodnoty zadáte při importu XML. | Ptá se v aplikaci | Výchozí | |-------------------|---------------| | 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ýrobců jsou © jejich příslušných vlastníků. Poskytujeme je tak, jak je výrobce zveřejnil, pouze pro informaci. ## Související dokumentace - [Integrace Packet Parser](https://taphome.com/cs/compatibility/packet-parser-guide/) - [Packet Parser (HTTP, TCP, UDP, FTP, MQTT)](https://taphome.com/cs/docs/integration/packet-parser/) - [Funkce Packet parser](https://taphome.com/cs/docs/script/packet-parser/) - [Funkce pro parsování](https://taphome.com/cs/docs/script/parsing-functions/)