TapHome
Čeština
Slovenčina

Čeština

Magyar Italiano Polski Deutsch Română Hrvatski English
Komunita Beta Senzory

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

Wi-Fi relé Shelly 1 Gen3 jako ovládání garážových vrat v TapHome přes lokální HTTP (Gen2+ RPC API). Jazýčkový kontakt na vstupu SW ukazuje, zda jsou vrata otevřená, nebo zavřená, a bezpotenciálové relé na svorkách I a O dá pohonu krátký impuls, jen když vrata ještě nejsou v požadovaném stavu. Navíc obyčejný spínač relé, stav vstupu SW a diagnostika Wi-Fi.

ShellyPacket Parser → HTTP3 zařízeníRevize 1.0 Poslední aktualizace: 10. listopadu 2026

Přidal Lukáš Štěpán

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

Import do aplikace TapHomeHardware › Packet Parser › Přidat ze šablony

Stáhnout šablonu
Na této stránce

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ě

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.

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

Hardwarové připojení

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.

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.

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.

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

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í ShellyHodnotaProč
Ochrana heslemSettings → Device settings → AuthenticationVypnutoTapHome nepodporuje HTTP Digest autentizaci. S heslem zobrazí každé zařízení chybu „Shelly asks for a password (HTTP 401)“.
Typ vstupuInput/output settings → input modeSwitchJazýčkový kontakt má stav; s typem Button Shelly nehlásí žádný stav a SW input i Garage door zobrazí chybu.
Režim vstupu/výstupuInput/output settings → output typeDetached SwitchV 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 adresaSettings → Wi-Fi (statická IP) nebo rezervace DHCP v routeru—Šablona oslovuje Shelly podle IP adresy; ta se nesmí měnit.

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í hodnotaVýznam
Invert00: 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ý.
PulseSeconds1Dé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 (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

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ě

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í

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)

Shelly 1 Gen3

Čtení (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
Servisní atributy
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)
Servisní akce
${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 Přepínač
Hodnoty / Stavy: ON · OFF

Relay

Čtení stavu přepínače
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
SENDHTTPREQUEST("/rpc/Switch.Set?id=0&on=" + IF(St, "true", "false"));
SW input Jazýčkový kontakt

SW input

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

Garage door

Čtení stavu přepínače
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
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)
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 aplikaciVýchozí
IP adresa192.168.0.1

Související dokumentace

Našli jste problém s touto šablonou zařízení?

Napište nám, co nefunguje, co chybí, nebo jak by se měla šablona chovat. Vaše zpětná vazba nám pomáhá udržet katalog přesný.

Šablona · portál TapHome Shelly 1 Gen3 Garage Door (Relay, Reed Contact on SW) Otevřete tuto šablonu v zákaznickém portálu a použijte ji ve svém domově, nebo navrhněte úpravu a odešlete ji zpět do katalogu. Packet Parser → HTTP Zobrazit v portálu TapHome