
Shelly i3 je kompaktný Wi-Fi 3-vstupový ovládač akcií a scén (model SHIX3-1). Nemá žiadne relé ani výstupy — funguje výhradne ako vstupné zariadenie, ktoré monitoruje tri externé prepínače alebo tlačidlá pripojené ku svorkám SW1, SW2 a SW3. Rozmery 40 × 36 × 10 mm umožňujú inštaláciu do štandardnej inštalačnej krabice za existujúci nástenný spínač. Napája sa z 110–230 VAC (potrebný neutrálny vodič) alebo 24–60 VDC a spotrebúva menej ako 1 W.
TapHome komunikuje so zariadením cez HTTP v lokálnej Wi-Fi sieti — cloudové pripojenie nie je potrebné. Pre každý vstup šablóna vytvorí dve zariadenia: viacstavový spínač, ktorý dekóduje multi-click udalosti (jednoduché, dvojité, trojité, dlhé a kombinované sekvencie), a reed kontakt, ktorý zverejňuje surový stav vstupu 0/1 plus servisnú akciu na prepínanie medzi režimom toggle a momentary.
Inštalácia
Wi-Fi párovanie a IP adresa
Po pripojení napájania sa i3 spustí v režime Access Point so SSID shellyi3-XXXXXX (kde XXXXXX je posledných 6 hex číslic MAC adresy). Pre spárovanie s domácou sieťou:
- Pripoj telefón alebo notebook k prístupovému bodu i3
- Otvor
http://192.168.33.1v prehliadači (alebo použi mobilnú aplikáciu Shelly) - Vo webovom rozhraní prejdi na Internet & Security → WIFI MODE - CLIENT, zadaj prihlasovacie údaje domácej Wi-Fi a ulož
- Zariadenie sa reštartuje a pripojí k domácej sieti cez DHCP
Pridelenú IP adresu zistíš z DHCP tabuľky routera alebo cez mDNS hostname shellyi3-XXXXXXXXXXXX.local (12-znakový MAC suffix, oznamovaný ako _http._tcp.local.). Pri importe TapHome šablóny zadaj túto IP adresu ako jediný povinný parameter.
Vypnutie HTTP autentifikácie
TapHome sa nedokáže autentifikovať voči zariadeniu. Vo webovom rozhraní Shelly prejdi na Internet & Security → RESTRICT LOGIN a uisti sa, že táto možnosť je vypnutá ešte pred importom šablóny — inak každý poll zlyhá s HTTP 401.
Konfigurácia typu tlačidla
Každý z troch vstupov môže pracovať v jednom z piatich btn_type režimov. Pre TapHome sú relevantné len dva, ktoré sú zverejnené ako servisná akcia na zariadeniach I1 / I2 / I3:
- Momentary — pre tlačidlá. Firmware dekóduje jedno krátke stlačenie (
S), dlhé stlačenie (L), dvojité krátke stlačenie (SS), trojité krátke stlačenie (SSS), krátke→dlhé (SL) a dlhé→krátke (LS). Vyžadované, aby zariadenia Events I{N} vrátili niečo iné akoNone. - Toggle — pre klasické kolískové alebo páčkové prepínače. Hlási sa len surový stav 0/1; viacstavový spínač zostáva na indexe 0.
Typ tlačidla možno kedykoľvek zmeniť z TapHome cez servisnú akciu Button Type na každom zariadení I1 / I2 / I3, alebo priamo vo webovom rozhraní Shelly v Settings → Input/Output settings.
Firmware podporuje aj režimy
edge,detachedaaction, ale tie nie sú zverejnené v TapHome šablóne. Možno ich nastaviť cez webové rozhranie Shelly bez narušenia integrácie — zmení sa len správanie dekódovania multi-click udalostí.
Schopnosti zariadenia
Dekódovanie multi-click udalostí (Events I1, Events I2, Events I3)
Pre každý vstup viacstavový spínač dekóduje firmvérový kód udalosti na jednu zo siedmich hodnôt:
| Index | Udalosť | Shelly kód |
|---|---|---|
| 0 | None | "" (idle) |
| 1 | Shortpush | S |
| 2 | Longpush | L |
| 3 | Double Shortpush | SS |
| 4 | Triple Shortpush | SSS |
| 5 | Shortpush + Longpush | SL |
| 6 | Longpush + Shortpush | LS |
Šablóna pollne /input/{0,1,2} každých 2,5 sekundy a číta pole event. Pri 6 udalostiach × 3 vstupy Shelly i3 marketingovo uvádza ako podporujúci až 18 odlišných multi-click akcií (24, ak sa zmeny surového on/off stavu počítajú ako samostatné spúšťače).
Prah dlhého stlačenia a okno pre multi-push sú konfigurované globálne na zariadení (predvolené hodnoty: 800 ms pre dlhé stlačenie, 500 ms okno medzi stlačeniami). Možno ich doladiť vo webovom rozhraní Shelly v Settings → Long Push Duration a Multi Push Time.
Surový stav vstupu a ovládanie typu tlačidla (I1, I2, I3)
Pre každý vstup reed-contact zariadenie zverejňuje surový logický stav prečítaný z poľa input v /input/{N} (0 = otvorený, 1 = zatvorený, po voliteľnej inverzii btn_reverse). Každé zariadenie I1 / I2 / I3 obsahuje aj:
- Button Type — servisný atribút s aktuálnou hodnotou
btn_type(toggle / momentary / edge / detached / action) - Button Type — servisná akcia, ktorá prepína vstup medzi Toggle a Momentary zápisom
POST /settings/input/{N}?btn_type=...
Surový stav je vhodný pre magnetické kontakty dverí / okien zapojené na svorky SW alebo na sledovanie polohy páčkového prepínača v reálnom čase.
Servisná diagnostika
Jeden servisný atribút na úrovni modulu zverejňuje Wi-Fi SSID, ku ktorému je i3 aktuálne pripojený (čítaný z /status → wifi_sta.ssid). Ďalšie Gen1 diagnostiky (uptime, MAC, RSSI, príznak aktualizácie firmvéru) sú dostupné cez REST API zariadenia, ale v tejto šablóne nie sú zverejnené.
Multi-click udalosti sa generujú len v režime momentary. Ak je fyzický vstup zapojený cez klasický páčkový prepínač, nakonfiguruj tento vstup ako Toggle a použi reed-contact zariadenie I{N} na čítanie jeho stavu 0/1 — zodpovedajúce zariadenie Events I{N} zostane na indexe 0.
Riešenie problémov
Multi-click udalosti sa nedetegujú
- Over, že vstup je v režime momentary — otvor zariadenie I{N} v TapHome, spusti servisnú akciu Button Type a vyber Momentary, alebo nastav priamo vo webovom rozhraní Shelly v Settings → Input/Output settings
- V režime toggle firmware hlási len zmeny stavu; viacstavový spínač Events I{N} zostáva na indexe 0
- Ak sú stlačenia dekódované ako nesprávna udalosť, uprav Long Push Duration (predvolene 800 ms) a Multi Push Time (predvolene 500 ms) vo webovom rozhraní Shelly
- Dlhé sekvencie ako
SSS,SLaleboLSvyžadujú, aby používateľ udržal všetky stlačenia v rámci multi-push okna — pauzy dlhšie ako toto okno sú dekódované ako samostatnéSudalosti
Tá istá udalosť sa opakuje stále / „uviaznutá" udalosť
Pole event vrátené z /input/{N} je posledná dekódovaná udalosť — firmware ju automaticky neresetuje. TapHome toto pole číta pri každom polle, takže viacstavový spínač bude naďalej hlásiť predchádzajúcu udalosť, kým nenastane nová. Toto je normálne správanie a neindikuje chybu. Pri písaní vlastnej logiky, ktorá sa spúšťa pri každom stlačení, sparuj udalosť s monotónnym čítačom event_cnt (tiež dostupný v /input/{N}) na detekciu zmeny namiesto spoliehania sa len na hodnotu event.
Zariadenie neodpovedá
- Over, že i3 je pripojený k Wi-Fi — otvor
http://{device-ip}/shellyv prehliadači; ak vráti JSON objekt, zariadenie je dostupné - Skús mDNS hostname
shellyi3-XXXXXXXXXXXX.localnamiesto IP adresy — IP sa mohla zmeniť po obnove DHCP - Uisti sa, že HTTP autentifikácia je vypnutá v Internet & Security → Restrict login — TapHome nedokáže odoslať prihlasovacie údaje a každá požiadavka vráti HTTP 401
- Skontroluj, že TapHome Core a zariadenie Shelly sú v rovnakej sieti alebo VLAN s povoleným mDNS / multicastom
Gen1 Shelly zariadenia akceptujú maximálne 2 súčasné HTTP spojenia. Dodaná šablóna pollne každý vstup v 2,5 s intervaloch, čo je už blízko limitu. Neznižuj poll interval a vyhni sa spúšťaniu iného systému (napr. Home Assistant, vlastné skripty), ktorý pollne ten istý i3 súčasne — komunikácia sa môže stať nespoľahlivou.
XML šablóna obsahuje tri rezervované multi-value indexy (7, 8, 9 so surovými kódmi 71/72/73 a generickými označeniami „7" / „8" / „9"). Gen1 firmware nevysiela žiadne udalosti okrem
S,L,SS,SSS,SLaLS, takže tieto indexy sú nepoužité placeholdery a hodnota zariadenia Events I{N} by v praxi nemala dosiahnuť 7-9.