TapHome

Shelly Plus 1

Packet Parser → HTTP
Eingereicht von
Zuletzt aktualisiert: 03. 2026
Shelly Plus 1

Der Shelly Plus 1 ist ein kompakter WLAN-Relaisschalter mit potentialfreien Kontakten. Er passt hinter einen Standard-Wandschalter und kann einen Stromkreis bis 16 A (3500 W bei 230 V AC) oder 10 A (30 V DC) steuern. Das Gerät unterstützt einen breiten Spannungsbereich — 110-240 VAC, 24-48 VDC oder 12 VDC — und eignet sich damit sowohl für Netz- als auch Niederspannungsinstallationen. TapHome kommuniziert mit dem Gerät über HTTP mittels der Gen2+ RPC-API im lokalen Netzwerk — keine Cloud-Verbindung erforderlich.

Die Vorlage stellt einen einzelnen Relaisschalter bereit. Im Gegensatz zum Plus 1PM verfügt dieses Gerät über keine integrierte Leistungsmessung.

Konfiguration

Der Shelly Plus 1 verbindet sich über WLAN. Beim Vorlagenimport in TapHome geben Sie die IP-Adresse des Geräts ein (Standardwert 192.168.0.1).

Das Gerät verwendet die Gen2+ JSON-RPC-API. Die gesamte Kommunikation erfolgt über HTTP-GET-Anfragen an /rpc/-Endpunkte auf Port 80.

Gerätefunktionen

Relaissteuerung

Die Vorlage stellt das Relais als Schaltgerät bereit. Der Relaisstatus wird aus der Antwort von /rpc/Switch.GetStatus?id=0 gelesen (Feld output, Boolean) und über /rpc/Switch.Set?id=0 mit on=true oder on=false gesteuert.

Das Abfrageintervall beträgt 2,5 Sekunden und bietet damit nahezu Echtzeit-Statusrückmeldung in TapHome.

Weitere Funktionen

Der Shelly Plus 1 stellt über die RPC-API auch die interne Relaistemperatur, den Status des physischen Eingangs, die MAC-Adresse, die Betriebszeit, die RAM-Auslastung, die Gerätezeit, die IP-Adresse, den WLAN-Namen und die WLAN-Signalstärke bereit. Ein Auto-Off-Timer (Parameter toggle_after) sowie Geräteneustart/Firmware-Update-Aktionen sind ebenfalls verfügbar. Diese Funktionen können in einem zukünftigen Vorlagenupdate hinzugefügt werden.

Der Shelly Plus 1 hat keine Leistungsmessung. Wenn Sie Energiemonitoring benötigen, verwenden Sie stattdessen den Shelly Plus 1PM — er hat den gleichen Formfaktor und die gleichen Relaisfunktionen, bietet aber zusätzlich Messung von Momentanleistung, Spannung, Strom und kumulativem Energieverbrauch.

Fehlerbehebung

Gerät reagiert nicht
  1. Überprüfen Sie, ob der Shelly mit dem WLAN verbunden ist und eine gültige IP-Adresse hat
  2. Versuchen Sie den mDNS-Hostnamen (shellyplus1-AABBCCDDEE.local) statt der IP-Adresse — die IP kann sich nach einer DHCP-Erneuerung geändert haben
  3. Öffnen Sie http://{geraete-ip}/rpc/Shelly.GetDeviceInfo im Browser — wenn JSON zurückkommt, ist das Gerät erreichbar
  4. Prüfen Sie, ob TapHome CCU und Shelly im gleichen Netzwerk / VLAN sind
  5. Stellen Sie sicher, dass die HTTP-Digest-Authentifizierung in der Shelly-Weboberfläche deaktiviert ist — TapHome unterstützt keine authentifizierten Anfragen
Relais schaltet nicht
  1. Überprüfen Sie den Eingangsmodus in der Shelly-Weboberfläche (Einstellung in_mode) — bei detached beeinflusst der physische Schalter das Relais nicht, HTTP-Befehle sollten aber weiterhin funktionieren
  2. Rufen Sie /rpc/Switch.GetStatus?id=0 manuell auf und prüfen Sie, ob sich das Feld output beim Umschalten ändert
  3. Prüfen Sie das Feld source in der Statusantwort, um zu sehen, was das Relais zuletzt gesteuert hat
Langsame Reaktion oder Zeitüberschreitungen
  1. Gen2+-Geräte unterstützen bis zu 6 gleichzeitige HTTP-Verbindungen (gegenüber 2 bei Gen1) — vermeiden Sie jedoch übermäßiges Polling von mehreren Systemen
  2. Deaktivieren Sie den ECO-Modus in der Shelly-Weboberfläche, falls aktiviert — er versetzt das Gerät zwischen Abfragen in den Schlafmodus und kann bei kurzen Abfrageintervallen Zeitüberschreitungen verursachen
  3. Verwenden Sie eine statische IP oder DHCP-Reservierung, um Adressänderungen zu vermeiden

Installation in TapHome

Voraussetzungen

  • Shelly-Gerät installiert und eingeschaltet
  • Lokales Wi-Fi-Netzwerk (2,4 GHz)
  • TapHome CCU im selben Netzwerk

Schritt 1 — Shelly mit Wi-Fi verbinden

Option A — Shelly-App (empfohlen):

  1. Laden Sie die Shelly-App herunter (iOS / Android)
  2. Tippen Sie auf + → Add Device und folgen Sie dem Bluetooth-Kopplungsassistenten
  3. Geben Sie Ihre Wi-Fi-Zugangsdaten ein, wenn Sie dazu aufgefordert werden

Option B — AP-Modus (ohne App):

  1. Beim ersten Einschalten erstellt das Gerät einen Hotspot: ShellyXXX-AABBCCDDEE
  2. Verbinden Sie Ihr Telefon/PC mit diesem Hotspot
  3. Öffnen Sie http://192.168.33.1 → Internet & Security → Wi-Fi Mode - Client
  4. Geben Sie SSID und Passwort ein → Save

Shelly unterstützt nur 2,4 GHz-Netzwerke. 5 GHz-Netzwerke werden beim Scannen nicht angezeigt.

Schritt 2 — IP-Adresse ermitteln

Nach der Verbindung mit Wi-Fi ermitteln Sie die zugewiesene IP-Adresse auf eine der folgenden Arten:

  • Shelly-App: Gerätedetail → Device info → IP-Adresse
  • Shelly-Weboberfläche: Verbinden Sie sich mit dem Geräte-AP vor der Wi-Fi-Einrichtung — die IP wird nach dem Speichern angezeigt
  • Router-DHCP-Tabelle: Suchen Sie nach einem Hostnamen wie shelly1pm-AABBCCDDEE
  • mDNS: Pingen Sie shelly<model>-<mac>.local (z. B. shelly1pm-AABBCCDDEE.local) aus dem selben Netzwerk

Weisen Sie dem Shelly-Gerät eine statische IP (DHCP-Reservierung) in Ihrem Router zu, damit sich die Adresse nach einem Router-Neustart nicht ändert.

Schritt 3 — Konfiguration in TapHome

  1. Fügen Sie in TapHome ein neues Modul Packet Parser (HTTP) hinzu
  2. IP Address: Geben Sie die IP aus Schritt 2 ein (z. B. 192.168.1.50)
  3. Port: 80 (Standard, keine Änderung erforderlich)
  4. Importieren Sie die Vorlage — TapHome fragt regelmäßig /status ab, um den Gerätestatus zu lesen

Die HTTP-Authentifizierung ist auf Shelly-Geräten standardmäßig deaktiviert. Wenn Sie den Anmeldeschutz aktiviert haben, unterstützt TapHome derzeit kein HTTP Basic Auth — lassen Sie die Authentifizierung für die TapHome-Integration deaktiviert.

Verfügbare Geräte

Shelly Plus 1 Modul
Benutzerdefinierte Variablen
status (string)
Schalter Schalter

Einkanal-Relaissteuerung — Ein/Aus-Schaltung über RPC API

boolean
Werte / Zustände: ON · OFF

Schalter

Schaltzustand lesen
var x := (sendhttprequest("/rpc/Switch.GetStatus?id=0"));
status := x.Content;
return(PARSEJSON(status, "$.output", true));
Schaltzustand schreiben
VAR response := SENDHTTPREQUEST("rpc/Switch.Set?id=0&on=" + if(St,"true","false"));
IF response.IsSuccess = false
  ADDERROR(response.StatusCode);
END
Verbindung: Packet Parser → HTTP
Mögliche Verbesserungen (12)
  • Switch Temperature — Internal relay temperature in °C, available in Switch.GetStatus response
  • Input State — Physical switch/button input state, available via /rpc/Input.GetStatus?id=0
  • MAC Address — Device MAC address, available in Sys.GetStatus response
  • Uptime — Seconds since last reboot, available in Sys.GetStatus response
  • RAM Usage — Total and free RAM in bytes, available in Sys.GetStatus response
  • Device Time — Current device time in HH:MM format, available in Sys.GetStatus response
  • IP Address — Device station IP address, available in WiFi.GetStatus response
  • WiFi SSID — Connected WiFi network name, available in WiFi.GetStatus response
  • WiFi Signal Strength — WiFi RSSI in dBm, available in WiFi.GetStatus response
  • Auto-off Timer — Auto-reset timer in seconds via toggle_after parameter, could be added as switch parameter
  • Reboot — Triggers device reboot, could be added as service action
  • Firmware Update — Initiates OTA firmware update to stable or beta channel

Quellen