---
title: "Shelly Dimmer 2"
description: "Shelly Dimmer 2 lokal per HTTP ohne Cloud: Helligkeit mit sanftem Übergang, Lichtschalter sowie momentane Leistung und Gesamtverbrauch in TapHome."
url: "https://taphome.com/de/compatibility/shelly-dimmer2/"
language: de
lastmod: 2026-03-29
generator: hugo
ai:
  topics: ["http","lighting","wifi","dimmer","power-metering"]
  questions: ["Wie integriere ich den Shelly Dimmer 2 mit TapHome?","Was steuert die TapHome-Vorlage für den Shelly Dimmer 2?","Wie verbinde ich den Shelly Dimmer 2 per HTTP mit TapHome?","Wie stelle ich einen sanften Helligkeitsübergang beim Shelly Dimmer 2 ein?","Was ist die Mindestlast für den Shelly Dimmer 2?","Warum flackert der Shelly Dimmer 2 bei niedriger Helligkeit?"]
---

# Shelly Dimmer 2

Kommunikation: Packet Parser → HTTP

- [Shelly Dimmer 2 — Produktseite](https://kb.shelly.cloud/knowledge-base/shelly-dimmer-2)

> 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 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

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

> [!WARNING]
> 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](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 3

Diese Geräte erscheinen nach dem Import in TapHome.

Shelly Dimmer2 Modul

Serviceattribute

|      |
|------|
| WiFi |

Serviceattribute

Wifi

```taphome
 VAR response := SENDHTTPREQUEST("/settings");
 IF response.IsSuccess
  VAR content := response.Content;
  RETURN(PARSEJSON(content, "$.wifi_sta.ssid"));
  End
```

Helligkeit Dimmer Lesen und Schreiben

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

numeric Einheit: %

Serviceattribute

|          |
|----------|
| Übergang |

Serviceaktionen

|          |
|----------|
| Übergang |

Level lesen

```taphome
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

```taphome
VAR response := SENDHTTPREQUEST("/light/0?brightness=" + Le*100);
IF response.IsSuccess = false
 ADDERROR(response.StatusCode);
 END
```

Serviceattribute

Transition

```taphome
 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)

```taphome
 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

Gesamtverbrauch lesen

```taphome
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

```taphome
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 Lesen und Schreiben

boolean

Werte / Zustände: ON · OFF

Schaltzustand lesen

```taphome
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

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

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)

## Importparameter

Diese Werte geben Sie beim Import des XML ein.

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

## Quellen

- Shelly Gen1 API Reference
  
  [shelly-api-docs.shelly.cloud](https://shelly-api-docs.shelly.cloud/gen1/) 2026-03-12
- Home Assistant Shelly Integration
  
  [www.home-assistant.io](https://www.home-assistant.io/integrations/shelly/) 2026-03-12
- Shelly Dimmer 2 Knowledge Base
  
  [kb.shelly.cloud](https://kb.shelly.cloud/knowledge-base/shelly-dimmer-2) 2026-03-29
- Shelly Dimmer 2 API Reference (Gen1)
  
  [shelly-api-docs.shelly.cloud](https://shelly-api-docs.shelly.cloud/gen1/#shelly-dimmer-dimmer2) 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/)