
A Shelly i3 egy kompakt Wi-Fi 3-bemenetes művelet- és jelenetvezérlő (modell: SHIX3-1). Nincsenek reléi vagy kimenetei — kizárólag bemeneti eszközként működik, amely három, az SW1, SW2 és SW3 sorkapcsokra kötött külső kapcsolót vagy nyomógombot figyel. A 40 × 36 × 10 mm-es méret lehetővé teszi a beszerelést szabványos szerelvénydobozba egy meglévő fali kapcsoló mögé. Tápellátása 110–230 VAC (nullavezető szükséges) vagy 24–60 VDC, fogyasztása 1 W alatt van.
A TapHome HTTP-n keresztül kommunikál az eszközzel a helyi Wi-Fi hálózaton — felhőkapcsolat nem szükséges. A sablon minden bemenethez két eszközt hoz létre: egy multi-érték kapcsolót, amely dekódolja a multi-click eseményeket (egyszeri, dupla, hármas, hosszú és kombinált szekvenciák), valamint egy reed-kontaktust, amely a nyers 0/1 bemeneti állapotot, illetve a toggle és momentary mód közti váltáshoz szervizakciót biztosít.
Beállítás
Wi-Fi párosítás és IP-cím
Bekapcsolás után az i3 Access Point módban indul shellyi3-XXXXXX SSID-vel (ahol az XXXXXX a MAC utolsó 6 hex számjegye). Az otthoni hálózathoz párosításhoz:
- Csatlakoztass egy telefont vagy laptopot az i3 hozzáférési ponthoz
- Nyisd meg böngészőben a
http://192.168.33.1címet (vagy használd a Shelly mobilalkalmazást) - A webes felületen menj a Internet & Security → WIFI MODE - CLIENT menüpontba, add meg az otthoni Wi-Fi hitelesítő adatait és mentsd
- Az eszköz újraindul és DHCP-n keresztül csatlakozik az otthoni hálózathoz
A kiosztott IP-címet a router DHCP bérleti táblájából vagy a shellyi3-XXXXXXXXXXXX.local mDNS hostnévből (12 karakteres MAC-utótag, hirdetve mint _http._tcp.local.) lehet visszanyerni. A TapHome sablon importja során add meg ezt az IP-címet az egyetlen kötelező paraméterként.
HTTP-hitelesítés letiltása
A TapHome nem tud hitelesíteni az eszköz felé. A Shelly webes felületén menj a Internet & Security → RESTRICT LOGIN menüpontba, és győződj meg róla, hogy ez az opció letiltott állapotban van a sablon importálása előtt — különben minden lekérdezés HTTP 401 hibával hiúsul meg.
Gombtípus konfigurálása
A három bemenet bármelyike öt btn_type mód egyikében működhet. A TapHome számára csak kettő releváns, amelyek szervizakcióként vannak elérhetők az I1 / I2 / I3 eszközökön:
- Momentary — nyomógombokhoz. A firmware dekódolja az egyszeri rövid nyomást (
S), hosszú nyomást (L), dupla rövid nyomást (SS), hármas rövid nyomást (SSS), rövid→hosszú (SL) és hosszú→rövid (LS) eseményeket. Szükséges ahhoz, hogy az Events I{N} eszközök aNone-on kívül bármi mást generáljanak. - Toggle — hagyományos billenő- vagy kapcsolókhoz. Csak a nyers 0/1 állapot kerül jelentésre; a multi-érték kapcsoló a 0 indexen marad.
A gombtípus bármikor megváltoztatható a TapHome-ból a Button Type szervizakcióval minden I1 / I2 / I3 eszközön, vagy közvetlenül a Shelly webes felületén a Settings → Input/Output settings menüpontban.
A firmware az
edge,detachedésactionmódokat is támogatja, de ezek nincsenek a TapHome sablonban kitéve. A Shelly webes felületéről továbbra is beállíthatók az integráció megtörése nélkül — csak a multi-click dekódolási viselkedés változik.
Eszközfunkciók
Multi-click eseménydekódolás (Events I1, Events I2, Events I3)
Minden bemenethez egy multi-érték kapcsoló dekódolja a firmware-szintű eseménykódot a hét érték egyikére:
| Index | Esemény | 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 |
A sablon 2,5 másodpercenként kérdezi le a /input/{0,1,2} végpontokat és olvassa az event mezőt. 6 esemény × 3 bemenet alapján a Shelly az i3-at akár 18 különböző multi-click műveletet támogató eszközként hirdeti (24, ha a nyers be/ki állapotváltozásokat külön triggernek számoljuk).
A hosszú nyomás küszöbértéke és a multi-push ablak globálisan konfigurált az eszközön (alapértelmezett: 800 ms hosszú nyomáshoz, 500 ms ablak a nyomások között). A Shelly webes felületén a Settings → Long Push Duration és Multi Push Time menüpontokban hangolhatók.
Nyers bemeneti állapot és gombtípus-vezérlés (I1, I2, I3)
Minden bemenethez egy reed-kontaktus eszköz teszi elérhetővé a /input/{N} input mezőjéből olvasott nyers logikai állapotot (0 = nyitott, 1 = zárt, az opcionális btn_reverse inverzió után). Minden I1 / I2 / I3 eszköz tartalmaz továbbá:
- Button Type — szervizattribútum a jelenlegi
btn_typeértékkel (toggle / momentary / edge / detached / action) - Button Type — szervizakció, amely a bemenetet Toggle és Momentary között kapcsolja a
POST /settings/input/{N}?btn_type=...írásával
A nyers állapot alkalmas az SW sorkapcsokra kötött ajtó / ablak mágneses kontaktusokhoz vagy egy billenőkapcsoló valós idejű pozíciókövetéséhez.
Szerviz diagnosztika
Egyetlen modulszintű szervizattribútum jeleníti meg a Wi-Fi SSID-t, amelyhez az i3 jelenleg csatlakozik (a /status → wifi_sta.ssid mezőből olvasva). Egyéb Gen1 diagnosztikai adatok (uptime, MAC, RSSI, firmware-frissítés jelző) elérhetők az eszköz REST API-ján, de ebben a sablonban nincsenek kitéve.
A multi-click események csak momentary módban generálódnak. Ha egy fizikai bemenet hagyományos billenőkapcsolóra van kötve, állítsd ezt a bemenetet Toggle módra, és használd az I{N} reed-kontaktus eszközt a 0/1 állapot olvasásához — a megfelelő Events I{N} eszköz a 0 indexen marad.
Hibaelhárítás
A multi-click események nem észlelhetők
- Ellenőrizd, hogy a bemenet momentary módban van-e — nyisd meg az I{N} eszközt a TapHome-ban, futtasd a Button Type szervizakciót és válaszd a Momentary opciót, vagy állítsd be közvetlenül a Shelly webes felületén a Settings → Input/Output settings menüpontban
- Toggle módban a firmware csak állapotváltozásokat jelent; az Events I{N} multi-érték kapcsoló a 0 indexen marad
- Ha a nyomások rossz eseményként kerülnek dekódolásra, állítsd be a Long Push Duration (alapértelmezett 800 ms) és Multi Push Time (alapértelmezett 500 ms) értékeket a Shelly webes felületén
- A hosszú szekvenciák, mint
SSS,SLvagyLS, igénylik, hogy a felhasználó minden nyomást a multi-push ablakon belül tartson — az ablakot meghaladó szünetek különSeseményként kerülnek dekódolásra
Ugyanaz az esemény ismétlődik / „beragadt" esemény
A /input/{N} által visszaadott event mező az utoljára dekódolt esemény — a firmware nem törli automatikusan. A TapHome ezt a mezőt minden lekérdezéskor olvassa, így a multi-érték kapcsoló továbbra is a korábbi eseményt jelenti, amíg új nem következik be. Ez normális viselkedés, és nem jelez hibát. Ha minden nyomásra elsülő egyedi logikát írsz, párosítsd az eseményt a monoton event_cnt számlálóval (szintén elérhető a /input/{N}-ben) a változás detektálásához, ahelyett hogy csak az event értékére hagyatkoznál.
Az eszköz nem válaszol
- Ellenőrizd, hogy az i3 csatlakozik-e a Wi-Fi-hez — nyisd meg böngészőben a
http://{device-ip}/shellycímet; ha JSON objektumot ad vissza, az eszköz elérhető - Próbáld meg az IP-cím helyett a
shellyi3-XXXXXXXXXXXX.localmDNS hostnevet — az IP DHCP megújítás után megváltozhatott - Győződj meg róla, hogy a HTTP-hitelesítés letiltott állapotú a Internet & Security → Restrict login menüpontban — a TapHome nem tud hitelesítő adatokat küldeni, és minden kérés HTTP 401-et ad vissza
- Ellenőrizd, hogy a TapHome Core és a Shelly eszköz ugyanazon a hálózaton vagy VLAN-on van, engedélyezett mDNS / multicast mellett
A Gen1 Shelly eszközök legfeljebb 2 egyidejű HTTP-kapcsolatot fogadnak el. A szállított sablon minden bemenetet 2,5 s-os intervallumokkal kérdez le, ami már közel van a limithez. Ne csökkentsd a lekérdezési intervallumot, és kerüld el más rendszer (pl. Home Assistant, egyéni szkriptek) futtatását, amely ugyanazt az i3-at egyidejűleg lekérdezi — a kommunikáció megbízhatatlanná válhat.
Az XML sablon három fenntartott multi-érték indexet tartalmaz (7, 8, 9 a 71/72/73 nyers kódokkal és „7" / „8" / „9" általános címkékkel). A Gen1 firmware nem bocsát ki eseményeket az
S,L,SS,SSS,SLésLS-en kívül, így ezek az indexek nem használt helyőrzők, és az Events I{N} eszköz értékének a gyakorlatban soha nem szabad elérnie a 7-9 tartományt.