---
title: "Shelly Plus 1PM"
description: "Shelly Plus 1PM a TapHome-ban HTTP-n vagy MQTT-n, felhő nélkül: egy áramkör kapcsolása, teljesítmény, feszültség, áram és energia mérése."
url: "https://taphome.com/hu/compatibility/shelly-plus-1pm/"
language: hu
lastmod: 2026-03-29
generator: hugo
ai:
  topics: ["http","mqtt","electric-meter","wifi","relay","power-metering","gen2plus"]
  questions: ["Hogyan integrálható a Shelly Plus 1PM a TapHome-mal?","Mit mér a Shelly Plus 1PM sablon a TapHome-ban?","Hogyan csatlakoztatható a Shelly Plus 1PM HTTP-n a TapHome-hoz?","Hogyan csatlakoztatható a Shelly Plus 1PM MQTT-n a TapHome-hoz?","Mi a különbség a Shelly Plus 1PM és a Shelly 1PM között a TapHome-ban?","Miért mutat nullát a Shelly Plus 1PM teljesítménymérése?","Milyen diagnosztika érhető el a Shelly Plus 1PM-hez a TapHome-ban?","Használhatok MQTT-t HTTP helyett a Shelly Plus 1PM-hez?"]
---

# Shelly Plus 1PM

Kommunikáció: Packet Parser → HTTP

- [Shelly Plus 1PM termékoldal](https://www.shelly.com/en/products/shop/shelly-plus-1pm)
- [Shelly Plus 1PM API dokumentáció](https://shelly-api-docs.shelly.cloud/gen2/)

> 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](https://taphome.com/hu/docs/setup/network-preparation/)

## Integrációs útmutató

A Shelly Plus 1PM egy kompakt Gen2+ Wi-Fi relés kapcsoló beépített teljesítményméréssel. 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 110-240 VAC vagy 24-30 VDC tápfeszültséget támogat, így hálózati és kisfeszültségű telepítésekhez egyaránt alkalmas. A TapHome lokálisan kommunikál az eszközzel Wi-Fi-n keresztül — felhőkapcsolat nem szükséges.

Két TapHome sablon érhető el: egy **HTTP sablon**, amely az eszköz Gen2+ RPC API-ját kérdezi le, és egy **MQTT sablon**, amely MQTT brokeren keresztül fogadja az adatokat. Mindkettő ugyanazt a két eszközt teszi elérhetővé — egy energiamérőt és egy relés kapcsolót.

## Konfiguráció

### HTTP sablon

A HTTP sablon csak az eszköz IP-címét igényli (alapértelmezett: `192.168.0.1`). A TapHome a `/rpc/Switch.GetStatus?id=0` végpontot kérdezi le a relé állapotához és a teljesítménymérési adatokhoz. A modul a JSON választ egy `status` változóban tárolja, így az egyes eszközszkriptek redundáns HTTP hívások nélkül elemezhetik az adatokat.

### MQTT sablon

Az MQTT sablon importáláskor három paramétert igényel:

- **MQTT broker IP** — az MQTT broker IP-címe (nem magáé a Shelly eszközé)
- **MQTT broker port** — alapértelmezett `1883`
- **Shelly MQTT Client ID** — formátum `shellyplus1pm-{deviceid}`, a Shelly webes felületén található: **Settings** > **MQTT Settings** > **Client ID**

Az MQTT aktiválása után a Shelly Plus 1PM-en (Settings > MQTT) a TapHome feliratkozik a `shellyplus1pm-{deviceid}/status/switch:0` témára, és vezérlő parancsokat küld a `shellyplus1pm-{deviceid}/command/switch:0` témára.

## Eszközképességek

### Relévezérlés

A sablon a relét kapcsolóeszközként teszi elérhetővé. A relé állapota az `output` mezőből olvasható (boolean), és a `/rpc/Switch.Set?id=0` végponton `on=true` vagy `on=false` paraméterrel (HTTP), vagy `on`/`off` publikálásával a parancs témára (MQTT) vezérelhető.

A HTTP sablon 2,5 másodperces intervallumban kérdezi le a relét, ami közel valós idejű állapotvisszajelzést biztosít. Az MQTT sablon a frissítéseket folyamatosan fogadja a listener szkripten keresztül.

### Teljesítménymérés

A beépített energiamérő két értéket olvas a Switch.GetStatus válaszából:

- **Pillanatnyi teljesítmény** — `apower` wattban, a sablon kW-ra konvertálja (osztás 1000-rel)
- **Összesített energiafogyasztás** — `aenergy.total` wattórában, a sablon kWh-ra konvertálja (osztás 1000-rel)

A mérő csak olvasható — automatikusan frissül minden lekérdezési ciklussal (HTTP) vagy minden MQTT állapotüzenettel.

A HTTP sablon az energiamérőn három szervizattribútumot is elérhetővé tesz:

| Attribútum | Egység | Leírás |
|------------|--------|--------|
| Áram | A | Pillanatnyi áramfelvétel |
| Feszültség | V | Effektív hálózati feszültség |
| Hőmérséklet | °C | Belső eszközhőmérséklet |

Az MQTT sablon a belső hőmérsékletet, feszültséget és áramot modulszintű szervizattribútumként teszi elérhetővé, azonos adatokkal, amelyeket az MQTT állapotüzenetből elemez.

### További képességek

A Shelly Plus 1PM az RPC API-n keresztül elérhetővé teszi a teljesítménytényezőt, hálózati frekvenciát, visszatáplált energiát (kétirányú méréshez), fizikai bemeneti állapotot, Wi-Fi jelerősséget, MAC-címet, üzemidőt, RAM-kihasználtságot és eszközidőt is. Firmware-frissítés, eszközújraindítás, automatikus kikapcsolási időzítő, energiaszámláló-visszaállítás és túlterhelés-védelem konfigurálása szintén 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 (HTTP)

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 (`shellyplus1pm-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

### MQTT üzenetek nem érkeznek

1. Ellenőrizze, hogy az MQTT engedélyezve van a Shelly webes felületén (Settings > MQTT)
2. Erősítse meg, hogy a broker címe és portja helyes a Shelly eszközben és a TapHome modulbeállításokban egyaránt
3. Ellenőrizze, hogy a `plug1topic` egyéni változó pontosan megegyezik a Shelly eszköz MQTT Client ID-jával (pl. `shellyplus1pm-AABBCCDDEE`)
4. Használjon MQTT klienst (pl. MQTT Explorer) a `shellyplus1pm-#` feliratkozásához, és ellenőrizze, hogy az eszköz küld-e üzeneteket

### Teljesítményértékek nullát mutatnak

1. Erősítse meg, hogy a terhelés a Shelly relén keresztül van csatlakoztatva (nem áthidalva)
2. Ellenőrizze, hogy a relé be van kapcsolva — a mérő csak akkor mér, ha áram folyik a relén át
3. Kérdezze le manuálisan a `/rpc/Switch.GetStatus?id=0` végpontot, és ellenőrizze, hogy az `apower` nem nullás értéket ad

### 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
4. Fontolja meg az MQTT sablonra való áttérést több rendszeres környezetben — az MQTT teljesen megkerüli a kapcsolatlimit problémáját

## 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](https://www.shelly.com/en/support/shelly-app) (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**

> [!NOTE]
> 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

> [!TIP]
> 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

> [!NOTE]
> 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 2

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

Shelly Plus 1PM Modul

Egyéni változók

Villamos mérő Villanyóra Csak olvasható

Pillanatnyi teljesítmény (kW) és összesített energia (kWh) áram-, feszültség- és hőmérséklet-diagnosztikával

numeric Egység: kW / kWh

Szerviz attribútumok

|             |
|-------------|
| Áram        |
| Feszültség  |
| Hőmérséklet |

Összes fogyasztás olvasása

```taphome
return(parsejson(parsejson(status,"aenergy"), "total")/1000);
```

Igény olvasása

```taphome
return(parsejson(status,"apower")/1000);
```

Olvasás (modul)

```taphome
var x := (sendhttprequest("/rpc/Switch.GetStatus?id=0"));
status := x.Content;
```

Szerviz attribútumok

${current} \[a]

```taphome
return(parsejson(status,"current"));
```

${electric\_voltage} \[v]

```taphome
return(parsejson(status,"voltage"));
```

${temp} \[C]

```taphome
return(parsejson(parsejson(status,"temperature"), "tC"));
```

Kapcsoló Kapcsoló Olvasás és írás

boolean

Értékek / Állapotok: ON · OFF

Kapcsoló állapot olvasása

```taphome
var x := (sendhttprequest("/rpc/Switch.GetStatus?id=0"));
status := x.Content;
return(PARSEJSON(status, "$.output", true));
```

Kapcsoló állapot írása

```taphome
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 • Hostname: `shellyplus1pm-{MAC}.local`

Lehetséges fejlesztések (16)

- Power Factor — Power factor value, available in Switch.GetStatus response for metered devices
- Network Frequency — AC network frequency in Hz, available in Switch.GetStatus response
- Returned Energy — Returned/exported energy in Wh, for bi-directional metering scenarios
- Input State — Physical switch/button input state, available via /rpc/Input.GetStatus?id=0
- WiFi SSID — Connected WiFi network name, available via /rpc/WiFi.GetStatus
- WiFi Signal Strength — WiFi RSSI in dBm, available via /rpc/WiFi.GetStatus
- IP Address — Device IP address, available via /rpc/WiFi.GetStatus
- MAC Address — Device MAC address, available via /rpc/Sys.GetStatus
- 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
- Firmware Update — Trigger firmware update to stable channel, available via Shelly.Update RPC method
- Reboot — Reboot the device, available via Shelly.Reboot RPC method
- Auto-off Timer — Auto-reset timer in seconds via toggle\_after parameter, could be added as switch parameter
- Reset Energy Counters — Resets energy measurement counters (aenergy, ret\_aenergy)
- Overpower Protection — Configurable power limit threshold in Watts, relay turns off when exceeded

## Importálási paraméterek

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

| Az alkalmazás kéri | Alapérték     |
|--------------------|---------------|
| IP-cím             | `192.168.0.1` |

## Források

- Shelly Gen2+/Gen3 RPC API Reference
  
  [shelly-api-docs.shelly.cloud](https://shelly-api-docs.shelly.cloud/gen2/) 2026-03-29
- Shelly Gen2+ Switch Component API
  
  [shelly-api-docs.shelly.cloud](https://shelly-api-docs.shelly.cloud/gen2/ComponentsAndServices/Switch/) 2026-03-29
- Shelly Gen2+ System (Sys) Component API
  
  [shelly-api-docs.shelly.cloud](https://shelly-api-docs.shelly.cloud/gen2/ComponentsAndServices/Sys/) 2026-03-29
- Shelly Gen2+ WiFi Component API
  
  [shelly-api-docs.shelly.cloud](https://shelly-api-docs.shelly.cloud/gen2/ComponentsAndServices/WiFi/) 2026-03-29
- Shelly Gen2+ MQTT Component API
  
  [shelly-api-docs.shelly.cloud](https://shelly-api-docs.shelly.cloud/gen2/ComponentsAndServices/Mqtt/) 2026-03-29
- Home Assistant Shelly Integration
  
  [www.home-assistant.io](https://www.home-assistant.io/integrations/shelly/) 2026-03-29
- Shelly Plus 1PM Knowledge Base — specs & wiring
  
  [kb.shelly.cloud](https://kb.shelly.cloud/knowledge-base/shelly-plus-1pm) 2026-03-29

## Kapcsolódó dokumentáció

- [Packet Parser integráció](https://taphome.com/hu/compatibility/packet-parser-guide/)
- [Packet Parser (HTTP, TCP, UDP, FTP, MQTT)](https://taphome.com/hu/docs/integration/packet-parser/)
- [Packet parser függvények](https://taphome.com/hu/docs/script/packet-parser/)
- [Elemző függvények](https://taphome.com/hu/docs/script/parsing-functions/)

