TapHome

Shelly Pro 3EM

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:

ShellyPro3EM-{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 Pro 3EM

Shelly Pro 3EM este un contor electric trifazat profesional pentru montare pe șină DIN, destinat utilizării cu transformatoare de curent externe. Este disponibil în trei variante — Pro 3EM (CT de 120 A), Pro 3EM-400 (CT de 400 A) și Pro 3EM-3CT63 (CT integrate de 63 A). Dispozitivul se conectează la rețeaua locală prin Wi-Fi sau Ethernet (RJ45) și oferă măsurători în timp real prin Gen2+ HTTP RPC API. TapHome interoghează dispozitivul prin HTTP pe portul 80 — nu este necesară conexiunea la cloud.

Șablonul oferă unsprezece dispozitive organizate pentru contorizarea bidirecțională a energiei: senzori de curent pe fiecare fază (L1, L2, L3), contoare electrice From Grid și To Grid pe fiecare fază și contoare totale From Grid și To Grid. Dispozitivele From Grid urmăresc energia consumată din rețea, iar dispozitivele To Grid urmăresc energia injectată înapoi în rețea (de ex. de la panourile solare), cu valoarea puterii inversată, astfel încât injecția să apară ca număr pozitiv.

Conectarea hardware

Shelly Pro 3EM se montează pe o șină DIN standard (94 x 19 x 69 mm). Necesită patru intrări de tensiune (trei conductoare de fază + neutru) prin borne cu șurub și patru intrări CT externe (trei faze + neutru). Dispozitivul se alimentează între oricare fază și neutru (100-260 V AC, 50/60 Hz).

Aspecte importante la conectare:

  • Intrări de tensiune: LA, LB, LC (câte una pentru fiecare fază) + N (neutru)
  • Intrări CT: trei CT de fază + un CT de neutru, conectate la mufele de intrare CT corespunzătoare
  • Ethernet: un conector RJ45 pentru conexiunea LAN (deconectați alimentarea înainte de a conecta sau deconecta cablul LAN)
  • Secțiunea conductoarelor: 0,5-2,5 mm² (20-14 AWG), lungimea de dezizolare 6-7 mm, cuplu maxim 0,4 Nm

Protecția externă trebuie să fie de maximum 16 A, cu caracteristica B sau C și capacitatea de rupere de minimum 6 kA. Domeniul tensiunii de funcționare este 100-260 V pe fază.

Configurare

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

Autentificare

TapHome nu acceptă autentificarea HTTP Digest. Asigurați-vă că autentificarea este dezactivată pe dispozitivul Shelly înainte de a-l adăuga în TapHome. Aceasta se configurează în interfața web Shelly, în Settings → Authentication.

Selectarea tipului de CT

După conectarea transformatoarelor de curent, configurați tipul de CT în interfața web Shelly sau prin apelarea EM.SetConfig cu valoarea ct_type potrivită. Folosiți EM.GetCTTypes pentru a afișa tipurile acceptate (de obicei 120A și 400A). Dacă tipul de CT nu este setat, dispozitivul raportează eroarea ct_type_not_set, iar măsurătorile nu vor fi disponibile.

Calibrarea între faze

Pro 3EM acceptă calibrarea între canale pentru a îmbunătăți precizia măsurării între faze. Calibrarea necesită o sarcină minimă de 500 W pe fiecare canal și durează aproximativ 5 secunde. Folosiți EM.PhaseToPhaseCalib pentru calibrare și EM.PhaseToPhaseCalibReset pentru revenirea la valorile 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 de 3 secunde al modulului, folosit de TapHome. Pentru o funcționare fiabilă, dezactivați modul ECO.

Funcțiile dispozitivului

Monitorizarea curentului pe fiecare fază

Trei dispozitive senzor de curent (Curent L1, Curent L2, Curent L3) raportează curentul instantaneu în amperi pentru fiecare fază, citit direct din câmpurile a_current, b_current și c_current ale EM.GetStatus. Valorile sunt preluate direct, fără conversie de unități.

Contorizarea bidirecțională a energiei pe fiecare fază

Fiecare fază are două dispozitive de contorizare a energiei — From Grid și To Grid:

  • L1/L2/L3 From Grid — puterea activă consumată din rețea (W, convertită în kW) și energia cumulată consumată (Wh, convertită în kWh). Fiecare dispozitiv From Grid oferă și patru atribute de service: Factor de putere, Curent [A], Tensiune [V] și Energie totală returnată [kWh].
  • L1/L2/L3 To Grid — puterea activă injectată în rețea (W, împărțită la -1000 pentru a afișa injecția ca valoare pozitivă în kW) și energia cumulată returnată (Wh, convertită în kWh). Dispozitivele To Grid nu au atribute de service.

Atributele de service ale dispozitivelor From Grid oferă o imagine completă pe fiecare fază: curentul și tensiunea în timp real, factorul de putere pentru evaluarea calității energiei și un contor de energie returnată pentru urmărirea injecției cumulate, alături de contorul de consum From Grid.

Contorizarea bidirecțională totală a energiei

Două dispozitive agregate însumează toate cele trei faze:

  • Total From Grid — puterea activă totală pe cele trei faze (kW) și energia totală cumulată consumată din rețea (kWh)
  • Total To Grid — puterea returnată totală pe cele trei faze (kW, cu semn inversat) și energia totală cumulată injectată în rețea (kWh)

Toate dispozitivele folosesc un interval de interogare de 3 secunde, corespunzător ciclului de citire al modulului.

Funcții suplimentare

Shelly Pro 3EM oferă nativ și puterea aparentă pe fiecare fază și totală, măsurarea curentului pe neutru (specifică modelului Pro — nu este disponibilă la 3EM Gen3), frecvența rețelei pe fiecare fază, curentul total pe toate fazele și diagnosticarea modulului (Wi-Fi SSID, adresă IP, puterea semnalului, adresă MAC). Prin RPC API sunt disponibile și acțiunile de actualizare a firmware-ului și de repornire. Nativ sunt acceptate și detectarea erorii de succesiune a fazelor și înregistrarea datelor cu rezoluție de 1 minut pentru până la 60 de zile, cu export CSV/JSON. Aceste funcții pot fi adăugate într-o actualizare viitoare a șablonului.

Rezolvarea problemelor

Dispozitivul nu răspunde
  1. Verificați dacă dispozitivul Shelly este conectat la Wi-Fi sau LAN și are o adresă IP validă
  2. Încercați numele de gazdă mDNS (ShellyPro3EM-XXXXXXXXXXXX.local) în locul adresei IP — adresa IP s-ar fi putut schimba după reînnoirea DHCP
  3. Deschideți http://{device-ip}/rpc/Shelly.GetDeviceInfo într-un browser — dacă răspunde cu JSON, dispozitivul este accesibil
  4. Verificați dacă TapHome Core și dispozitivul Shelly se află în aceeași rețea / VLAN
Eroarea ct_type_not_set

Dacă componenta EM sau EMData raportează eroarea ct_type_not_set, tipul transformatorului de curent nu a fost configurat. Setați tipul de CT în interfața web Shelly sau prin apelarea EM.SetConfig cu valoarea ct_type potrivită. Folosiți EM.GetCTTypes pentru a afișa tipurile 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ă.

Valori negative sau zero pe dispozitivele To Grid

Dispozitivele To Grid folosesc o conversie inversată (împărțire la -1000) pentru a reprezenta injecția în rețea ca număr pozitiv. Dacă nu există injecție (sistemul doar consumă), valoarea puterii To Grid va fi zero sau negativă. Acesta este comportamentul așteptat — dispozitivul From Grid urmărește consumul, iar To Grid urmărește exportul.

Dispozitivele Shelly Gen2+/Gen3 acceptă până la 6 conexiuni HTTP simultane. Fiecare sistem care interoghează dispozitivul (TapHome, Home Assistant etc.) consumă conexiuni. Evitați rularea simultană a prea multor integrări 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 Pro 3 EM Modul
Variabile personalizate

Shelly Pro 3 EM

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

response := SENDHTTPREQUEST("/rpc/EMData.GetStatus?id=0");
IF response.IsSuccess
    EMDataStatus := response.Content;
END
Curent L1 Variabilă Doar citire
numeric Unitate: A json_path

Curent L1

Citire
todouble(PARSEjson(EMStatus, "a_current"))
L1 From Grid Contor electric Doar citire

Puterea activă a fazei A (kW) și energia cumulată consumată din rețea (kWh), cu tensiune, curent, factor de putere și energie returnată

numeric Unitate: kW / kWh json_path
Atribute de service
Factor de putere
Curent
Tensiune
Energie totală returnatăEnergia cumulată returnată (injectată în rețea) a fazei A, în kWh

L1 From Grid

Citirea consumului total
todouble(PARSEjson(EMDataStatus, "a_total_act_energy"))/1000
Citirea cererii
todouble(PARSEjson(EMStatus, "a_act_power"))/1000
Atribute de service
power factor
RETURN(todouble(PARSEjson(EMStatus, "a_pf")));
Current [A]
RETURN(todouble(PARSEjson(EMStatus, "a_current")));
voltage [V]
RETURN(todouble(PARSEjson(EMStatus, "a_voltage")));
Total returned energy [kWh]
RETURN(todouble(PARSEjson(EMDataStatus, "a_total_act_ret_energy"))/1000);
L1 To Grid Contor electric Doar citire

Puterea returnată a fazei A (kW, cu semn inversat) și energia cumulată injectată în rețea (kWh)

numeric Unitate: kW / kWh json_path

L1 To Grid

Citirea consumului total
todouble(PARSEjson(EMDataStatus, "a_total_act_ret_energy"))/1000
Citirea cererii
todouble(PARSEjson(EMStatus, "a_act_power"))/-1000
Curent L2 Variabilă Doar citire
numeric Unitate: A json_path

Curent L2

Citire
todouble(PARSEjson(EMStatus, "b_current"))
L2 From Grid Contor electric Doar citire

Puterea activă a fazei B (kW) și energia cumulată consumată din rețea (kWh), cu tensiune, curent, factor de putere și energie returnată

numeric Unitate: kW / kWh json_path
Atribute de service
Factor de putere
Curent
Tensiune
Energie totală returnatăEnergia cumulată returnată (injectată în rețea) a fazei B, în kWh

L2 From Grid

Citirea consumului total
todouble(PARSEjson(EMDataStatus, "b_total_act_energy"))/1000
Citirea cererii
todouble(PARSEjson(EMStatus, "b_act_power"))/1000
Atribute de service
power factor
RETURN(todouble(PARSEjson(EMStatus, "b_pf")));
current [A[
RETURN(todouble(PARSEjson(EMStatus, "b_current")));
voltage [V]
RETURN(todouble(PARSEjson(EMStatus, "b_voltage")));
total returned energy [kWh]
RETURN(todouble(PARSEjson(EMDataStatus, "b_total_act_ret_energy"))/1000);
L2 To Grid Contor electric Doar citire

Puterea returnată a fazei B (kW, inversată) și energia cumulată injectată în rețea (kWh)

numeric Unitate: kW / kWh json_path

L2 To Grid

Citirea consumului total
todouble(PARSEjson(EMDataStatus, "b_total_act_ret_energy"))/1000
Citirea cererii
todouble(PARSEjson(EMStatus, "b_act_power"))/-1000
Curent L3 Variabilă Doar citire
numeric Unitate: A json_path

Curent L3

Citire
todouble(PARSEjson(EMStatus, "c_current"))
L3 From Grid Contor electric Doar citire

Puterea activă a fazei C (kW) și energia cumulată consumată din rețea (kWh), cu tensiune, curent, factor de putere și energie returnată

numeric Unitate: kW / kWh json_path
Atribute de service
Factor de putere
Curent
Tensiune
Energie totală returnatăEnergia cumulată returnată (injectată în rețea) a fazei C, în kWh

L3 From Grid

Citirea consumului total
todouble(PARSEjson(EMDataStatus, "c_total_act_energy"))/1000
Citirea cererii
todouble(PARSEjson(EMStatus, "c_act_power"))/1000
Atribute de service
power factor
RETURN(todouble(PARSEjson(EMStatus, "c_pf")));
current [A]
RETURN(todouble(PARSEjson(EMStatus, "c_current")));
voltage [V]
RETURN(todouble(PARSEjson(EMStatus, "c_voltage")));
Total returned energy [kWh]
RETURN(todouble(PARSEjson(EMDataStatus, "c_total_act_ret_energy"))/1000);
L3 To Grid Contor electric Doar citire

Puterea returnată a fazei C (kW, inversată) și energia cumulată injectată în rețea (kWh)

numeric Unitate: kW / kWh json_path

L3 To Grid

Citirea consumului total
todouble(PARSEjson(EMDataStatus, "c_total_act_ret_energy"))/1000
Citirea cererii
todouble(PARSEjson(EMStatus, "c_act_power"))/-1000
Total From Grid Contor electric Doar citire

Puterea activă totală pe cele trei faze (kW) și energia totală cumulată consumată din rețea (kWh)

numeric Unitate: kW / kWh json_path

Total From Grid

Citirea consumului total
todouble(PARSEjson(EMDataStatus, "total_act"))/1000
Citirea cererii
todouble(PARSEjson(EMStatus, "total_act_power"))/1000
Total To Grid Contor electric Doar citire

Puterea returnată totală pe cele trei faze (kW, cu semn inversat) și energia totală cumulată injectată în rețea (kWh)

numeric Unitate: kW / kWh json_path

Total To Grid

Citirea consumului total
todouble(PARSEjson(EMDataStatus, "total_act_ret"))/1000
Citirea cererii
todouble(PARSEjson(EMStatus, "total_act_power"))/-1000
Conexiune: Packet Parser → HTTP • Nume gazdă: ShellyPro3EM-{MAC}.local
Îmbunătățiri posibile (14)
  • 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] — Pro 3EM supports this (unlike 3EM Gen3)
  • Grid Frequency — Network frequency in Hz, available per phase — not exposed as device or SA
  • Total Current — Sum of current on all three phases [A]
  • MAC Address — No module-level service attributes in this template (unlike 3EM Gen3)
  • WiFi SSID — No module-level service attributes in this template (unlike 3EM Gen3)
  • Signal Strength — WiFi RSSI in dBm — not polled by module readscript
  • Firmware Update — No module-level service actions in this template (unlike 3EM Gen3)
  • Reboot — No module-level service actions in this template (unlike 3EM Gen3)
  • Uptime — Seconds since last reboot
  • Free RAM — Available RAM in bytes
  • Total Returned Energy (dedicated) — Already implemented as Total To Grid device (readtotalconsumption), listed for completeness
  • 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