---
title: "Shelly Dimmer 2"
description: "Reglarea luminozității, pornire/oprire și măsurarea energiei prin HTTP local. Șablon de integrare TapHome pentru dimmerul Wi-Fi Shelly Dimmer 2."
url: "https://taphome.com/ro/compatibility/shelly-dimmer2/"
language: ro
lastmod: 2026-03-29
generator: hugo
ai:
  topics: ["http","lighting","wifi","dimmer","power-metering"]
  questions: ["Cum integrez Shelly Dimmer 2 cu TapHome?","Ce comandă șablonul TapHome Shelly Dimmer 2?","Cum conectez Shelly Dimmer 2 la TapHome prin HTTP?","Cum setez o tranziție graduală a luminozității pe Shelly Dimmer 2?","Care este sarcina minimă pentru Shelly Dimmer 2?","De ce pâlpâie Shelly Dimmer 2 la luminozitate redusă?"]
---

# Shelly Dimmer 2

Comunicație: Packet Parser → HTTP

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

> Adresa în rețea
> 
> TapHome comunică cu dispozitivul la adresa introdusă la import. Atribuiți dispozitivului o adresă fixă — o rezervare IP în router sau numele său mDNS, dacă îl acceptă —, altfel integrarea nu mai funcționează când routerul schimbă adresa.
> 
> [Pregătirea rețelei](https://taphome.com/ro/docs/setup/network-preparation/)

## Ghid de integrare

Shelly Dimmer 2 este un modul dimmer Wi-Fi compact, destinat montării în spatele întrerupătorului de perete. Acceptă LED-uri dimabile (10–200 W), becuri incandescente/cu halogen (10–220 W) și transformatoare feromagnetice. TapHome comunică cu dispozitivul prin HTTP în rețeaua locală — nu este necesară conexiunea la cloud.

Șablonul oferă reglarea luminozității cu tranziții graduale configurabile, un întrerupător de lumină pornit/oprit și un contor electric care citește consumul de putere în timp real și consumul cumulat de energie.

## Configurare

Shelly Dimmer 2 se conectează prin Wi-Fi. La importul șablonului în TapHome, introduceți adresa IP a dispozitivului (valoarea implicită: `192.168.0.1`).

Dispozitivul acceptă patru variante de conectare:

- **Cu conductor neutru** — instalare standard cu bornele N, L, SW1, SW2, O
- **Fără neutru, sarcină minimă 10 W** — fără conexiune la neutru, necesită o sarcină de cel puțin 10 W
- **Fără neutru + Shelly Bypass** — pentru sarcini sub 10 W este necesar accesoriul Shelly Bypass
- **Neutru comutat** — conectare alternativă cu conductorul neutru comutat

> [!WARNING]
> Sub sarcina minimă (10 W cu neutru, 20 W fără neutru) dimmerul poate pâlpâi sau poate să nu pornească. Pentru sarcini de putere mică fără conductor neutru folosiți accesoriul Shelly Bypass.

## Funcțiile dispozitivului

### Reglarea luminozității

Șablonul oferă un dispozitiv de tip dimmer care citește nivelul de luminozitate din `/light/0` (câmpul `brightness`, 0–100 %) și îl setează prin `/light/0?brightness={value}`. Valoarea se normalizează intern — API-ul folosește 0–100 %, iar TapHome lucrează cu intervalul 0,0–1,0.

Atributul de service **Tranziție** afișează durata actuală a tranziției graduale în milisecunde. Acțiunea de service **Tranziție** permite setarea unei tranziții graduale a luminozității (0–5000 ms) pentru comenzi individuale prin `/light/0?transition={ms}`.

### Întrerupătorul de lumină

Starea pornit/oprit a luminii se comandă independent de nivelul de luminozitate. Șablonul citește `ison` din `/light/0` și scrie prin `/light/0?turn=on` sau `/light/0?turn=off`. Dispozitivul are indicatorul de capabilitate `lighting` — în TapHome apare ca întrerupător de lumină, nu ca releu generic.

### Măsurarea puterii

Contorul electric integrat citește două valori din răspunsul `/status`:

- **Putere în timp real** — `meters[0].power`, raportată în wați și convertită de șablon în kW
- **Consum total** — `meters[0].total`, raportat în wați-minut și convertit de șablon în kWh

Contorul este doar pentru citire și se actualizează automat la fiecare ciclu de interogare (interval de 15 secunde).

### Diagnosticare de service

Atributul de service **Wi-Fi** la nivel de modul citește din `/settings` SSID-ul rețelei Wi-Fi la care este conectat dispozitivul.

### Funcții suplimentare

În răspunsul `/status`, Shelly Dimmer 2 oferă și temperatura internă, starea protecției la supratemperatură, validitatea contorului, puterea semnalului Wi-Fi și două intrări fizice pentru întrerupătoare (SW1, SW2). Prin API sunt disponibile un mod de noapte cu limitarea programată a luminozității și reglarea luminozității în pași. Pentru fiecare comandă se poate seta un temporizator de oprire automată. Aceste funcții pot fi adăugate într-o actualizare viitoare a șablonului.

## Rezolvarea problemelor

### Dispozitivul nu răspunde

1. Verificați dacă Shelly este conectat la Wi-Fi și are o adresă IP validă
2. Încercați numele de gazdă mDNS (`shellydimmer2-AABBCCDDEE.local`) în locul adresei IP — adresa IP s-ar fi putut schimba după reînnoirea DHCP
3. Deschideți `http://{device-ip}/shelly` într-un browser — dacă răspunde, dispozitivul este accesibil
4. Verificați dacă unitatea de control TapHome (CCU) și Shelly se află în aceeași rețea / VLAN

### Pâlpâire sau reglare instabilă a luminozității

1. Verificați dacă sarcina conectată îndeplinește cerința de putere minimă (10 W cu neutru, 20 W fără neutru)
2. Verificați dacă tipul de sarcină este acceptat — nu toate driverele LED sunt compatibile cu dimmerele cu tăiere pe frontul descendent (trailing edge)
3. Dacă lumina pâlpâie la niveluri reduse, ajustați setarea `min_brightness` prin `/settings/light/0`
4. Pentru sarcinile care au nevoie de o perioadă de pornire treptată, măriți timpul `warm_up` (0–1000 ms) în `/settings/light/0`

### Puterea afișată este zero

1. Verificați dacă sarcina este conectată prin dimmer (nu îl ocolește)
2. Verificați dacă lumina este pornită — contorul măsoară doar atunci când trece curent
3. Interogați manual `/status` și verificați dacă `meters[0].power` returnează o valoare diferită de zero

> [!WARNING]
> Dispozitivele Shelly Gen1 acceptă doar **2 conexiuni HTTP simultane**. Dacă TapHome și un alt sistem (de ex. Home Assistant) interoghează același dispozitiv în același timp, comunicarea poate deveni instabilă. Folosiți un interval de interogare de 10–30 de secunde.

## Cum se instalează în TapHome

### Cerințe preliminare

- Dispozitiv Shelly instalat și pornit
- Rețea Wi-Fi locală (2,4 GHz)
- TapHome CCU în aceeași rețea

### Pasul 1 — Conectați dispozitivul Shelly la Wi-Fi

**Varianta A — aplicația Shelly (recomandat):**

1. Descărcați [aplicația Shelly](https://www.shelly.com/en/support/shelly-app) (iOS / Android)
2. Atingeți **+** → **Add Device** și urmați asistentul de împerechere prin Bluetooth
3. Introduceți datele de conectare la Wi-Fi când vi se solicită

**Varianta B — modul AP (fără aplicație):**

1. La prima pornire, dispozitivul creează un hotspot: `ShellyXXX-AABBCCDDEE`
2. Conectați telefonul/PC-ul la acest hotspot
3. Deschideți `http://192.168.33.1` → **Internet & Security** → **Wi-Fi Mode - Client**
4. Introduceți SSID-ul și parola → **Save**

> [!NOTE]
> Shelly acceptă doar rețele de **2,4 GHz**. Rețelele de 5 GHz nu vor apărea la scanare.

### Pasul 2 — Găsiți adresa dispozitivului

Dispozitivele Shelly Gen1 acceptă **mDNS** (Zeroconf). Puteți accesa dispozitivul folosind un nume de gazdă în locul adresei IP:

```
shelly<model>-<MAC>.local
```

De exemplu: `shelly1pm-AABBCCDDEE.local` (adresa MAC în hexazecimal cu majuscule, fără două puncte).

> [!TIP]
> **Recomandat: folosiți Scanner IP din TapHome.** Deschideți aplicația TapHome și folosiți **Scanner IP** (Setări → Rețea → Scanare). Scannerul descoperă dispozitivele din rețea și afișează atât adresa IP, cât și numele de gazdă mDNS. Pentru o conexiune mai fiabilă folosiți **numele de gazdă** în locul adresei IP — acesta rămâne același chiar dacă adresa IP a dispozitivului se schimbă după o repornire a routerului.

**Metode alternative** pentru aflarea adresei IP:

- **Aplicația Shelly:** detaliile dispozitivului → **Device info** → adresa IP
- **Interfața web Shelly:** conectați-vă la AP-ul dispozitivului înainte de configurarea Wi-Fi — adresa IP se afișează după salvare
- **Tabelul DHCP al routerului:** căutați un nume de gazdă de forma `shelly1pm-AABBCCDDEE`

### Pasul 3 — Configurați dispozitivul în TapHome

1. În TapHome adăugați un nou modul **Packet Parser (HTTP)**
2. **Address:** introduceți numele de gazdă mDNS (de ex. `shelly1pm-AABBCCDDEE.local`) sau adresa IP de la pasul 2
3. **Port:** `80` (implicit, nu este necesară nicio modificare)
4. Importați șablonul — TapHome va interoga periodic `/status` pentru a citi starea dispozitivului

> [!NOTE]
> Autentificarea HTTP este dezactivată implicit pe dispozitivele Shelly. Dacă ați activat protecția prin autentificare, rețineți că TapHome nu acceptă momentan HTTP Basic Auth — pentru integrarea cu TapHome lăsați autentificarea dezactivată.

## Dispozitive disponibile 3

Aceste dispozitive apar în TapHome după import.

Shelly Dimmer2 Modul

Atribute de service

|       |
|-------|
| Wi-Fi |

Atribute de service

Wifi

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

Luminozitate Dimmer Citire și scriere

Nivelul dimmerului 0–100 % cu tranziție graduală configurabilă (0–5000 ms)

numeric Unitate: %

Atribute de service

|           |
|-----------|
| Tranziție |

Acțiuni de service

|           |
|-----------|
| Tranziție |

Citirea nivelului

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

Scrierea nivelului

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

Atribute de service

Transition

```taphome
 VAR response := SENDHTTPREQUEST("/light/0");
 IF response.IsSuccess
  VAR content := response.Content;
  RETURN(PARSEJSON(content, "transition") + " ms");
 END
```

Acțiuni de service

Transition

Parametri: Transition time \[ms] (0–5000 G)

```taphome
 VAR response := SENDHTTPREQUEST("/light/0?transition=" + G);
```

Contor electric Contor electric Doar citire

Măsurarea consumului de putere și de energie — putere instantanee (kW) și energie cumulată (kWh)

numeric Unitate: W / kWh

Citirea consumului total

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

Citirea cererii

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

Lumină Comutator Citire și scriere

boolean

Valori / Stări: ON · OFF

Citirea stării comutatorului

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

Scrierea stării comutatorului

```taphome
var Ru := Switch(St, 1, "on", "off");
 VAR response := SENDHTTPREQUEST("/light/0?turn=" + Ru);
 IF response.IsSuccess = false
  ADDERROR(response.StatusCode);
 END
```

**Conexiune:** Packet Parser → HTTP • Nume gazdă: `shellydimmer2-{MAC}.local`

Îmbunătățiri posibile (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)

## Parametri de import

Introduceți aceste valori când importați XML-ul.

| Solicitat în aplicație | Implicit      |
|------------------------|---------------|
| Adresă IP              | `192.168.0.1` |

## Surse

- 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

## Documentație asociată

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

