TapHome
Comunitate Beta Senzori

Shelly 1 Gen3 Garage Door (Relay, Reed Contact on SW)

Releul Wi-Fi Shelly 1 Gen3 ca controler pentru ușa de garaj în TapHome, prin HTTP local (Gen2+ RPC API). Un contact reed pe intrarea SW arată dacă ușa este deschisă sau închisă, iar releul fără potențial de pe I și O trimite un impuls scurt automatizării ușii numai când ușa nu se află deja în starea cerută. Include și un întrerupător simplu pe releu, starea intrării SW și diagnosticare Wi-Fi.

ShellyPacket Parser → HTTP3 dispozitiveRevizia 1.0 Ultima actualizare: 10 noiembrie 2026

Trimis de Lukáš Štěpán

Shelly 1 Gen3 Garage Door (Relay, Reed Contact on SW)

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

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

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 1 Gen3 (modelul S3SW-001X16EU) este un releu Wi-Fi compact, cu un singur canal, cu un contact de releu fără potențial (bornele I și O) și o intrare pentru întrerupător (SW). Se alimentează la 110–240 V~, 24–48 V⎓ sau de la o sursă stabilizată de 12 V⎓ și se montează într-o doză de aparataj standard. TapHome îl citește și îl controlează prin HTTP în rețeaua locală, cu Shelly Gen2+ RPC API (componentele switch:0 și input:0), fără cloudul Shelly.

Acest șablon al comunității este creat pentru o ușă de garaj: un contact reed pe SW raportează dacă ușa este deschisă sau închisă, iar releul trimite un impuls scurt la intrarea pentru buton a automatizării ușii de garaj. Oferă trei dispozitive:

  • Relay — releul ca întrerupător simplu pornit/oprit.
  • SW input — starea intrării SW (pornit = contactul de pe SW este închis).
  • Garage door — starea ușii după contactul reed; o atingere trimite un impuls de releu la automatizare, dar numai când ușa nu se află deja în starea cerută.

Relay și Garage door controlează același releu. Folosiți unul dintre ele, iar pe celălalt ascundeți-l sau ștergeți-l.

Conectarea hardware

Instalarea trebuie efectuată de un electrician autorizat. Înainte de a conecta sau de a modifica orice fir, opriți disjunctorul și verificați cu un tester adecvat că nu există tensiune pe borne. Shelly cere un disjunctor cu caracteristica B sau C, max. 16 A.

Scheme de conectare

Shelly oferă câte o schemă de conectare pentru fiecare tip de alimentare. În toate trei, sarcina se conectează prin bornele de releu fără potențial O și I, iar întrerupătorul se conectează între SW și linia de alimentare.

Alimentare 110–240 V~: L și N alimentate, întrerupătorul între SW și L.

Schema de conectare Shelly 1 Gen3 pentru alimentare 110-240 V AC: bornele L și N alimentate, întrerupătorul între SW și L, sarcina conectată prin bornele fără potențial O și I.

Alimentare 24–48 V⎓: plus la N, GND la L, întrerupătorul între SW și GND.

Schema de conectare Shelly 1 Gen3 pentru alimentare 24-48 V DC: plus la N, GND la L, întrerupătorul între SW și GND, sarcina conectată prin bornele fără potențial O și I.

Alimentare stabilizată 12 V⎓: plus la borna 12V, GND la L, întrerupătorul între SW și GND.

Schema de conectare Shelly 1 Gen3 pentru alimentare stabilizată 12 V DC: plus la borna 12V, GND la L, întrerupătorul între SW și GND, sarcina conectată prin bornele O și I.

Automatizarea ușii de garaj pe I și O

Conectați bornele pentru buton ale automatizării ușii de garaj la bornele releului I și O — în scheme, în locul lămpii. Contactul releului este fără potențial, astfel că acționează intrarea automatizării ca un buton, independent de alimentarea Shelly. Contactul suportă max. 240 V~ / 16 A și max. 30 V⎓ / 10 A.

Contactul reed pe SW

Conectați contactul reed la intrarea SW în același loc ca întrerupătorul din schema de conectare pentru alimentarea dvs. Șablonul așteaptă un contact reed normal deschis, cu magnetul la ușa închisă (contact închis = ușă închisă); o altă dispunere se rezolvă cu variabila Invert (consultați Configurare).

SW nu este o intrare fără potențial. În schemele Shelly, întrerupătorul de pe SW este conectat la alimentare: la alimentarea de 110–240 V~, contactul reed și cablul său comută tensiunea de rețea (SW la L). Folosiți un contact și un cablu dimensionate pentru tensiunea de rețea sau alimentați Shelly la 12 V⎓ sau 24–48 V⎓, unde contactul comută SW la GND. Respectați întotdeauna schema de conectare din manualul de utilizare Shelly.

Bornele cu șurub acceptă conductoare de 0,2–2,5 mm² (rigide, multifilare sau cu manșoane de capăt), dezizolate pe 6–7 mm. Shelly este destinat exclusiv utilizării în interior, la temperaturi între –20 °C și 40 °C.

Configurare

Conectarea Shelly la Wi-Fi

Shelly 1 Gen3 are o interfață web integrată. După prima pornire, deschide propriul punct de acces Shelly1G3-XXXXXXXXXXXX:

  1. Conectați un telefon sau un calculator la rețeaua Wi-Fi Shelly1G3-XXXXXXXXXXXX (deschisă implicit).
  2. Deschideți http://192.168.33.1/ într-un browser.
  3. Accesați Settings → Wi-Fi, selectați sau introduceți rețeaua Wi-Fi și parola ei, apoi salvați. Shelly funcționează în banda de 2,4 GHz, deci folosiți o rețea de 2,4 GHz.
  4. Găsiți în router adresa IP primită de Shelly și deschideți interfața web la http://<IP address>/.

Punctul de acces este implicit o rețea deschisă. După ce Shelly este conectat la rețeaua dvs. Wi-Fi, punctul de acces se poate dezactiva din Settings → Access point and Range Extender.

Shelly poate fi adăugat în rețeaua Wi-Fi și cu aplicația Shelly Smart Control. TapHome nu are nevoie de cloudul Shelly.

Setările Shelly pentru TapHome

Configurați următoarele în interfața web Shelly (http://<IP address>/) înainte de a importa șablonul:

SetareUnde în interfața web ShellyValoareDe ce
Protecție prin parolăSettings → Device settings → AuthenticationDezactivatăTapHome nu acceptă autentificarea HTTP Digest. Cu parolă, fiecare dispozitiv afișează eroarea “Shelly asks for a password (HTTP 401)”.
Tipul intrăriiInput/output settings → input modeSwitchContactul reed are o stare; cu tipul Button, Shelly nu raportează nicio stare, iar SW input și Garage door afișează o eroare.
Modul intrare/ieșireInput/output settings → output typeDetached SwitchÎn celelalte moduri, contactul reed comută singur releul la fiecare mișcare a ușii. Garage door afișează un avertisment până când modul este Detached.
Adresă IP fixăSettings → Wi-Fi (IP static) sau o rezervare DHCP în router—Șablonul accesează Shelly după adresa IP; aceasta nu trebuie să se schimbe.

Lăsați dezactivată opțiunea proprie Shelly Invert pentru intrare și folosiți în schimb variabila șablonului Invert. Opțiunea Shelly inversează starea intrării pe care o citește TapHome, deci ar inversa simultan SW input și Garage door.

Importul șablonului

În TapHome, importați șablonul și introduceți adresa IP fixă a Shelly ca parametru de adresă IP (valoarea implicită 192.168.0.1 este doar un substituent).

Variabilele Garage door

VariabilăImplicitSemnificație
Invert00: contact închis = ușă în starea Închis (contact reed normal deschis, cu magnetul la ușa închisă). Setați 1 când contactul este deschis cu ușa închisă.
PulseSeconds1Durata impulsului releului în secunde. Shelly comută releul înapoi singur (toggle_after).

Funcțiile dispozitivului

Garage door

Starea ușii provine de la intrarea SW (Input.GetStatus?id=0), interogată la fiecare 2,5 s, și se afișează ca Deschis sau Închis. O atingere pe Deschis sau Închis citește mai întâi intrarea și trimite Switch.Set?id=0&on=true&toggle_after=<PulseSeconds> numai dacă ușa nu se află deja în acea stare. O a doua atingere pe aceeași stare sau o atingere după ce ușa a fost mișcată cu telecomanda nu trimite nimic. Dacă Shelly nu răspunde la citirea intrării, nu se trimite niciun impuls.

După o repornire a unității de control, Garage door își citește starea din Shelly și nu trimite nimic (StartupValueSource = citire din dispozitiv). Fără aceasta, o ușă mișcată în timpul repornirii ar fi readusă în poziția anterioară.

Dispozitivul citește și setările de comutare ale Shelly (Switch.GetConfig?id=0) și afișează un avertisment cât timp modul intrării nu este Detached.

O singură intrare oferă doar două stări. „Se deschide” și „se închide” nu pot fi afișate: ușa afișează Deschis imediat ce părăsește poziția închisă.

Relay

Releul ca întrerupător pornit/oprit: starea se citește din Switch.GetStatus?id=0 (output) la fiecare 2,5 s și se comută cu Switch.Set?id=0&on=true sau on=false. După o repornire a unității de control, și Relay își citește starea din Shelly, în loc să trimită una.

SW input

Starea input:0 din Input.GetStatus?id=0, interogată la fiecare 2,5 s — pornit când contactul de pe SW este închis. Înainte de fiecare citire, șablonul verifică tipul intrării (Input.GetConfig?id=0) și afișează o eroare dacă acesta nu este Switch.

Diagnosticarea modulului și acțiuni de service

Modulul este interogat la fiecare 15 s (Sys.GetStatus, WiFi.GetStatus, Switch.GetStatus) și afișează următoarele atribute de service:

  • Wi-Fi — numele rețelei conectate
  • Adresă IP — adresa IP curentă a Shelly
  • Puterea semnalului — puterea semnalului Wi-Fi (RSSI)
  • MAC — adresa MAC
  • Temperatură — temperatura internă a Shelly în °C

Afișează un avertisment când este disponibil un firmware stabil nou și când Shelly necesită o repornire. Sunt disponibile două acțiuni de service: actualizare firmware la versiunea stabilă (Shelly.Update) și repornire (Shelly.Reboot).

Shelly 1 Gen3 nu are funcție de măsurare a puterii.

Rezolvarea problemelor

“Shelly asks for a password (HTTP 401)” pe toate dispozitivele

Protecția prin parolă este activată în Shelly. Dezactivați-o din Settings → Device settings → Authentication în interfața web Shelly.

Dispozitivele nu răspund sau “Shelly answered HTTP …”

  1. Verificați dacă adresa IP din TapHome este adresa IP curentă a Shelly și dacă Shelly este conectat la rețea.
  2. Verificați dacă Shelly are o adresă IP fixă (IP static sau rezervare DHCP), astfel încât adresa să nu se schimbe după o repornire a routerului.
  3. Deschideți http://<IP address>/rpc/Sys.GetStatus într-un browser din aceeași rețea — dacă Shelly răspunde cu JSON, este accesibil.

“SW input is not of type switch in Shelly” sau “SW input has no state”

Modul intrării este Button (sau alt tip). Setați modul intrării la Switch în setările de intrare/ieșire Shelly.

Avertismentul “Shelly input mode is not Detached” pe Garage door

Contactul reed comută singur releul. Setați tipul ieșirii la Detached Switch în setările de intrare/ieșire Shelly.

Garage door afișează Deschis deși ușa este închisă

Contactul reed este deschis cu ușa închisă. Setați variabila Invert la 1.

Automatizarea nu reacționează la impuls

Impulsul este prea scurt pentru automatizare. Măriți PulseSeconds. Verificați și dacă bornele pentru buton ale automatizării sunt conectate la I și O.

O atingere pe Garage door nu face nimic

Șablonul trimite un impuls numai când, conform contactului reed, ușa nu se află deja în starea cerută. Verificați dispozitivul SW input: dacă nu se schimbă când ușa se mișcă, verificați cablarea contactului reed și poziția magnetului.

Avertismentele “New firmware update is available” sau “Restart required”

Folosiți acțiunea de service actualizare firmware sau repornire pe modul.

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 3

Aceste dispozitive apar în TapHome după import.

Shelly 1 Gen3 Modul
Atribute de service
Wi-Fi
${ipAddress}
${xml_signal_strength} [dB]
MAC
${temperature} [°C]
Acțiuni de service
${xml_update_fw}
Reboot
Variabile personalizate
SysStatus (string)
WiFiStatus (string)
SwitchStatus (string)

Shelly 1 Gen3

Citire (modul)
VAR r := SENDHTTPREQUEST("/rpc/Sys.GetStatus");
IF r.IsSuccess
    SysStatus := r.Content;
ELSE
    IF r.StatusCode = 401
        ADDERROR(401, "Shelly asks for a password (HTTP 401). Turn off password protection in the Shelly web interface, TapHome does not support HTTP Digest.");
    ELSE
        ADDERROR(1, "Shelly answered HTTP " + TOSTRING(r.StatusCode));
    END
    RETURN(0);
END
r := SENDHTTPREQUEST("/rpc/WiFi.GetStatus");
IF r.IsSuccess
    WiFiStatus := r.Content;
END
r := SENDHTTPREQUEST("/rpc/Switch.GetStatus?id=0");
IF r.IsSuccess
    SwitchStatus := r.Content;
END
IF ! ISNULL(PARSEJSON(SysStatus, "available_updates.stable", true))
    ADDWARNING(2, "New firmware update is available");
END
IF PARSEJSON(SysStatus, "restart_required", true)
    ADDWARNING(3, "Restart required");
END
Atribute de service
Wi-Fi
PARSEJSON(WiFiStatus, "ssid", true)
${ipAddress}
PARSEJSON(WiFiStatus, "sta_ip", true)
${xml_signal_strength} [dB]
PARSEJSON(WiFiStatus, "rssi", true)
MAC
PARSEJSON(SysStatus, "mac", true)
${temperature} [°C]
PARSEJSON(SwitchStatus, "temperature.tC", true)
Acțiuni de service
${xml_update_fw}
VAR r := SENDHTTPREQUEST("/rpc/Shelly.Update?stage=\"stable\"");
IF r.IsSuccess
    RETURN("OK");
ELSE
    RETURN("Error " + TOSTRING(r.StatusCode));
END
Reboot
VAR r := SENDHTTPREQUEST("/rpc/Shelly.Reboot");
IF r.IsSuccess
    RETURN("OK");
ELSE
    RETURN("Error " + TOSTRING(r.StatusCode));
END
Relay Comutator
Valori / Stări: ON · OFF

Relay

Citirea stării comutatorului
VAR r := SENDHTTPREQUEST("/rpc/Switch.GetStatus?id=0");
IF r.IsSuccess
    RETURN(PARSEJSON(r.Content, "$.output"));
END
IF r.StatusCode = 401
    ADDERROR(401, "Shelly asks for a password (HTTP 401). Turn off password protection in the Shelly web interface, TapHome does not support HTTP Digest.");
ELSE
    ADDERROR(1, "Shelly answered HTTP " + TOSTRING(r.StatusCode));
END
RETURN(NaN);
Scrierea stării comutatorului
SENDHTTPREQUEST("/rpc/Switch.Set?id=0&on=" + IF(St, "true", "false"));
SW input Contact reed

SW input

Citire
VAR r := SENDHTTPREQUEST("/rpc/Input.GetConfig?id=0");
IF r.IsSuccess
    IF PARSEJSON(r.Content, "$.type", true) != "switch"
        ADDERROR(2, "SW input is not of type switch in Shelly (Input settings: Input mode = Switch)");
        RETURN(NaN);
    END
ELSE
    IF r.StatusCode = 401
        ADDERROR(401, "Shelly asks for a password (HTTP 401). Turn off password protection in the Shelly web interface, TapHome does not support HTTP Digest.");
    ELSE
        ADDERROR(1, "Shelly answered HTTP " + TOSTRING(r.StatusCode));
    END
    RETURN(NaN);
END
r := SENDHTTPREQUEST("/rpc/Input.GetStatus?id=0");
IF r.IsSuccess
    RETURN(PARSEJSON(r.Content, "$.state"));
END
IF r.StatusCode = 401
    ADDERROR(401, "Shelly asks for a password (HTTP 401). Turn off password protection in the Shelly web interface, TapHome does not support HTTP Digest.");
ELSE
    ADDERROR(1, "Shelly answered HTTP " + TOSTRING(r.StatusCode));
END
RETURN(NaN);
Garage door Comutator
Valori / Stări: Open · Closed
Variabilă: Invert, Variabilă: PulseSeconds

Garage door

Citirea stării comutatorului
VAR r := SENDHTTPREQUEST("/rpc/Input.GetStatus?id=0");
IF r.IsSuccess = false
    IF r.StatusCode = 401
        ADDERROR(401, "Shelly asks for a password (HTTP 401). Turn off password protection in the Shelly web interface, TapHome does not support HTTP Digest.");
    ELSE
        ADDERROR(1, "Shelly answered HTTP " + TOSTRING(r.StatusCode));
    END
    RETURN(NaN);
END
VAR s := PARSEJSON(r.Content, "$.state", true);
IF ISNULL(s)
    ADDERROR(2, "SW input has no state - set it to type switch in Shelly");
    RETURN(NaN);
END
IF Invert = 1
    RETURN(s);
END
RETURN(! s);
Scrierea stării comutatorului
VAR r := SENDHTTPREQUEST("/rpc/Input.GetStatus?id=0");
IF r.IsSuccess = false
    RETURN(0);
END
VAR open := IF(PARSEJSON(r.Content, "$.state", true), 0, 1);
IF Invert = 1
    open := 1 - open;
END
IF IF(St, 1, 0) != open
    SENDHTTPREQUEST("/rpc/Switch.Set?id=0&on=true&toggle_after=" + TOSTRING(PulseSeconds));
END
Citire (modul)
VAR r := SENDHTTPREQUEST("/rpc/Switch.GetConfig?id=0");
IF r.IsSuccess
    IF PARSEJSON(r.Content, "$.in_mode", true) != "detached"
        ADDWARNING(3, "Shelly input mode is not Detached - the reed contact on SW switches the relay by itself. Set Input/Output settings to Detached.");
    END
END
Conexiune: Packet Parser → HTTP

Parametri de import

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

Solicitat în aplicațieImplicit
Adresă IP192.168.0.1

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 1 Gen3 Garage Door (Relay, Reed Contact on SW) 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