--- title: "Shelly 1 Gen3 Garage Door (Relay, Reed Contact on SW)" description: "Shelly 1 Gen3 cez lokálne HTTP ako ovládanie garážových dverí: stav z jazýčkového kontaktu na SW, impulz pre pohon z relé. Bez hesla, režim Detached." url: "https://taphome.com/sk/compatibility/shelly-1-gen3-http/" language: sk lastmod: 2026-11-10 generator: hugo ai: topics: ["http","wifi","garage-door","relay","reed-contact","door-sensor","i/o-module","sensor"] questions: ["Ako integrovať Shelly 1 Gen3 ako ovládanie garážových dverí s TapHome?","Čo ovláda a číta šablóna TapHome pre garážové dvere so Shelly 1 Gen3?","Ako pripojiť pohon garážových dverí a jazýčkový kontakt k Shelly 1 Gen3?","Je vstup SW na Shelly 1 Gen3 bezpotenciálový?","Ktoré nastavenia Shelly sú potrebné pre TapHome: heslo, režim vstupu a režim Detached?","Prečo TapHome ukazuje garážové dvere ako otvorené, hoci sú zatvorené?","Ako zmeniť dĺžku impulzu relé pre pohon garážových dverí?","Prečo TapHome zobrazuje „Shelly asks for a password (HTTP 401)“?"] --- # Shelly 1 Gen3 Garage Door (Relay, Reed Contact on SW) Komunikácia: Packet Parser → HTTP > Adresa v sieti > > TapHome komunikuje so zariadením na adrese zadanej pri importe. Dajte zariadeniu stálu adresu — rezerváciu IP v routeri, alebo jeho mDNS meno, ak ho podporuje —, inak integrácia prestane fungovať, keď router adresu zmení. > > [Príprava siete](https://taphome.com/sk/docs/setup/network-preparation/) ## Návod na integráciu Shelly 1 Gen3 (model S3SW-001X16EU) je kompaktné jednokanálové Wi-Fi relé s bezpotenciálovým kontaktom relé (svorky **I** a **O**) a jedným vstupom pre spínač (**SW**). Napája sa z 110–240 V~, 24–48 V⎓ alebo zo stabilizovaného zdroja 12 V⎓ a zmestí sa do štandardnej inštalačnej krabice. TapHome ho číta a ovláda cez HTTP v lokálnej sieti pomocou Shelly Gen2+ RPC API (komponenty `switch:0` a `input:0`), bez cloudu Shelly. Táto komunitná šablóna je určená pre garážové dvere: jazýčkový kontakt na SW hlási, či sú dvere otvorené alebo zatvorené, a relé dáva vstupu tlačidla pohonu dverí krátky impulz. Poskytuje tri zariadenia: - **Relay** — relé ako obyčajný spínač zap/vyp. - **SW input** — stav vstupu SW (zapnuté = kontakt na SW je zopnutý). - **Garage door** — stav dverí z jazýčkového kontaktu; ťuknutie pošle pohonu jeden impulz relé, ale len vtedy, keď dvere ešte nie sú v požadovanom stave. > [!NOTE] > Relay a Garage door ovládajú to isté relé. Použite jedno z nich a druhé skryte alebo vymažte. ## Hardvérové pripojenie > [!WARNING] > Inštaláciu musí vykonať certifikovaný elektrikár. Pred pripájaním alebo zmenou akýchkoľvek vodičov vypnite istič a vhodnou skúšačkou overte, že na svorkách nie je napätie. Shelly vyžaduje istič s charakteristikou B alebo C, max. 16 A. ### Schémy zapojenia Shelly uvádza jednu schému zapojenia pre každé napájanie. Vo všetkých troch je záťaž pripojená cez bezpotenciálové svorky relé **O** a **I** a spínač je zapojený medzi **SW** a napájací vodič. Napájanie 110–240 V~: L a N pod napätím, spínač medzi SW a L. ![Schéma zapojenia Shelly 1 Gen3 pre napájanie 110–240 V AC: svorky L a N pod napätím, spínač medzi SW a L, záťaž zapojená cez bezpotenciálové svorky O a I.](https://taphome.com/images/compatibility/shelly-1-gen3-http/wiring-ac_hu_d66b4612c062a05b.jpg) Napájanie 24–48 V⎓: plus na N, GND na L, spínač medzi SW a GND. ![Schéma zapojenia Shelly 1 Gen3 pre napájanie 24–48 V DC: plus na N, GND na L, spínač medzi SW a GND, záťaž zapojená cez bezpotenciálové svorky O a I.](https://taphome.com/images/compatibility/shelly-1-gen3-http/wiring-dc-24-48v_hu_9d7ec3968564d1b0.jpg) Stabilizované napájanie 12 V⎓: plus na svorku 12V, GND na L, spínač medzi SW a GND. ![Schéma zapojenia Shelly 1 Gen3 pre stabilizované napájanie 12 V DC: plus na svorku 12V, GND na L, spínač medzi SW a GND, záťaž zapojená cez svorky O a I.](https://taphome.com/images/compatibility/shelly-1-gen3-http/wiring-dc-12v_hu_bb0aaf79a96be915.jpg) ### Pohon garážových dverí na I a O Svorky tlačidla pohonu garážových dverí pripojte na svorky relé **I** a **O** — v schémach namiesto žiarovky. Kontakt relé je bezpotenciálový, takže spína vstup pohonu ako tlačidlo, nezávisle od napájania Shelly. Kontakt je dimenzovaný na max. 240 V~ / 16 A a max. 30 V⎓ / 10 A. ### Jazýčkový kontakt na SW Jazýčkový kontakt pripojte na vstup **SW** na rovnaké miesto ako spínač v schéme zapojenia pre vaše napájanie. Šablóna očakáva spínací (NO) jazýčkový kontakt s magnetom pri zatvorených dverách (kontakt zopnutý = dvere zatvorené); iné usporiadanie rieši premenná `Invert` (pozri Konfigurácia). > [!WARNING] > SW **nie je** bezpotenciálový vstup. V schémach zapojenia Shelly je spínač na SW pripojený na napájanie: pri napájaní 110–240 V~ jazýčkový kontakt a jeho kábel spínajú **sieťové napätie** (SW na L). Použite kontakt a kábel dimenzované na sieťové napätie, alebo napájajte Shelly z 12 V⎓ či 24–48 V⎓, kde kontakt spína SW na GND. Vždy sa riaďte schémou zapojenia v používateľskej príručke Shelly. Skrutkové svorky prijmú vodiče s prierezom 0,2 až 2,5 mm² (plné, lanké alebo s dutinkami), odizolované na 6–7 mm. Shelly je určené len na použitie vo vnútri, pri teplote –20 °C až 40 °C. ## Konfigurácia ### Pripojenie Shelly na Wi-Fi Shelly 1 Gen3 má zabudované webové rozhranie. Po prvom zapnutí otvorí vlastný prístupový bod `Shelly1G3-XXXXXXXXXXXX`: 1. Pripojte telefón alebo počítač k Wi-Fi sieti `Shelly1G3-XXXXXXXXXXXX` (predvolene otvorená). 2. V prehliadači otvorte `http://192.168.33.1/`. 3. Prejdite do **Settings → Wi-Fi**, vyberte alebo zadajte svoju Wi-Fi sieť a jej heslo a uložte. Shelly pracuje v pásme 2,4 GHz, preto použite sieť 2,4 GHz. 4. V routeri nájdite IP adresu, ktorú Shelly dostalo, a otvorte webové rozhranie na `http:///`. Prístupový bod je predvolene otvorená sieť. Keď je Shelly pripojené k vašej Wi-Fi, prístupový bod sa dá vypnúť v **Settings → Access point and Range Extender**. Shelly sa dá pridať do Wi-Fi aj aplikáciou Shelly Smart Control. TapHome cloud Shelly nepotrebuje. ### Nastavenia Shelly pre TapHome Pred importom šablóny nastavte vo webovom rozhraní Shelly (`http:///`): | Nastavenie | Kde vo webovom rozhraní Shelly | Hodnota | Prečo | |---|---|---|---| | Ochrana heslom | **Settings → Device settings → Authentication** | Vypnutá | TapHome nepodporuje HTTP Digest autentifikáciu. S heslom zobrazí každé zariadenie chybu „Shelly asks for a password (HTTP 401)“. | | Typ vstupu | **Input/output settings → input mode** | **Switch** | Jazýčkový kontakt má stav; pri type Button Shelly nehlási žiadny stav a SW input aj Garage door zobrazia chybu. | | Režim vstupu/výstupu | **Input/output settings → output type** | **Detached Switch** | V ostatných režimoch jazýčkový kontakt sám prepne relé pri každom pohybe dverí. Garage door zobrazuje varovanie, kým režim nie je Detached. | | Pevná IP adresa | **Settings → Wi-Fi** (statická IP) alebo rezervácia DHCP v routeri | — | Šablóna oslovuje Shelly podľa IP adresy; tá sa nesmie meniť. | > [!TIP] > Vlastnú voľbu vstupu Shelly **Invert** nechajte vypnutú a namiesto nej použite premennú šablóny `Invert`. Voľba v Shelly invertuje stav vstupu, ktorý TapHome číta, takže by otočila SW input aj Garage door naraz. ### Import šablóny V TapHome importujte šablónu a ako parameter IP adresy zadajte pevnú IP adresu Shelly (predvolená `192.168.0.1` je len zástupná hodnota). ### Premenné Garage door | Premenná | Predvolená hodnota | Význam | |---|---|---| | `Invert` | `0` | `0`: kontakt zopnutý = stav **Zatvorené** (spínací jazýčkový kontakt s magnetom pri zatvorených dverách). Nastavte `1`, keď je kontakt pri zatvorených dverách rozopnutý. | | `PulseSeconds` | `1` | Dĺžka impulzu relé v sekundách. Shelly prepne relé späť samo (`toggle_after`). | ## Možnosti zariadenia ### Garage door Stav dverí pochádza zo vstupu SW (`Input.GetStatus?id=0`), dotazuje sa každých 2,5 s a zobrazuje sa ako **Otvorené** alebo **Zatvorené**. Ťuknutie na Otvorené alebo Zatvorené najprv prečíta vstup a `Switch.Set?id=0&on=true&toggle_after=` pošle, len keď dvere ešte nie sú v danom stave. Druhé ťuknutie na ten istý stav alebo ťuknutie po tom, čo dvere pohol diaľkový ovládač, nepošle nič. Ak Shelly na čítanie vstupu neodpovie, impulz sa tiež nepošle. Po reštarte riadiacej jednotky Garage door prečíta svoj stav zo Shelly a nič nepošle (`StartupValueSource` = čítať zo zariadenia). Bez toho by sa dvere, ktoré sa počas reštartu pohli, vrátili späť. Zariadenie číta aj nastavenia spínača Shelly (`Switch.GetConfig?id=0`) a zobrazuje varovanie, kým režim vstupu nie je Detached. Jeden vstup dáva len dva stavy. „Otvára sa“ a „zatvára sa“ sa zobraziť nedá: dvere ukazujú Otvorené hneď, ako opustia zatvorenú polohu. ### Relay Relé ako spínač zap/vyp: stav sa číta zo `Switch.GetStatus?id=0` (`output`) každých 2,5 s a prepína sa cez `Switch.Set?id=0&on=true` alebo `on=false`. Po reštarte riadiacej jednotky Relay tiež prečíta svoj stav zo Shelly, namiesto toho aby ho poslal. ### SW input Stav `input:0` z `Input.GetStatus?id=0`, dotazovaný každých 2,5 s — zapnutý, keď je kontakt na SW zopnutý. Pred každým čítaním šablóna skontroluje typ vstupu (`Input.GetConfig?id=0`) a zobrazí chybu, keď to nie je Switch. ### Diagnostika modulu a servisné akcie Modul sa dotazuje každých 15 s (`Sys.GetStatus`, `WiFi.GetStatus`, `Switch.GetStatus`) a zobrazuje tieto servisné atribúty: - **Wi-Fi** — názov pripojenej siete - **IP adresa** — aktuálna IP adresa Shelly - **Sila signálu** — sila Wi-Fi signálu (RSSI) - **MAC** — MAC adresa - **Teplota** — vnútorná teplota Shelly v °C Zobrazí varovanie, keď je dostupný nový stabilný firmvér a keď Shelly potrebuje reštart. K dispozícii sú dve servisné akcie: **aktualizácia firmvéru** na stabilnú verziu (`Shelly.Update`) a **reštart** (`Shelly.Reboot`). Shelly 1 Gen3 nemá merač výkonu. ## Riešenie problémov ### „Shelly asks for a password (HTTP 401)“ na všetkých zariadeniach V Shelly je zapnutá ochrana heslom. Vypnite ju vo webovom rozhraní Shelly v **Settings → Device settings → Authentication**. ### Zariadenia neodpovedajú alebo „Shelly answered HTTP …“ 1. Overte, že IP adresa v TapHome je aktuálna IP adresa Shelly a že Shelly je v sieti. 2. Overte, že Shelly má pevnú IP adresu (statická IP alebo rezervácia DHCP), aby sa adresa po reštarte routera nezmenila. 3. V prehliadači v tej istej sieti otvorte `http:///rpc/Sys.GetStatus` — ak Shelly odpovie JSON-om, je dostupné. ### „SW input is not of type switch in Shelly“ alebo „SW input has no state“ Režim vstupu je Button (alebo iný typ). V nastaveniach vstupu/výstupu Shelly nastavte režim vstupu na **Switch**. ### Varovanie „Shelly input mode is not Detached“ na Garage door Jazýčkový kontakt sám prepína relé. V nastaveniach vstupu/výstupu Shelly nastavte typ výstupu na **Detached Switch**. ### Garage door ukazuje Otvorené, hoci sú dvere zatvorené Jazýčkový kontakt je pri zatvorených dverách rozopnutý. Nastavte premennú `Invert` na `1`. ### Pohon nereaguje na impulz Impulz je pre pohon príliš krátky. Zvýšte `PulseSeconds`. Overte tiež, že svorky tlačidla pohonu sú pripojené na I a O. ### Ťuknutie na Garage door nič neurobí Šablóna pošle impulz, len keď dvere podľa jazýčkového kontaktu ešte nie sú v požadovanom stave. Skontrolujte zariadenie SW input: ak sa pri pohybe dverí nemení, skontrolujte zapojenie jazýčkového kontaktu a polohu magnetu. ### Varovania „New firmware update is available“ alebo „Restart required“ Použite na module servisnú akciu **aktualizácia firmvéru** alebo **reštart**. ## Ako nainštalovať v TapHome ### Predpoklady - Zariadenie Shelly nainštalované a zapnuté - Lokálna Wi-Fi sieť (2,4 GHz) - TapHome CCU v rovnakej sieti ### Krok 1 — Pripojte Shelly k Wi-Fi **Možnosť A — Aplikácia Shelly (odporúčané):** 1. Stiahnite si [aplikáciu Shelly](https://www.shelly.com/en/support/shelly-app) (iOS / Android) 2. Klepnite na **+** → **Add Device** a postupujte podľa sprievodcu Bluetooth párovaním 3. Po výzve zadajte svoje Wi-Fi prihlasovacie údaje **Možnosť B — AP režim (bez aplikácie):** 1. Pri prvom zapnutí zariadenie vytvorí hotspot: `ShellyXXX-AABBCCDDEE` 2. Pripojte telefón/PC k tomuto hotspotu 3. Otvorte `http://192.168.33.1` → **Internet & Security** → **Wi-Fi Mode - Client** 4. Zadajte SSID a heslo → **Save** > [!NOTE] > Shelly podporuje iba **2,4 GHz** siete. 5 GHz siete sa pri skenovaní nezobrazia. ### Krok 2 — Zistite IP adresu Po pripojení k Wi-Fi zistite priradenú IP adresu jedným z nasledujúcich spôsobov: - **Aplikácia Shelly:** Detail zariadenia → **Device info** → IP adresa - **Webové rozhranie Shelly:** Pripojte sa k AP zariadenia pred nastavením Wi-Fi — IP sa zobrazí po uložení - **DHCP tabuľka routera:** Hľadajte hostname ako `shelly1pm-AABBCCDDEE` - **mDNS:** Pingnite `shelly-.local` (napr. `shelly1pm-AABBCCDDEE.local`) z rovnakej siete > [!TIP] > Priraďte zariadeniu Shelly **statickú IP** (DHCP rezerváciu) vo vašom routeri, aby sa adresa nezmenila po reštarte routera. ### Krok 3 — Konfigurácia v TapHome 1. V TapHome pridajte nový modul **Packet Parser (HTTP)** 2. **IP Address:** zadajte IP z kroku 2 (napr. `192.168.1.50`) 3. **Port:** `80` (predvolený, nie je potrebné meniť) 4. Importujte šablónu — TapHome bude pravidelne čítať `/status` pre zistenie stavu zariadenia > [!NOTE] > HTTP autentifikácia je na zariadeniach Shelly štandardne vypnutá. Ak ste povolili ochranu prihlásením, TapHome momentálne nepodporuje HTTP Basic Auth — pre integráciu s TapHome ponechajte autentifikáciu vypnutú. ## Dostupné zariadenia 3 Tieto zariadenia sa po importe zobrazia v TapHome. Shelly 1 Gen3 Modul Servisné atribúty | | |--------------------------------| | Wi-Fi | | ${ipAddress} | | ${xml\_signal\_strength} \[dB] | | MAC | | ${temperature} \[°C] | Servisné akcie | | |--------------------| | ${xml\_update\_fw} | | Reboot | Vlastné premenné | | |-------------------------| | `SysStatus` (string) | | `WiFiStatus` (string) | | `SwitchStatus` (string) | Čítanie (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é atribúty 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é akcie ${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 Prepínač Hodnoty / Stavy: ON · OFF Čítanie stavu prepínača ```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 prepínača ```taphome SENDHTTPREQUEST("/rpc/Switch.Set?id=0&on=" + IF(St, "true", "false")); ``` SW input Jazýčkový kontakt Čítanie ```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 Prepínač Hodnoty / Stavy: Open · Closed Premenná: `Invert`, Premenná: `PulseSeconds` Čítanie stavu prepínača ```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 prepínača ```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 ``` Čítanie (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 ``` **Pripojenie:** Packet Parser → HTTP ## Parametre importu Tieto hodnoty zadáte pri importe XML. | Pýta sa v aplikácii | Predvolené | |---------------------|---------------| | IP adresa | `192.168.0.1` | ## Súvisiaca dokumentácia - [Integrácia Packet Parser](https://taphome.com/sk/compatibility/packet-parser-guide/) - [Packet Parser (HTTP, TCP, UDP, FTP, MQTT)](https://taphome.com/sk/docs/integration/packet-parser/) - [Funkcie Packet parsera](https://taphome.com/sk/docs/script/packet-parser/) - [Parsovacie funkcie](https://taphome.com/sk/docs/script/parsing-functions/)