TapHome

Shelly Pro 3

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:

ShellyPro3-{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 3

Shelly Pro 3 este un modul cu relee cu 3 canale pentru montare pe șină DIN, cu contacte fără potențial. Fiecare dintre cele trei ieșiri independente poate comuta până la 16 A (în total 48 A pe toate canalele), astfel încât este potrivit pentru comanda circuitelor de iluminat, a elementelor de încălzire sau a sarcinilor trifazate la care fiecare fază se comută separat. TapHome comunică cu dispozitivul prin HTTP, folosind API-ul JSON-RPC 2.0 Gen2 în rețeaua locală — nu este necesară conexiunea la cloud.

Spre deosebire de Shelly Pro 3EM, care este un contor electric (doar monitorizare), Pro 3 este un dispozitiv destinat exclusiv comutării cu relee, fără măsurarea puterii. Dispozitivul se conectează prin Wi-Fi, Ethernet (RJ45) sau Bluetooth și este destinat instalării profesionale în tablouri electrice.

Configurare

Shelly Pro 3 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 se poate conecta sau deconecta numai când dispozitivul este scos de sub tensiune. 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–3 secunde). Dacă întâmpinați probleme intermitente de conectivitate, dezactivați modul ECO în interfața web Shelly.

Funcțiile dispozitivului

Comanda releelor

Șablonul oferă trei dispozitive de tip întrerupător independente, câte unul pentru fiecare canal de releu. Starea fiecărui releu se citește din răspunsul /rpc/Switch.GetStatus?id=N (câmpul output, boolean), iar releul se comandă prin /rpc/Switch.Set?id=N&on=true sau on=false, unde N este 0, 1 sau 2.

Toate cele trei canale funcționează independent — pot fi pe circuite diferite, pe faze AC diferite sau chiar cu sarcini mixte AC/DC. Contactele releelor sunt fără potențial (contacte uscate), astfel încât fiecare ieșire poate comuta un circuit complet separat de sursa care alimentează dispozitivul.

Diagnosticarea de service

Șablonul oferă la nivelul modulului atribute de service pentru monitorizarea dispozitivului:

  • Wi-Fi — numele SSID al rețelei conectate
  • Adresă IP — adresa IP curentă a dispozitivului în rețea
  • Puterea semnalului — RSSI Wi-Fi în dB
  • MAC — adresa MAC a dispozitivului

Scriptul de citire al modulului verifică și dacă sunt disponibile actualizări de firmware și dacă este necesară o repornire, afișându-le ca avertizări în interfața TapHome.

Acțiuni de service

La nivelul modulului sunt disponibile două acțiuni de service:

  • Actualizare firmware — pornește actualizarea firmware-ului la cea mai recentă versiune stabilă prin /rpc/Shelly.Update
  • Repornire — repornește dispozitivul prin /rpc/Shelly.Reboot
Funcții suplimentare

Prin RPC API, Shelly Pro 3 oferă și stările intrărilor fizice pentru întrerupătoare/butoane (S1, S2, S3) prin componenta Input, temperatura internă a dispozitivului, timpul de funcționare, utilizarea memoriei RAM, ora dispozitivului și starea conexiunii Ethernet. Prin parametrul toggle_after al comenzii Switch.Set este disponibil 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ă dispozitivul Shelly este conectat la Wi-Fi sau Ethernet și are o adresă IP validă
  2. Încercați numele de gazdă mDNS (ShellyPro3-AABBCCDDEE.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
  5. Verificați dacă autentificarea este dezactivată pe dispozitivul Shelly
Răspund doar unele canale
  1. Verificați dacă fiecare canal este adresat corect (id=0 pentru ieșirea 1, id=1 pentru ieșirea 2, id=2 pentru ieșirea 3)
  2. Verificați LED-urile indicatoare ale releelor de pe panoul frontal al dispozitivului — LED-ul roșu înseamnă că releul corespunzător este închis (ON)
  3. Testați manual în browser canalul care nu răspunde: http://{device-ip}/rpc/Switch.Set?id=N&on=true
Probleme cu sarcinile inductive

Pentru sarcinile inductive (ventilatoare, transformatoare, drivere LED) se recomandă un circuit RC snubber (0,1 uF / 100 Ohm / 1/2 W / 600 V AC) pe ieșirea releului, pentru protecția împotriva vârfurilor de tensiune și prelungirea duratei de viață a releului.

Dispozitivele Shelly Gen2 acceptă până la 6 conexiuni HTTP simultane. Evitați interogarea din prea multe sisteme în același timp (TapHome, Home Assistant, scripturi personalizate), pentru a nu epuiza conexiunile disponibile.

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 Modul
Atribute de service
Wi-Fi
Adresă IP
Puterea semnalului
MAC
Acțiuni de service
Actualizare firmware
Repornire
Variabile personalizate

Shelly Pro 3

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

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
Întrerupător 1 Comutator
boolean
Valori / Stări: ON · OFF

Întrerupător 1

Citirea stării comutatorului
VAR response := SENDHTTPREQUEST("/rpc/Switch.GetStatus?id=" + id);
IF response.IsSuccess
    Switch.GetStatus := response.Content;
END
return(parsejson(Switch.GetStatus, "output"));
Scrierea stării comutatorului
VAR path := "/rpc/Switch.Set?id=" + id + "&on=" + SWITCH(St, 1, "true", "false");
SENDHTTPREQUEST(path);
Întrerupător 2 Comutator
boolean
Valori / Stări: ON · OFF

Întrerupător 2

Citirea stării comutatorului
VAR response := SENDHTTPREQUEST("/rpc/Switch.GetStatus?id=" + id);
IF response.IsSuccess
    Switch.GetStatus := response.Content;
END
return(parsejson(Switch.GetStatus, "output"));
Scrierea stării comutatorului
VAR path := "/rpc/Switch.Set?id=" + id + "&on=" + SWITCH(St, 1, "true", "false");
SENDHTTPREQUEST(path);
Întrerupător 3 Comutator
boolean
Valori / Stări: ON · OFF

Întrerupător 3

Citirea stării comutatorului
VAR response := SENDHTTPREQUEST("/rpc/Switch.GetStatus?id=" + id);
IF response.IsSuccess
    Switch.GetStatus := response.Content;
END
return(parsejson(Switch.GetStatus, "output"));
Scrierea stării comutatorului
VAR path := "/rpc/Switch.Set?id=" + id + "&on=" + SWITCH(St, 1, "true", "false");
SENDHTTPREQUEST(path);
Conexiune: Packet Parser → HTTP • Nume gazdă: ShellyPro3-{MAC}.local
Îmbunătățiri posibile (9)
  • Input 1 State — Physical switch/button input S1 state, available via /rpc/Input.GetStatus?id=0
  • Input 2 State — Physical switch/button input S2 state, available via /rpc/Input.GetStatus?id=1
  • Input 3 State — Physical switch/button input S3 state, available via /rpc/Input.GetStatus?id=2
  • Device Temperature — Internal temperature in °C, available in Switch.GetStatus response (non-metered devices may still report temperature)
  • Uptime — Seconds since last reboot, available in Sys.GetStatus response
  • RAM Usage — Total and free RAM in bytes, available in Sys.GetStatus response
  • Device Time — Current device time in HH:MM format, available in Sys.GetStatus response
  • Auto-off Timer — Auto-reset timer in seconds via toggle_after parameter, could be added as switch parameter for all 3 channels
  • Ethernet Status — Pro 3 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