---
title: "Shelly 1 Gen3 Garage Door (Relay, Reed Contact on SW)"
description: "Shelly 1 Gen3 prin HTTP local pentru ușa de garaj: deschis/închis de la un contact reed pe SW, impuls de la releu. Fără parolă, mod Detached."
url: "https://taphome.com/ro/compatibility/shelly-1-gen3-http/"
language: ro
lastmod: 2026-11-10
generator: hugo
ai:
  topics: ["http","wifi","garage-door","relay","reed-contact","door-sensor","i/o-module","sensor"]
  questions: ["Cum se integrează în TapHome un controler Shelly 1 Gen3 pentru ușa de garaj?","Ce controlează și ce citește șablonul TapHome Shelly 1 Gen3 pentru ușa de garaj?","Cum se conectează automatizarea ușii de garaj și un contact reed la Shelly 1 Gen3?","Este intrarea SW a Shelly 1 Gen3 fără potențial?","Ce setări Shelly sunt necesare pentru TapHome: parolă, modul intrării și modul Detached?","De ce ușa de garaj apare ca Deschis în TapHome deși ușa este închisă?","Cum se modifică durata impulsului releului pentru automatizarea ușii de garaj?","De ce TapHome afișează \"Shelly asks for a password (HTTP 401)\"?"]
---

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

Comunicație: Packet Parser → HTTP

> 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](https://taphome.com/ro/docs/setup/network-preparation/)

## 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ă.

> [!NOTE]
> 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

> [!WARNING]
> 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.](https://taphome.com/images/compatibility/shelly-1-gen3-http/wiring-ac_hu_d66b4612c062a05b.jpg)

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.](https://taphome.com/images/compatibility/shelly-1-gen3-http/wiring-dc-24-48v_hu_9d7ec3968564d1b0.jpg)

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.](https://taphome.com/images/compatibility/shelly-1-gen3-http/wiring-dc-12v_hu_bb0aaf79a96be915.jpg)

### 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).

> [!WARNING]
> 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:

| Setare | Unde în interfața web Shelly | Valoare | De ce |
|---|---|---|---|
| Protecție prin parolă | **Settings → Device settings → Authentication** | Dezactivată | TapHome nu acceptă autentificarea HTTP Digest. Cu parolă, fiecare dispozitiv afișează eroarea "Shelly asks for a password (HTTP 401)". |
| Tipul intrării | **Input/output settings → input mode** | **Switch** | Contactul 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șire | **Input/output settings → output type** | **Detached 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. |

> [!TIP]
> 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ă | Implicit | Semnificație |
|---|---|---|
| `Invert` | `0` | `0`: 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ă. |
| `PulseSeconds` | `1` | Durata 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](https://www.shelly.com/en/support/shelly-app) (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**

> [!NOTE]
> 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:

```
shelly<model>-<MAC>.local
```

De exemplu: `shelly1pm-AABBCCDDEE.local` (adresa MAC în hexazecimal cu majuscule, fără două puncte).

> [!TIP]
> **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

> [!NOTE]
> 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) |

Citire (modul)

```taphome
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

```taphome
PARSEJSON(WiFiStatus, "ssid", true)
```

${ipAddress}

```taphome
PARSEJSON(WiFiStatus, "sta_ip", true)
```

${xml\_signal\_strength} \[dB]

```taphome
PARSEJSON(WiFiStatus, "rssi", true)
```

MAC

```taphome
PARSEJSON(SysStatus, "mac", true)
```

${temperature} \[°C]

```taphome
PARSEJSON(SwitchStatus, "temperature.tC", true)
```

Acțiuni de service

${xml\_update\_fw}

```taphome
VAR r := SENDHTTPREQUEST("/rpc/Shelly.Update?stage=\"stable\"");
IF r.IsSuccess
    RETURN("OK");
ELSE
    RETURN("Error " + TOSTRING(r.StatusCode));
END
```

Reboot

```taphome
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

Citirea stării comutatorului

```taphome
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

```taphome
SENDHTTPREQUEST("/rpc/Switch.Set?id=0&on=" + IF(St, "true", "false"));
```

SW input Contact reed

Citire

```taphome
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`

Citirea stării comutatorului

```taphome
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

```taphome
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)

```taphome
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ție | Implicit      |
|------------------------|---------------|
| Adresă IP              | `192.168.0.1` |

## Documentație asociată

- [Packet Parser Integration](https://taphome.com/ro/compatibility/packet-parser-guide/)
- [Packet Parser (HTTP, TCP, UDP, FTP, MQTT)](https://taphome.com/ro/docs/integration/packet-parser/)
- [Funcții Packet parser](https://taphome.com/ro/docs/script/packet-parser/)
- [Funcții de parsare](https://taphome.com/ro/docs/script/parsing-functions/)