
Shelly i3 este un controler Wi-Fi compact pentru acțiuni și scene, cu 3 intrări (model SHIX3-1). Nu are relee sau ieșiri — funcționează exclusiv ca dispozitiv de intrare care monitorizează trei întrerupătoare sau butoane externe conectate la bornele SW1, SW2 și SW3. Dimensiunile de 40 x 36 x 10 mm permit montarea într-o doză de aparataj standard, în spatele unui întrerupător de perete existent. Se alimentează la 110–230 V c.a. (este necesar nulul) sau la 24–60 V c.c. și consumă mai puțin de 1 W.
TapHome comunică cu dispozitivul prin HTTP în rețeaua Wi-Fi locală — nu este necesară conexiunea la cloud. Pentru fiecare intrare, șablonul creează două dispozitive: un comutator cu mai multe valori care decodează evenimentele de apăsări multiple (apăsare simplă, dublă, triplă, lungă și secvențe combinate) și un contact reed care oferă starea brută 0/1 a intrării, plus o acțiune de service pentru comutarea între modurile toggle și momentary.
Configurare
Asocierea Wi-Fi și adresa IP
După alimentare, i3 pornește în modul punct de acces, cu SSID-ul shellyi3-XXXXXX (unde XXXXXX reprezintă ultimele 6 cifre hexazecimale ale adresei MAC). Pentru a-l asocia cu rețeaua de acasă:
- Conectați un telefon sau un laptop la punctul de acces al i3
- Deschideți
http://192.168.33.1într-un browser (sau folosiți aplicația mobilă Shelly) - În interfața web accesați Internet & Security → WIFI MODE - CLIENT, introduceți datele de acces la rețeaua Wi-Fi de acasă și salvați
- Dispozitivul repornește și se conectează la rețeaua de acasă prin DHCP
Adresa IP atribuită se poate afla din tabelul de alocări DHCP al routerului sau prin numele de gazdă mDNS shellyi3-XXXXXXXXXXXX.local (sufix MAC de 12 caractere, anunțat ca _http._tcp.local.). La importul șablonului în TapHome, introduceți această adresă IP ca singurul parametru obligatoriu.
Dezactivarea autentificării HTTP
TapHome nu se poate autentifica pe dispozitiv. În interfața web Shelly accesați Internet & Security → RESTRICT LOGIN și asigurați-vă că opțiunea este dezactivată înainte de importul șablonului — altfel fiecare interogare va eșua cu HTTP 401.
Configurarea tipului de buton
Fiecare dintre cele trei intrări poate funcționa într-unul dintre cele cinci moduri btn_type. Doar două sunt relevante pentru TapHome și sunt disponibile ca acțiune de service pe dispozitivele I1 / I2 / I3:
- Momentary — pentru butoane. Firmware-ul decodează apăsarea scurtă simplă (
S), apăsarea lungă (L), apăsarea scurtă dublă (SS), apăsarea scurtă triplă (SSS), scurtă→lungă (SL) și lungă→scurtă (LS). Este necesar pentru ca dispozitivele Events I{N} să transmită altceva decâtNone. - Toggle — pentru întrerupătoarele clasice basculante sau cu manetă. Se raportează doar starea brută 0/1; comutatorul cu mai multe valori rămâne la indexul 0.
Tipul de buton poate fi schimbat oricând din TapHome, prin acțiunea de service Tip buton a fiecărui dispozitiv I1 / I2 / I3, sau direct în interfața web Shelly, la Settings → Input/Output settings.
Firmware-ul acceptă și modurile
edge,detachedșiaction, dar acestea nu sunt disponibile în șablonul TapHome. Ele pot fi totuși setate din interfața web Shelly fără a afecta integrarea — se modifică doar comportamentul de decodare a apăsărilor multiple.
Funcțiile dispozitivului
Decodarea evenimentelor de apăsări multiple (Events I1, Events I2, Events I3)
Pentru fiecare intrare, un comutator cu mai multe valori decodează codul de eveniment din firmware într-una dintre cele șapte valori:
| Index | Eveniment | Cod Shelly |
|---|---|---|
| 0 | None | "" (inactiv) |
| 1 | Shortpush | S |
| 2 | Longpush | L |
| 3 | Double Shortpush | SS |
| 4 | Triple Shortpush | SSS |
| 5 | Shortpush + Longpush | SL |
| 6 | Longpush + Shortpush | LS |
Șablonul interoghează /input/{0,1,2} la fiecare 2,5 secunde și citește câmpul event. Cu 6 evenimente × 3 intrări, potrivit Shelly, i3 permite până la 18 acțiuni distincte prin apăsări multiple (24, dacă schimbările brute ale stării pornit/oprit sunt considerate declanșatoare separate).
Pragul pentru apăsarea lungă și fereastra pentru apăsări multiple se configurează global pe dispozitiv (implicit: 800 ms pentru apăsarea lungă, 500 ms între apăsări). Acestea pot fi ajustate în interfața web Shelly, la Settings → Long Push Duration și Multi Push Time.
Starea brută a intrării și comanda tipului de buton (I1, I2, I3)
Pentru fiecare intrare, un dispozitiv de tip contact reed oferă starea logică brută citită din câmpul input al /input/{N} (0 = deschis, 1 = închis, după inversarea opțională btn_reverse). Fiecare dispozitiv I1 / I2 / I3 are și:
- Atributul de service Tip buton — valoarea curentă
btn_type(toggle / momentary / edge / detached / action) - Acțiunea de service Tip buton — comută intrarea între Toggle și Momentary, scriind
POST /settings/input/{N}?btn_type=...
Starea brută este potrivită pentru contactele magnetice de ușă / fereastră conectate la bornele SW sau pentru urmărirea în timp real a poziției unui întrerupător basculant.
Diagnosticare de service
Un singur atribut de service la nivelul modulului oferă SSID-ul Wi-Fi al rețelei la care este conectat în prezent i3 (citit din /status → wifi_sta.ssid). Alte date de diagnosticare Gen1 (timpul de funcționare, adresa MAC, RSSI, indicatorul de actualizare a firmware-ului) sunt disponibile în API-ul REST al dispozitivului, dar nu sunt incluse în acest șablon.
Evenimentele de apăsări multiple se declanșează doar în modul momentary. Dacă o intrare fizică este conectată la un întrerupător basculant clasic, configurați intrarea respectivă ca Toggle și folosiți dispozitivul de tip contact reed I{N} pentru a citi starea ei 0/1 — dispozitivul Events I{N} corespunzător va rămâne la indexul 0.
Rezolvarea problemelor
Evenimentele de apăsări multiple nu sunt detectate
- Verificați dacă intrarea este în modul momentary — deschideți dispozitivul I{N} în TapHome, rulați acțiunea de service Tip buton și selectați Momentary sau setați modul direct în interfața web Shelly, la Settings → Input/Output settings
- În modul toggle, firmware-ul raportează doar schimbările de stare; comutatorul cu mai multe valori Events I{N} rămâne la indexul 0
- Dacă apăsările sunt decodate ca alt eveniment, ajustați Long Push Duration (implicit 800 ms) și Multi Push Time (implicit 500 ms) în interfața web Shelly
- Secvențele lungi, precum
SSS,SLsauLS, necesită ca toate apăsările să fie făcute în fereastra pentru apăsări multiple — pauzele după eliberarea butonului mai lungi decât această fereastră sunt decodate ca evenimenteSseparate
Același eveniment se repetă la nesfârșit / eveniment „blocat”
Câmpul event returnat de /input/{N} este ultimul eveniment decodat — firmware-ul nu îl șterge automat. TapHome citește acest câmp la fiecare interogare, așa că comutatorul cu mai multe valori va raporta în continuare evenimentul anterior până la apariția unuia nou. Acesta este un comportament normal și nu indică un defect. Când scrieți o logică proprie care se declanșează la fiecare apăsare, asociați evenimentul cu contorul monoton event_cnt (disponibil tot în /input/{N}) pentru a detecta o schimbare, în loc să vă bazați doar pe valoarea event.
Dispozitivul nu răspunde
- Verificați dacă i3 este conectat la Wi-Fi — deschideți
http://{device-ip}/shellyîntr-un browser; dacă returnează un obiect JSON, dispozitivul este accesibil - Încercați numele de gazdă mDNS
shellyi3-XXXXXXXXXXXX.localîn locul adresei IP — adresa IP s-ar fi putut schimba după reînnoirea DHCP - Asigurați-vă că autentificarea HTTP este dezactivată la Internet & Security → Restrict login — TapHome nu poate trimite date de autentificare și fiecare cerere va returna HTTP 401
- Verificați dacă TapHome Core și dispozitivul Shelly se află în aceeași rețea sau VLAN, cu mDNS / multicast permis
Dispozitivele Shelly Gen1 acceptă maximum 2 conexiuni HTTP simultane. Șablonul livrat interoghează fiecare intrare la intervale de 2,5 s, ceea ce este deja aproape de limită. Nu reduceți intervalul de interogare și evitați rularea unui alt sistem (de ex. Home Assistant, scripturi proprii) care interoghează în același timp același i3 — comunicarea poate deveni instabilă.
Șablonul XML este livrat cu trei indici rezervați ai comutatorului cu mai multe valori (7, 8, 9, cu codurile brute 71/72/73 și etichetele generice „7” / „8” / „9”). Firmware-ul Gen1 nu emite alte evenimente în afară de
S,L,SS,SSS,SLșiLS, așa că acești indici sunt poziții rezervate, nefolosite, iar valoarea dispozitivului Events I{N} corespunzător nu ar trebui să ajungă în practică niciodată la 7-9.