---
title: "Shelly 1 Gen3 Garage Door (Relay, Reed Contact on SW)"
description: "Shelly 1 Gen3 přes lokální HTTP jako ovládání garážových vrat: stav z jazýčkového kontaktu na SW, impuls pro pohon z relé. Bez hesla, režim Detached."
url: "https://taphome.com/cs/compatibility/shelly-1-gen3-http/"
language: cs
lastmod: 2026-11-10
generator: hugo
ai:
  topics: ["http","wifi","garage-door","relay","reed-contact","door-sensor","i/o-module","sensor"]
  questions: ["Jak integrovat Shelly 1 Gen3 jako ovládání garážových vrat s TapHome?","Co ovládá a čte šablona TapHome pro garážová vrata se Shelly 1 Gen3?","Jak připojit pohon garážových vrat a jazýčkový kontakt k Shelly 1 Gen3?","Je vstup SW na Shelly 1 Gen3 bezpotenciálový?","Která nastavení Shelly jsou potřeba pro TapHome: heslo, režim vstupu a režim Detached?","Proč TapHome ukazuje garážová vrata jako otevřená, i když jsou zavřená?","Jak změnit délku impulsu relé pro pohon garážových vrat?","Proč TapHome zobrazuje „Shelly asks for a password (HTTP 401)“?"]
---

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

Komunikace: Packet Parser → HTTP

> Adresa v síti
> 
> TapHome komunikuje se zařízením na adrese zadané při importu. Dejte zařízení stálou adresu — rezervaci IP v routeru, nebo jeho mDNS jméno, pokud ho podporuje —, jinak integrace přestane fungovat, když router adresu změní.
> 
> [Příprava sítě](https://taphome.com/cs/docs/setup/network-preparation/)

## Návod na integraci

Shelly 1 Gen3 (model S3SW-001X16EU) je kompaktní jednokanálové Wi-Fi relé s bezpotenciálovým kontaktem relé (svorky **I** a **O**) a jedním vstupem pro spínač (**SW**). Napájí se z 110–240 V~, 24–48 V⎓ nebo ze stabilizovaného zdroje 12 V⎓ a vejde se do standardní instalační krabice. TapHome ho čte a ovládá přes HTTP v lokální síti pomocí Shelly Gen2+ RPC API (komponenty `switch:0` a `input:0`), bez cloudu Shelly.

Tato komunitní šablona je určena pro garážová vrata: jazýčkový kontakt na SW hlásí, zda jsou vrata otevřená, nebo zavřená, a relé dává vstupu tlačítka pohonu vrat krátký impuls. Poskytuje tři zařízení:

- **Relay** — relé jako obyčejný spínač zap/vyp.
- **SW input** — stav vstupu SW (zapnuto = kontakt na SW je sepnutý).
- **Garage door** — stav vrat z jazýčkového kontaktu; klepnutí pošle pohonu jeden impuls relé, ale jen tehdy, když vrata ještě nejsou v požadovaném stavu.

> [!NOTE]
> Relay a Garage door ovládají totéž relé. Použijte jedno z nich a druhé skryjte nebo smažte.

## Hardwarové připojení

> [!WARNING]
> Instalaci musí provést certifikovaný elektrikář. Před připojováním nebo změnou jakýchkoli vodičů vypněte jistič a vhodnou zkoušečkou ověřte, že na svorkách není napětí. Shelly vyžaduje jistič s charakteristikou B nebo C, max. 16 A.

### Schémata zapojení

Shelly uvádí jedno schéma zapojení pro každé napájení. Ve všech třech je zátěž připojena přes bezpotenciálové svorky relé **O** a **I** a spínač je zapojen mezi **SW** a napájecí vodič.

Napájení 110–240 V~: L a N pod napětím, spínač mezi SW a L.

![Schéma zapojení Shelly 1 Gen3 pro napájení 110–240 V AC: svorky L a N pod napětím, spínač mezi SW a L, zátěž zapojená přes bezpotenciálové svorky O a I.](https://taphome.com/images/compatibility/shelly-1-gen3-http/wiring-ac_hu_d66b4612c062a05b.jpg)

Napájení 24–48 V⎓: plus na N, GND na L, spínač mezi SW a GND.

![Schéma zapojení Shelly 1 Gen3 pro napájení 24–48 V DC: plus na N, GND na L, spínač mezi SW a GND, zátěž zapojená přes bezpotenciálové svorky O a I.](https://taphome.com/images/compatibility/shelly-1-gen3-http/wiring-dc-24-48v_hu_9d7ec3968564d1b0.jpg)

Stabilizované napájení 12 V⎓: plus na svorku 12V, GND na L, spínač mezi SW a GND.

![Schéma zapojení Shelly 1 Gen3 pro stabilizované napájení 12 V DC: plus na svorku 12V, GND na L, spínač mezi SW a GND, zátěž zapojená přes svorky O a I.](https://taphome.com/images/compatibility/shelly-1-gen3-http/wiring-dc-12v_hu_bb0aaf79a96be915.jpg)

### Pohon garážových vrat na I a O

Svorky tlačítka pohonu garážových vrat připojte na svorky relé **I** a **O** — ve schématech místo žárovky. Kontakt relé je bezpotenciálový, takže spíná vstup pohonu jako tlačítko, nezávisle na napájení Shelly. Kontakt je dimenzován na max. 240 V~ / 16 A a max. 30 V⎓ / 10 A.

### Jazýčkový kontakt na SW

Jazýčkový kontakt připojte na vstup **SW** na stejné místo jako spínač ve schématu zapojení pro vaše napájení. Šablona očekává spínací (NO) jazýčkový kontakt s magnetem u zavřených vrat (kontakt sepnutý = vrata zavřená); jiné uspořádání řeší proměnná `Invert` (viz Konfigurace).

> [!WARNING]
> SW **není** bezpotenciálový vstup. Ve schématech zapojení Shelly je spínač na SW připojen na napájení: při napájení 110–240 V~ jazýčkový kontakt a jeho kabel spínají **síťové napětí** (SW na L). Použijte kontakt a kabel dimenzované na síťové napětí, nebo napájejte Shelly z 12 V⎓ či 24–48 V⎓, kde kontakt spíná SW na GND. Vždy se řiďte schématem zapojení v uživatelské příručce Shelly.

Šroubové svorky pojmou vodiče o průřezu 0,2 až 2,5 mm² (plné, lanové nebo s dutinkami), odizolované na 6–7 mm. Shelly je určeno jen pro vnitřní použití, při teplotě –20 °C až 40 °C.

## Konfigurace

### Připojení Shelly k Wi-Fi

Shelly 1 Gen3 má vestavěné webové rozhraní. Po prvním zapnutí otevře vlastní přístupový bod `Shelly1G3-XXXXXXXXXXXX`:

1. Připojte telefon nebo počítač k Wi-Fi síti `Shelly1G3-XXXXXXXXXXXX` (ve výchozím stavu otevřená).
2. V prohlížeči otevřete `http://192.168.33.1/`.
3. Přejděte do **Settings → Wi-Fi**, vyberte nebo zadejte svou Wi-Fi síť a její heslo a uložte. Shelly pracuje v pásmu 2,4 GHz, proto použijte síť 2,4 GHz.
4. V routeru najděte IP adresu, kterou Shelly dostalo, a otevřete webové rozhraní na `http://<IP address>/`.

Přístupový bod je ve výchozím stavu otevřená síť. Jakmile je Shelly připojeno k vaší Wi-Fi, přístupový bod lze vypnout v **Settings → Access point and Range Extender**.

Shelly lze přidat do Wi-Fi i aplikací Shelly Smart Control. TapHome cloud Shelly nepotřebuje.

### Nastavení Shelly pro TapHome

Před importem šablony nastavte ve webovém rozhraní Shelly (`http://<IP address>/`):

| Nastavení | Kde ve webovém rozhraní Shelly | Hodnota | Proč |
|---|---|---|---|
| Ochrana heslem | **Settings → Device settings → Authentication** | Vypnuto | TapHome nepodporuje HTTP Digest autentizaci. S heslem zobrazí každé zařízení chybu „Shelly asks for a password (HTTP 401)“. |
| Typ vstupu | **Input/output settings → input mode** | **Switch** | Jazýčkový kontakt má stav; s typem Button Shelly nehlásí žádný stav a SW input i Garage door zobrazí chybu. |
| Režim vstupu/výstupu | **Input/output settings → output type** | **Detached Switch** | V ostatních režimech jazýčkový kontakt sám přepne relé při každém pohybu vrat. Garage door zobrazuje varování, dokud režim není Detached. |
| Pevná IP adresa | **Settings → Wi-Fi** (statická IP) nebo rezervace DHCP v routeru | — | Šablona oslovuje Shelly podle IP adresy; ta se nesmí měnit. |

> [!TIP]
> Vlastní volbu vstupu Shelly **Invert** nechte vypnutou a místo ní použijte proměnnou šablony `Invert`. Volba v Shelly invertuje stav vstupu, který TapHome čte, takže by otočila SW input i Garage door současně.

### Import šablony

V TapHome importujte šablonu a jako parametr IP adresy zadejte pevnou IP adresu Shelly (výchozí `192.168.0.1` je jen zástupná hodnota).

### Proměnné Garage door

| Proměnná | Výchozí hodnota | Význam |
|---|---|---|
| `Invert` | `0` | `0`: kontakt sepnutý = stav **Uzavřeno** (spínací jazýčkový kontakt s magnetem u zavřených vrat). Nastavte `1`, když je kontakt při zavřených vratech rozepnutý. |
| `PulseSeconds` | `1` | Délka impulsu relé v sekundách. Shelly přepne relé zpět samo (`toggle_after`). |

## Možnosti zařízení

### Garage door

Stav vrat pochází ze vstupu SW (`Input.GetStatus?id=0`), dotazuje se každých 2,5 s a zobrazuje se jako **Otevřeno** nebo **Uzavřeno**. Klepnutí na Otevřeno nebo Uzavřeno nejprve přečte vstup a `Switch.Set?id=0&on=true&toggle_after=<PulseSeconds>` pošle, jen když vrata ještě nejsou v daném stavu. Druhé klepnutí na tentýž stav nebo klepnutí poté, co vraty pohnul dálkový ovladač, nepošle nic. Pokud Shelly na čtení vstupu neodpoví, impuls se také nepošle.

Po restartu řídicí jednotky Garage door přečte svůj stav ze Shelly a nic nepošle (`StartupValueSource` = číst ze zařízení). Bez toho by se vrata, která se během restartu pohnula, vrátila zpět.

Zařízení čte i nastavení spínače Shelly (`Switch.GetConfig?id=0`) a zobrazuje varování, dokud režim vstupu není Detached.

Jeden vstup dává jen dva stavy. „Otevírá se“ a „zavírá se“ zobrazit nelze: vrata ukazují Otevřeno, jakmile opustí zavřenou polohu.

### Relay

Relé jako spínač zap/vyp: stav se čte ze `Switch.GetStatus?id=0` (`output`) každých 2,5 s a přepíná se pomocí `Switch.Set?id=0&on=true` nebo `on=false`. Po restartu řídicí jednotky Relay také přečte svůj stav ze Shelly, místo aby ho poslal.

### SW input

Stav `input:0` z `Input.GetStatus?id=0`, dotazovaný každých 2,5 s — zapnutý, když je kontakt na SW sepnutý. Před každým čtením šablona zkontroluje typ vstupu (`Input.GetConfig?id=0`) a zobrazí chybu, když to není Switch.

### Diagnostika modulu a servisní akce

Modul se dotazuje každých 15 s (`Sys.GetStatus`, `WiFi.GetStatus`, `Switch.GetStatus`) a zobrazuje tyto servisní atributy:

- **Wi-Fi** — název připojené sítě
- **IP adresa** — aktuální IP adresa Shelly
- **Síla signálu** — síla Wi-Fi signálu (RSSI)
- **MAC** — MAC adresa
- **Teplota** — vnitřní teplota Shelly v °C

Zobrazí varování, když je k dispozici nový stabilní firmware a když Shelly potřebuje restart. K dispozici jsou dvě servisní akce: **aktualizace firmwaru** na stabilní verzi (`Shelly.Update`) a **restart** (`Shelly.Reboot`).

Shelly 1 Gen3 nemá měření výkonu.

## Řešení problémů

### „Shelly asks for a password (HTTP 401)“ na všech zařízeních

V Shelly je zapnutá ochrana heslem. Vypněte ji ve webovém rozhraní Shelly v **Settings → Device settings → Authentication**.

### Zařízení neodpovídají nebo „Shelly answered HTTP …“

1. Ověřte, že IP adresa v TapHome je aktuální IP adresa Shelly a že je Shelly v síti.
2. Ověřte, že Shelly má pevnou IP adresu (statická IP nebo rezervace DHCP), aby se adresa po restartu routeru nezměnila.
3. V prohlížeči ve stejné síti otevřete `http://<IP address>/rpc/Sys.GetStatus` — pokud Shelly odpoví JSONem, je dostupné.

### „SW input is not of type switch in Shelly“ nebo „SW input has no state“

Režim vstupu je Button (nebo jiný typ). V nastavení vstupu/výstupu Shelly nastavte režim vstupu na **Switch**.

### Varování „Shelly input mode is not Detached“ na Garage door

Jazýčkový kontakt sám přepíná relé. V nastavení vstupu/výstupu Shelly nastavte typ výstupu na **Detached Switch**.

### Garage door ukazuje Otevřeno, ačkoli jsou vrata zavřená

Jazýčkový kontakt je při zavřených vratech rozepnutý. Nastavte proměnnou `Invert` na `1`.

### Pohon nereaguje na impuls

Impuls je pro pohon příliš krátký. Zvyšte `PulseSeconds`. Ověřte také, že svorky tlačítka pohonu jsou připojeny na I a O.

### Klepnutí na Garage door nic neudělá

Šablona pošle impuls, jen když vrata podle jazýčkového kontaktu ještě nejsou v požadovaném stavu. Zkontrolujte zařízení SW input: pokud se při pohybu vrat nemění, zkontrolujte zapojení jazýčkového kontaktu a polohu magnetu.

### Varování „New firmware update is available“ nebo „Restart required“

Použijte na modulu servisní akci **aktualizace firmwaru** nebo **restart**.

## Jak nainstalovat v TapHome

### Předpoklady

- Zařízení Shelly nainstalované a zapnuté
- Lokální Wi-Fi síť (2,4 GHz)
- TapHome CCU ve stejné síti

### Krok 1 — Připojte Shelly k Wi-Fi

**Možnost A — Aplikace Shelly (doporučeno):**

1. Stáhněte si [aplikaci Shelly](https://www.shelly.com/en/support/shelly-app) (iOS / Android)
2. Klepněte na **+** → **Add Device** a postupujte podle průvodce Bluetooth párováním
3. Po výzvě zadejte své Wi-Fi přihlašovací údaje

**Možnost B — AP režim (bez aplikace):**

1. Při prvním zapnutí zařízení vytvoří hotspot: `ShellyXXX-AABBCCDDEE`
2. Připojte telefon/PC k tomuto hotspotu
3. Otevřete `http://192.168.33.1` → **Internet & Security** → **Wi-Fi Mode - Client**
4. Zadejte SSID a heslo → **Save**

> [!NOTE]
> Shelly podporuje pouze **2,4 GHz** sítě. 5 GHz sítě se při skenování nezobrazí.

### Krok 2 — Zjistěte IP adresu

Po připojení k Wi-Fi zjistěte přiřazenou IP adresu jedním z následujících způsobů:

- **Aplikace Shelly:** Detail zařízení → **Device info** → IP adresa
- **Webové rozhraní Shelly:** Připojte se k AP zařízení před nastavením Wi-Fi — IP se zobrazí po uložení
- **DHCP tabulka routeru:** Hledejte hostname jako `shelly1pm-AABBCCDDEE`
- **mDNS:** Pingněte `shelly<model>-<mac>.local` (např. `shelly1pm-AABBCCDDEE.local`) ze stejné sítě

> [!TIP]
> Přiřaďte zařízení Shelly **statickou IP** (DHCP rezervaci) ve vašem routeru, aby se adresa nezměnila po restartu routeru.

### Krok 3 — Konfigurace v TapHome

1. V TapHome přidejte nový modul **Packet Parser (HTTP)**
2. **IP Address:** zadejte IP z kroku 2 (např. `192.168.1.50`)
3. **Port:** `80` (výchozí, není potřeba měnit)
4. Importujte šablonu — TapHome bude pravidelně číst `/status` pro zjištění stavu zařízení

> [!NOTE]
> HTTP autentifikace je na zařízeních Shelly standardně vypnutá. Pokud jste povolili ochranu přihlášením, TapHome momentálně nepodporuje HTTP Basic Auth — pro integraci s TapHome ponechte autentifikaci vypnutou.

## Dostupná zařízení 3

Tato zařízení se po importu zobrazí v TapHome.

Shelly 1 Gen3 Modul

Servisní atributy

|                                |
|--------------------------------|
| Wi-Fi                          |
| ${ipAddress}                   |
| ${xml\_signal\_strength} \[dB] |
| MAC                            |
| ${temperature} \[°C]           |

Servisní akce

|                    |
|--------------------|
| ${xml\_update\_fw} |
| Reboot             |

Vlastní proměnné

|                         |
|-------------------------|
| `SysStatus` (string)    |
| `WiFiStatus` (string)   |
| `SwitchStatus` (string) |

Čtení (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
```

Servisní atributy

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

Servisní akce

${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 Přepínač

Hodnoty / Stavy: ON · OFF

Čtení stavu přepínače

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

Zápis stavu přepínače

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

SW input Jazýčkový kontakt

Čtení

```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 Přepínač

Hodnoty / Stavy: Open · Closed

Proměnná: `Invert`, Proměnná: `PulseSeconds`

Čtení stavu přepínače

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

Zápis stavu přepínače

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

Čtení (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
```

**Připojení:** Packet Parser → HTTP

## Parametry importu

Tyto hodnoty zadáte při importu XML.

| Ptá se v aplikaci | Výchozí       |
|-------------------|---------------|
| IP adresa         | `192.168.0.1` |

## Související dokumentace

- [Integrace Packet Parser](https://taphome.com/cs/compatibility/packet-parser-guide/)
- [Packet Parser (HTTP, TCP, UDP, FTP, MQTT)](https://taphome.com/cs/docs/integration/packet-parser/)
- [Funkce Packet parser](https://taphome.com/cs/docs/script/packet-parser/)
- [Funkce pro parsování](https://taphome.com/cs/docs/script/parsing-functions/)