
Die Shelly Plus Plug S ist eine Gen2+ WLAN-Smart-Steckdose mit eingebauter Leistungsmessung und mehrfarbigem LED-Ring. Sie wird in eine normale CEE-7/3-Steckdose (Type-F / Schuko) gesteckt und kann Lasten bis 12 A / 2760 W bei 230 V schalten. TapHome kommuniziert mit dem Gerät lokal per WLAN über die Gen2+ JSON-RPC-API auf Port 80 — eine Cloud-Verbindung ist nicht erforderlich.
Die Vorlage stellt die Steckdose als sechs TapHome-Geräte bereit: einen Relais-Schalter, einen Stromzähler, einen LED-Modus-Wähler, zwei LED-Farbwähler (für Relais-AN und Relais-AUS) sowie einen Helligkeitsdimmer für den Leistungs-Anzeigemodus.
Konfiguration
Pairing und Netzwerkeinrichtung
Ab Werk startet das Gerät im Access-Point-Modus mit der SSID ShellyPlusPlugS-XXXXXX (LED blinkt blau). Verbinden Sie sich mit dieser SSID, öffnen Sie http://192.168.33.1/ und wählen Sie Ihr Heim-WLAN in der Weboberfläche aus. Nach dem LAN-Beitritt ist die Steckdose auf Port 80 unter ihrer Station-IP sowie über mDNS unter shellyplusplugs-<MAC>.local erreichbar.
TapHome fragt die Gen2+ RPC-Endpunkte über unverschlüsseltes HTTP ab — HTTPS ist standardmäßig deaktiviert und die HTTP-Authentifizierung (Shelly.SetAuth) muss deaktiviert bleiben, damit die Vorlage funktioniert. Stellen Sie sicher, dass die Steckdose im selben LAN / VLAN wie der TapHome Core ist.
Geben Sie beim Vorlagen-Import in TapHome die IP-Adresse der Steckdose als Parameter IpAddress ein. Eine statische DHCP-Reservierung wird dringend empfohlen, damit sich die Adresse nach Neustarts nicht ändert.
Gerätefunktionen
Relais-Steuerung
Das Relais wird als Schaltgerät bereitgestellt. Sein Zustand wird aus /rpc/Switch.GetStatus?id=0 gelesen (Boolean output) und über /rpc/Switch.Set?id=0&on=true|false gesteuert. Das Modul cached die komplette Switch.GetStatus-Antwort, sodass Relais, Zähler und Service-Attribute einen einzigen HTTP-Aufruf pro Abfrage teilen.
Leistungs- und Energiemessung
Der integrierte Zähler in der Switch-Komponente liefert:
- Momentanleistung —
apowerin Watt, von der Vorlage in kW umgerechnet (durch 1000 geteilt) - Kumulierte Energie —
aenergy.totalin Wattstunden, in kWh umgerechnet (durch 1000 geteilt)
Drei weitere Messwerte stehen als Service-Attribute am Zähler zur Verfügung:
| Attribut | Einheit | Quellfeld |
|---|---|---|
| Strom | A | current |
| Spannung | V | voltage |
| Interne Temperatur | °C | temperature.tC |
Der Zähler ist schreibgeschützt und wird bei jedem Pollzyklus aktualisiert.
LED-Anzeigemodus
Der mehrfarbige LED-Ring wird durch die Plus-Plug-S-spezifische RPC-Komponente PLUGS_UI gesteuert. TapHome stellt einen Modus-Wähler mit drei gültigen Optionen bereit — obwohl die Vorlage zehn Enum-Slots listet, entsprechen nur die ersten drei echten Firmware-Modi:
| Wert | Verhalten |
|---|---|
off | LED-Ring deaktiviert (WLAN-/AP-/Firmware-Diagnosemuster werden weiterhin angezeigt) |
switch | LED-Farbe spiegelt den Relaiszustand wider — verwendet die benutzerdefinierten Farben für AUS und AN |
power | LED-Farbe spiegelt die gemessene Last als Anteil des konfigurierten Leistungslimits wider (Gradient grün → gelb → rot) |
Der Moduswechsel ist eine rein kosmetische Änderung und erfordert keinen Neustart.
LED-Farben (Modus switch)
Zwei unabhängige HSB-Geräte ermöglichen die Wahl der LED-Ring-Farbe für jeden Relaiszustand:
- LED-Farbe (AUS-Zustand) — Farbe und Helligkeit bei ausgeschaltetem Relais
- LED-Farbe (AN-Zustand) — Farbe und Helligkeit bei eingeschaltetem Relais
Beide werden auf leds.colors.switch:0.{off|on}.{rgb,brightness} in der PLUGS_UI-Konfiguration abgebildet. Shelly speichert RGB-Werte in Prozent (0–100 pro Kanal) und nicht als 0–255, daher multipliziert die Vorlage jeden Kanal mit 2,55 bei der Umrechnung zwischen HSV und dem nativen Geräteformat. Die Umrechnung ist intern — in TapHome verhalten sich die Geräte wie jede andere HSB-Farbauswahl.
LED-Helligkeit (Modus power)
Im Modus power wählt die Firmware die Farbe automatisch basierend auf der Last. Benutzerkonfigurierbar ist nur die Helligkeit, weshalb die Vorlage sie als Dimmer bereitstellt (leds.colors.power.brightness, 0–100 % auf einen TapHome-Dimmerwert von 0,0–1,0 skaliert).
Moduldiagnose und -aktionen
Das HTTP-Modul stellt vier Service-Attribute bereit, die aus /rpc/WiFi.GetStatus und /rpc/Sys.GetStatus geparst werden:
| Attribut | Quelle |
|---|---|
| WLAN-SSID | ssid |
| IP-Adresse | sta_ip |
| Signalstärke | rssi (dBm) |
| MAC-Adresse | mac |
Außerdem stehen zwei Service-Aktionen zur Verfügung:
- Firmware-Update — löst ein OTA-Update vom Stable-Kanal aus (
/rpc/Shelly.Update?stage="stable"). Wird automatisch aktiviert, wennSys.GetStatusavailable_updates.stablemeldet. - Neustart — startet das Gerät neu (
/rpc/Shelly.Reboot), nützlich nach Netzwerkänderungen oder zur Behebung vorübergehender Probleme.
Wenn Sie nur Ein-/Aus-Steuerung und grundlegende Energiemessung benötigen, können Sie die LED-Geräte ignorieren — sie sind optional. Relais und Zähler arbeiten unabhängig vom LED-Modus.
Fehlersuche
Gerät reagiert nicht
- Prüfen Sie, ob die Steckdose mit WLAN verbunden ist — die LED sollte weder blinken noch dauerhaft rot leuchten
- Versuchen Sie den mDNS-Hostnamen
shellyplusplugs-<MAC>.localstatt der IP-Adresse — die DHCP-Lease hat sich möglicherweise geändert - Öffnen Sie
http://{geräte-ip}/rpc/Shelly.GetDeviceInfoim Browser; antwortet es mit JSON, ist das Gerät erreichbar - Stellen Sie sicher, dass TapHome Core und Steckdose im selben LAN / VLAN sind
- Vergewissern Sie sich, dass die HTTP-Authentifizierung in der Shelly-Weboberfläche deaktiviert ist — die Vorlage unterstützt keine Digest-Authentifizierung
Leistungsmesser zeigt null an
- Überprüfen Sie, ob tatsächlich eine Last an der Shelly angeschlossen und nicht umgangen ist
- Prüfen Sie, dass das Relais eingeschaltet ist — der Zähler meldet 0 W, wenn das Relais offen ist
- Rufen Sie
/rpc/Switch.GetStatus?id=0direkt im Browser auf und verifizieren Sie, dassapowerungleich null ist
LED ändert sich nach Moduswechsel nicht
- Die LED spiegelt den Laufzeitzustand nur in den Modi
switchundpowerwider; im Modusoffbleibt sie dunkel, außer bei Systemdiagnosemustern (AP-Modus, Wiederverbindung, OTA) - Stellen Sie im Modus
switchsicher, dass nicht beide Farben für AN und AUS auf schwarz / 0 % Helligkeit eingestellt sind - Systemanzeigen (blaues Blinken im AP-Modus, rot bei WLAN-Problemen) überschreiben immer die Benutzer-LED-Konfiguration — blinkt die LED rot, ist die Steckdose nicht in Ihrem WLAN
Firmware-Update-Aktion wird nicht ausgelöst
- Die Vorlage löst das Update nur aus, wenn
Sys.GetStatusavailable_updates.stablemeldet — starten Sie die Aktion manuell aus der Gerätekarte oder der Weboberfläche, falls die Steckdose bereits aktuell ist - Die Vorlage zielt nur auf den Stable-Kanal; Beta-Firmware muss über die Shelly-Weboberfläche installiert werden