TapHome

Shelly Dimmer 2

Packet Parser → HTTP
Trimis de
Ultima actualizare: 03. 2026

Acest dispozitiv acceptă mDNS

În loc să folosiți o adresă IP, puteți accesa dispozitivul la:

shellydimmer2-{MAC}.local

Înlocuiți {MAC} cu adresa MAC a dispozitivului dvs. (majuscule, fără două puncte).

TapHome acceptă mDNS — folosirea unui nume de gazdă este mai fiabilă decât un IP static.

Shelly Dimmer 2

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

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

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

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:

1

shelly<model>-<MAC>.local

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

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

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

Shelly Dimmer2 Modul
Atribute de service
Wi-Fi

Shelly Dimmer2

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

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

Luminozitate

Citirea nivelului
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
VAR response := SENDHTTPREQUEST("/light/0?brightness=" + Le*100);
IF response.IsSuccess = false
 ADDERROR(response.StatusCode);
 END
Atribute de service
Transition
 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)
 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

Contor electric

Citirea consumului total
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
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
boolean
Valori / Stări: ON · OFF

Lumină

Citirea stării comutatorului
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
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)

Surse

Ați găsit o problemă la acest șablon de dispozitiv?

Spuneți-ne ce nu funcționează, ce lipsește sau cum ar trebui să se comporte șablonul. Feedbackul dvs. ne ajută să păstrăm catalogul corect.

Verificat de TapHome

Doriți să folosiți acest șablon în TapHome Core?

Deschideți acest șablon în Customer Portal pentru a-l aplica într-una dintre locuințele dvs. sau pentru a propune o îmbunătățire și a o trimite înapoi în catalog.

Deschideți în portal