TapHome

Shelly 3EM Gen3

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

Acest dispozitiv acceptă mDNS

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

Shelly3EM63G3-{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 3EM Gen3

Shelly 3EM Gen3 este un contor electric trifazat pe șină DIN, cu transformatoare de curent integrate (până la 63 A pe fază). Se conectează la rețeaua locală prin Wi-Fi și furnizează măsurători în timp real prin API-ul HTTP RPC Gen2+/Gen3. TapHome interoghează dispozitivul prin HTTP pe portul 80 — nu este necesară conexiunea la cloud.

Șablonul oferă patru dispozitive de tip contor electric: un contor total combinat și trei contoare pentru fazele individuale (A, B, C). Fiecare contor raportează puterea activă instantanee și consumul cumulat de energie, iar contoarele de fază oferă în plus, ca atribute de service, tensiunea, curentul, factorul de putere și frecvența rețelei.

Conectarea hardware

Shelly 3EM Gen3 este disponibil în două variante — 3EM-63W (model cu conductoare) și 3EM-63T (model cu borne plate). Ambele se montează deasupra sau dedesubtul întrerupătoarelor automate de pe șina DIN.

Dispozitivul necesită o conexiune în Y (stea) cu 4 conductoare:

  • LA, LB, LC — trei intrări de fază, câte una pentru fiecare fază
  • N — intrare pentru neutru
  • Alimentarea se face între faza LA și neutru (220-240 V~ 50/60 Hz)

Protecția externă trebuie să fie de 63 A, cu caracteristica B sau C și capacitatea de rupere de 6 kA.

Tensiunea maximă de funcționare sigură este de 280 V pe fază. Domeniul de curent este 0-63 A, cu saturație la 130 A. Depășirea acestor limite poate deteriora dispozitivul.

Configurare

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

Autentificare

TapHome nu acceptă HTTP Digest Authentication. Înainte de a adăuga dispozitivul în TapHome, asigurați-vă că autentificarea pe dispozitivul Shelly este dezactivată. Setarea se găsește în interfața web Shelly la Settings → Authentication.

Selectarea profilului

Shelly 3EM Gen3 are două profiluri — Triphase (implicit) și Monophase. Șablonul TapHome este conceput pentru profilul Triphase, care oferă o singură componentă EM (em:0) cu valori pe fiecare fază și valori totale. Asigurați-vă că dispozitivul este setat pe profilul Triphase (setarea din fabrică).

Modul ECO

Dacă pe dispozitivul Shelly este activat modul ECO, pot apărea erori de timeout ale comunicării din cauza intervalului de interogare a modulului de 3 secunde folosit de TapHome. Pentru o funcționare fiabilă, dezactivați modul ECO.

Funcțiile dispozitivului

Contorizarea energiei totale

Dispozitivul Contor electric total oferă o imagine de ansamblu asupra tuturor celor trei faze:

  • Putere activă — total_act_power din EM.GetStatus, convertită din W în kW (împărțită la 1000)
  • Energie cumulată — total_act din EMData.GetStatus, convertită din Wh în kWh (împărțită la 1000)
  • Curent electric (atribut de service) — suma curenților de pe toate cele trei faze
Contorizarea energiei pe fiecare fază

Trei contoare pentru fazele individuale (faza A, faza B, faza C) oferă măsurători detaliate pe fiecare fază. Fiecare contor de fază raportează:

  • Putere activă — puterea instantanee în kW (convertită din W)
  • Energie cumulată — consumul total de energie în kWh (convertit din Wh)

Fiecare contor de fază oferă și patru atribute de service:

  • Curent electric — curentul fazei în A
  • Tensiune electrică — tensiunea fazei în V
  • Factor de putere — raportul adimensional dintre puterea activă și cea aparentă
  • Frecvența rețelei — frecvența rețelei în Hz

Contoarele de fază folosesc un interval de interogare de 15 secunde (față de intervalul de 3 secunde al modulului), suficient pentru monitorizarea energiei.

Diagnosticarea modulului

Șablonul oferă patru atribute de service la nivelul modulului:

  • Wifi — SSID-ul rețelei Wi-Fi la care este conectat dispozitivul
  • Adresă IP — adresa IP a dispozitivului în rețeaua locală
  • Puterea semnalului — Wi-Fi RSSI în dBm
  • MAC — adresa MAC a dispozitivului

Sunt disponibile două acțiuni de service:

  • Actualizare FW — pornește actualizarea firmware-ului la ultima versiune stabilă
  • Repornire — declanșează repornirea dispozitivului

Scriptul de citire al modulului verifică și actualizările de firmware disponibile și necesitatea unei reporniri și afișează avertizări în TapHome atunci când detectează oricare dintre aceste situații.

Funcții suplimentare

Shelly 3EM Gen3 furnizează și puterea aparentă pe fiecare fază și totală, curentul prin neutru și contoarele energiei returnate (injectate în rețea) pe fiecare fază și totale. Dispozitivul oferă nativ și detectarea erorii de succesiune a fazelor și stocarea datelor istorice cu rezoluție de 1 minut. 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 să folosiți numele de gazdă mDNS (Shelly3EM63G3-XXXXXXXXXXXX.local) în locul adresei IP — adresa IP se poate schimba după reînnoirea DHCP
  3. Deschideți http://{device-ip}/rpc/Shelly.GetDeviceInfo în browser — dacă răspunde cu JSON, dispozitivul este accesibil
  4. Verificați dacă TapHome Core și Shelly sunt în aceeași rețea / VLAN
Eroarea ct_type_not_set

Dacă componenta EM raportează eroarea ct_type_not_set, tipul transformatorului de curent nu a fost configurat. Setați tipul CT în interfața web Shelly sau apelând EM.SetConfig cu valoarea ct_type corespunzătoare. Folosiți EM.GetCTTypes pentru a afișa lista tipurilor acceptate.

Eroare de succesiune a fazelor

Dacă în EM.GetStatus apare eroarea phase_sequence, fazele sunt conectate în ordine inversă (A-C-B în loc de A-B-C). Fie reconectați fazele în succesiunea corectă, fie dezactivați monitor_phase_sequence în configurația EM pentru a suprima eroarea, dacă ordinea inversă este intenționată.

Dispozitivele Shelly Gen2+/Gen3 acceptă până la 6 conexiuni HTTP simultane. Este mai mult decât la dispozitivele Gen1 (2 conexiuni), dar rețineți că fiecare sistem care interoghează dispozitivul (TapHome, Home Assistant etc.) ocupă conexiuni. Evitați să rulați prea multe integrări simultan pe același dispozitiv.

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 3EM Gen3 Modul
Atribute de service
Wifi
Adresă IP
Puterea semnalului
MAC
Acțiuni de service
Actualizare FWPornește actualizarea firmware-ului la ultima versiune stabilă
Repornire
Variabile personalizate

Shelly 3EM Gen3

Citire (modul)
VAR response := SENDHTTPREQUEST("/rpc/Sys.GetStatus");
IF response.IsSuccess
    Sys.GetStatus := response.Content;
END

response := SENDHTTPREQUEST("/rpc/Sys.GetConfig");
IF response.IsSuccess
    Sys.GetConfig := response.Content;
END

response := SENDHTTPREQUEST("/rpc/WiFi.GetStatus");
IF response.IsSuccess
    WiFi.GetStatus := response.Content;
END

response := SENDHTTPREQUEST("/rpc/EM.GetStatus?id=0");
IF response.IsSuccess
    EM.GetStatus := response.Content;
END

response := SENDHTTPREQUEST("/rpc/EMData.GetStatus?id=0");
IF response.IsSuccess
    EMData.GetStatus := response.Content;
END

if ! ISNULL(parsejson(Sys.GetStatus, "available_updates.stable", true))
    addwarning("New firmware update is available");
end

if parsejson(Sys.GetStatus, "restart_required", true)
    addwarning("Restart required");
end
Atribute de service
Wifi
PARSEJSON(WiFi.GetStatus, "ssid")
${ipAddress}
PARSEJSON(WiFi.GetStatus, "sta_ip")
${xml_signal_strength} [dB]
PARSEJSON(WiFi.GetStatus, "rssi")
MAC
PARSEJSON(Sys.GetStatus, "mac")
Acțiuni de service
${xml_update_fw}
VAR response := SENDHTTPREQUEST("/rpc/Shelly.Update?stage=\"stable\"");
IF response.IsSuccess
    return("OK");
else
    return("Error");
END
Reboot
VAR response := SENDHTTPREQUEST("/rpc/Shelly.Reboot");
IF response.IsSuccess
    return("OK");
else
    return("Error");
END
Contor electric total Contor electric Doar citire

Puterea activă totală pe cele 3 faze (kW) și consumul total cumulat de energie (kWh)

numeric Unitate: kW / kWh json_path
Atribute de service
Curent electricSuma curenților de pe toate cele trei faze
Variabilă: EM.GetStatus

Contor electric total

Citirea consumului total
return(parsejson(EMData.GetStatus,"total_act")/1000);
Citirea cererii
return(parsejson(EM.GetStatus,"total_act_power")/1000);
Atribute de service
${electric_current} [A]
return(parsejson(EM.GetStatus,"total_current"));
Contor electric faza A Contor electric Doar citire

Puterea activă (kW), energia cumulată (kWh), tensiunea, curentul, factorul de putere și frecvența pe faza A

numeric Unitate: kW / kWh json_path
Atribute de service
Curent electric
Tensiune electrică
Factor de putere
Frecvența rețelei

Contor electric faza A

Citirea consumului total
return(parsejson(EMData.GetStatus,"a_total_act_energy")/1000);
Citirea cererii
return(parsejson(EM.GetStatus,"a_act_power")/1000);
Atribute de service
${electric_current} [A]
return(parsejson(EM.GetStatus,"a_current"));
${electric_voltage} [V]
return(parsejson(EM.GetStatus,"a_voltage"));
${power_factor}
return(parsejson(EM.GetStatus,"a_pf"));
${grid_frequency} [Hz]
return(parsejson(EM.GetStatus,"a_freq"));
Contor electric faza B Contor electric Doar citire

Puterea activă (kW), energia cumulată (kWh), tensiunea, curentul, factorul de putere și frecvența pe faza B

numeric Unitate: kW / kWh json_path
Atribute de service
Curent electric
Tensiune electrică
Factor de putere
Frecvența rețelei

Contor electric faza B

Citirea consumului total
return(parsejson(EMData.GetStatus,"b_total_act_energy")/1000);
Citirea cererii
return(parsejson(EM.GetStatus,"b_act_power")/1000);
Atribute de service
${electric_current} [A]
return(parsejson(EM.GetStatus,"b_current"));
${electric_voltage} [V]
return(parsejson(EM.GetStatus,"b_voltage"));
${power_factor}
return(parsejson(EM.GetStatus,"b_pf"));
${grid_frequency} [Hz]
return(parsejson(EM.GetStatus,"b_freq"));
Contor electric faza C Contor electric Doar citire

Puterea activă (kW), energia cumulată (kWh), tensiunea, curentul, factorul de putere și frecvența pe faza C

numeric Unitate: kW / kWh json_path
Atribute de service
Curent electric
Tensiune electrică
Factor de putere
Frecvența rețelei

Contor electric faza C

Citirea consumului total
return(parsejson(EMData.GetStatus,"c_total_act_energy")/1000);
Citirea cererii
return(parsejson(EM.GetStatus,"c_act_power")/1000);
Atribute de service
${electric_current} [A]
return(parsejson(EM.GetStatus,"c_current"));
${electric_voltage} [V]
return(parsejson(EM.GetStatus,"c_voltage"));
${power_factor}
return(parsejson(EM.GetStatus,"c_pf"));
${grid_frequency} [Hz]
return(parsejson(EM.GetStatus,"c_freq"));
Conexiune: Packet Parser → HTTP • Nume gazdă: Shelly3EM63G3-{MAC}.local
Îmbunătățiri posibile (8)
  • Phase A Apparent Power — Apparent power in VA, available per phase — could complement active power
  • Total Apparent Power — Sum of apparent power on all phases [VA]
  • Neutral Current — Current on neutral conductor [A]
  • Total Returned Energy — Total active returned energy [Wh] — relevant for solar/grid feed-in
  • Phase A Returned Energy — Per-phase returned energy [Wh] — same available for B and C
  • Uptime — Seconds since last reboot, available in Sys.GetStatus
  • Free RAM — Available RAM in bytes
  • Phase Sequence Monitoring — Enable/disable phase sequence error detection via EM.SetConfig

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