Shelly 1PM

Packet Parser → HTTP

Submitted by

Last updated: 03. 2026

A Shelly 1PM egy kompakt Wi-Fi relé kapcsoló beépített teljesítménymérővel. Elfér egy hagyományos falba süllyesztett kapcsoló mögött, és egy áramkört képes vezérelni, akár 16 A terheléssel (230 V-on 3500 W). A TapHome HTTP-n keresztül kommunikál az eszközzel a helyi hálózaton – nincs szükség felhőkapcsolatra.

A sablon relévezérlést és energiamérőt biztosít, amely valós idejű fogyasztást és összesített energiafelhasználást olvas.

Konfiguráció

A Shelly 1PM Wi-Fi-n keresztül csatlakozik. A TapHome sablon importálásakor add meg az eszköz IP-címét (alapértelmezett helyőrző: 192.168.0.1).

Ez az eszköz támogatja az mDNS felfedezést. A TapHome konfigurálásához IP-cím helyett használhatod a shelly1pm-{MAC}.local állomásnevet. A {MAC} helyére az eszköz MAC-címét írd (nagybetűs hexadecimális, kettőspontok nélkül). Az állomásnév használatával elkerülhetők a csatlakozási problémák, amelyek akkor lépnek fel, ha az eszköz IP-címe megváltozik.

Nyisd meg a TapHome alkalmazást, és használd az IP-szkenner funkciót (Beállítások → Hálózat → Szkennelés). A szkenner megkeresi a hálózaton lévő eszközöket, és megmutatja az IP-címet és az mDNS állomásnevet is (pl. shelly1pm-AABBCCDDEE.local). Megbízhatóbb kapcsolathoz használd az állomásnevet az IP-cím helyett.

Eszközképességek

Relévezérlés

A sablon a reléet kapcsolóeszközként teszi elérhetővé. A relé állapotát a /status válaszból olvassa (relays[0].ison), vezérlése a /relay/0 végponton keresztül történik turn=on vagy turn=off paraméterrel.

Teljesítménymérés

A beépített energiamérő két értéket olvas a /status válaszból:

Valós idejű teljesítmény — meters[0].power, wattban megadva, a sablon kW-ra konvertálja
Összesített fogyasztás — meters[0].total, wattperces mértékegységben megadva, a sablon kWh-ra konvertálja

A mérő csak olvasható – minden lekérdezési ciklussal automatikusan frissül.

Szolgáltatás-diagnosztika

A sablon 13 szolgáltatási attribútumot tesz elérhetővé az eszköz monitorozásához:

Eszközadatok — állomásnév, MAC-cím, eszközidő, üzemidő, RAM-használat
Hővédelem — belső hőmérséklet (°C), hőmérsékleti állapot (Normal / High / Very High), túlhőmérséklet-jelző
Kapcsolat — felhőkapcsolat engedélyezve/csatlakoztatva, MQTT csatlakoztatva, firmware-frissítés elérhető
Teljesítményvédelem — jelenlegi maximális teljesítménykorlát (a /settings végpontról olvasva)

Szolgáltatási műveletek

Három szolgáltatási művelet érhető el:

Teljesítményvédelem beállítása — maximális teljesítménykorlát megadása (1–3500 W). Ha a fogyasztás meghaladja ezt az értéket, a relé automatikusan kikapcsol.
Felhőkapcsolat engedélyezése — a Shelly Cloud kapcsolat be- vagy kikapcsolása
Újraindítás — az eszköz újraindítását kezdeményezi

További képességek

A Shelly 1PM a /status válaszban hálózati feszültséget, reaktív teljesítményt, fizikai bemeneti állapotot és Wi-Fi jelszintet is megad. A relé végponton automatikus kikapcsolási időzítő is elérhető. Ezek a képességek egy jövőbeli sablonfrissítésben adhatók hozzá.

Hibaelhárítás

Az eszköz nem válaszol

Ellenőrizd, hogy a Shelly csatlakozik-e Wi-Fi-hez, és van-e érvényes IP-címe
Próbálj meg az IP-cím helyett mDNS állomásnevet használni (shelly1pm-AABBCCDDEE.local) – az IP-cím megváltozhatott DHCP-megújítás után
Nyisd meg a http://{device-ip}/shelly címet egy böngészőben – ha válaszol, az eszköz elérhető
Ellenőrizd, hogy a TapHome CCU és a Shelly ugyanazon a hálózaton / VLAN-on van-e

A teljesítményértékek nullát mutatnak

Győződj meg arról, hogy a terhelés a Shelly reléen keresztül csatlakozik (nem bypassed)
Ellenőrizd, hogy a relé be van-e kapcsolva – a mérő csak akkor olvas, ha áram folyik a reléen
Kérd le manuálisan a /status végpontot, és ellenőrizd, hogy a meters[0].power nullától különböző értéket ad-e vissza

Túlhőmérsékleti figyelmeztetés

A Shelly 1PM belső hővédelemmel rendelkezik. Ha az eszköz hőmérséklete meghaladja a biztonságos határértéket, a temperature_status „High" vagy „Very High" értékre vált, és az overtemperature true lesz. Gondoskodj megfelelő szellőzésről az eszköz körül, különösen nagy terhelés kapcsolásakor.

Az 1. generációs Shelly eszközök csak 2 egyidejű HTTP-kapcsolatot támogatnak. Ha a TapHome és egy másik rendszer (pl. Home Assistant) egyszerre kérdezi le ugyanazt az eszközt, a kommunikáció megbízhatatlanná válhat. Használj 10–30 másodperces lekérdezési időközt.

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):

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

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

Első bekapcsoláskor az eszköz létrehoz egy hotspotot: ShellyXXX-AABBCCDDEE
Csatlakoztassa telefonját/PC-jét ehhez a hotspothoz
Nyissa meg a http://192.168.33.1 címet → Internet & Security → Wi-Fi Mode - Client
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

A TapHome-ban adjon hozzá egy új Packet Parser (HTTP) modult
IP Address: adja meg a 2. lépésben kapott IP-t (pl. 192.168.1.50)
Port: 80 (alapértelmezett, nem kell módosítani)
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 1PM Modul

Szerviz attribútumok

Teljesítményvédelem

Gazdagép neve

MAC-cím

Eszköz ideje

Üzemidő

RAM

Belső eszközhőmérséklet

Hőmérsékleti állapot

FW frissítés

Cloud engedélyezve

Cloud csatlakoztatva

MQTT csatlakoztatva

Túlmelegedett

Szerviz műveletek

Teljesítményvédelem beállítása

Cloud engedélyezése

Újraindítás

Shelly 1PM Module

Olvasás (modul)

VAR response := SENDHTTPREQUEST("/status", "GET");
StatusJson := response.Content;

Szerviz attribútumok

Power protection

VAR response := SENDHTTPREQUEST("/settings", "GET");
SettingsJson := response.Content;

response := SENDHTTPREQUEST("/status", "GET");
StatusJson := response.Content;

PARSEJSON(SettingsJson, "max_power") + "W";

Host name

PARSEJSON(SettingsJson, "device.hostname");

Mac address

PARSEJSON(StatusJson, "mac");

Device time

PARSEJSON(StatusJson, "time")

Uptime

VAR upTimeSeconds := PARSEJSON(StatusJson, "uptime");
VAR days := FLOOR(upTimeSeconds/86400, 1);
uptimeSeconds := MOD(upTimeSeconds, 86400);
var hours := FLOOR(upTimeSeconds/3600, 1);
uptimeSeconds := MOD(upTimeSeconds, 3600);
var minutes := FLOOR(upTimeSeconds/60, 1);
days + "day(s) " + hours + "h " + minutes + "m"

RAM

var ramTotal := PARSEJSON(StatusJson, "ram_total");
var ramFree := PARSEJSON(StatusJson, "ram_free");
ramFree + " bytes free of " + ramTotal

Internal device temperature

PARSEJSON(StatusJson, "temperature") + "°C"

Temperature status

PARSEJSON(StatusJson, "temperature_status");

FW update

PARSEJSON(StatusJson, "has_update");

Cloud enabled

PARSEJSON(StatusJson, "cloud.enabled");

Cloud connected

PARSEJSON(StatusJson, "cloud.connected");

MQTT connected

PARSEJSON(StatusJson, "mqtt.connected");

Overheated

PARSEJSON(StatusJson, "overtemperature");

Szerviz műveletek

Set power protection

Paraméterek: Maximum power (1–3500 Watts)

VAR response := SENDHTTPREQUEST("settings?max_power=" + Watts);
VAR contentJson := response.Content;
VAR limitSet := PARSEJSON(contentJson, "max_power");

"Power limit set to " + limitSet + "W"

Enable cloud

Paraméterek: Enable (Enable / Disable)

VAR response := SENDHTTPREQUEST("/settings/cloud?enabled=" + enable);
VAR contentJson := response.Content;
VAR wasEnabled := PARSEJSON(contentJson, "enabled");

IF(wasEnabled, "Cloud enabled", "Cloud disabled");

Reboot

VAR response := SENDHTTPREQUEST("/reboot");
VAR contentJson := response.Content;
VAR wasRebooted := PARSEJSON(contentJson, "ok");

IF(wasRebooted, "Reboot successful", "Error");

Kapcsoló Kapcsoló

boolean

Kapcsoló

Kapcsoló állapot olvasása

VAR value := PARSEJSON(StatusJson, "relays[0].ison", 1);
IF(ISNULL(value), NaN, value);

Kapcsoló állapot írása

VAR path := "relay/0?turn=" + SWITCH(St, 0, "off", 1, "on","off");
SENDHTTPREQUEST(path);

Villamos mérő Villanyóra Csak olvasható

Energiafogyasztás mérés — pillanatnyi teljesítmény (kW) és összesített energia (kWh)

numeric Egység: W / kWh

Villamos mérő

Összes fogyasztás olvasása

VAR total := PARSEJSON(StatusJson, "meters[0].total", 1);
IF(ISNULL(total), NaN, total / 60000.0);

Igény olvasása

VAR power := PARSEJSON(StatusJson, "meters[0].power", 1);
IF(ISNULL(power), NaN, power / 1000.0);

Kapcsolat: Packet Parser → HTTP

Lehetséges fejlesztések (5)

Voltage — Line voltage in V, available in /status response
Reactive Power — Reactive power in VAR, available in /status response
Input State — Physical input state (0/1), available in /status response
WiFi Signal Strength — WiFi RSSI in dBm, available in /status response
Auto-off Timer — Auto-off timer in seconds, could be added as service action or switch parameter

Sablon letöltése

Források

Shelly Gen1 API Reference
shelly-api-docs.shelly.cloud 2026-03-12
Home Assistant Shelly Integration
www.home-assistant.io 2026-03-12