
Shelly i3 je kompaktní Wi-Fi 3-vstupový ovladač akcí a scén (model SHIX3-1). Nemá žádná relé ani výstupy — funguje výhradně jako vstupní zařízení, které monitoruje tři externí přepínače nebo tlačítka připojená ke svorkám SW1, SW2 a SW3. Rozměry 40 × 36 × 10 mm umožňují instalaci do standardní instalační krabice za stávající nástěnný spínač. Napájí se z 110–230 VAC (potřebný neutrální vodič) nebo 24–60 VDC a spotřebovává méně než 1 W.
TapHome komunikuje se zařízením přes HTTP v lokální Wi-Fi síti — cloudové připojení není potřeba. Pro každý vstup šablona vytvoří dvě zařízení: vícestavový spínač, který dekóduje multi-click události (jednoduché, dvojité, trojité, dlouhé a kombinované sekvence), a reed kontakt, který zveřejňuje surový stav vstupu 0/1 plus servisní akci pro přepínání mezi režimem toggle a momentary.
Instalace
Wi-Fi párování a IP adresa
Po připojení napájení se i3 spustí v režimu Access Point se SSID shellyi3-XXXXXX (kde XXXXXX je posledních 6 hex číslic MAC adresy). Pro spárování s domácí sítí:
- Připoj telefon nebo notebook k přístupovému bodu i3
- Otevři
http://192.168.33.1v prohlížeči (nebo použij mobilní aplikaci Shelly) - Ve webovém rozhraní přejdi na Internet & Security → WIFI MODE - CLIENT, zadej přihlašovací údaje domácí Wi-Fi a ulož
- Zařízení se restartuje a připojí k domácí síti přes DHCP
Přidělenou IP adresu zjistíš z DHCP tabulky routeru nebo přes mDNS hostname shellyi3-XXXXXXXXXXXX.local (12-znakový MAC sufix, oznamovaný jako _http._tcp.local.). Při importu TapHome šablony zadej tuto IP adresu jako jediný povinný parametr.
Vypnutí HTTP autentifikace
TapHome se nedokáže autentifikovat vůči zařízení. Ve webovém rozhraní Shelly přejdi na Internet & Security → RESTRICT LOGIN a ujisti se, že tato možnost je vypnutá ještě před importem šablony — jinak každý poll selže s HTTP 401.
Konfigurace typu tlačítka
Každý ze tří vstupů může pracovat v jednom z pěti btn_type režimů. Pro TapHome jsou relevantní pouze dva, které jsou zveřejněny jako servisní akce na zařízeních I1 / I2 / I3:
- Momentary — pro tlačítka. Firmware dekóduje jedno krátké stisknutí (
S), dlouhé stisknutí (L), dvojité krátké stisknutí (SS), trojité krátké stisknutí (SSS), krátké→dlouhé (SL) a dlouhé→krátké (LS). Vyžadováno, aby zařízení Events I{N} vrátila něco jiného nežNone. - Toggle — pro klasické kolébkové nebo páčkové přepínače. Hlásí se pouze surový stav 0/1; vícestavový spínač zůstává na indexu 0.
Typ tlačítka lze kdykoliv změnit z TapHome přes servisní akci Button Type na každém zařízení I1 / I2 / I3, nebo přímo ve webovém rozhraní Shelly v Settings → Input/Output settings.
Firmware podporuje i režimy
edge,detachedaaction, ale ty nejsou zveřejněny v TapHome šabloně. Lze je nastavit přes webové rozhraní Shelly bez narušení integrace — změní se pouze chování dekódování multi-click událostí.
Schopnosti zařízení
Dekódování multi-click událostí (Events I1, Events I2, Events I3)
Pro každý vstup vícestavový spínač dekóduje firmwarový kód události na jednu ze sedmi hodnot:
| Index | Událost | 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 |
Šablona pollne /input/{0,1,2} každých 2,5 sekundy a čte pole event. Při 6 událostech × 3 vstupy Shelly i3 marketingově uvádí jako podporující až 18 odlišných multi-click akcí (24, pokud se změny surového on/off stavu počítají jako samostatné spouštěče).
Práh dlouhého stisknutí a okno pro multi-push jsou konfigurovány globálně na zařízení (výchozí hodnoty: 800 ms pro dlouhé stisknutí, 500 ms okno mezi stisknutími). Lze je doladit ve webovém rozhraní Shelly v Settings → Long Push Duration a Multi Push Time.
Surový stav vstupu a ovládání typu tlačítka (I1, I2, I3)
Pro každý vstup reed-contact zařízení zveřejňuje surový logický stav přečtený z pole input v /input/{N} (0 = otevřený, 1 = zavřený, po volitelné inverzi btn_reverse). Každé zařízení I1 / I2 / I3 obsahuje také:
- Button Type — servisní atribut s aktuální hodnotou
btn_type(toggle / momentary / edge / detached / action) - Button Type — servisní akce, která přepíná vstup mezi Toggle a Momentary zápisem
POST /settings/input/{N}?btn_type=...
Surový stav je vhodný pro magnetické kontakty dveří / oken zapojené na svorky SW nebo pro sledování polohy páčkového přepínače v reálném čase.
Servisní diagnostika
Jeden servisní atribut na úrovni modulu zveřejňuje Wi-Fi SSID, ke kterému je i3 aktuálně připojený (čtený z /status → wifi_sta.ssid). Další Gen1 diagnostiky (uptime, MAC, RSSI, příznak aktualizace firmware) jsou dostupné přes REST API zařízení, ale v této šabloně nejsou zveřejněny.
Multi-click události se generují pouze v režimu momentary. Pokud je fyzický vstup zapojený přes klasický páčkový přepínač, nakonfiguruj tento vstup jako Toggle a použij reed-contact zařízení I{N} pro čtení jeho stavu 0/1 — odpovídající zařízení Events I{N} zůstane na indexu 0.
Řešení problémů
Multi-click události se nedetekují
- Ověř, že vstup je v režimu momentary — otevři zařízení I{N} v TapHome, spusť servisní akci Button Type a vyber Momentary, nebo nastav přímo ve webovém rozhraní Shelly v Settings → Input/Output settings
- V režimu toggle firmware hlásí pouze změny stavu; vícestavový spínač Events I{N} zůstává na indexu 0
- Pokud jsou stisknutí dekódována jako nesprávná událost, uprav Long Push Duration (výchozí 800 ms) a Multi Push Time (výchozí 500 ms) ve webovém rozhraní Shelly
- Dlouhé sekvence jako
SSS,SLneboLSvyžadují, aby uživatel udržel všechna stisknutí v rámci multi-push okna — pauzy delší než toto okno jsou dekódovány jako samostatnéSudálosti
Stejná událost se opakuje stále / „uvíznutá" událost
Pole event vrácené z /input/{N} je poslední dekódovaná událost — firmware ji automaticky neresetuje. TapHome toto pole čte při každém pollu, takže vícestavový spínač bude nadále hlásit předchozí událost, dokud nenastane nová. Toto je normální chování a neznačí chybu. Při psaní vlastní logiky, která se spouští při každém stisknutí, spáruj událost s monotónním čítačem event_cnt (také dostupný v /input/{N}) pro detekci změny místo spoléhání se pouze na hodnotu event.
Zařízení neodpovídá
- Ověř, že i3 je připojený k Wi-Fi — otevři
http://{device-ip}/shellyv prohlížeči; pokud vrátí JSON objekt, zařízení je dostupné - Zkus mDNS hostname
shellyi3-XXXXXXXXXXXX.localmísto IP adresy — IP se mohla změnit po obnově DHCP - Ujisti se, že HTTP autentifikace je vypnutá v Internet & Security → Restrict login — TapHome nedokáže odeslat přihlašovací údaje a každý požadavek vrátí HTTP 401
- Zkontroluj, že TapHome Core a zařízení Shelly jsou ve stejné síti nebo VLAN s povoleným mDNS / multicastem
Gen1 Shelly zařízení akceptují maximálně 2 současná HTTP spojení. Dodaná šablona pollne každý vstup v intervalech 2,5 s, což je již blízko limitu. Nesnižuj poll interval a vyhni se spouštění jiného systému (např. Home Assistant, vlastní skripty), který pollne stejný i3 současně — komunikace se může stát nespolehlivou.
XML šablona obsahuje tři rezervované multi-value indexy (7, 8, 9 se surovými kódy 71/72/73 a generickými označeními „7" / „8" / „9"). Gen1 firmware nevysílá žádné události kromě
S,L,SS,SSS,SLaLS, takže tyto indexy jsou nepoužité placeholdery a hodnota zařízení Events I{N} by v praxi neměla dosáhnout 7-9.