
Der Shelly i3 ist eine kompakte Wi-Fi 3-Eingangs-Aktions- und Szenensteuerung (Modell SHIX3-1). Er hat keine Relais oder Ausgänge — er fungiert ausschließlich als Eingabegerät, das drei externe Schalter oder Taster überwacht, die an die Klemmen SW1, SW2 und SW3 angeschlossen sind. Die Abmessungen 40 × 36 × 10 mm ermöglichen die Installation in einer Standard-Unterputzdose hinter einem bestehenden Wandschalter. Er wird mit 110–230 VAC (Neutralleiter erforderlich) oder 24–60 VDC betrieben und verbraucht weniger als 1 W.
TapHome kommuniziert mit dem Gerät über HTTP im lokalen Wi-Fi-Netzwerk — eine Cloud-Verbindung ist nicht erforderlich. Für jeden Eingang erstellt die Vorlage zwei Geräte: einen Multi-Wert-Schalter, der Multi-Klick-Ereignisse dekodiert (Einzel-, Doppel-, Dreifach-, Lang- und kombinierte Sequenzen), und einen Reed-Kontakt, der den rohen 0/1-Eingangszustand sowie eine Service-Aktion zum Umschalten zwischen Toggle- und Momentary-Modus bereitstellt.
Einrichtung
Wi-Fi-Kopplung und IP-Adresse
Nach dem Einschalten startet der i3 im Access-Point-Modus mit der SSID shellyi3-XXXXXX (wobei XXXXXX die letzten 6 Hex-Ziffern der MAC sind). Zum Koppeln mit dem Heimnetzwerk:
- Verbinde Telefon oder Laptop mit dem i3 Access Point
- Öffne
http://192.168.33.1im Browser (oder verwende die Shelly Mobile App) - Gehe in der Web-Oberfläche zu Internet & Security → WIFI MODE - CLIENT, gib die WLAN-Zugangsdaten ein und speichere
- Das Gerät startet neu und tritt dem Heimnetzwerk per DHCP bei
Die zugewiesene IP-Adresse findest du in der DHCP-Lease-Tabelle des Routers oder über den mDNS-Hostnamen shellyi3-XXXXXXXXXXXX.local (12-stelliger MAC-Suffix, angekündigt als _http._tcp.local.). Beim Import der TapHome-Vorlage gib diese IP-Adresse als einzigen erforderlichen Parameter ein.
HTTP-Authentifizierung deaktivieren
TapHome kann sich nicht gegen das Gerät authentifizieren. Gehe in der Shelly-Weboberfläche zu Internet & Security → RESTRICT LOGIN und stelle sicher, dass diese Option deaktiviert ist, bevor du die Vorlage importierst — sonst schlägt jede Abfrage mit HTTP 401 fehl.
Tastentyp-Konfiguration
Jeder der drei Eingänge kann in einem von fünf btn_type-Modi laufen. Nur zwei sind für TapHome relevant und werden als Service-Aktion auf den Geräten I1 / I2 / I3 bereitgestellt:
- Momentary — für Taster. Die Firmware dekodiert einzelnen kurzen Druck (
S), langen Druck (L), doppelten kurzen Druck (SS), dreifachen kurzen Druck (SSS), kurz→lang (SL) und lang→kurz (LS). Erforderlich, damit die Events I{N}-Geräte etwas anderes alsNoneauslösen. - Toggle — für klassische Wipp- oder Kippschalter. Es wird nur der rohe 0/1-Zustand gemeldet; der Multi-Wert-Schalter bleibt auf Index 0.
Der Tastentyp kann jederzeit von TapHome über die Service-Aktion Button Type auf jedem I1 / I2 / I3-Gerät geändert werden, oder direkt in der Shelly-Weboberfläche unter Settings → Input/Output settings.
Die Firmware unterstützt auch die Modi
edge,detachedundaction, diese werden jedoch nicht in der TapHome-Vorlage bereitgestellt. Sie können trotzdem über die Shelly-Weboberfläche eingestellt werden, ohne die Integration zu beeinträchtigen — nur das Multi-Klick-Dekodierungsverhalten ändert sich.
Gerätefunktionen
Multi-Klick-Ereignisdekodierung (Events I1, Events I2, Events I3)
Für jeden Eingang dekodiert ein Multi-Wert-Schalter den firmware-seitigen Ereigniscode in einen von sieben Werten:
| Index | Ereignis | Shelly-Code |
|---|---|---|
| 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 |
Die Vorlage fragt /input/{0,1,2} alle 2,5 Sekunden ab und liest das Feld event. Mit 6 Ereignissen × 3 Eingängen vermarktet Shelly den i3 als Unterstützung für bis zu 18 verschiedene Multi-Klick-Aktionen (24, wenn rohe On/Off-Zustandsänderungen als separate Auslöser gezählt werden).
Der Long-Push-Schwellwert und das Multi-Push-Fenster sind global auf dem Gerät konfiguriert (Standardwerte: 800 ms für Langdruck, 500 ms Inter-Druck-Fenster). Sie können in der Shelly-Weboberfläche unter Settings → Long Push Duration und Multi Push Time angepasst werden.
Roher Eingangszustand und Tastentyp-Steuerung (I1, I2, I3)
Für jeden Eingang stellt ein Reed-Kontakt-Gerät den rohen logischen Zustand bereit, der aus dem input-Feld in /input/{N} gelesen wird (0 = offen, 1 = geschlossen, nach optionaler btn_reverse-Umkehrung). Jedes I1 / I2 / I3-Gerät enthält außerdem:
- Button Type — Service-Attribut mit dem aktuellen
btn_type-Wert (toggle / momentary / edge / detached / action) - Button Type — Service-Aktion, die den Eingang zwischen Toggle und Momentary umschaltet, indem sie
POST /settings/input/{N}?btn_type=...schreibt
Der rohe Zustand eignet sich für Magnetkontakte von Türen / Fenstern, die an die SW-Klemmen verdrahtet sind, oder für die Echtzeitverfolgung der Position eines Kippschalters.
Service-Diagnostik
Ein einzelnes Service-Attribut auf Modulebene stellt die Wi-Fi-SSID bereit, mit der der i3 derzeit verbunden ist (gelesen aus /status → wifi_sta.ssid). Andere Gen1-Diagnostiken (Uptime, MAC, RSSI, Firmware-Update-Flag) sind über die REST-API des Geräts verfügbar, werden aber in dieser Vorlage nicht bereitgestellt.
Multi-Klick-Ereignisse werden nur im Momentary-Modus ausgelöst. Wenn ein physischer Eingang über einen klassischen Kippschalter verdrahtet ist, konfiguriere diesen Eingang als Toggle und verwende das Reed-Kontakt-Gerät I{N}, um seinen 0/1-Zustand zu lesen — das entsprechende Events I{N}-Gerät bleibt auf Index 0.
Fehlerbehebung
Multi-Klick-Ereignisse werden nicht erkannt
- Überprüfe, ob der Eingang im Momentary-Modus ist — öffne das I{N}-Gerät in TapHome, führe die Service-Aktion Button Type aus und wähle Momentary, oder stelle es direkt in der Shelly-Weboberfläche unter Settings → Input/Output settings ein
- Im Toggle-Modus meldet die Firmware nur Zustandsänderungen; der Events I{N}-Multi-Wert-Schalter bleibt auf Index 0
- Passe Long Push Duration (Standard 800 ms) und Multi Push Time (Standard 500 ms) in der Shelly-Weboberfläche an, wenn Drücke als falsches Ereignis dekodiert werden
- Lange Sequenzen wie
SSS,SLoderLSerfordern, dass der Benutzer alle Drücke innerhalb des Multi-Push-Fensters hält — Pausen, die länger als dieses Fenster sind, werden als separateS-Ereignisse dekodiert
Dasselbe Ereignis wiederholt sich für immer / „festgefahrenes" Ereignis
Das von /input/{N} zurückgegebene Feld event ist das letzte dekodierte Ereignis — die Firmware löscht es nicht automatisch. TapHome liest dieses Feld bei jeder Abfrage, sodass der Multi-Wert-Schalter das vorherige Ereignis weiterhin meldet, bis ein neues auftritt. Dies ist normales Verhalten und weist nicht auf einen Fehler hin. Beim Schreiben benutzerdefinierter Logik, die bei jedem Druck ausgelöst wird, paare das Ereignis mit dem monotonen event_cnt-Zähler (ebenfalls in /input/{N} verfügbar), um eine Änderung zu erkennen, anstatt sich nur auf den event-Wert zu verlassen.
Gerät reagiert nicht
- Überprüfe, ob der i3 mit Wi-Fi verbunden ist — öffne
http://{device-ip}/shellyim Browser; wenn ein JSON-Objekt zurückgegeben wird, ist das Gerät erreichbar - Versuche den mDNS-Hostnamen
shellyi3-XXXXXXXXXXXX.localanstelle der IP-Adresse — die IP kann sich nach einer DHCP-Erneuerung geändert haben - Stelle sicher, dass die HTTP-Authentifizierung unter Internet & Security → Restrict login deaktiviert ist — TapHome kann keine Anmeldedaten senden und jede Anfrage gibt HTTP 401 zurück
- Überprüfe, ob TapHome Core und das Shelly-Gerät sich im selben Netzwerk oder VLAN mit erlaubtem mDNS / Multicast befinden
Gen1 Shelly-Geräte akzeptieren maximal 2 gleichzeitige HTTP-Verbindungen. Die mitgelieferte Vorlage fragt jeden Eingang in 2,5-s-Intervallen ab, was bereits nahe am Limit liegt. Senke das Abfrageintervall nicht und vermeide den Betrieb eines anderen Systems (z. B. Home Assistant, eigene Skripte), das denselben i3 gleichzeitig abfragt — die Kommunikation kann unzuverlässig werden.
Die XML-Vorlage enthält drei reservierte Multi-Wert-Indizes (7, 8, 9 mit Rohcodes 71/72/73 und generischen Bezeichnungen „7" / „8" / „9"). Die Gen1-Firmware sendet keine Ereignisse außer
S,L,SS,SSS,SLundLS, sodass diese Indizes ungenutzte Platzhalter sind und der Wert des Events I{N}-Geräts in der Praxis niemals 7-9 erreichen sollte.