Shelly TRV

Packet Parser → HTTP

Přidal

Poslední aktualizace: 04. 2026

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. 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.

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

Ujisti se, že radiátor je vypnutý a vychladlý.
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.
Nasaď správný adaptér, pokud závit ventilu není původní M30 × 1,5.
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.
Před úplným dotažením matice natoč displej do požadované orientace.
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.

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í).

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.

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.
Spusť service akci Calibrate na modulu (odešle /calibrate). Displej krátce zobrazí CL, dokud se motor pohybuje oběma směry.
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é

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.
Potvrď, že TapHome CCU a TRV jsou ve stejné síti / VLAN — Shelly Gen1 standardně neroutuje mezi podsítěmi.
Zkus mDNS hostname (shellytrv-XXXXXX.local) místo IP — DHCP lease se možná změnil.
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.

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.

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):

Stáhněte si aplikaci Shelly (iOS / Android)
Klepněte na + → Add Device a postupujte podle průvodce Bluetooth párováním
Po výzvě zadejte své Wi-Fi přihlašovací údaje

Možnost B — AP režim (bez aplikace):

Při prvním zapnutí zařízení vytvoří hotspot: ShellyXXX-AABBCCDDEE
Připojte telefon/PC k tomuto hotspotu
Otevřete http://192.168.33.1 → Internet & Security → Wi-Fi Mode - Client
Zadejte SSID a heslo → Save

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<model>-<mac>.local (např. shelly1pm-AABBCCDDEE.local) ze stejné sítě

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

V TapHome přidejte nový modul Packet Parser (HTTP)
IP Address: zadejte IP z kroku 2 (např. 192.168.1.50)
Port: 80 (výchozí, není potřeba měnit)
Importujte šablonu — TapHome bude pravidelně číst /status pro zjištění stavu zařízení

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í

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é

Shelly TRV

Čtení (modul)

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

PARSEJSON(status, "$.wifi_sta.ssid")

${ipAddress}

PARSEJSON(status, "$.wifi_sta.ip")

MAC

PARSEJSON(status, "$.mac")

Received signal strength

PARSEJSON(status, "$.wifi_sta.rssi")

Calibrated

if(PARSEJSON(status, "$.calibrated"), "${detail_deviceSettings_true}", "${detail_deviceSettings_false}")

Schedule

 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

PARSEJSON(settings, "$.display.brightness")

Display flipped

if(PARSEJSON(settings, "$.display.flipped"), "${detail_deviceSettings_true}", "${detail_deviceSettings_false}")

Servisní akce

Disable schedule

var response := SENDHTTPREQUEST("/settings/thermostats/0?schedule=false");
if(response.IsSuccess, return("OK"), return(response.Content));

Reboot

VAR response := SENDHTTPREQUEST("/reboot");
if(response.IsSuccess, return("OK"), return(response.Content));

Calibrate

VAR response := SENDHTTPREQUEST("/calibrate");
if(response.IsSuccess, return("OK"), return(response.Content));

Update firmware

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)

var response := SENDHTTPREQUEST("/settings?display_brightness=" + Br);
if(response.IsSuccess, return("OK"), return(response.Content));

Flip display

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

Baterie

Čtení stavu přepínače

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 [%]

PARSEJSON(status, "$.bat.value");

Voltage [V]

PARSEJSON(status, "$.bat.voltage");

Termostat Termostat

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

Termostat

Čtení teploty

PARSEJSON(status, "$.thermostats[0].tmp.value")

Čtení (modul)

if(! PARSEJSON(status, "$.thermostats[0].tmp.is_valid"), adderror("Temperature sensor error"));

Čtení požadované teploty

PARSEJSON(status, "$.thermostats[0].target_t.value")

Zápis požadované teploty

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]

PARSEJSON(settings, "$.thermostats[0].temperature_offset")

${device_variable_valvestate} [%]

PARSEJSON(status, "$.thermostats[0].pos")

Force close

if(PARSEJSON(settings, "$.thermostats[0].force_close"), "${detail_deviceSettings_true}", "${detail_deviceSettings_false}")

Extra pressure

if(PARSEJSON(settings, "$.thermostats[0].extra_pressure"), "${detail_deviceSettings_true}", "${detail_deviceSettings_false}")

Automatic calibration correction

if(PARSEJSON(settings, "$.thermostats[0].calibration_correction"), "${detail_deviceSettings_true}", "${detail_deviceSettings_false}")

Servisní akce

Set temperature offset

Parametry: Offset (-20–20 C)

VAR response := SENDHTTPREQUEST("/settings/thermostats/0?temperature_offset=" + C);
if(response.IsSuccess, return("OK"), return(response.Content));

Toggle force close

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

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

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

Stáhnout šablonu

Zdroje

Shelly Gen1 API Reference
shelly-api-docs.shelly.cloud 2026-03-12
Home Assistant Shelly Integration
www.home-assistant.io 2026-03-12
Shelly TRV — HTTP API (TRV-specific endpoints)
shelly-api-docs.shelly.cloud 2026-04-16
Shelly TRV — Knowledge Base
kb.shelly.cloud 2026-04-16
Shelly TRV — Multilingual User & Safety Guide
kb.shelly.cloud 2026-04-16
PDF
Peyanski — Home Assistant and Shelly TRV
peyanski.com 2026-04-16

Shelly TRV

Instalace hardwaru#

Kompatibilní tělesa ventilů

Postup montáže

Nabíjení

Konfigurace#

TapHome import

Vypnutí týdenního rozvrhu

Externí pokojový senzor (doporučeno)

Možnosti zařízení#

Stav baterie

Termostat (main šablona)

Dimmer ventilu (valve šablona)

Termostat (varianta valve šablony)

Modulové diagnostiky a akce

Další možnosti

Řešení problémů#

Device is not calibrated

Setpoint se každých pár hodin vrací na jiné hodnoty

Pokojová teplota je příliš vysoká

Displej zobrazuje E1 / E2

Zařízení je nedostupné

Jak nainstalovat v TapHome

Předpoklady#

Krok 1 — Připojte Shelly k Wi-Fi#

Krok 2 — Zjistěte IP adresu#

Krok 3 — Konfigurace v TapHome#

Dostupná zařízení

Shelly TRV

Baterie

Termostat

Zdroje

Instalace hardwaru

Konfigurace

Možnosti zařízení

Řešení problémů

Předpoklady

Krok 1 — Připojte Shelly k Wi-Fi

Krok 2 — Zjistěte IP adresu

Krok 3 — Konfigurace v TapHome