TapHome

Shelly Plus 1

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:

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.

Shelly Plus 1

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

Shelly Plus 1 Modul
Variabile personalizate
status (string)
Întrerupător Comutator

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

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