
Shelly i3 je kompaktni Wi-Fi upravljač radnji i scena s 3 ulaza (model SHIX3-1). Nema releje ni izlaze: radi isključivo kao ulazni uređaj koji prati tri vanjska prekidača ili tipkala spojena na stezaljke SW1, SW2 i SW3. Zahvaljujući dimenzijama 40 × 36 × 10 mm može se ugraditi u standardnu podžbuknu kutiju iza postojećeg zidnog prekidača. Napaja se naponom 110–230 V AC (potreban je neutralni vodič) ili 24–60 V DC i troši manje od 1 W.
TapHome s uređajem komunicira preko HTTP-a u lokalnoj Wi-Fi mreži, veza s oblakom nije potrebna. Za svaki ulaz predložak stvara dva uređaja: prekidač s više vrijednosti koji dekodira događaje višestrukog klika (jednostruke, dvostruke, trostruke, duge i kombinirane nizove) i magnetski kontakt koji prikazuje neobrađeno stanje ulaza 0/1, uz servisnu radnju za prebacivanje između načina toggle i momentary.
Postavljanje
Uparivanje s Wi-Fi mrežom i IP adresa
Nakon uključivanja i3 se pokreće u načinu pristupne točke sa SSID-om shellyi3-XXXXXX (gdje je XXXXXX zadnjih 6 heksadecimalnih znamenki MAC adrese). Za uparivanje s kućnom mrežom:
- Spojite telefon ili prijenosno računalo na pristupnu točku uređaja i3
- U pregledniku otvorite
http://192.168.33.1(ili koristite mobilnu aplikaciju Shelly) - U web-sučelju idite na Internet & Security → WIFI MODE - CLIENT, unesite podatke za prijavu na kućnu Wi-Fi mrežu i spremite
- Uređaj se ponovno pokreće i spaja na kućnu mrežu preko DHCP-a
Dodijeljenu IP adresu pronađite u tablici DHCP zakupa usmjerivača ili preko mDNS naziva hosta shellyi3-XXXXXXXXXXXX.local (sufiks MAC adrese od 12 znakova, oglašava se kao _http._tcp.local.). Pri uvozu predloška u TapHome unesite tu IP adresu kao jedini obvezni parametar.
Isključivanje HTTP autentifikacije
TapHome se ne može autentificirati na uređaju. U web-sučelju Shelly idite na Internet & Security → RESTRICT LOGIN i prije uvoza predloška provjerite je li ta opcija isključena, inače će svako očitavanje završiti pogreškom HTTP 401.
Postavljanje vrste tipke
Svaki od tri ulaza može raditi u jednom od pet načina btn_type. Za TapHome su važna samo dva, koja su dostupna kao servisna radnja na uređajima I1 / I2 / I3:
- Momentary: za tipkala. Firmver dekodira jednostruki klik (
S), dugi pritisak (L), dvostruki klik (SS), trostruki klik (SSS), kratki→dugi (SL) i dugi→kratki (LS). Potreban je da bi uređaji Events I{N} javljali vrijednosti različite odNone. - Toggle: za klasične preklopne prekidače. Javlja se samo neobrađeno stanje 0/1, a prekidač s više vrijednosti ostaje na indeksu 0.
Vrsta tipke može se u bilo kojem trenutku promijeniti iz sustava TapHome servisnom radnjom Vrsta tipke na svakom uređaju I1 / I2 / I3 ili izravno u web-sučelju Shelly pod Settings → Input/Output settings.
Firmver podržava i načine
edge,detachediaction, ali oni nisu dostupni u predlošku TapHome. I dalje se mogu postaviti u web-sučelju Shelly bez narušavanja integracije, mijenja se samo način dekodiranja događaja višestrukog klika.
Mogućnosti uređaja
Dekodiranje događaja višestrukog klika (Events I1, Events I2, Events I3)
Za svaki ulaz prekidač s više vrijednosti dekodira kod događaja iz firmvera u jednu od sedam vrijednosti:
| Indeks | Događaj | Kod Shelly |
|---|---|---|
| 0 | None | "" (mirovanje) |
| 1 | Shortpush | S |
| 2 | Longpush | L |
| 3 | Double Shortpush | SS |
| 4 | Triple Shortpush | SSS |
| 5 | Shortpush + Longpush | SL |
| 6 | Longpush + Shortpush | LS |
Predložak svakih 2,5 sekunde očitava /input/{0,1,2} i čita polje event. Sa 6 događaja × 3 ulaza Shelly navodi da i3 podržava do 18 različitih radnji višestrukog klika (24 ako se promjene neobrađenog stanja uključeno/isključeno računaju kao zasebni okidači).
Prag dugog pritiska i vremenski prozor za višestruki klik postavljaju se globalno na uređaju (zadano: 800 ms za dugi pritisak, 500 ms između pritisaka). Mogu se podesiti u web-sučelju Shelly pod Settings → Long Push Duration i Multi Push Time.
Neobrađeno stanje ulaza i upravljanje vrstom tipke (I1, I2, I3)
Za svaki ulaz uređaj magnetski kontakt prikazuje neobrađeno logičko stanje pročitano iz polja input u /input/{N} (0 = otvoreno, 1 = zatvoreno, nakon moguće inverzije btn_reverse). Svaki uređaj I1 / I2 / I3 ima i:
- servisni atribut Vrsta tipke: trenutačna vrijednost
btn_type(toggle / momentary / edge / detached / action) - servisnu radnju Vrsta tipke: prebacuje ulaz između načina Toggle i Momentary upisom
POST /settings/input/{N}?btn_type=...
Neobrađeno stanje prikladno je za magnetske kontakte vrata / prozora spojene na stezaljke SW ili za praćenje položaja preklopnog prekidača u stvarnom vremenu.
Servisna dijagnostika
Jedan servisni atribut na razini modula prikazuje Wi-Fi SSID mreže na koju je i3 trenutačno spojen (čita se iz /status → wifi_sta.ssid). Ostala dijagnostika Gen1 (vrijeme rada, MAC, RSSI, oznaka ažuriranja firmvera) dostupna je preko REST API-ja uređaja, ali nije uključena u ovaj predložak.
Događaji višestrukog klika aktiviraju se samo u načinu momentary. Ako je fizički ulaz spojen preko klasičnog preklopnog prekidača, postavite taj ulaz na Toggle i za čitanje stanja 0/1 koristite uređaj magnetski kontakt I{N}: odgovarajući uređaj Events I{N} ostat će na indeksu 0.
Rješavanje problema
Događaji višestrukog klika se ne prepoznaju
- Provjerite je li ulaz u načinu momentary: u sustavu TapHome otvorite uređaj I{N}, pokrenite servisnu radnju Vrsta tipke i odaberite Momentary ili to postavite izravno u web-sučelju Shelly pod Settings → Input/Output settings
- U načinu toggle firmver javlja samo promjene stanja, a prekidač s više vrijednosti Events I{N} ostaje na indeksu 0
- Ako se pritisci dekodiraju kao pogrešan događaj, u web-sučelju Shelly podesite Long Push Duration (zadano 800 ms) i Multi Push Time (zadano 500 ms)
- Kod dužih nizova kao što su
SSS,SLiliLSkorisnik mora sve pritiske izvesti unutar vremenskog prozora za višestruki klik: stanke između pritisaka dulje od tog prozora dekodiraju se kao zasebni događajiS
Isti se događaj stalno ponavlja / „zaglavljeni” događaj
Polje event koje vraća /input/{N} je zadnji dekodirani događaj: firmver ga ne briše sam. TapHome to polje čita pri svakom očitavanju, pa prekidač s više vrijednosti javlja prethodni događaj sve dok se ne dogodi novi. To je normalno ponašanje i ne znači kvar. Kada pišete vlastitu logiku koja treba reagirati na svaki pritisak, uz događaj koristite i rastući brojač event_cnt (također dostupan u /input/{N}) kako biste prepoznali promjenu, umjesto da se oslanjate samo na vrijednost event.
Uređaj ne odgovara
- Provjerite je li i3 spojen na Wi-Fi: u pregledniku otvorite
http://{device-ip}/shelly; ako vrati JSON objekt, uređaj je dostupan - Umjesto IP adrese pokušajte mDNS naziv hosta
shellyi3-XXXXXXXXXXXX.local: IP adresa se možda promijenila nakon obnove DHCP zakupa - Provjerite je li HTTP autentifikacija isključena pod Internet & Security → Restrict login: TapHome ne može poslati podatke za prijavu i svaki će zahtjev vratiti HTTP 401
- Provjerite jesu li TapHome Core i uređaj Shelly u istoj mreži ili VLAN-u s dopuštenim mDNS-om / multicastom
Uređaji Shelly Gen1 prihvaćaju najviše 2 istodobne HTTP veze. Isporučeni predložak očitava svaki ulaz u intervalima od 2,5 s, što je već blizu granice. Nemojte smanjivati interval očitavanja i izbjegavajte da drugi sustav (npr. Home Assistant, vlastite skripte) istodobno očitava isti i3, jer komunikacija može postati nepouzdana.
XML predložak sadrži tri rezervirana indeksa vrijednosti (7, 8, 9 s neobrađenim kodovima 71/72/73 i općenitim oznakama „7” / „8” / „9”). Firmver Gen1 ne šalje druge događaje osim
S,L,SS,SSS,SLiLS, pa su ti indeksi neiskorištena rezervirana mjesta i vrijednost odgovarajućeg uređaja Events I{N} u praksi nikada ne bi trebala doseći 7–9.