---
title: "Shelly Plus 1"
description: "Shelly Plus 1 Gen2+ WLAN-Relais mit potentialfreien Kontakten. Einkanal-Schaltsteuerung über RPC-API per HTTP von TapHome."
url: "https://taphome.com/de/compatibility/shelly-plus-1/"
language: de
lastmod: 2026-03-29
generator: hugo
ai:
  topics: ["http","i/o-module","wifi","relay","switch","gen2plus"]
  questions: ["Wie integriert man Shelly Plus 1 mit TapHome?","Wie verbindet man Shelly Plus 1 über HTTP mit TapHome?","Unterstützt Shelly Plus 1 Leistungsmessung in TapHome?","Was ist der Unterschied zwischen Shelly Plus 1 und Plus 1PM in TapHome?","Kann Shelly Plus 1 Gleichstromlasten über TapHome schalten?","Wie behebt man das Problem, wenn Shelly Plus 1 in TapHome nicht reagiert?"]
---

# Shelly Plus 1

Kommunikation: Packet Parser → HTTP

- [Shelly Plus 1 Produktseite](https://www.shelly.com/en/products/shop/shelly-plus-1)
- [Shelly Plus 1 API-Dokumentation](https://shelly-api-docs.shelly.cloud/gen2/)

> Netzwerkadresse
> 
> TapHome erreicht dieses Gerät unter der beim Import eingegebenen Adresse. Geben Sie dem Gerät eine feste Adresse — eine IP-Reservierung im Router oder seinen mDNS-Namen, falls es einen unterstützt —, sonst funktioniert die Integration nicht mehr, sobald der Router die Adresse ändert.
> 
> [Netzwerkvorbereitung](https://taphome.com/de/docs/setup/network-preparation/)

## Integrationsanleitung

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.

> [!NOTE]
> 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](https://www.shelly.com/en/support/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**

> [!NOTE]
> 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

> [!TIP]
> 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

> [!NOTE]
> 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 1

Diese Geräte erscheinen nach dem Import in TapHome.

Shelly Plus 1 Modul

Benutzerdefinierte Variablen

|                   |
|-------------------|
| `status` (string) |

Schalter Schalter Lesen und Schreiben

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

boolean

Werte / Zustände: ON · OFF

Schaltzustand lesen

```taphome
var x := (sendhttprequest("/rpc/Switch.GetStatus?id=0"));
status := x.Content;
return(PARSEJSON(status, "$.output", true));
```

Schaltzustand schreiben

```taphome
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 • Hostname: `shellyplus1-{MAC}.local`

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

## Importparameter

Diese Werte geben Sie beim Import des XML ein.

| In der App abgefragt | Standard      |
|----------------------|---------------|
| IP-Adresse           | `192.168.0.1` |

## Quellen

- Shelly Gen2+ RPC API Reference
  
  [shelly-api-docs.shelly.cloud](https://shelly-api-docs.shelly.cloud/gen2/) 2026-03-29
- Shelly Gen2+ Switch Component API
  
  [shelly-api-docs.shelly.cloud](https://shelly-api-docs.shelly.cloud/gen2/ComponentsAndServices/Switch/) 2026-03-29
- Shelly Gen2+ System Component API
  
  [shelly-api-docs.shelly.cloud](https://shelly-api-docs.shelly.cloud/gen2/ComponentsAndServices/Shelly/) 2026-03-29
- Shelly Gen2+ WiFi Component API
  
  [shelly-api-docs.shelly.cloud](https://shelly-api-docs.shelly.cloud/gen2/ComponentsAndServices/Wifi/) 2026-03-29
- Home Assistant Shelly Integration
  
  [www.home-assistant.io](https://www.home-assistant.io/integrations/shelly/) 2026-03-29
- Shelly Plus 1 Knowledge Base
  
  [kb.shelly.cloud](https://kb.shelly.cloud/knowledge-base/shelly-plus-1) 2026-03-29

## Verwandte Dokumentation

- [Packet-Parser-Integration](https://taphome.com/de/compatibility/packet-parser-guide/)
- [Packet Parser (HTTP, TCP, UDP, FTP, MQTT)](https://taphome.com/de/docs/integration/packet-parser/)
- [Packet-Parser-Funktionen](https://taphome.com/de/docs/script/packet-parser/)
- [Parsing-Funktionen](https://taphome.com/de/docs/script/parsing-functions/)