TapHome
Zajednica Beta Senzori

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

Wi-Fi relej Shelly 1 Gen3 kao upravljanje garažnim vratima u sustavu TapHome preko lokalnog HTTP-a (Gen2+ RPC API). Magnetski kontakt na ulazu SW prikazuje jesu li vrata otvorena ili zatvorena, a beznaponski relej na stezaljkama I i O daje pogonu kratki impuls samo kada vrata već nisu u traženom stanju. Uz to obična sklopka releja, stanje ulaza SW i dijagnostika Wi-Fi veze.

ShellyPacket Parser → HTTP3 uređajaRevizija 1.0 Posljednje ažuriranje: 10. studenoga 2026.

Autor Lukáš Štěpán

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

Uvoz u aplikaciju TapHomeHardver › Packet Parser › Dodaj iz predloška

Preuzmite predložak
Na ovoj stranici

Adresa u mreži

TapHome komunicira s uređajem na adresi unesenoj pri uvozu. Dodijelite uređaju stalnu adresu — rezervaciju IP adrese u usmjerivaču ili njegovo mDNS ime ako ga podržava — inače integracija prestaje raditi kada usmjerivač promijeni adresu.

Priprema mreže

Upute za integraciju

Shelly 1 Gen3 (model S3SW-001X16EU) je kompaktan jednokanalni Wi-Fi relej s beznaponskim kontaktom releja (stezaljke I i O) i jednim ulazom za prekidač (SW). Napaja se s 110–240 V~, 24–48 V⎓ ili stabiliziranih 12 V⎓ i stane u standardnu podžbuknu kutiju. TapHome ga u lokalnoj mreži očitava i njime upravlja preko HTTP-a pomoću Shelly Gen2+ RPC API-ja (komponente switch:0 i input:0), bez oblaka Shelly.

Ovaj predložak zajednice izrađen je za garažna vrata: magnetski kontakt (reed kontakt) na ulazu SW javlja jesu li vrata otvorena ili zatvorena, a relej daje kratki impuls ulazu za tipkalo na pogonu garažnih vrata. Predložak daje tri uređaja:

  • Relay — relej kao obična sklopka za uključivanje i isključivanje.
  • SW input — stanje ulaza SW (uključeno = kontakt na SW je zatvoren).
  • Garage door — stanje vrata iz magnetskog kontakta; dodir šalje jedan impuls releja pogonu, ali samo kada vrata već nisu u traženom stanju.

Relay i Garage door upravljaju istim relejem. Koristite jedan od njih, a drugi sakrijte ili izbrišite.

Hardversko spajanje

Ugradnju mora obaviti ovlašteni električar. Prije spajanja ili mijenjanja bilo kojeg vodiča isključite automatski osigurač i prikladnim ispitivačem napona provjerite da na stezaljkama nema napona. Shelly zahtijeva automatski osigurač karakteristike B ili C, najviše 16 A.

Sheme spajanja

Shelly daje po jednu shemu spajanja za svako napajanje. U sve tri sheme trošilo je spojeno preko beznaponskih stezaljki releja O i I, a prekidač je spojen između SW i vodiča napajanja.

Napajanje 110–240 V~: napajaju se L i N, prekidač je između SW i L.

Shema spajanja Shelly 1 Gen3 za napajanje 110–240 V AC: napajane stezaljke L i N, prekidač između SW i L, trošilo spojeno preko beznaponskih stezaljki O i I.

Napajanje 24–48 V⎓: plus na N, GND na L, prekidač između SW i GND.

Shema spajanja Shelly 1 Gen3 za napajanje 24–48 V DC: plus na N, GND na L, prekidač između SW i GND, trošilo spojeno preko beznaponskih stezaljki O i I.

Stabilizirano napajanje 12 V⎓: plus na stezaljku 12V, GND na L, prekidač između SW i GND.

Shema spajanja Shelly 1 Gen3 za stabilizirano napajanje 12 V DC: plus na stezaljku 12V, GND na L, prekidač između SW i GND, trošilo spojeno preko stezaljki O i I.

Pogon garažnih vrata na I i O

Stezaljke za tipkalo na pogonu garažnih vrata spojite na stezaljke releja I i O — na shemama umjesto žarulje. Kontakt releja je beznaponski, pa ulaz pogona sklapa kao tipkalo, neovisno o napajanju uređaja Shelly. Kontakt je predviđen za najviše 240 V~ / 16 A i najviše 30 V⎓ / 10 A.

Magnetski kontakt na SW

Magnetski kontakt spojite na ulaz SW na isto mjesto kao prekidač na shemi spajanja za vaše napajanje. Predložak očekuje normalno otvoren magnetski kontakt s magnetom na zatvorenim vratima (kontakt zatvoren = vrata zatvorena); drukčiji raspored rješava varijabla Invert (vidi Konfiguracija).

SW nije beznaponski ulaz. Na shemama spajanja Shelly prekidač na SW spojen je na napajanje: s napajanjem 110–240 V~ magnetski kontakt i njegov kabel sklapaju mrežni napon (SW na L). Koristite kontakt i kabel predviđene za mrežni napon ili Shelly napajajte s 12 V⎓ ili 24–48 V⎓, gdje kontakt spaja SW na GND. Uvijek se držite sheme spajanja iz korisničkih uputa za Shelly.

Vijčane stezaljke primaju vodiče presjeka od 0,2 do 2,5 mm² (pune, finožične ili sa završnim čahurama), skinute izolacije 6–7 mm. Shelly je namijenjen samo za unutarnju ugradnju, na temperaturi od –20 °C do 40 °C.

Konfiguracija

Spajanje uređaja Shelly na Wi-Fi

Shelly 1 Gen3 ima ugrađeno web-sučelje. Nakon prvog uključivanja otvara vlastitu pristupnu točku Shelly1G3-XXXXXXXXXXXX:

  1. Telefon ili računalo spojite na Wi-Fi mrežu Shelly1G3-XXXXXXXXXXXX (zadano je otvorena).
  2. U pregledniku otvorite http://192.168.33.1/.
  3. Otvorite Settings → Wi-Fi, odaberite ili upišite svoju Wi-Fi mrežu i njezinu lozinku pa spremite. Shelly radi u pojasu 2,4 GHz, pa koristite mrežu od 2,4 GHz.
  4. U routeru pronađite IP adresu koju je Shelly dobio i otvorite web-sučelje na http://<IP address>/.

Pristupna točka zadano je otvorena mreža. Kad je Shelly spojen na vašu Wi-Fi mrežu, pristupnu točku možete isključiti u Settings → Access point and Range Extender.

Shelly se na Wi-Fi mrežu može dodati i aplikacijom Shelly Smart Control. TapHome ne treba oblak Shelly.

Postavke uređaja Shelly za TapHome

Prije uvoza predloška u web-sučelju Shelly (http://<IP address>/) postavite sljedeće:

PostavkaGdje u web-sučelju ShellyVrijednostZašto
Zaštita lozinkomSettings → Device settings → AuthenticationIsključenoTapHome ne podržava HTTP Digest autentifikaciju. S lozinkom svaki uređaj prikazuje pogrešku „Shelly asks for a password (HTTP 401)”.
Vrsta ulazaInput/output settings → input modeSwitchMagnetski kontakt ima stanje; s vrstom Button Shelly ne javlja stanje, a SW input i Garage door prikazuju pogrešku.
Način rada ulaza/izlazaInput/output settings → output typeDetached SwitchU ostalim načinima rada magnetski kontakt sam sklapa relej pri svakom pomaku vrata. Garage door prikazuje upozorenje dok način rada nije Detached.
Fiksna IP adresaSettings → Wi-Fi (statička IP adresa) ili DHCP rezervacija u routeru—Predložak se uređaju Shelly obraća preko IP adrese, pa se ona ne smije mijenjati.

Vlastitu opciju ulaza Invert u uređaju Shelly ostavite isključenu, a umjesto nje koristite varijablu predloška Invert. Opcija u uređaju Shelly obrće stanje ulaza koje TapHome čita, pa bi zajedno obrnula SW input i Garage door.

Uvoz predloška

U sustavu TapHome uvezite predložak i kao parametar IP adrese unesite fiksnu IP adresu uređaja Shelly (zadana vrijednost 192.168.0.1 samo je rezervirano mjesto).

Varijable uređaja Garage door

VarijablaZadanoZnačenje
Invert00: kontakt zatvoren = vrata Closed (normalno otvoren magnetski kontakt s magnetom na zatvorenim vratima). Postavite 1 kada je kontakt otvoren dok su vrata zatvorena.
PulseSeconds1Trajanje impulsa releja u sekundama. Shelly sam vraća relej (toggle_after).

Mogućnosti uređaja

Garage door

Stanje vrata dolazi s ulaza SW (Input.GetStatus?id=0), očitava se svakih 2,5 s i prikazuje kao Open (otvoreno) ili Closed (zatvoreno). Dodir na Open ili Closed najprije očita ulaz i pošalje Switch.Set?id=0&on=true&toggle_after=<PulseSeconds> samo kada vrata već nisu u tom stanju. Drugi dodir na isto stanje ili dodir nakon što su vrata pomaknuta daljinskim upravljačem ne šalje ništa. Ako Shelly ne odgovori na očitavanje ulaza, ni impuls se ne šalje.

Nakon ponovnog pokretanja centralne jedinice Garage door čita stanje iz uređaja Shelly i ne šalje ništa (StartupValueSource = čitanje iz uređaja). Bez toga bi se vrata pomaknuta tijekom ponovnog pokretanja vratila natrag.

Uređaj čita i postavke sklopke Shelly (Switch.GetConfig?id=0) i prikazuje upozorenje dok način rada ulaza nije Detached.

Jedan ulaz daje samo dva stanja. „Otvaranje” i „zatvaranje” ne mogu se prikazati: vrata pokazuju Open čim napuste zatvoreni položaj.

Relay

Relej kao sklopka za uključivanje i isključivanje: stanje se čita iz Switch.GetStatus?id=0 (output) svakih 2,5 s, a relej se sklapa naredbom Switch.Set?id=0&on=true ili on=false. Nakon ponovnog pokretanja centralne jedinice i Relay čita stanje iz uređaja Shelly umjesto da ga šalje.

SW input

Stanje komponente input:0 iz Input.GetStatus?id=0, očitava se svakih 2,5 s — uključeno kada je kontakt na SW zatvoren. Prije svakog očitavanja predložak provjerava vrstu ulaza (Input.GetConfig?id=0) i prikazuje pogrešku kada to nije Switch.

Dijagnostika modula i servisne radnje

Modul se očitava svakih 15 s (Sys.GetStatus, WiFi.GetStatus, Switch.GetStatus) i prikazuje ove servisne atribute:

  • Wi-Fi — naziv spojene mreže
  • IP adresa — trenutačna IP adresa uređaja Shelly
  • Jačina signala — jačina Wi-Fi signala (RSSI)
  • MAC — MAC adresa
  • Temperatura — unutarnja temperatura uređaja Shelly u °C

Prikazuje upozorenje kada je dostupan novi stabilni firmver i kada Shelly treba ponovno pokrenuti. Dostupne su dvije servisne radnje: Ažuriranje firmvera na stabilnu verziju (Shelly.Update) i Reboot (Shelly.Reboot).

Shelly 1 Gen3 nema mjerenje snage.

Rješavanje problema

„Shelly asks for a password (HTTP 401)” na svim uređajima

U uređaju Shelly uključena je zaštita lozinkom. Isključite je u web-sučelju Shelly u Settings → Device settings → Authentication.

Uređaji ne odgovaraju ili „Shelly answered HTTP …”

  1. Provjerite je li IP adresa u sustavu TapHome trenutačna IP adresa uređaja Shelly i je li Shelly u mreži.
  2. Provjerite ima li Shelly fiksnu IP adresu (statičku IP adresu ili DHCP rezervaciju), kako se adresa ne bi promijenila nakon ponovnog pokretanja routera.
  3. U pregledniku na istoj mreži otvorite http://<IP address>/rpc/Sys.GetStatus — ako Shelly odgovori u obliku JSON, dostupan je.

„SW input is not of type switch in Shelly” ili „SW input has no state”

Način rada ulaza je Button (ili druga vrsta). U postavkama ulaza i izlaza uređaja Shelly postavite način rada ulaza na Switch.

Upozorenje „Shelly input mode is not Detached” na uređaju Garage door

Magnetski kontakt sam sklapa relej. U postavkama ulaza i izlaza uređaja Shelly postavite vrstu izlaza na Detached Switch.

Garage door pokazuje Open iako su vrata zatvorena

Magnetski kontakt je otvoren dok su vrata zatvorena. Postavite varijablu Invert na 1.

Pogon ne reagira na impuls

Impuls je za pogon prekratak. Povećajte PulseSeconds. Provjerite i jesu li stezaljke za tipkalo na pogonu spojene na I i O.

Dodir na Garage door ne radi ništa

Predložak šalje impuls samo kada vrata prema magnetskom kontaktu već nisu u traženom stanju. Provjerite uređaj SW input: ako se ne mijenja kada se vrata pomiču, provjerite ožičenje magnetskog kontakta i položaj magneta.

Upozorenja „New firmware update is available” ili „Restart required”

Na modulu upotrijebite servisnu radnju Ažuriranje firmvera ili Reboot.

Kako ga instalirati u TapHome

Preduvjeti

  • Uređaj Shelly ugrađen i uključen
  • Lokalna Wi-Fi mreža (2,4 GHz)
  • TapHome CCU u istoj mreži

Korak 1 — Spojite Shelly na Wi-Fi

Opcija A — aplikacija Shelly (preporučeno):

  1. Preuzmite aplikaciju Shelly (iOS / Android)
  2. Dodirnite + → Add Device i slijedite čarobnjak za uparivanje preko Bluetootha
  3. Kada se to zatraži, unesite podatke za prijavu na Wi-Fi

Opcija B — način rada AP (bez aplikacije):

  1. Pri prvom uključivanju uređaj stvara pristupnu točku: ShellyXXX-AABBCCDDEE
  2. Spojite telefon ili računalo na tu pristupnu točku
  3. Otvorite http://192.168.33.1 → Internet & Security → Wi-Fi Mode - Client
  4. Unesite SSID i lozinku → Save

Shelly podržava samo mreže od 2,4 GHz. Mreže od 5 GHz neće se prikazati pri skeniranju.

Korak 2 — Pronađite adresu uređaja

Uređaji Shelly Gen1 podržavaju mDNS (Zeroconf). Uređaju možete pristupiti preko naziva hosta umjesto IP adrese:

1
shelly<model>-<MAC>.local

Na primjer: shelly1pm-AABBCCDDEE.local (MAC adresa velikim slovima u heksadecimalnom zapisu, bez dvotočaka).

Preporučeno: koristite IP skener TapHome. Otvorite aplikaciju TapHome i pokrenite IP skener (Postavke → Mreža → Skeniranje). Skener pronalazi uređaje u vašoj mreži i prikazuje IP adresu i mDNS naziv hosta. Za pouzdaniju vezu koristite naziv hosta umjesto IP adrese, jer ostaje isti i kada se IP adresa uređaja promijeni nakon ponovnog pokretanja usmjerivača.

Drugi načini za pronalaženje IP adrese:

  • Aplikacija Shelly: detalji uređaja → Device info → IP adresa
  • Web-sučelje Shelly: spojite se na AP uređaja prije postavljanja Wi-Fi mreže — IP adresa prikazuje se nakon spremanja
  • DHCP tablica usmjerivača: potražite naziv hosta poput shelly1pm-AABBCCDDEE

Korak 3 — Konfiguracija u sustavu TapHome

  1. U sustavu TapHome dodajte novi modul Packet Parser (HTTP)
  2. Adresa: unesite mDNS naziv hosta (npr. shelly1pm-AABBCCDDEE.local) ili IP adresu iz koraka 2
  3. Port: 80 (zadano, nije potrebno mijenjati)
  4. Uvezite predložak — TapHome će čitati /status kako bi očitao stanje uređaja

HTTP autentifikacija na uređajima Shelly zadano je isključena. Ako ste uključili zaštitu prijavom, TapHome trenutačno ne podržava HTTP Basic Auth — za integraciju sa sustavom TapHome ostavite autentifikaciju isključenom.

Dostupni uređaji 3

Ovi se uređaji pojavljuju u TapHomeu nakon uvoza.

Shelly 1 Gen3 Modul
Servisni atributi
Wi-Fi
${ipAddress}
${xml_signal_strength} [dB]
MAC
${temperature} [°C]
Servisne radnje
${xml_update_fw}
Reboot
Prilagođene varijable
SysStatus (string)
WiFiStatus (string)
SwitchStatus (string)

Shelly 1 Gen3

Čitanje (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
Servisni atributi
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)
Servisne radnje
${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 Sklopka
Vrijednosti / stanja: ON · OFF

Relay

Čitanje stanja sklopke
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);
Zapis stanja sklopke
SENDHTTPREQUEST("/rpc/Switch.Set?id=0&on=" + IF(St, "true", "false"));
SW input Magnetski kontakt

SW input

Čitanje
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 Sklopka
Vrijednosti / stanja: Open · Closed
Varijabla: Invert, Varijabla: PulseSeconds

Garage door

Čitanje stanja sklopke
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);
Zapis stanja sklopke
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
Čitanje (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
Povezivanje: Packet Parser → HTTP

Parametri uvoza

Ove vrijednosti unosite pri uvozu XML-a.

Pitanje u aplikacijiZadano
IP adresa192.168.0.1

Pronašli ste problem s ovim predloškom uređaja?

Recite nam što ne radi, što nedostaje ili kako bi se predložak trebao ponašati. Vaše povratne informacije pomažu nam da katalog bude točan.

Predložak · TapHome portal Shelly 1 Gen3 Garage Door (Relay, Reed Contact on SW) Otvorite ovaj predložak na portalu Customer Portal kako biste ga primijenili na jedan od svojih domova ili predložili poboljšanje i poslali ga natrag u katalog. Packet Parser → HTTP Pogledaj u TapHome portalu