---
title: "Shelly TRV"
description: "Zadana sobna temperatura (5–30 °C) ili položaj ventila (0–100 %) na Wi-Fi glavi na baterije preko HTTP-a. Predložak TapHome za Shelly TRV."
url: "https://taphome.com/hr/compatibility/shelly-trv/"
language: hr
lastmod: 2026-04-18
generator: hugo
ai:
  topics: ["http","thermostat","wifi","battery-powered","radiator-valve","mdns"]
  questions: ["Kako integrirati Shelly TRV sa sustavom TapHome?","Koja je razlika između predložaka Shelly TRV za termostat i za ventil?","Kako kalibrirati Shelly TRV nakon ugradnje na radijator?","Zašto Shelly TRV odbija upis zadane temperature iz sustava TapHome?","Zašto Shelly TRV pokazuje previsoku sobnu temperaturu?","Kako isključiti tjedni raspored da bi TapHome upravljao zadanom temperaturom?"]
---

# Shelly TRV

Komunikacija: Packet Parser → HTTP

- [Baza znanja Shelly TRV](https://kb.shelly.cloud/knowledge-base/shelly-trv)
- [Dokumentacija API-ja Shelly Gen1](https://shelly-api-docs.shelly.cloud/gen1/#shelly-trv)

> Adresa u mreži
> 
> TapHome komunicira s uređajem na adresi unesenoj pri uvozu. Dodijelite uređaju stalnu adresu — rezervaciju IP adrese u usmjerivaču ili njegovo mDNS ime ako ga podržava — inače integracija prestaje raditi kada usmjerivač promijeni adresu.
> 
> [Priprema mreže](https://taphome.com/hr/docs/setup/network-preparation/)

## Upute za integraciju

Shelly TRV (SHTRV-01) je Wi-Fi termostatska radijatorska glava na baterije tvrtke Allterco Robotics. Postavlja se izravno na tijelo standardnog radijatorskog ventila za toplu vodu i regulira sobnu temperaturu tako da unutarnjim motorom pomiče iglu ventila. TapHome s uređajem komunicira preko HTTP-a u lokalnoj mreži, bez pristupnika, bez oblaka i bez MQTT brokera.

Shelly TRV se **više ne proizvodi**, a naslijedila ga je glava [Shelly BLU TRV](https://www.shelly.com/products/shelly-blu-trv) s Bluetooth vezom. Postojeći uređaji i dalje rade i ovaj predložak ostaje u potpunosti podržan; za nove projekte razmislite o nasljedniku.

Za isti fizički uređaj dostupna su dva alternativna predloška. Odaberite jedan prema željenom načinu upravljanja.

| Predložak | Prikazuje | Primjena |
|----------|---------|----------|
| **Shelly TRV** (glavni) | Baterija + termostat sa zatvorenom regulacijskom petljom | Korisničko upravljanje sobnom temperaturom preko zadane temperature (5–30 °C). Ventilom interno upravlja firmver. |
| **Shelly TRV (valve)** | Baterija + dimer ventila + termostat (varijanta za zadanu temperaturu) | Smart rules kojima treba izravno preuzimanje upravljanja ventilom: položaj ventila prikazuje se kao dimer 0,0–1,0. |

> [!WARNING]
> Ne uvozite oba predloška za isti fizički uređaj. Oba se vežu na istu krajnju točku pa bi se ciklusi očitavanja sudarali: upisi bi bili u sukobu, a ponašanje ventila postalo bi nepredvidivo.

## Ugradnja uređaja

Shelly TRV **nema ožičenje**. To je mehanička radijatorska glava s unutarnjom elektronikom, napajana unutarnjom Li-ion baterijom (Panasonic NCR18650BD, 3,7 V / 6500 mAh). Postavlja se izravno na tijelo radijatorskog ventila pomoću metalnog pričvrsnog prstena.

### Kompatibilna tijela ventila

Izvorni navoj: **M30 × 1,5**. U prodajnom pakiranju nalaze se ovi adapteri:

- **Danfoss** — RA, RAV, RAVL
- **Caleffi**
- **Giacomini**
- **M28 × 1,5** — Sam, Slovarm, Comap, TA, Herz, MMA, Remagg
- **Pont à Mousson**

Adapteri drugih proizvođača (nisu priloženi) proširuju kompatibilnost na Gampper, Ista, Meges, Ondal, Oventrop, Rossweiner, Vaillant i druge.

### Postupak ugradnje

1. Provjerite je li radijator isključen i ohlađen.
2. Postojeću ručnu glavu ventila okrenite suprotno od kazaljke na satu do potpunog otvaranja, a zatim odvijte metalni pričvrsni prsten i skinite je.
3. Ako navoj ventila nije izvorni M30 × 1,5, postavite odgovarajući adapter.
4. Postavite Shelly TRV na tijelo ventila i metalni prsten zategnite u smjeru kazaljke na satu, čvrsto, ali ne prejako. Kalibracija ne uspijeva ni kad je prsten prelabavo ni kad je prečvrsto zategnut.
5. Prije konačnog zatezanja prstena okrenite zaslon u željeni položaj.
6. Kratko pritisnite tipkalo **Reset** (na stražnjoj strani uređaja). Na zaslonu se prikazuje `CL` (kalibracija), a unutarnji motor pomiče se u oba smjera. Uspješna kalibracija završava prikazom `AP` na zaslonu, a neuspješna prikazuje `E1`.

> [!NOTE]
> Kalibraciju treba provesti nakon svakog ponovnog postavljanja na drugo tijelo ventila. Dok nije `calibrated=true`, upisi zadane temperature i položaja ventila iz sustava TapHome odbijaju se uz poruku `Device is not calibrated`.

### Punjenje

Uređaj se puni preko **USB-C** priključka (kabel je priložen, adapter nije). Punjač USB-C od najmanje 1 A napuni praznu bateriju do kraja za približno 5 sati. Tipično trajanje baterije je oko 2 godine (oko 5 mjeseci neprekidne sezone grijanja pri uobičajenoj upotrebi).

> [!WARNING]
> Tijekom punjenja kućište uređaja se zagrijava, a unutarnji senzor temperature mjeri netočno. Očekujte iskrivljene vrijednosti sobne temperature sve dok `charger` nije `disconnected`.

## Konfiguracija

### Uvoz u TapHome

Pri uvozu predloška TapHome traži samo jedan parametar:

| Parametar | Opis | Zadano |
|-----------|-------------|---------|
| `IpAddress` | Lokalna IP adresa ili mDNS naziv hosta uređaja | `192.168.0.1` |

Port `80` je fiksan. Gen1 ne podržava HTTPS. HTTP Basic Auth na uređaju mora biti **isključena**, jer TapHome HTTP zahtjeve prema uređajima Shelly Gen1 ne autentificira.

Kad god je moguće, koristite mDNS naziv hosta (`shellytrv-XXXXXX.local`), jer je otporan na promjene DHCP zakupa. **IP Scanner** u sustavu TapHome (Settings → Network → Scan) pronalazi i IP adresu i mDNS naziv hosta.

### Isključivanje tjednog rasporeda

Shelly TRV ima ugrađeni tjedni raspored (5 profila, do 18 planiranih promjena tjedno po profilu). Kada je raspored uključen, firmver pri sljedećem planiranom događaju prepisuje svaku izvana upisanu zadanu temperaturu, pa se zadane temperature iz sustava TapHome bez upozorenja vraćaju.

Predložak to prikazuje kao upozorenje (`Schedule is enabled`). Prije nego što uređaj predate na upravljanje sustavu TapHome:

- pokrenite servisnu radnju **Isključi raspored** na modulu (šalje `/settings/thermostats/0?schedule=false`) ili
- odaberite profil **Disable** u aplikaciji Shelly Cloud ili u web-sučelju uređaja.

### Vanjski sobni senzor (preporučeno)

Ugrađeni senzor temperature fizički je blizu vruće cijevi radijatora i obično pokazuje **1–3 °C više od stvarne sobne temperature**. Dostupna su dva načina korekcije:

- **Vanjski senzor** — uparite zaseban Wi-Fi termometar (npr. **Shelly H&T**) preko web-sučelja uređaja → **Sensor Settings** → **Enable external temperature corrections endpoint**. Vanjski senzor tada šalje (POST) temperaturu prostorije glavi.
- **Statički pomak** — servisnom radnjom **Postavi pomak temperature** na uređaju Termostat (raspon ±20 °C) kompenzirajte stalno odstupanje.

Za najbolju toplinsku ugodnost kombinirajte pouzdan vanjski senzor s malim statičkim pomakom kao rezervom.

## Mogućnosti uređaja

Glavni predložak prikazuje uređaj kao pokazatelj baterije i termostat sa zatvorenom regulacijskom petljom. Predložak za ventil zadržava isti modul i bateriju, ali položaj ventila prikazuje kao dimer i koristi varijantu za zadanu temperaturu koja pri upisu isključuje automatsku PID regulaciju. Dijagnostika i radnje na razini modula jednake su u oba predloška.

### Stanje baterije

Baterija se prikazuje kao **prekidač s više vrijednosti** izveden iz javljene razine napunjenosti i stanja USB-C punjača. Stanje punjača ima prednost pred razinom:

| Stanje | Uvjet |
|-------|-----------|
| Kritična | `bat.value < 25` |
| Niska | `bat.value 25-50` |
| Normalna | `bat.value 50-75` |
| Puna | `bat.value > 75` |
| Punjenje | `charger != disconnected` |

Dva dodatna servisna atributa javljaju neobrađenu vrijednost napunjenosti baterije (`%`) i napon ćelije (V, nazivno oko 3,7 V, tipični raspon 2,6–4,2 V). Predložak javlja `Low battery` ispod 50 % i `Battery charge is critically low` ispod 25 %.

### Termostat (glavni predložak)

Sobni termostat sa zatvorenom regulacijskom petljom: TapHome upisuje zadanu temperaturu, a firmver glave interno upravlja položajem ventila na temelju ugrađenog (ili vanjskog) senzora temperature.

- **Čitanje:** izmjerena sobna temperatura (`thermostats[0].tmp.value`) i aktivna zadana temperatura (`thermostats[0].target_t.value`)
- **Upis:** zadana temperatura 5–30 °C preko `/settings/thermostats/0?target_t={Se}`

Dodatni atributi termostata su **Pomak temperature [°C]**, **Položaj ventila [%]** (samo za čitanje, za uvid u izlaz PID regulatora), **Prisilno zatvaranje**, **Dodatni pritisak** i **Automatska korekcija kalibracije**. Odgovarajuće servisne radnje omogućuju sustavu TapHome postavljanje pomaka, uključivanje i isključivanje načina prisilnog zatvaranja (ventil ostaje potpuno zatvoren bez obzira na zadanu temperaturu) i načina dodatnog pritiska (pojačava pokretanje krutih ventila).

Upisi zadane temperature ne uspijevaju s porukom `Device is not calibrated` dok je `calibrated=false`, a predložak dodaje upozorenje kada je tjedni raspored uključen (jer će firmver pri sljedećem događaju rasporeda prepisati vanjske upise).

### Dimer ventila (predložak za ventil)

Alternativni predložak prikazuje pogon ventila izravno kao dimer (0,0–1,0 → 0–100 %). TapHome upisuje položaj preko `/thermostats/0?pos={Le*100}`. Firmver pomiče motor u traženi položaj i pritom implicitno isključuje automatsku regulaciju prema zadanoj temperaturi.

Predložak za ventil na uređaju ventila dodaje servisne atribute `Force close`, `Extra pressure` i `Automatic calibration correction` (uz odgovarajuće radnje za uključivanje i isključivanje), tako da autori smart rules mogu izravno upravljati motorom u scenarijima kao što su hitno zatvaranje, ručno predgrijavanje ili pojačano grijanje (boost).

### Termostat (varijanta predloška za ventil)

Predložak za ventil i dalje prikazuje termostat, kako bi se zadana temperatura mogla upisivati iz iste grupe uređaja TapHome, ali njegova skripta upisa šalje **i** `target_t` **i** `target_t_enabled=false`, kako PID regulacija u firmveru ne bi ometala ručno upravljanje ventilom. Skup servisnih atributa sveden je na **Pomak temperature [°C]** (atributi tijela ventila kao što su `force_close` i `valve_state` premješteni su na uređaj ventila). Predložak upozorava kada uoči `target_t.enabled=true`, jer to znači sukob između dimera ventila i automatske regulacije.

### Dijagnostika i radnje modula

Modul (glava) očitava `/status` i `/settings` svake 3 sekunde i prikazuje dijagnostiku i radnje za cijeli uređaj:

- **Dijagnostika:** Wi-Fi SSID, IP adresa, MAC, jačina primljenog signala (RSSI u dBm), stanje kalibracije, raspored uključen/isključen, svjetlina zaslona (1–7) i stanje okrenutog zaslona.
- **Radnje:** Isključi raspored, Ponovno pokretanje, Kalibriraj (pokreće `/calibrate`), Ažuriraj firmver (preuzima `SHTRV-01_build.gbl` sa službenog poslužitelja firmvera Shelly EU), Postavi svjetlinu zaslona i Okreni zaslon.

### Dodatne mogućnosti

Uređaj nudi još nekoliko funkcija Gen1 koje trenutačni predlošci još ne prikazuju: pasivno prepoznavanje otvorenog prozora (`/window`), simetričnu radnju **Force open**, rezervnu temperaturu prostorije (`auto_temp`), zaštitu od djece, odgodu automatskog zatvaranja pri otvorenom prozoru, senzor planirane zadane temperature (`schedule_t`), indeks aktivnog profila, preostale minute pojačanog grijanja i radnju **Trigger boost** (`/thermostats/0?boost_minutes=N`), toplinsko stanje unutarnje elektronike (`tmp_state`) te dostupnost ažuriranja firmvera kao senzor. CoIoT push i MQTT prijenos podržani su na razini uređaja, ali se ne koriste: TapHome umjesto toga očitava `/status` svake 3 s. Te se funkcije mogu dodati u budućem ažuriranju predloška.

## Rješavanje problema

### Device is not calibrated

Svaki upis zadane temperature i položaja ventila vraća `Device is not calibrated` sve dok glava ne završi uspješan ciklus kalibracije.

1. Provjerite sjedi li uređaj čvrsto na tijelu ventila. Pričvrsni prsten mora biti dovoljno zategnut da motor može pritisnuti iglu ventila, ali ne toliko da se deformira.
2. Pokrenite servisnu radnju **Kalibriraj** na modulu (šalje `/calibrate`). Na zaslonu se nakratko prikazuje `CL` dok se motor pomiče u oba smjera.
3. Nakon uspjeha `calibrated` postaje `true` i upisi uspijevaju. Neuspjeh se prikazuje kao `E1` na zaslonu i obično znači neispravnu ugradnju.

### Zadana temperatura se vraća svakih nekoliko sati

To tjedni raspored prepisuje vanjske upise. Provjerite servisni atribut **Raspored**: ako je uključen, pokrenite radnju **Isključi raspored** na modulu ili isključite aktivni profil u aplikaciji Shelly Cloud.

### Sobna temperatura je previsoka

Dva česta uzroka:

- **Spojen punjač.** Očitanja sobne temperature nisu valjana dok je `charger != disconnected`. Odspojite USB-C i pustite uređaj da se ohladi.
- **Odstupanje ugrađenog senzora.** Senzor je blizu vrućih cijevi i obično pokazuje 1–3 °C više. Uključite krajnju točku za vanjske korekcije temperature i uparite Shelly H&T (ili kompatibilan Wi-Fi termometar) u istoj prostoriji ili postavite statički pomak radnjom **Postavi pomak temperature** (npr. `-1.5 °C`).

### Zaslon prikazuje E1 / E2

`E1` — problem s kalibracijom. Ponovno postavite uređaj, pažljivo zategnite prsten i pokrenite novi ciklus kalibracije.

`E2` — problem sa senzorom temperature. `tmp.is_valid` u `/status` postaje `false`, a predložak dodaje grešku `Temperature sensor error`. Ako problem ostane i nakon ponovnog pokretanja, senzor je vjerojatno neispravan; obratite se podršci tvrtke Shelly.

### Uređaj nije dostupan

1. Provjerite je li glava spojena na Wi-Fi: držite **Up + Down** 5 s i prođite kroz parametre stanja; `CO` znači spojen Wi-Fi klijent.
2. Provjerite jesu li centralna jedinica TapHome (CCU) i glava u istoj mreži / VLAN-u, jer Shelly Gen1 prema zadanim postavkama ne usmjerava promet između podmreža.
3. Umjesto IP adrese pokušajte s mDNS nazivom hosta (`shellytrv-XXXXXX.local`), jer se DHCP zakup možda promijenio.
4. U pregledniku otvorite `http://{device-ip}/status`. Ako stigne JSON odgovor, uređaj je dostupan, a problem je u konfiguraciji sustava TapHome.

> [!WARNING]
> Uređaji Shelly Gen1 prihvaćaju samo **2 istodobne HTTP veze**. Ako TapHome i drugi sustav (Home Assistant, Node-RED) istodobno očitavaju isti uređaj, komunikacija postaje nepouzdana. Interval očitavanja ostavite na zadanoj vrijednosti predloška (3 s) i izbjegavajte dodatna očitavanja iz drugih sustava.

> [!NOTE]
> Uključivanje MQTT-a na uređajima Shelly Gen1 **nepovratno isključuje Shelly Cloud**. TapHome koristi samo HTTP; MQTT ostavite isključen, osim ako izričito ne želite prijeći sa Shelly Clouda.

## Kako ga instalirati u TapHome

### Preduvjeti

- Uređaj Shelly ugrađen i uključen
- Lokalna Wi-Fi mreža (2,4 GHz)
- TapHome CCU u istoj mreži

### Korak 1 — Spojite Shelly na Wi-Fi

**Opcija A — aplikacija Shelly (preporučeno):**

1. Preuzmite [aplikaciju Shelly](https://www.shelly.com/en/support/shelly-app) (iOS / Android)
2. Dodirnite **+** → **Add Device** i slijedite čarobnjak za uparivanje preko Bluetootha
3. Kada se to zatraži, unesite podatke za prijavu na Wi-Fi

**Opcija B — način rada AP (bez aplikacije):**

1. Pri prvom uključivanju uređaj stvara pristupnu točku: `ShellyXXX-AABBCCDDEE`
2. Spojite telefon ili računalo na tu pristupnu točku
3. Otvorite `http://192.168.33.1` → **Internet & Security** → **Wi-Fi Mode - Client**
4. Unesite SSID i lozinku → **Save**

> [!NOTE]
> Shelly podržava samo mreže od **2,4 GHz**. Mreže od 5 GHz neće se prikazati pri skeniranju.

### Korak 2 — Pronađite adresu uređaja

Uređaji Shelly Gen1 podržavaju **mDNS** (Zeroconf). Uređaju možete pristupiti preko naziva hosta umjesto IP adrese:

```
shelly<model>-<MAC>.local
```

Na primjer: `shelly1pm-AABBCCDDEE.local` (MAC adresa velikim slovima u heksadecimalnom zapisu, bez dvotočaka).

> [!TIP]
> **Preporučeno: koristite IP skener TapHome.** Otvorite aplikaciju TapHome i pokrenite **IP skener** (Postavke → Mreža → Skeniranje). Skener pronalazi uređaje u vašoj mreži i prikazuje IP adresu i mDNS naziv hosta. Za pouzdaniju vezu koristite **naziv hosta** umjesto IP adrese, jer ostaje isti i kada se IP adresa uređaja promijeni nakon ponovnog pokretanja usmjerivača.

**Drugi načini** za pronalaženje IP adrese:

- **Aplikacija Shelly:** detalji uređaja → **Device info** → IP adresa
- **Web-sučelje Shelly:** spojite se na AP uređaja prije postavljanja Wi-Fi mreže — IP adresa prikazuje se nakon spremanja
- **DHCP tablica usmjerivača:** potražite naziv hosta poput `shelly1pm-AABBCCDDEE`

### Korak 3 — Konfiguracija u sustavu TapHome

1. U sustavu TapHome dodajte novi modul **Packet Parser (HTTP)**
2. **Adresa:** unesite mDNS naziv hosta (npr. `shelly1pm-AABBCCDDEE.local`) ili IP adresu iz koraka 2
3. **Port:** `80` (zadano, nije potrebno mijenjati)
4. Uvezite predložak — TapHome će čitati `/status` kako bi očitao stanje uređaja

> [!NOTE]
> HTTP autentifikacija na uređajima Shelly zadano je isključena. Ako ste uključili zaštitu prijavom, TapHome trenutačno ne podržava HTTP Basic Auth — za integraciju sa sustavom TapHome ostavite autentifikaciju isključenom.

## Dostupni uređaji 2

Ovi se uređaji pojavljuju u TapHomeu nakon uvoza.

Shelly TRV Modul

Servisni atributi

|                           |                                                                                                                                             |
|---------------------------|---------------------------------------------------------------------------------------------------------------------------------------------|
| Wi-Fi SSID                |                                                                                                                                             |
| IP adresa                 |                                                                                                                                             |
| MAC adresa                |                                                                                                                                             |
| Jačina primljenog signala | Jačina Wi-Fi signala u dBm — tipično dobar raspon od -55 do -70 dBm, ispod -80 dBm veza je nepouzdana                                       |
| Kalibrirano               | Je li mehanička kalibracija ventila završena — upisi zadane temperature i položaja ventila odbijaju se dok kalibracija ne uspije            |
| Raspored                  | Tjedni raspored uključen/isključen — kada je uključen, firmver pri sljedećem događaju rasporeda prepisuje izvana upisane zadane temperature |
| Svjetlina zaslona         | Razina svjetline LED zaslona (1 = slabo, 7 = jako)                                                                                          |
| Zaslon okrenut            | Je li LED zaslon okrenut za 180° zbog ugradnje naopako                                                                                      |

Servisne radnje

|                           |                                                                                                                   |
|---------------------------|-------------------------------------------------------------------------------------------------------------------|
| Isključi raspored         | Isključuje tjedni raspored kako se vanjske zadane temperature ne bi vraćale pri sljedećem događaju rasporeda      |
| Ponovno pokretanje        |                                                                                                                   |
| Kalibriraj                | Pokreće ciklus mehaničke kalibracije ventila — obvezno nakon svakog ponovnog postavljanja na drugo tijelo ventila |
| Ažuriraj firmver          | Pokreće OTA ažuriranje firmvera sa službenog poslužitelja firmvera Shelly EU                                      |
| Postavi svjetlinu zaslona | Postavlja svjetlinu LED zaslona (1 = slabo, 7 = jako)                                                             |
| Okreni zaslon             | Uključuje ili isključuje okretanje zaslona za 180° kada je ventil ugrađen naopako                                 |

Prilagođene varijable

Čitanje (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
```

Servisni atributi

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}")
```

Servisne radnje

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

Parametri: 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));
```

Baterija Prekidač s više vrijednosti Samo za čitanje

Razina napunjenosti baterije kao prekidač s više vrijednosti — Kritična (&lt;25 %), Niska (25–50 %), Normalna (50–75 %), Puna (&gt;75 %), Punjenje (spojen USB-C). Stanje punjenja ima prednost pred razinom

numeric Jedinica: % multi-value switch

Vrijednosti / stanja: Critical · Low · Normal · Full · Charging

Čitanje stanja sklopke

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

Servisni atributi

Value \[%]

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

Voltage \[V]

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

Termostat Termostat Čitanje i pisanje

Sobni termostat sa zatvorenom regulacijskom petljom — upisuje se zadana temperatura (5–30 °C), a firmver interno upravlja ventilom na temelju ugrađenog ili vanjskog senzora

numeric Jedinica: °C

Servisni atributi

|                                  |                                                                                                                                                      |
|----------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------|
| Pomak temperature \[°C]          | Statički pomak koji se dodaje izmjerenoj sobnoj temperaturi — koristan kada ugrađeni senzor zbog blizine vruće cijevi pokazuje previsoku temperaturu |
| Položaj ventila \[%]             | Trenutačno otvorenje ventila u postocima (0 = potpuno zatvoren, 100 = potpuno otvoren)                                                               |
| Prisilno zatvaranje              | Je li ventil prisilno potpuno zatvoren bez obzira na zadanu temperaturu                                                                              |
| Dodatni pritisak                 | Je li aktivan način dodatnog pritiska — primjenjuje dodatnu mehaničku silu za pokretanje teško pokretljivih ventila                                  |
| Automatska korekcija kalibracije | Primjenjuje li se fina korekcija kalibracije na mehanički hod                                                                                        |

Servisne radnje

|                                      |                                                                                                                       |
|--------------------------------------|-----------------------------------------------------------------------------------------------------------------------|
| Postavi pomak temperature            | Postavlja pomak temperature senzora (od -20 do +20 °C) za kompenzaciju previsokog očitanja ugrađenog senzora          |
| Uključi/isključi prisilno zatvaranje | Uključuje ili isključuje način prisilnog zatvaranja — ventil ostaje potpuno zatvoren bez obzira na zadanu temperaturu |
| Uključi/isključi dodatni pritisak    | Uključuje ili isključuje način dodatnog pritiska — pojačava pokretanje teško pokretljivih ventila                     |

Čitanje temperature

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

Čitanje (modul)

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

Čitanje željene temperature

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

Zapis željene temperature

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

Servisni atributi

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}")
```

Servisne radnje

Set temperature offset

Parametri: 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));
```

**Povezivanje:** Packet Parser → HTTP • Naziv računala (hostname): `shellytrv-{MAC}.local`

Moguća poboljšanja (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

## Parametri uvoza

Ove vrijednosti unosite pri uvozu XML-a.

| Pitanje u aplikaciji | Zadano        |
|----------------------|---------------|
| IP adresa            | `192.168.0.1` |

## Izvori

- 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

Dokumenti proizvođača zaštićeni su autorskim pravom (©) svojih vlasnika. Dostupni su onako kako ih je proizvođač objavio, samo za informaciju.

## Povezana dokumentacija

- [Packet Parser Integration](https://taphome.com/hr/compatibility/packet-parser-guide/)
- [Packet Parser (HTTP, TCP, UDP, FTP, MQTT)](https://taphome.com/hr/docs/integration/packet-parser/)
- [Funkcije Packet parsera](https://taphome.com/hr/docs/script/packet-parser/)
- [Funkcije za raščlambu](https://taphome.com/hr/docs/script/parsing-functions/)

