TapHome

Shelly Pro 3

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:

ShellyPro3-{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 Pro 3

Shelly Pro 3 je trokanalni relejni modul za ugradnju na DIN šinu s beznaponskim kontaktima. Svaki od tri neovisna izlaza može uključivati i isključivati do 16 A (ukupno 48 A na svim kanalima), pa je prikladan za upravljanje strujnim krugovima rasvjete, grijaćim elementima ili trofaznim trošilima kod kojih se svaka faza uključuje i isključuje zasebno. TapHome s uređajem komunicira preko HTTP-a putem JSON-RPC 2.0 API-ja Gen2 u lokalnoj mreži, pa veza s oblakom nije potrebna.

Za razliku od uređaja Shelly Pro 3EM, koji je brojilo energije (samo mjeri), Pro 3 je čisti relejni uređaj za uključivanje i isključivanje, bez mogućnosti mjerenja snage. Uređaj se spaja preko Wi-Fi mreže, Etherneta (RJ45) ili Bluetootha i namijenjen je stručnoj ugradnji u razvodne ormare.

Konfiguracija

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

Za integraciju sa sustavom TapHome autentifikacija na uređaju Shelly mora biti isključena. TapHome ne podržava HTTP Digest Auth koji koriste uređaji Gen2. Otvorite web-sučelje Shelly (http://{device-ip}) → Settings → Authentication i provjerite je li isključena.

Mrežni (LAN) kabel smije se ukopčati ili iskopčati samo kada je uređaj isključen s napajanja. Ukopčavanje Ethernet kabela dok je uređaj pod naponom može uzrokovati probleme.

Ako je na uređaju Shelly uključen način ECO, može doći do isteka vremena komunikacije zbog kratkih intervala očitavanja koje koristi predložak (2,5–3 sekunde). Ako se veza povremeno prekida, isključite način ECO u web-sučelju Shelly.

Mogućnosti uređaja

Upravljanje relejima

Predložak daje tri neovisna uređaja vrste „Sklopka”, po jedan za svaki relejni kanal. Stanje svakog releja čita se iz odgovora /rpc/Switch.GetStatus?id=N (polje output, logička vrijednost), a relejem se upravlja preko /rpc/Switch.Set?id=N&on=true ili on=false, gdje je N 0, 1 ili 2.

Sva tri kanala rade neovisno: mogu biti na različitim strujnim krugovima, različitim fazama izmjenične mreže ili čak s mješovitim AC/DC trošilima. Kontakti releja su beznaponski, pa svaki izlaz može uključivati i isključivati potpuno zaseban strujni krug, neovisan o napajanju samog uređaja.

Servisna dijagnostika

Predložak daje servisne atribute na razini modula za praćenje uređaja:

  • Wi-Fi: naziv spojene mreže (SSID)
  • IP adresa: trenutačna IP adresa uređaja u mreži
  • Jačina signala: Wi-Fi RSSI u dB
  • MAC: MAC adresa uređaja

Skripta za čitanje modula provjerava i dostupna ažuriranja firmvera te potrebu za ponovnim pokretanjem i prikazuje ih kao upozorenja u sučelju TapHome.

Servisne radnje

Na razini modula dostupne su dvije servisne radnje:

  • Ažuriraj firmver: pokreće ažuriranje firmvera na najnovije stabilno izdanje preko /rpc/Shelly.Update
  • Ponovno pokretanje: ponovno pokreće uređaj preko /rpc/Shelly.Reboot
Dodatne mogućnosti

Shelly Pro 3 preko RPC API-ja daje i stanja fizičkih ulaza za prekidač ili tipkalo (S1, S2, S3) putem komponente Input, unutarnju temperaturu uređaja, vrijeme rada uređaja, zauzeće RAM-a, vrijeme uređaja i stanje Ethernet veze. Timer za automatsko isključivanje dostupan je preko parametra toggle_after u naredbi Switch.Set. Te se mogućnosti mogu dodati u budućem ažuriranju predloška.

Rješavanje problema

Uređaj ne odgovara
  1. Provjerite je li Shelly spojen na Wi-Fi ili Ethernet i ima li valjanu IP adresu
  2. Umjesto IP adrese pokušajte koristiti mDNS naziv hosta (ShellyPro3-AABBCCDDEE.local): IP adresa se možda promijenila nakon obnove DHCP zakupa
  3. U pregledniku otvorite http://{device-ip}/rpc/Shelly.GetDeviceInfo: ako odgovori u formatu JSON, uređaj je dostupan
  4. Provjerite jesu li centralna jedinica TapHome Core i Shelly u istoj mreži / VLAN-u
  5. Provjerite je li autentifikacija na uređaju Shelly isključena
Odgovaraju samo neki kanali
  1. Provjerite je li svaki kanal ispravno adresiran (id=0 za izlaz 1, id=1 za izlaz 2, id=2 za izlaz 3)
  2. Provjerite LED indikatore releja na prednjoj ploči uređaja: crvena LED dioda znači da je odgovarajući relej zatvoren (ON)
  3. Ručno u pregledniku isprobajte kanal koji ne odgovara: http://{device-ip}/rpc/Switch.Set?id=N&on=true
Problemi s induktivnim trošilima

Za induktivna trošila (ventilatori, transformatori, LED napajanja) na relejnom izlazu preporučuje se RC prigušni član (snubber) (0,1 uF / 100 Ohm / 1/2 W / 600 VAC) koji štiti od naponskih šiljaka i produljuje vijek trajanja releja.

Uređaji Shelly Gen2 podržavaju do 6 istodobnih HTTP veza. Izbjegavajte istodobno očitavanje iz previše sustava (TapHome, Home Assistant, vlastite skripte) kako se ne bi potrošile sve dostupne veze.

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 Pro 3 Modul
Servisni atributi
Wi-Fi
IP adresa
Jačina signala
MAC
Servisne radnje
Ažuriraj firmver
Ponovno pokretanje
Prilagođene varijable

Shelly Pro 3

Čitanje (modul)
VAR response := SENDHTTPREQUEST("/rpc/Sys.GetStatus");
IF response.IsSuccess
    Sys.GetStatus := response.Content;
END

response := SENDHTTPREQUEST("/rpc/Sys.GetConfig");
IF response.IsSuccess
    Sys.GetConfig := response.Content;
END

response := SENDHTTPREQUEST("/rpc/WiFi.GetStatus");
IF response.IsSuccess
    WiFi.GetStatus := response.Content;
END

if ! ISNULL(parsejson(Sys.GetStatus, "available_updates.stable", true))
    addwarning("New firmware update is available");
end

if parsejson(Sys.GetStatus, "restart_required", true)
    addwarning("Restart required");
end
Servisni atributi
Wifi
PARSEJSON(WiFi.GetStatus, "ssid")
${ipAddress}
PARSEJSON(WiFi.GetStatus, "sta_ip")
${xml_signal_strength} [dB]
PARSEJSON(WiFi.GetStatus, "rssi")
MAC
PARSEJSON(Sys.GetStatus, "mac")
Servisne radnje
${xml_update_fw}
VAR response := SENDHTTPREQUEST("/rpc/Shelly.Update?stage=\"stable\"");
IF response.IsSuccess
    return("OK");
else
    return("Error");
END
Reboot
VAR response := SENDHTTPREQUEST("/rpc/Shelly.Reboot");
IF response.IsSuccess
    return("OK");
else
    return("Error");
END
Sklopka 1 Sklopka
boolean
Vrijednosti / stanja: ON · OFF

Sklopka 1

Čitanje stanja sklopke
VAR response := SENDHTTPREQUEST("/rpc/Switch.GetStatus?id=" + id);
IF response.IsSuccess
    Switch.GetStatus := response.Content;
END
return(parsejson(Switch.GetStatus, "output"));
Zapis stanja sklopke
VAR path := "/rpc/Switch.Set?id=" + id + "&on=" + SWITCH(St, 1, "true", "false");
SENDHTTPREQUEST(path);
Sklopka 2 Sklopka
boolean
Vrijednosti / stanja: ON · OFF

Sklopka 2

Čitanje stanja sklopke
VAR response := SENDHTTPREQUEST("/rpc/Switch.GetStatus?id=" + id);
IF response.IsSuccess
    Switch.GetStatus := response.Content;
END
return(parsejson(Switch.GetStatus, "output"));
Zapis stanja sklopke
VAR path := "/rpc/Switch.Set?id=" + id + "&on=" + SWITCH(St, 1, "true", "false");
SENDHTTPREQUEST(path);
Sklopka 3 Sklopka
boolean
Vrijednosti / stanja: ON · OFF

Sklopka 3

Čitanje stanja sklopke
VAR response := SENDHTTPREQUEST("/rpc/Switch.GetStatus?id=" + id);
IF response.IsSuccess
    Switch.GetStatus := response.Content;
END
return(parsejson(Switch.GetStatus, "output"));
Zapis stanja sklopke
VAR path := "/rpc/Switch.Set?id=" + id + "&on=" + SWITCH(St, 1, "true", "false");
SENDHTTPREQUEST(path);
Povezivanje: Packet Parser → HTTP • Naziv računala (hostname): ShellyPro3-{MAC}.local
Moguća poboljšanja (9)
  • Input 1 State — Physical switch/button input S1 state, available via /rpc/Input.GetStatus?id=0
  • Input 2 State — Physical switch/button input S2 state, available via /rpc/Input.GetStatus?id=1
  • Input 3 State — Physical switch/button input S3 state, available via /rpc/Input.GetStatus?id=2
  • Device Temperature — Internal temperature in °C, available in Switch.GetStatus response (non-metered devices may still report temperature)
  • Uptime — Seconds since last reboot, available in Sys.GetStatus response
  • RAM Usage — Total and free RAM in bytes, available in Sys.GetStatus response
  • Device Time — Current device time in HH:MM format, available in Sys.GetStatus response
  • Auto-off Timer — Auto-reset timer in seconds via toggle_after parameter, could be added as switch parameter for all 3 channels
  • Ethernet Status — Pro 3 has RJ45 LAN port; Ethernet status (IP, link) available via /rpc/Ethernet.GetStatus

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