TapHome

Shelly Pro 3

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

A Shelly Pro 3 egy DIN sínre szerelhető 3 csatornás relé modul potenciálmentes érintkezőkkel. Mindhárom független kimenet egyenként 16 A-ig kapcsolhat (összesen 48 A az összes csatornán), ami alkalmassá teszi világítási áramkörök, fűtőelemek vagy háromfázisú terhelések vezérlésére, ahol minden fázis külön kapcsolható. A TapHome HTTP-n kommunikál az eszközzel a Gen2 JSON-RPC 2.0 API-n keresztül a helyi hálózaton — felhőkapcsolat nem szükséges.

A Shelly Pro 3EM-mel ellentétben, amely villamos mérő (csak felügyelet), a Pro 3 egy tisztán relékapcsoló eszköz teljesítménymérési képesség nélkül. Az eszköz WiFi-n, Etherneten (RJ45) vagy Bluetooth-on csatlakozik, és professzionális telepítésre tervezték villamos elosztószekrényekbe.

Konfiguráció

A Shelly Pro 3 WiFi-n vagy Etherneten csatlakozik. A TapHome sablonimport során add meg az eszköz IP-címét (alapértelmezett helyőrző: 192.168.0.1).

A hitelesítést ki kell kapcsolni a Shelly eszközön a TapHome integrációhoz. A TapHome nem támogatja a Gen2 eszközök által használt HTTP Digest Auth hitelesítést. Nyisd meg a Shelly webes felületét (http://{device-ip}) → Settings → Authentication, és győződj meg róla, hogy ki van kapcsolva.

A LAN-kábelt csak az eszköz kikapcsolt állapotában szabad csatlakoztatni vagy eltávolítani. Az Ethernet-kábel menet közbeni csatlakoztatása problémákat okozhat.

Ha az ECO mód be van kapcsolva a Shelly eszközön, kommunikációs időtúllépéseket okozhat a sablon gyors lekérdezési intervallumai (2,5–3 másodperc) miatt. Kapcsold ki az ECO módot a Shelly webes felületén, ha időszakos kapcsolódási problémákat tapasztalsz.

Eszközképességek

Relévezérlés

A sablon három független kapcsolóeszközt tesz elérhetővé, egyet minden relécsatornához. Minden relé állapota a /rpc/Switch.GetStatus?id=N válaszból olvasható (output mező, boolean), és a /rpc/Switch.Set?id=N&on=true vagy on=false végponton vezérelhető, ahol N értéke 0, 1 vagy 2.

Mindhárom csatorna függetlenül működik — lehetnek különböző áramkörökön, különböző AC fázisokon, vagy akár vegyes AC/DC terheléseken. A reléérintkezők potenciálmentesek (száraz érintkezők), így minden kimenet az eszköz saját tápellátásától teljesen elkülönített áramkört kapcsolhat.

Szervizdiagnosztika

A sablon modulszintű szervizattribútumokat biztosít az eszközfelügyelethez:

  • WiFi — a csatlakoztatott SSID neve
  • IP-cím — aktuális állomás IP-cím
  • Jelerősség — WiFi RSSI dB-ben
  • MAC — az eszköz MAC-címe

A modul olvasási szkriptje firmware-frissítések elérhetőségét és függő újraindítási követelményeket is ellenőrzi, amelyeket figyelmeztetésként jelenít meg a TapHome felületén.

Szervizakciók

Két szervizakció érhető el modulszinten:

  • Firmware frissítése — firmware-frissítést indít a legújabb stabil verzióra a /rpc/Shelly.Update végponton
  • Újraindítás — eszköz újraindítást indít a /rpc/Shelly.Reboot végponton
További képességek

A Shelly Pro 3 fizikai kapcsoló-/nyomógomb bemeneti állapotokat (S1, S2, S3) is szolgáltat az Input komponensen keresztül, valamint belső eszközhőmérsékletet, üzemidőt, RAM-használatot, eszközidőt és Ethernet-állapotot az RPC API-n. Auto-off időzítő elérhető a Switch.Set parancs toggle_after paraméterén. Ezek a képességek egy jövőbeli sablonfrissítésben kerülhetnek hozzáadásra.

Hibaelhárítás

Az eszköz nem válaszol
  1. Ellenőrizd, hogy a Shelly csatlakozik a WiFi-hez vagy Ethernethez, és érvényes IP-címe van
  2. Próbáld az mDNS hosztnevet (ShellyPro3-AABBCCDDEE.local) az IP-cím helyett — az IP megváltozhatott DHCP-megújítás után
  3. Nyisd meg a http://{device-ip}/rpc/Shelly.GetDeviceInfo címet a böngészőben — ha JSON-nal válaszol, az eszköz elérhető
  4. Ellenőrizd, hogy a TapHome Core és a Shelly ugyanazon a hálózaton / VLAN-on vannak
  5. Győződj meg róla, hogy a hitelesítés ki van kapcsolva a Shelly eszközön
Csak néhány csatorna reagál
  1. Ellenőrizd, hogy minden csatorna helyesen van címezve (id=0 az 1. kimenethez, id=1 a 2. kimenethez, id=2 a 3. kimenethez)
  2. Ellenőrizd a relé LED-jelzőket az eszköz előlapján — piros LED azt jelenti, hogy a megfelelő relé zárt (BE) állapotban van
  3. Teszteld a nem reagáló csatornát manuálisan a böngészőben: http://{device-ip}/rpc/Switch.Set?id=N&on=true
Induktív terhelési problémák

Induktív terhelésekhez (ventilátorok, transzformátorok, LED-meghajtók) RC tag (0,1 uF / 100 Ohm / 1/2 W / 600 VAC) ajánlott a relékimeneten a feszültségcsúcsok elleni védelem és a relé élettartamának meghosszabbítása érdekében.

A Shelly Gen2 eszközök legfeljebb 6 egyidejű HTTP-kapcsolatot támogatnak. Kerüld a túl sok rendszerből történő egyidejű lekérdezést (TapHome, Home Assistant, egyéni szkriptek), hogy elkerüld a kapcsolatkimerülést.

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 Pro 3 Modul
Szerviz attribútumok
WiFi
IP-cím
Jelerősség
MAC
Szerviz műveletek
Firmware frissítése
Újraindítás
Egyéni változók

Shelly Pro 3

Olvasás (modul)
VAR response := SENDHTTPREQUEST("/rpc/Sys.GetStatus");
IF response.IsSuccess
    Sys.GetStatus := response.Content;
END

response := SENDHTTPREQUEST("/rpc/Sys.GetConfig");
IF response.IsSuccess
    Sys.GetConfig := response.Content;
END

response := SENDHTTPREQUEST("/rpc/WiFi.GetStatus");
IF response.IsSuccess
    WiFi.GetStatus := response.Content;
END

if ! ISNULL(parsejson(Sys.GetStatus, "available_updates.stable", true))
    addwarning("New firmware update is available");
end

if parsejson(Sys.GetStatus, "restart_required", true)
    addwarning("Restart required");
end
Szerviz attribútumok
Wifi
PARSEJSON(WiFi.GetStatus, "ssid")
${ipAddress}
PARSEJSON(WiFi.GetStatus, "sta_ip")
${xml_signal_strength} [dB]
PARSEJSON(WiFi.GetStatus, "rssi")
MAC
PARSEJSON(Sys.GetStatus, "mac")
Szerviz műveletek
${xml_update_fw}
VAR response := SENDHTTPREQUEST("/rpc/Shelly.Update?stage=\"stable\"");
IF response.IsSuccess
    return("OK");
else
    return("Error");
END
Reboot
VAR response := SENDHTTPREQUEST("/rpc/Shelly.Reboot");
IF response.IsSuccess
    return("OK");
else
    return("Error");
END
Kapcsoló 1 Kapcsoló
boolean
Értékek / Állapotok: ON · OFF

Kapcsoló 1

Kapcsoló állapot olvasása
VAR response := SENDHTTPREQUEST("/rpc/Switch.GetStatus?id=" + id);
IF response.IsSuccess
    Switch.GetStatus := response.Content;
END
return(parsejson(Switch.GetStatus, "output"));
Kapcsoló állapot írása
VAR path := "/rpc/Switch.Set?id=" + id + "&on=" + SWITCH(St, 1, "true", "false");
SENDHTTPREQUEST(path);
Kapcsoló 2 Kapcsoló
boolean
Értékek / Állapotok: ON · OFF

Kapcsoló 2

Kapcsoló állapot olvasása
VAR response := SENDHTTPREQUEST("/rpc/Switch.GetStatus?id=" + id);
IF response.IsSuccess
    Switch.GetStatus := response.Content;
END
return(parsejson(Switch.GetStatus, "output"));
Kapcsoló állapot írása
VAR path := "/rpc/Switch.Set?id=" + id + "&on=" + SWITCH(St, 1, "true", "false");
SENDHTTPREQUEST(path);
Kapcsoló 3 Kapcsoló
boolean
Értékek / Állapotok: ON · OFF

Kapcsoló 3

Kapcsoló állapot olvasása
VAR response := SENDHTTPREQUEST("/rpc/Switch.GetStatus?id=" + id);
IF response.IsSuccess
    Switch.GetStatus := response.Content;
END
return(parsejson(Switch.GetStatus, "output"));
Kapcsoló állapot írása
VAR path := "/rpc/Switch.Set?id=" + id + "&on=" + SWITCH(St, 1, "true", "false");
SENDHTTPREQUEST(path);
Kapcsolat: Packet Parser → HTTP
Lehetséges fejlesztések (9)
  • Input 1 State — Physical switch/button input S1 state, available via /rpc/Input.GetStatus?id=0
  • Input 2 State — Physical switch/button input S2 state, available via /rpc/Input.GetStatus?id=1
  • Input 3 State — Physical switch/button input S3 state, available via /rpc/Input.GetStatus?id=2
  • Device Temperature — Internal temperature in °C, available in Switch.GetStatus response (non-metered devices may still report temperature)
  • 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
  • Auto-off Timer — Auto-reset timer in seconds via toggle_after parameter, could be added as switch parameter for all 3 channels
  • Ethernet Status — Pro 3 has RJ45 LAN port; Ethernet status (IP, link) available via /rpc/Ethernet.GetStatus

Források