TapHome

Shelly Dimmer 2

Packet Parser → HTTP
Eingereicht von
Zuletzt aktualisiert: 03. 2026
Shelly Dimmer 2

Der Shelly Dimmer 2 ist ein kompaktes WLAN-Dimmermodul für die Unterputzmontage. Er unterstützt dimmbare LEDs (10 – 200 W), Glüh-/Halogenlampen (10 – 220 W) und ferromagnetische Transformatoren. TapHome kommuniziert mit dem Gerät über HTTP im lokalen Netzwerk — keine Cloud-Verbindung erforderlich.

Die Vorlage bietet Helligkeitssteuerung mit einstellbarem sanften Übergang, einen Lichtschalter und einen Energiezähler, der die momentane Leistung und den Gesamtverbrauch ausliest.

Konfiguration

Der Shelly Dimmer 2 verbindet sich per WLAN. Beim Import der Vorlage in TapHome geben Sie die IP-Adresse des Geräts ein (Standard-Platzhalter 192.168.0.1).

Das Gerät unterstützt vier Verdrahtungsvarianten:

  • Mit Neutralleiter — Standardinstallation mit den Klemmen N, L, SW1, SW2, O
  • Ohne Neutralleiter, Mindestlast 10 W — ohne Neutralleiteranschluss, erfordert mindestens 10 W Last
  • Ohne Neutralleiter + Shelly Bypass — für Lasten unter 10 W ist das Shelly-Bypass-Modul erforderlich
  • Geschalteter Neutralleiter — alternative Verdrahtung mit geschaltetem Neutralleiter

Unterhalb der Mindestlast (10 W mit Neutralleiter, 20 W ohne) kann der Dimmer flackern oder sich nicht einschalten. Verwenden Sie für Lasten mit geringer Leistung ohne Neutralleiter das Shelly-Bypass-Modul.

Gerätefunktionen

Helligkeitssteuerung

Die Vorlage stellt einen Dimmer bereit, der die Helligkeitsstufe aus /light/0 (Feld brightness, 0 – 100 %) ausliest und über /light/0?brightness={Wert} einstellt. Der Wert wird intern normalisiert — die API verwendet 0 – 100 %, während TapHome mit dem Bereich 0,0 – 1,0 arbeitet.

Das Serviceattribut Transition zeigt die aktuelle Übergangszeit in Millisekunden an. Die Serviceaktion Transition ermöglicht das Einstellen eines sanften Helligkeitsübergangs (0 – 5000 ms) für einzelne Befehle über /light/0?transition={ms}.

Lichtschalter

Der Ein-/Aus-Zustand des Lichts wird unabhängig von der Helligkeitsstufe gesteuert. Die Vorlage liest ison aus /light/0 und schreibt über /light/0?turn=on oder /light/0?turn=off. Das Gerät hat das Fähigkeits-Flag lighting — es erscheint in TapHome als Lichtschalter, nicht als generisches Relais.

Leistungsmessung

Der integrierte Energiezähler liest zwei Werte aus der /status-Antwort:

  • Momentane Leistung — meters[0].power in Watt, von der Vorlage in kW umgerechnet
  • Gesamtverbrauch — meters[0].total in Wattminuten, von der Vorlage in kWh umgerechnet

Der Zähler ist schreibgeschützt und wird bei jedem Abfragezyklus automatisch aktualisiert (15-Sekunden-Intervall).

Servicediagnostik

Das Serviceattribut WiFi auf Modulebene liest die verbundene SSID aus /settings.

Weitere Funktionen

Der Shelly Dimmer 2 stellt in seiner /status-Antwort auch die interne Temperatur, den Überhitzungsschutzstatus, die Messvalidität, die WLAN-Signalstärke und zwei physische Schaltereingänge (SW1, SW2) bereit. Ein Nachtmodus mit zeitgesteuerter Helligkeitsbegrenzung und stufenweises Dimmen sind über die API verfügbar. Für einzelne Befehle kann ein Auto-Off-Timer gesetzt werden. Diese Funktionen können in einem zukünftigen Vorlagenupdate hinzugefügt werden.

Fehlerbehebung

Gerät antwortet 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 (shellydimmer2-AABBCCDDEE.local) statt der IP-Adresse — die IP kann sich nach einer DHCP-Erneuerung geändert haben
  3. Öffnen Sie http://{geraete-ip}/shelly im Browser — wenn das Gerät antwortet, ist es erreichbar
  4. Prüfen Sie, ob TapHome CCU und Shelly im selben Netzwerk / VLAN sind
Flackern oder instabiles Dimmen
  1. Stellen Sie sicher, dass die angeschlossene Last die Mindestleistung erfüllt (10 W mit Neutralleiter, 20 W ohne)
  2. Prüfen Sie, ob der Lasttyp unterstützt wird — nicht alle LED-Treiber sind mit Phasenanschnittdimmern kompatibel
  3. Passen Sie die Einstellung min_brightness über /settings/light/0 an, wenn das Licht bei niedrigen Stufen flackert
  4. Erhöhen Sie die warm_up-Zeit (0 – 1000 ms) in /settings/light/0 für Lasten, die eine Anlaufphase benötigen
Leistungsmessung zeigt null
  1. Stellen Sie sicher, dass die Last über den Dimmer angeschlossen ist (nicht umgangen)
  2. Prüfen Sie, ob das Licht eingeschaltet ist — der Zähler misst nur bei Stromfluss
  3. Fragen Sie /status manuell ab und überprüfen Sie, ob meters[0].power einen Wert ungleich null liefert

Gen1-Shelly-Geräte unterstützen nur 2 gleichzeitige HTTP-Verbindungen. Wenn TapHome und ein anderes System (z. B. Home Assistant) dasselbe Gerät gleichzeitig abfragen, kann die Kommunikation unzuverlässig werden. Verwenden Sie ein Abfrageintervall von 10 – 30 Sekunden.

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 Dimmer2 Modul
Serviceattribute
WiFi

Shelly Dimmer2

Serviceattribute
Wifi
 VAR response := SENDHTTPREQUEST("/settings");
 IF response.IsSuccess
  VAR content := response.Content;
  RETURN(PARSEJSON(content, "$.wifi_sta.ssid"));
  End
Helligkeit Dimmer

Dimmerstufe 0 – 100 % mit einstellbarem sanften Übergang (0 – 5000 ms)

numeric Einheit: %
Serviceattribute
Übergang
Serviceaktionen
Übergang

Helligkeit

Level lesen
VAR response := SENDHTTPREQUEST("/light/0");
 IF response.IsSuccess
  VAR content := response.Content;
  RETURN(PARSEJSON(content, "brightness")/100);
 ELSE
  ADDERROR(response.StatusCode + " (" + response.ReasonPhrase + ")");
  RETURN(NaN);
 END
Level schreiben
VAR response := SENDHTTPREQUEST("/light/0?brightness=" + Le*100);
IF response.IsSuccess = false
 ADDERROR(response.StatusCode);
 END
Serviceattribute
Transition
 VAR response := SENDHTTPREQUEST("/light/0");
 IF response.IsSuccess
  VAR content := response.Content;
  RETURN(PARSEJSON(content, "transition") + " ms");
 END
Serviceaktionen
Transition
Parameter: Transition time [ms] (0–5000 G)
 VAR response := SENDHTTPREQUEST("/light/0?transition=" + G);
Stromzähler Stromzähler Nur lesen

Leistungs- und Energiemessung — momentane Leistung (kW) und kumulierter Energieverbrauch (kWh)

numeric Einheit: W / kWh

Stromzähler

Gesamtverbrauch lesen
VAR response := SENDHTTPREQUEST("/status");
 IF response.IsSuccess
  VAR content := response.Content;
 VAR responseHeaders := response.Headers;
 RETURN(PARSEJSON(content, "$..meters..total")/60000);
 ELSE 
 ADDERROR(response.StatusCode + " (" + response.ReasonPhrase + ")");
  RETURN(NaN);
 END
Bedarf lesen
VAR response := SENDHTTPREQUEST("/status");
 IF response.IsSuccess
  VAR content := response.Content;
 VAR responseHeaders := response.Headers;
 RETURN(PARSEJSON(content, "$..meters..power")/1000);
 ELSE 
 ADDERROR(response.StatusCode + " (" + response.ReasonPhrase + ")");
  RETURN(NaN);
 END
Licht Schalter
boolean
Werte / Zustände: ON · OFF

Licht

Schaltzustand lesen
VAR response := SENDHTTPREQUEST("/light/0");
 IF response.IsSuccess
  VAR content := response.Content;
  RETURN(PARSEJSON(content, "ison"));
 ELSE
  ADDERROR(response.StatusCode + " (" + response.ReasonPhrase + ")");
  RETURN(NaN);
 END
Schaltzustand schreiben
var Ru := Switch(St, 1, "on", "off");
 VAR response := SENDHTTPREQUEST("/light/0?turn=" + Ru);
 IF response.IsSuccess = false
  ADDERROR(response.StatusCode);
 END
Verbindung: Packet Parser → HTTP
Mögliche Verbesserungen (9)
  • Brightness (via /status) — Current brightness also available in /status → lights[0].brightness; template uses /light/0 instead
  • Meter Validity — Measurement validity flag, available in /status response
  • Internal Temperature — Internal device temperature in °C, available in /status response
  • Overtemperature Protection — Overtemperature protection triggered flag, threshold 95°C
  • Night Mode — Night mode with start/end time and max brightness — configurable via /settings/night_mode
  • Switch Inputs (SW1, SW2) — Two physical switch inputs available in /status → inputs[0].input and inputs[1].input
  • WiFi Signal Strength — WiFi RSSI in dBm, available in /status response
  • Auto-off Timer — Auto-off timer in seconds, could be added as service action parameter
  • Incremental Dimming — Step-based dimming (dim up/down/stop with configurable step size 1-100)

Quellen