TapHome

Shelly Plus 1

Packet Parser → HTTP
Beküldő
Utoljára frissítve: 03. 2026
Shelly Plus 1

A Shelly Plus 1 egy kompakt Wi-Fi relés kapcsoló potenciálmentes érintkezőkkel. Elfér egy szabványos fali kapcsoló mögött, és egyetlen áramkört képes vezérelni 16 A-ig (3500 W 230 V AC mellett) vagy 10 A-ig (30 V DC). A készülék széles tápfeszültség-tartományt támogat — 110-240 VAC, 24-48 VDC vagy 12 VDC — így hálózati és kisfeszültségű telepítésekhez egyaránt alkalmas. A TapHome HTTP-n keresztül kommunikál az eszközzel a Gen2+ RPC API segítségével a helyi hálózaton — felhőkapcsolat nem szükséges.

A sablon egyetlen relés kapcsolót biztosít. A Plus 1PM-mel ellentétben ez az eszköz nem rendelkezik beépített teljesítményméréssel.

Konfiguráció

A Shelly Plus 1 Wi-Fi-n keresztül csatlakozik. A TapHome sablonimportálás során adja meg az eszköz IP-címét (alapértelmezett: 192.168.0.1).

Az eszköz a Gen2+ JSON-RPC API-t használja. A teljes kommunikáció HTTP GET kéréseken keresztül történik a /rpc/ végpontokra a 80-as porton.

Eszközképességek

Relévezérlés

A sablon a relét kapcsolóeszközként teszi elérhetővé. A relé állapota a /rpc/Switch.GetStatus?id=0 válaszból olvasható (output mező, boolean), és a /rpc/Switch.Set?id=0 végponton keresztül vezérelhető on=true vagy on=false paraméterrel.

A lekérdezési intervallum 2,5 másodperc, ami közel valós idejű állapotvisszajelzést biztosít a TapHome-ban.

További képességek

A Shelly Plus 1 az RPC API-n keresztül elérhetővé teszi a relé belső hőmérsékletét, a fizikai bemenet állapotát, az eszköz MAC-címét, az üzemidőt, a RAM-kihasználtságot, az eszközidőt, az IP-címet, a Wi-Fi hálózatnevet és a Wi-Fi jelerősséget is. Elérhető egy automatikus kikapcsolási időzítő (toggle_after paraméter) és eszközújraindítás/firmware-frissítés műveletek is. Ezek a képességek egy jövőbeli sablonfrissítésben adhatók hozzá.

A Shelly Plus 1 nem rendelkezik teljesítményméréssel. Ha energiafigyelésre van szüksége, használja helyette a Shelly Plus 1PM-et — azonos méretű és relés képességekkel rendelkezik, de kiegészül pillanatnyi teljesítmény, feszültség, áram és összesített energiafogyasztás méréssel.

Hibaelhárítás

Az eszköz nem válaszol
  1. Ellenőrizze, hogy a Shelly csatlakozik a Wi-Fi-hez és érvényes IP-címmel rendelkezik
  2. Próbálja meg az mDNS hosztnevet (shellyplus1-AABBCCDDEE.local) az IP-cím helyett — az IP megváltozhatott DHCP-megújítás után
  3. Nyissa meg a http://{eszkoz-ip}/rpc/Shelly.GetDeviceInfo címet böngészőben — ha JSON-nal válaszol, az eszköz elérhető
  4. Ellenőrizze, hogy a TapHome CCU és a Shelly azonos hálózaton / VLAN-on vannak
  5. Győződjön meg róla, hogy a HTTP Digest hitelesítés ki van kapcsolva a Shelly webes felületén — a TapHome nem támogatja a hitelesített kéréseket
A relé nem kapcsol
  1. Ellenőrizze a bemeneti módot a Shelly webes felületén (in_mode beállítás) — ha detached-re van állítva, a fizikai kapcsoló nem befolyásolja a relét, de a HTTP parancsoknak továbbra is működniük kell
  2. Kérdezze le manuálisan a /rpc/Switch.GetStatus?id=0 végpontot, és ellenőrizze, hogy az output mező változik-e kapcsoláskor
  3. Ellenőrizze a source mezőt a válaszban, hogy lássa, mi vezérelte utoljára a relét
Lassú válasz vagy időtúllépések
  1. A Gen2+ eszközök legfeljebb 6 egyidejű HTTP-kapcsolatot támogatnak (a Gen1 2-jével szemben) — de kerülje a túlzott lekérdezést több rendszerből
  2. Kapcsolja ki az ECO módot a Shelly webes felületén, ha engedélyezve van — alvó módba helyezi az eszközt a lekérdezések között, ami rövid lekérdezési intervallumoknál időtúllépéseket okozhat
  3. Használjon statikus IP-t vagy DHCP-foglalást a címváltozások elkerülésére

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

Shelly Plus 1 Modul
Egyéni változók
status (string)
Kapcsoló Kapcsoló

Egycsatornás relévezérlés — be/ki kapcsolás RPC API-n

boolean
Értékek / Állapotok: ON · OFF

Kapcsoló

Kapcsoló állapot olvasása
var x := (sendhttprequest("/rpc/Switch.GetStatus?id=0"));
status := x.Content;
return(PARSEJSON(status, "$.output", true));
Kapcsoló állapot írása
VAR response := SENDHTTPREQUEST("rpc/Switch.Set?id=0&on=" + if(St,"true","false"));
IF response.IsSuccess = false
  ADDERROR(response.StatusCode);
END
Kapcsolat: Packet Parser → HTTP
Lehetséges fejlesztések (12)
  • Switch Temperature — Internal relay temperature in °C, available in Switch.GetStatus response
  • Input State — Physical switch/button input state, available via /rpc/Input.GetStatus?id=0
  • MAC Address — Device MAC address, available in Sys.GetStatus response
  • Uptime — Seconds since last reboot, available in Sys.GetStatus response
  • RAM Usage — Total and free RAM in bytes, available in Sys.GetStatus response
  • Device Time — Current device time in HH:MM format, available in Sys.GetStatus response
  • IP Address — Device station IP address, available in WiFi.GetStatus response
  • WiFi SSID — Connected WiFi network name, available in WiFi.GetStatus response
  • WiFi Signal Strength — WiFi RSSI in dBm, available in WiFi.GetStatus response
  • Auto-off Timer — Auto-reset timer in seconds via toggle_after parameter, could be added as switch parameter
  • Reboot — Triggers device reboot, could be added as service action
  • Firmware Update — Initiates OTA firmware update to stable or beta channel

Források