TapHome

Shelly Pro 4PM

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:

ShellyPro4PM-{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 4PM

Shelly Pro 4PM este un releu inteligent cu 4 canale pentru montare pe șină DIN, cu măsurarea integrată a puterii pe fiecare canal. Fiecare dintre cele patru ieșiri independente poate comuta până la 16 A (în total 40 A), astfel încât este potrivit pentru comanda circuitelor de iluminat, a aparatelor sau a sarcinilor din tabloul electric, cu monitorizarea individuală a energiei pe fiecare canal. TapHome comunică cu dispozitivul prin HTTP în rețeaua locală — nu este necesară conexiunea la cloud.

Șablonul folosește o abordare mixtă a API-ului: endpointurile RPC Gen2+ (/rpc/Switch.GetStatus?id=N) pentru citirea măsurătorilor de energie și endpointurile Gen1 (/relay/N?turn=on|off) pentru comanda releelor. Pro 4PM acceptă ambele generații de API pentru compatibilitate cu versiunile anterioare. Dispozitivul se conectează prin Wi-Fi sau Ethernet (RJ45) și are un afișaj LCD color de 1,8 inchi pentru monitorizarea locală a stării.

Configurare

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

Pentru integrarea cu TapHome, autentificarea pe dispozitivul Shelly trebuie să fie dezactivată. TapHome nu acceptă HTTP Digest Auth, folosită de dispozitivele Gen2. Deschideți interfața web Shelly (http://{device-ip}) → Settings → Authentication și asigurați-vă că este dezactivată.

Cablul LAN trebuie conectat sau deconectat doar când dispozitivul este oprit. Conectarea sau deconectarea cablului Ethernet sub tensiune poate cauza probleme.

Dacă pe dispozitivul Shelly este activat modul ECO, pot apărea erori de timeout ale comunicării din cauza intervalelor scurte de interogare folosite de șablon (2,5–15 secunde). Dacă întâmpinați probleme intermitente de conectivitate, dezactivați modul ECO în interfața web Shelly.

Funcțiile dispozitivului

Contorizarea energiei

Șablonul oferă patru dispozitive independente de tip contor electric, câte unul pe canal. Fiecare contor citește din /rpc/Switch.GetStatus?id=N (unde N este 0–3):

  • Putere în timp real — apower, raportată în wați și convertită de șablon în kW
  • Consum total — aenergy.total, raportat în wați-oră și convertit de șablon în kWh

Canalul 1 este interogat la fiecare 2,5 secunde, pentru un răspuns mai rapid. Canalele 2–4 sunt interogate la fiecare 15 secunde.

Contoarele sunt doar pentru citire — se actualizează automat la fiecare ciclu de interogare.

Comanda releelor

Șablonul oferă patru dispozitive de tip întrerupător cu releu, câte unul pe canal. Fiecare releu se comandă prin endpointul Gen1 /relay/N?turn=on|off (unde N este 0–3).

Întrerupătoarele cu releu sunt doar pentru scriere — șablonul nu recitește starea releului din dispozitiv. Starea curentă a releului se poate deduce din contorul electric corespunzător: dacă pe canal se raportează un consum de putere diferit de zero, releul este pornit. O actualizare viitoare a șablonului ar putea adăuga citirea stării releului prin câmpul output din endpointul Gen2+ /rpc/Switch.GetStatus?id=N.

Senzor de putere

Un dispozitiv separat de tip senzor de putere oferă puterea activă brută în wați pentru canalul 1 (citită din /rpc/Switch.GetStatus?id=0 → apower). Spre deosebire de contorul electric, care convertește în kW, acest senzor raportează valoarea în wați fără conversie, ceea ce este util pentru automatizările care necesită precizie la nivel de watt.

Diagnosticare de service

Șablonul oferă 13 atribute de service pentru monitorizarea dispozitivului:

  • Informații despre dispozitiv — numele de gazdă, adresa MAC, ora dispozitivului, timpul de funcționare, utilizarea RAM
  • Protecție termică — temperatura internă (°C), starea temperaturii (Normal / High / Very High), indicatorul de supratemperatură
  • Conectivitate — cloud activat/conectat, MQTT conectat, actualizare de firmware disponibilă
  • Protecție la depășirea puterii — limita curentă de putere maximă (citită din /settings)
Acțiuni de service

Sunt disponibile trei acțiuni de service:

  • Setare protecție la depășirea puterii — setează limita de putere maximă (1–3500 W). Releul se oprește automat dacă consumul depășește această valoare.
  • Activare cloud — activează sau dezactivează conectivitatea Shelly Cloud
  • Repornire — declanșează repornirea dispozitivului
Funcții suplimentare

În răspunsul /rpc/Switch.GetStatus, Shelly Pro 4PM furnizează și tensiunea, curentul, factorul de putere, frecvența și temperatura internă pentru fiecare canal. Prin API-ul RPC sunt disponibile și starea intrărilor fizice pentru întrerupătoare/butoane (S1–S4), starea conexiunii Ethernet, puterea semnalului Wi-Fi (RSSI) și comanda nativă Gen2+ a releelor cu 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 sau Ethernet și are o adresă IP validă
  2. Încercați să folosiți numele de gazdă mDNS (shellypro4pm-AABBCCDDEE.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
  5. Verificați dacă autentificarea este dezactivată pe dispozitivul Shelly
Puterea afișată este zero
  1. Verificați dacă sarcina este conectată prin ieșirea de releu Shelly (O1–O4) și nu o ocolește
  2. Verificați dacă releul este pornit — contorul măsoară doar atunci când curentul trece prin releu
  3. Interogați manual /rpc/Switch.GetStatus?id=0 și verificați dacă apower returnează o valoare diferită de zero
  4. Verificați ID-ul corect al canalului (id=0 pentru ieșirea 1, id=1 pentru ieșirea 2 etc.)
Starea releului este necunoscută

Întrerupătoarele cu releu din acest șablon sunt doar pentru scriere — trimit comenzi de pornire/oprire, dar nu citesc înapoi starea releului. Pentru a verifica starea reală a releului:

  1. Verificați contorul electric corespunzător — o putere diferită de zero înseamnă că releul este pornit
  2. Urmăriți indicatoarele LED ale releelor de pe panoul frontal al dispozitivului
  3. Testați manual în browser: http://{device-ip}/relay/0 returnează starea curentă a releului în format JSON
Avertizare de supratemperatură

Shelly Pro 4PM are protecție termică internă. Dacă temperatura dispozitivului depășește limitele de siguranță, temperature_status se schimbă în „High” sau „Very High”, iar overtemperature devine true. Asigurați o ventilație adecvată în tabloul electric, mai ales la comutarea simultană a sarcinilor mari pe mai multe canale.

Hardware V1 și V2

Ambele versiuni folosesc același firmware și același API. V2 (SPSW-104PE16EU) are conectori îmbunătățiți — cinci borne individuale cu șurub în locul a patru blocuri cu 2 borne — și o izolare electrică LAN mai bună. Între versiuni nu sunt necesare modificări ale șablonului.

Dispozitivele Shelly Gen2 acceptă până la 6 conexiuni HTTP simultane. Șablonul Shelly Pro 4PM folosește până la 5 endpointuri simultane per ciclu de interogare (4 contoare electrice + starea modulului), ceea ce lasă o rezervă limitată. Evitați interogarea simultană din prea multe sisteme.

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 4PM Modul
Acțiuni de service
Setare protecție la depășirea puteriiSetează limita de putere maximă (1–3500 W) — releul se oprește automat dacă consumul depășește această valoare
Activare cloudActivează sau dezactivează conectivitatea Shelly Cloud
RepornireDeclanșează repornirea dispozitivului
Variabile personalizate
StatusJson (string)
SettingsJson (string)
status (string) = 0

Shelly 4 Pro

Citire (modul)
VAR response := SENDHTTPREQUEST("/status", "GET");
StatusJson := response.Content;
Acțiuni de service
Set power protection
Parametri: Maximum power (1–3500 Watts)
VAR response := SENDHTTPREQUEST("settings?max_power=" + Watts);
VAR contentJson := response.Content;
VAR limitSet := PARSEJSON(contentJson, "max_power");

"Power limit set to " + limitSet + "W"
Enable cloud
Parametri: Enable (Enable / Disable)
VAR response := SENDHTTPREQUEST("/settings/cloud?enabled=" + enable);
VAR contentJson := response.Content;
VAR wasEnabled := PARSEJSON(contentJson, "enabled");

IF(wasEnabled, "Cloud enabled", "Cloud disabled");
Reboot
VAR response := SENDHTTPREQUEST("/reboot");
VAR contentJson := response.Content;
VAR wasRebooted := PARSEJSON(contentJson, "ok");

IF(wasRebooted, "Reboot successful", "Error");
Contor electric canal 1 Contor electric Doar citire

Măsurarea puterii și a consumului de energie pentru ieșirea 1 — putere instantanee (kW) și energie cumulată (kWh)

numeric Unitate: W / kWh

Contor electric canal 1

Citirea consumului total
return(parsejson(parsejson(status,"aenergy"), "total")/1000);
Citirea cererii
return(parsejson(status,"apower")/1000);
Citire (modul)
var x := (sendhttprequest("/rpc/Switch.GetStatus?id=0"));
status := x.Content;
Contor electric canal 2 Contor electric Doar citire

Măsurarea puterii și a consumului de energie pentru ieșirea 2 — putere instantanee (kW) și energie cumulată (kWh)

numeric Unitate: W / kWh

Contor electric canal 2

Citirea consumului total
return(parsejson(parsejson(status,"aenergy"), "total")/1000);
Citirea cererii
return(parsejson(status,"apower")/1000);
Citire (modul)
var x := (sendhttprequest("/rpc/Switch.GetStatus?id=1"));
status := x.Content;
Contor electric canal 3 Contor electric Doar citire

Măsurarea puterii și a consumului de energie pentru ieșirea 3 — putere instantanee (kW) și energie cumulată (kWh)

numeric Unitate: W / kWh

Contor electric canal 3

Citirea consumului total
return(parsejson(parsejson(status,"aenergy"), "total")/1000);
Citirea cererii
return(parsejson(status,"apower")/1000);
Citire (modul)
var x := (sendhttprequest("/rpc/Switch.GetStatus?id=2"));
status := x.Content;
Contor electric canal 4 Contor electric Doar citire

Măsurarea puterii și a consumului de energie pentru ieșirea 4 — putere instantanee (kW) și energie cumulată (kWh)

numeric Unitate: W / kWh

Contor electric canal 4

Citirea consumului total
return(parsejson(parsejson(status,"aenergy"), "total")/1000);
Citirea cererii
return(parsejson(status,"apower")/1000);
Citire (modul)
var x := (sendhttprequest("/rpc/Switch.GetStatus?id=3"));
status := x.Content;
Releu canal 2 Comutator

Comanda releului ieșirii 2 doar pentru scriere — starea nu se recitește, deduceți-o din contorul electric

boolean
Valori / Stări: ON · OFF

Releu canal 2

Scrierea stării comutatorului
VAR path := "relay/1?turn=" + SWITCH(St, 0, "off", 1, "on","off");
SENDHTTPREQUEST(path);
Releu canal 1 Comutator

Comanda releului ieșirii 1 doar pentru scriere — starea nu se recitește, deduceți-o din contorul electric

boolean
Valori / Stări: ON · OFF

Releu canal 1

Scrierea stării comutatorului
VAR path := "relay/0?turn=" + SWITCH(St, 0, "off", 1, "on","off");
SENDHTTPREQUEST(path);
Senzor de putere canal 1 Variabilă Doar citire

Puterea activă brută în wați pentru canalul 1 — valoarea unui senzor separat, fără conversie în kW

numeric Unitate: W

Senzor de putere canal 1

Citire
return(parsejson(status,"apower"));
Citire (modul)
var x := (sendhttprequest("/rpc/Switch.GetStatus?id=0"));
status := x.Content;
Releu canal 3 Comutator

Comanda releului ieșirii 3 doar pentru scriere — starea nu se recitește, deduceți-o din contorul electric

boolean
Valori / Stări: ON · OFF

Releu canal 3

Scrierea stării comutatorului
VAR path := "relay/2?turn=" + SWITCH(St, 0, "off", 1, "on","off");
SENDHTTPREQUEST(path);
Releu canal 4 Comutator

Comanda releului ieșirii 4 doar pentru scriere — starea nu se recitește, deduceți-o din contorul electric

boolean
Valori / Stări: ON · OFF

Releu canal 4

Scrierea stării comutatorului
VAR path := "relay/3?turn=" + SWITCH(St, 0, "off", 1, "on","off");
SENDHTTPREQUEST(path);
Conexiune: Packet Parser → HTTP • Nume gazdă: ShellyPro4PM-{MAC}.local
Îmbunătățiri posibile (10)
  • Relay State Read — Switches have no readswitchstate script — relay state is not read back. Gen2+ /rpc/Switch.GetStatus?id=N provides output (boolean) for state feedback.
  • Voltage — Per-channel line voltage in V, available in /rpc/Switch.GetStatus response
  • Current — Per-channel load current in A, available in /rpc/Switch.GetStatus response
  • Power Factor — Per-channel power factor, available in /rpc/Switch.GetStatus response
  • Frequency — Network frequency in Hz, available in /rpc/Switch.GetStatus response
  • Per-Channel Temperature — Internal temperature in °C per switch component, available in /rpc/Switch.GetStatus response
  • Input States (S1-S4) — 4 physical switch/button inputs, available via /rpc/Input.GetStatus?id=0..3
  • Gen2+ Relay Control — Native Gen2+ relay control with toggle_after timer support. Template uses Gen1 /relay/N instead.
  • WiFi Status (SSID, IP, RSSI) — WiFi status including signal strength, available via Gen2+ RPC
  • Ethernet Status — Pro 4PM has RJ45 LAN port; Ethernet status (IP, link) available via /rpc/Ethernet.GetStatus

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