TapHome
Oficial · TapHome Verificat

Shelly Plus 1

Releu Wi-Fi Shelly Plus 1 cu contacte libere de potențial. Comandați un singur circuit prin HTTP din TapHome — fără cloud.

ShellyPacket Parser → HTTP1 dispozitivRevizia 1.0 Ultima actualizare: 29 martie 2026
Shelly Plus 1

Import în aplicația TapHomeHardware › Packet Parser › Adăugați din șablon

Descărcați șablon
Pe această pagină

Acest dispozitiv acceptă mDNS

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

shellyplus1-{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.

Adresa în rețea

TapHome comunică cu dispozitivul la adresa introdusă la import. Atribuiți dispozitivului o adresă fixă — o rezervare IP în router sau numele său mDNS, dacă îl acceptă —, altfel integrarea nu mai funcționează când routerul schimbă adresa.

Pregătirea rețelei

Ghid de integrare

Shelly Plus 1 este un releu Wi-Fi compact cu contacte libere de potențial. Se montează în spatele unui întrerupător de perete standard și poate comanda un circuit de până la 16 A (3500 W la 230 V AC) sau 10 A (30 V DC). Dispozitivul acceptă o gamă largă de tensiuni de alimentare — 110-240 VAC, 24-48 VDC sau 12 VDC — fiind potrivit atât pentru instalații alimentate de la rețea, cât și pentru instalații de joasă tensiune. TapHome comunică cu dispozitivul prin HTTP, folosind API-ul RPC Gen2+ în rețeaua locală — nu este necesară conexiunea la cloud.

Șablonul oferă un singur întrerupător cu releu. Spre deosebire de Plus 1PM, acest dispozitiv nu are o funcție integrată de măsurare a puterii.

Configurare

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

Dispozitivul folosește API-ul JSON-RPC Gen2+. Toată comunicația are loc prin cereri HTTP GET către endpointurile /rpc/ pe portul 80.

Funcțiile dispozitivului

Comanda releului

Șablonul oferă releul ca dispozitiv de tip întrerupător. Starea releului se citește din răspunsul /rpc/Switch.GetStatus?id=0 (câmpul output, boolean), iar releul se comandă prin /rpc/Switch.Set?id=0 cu on=true sau on=false.

Intervalul de interogare este de 2,5 secunde, ceea ce asigură în TapHome o actualizare a stării aproape în timp real.

Funcții suplimentare

Prin API-ul RPC, Shelly Plus 1 furnizează și temperatura internă a releului, starea intrării pentru întrerupătorul fizic, adresa MAC a dispozitivului, timpul de funcționare, utilizarea RAM, ora dispozitivului, adresa IP, SSID-ul Wi-Fi și puterea semnalului Wi-Fi. Sunt disponibile și un temporizator de oprire automată (parametrul toggle_after) și acțiunile de repornire a dispozitivului și de actualizare a firmware-ului. Aceste funcții pot fi adăugate într-o actualizare viitoare a șablonului.

Shelly Plus 1 nu măsoară puterea. Dacă aveți nevoie de monitorizarea energiei, folosiți în schimb Shelly Plus 1PM — are aceleași dimensiuni și aceleași funcții de releu, dar oferă în plus citirea puterii instantanee, a tensiunii, a curentului și a energiei cumulate.

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 (shellyplus1-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ă unitatea centrală TapHome (CCU) și Shelly sunt în aceeași rețea / VLAN
  5. Asigurați-vă că autentificarea HTTP Digest este dezactivată în interfața web Shelly — TapHome nu acceptă cereri autentificate

Releul nu comută

  1. Verificați modul intrării pentru întrerupător în interfața web Shelly (setarea in_mode) — dacă este setat la detached, întrerupătorul fizic nu va acționa releul, dar comenzile HTTP ar trebui să funcționeze în continuare
  2. Interogați manual /rpc/Switch.GetStatus?id=0 și verificați dacă câmpul output se schimbă la comutare
  3. Verificați câmpul source din răspunsul de stare pentru a vedea ce a comandat ultima dată releul

Răspuns lent sau erori de timeout

  1. Dispozitivele Gen2+ acceptă până la 6 conexiuni HTTP simultane (față de 2 la Gen1) — evitați totuși interogarea excesivă din mai multe sisteme
  2. Dezactivați modul ECO în interfața web Shelly, dacă este activat — acesta trece dispozitivul în repaus între interogări și poate provoca erori de timeout la intervale scurte de interogare
  3. Folosiți o adresă IP statică sau o rezervare DHCP pentru a preveni schimbarea adresei

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 1

Aceste dispozitive apar în TapHome după import.

Shelly Plus 1 Modul
Variabile personalizate
status (string)
Întrerupător Comutator Citire și scriere

Comanda releului monocanal — pornire/oprire prin API-ul RPC

boolean
Valori / Stări: ON · OFF

Întrerupător

Citirea stării comutatorului
var x := (sendhttprequest("/rpc/Switch.GetStatus?id=0"));
status := x.Content;
return(PARSEJSON(status, "$.output", true));
Scrierea stării comutatorului
VAR response := SENDHTTPREQUEST("rpc/Switch.Set?id=0&on=" + if(St,"true","false"));
IF response.IsSuccess = false
  ADDERROR(response.StatusCode);
END
Conexiune: Packet Parser → HTTP • Nume gazdă: shellyplus1-{MAC}.local
Îmbunătățiri posibile (12)
  • Switch Temperature — Internal relay temperature in °C, available in Switch.GetStatus response
  • Input State — Physical switch/button input state, available via /rpc/Input.GetStatus?id=0
  • MAC Address — Device MAC address, available in Sys.GetStatus response
  • 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
  • IP Address — Device station IP address, available in WiFi.GetStatus response
  • WiFi SSID — Connected WiFi network name, available in WiFi.GetStatus response
  • WiFi Signal Strength — WiFi RSSI in dBm, available in WiFi.GetStatus response
  • Auto-off Timer — Auto-reset timer in seconds via toggle_after parameter, could be added as switch parameter
  • Reboot — Triggers device reboot, could be added as service action
  • Firmware Update — Initiates OTA firmware update to stable or beta channel

Parametri de import

Introduceți aceste valori când importați XML-ul.

Solicitat în aplicațieImplicit
Adresă IP192.168.0.1

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.

Șablon · portalul TapHome Shelly Plus 1 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. Packet Parser → HTTP Vezi în portalul TapHome