TapHome

Shelly 2.5

Packet Parser → HTTP
Autor
Posljednje ažuriranje: 03. 2026

Ovaj uređaj podržava mDNS

Umjesto IP adrese uređaju možete pristupiti na adresi:

shellyswitch25-{MAC}.local

Zamijenite {MAC} MAC adresom svog uređaja (velika slova, bez dvotočaka).

TapHome podržava mDNS. Naziv računala (hostname) pouzdaniji je od statične IP adrese.

Shelly 2.5

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

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.

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.

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

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:

1

shelly<model>-<MAC>.local

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

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

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

Shelly 2.5 Modul
Servisni atributi
Način rada
Servisne radnje
Način rada

Shelly2.5

Servisni atributi
Mode
 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
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

Brojilo energije — kanal 1

Čitanje ukupne potrošnje
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
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
 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

Brojilo energije — kanal 2

Čitanje ukupne potrošnje
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
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
 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
boolean
Vrijednosti / stanja: ON · OFF

Relej — kanal 1

Čitanje stanja sklopke
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
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
 VAR response := SENDHTTPREQUEST("/relay/0");
 IF response.IsSuccess
  VAR content := response.Content;
  RETURN(IF(PARSEJSON(content, "overpower"),"Yes", "No"));
 END
Overtemperature
 VAR response := SENDHTTPREQUEST("/relay/0");
 IF response.IsSuccess
  VAR content := response.Content;
  RETURN(IF(PARSEJSON(content, "overtemperature"),"Yes", "No"));
 END
Power Meter
 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
boolean
Vrijednosti / stanja: ON · OFF

Relej — kanal 2

Čitanje stanja sklopke
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
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
 VAR response := SENDHTTPREQUEST("/relay/1");
 IF response.IsSuccess
  VAR content := response.Content;
  RETURN(IF(PARSEJSON(content, "overpower"),"Yes", "No"));
 END
Overtemperature
 VAR response := SENDHTTPREQUEST("/relay/1");
 IF response.IsSuccess
  VAR content := response.Content;
  RETURN(IF(PARSEJSON(content, "overtemperature"),"Yes", "No"));
 END
Power Meter
 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

Izvori

Pronašli ste problem s ovim predloškom uređaja?

Recite nam što ne radi, što nedostaje ili kako bi se predložak trebao ponašati. Vaše povratne informacije pomažu nam da katalog bude točan.

Provjerio TapHome

Želite ovo koristiti u svojoj centralnoj jedinici TapHome Core?

Otvorite ovaj predložak na portalu Customer Portal kako biste ga primijenili na jedan od svojih domova ili predložili poboljšanje i poslali ga natrag u katalog.

Otvorite na portalu