TapHome
Közösség Béta Szenzorok

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

A Shelly 1 Gen3 Wi-Fi relé garázskapu-vezérlőként a TapHome-ban, helyi HTTP-n (Gen2+ RPC API). Az SW bemenetre kötött reed érintkező mutatja, hogy a kapu nyitva vagy zárva van, az I és O kapcsokon lévő potenciálmentes relé pedig csak akkor ad rövid impulzust a kapunyitónak, ha a kapu még nincs a kért állapotban. Emellett egyszerű relékapcsoló, az SW bemenet állapota és Wi-Fi-diagnosztika.

ShellyPacket Parser → HTTP3 eszközRevízió 1.0 Utoljára frissítve: 2026. november 10.

Beküldő Lukáš Štěpán

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

Importálás a TapHome alkalmazásbaHardver › Packet Parser › Hozzáadás sablonból

Sablon letöltése
Ezen az oldalon

Hálózati cím

A TapHome az importáláskor megadott címen éri el az eszközt. Adjon az eszköznek állandó címet — IP-foglalást a routerben, vagy az mDNS-nevét, ha támogatja —, különben az integráció leáll, amikor a router megváltoztatja a címet.

A hálózat előkészítése

Integrációs útmutató

A Shelly 1 Gen3 (S3SW-001X16EU modell) kompakt, egycsatornás Wi-Fi relé potenciálmentes relékontaktussal (I és O kapcsok) és egy kapcsolóbemenettel (SW). 110–240 V~, 24–48 V⎓ vagy stabilizált 12 V⎓ tápellátásról működik, és elfér egy szabványos szerelvénydobozban. A TapHome a helyi hálózaton HTTP-n keresztül olvassa és vezérli a Shelly Gen2+ RPC API segítségével (switch:0 és input:0 komponensek), a Shelly felhő nélkül.

Ez a közösségi sablon garázskapuhoz készült: az SW bemenetre kötött reed érintkező jelzi, hogy a kapu nyitva vagy zárva van, a relé pedig rövid impulzust ad a kapunyitó nyomógomb-bemenetére. Három eszközt biztosít:

  • Relay — a relé egyszerű be/ki kapcsolóként.
  • SW input — az SW bemenet állapota (be = az SW-re kötött érintkező zárva van).
  • Garage door — a kapu állapota a reed érintkező alapján; egy koppintás egy reléimpulzust küld a kapunyitónak, de csak akkor, ha a kapu még nincs a kért állapotban.

A Relay és a Garage door ugyanazt a relét vezérli. Használd az egyiket, a másikat rejtsd el vagy töröld.

Hardveres csatlakoztatás

A telepítést csak minősített villanyszerelő végezheti. Mielőtt bármilyen vezetéket bekötsz vagy módosítasz, kapcsold le a kismegszakítót, és megfelelő feszültségvizsgálóval ellenőrizd, hogy a kapcsokon nincs feszültség. A Shelly B vagy C karakterisztikájú, legfeljebb 16 A-es kismegszakítót ír elő.

Bekötési rajzok

A Shelly minden tápellátáshoz külön bekötési rajzot ad. Mindhárom esetben a terhelés a potenciálmentes O és I relékapcsokon keresztül csatlakozik, a kapcsoló pedig az SW és a tápvezeték közé kerül.

110–240 V~ tápellátás: az L és az N kap tápot, a kapcsoló az SW és az L között van.

A Shelly 1 Gen3 bekötési rajza 110-240 V AC tápellátáshoz: az L és N kapocs táplálva, a kapcsoló az SW és az L között, a terhelés a potenciálmentes O és I kapcsokon keresztül.

24–48 V⎓ tápellátás: a plusz az N-re, a GND az L-re, a kapcsoló az SW és a GND között van.

A Shelly 1 Gen3 bekötési rajza 24-48 V DC tápellátáshoz: a plusz az N-re, a GND az L-re, a kapcsoló az SW és a GND között, a terhelés a potenciálmentes O és I kapcsokon keresztül.

Stabilizált 12 V⎓ tápellátás: a plusz a 12V kapocsra, a GND az L-re, a kapcsoló az SW és a GND között van.

A Shelly 1 Gen3 bekötési rajza stabilizált 12 V DC tápellátáshoz: a plusz a 12V kapocsra, a GND az L-re, a kapcsoló az SW és a GND között, a terhelés az O és I kapcsokon keresztül.

Garázskapu-nyitó az I és O kapcsokon

Kösd a garázskapu-nyitó nyomógomb-kapcsait az I és O relékapcsokra — a rajzokon a lámpa helyére. A relékontaktus potenciálmentes, ezért a nyitó bemenetét nyomógombként kapcsolja, a Shelly tápellátásától függetlenül. Az érintkező terhelhetősége max. 240 V~ / 16 A és max. 30 V⎓ / 10 A.

Reed érintkező az SW bemeneten

Kösd a reed érintkezőt az SW bemenetre ugyanoda, ahol a tápellátásodhoz tartozó bekötési rajzon a kapcsoló van. A sablon alaphelyzetben nyitott reed érintkezőt vár, a mágnessel a zárt kapunál (érintkező zárva = kapu zárva); más elrendezést az Invert változóval kezelhetsz (lásd Konfiguráció).

Az SW nem potenciálmentes bemenet. A Shelly bekötési rajzain az SW-re kötött kapcsoló a tápellátásra csatlakozik: 110–240 V~ tápellátásnál a reed érintkező és a kábele hálózati feszültséget kapcsol (SW az L-re). Használj hálózati feszültségre méretezett érintkezőt és kábelt, vagy tápláld a Shellyt 12 V⎓ vagy 24–48 V⎓ feszültségről, ahol az érintkező az SW-t a GND-re kapcsolja. Mindig a Shelly felhasználói kézikönyvében szereplő bekötési rajzot kövesd.

A csavaros kapcsok 0,2–2,5 mm² keresztmetszetű vezetőket fogadnak (tömör, sodrott vagy érvéghüvelyes), 6–7 mm-es csupaszolással. A Shelly csak beltéri használatra alkalmas, –20 °C és 40 °C között.

Konfiguráció

A Shelly csatlakoztatása a Wi-Fi-hez

A Shelly 1 Gen3 beépített webes felülettel rendelkezik. Az első bekapcsolás után saját hozzáférési pontot nyit Shelly1G3-XXXXXXXXXXXX néven:

  1. Csatlakoztass egy telefont vagy számítógépet a Shelly1G3-XXXXXXXXXXXX Wi-Fi-hálózathoz (alapértelmezetten nyitott).
  2. Nyisd meg a http://192.168.33.1/ címet egy böngészőben.
  3. Lépj a Settings → Wi-Fi menübe, válaszd ki vagy add meg a Wi-Fi-hálózatodat és a jelszavát, majd mentsd. A Shelly a 2,4 GHz-es sávban működik, ezért 2,4 GHz-es hálózatot használj.
  4. Keresd meg a routeredben, milyen IP-címet kapott a Shelly, és nyisd meg a webes felületet a http://<IP address>/ címen.

A hozzáférési pont alapértelmezetten nyitott hálózat. Amint a Shelly csatlakozott a Wi-Fi-hálózatodhoz, a Settings → Access point and Range Extender menüben kikapcsolhatod.

A Shellyt a Shelly Smart Control alkalmazással is felveheted a Wi-Fi-hálózatodra. A TapHome-nak nincs szüksége a Shelly felhőre.

Shelly-beállítások a TapHome-hoz

Ezeket a Shelly webes felületén (http://<IP address>/) állítsd be a sablon importálása előtt:

BeállításHol található a Shelly webes felületénÉrtékMiért
Jelszavas védelemSettings → Device settings → AuthenticationKiA TapHome nem támogatja a HTTP Digest hitelesítést. Jelszó esetén minden eszköz a “Shelly asks for a password (HTTP 401)” hibát mutatja.
Bemenet típusaInput/output settings → input modeSwitchA reed érintkezőnek állapota van; Button típusnál a Shelly nem jelent állapotot, és az SW input és a Garage door hibát mutat.
Bemenet/kimenet módInput/output settings → output typeDetached SwitchA többi módban a reed érintkező minden kapumozgáskor magától kapcsolja a relét. A Garage door figyelmeztetést mutat, amíg a mód nem Detached.
Fix IP-címSettings → Wi-Fi (statikus IP) vagy DHCP-foglalás a routerben—A sablon IP-cím alapján éri el a Shellyt; a cím nem változhat meg.

A Shelly saját Invert bemeneti opcióját hagyd kikapcsolva, és helyette a sablon Invert változóját használd. A Shelly opciója a TapHome által olvasott bemeneti állapotot fordítja meg, így az SW input és a Garage door eszközt egyszerre fordítaná át.

A sablon importálása

A TapHome-ban importáld a sablont, és IP-cím paraméterként add meg a Shelly fix IP-címét (az alapértelmezett 192.168.0.1 csak helyőrző).

A Garage door változói

VáltozóAlapértelmezésJelentés
Invert00: érintkező zárva = kapu Zárva (alaphelyzetben nyitott reed érintkező, a mágnes a zárt kapunál). Állítsd 1-re, ha zárt kapunál az érintkező nyitva van.
PulseSeconds1A reléimpulzus hossza másodpercben. A Shelly magától kapcsolja vissza a relét (toggle_after).

Eszközképességek

Garage door

A kapu állapota az SW bemenetről származik (Input.GetStatus?id=0), 2,5 s-onként lekérdezve, és Nyitva vagy Zárva értékként jelenik meg. A Nyitva vagy Zárva állapotra koppintva a sablon először beolvassa a bemenetet, és csak akkor küldi el a Switch.Set?id=0&on=true&toggle_after=<PulseSeconds> parancsot, ha a kapu még nincs abban az állapotban. Ugyanarra az állapotra való második koppintás, vagy a távirányítóval mozgatott kapu utáni koppintás nem küld semmit. Ha a Shelly nem válaszol a bemenet olvasására, impulzus sem megy ki.

A vezérlőegység újraindítása után a Garage door a Shellyből olvassa be az állapotát, és nem küld semmit (StartupValueSource = olvasás az eszközből). Enélkül az újraindítás alatt mozgatott kaput a rendszer visszamozgatná.

Az eszköz a Shelly kapcsolóbeállításait is beolvassa (Switch.GetConfig?id=0), és figyelmeztetést mutat, amíg a bemeneti mód nem Detached.

Egy bemenet csak két állapotot ad. A „nyitás” és a „zárás” nem jeleníthető meg: a kapu Nyitva állapotot mutat, amint elhagyja a zárt helyzetet.

Relay

A relé be/ki kapcsolóként: az állapotot 2,5 s-onként a Switch.GetStatus?id=0 (output) válaszból olvassa, a kapcsolás a Switch.Set?id=0&on=true vagy on=false paranccsal történik. A vezérlőegység újraindítása után a Relay is a Shellyből olvassa be az állapotát, ahelyett hogy állapotot küldene.

SW input

Az input:0 állapota az Input.GetStatus?id=0 válaszból, 2,5 s-onként lekérdezve — be, ha az SW-re kötött érintkező zárva van. Minden olvasás előtt a sablon ellenőrzi a bemenet típusát (Input.GetConfig?id=0), és hibát mutat, ha az nem Switch.

Moduldiagnosztika és szervizműveletek

A sablon 15 s-onként lekérdezi a modult (Sys.GetStatus, WiFi.GetStatus, Switch.GetStatus), és ezeket a szervizattribútumokat mutatja:

  • Wi-Fi — a csatlakoztatott hálózat neve
  • IP-cím — a Shelly aktuális IP-címe
  • Jelerősség — a Wi-Fi jelerőssége (RSSI)
  • MAC — MAC-cím
  • Hőmérséklet — a Shelly belső hőmérséklete °C-ban

Figyelmeztetést mutat, ha új stabil firmware érhető el, és ha a Shellyt újra kell indítani. Két szervizművelet érhető el: firmware-frissítés a stabil verzióra (Shelly.Update) és újraindítás (Shelly.Reboot).

A Shelly 1 Gen3 nem rendelkezik teljesítménymérővel.

Hibaelhárítás

“Shelly asks for a password (HTTP 401)” minden eszközön

A Shellyben be van kapcsolva a jelszavas védelem. Kapcsold ki a Shelly webes felületén a Settings → Device settings → Authentication menüben.

Az eszközök nem válaszolnak, vagy “Shelly answered HTTP …”

  1. Ellenőrizd, hogy a TapHome-ban megadott IP-cím a Shelly aktuális IP-címe, és hogy a Shelly a hálózaton van.
  2. Ellenőrizd, hogy a Shelly fix IP-címmel rendelkezik (statikus IP vagy DHCP-foglalás), így a cím nem változik meg a router újraindítása után.
  3. Nyisd meg a http://<IP address>/rpc/Sys.GetStatus címet egy böngészőben ugyanazon a hálózaton — ha a Shelly JSON-nal válaszol, elérhető.

“SW input is not of type switch in Shelly” vagy “SW input has no state”

A bemeneti mód Button (vagy más típus). A Shelly bemenet/kimenet beállításaiban állítsd a bemeneti módot Switch értékre.

“Shelly input mode is not Detached” figyelmeztetés a Garage door eszközön

A reed érintkező magától kapcsolja a relét. A Shelly bemenet/kimenet beállításaiban állítsd a kimenet típusát Detached Switch értékre.

A Garage door Nyitva állapotot mutat, pedig a kapu zárva van

Zárt kapunál a reed érintkező nyitva van. Állítsd az Invert változót 1-re.

A kapunyitó nem reagál az impulzusra

Az impulzus túl rövid a nyitónak. Növeld a PulseSeconds értékét. Ellenőrizd azt is, hogy a nyitó nyomógomb-kapcsai az I és O kapcsokra vannak kötve.

A Garage door eszközre koppintva semmi sem történik

A sablon csak akkor küld impulzust, ha a reed érintkező szerint a kapu még nincs a kért állapotban. Nézd meg az SW input eszközt: ha nem változik a kapu mozgásakor, ellenőrizd a reed érintkező bekötését és a mágnes helyzetét.

“New firmware update is available” vagy “Restart required” figyelmeztetés

Használd a modulon a firmware-frissítés vagy az újraindítás szervizműveletet.

Telepítés a TapHome-ban

Előfeltételek

  • Shelly eszköz telepítve és bekapcsolva
  • Helyi Wi-Fi hálózat (2,4 GHz)
  • TapHome CCU ugyanazon a hálózaton

1. lépés — Shelly csatlakoztatása a Wi-Fi-hez

A lehetőség — Shelly alkalmazás (ajánlott):

  1. Töltse le a Shelly alkalmazást (iOS / Android)
  2. Érintse meg a + → Add Device gombot, és kövesse a Bluetooth párosítási varázslót
  3. Adja meg Wi-Fi hitelesítő adatait, amikor a rendszer kéri

B lehetőség — AP mód (alkalmazás nélkül):

  1. Első bekapcsoláskor az eszköz létrehoz egy hotspotot: ShellyXXX-AABBCCDDEE
  2. Csatlakoztassa telefonját/PC-jét ehhez a hotspothoz
  3. Nyissa meg a http://192.168.33.1 címet → Internet & Security → Wi-Fi Mode - Client
  4. Adja meg az SSID-t és a jelszót → Save

A Shelly csak 2,4 GHz-es hálózatokat támogat. Az 5 GHz-es hálózatok nem jelennek meg a keresésben.

2. lépés — IP-cím megkeresése

A Wi-Fi-hez való csatlakozás után az alábbi módszerek egyikével keresse meg a hozzárendelt IP-címet:

  • Shelly alkalmazás: Eszköz részletei → Device info → IP-cím
  • Shelly webes felület: Csatlakozzon az eszköz AP-jához a Wi-Fi beállítás előtt — az IP a mentés után jelenik meg
  • Router DHCP tábla: Keressen egy hasonló hosztnevet: shelly1pm-AABBCCDDEE
  • mDNS: Pingelje a shelly<model>-<mac>.local címet (pl. shelly1pm-AABBCCDDEE.local) ugyanarról a hálózatról

Rendeljen statikus IP-t (DHCP foglalást) a Shelly eszközhöz a routerben, hogy a cím ne változzon a router újraindítása után.

3. lépés — Konfigurálás a TapHome-ban

  1. A TapHome-ban adjon hozzá egy új Packet Parser (HTTP) modult
  2. IP Address: adja meg a 2. lépésben kapott IP-t (pl. 192.168.1.50)
  3. Port: 80 (alapértelmezett, nem kell módosítani)
  4. Importálja a sablont — a TapHome rendszeresen lekérdezi a /status végpontot az eszköz állapotának olvasásához

A HTTP hitelesítés a Shelly eszközökön alapértelmezetten ki van kapcsolva. Ha engedélyezte a bejelentkezésvédelmet, a TapHome jelenleg nem támogatja a HTTP Basic Auth-ot — a TapHome integrációhoz hagyja kikapcsolva a hitelesítést.

Elérhető eszközök 3

Ezek az eszközök az importálás után jelennek meg a TapHome-ban.

Shelly 1 Gen3 Modul
Szerviz attribútumok
Wi-Fi
${ipAddress}
${xml_signal_strength} [dB]
MAC
${temperature} [°C]
Szerviz műveletek
${xml_update_fw}
Reboot
Egyéni változók
SysStatus (string)
WiFiStatus (string)
SwitchStatus (string)

Shelly 1 Gen3

Olvasás (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
Szerviz attribútumok
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)
Szerviz műveletek
${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 Kapcsoló
Értékek / Állapotok: ON · OFF

Relay

Kapcsoló állapot olvasása
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);
Kapcsoló állapot írása
SENDHTTPREQUEST("/rpc/Switch.Set?id=0&on=" + IF(St, "true", "false"));
SW input Reed kontaktus

SW input

Olvasás
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 Kapcsoló
Értékek / Állapotok: Open · Closed
Változó: Invert, Változó: PulseSeconds

Garage door

Kapcsoló állapot olvasása
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);
Kapcsoló állapot írása
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
Olvasás (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
Kapcsolat: Packet Parser → HTTP

Importálási paraméterek

Ezeket az értékeket az XML importálásakor adja meg.

Az alkalmazás kériAlapérték
IP-cím192.168.0.1

Talált problémát ezzel az eszközsablonnal?

Írja meg, mi nem működik, mi hiányzik, vagy hogyan kellene a sablonnak viselkednie. Visszajelzése segít, hogy a katalógus pontos maradjon.

Sablon · TapHome portál Shelly 1 Gen3 Garage Door (Relay, Reed Contact on SW) Nyisd meg ezt a sablont az ügyfélportálon, hogy alkalmazd az otthonaid egyikére, vagy készíts egy módosítást és küldd vissza a katalógusba. Packet Parser → HTTP Megnyitás a TapHome portálon