---
title: "Shelly 2.5"
description: "Upravljanje dvokanalnim relejem s mjerenjem snage po kanalu preko HTTP-a. Predložak TapHome za Shelly 2.5 (Gen1, relejni način rada)."
url: "https://taphome.com/hr/compatibility/shelly-2-5/"
language: hr
lastmod: 2026-03-29
generator: hugo
ai:
  topics: ["http","i/o-module","wifi","relay","power-metering","dual-channel"]
  questions: ["Kako integrirati Shelly 2.5 sa sustavom TapHome?","Što mjeri predložak TapHome za Shelly 2.5?","Kako spojiti Shelly 2.5 na TapHome preko HTTP-a?","Podržava li predložak TapHome za Shelly 2.5 način rada za rolete?","Zašto se očitanje energije na kanalu 1 uređaja Shelly 2.5 čini previsokim?","Koji su servisni atributi dostupni za releje Shelly 2.5 u sustavu TapHome?"]
---

# Shelly 2.5

Komunikacija: Packet Parser → HTTP

- [Stranica proizvoda Shelly 2.5](https://www.shelly.com/en/products/shop/shelly-25)
- [Dokumentacija API-ja Shelly 2.5](https://shelly-api-docs.shelly.cloud/gen1/#shelly2-5)

> 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 2.5 kompaktan je dvokanalni Wi-Fi relej s ugrađenim mjerenjem snage na oba kanala. Stane iza standardnog zidnog prekidača i može upravljati dvama neovisnim strujnim krugovima, svakim do 10 A (2300 W pri 230 V), uz najveću ukupnu struju od 20 A. Uređaj podržava dva načina rada: relejni (dvije neovisne sklopke) i način za rolete (usklađeno upravljanje motorom). Predložak TapHome podržava samo relejni način rada. TapHome s uređajem komunicira preko HTTP-a u lokalnoj mreži, veza s oblakom nije potrebna.

Predložak daje dvije relejne sklopke i dva brojila energije (jedno po kanalu) te servisnu radnju za prebacivanje između relejnog načina rada i načina za rolete.

## Konfiguracija

Shelly 2.5 spaja se preko Wi-Fi mreže. Pri uvozu predloška TapHome unesite IP adresu uređaja (u predlošku je unaprijed upisan primjer `192.168.0.1`).

Trenutačni način rada prikazuje se kao servisni atribut modula („Način rada”) i može se promijeniti servisnom radnjom „Način rada”. Promjena između relejnog načina rada i načina za rolete stupa na snagu tek nakon ponovnog pokretanja uređaja.

## Mogućnosti uređaja

### Upravljanje relejem

Predložak daje dva neovisna relejna kanala. Stanje svakog releja čita se iz pripadajuće krajnje točke `/relay/` (polje `ison`), a relejem se upravlja s `turn=on` ili `turn=off`.

- **Kanal 1** — čita `/relay/0` i njime upravlja
- **Kanal 2** — čita `/relay/1` i njime upravlja

Svaki relej ima tri servisna atributa:

- **Prekoračenje snage** — je li na kanalu otkriveno prekoračenje snage
- **Pregrijavanje** — je li uređaj prešao sigurnu radnu temperaturu
- **Mjerač snage** — valjanost mjerenja (OK ili Fault)

### Mjerenje snage

Svaki kanal ima vlastito brojilo energije koje čita dvije vrijednosti iz svoje krajnje točke `/meter/`:

- **Trenutačna snaga** — `power` u vatima, predložak je pretvara u kW
- **Ukupna potrošnja** — `total` u vat-minutama, predložak je pretvara u kWh

Svako brojilo energije ima servisni atribut „Prekoračenje snage” koji prikazuje graničnu vrijednost prekoračenja snage (u vatima, podijeljeno s 1000).

Brojila su samo za čitanje i automatski se ažuriraju u svakom ciklusu očitavanja (interval 15 sekundi).

> [!WARNING]
> **Poznati problem: očitanje energije na kanalu 1 je 10 puta previsoko.** Predložak za kanal 1 dijeli `total` sa 6000 umjesto sa 60000 (kanal 2 to radi ispravno). Zbog toga je ukupna vrijednost energije za kanal 1 približno 10 puta veća od stvarne potrošnje. Riječ je o grešci u formuli za pretvorbu u predlošku.

### Dodatne mogućnosti

Shelly 2.5 izvorno podržava potpuno upravljanje roletama (otvaranje, zatvaranje i zaustavljanje s položajem 0–100 % nakon kalibracije), jednominutne pomične prosjeke snage po kanalu, stanja fizičkih ulaza za prekidače, unutarnju temperaturu uređaja, jačinu Wi-Fi signala i timere za automatsko isključivanje po kanalu. Uređaj može spremiti i do četiri omiljena položaja rolete. Te se mogućnosti mogu dodati u nekom budućem ažuriranju predloška.

> [!NOTE]
> Za razliku od predloška Shelly 1PM, predložak Shelly 2.5 ne prikazuje dijagnostiku uređaja kao što su naziv hosta, MAC adresa, vrijeme rada, zauzeće RAM-a, stanje oblaka/MQTT-a, dostupnost ažuriranja firmvera ili unutarnja temperatura. Nema ni servisnu radnju za zaštitu od prekoračenja snage (ograničenje najveće snage) ni radnju za ponovno pokretanje.

## Rješavanje problema

### Uređaj ne odgovara

1. Provjerite je li Shelly spojen na Wi-Fi i ima li valjanu IP adresu
2. Umjesto IP adrese pokušajte koristiti mDNS naziv hosta (`shellyswitch25-AABBCCDDEE.local`), jer se IP adresa možda promijenila nakon obnove DHCP zakupa
3. U pregledniku otvorite `http://{device-ip}/shelly`. Ako se stranica otvori, uređaj je dostupan
4. Provjerite jesu li centralna jedinica TapHome (CCU) i Shelly u istoj mreži / VLAN-u

### Očitanja snage pokazuju nulu

1. Provjerite je li trošilo spojeno preko releja Shelly (a ne premošteno)
2. Provjerite je li relej uključen, jer brojilo mjeri samo kada kroz relej teče struja
3. Ručno očitajte `/meter/0` ili `/meter/1` i provjerite vraća li `power` vrijednost različitu od nule

### Ukupna energija na kanalu 1 čini se netočnom

Predložak ukupnu vrijednost za kanal 1 dijeli sa 6000 umjesto s ispravnih 60000 (koje koristi kanal 2). Zbog toga je ukupna vrijednost energije za kanal 1 10 puta veća od stvarne. Unutar predloška trenutačno ne postoji zaobilazno rješenje, jer je faktor pretvorbe ugrađen u skriptu za očitavanje.

> [!WARNING]
> Uređaji Shelly Gen1 podržavaju samo **2 istodobne HTTP veze**. Ako TapHome i drugi sustav (npr. Home Assistant) istodobno očitavaju isti uređaj, komunikacija može postati nepouzdana. Krajnje točke releja očitavaju se svakih 2,5 sekunde, a krajnje točke brojila svakih 15 sekundi.

## 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 4

Ovi se uređaji pojavljuju u TapHomeu nakon uvoza.

Shelly 2.5 Modul

Servisni atributi

|            |
|------------|
| Način rada |

Servisne radnje

|            |
|------------|
| Način rada |

Servisni atributi

Mode

```taphome
 VAR response := SENDHTTPREQUEST("/settings");
 IF response.IsSuccess
  VAR content := response.Content;
  VAR responseHeaders := response.Headers;
  RETURN(PARSEJSON(content, "mode"));
 END
```

Servisne radnje

Mode

Parametri: Mode

```taphome
var St := SWITCH(mo, 1, "roller", "relay");
 VAR response := SENDHTTPREQUEST("/settings?mode=" + St);
```

Brojilo energije — kanal 1 Brojilo električne energije Samo za čitanje

Mjerenje potrošnje snage i energije za kanal 1 — trenutačna snaga (kW) i ukupna energija (kWh). Napomena: očitanje energije je 10 puta previsoko zbog pogrešnog djelitelja u predlošku (/6000 umjesto /60000)

numeric Jedinica: W / kWh

Servisni atributi

|                    |
|--------------------|
| Prekoračenje snage |

Čitanje ukupne potrošnje

```taphome
VAR response := SENDHTTPREQUEST("/meter/0");
 IF response.IsSuccess
  VAR content := response.Content;
 VAR responseHeaders := response.Headers;
 RETURN(PARSEJSON(content, "total")/6000);
 ELSE 
 ADDERROR(response.StatusCode + " (" + response.ReasonPhrase + ")");
  RETURN(NaN);
 END
```

Čitanje zahtjeva

```taphome
VAR response := SENDHTTPREQUEST("/meter/0");
 IF response.IsSuccess
  VAR content := response.Content;
 VAR responseHeaders := response.Headers;
 RETURN(PARSEJSON(content, "power")/1000);
 ELSE 
 ADDERROR(response.StatusCode + " (" + response.ReasonPhrase + ")");
  RETURN(NaN);
 END
```

Servisni atributi

Overpower

```taphome
 VAR response := SENDHTTPREQUEST("/meter/0");
 IF response.IsSuccess
  VAR content := response.Content;
 RETURN((PARSEJSON(content, "overpower")/1000) + " W");
 END
```

Brojilo energije — kanal 2 Brojilo električne energije Samo za čitanje

Mjerenje potrošnje snage i energije za kanal 2 — trenutačna snaga (kW) i ukupna energija (kWh)

numeric Jedinica: W / kWh

Servisni atributi

|                    |
|--------------------|
| Prekoračenje snage |

Čitanje ukupne potrošnje

```taphome
VAR response := SENDHTTPREQUEST("/meter/1");
 IF response.IsSuccess
  VAR content := response.Content;
 VAR responseHeaders := response.Headers;
 RETURN(PARSEJSON(content, "total")/60000);
 ELSE 
 ADDERROR(response.StatusCode + " (" + response.ReasonPhrase + ")");
  RETURN(NaN);
 END
```

Čitanje zahtjeva

```taphome
VAR response := SENDHTTPREQUEST("/meter/1");
 IF response.IsSuccess
  VAR content := response.Content;
 VAR responseHeaders := response.Headers;
 RETURN(PARSEJSON(content, "power")/1000);
 ELSE 
 ADDERROR(response.StatusCode + " (" + response.ReasonPhrase + ")");
  RETURN(NaN);
 END
```

Servisni atributi

Overpower

```taphome
 VAR response := SENDHTTPREQUEST("/meter/1");
 IF response.IsSuccess
  VAR content := response.Content;
 VAR responseHeaders := response.Headers;
 RETURN((PARSEJSON(content, "overpower")/1000) + " W");
 END
```

Relej — kanal 1 Sklopka Čitanje i pisanje

boolean

Vrijednosti / stanja: ON · OFF

Čitanje stanja sklopke

```taphome
VAR response := SENDHTTPREQUEST("/relay/0");
 IF response.IsSuccess
  VAR content := response.Content;
  VAR responseHeaders := response.Headers;
  RETURN(PARSEJSON(content, "ison"));
 ELSE
  ADDERROR(response.StatusCode + " (" + response.ReasonPhrase + ")");
  RETURN(NaN);
 END
```

Zapis stanja sklopke

```taphome
var turn := Switch(St, 1, "on", "off");
 VAR response := SENDHTTPREQUEST("/relay/0?turn=" + turn);
 IF response.IsSuccess = false
  ADDERROR(response.StatusCode);
 END
```

Servisni atributi

Overpower

```taphome
 VAR response := SENDHTTPREQUEST("/relay/0");
 IF response.IsSuccess
  VAR content := response.Content;
  RETURN(IF(PARSEJSON(content, "overpower"),"Yes", "No"));
 END
```

Overtemperature

```taphome
 VAR response := SENDHTTPREQUEST("/relay/0");
 IF response.IsSuccess
  VAR content := response.Content;
  RETURN(IF(PARSEJSON(content, "overtemperature"),"Yes", "No"));
 END
```

Power Meter

```taphome
 VAR response := SENDHTTPREQUEST("/relay/0");
 IF response.IsSuccess
  VAR content := response.Content;
  RETURN(IF(PARSEJSON(content, "is_valid"),"OK","Fault"));
 END
```

Relej — kanal 2 Sklopka Čitanje i pisanje

boolean

Vrijednosti / stanja: ON · OFF

Čitanje stanja sklopke

```taphome
VAR response := SENDHTTPREQUEST("/relay/1");
 IF response.IsSuccess
  VAR content := response.Content;
  VAR responseHeaders := response.Headers;
  RETURN(PARSEJSON(content, "ison"));
 ELSE
  ADDERROR(response.StatusCode + " (" + response.ReasonPhrase + ")");
  RETURN(NaN);
 END
```

Zapis stanja sklopke

```taphome
var turn := Switch(St, 1, "on", "off");
 VAR response := SENDHTTPREQUEST("/relay/1?turn=" + turn);
 IF response.IsSuccess = false
  ADDERROR(response.StatusCode);
 END
```

Servisni atributi

Overpower

```taphome
 VAR response := SENDHTTPREQUEST("/relay/1");
 IF response.IsSuccess
  VAR content := response.Content;
  RETURN(IF(PARSEJSON(content, "overpower"),"Yes", "No"));
 END
```

Overtemperature

```taphome
 VAR response := SENDHTTPREQUEST("/relay/1");
 IF response.IsSuccess
  VAR content := response.Content;
  RETURN(IF(PARSEJSON(content, "overtemperature"),"Yes", "No"));
 END
```

Power Meter

```taphome
 VAR response := SENDHTTPREQUEST("/relay/1");
 IF response.IsSuccess
  VAR content := response.Content;
  RETURN(IF(PARSEJSON(content, "is_valid"),"OK","Fault"));
 END
```

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

Moguća poboljšanja (9)

- Roller Shutter Control — Full roller shutter control (open/close/stop/position 0-100%) — the Shelly 2.5's key dual-mode feature. Template only implements relay mode.
- Roller Position — Current roller position 0-100% (requires calibration). Not available without /roller/ endpoint.
- Roller Calibration — Initiates travel-time calibration procedure for position control.
- Rolling Power Averages — 3 rolling one-minute power averages per channel, available in /meter/ response
- Input States — Physical switch input states (0/1) for both channels, available in /status response
- Internal Device Temperature — Internal temperature in C available in /status response (not exposed as a device, only as relay SA)
- Auto-off Timer — Per-channel auto-off timer in seconds, could be added as service action parameter
- WiFi Signal Strength — WiFi RSSI in dBm, available in /status response
- Favorite Positions (Roller Mode) — Up to 4 saved roller shutter positions — only relevant if roller mode is implemented

## 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 2.5 Knowledge Base
  
  [kb.shelly.cloud](https://kb.shelly.cloud/knowledge-base/shelly-2-5) 2026-03-29
- Shelly 2.5 API Reference (Device-Specific)
  
  [shelly-api-docs.shelly.cloud](https://shelly-api-docs.shelly.cloud/gen1/#shelly2-5) 2026-03-29

## 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/)

