---
title: "SmartThings Kapcsoló/Csatlakozó Teljesítményméréssel"
description: "SmartThings kapcsoló/csatlakozó teljesítményméréssel a SmartThings Cloud API-n keresztül."
url: "https://taphome.com/hu/compatibility/smartthings-switch-plug/"
language: hu
lastmod: 2026-03-28
generator: hugo
ai:
  topics: ["http","smart-plug","cloud-api","power-metering","smartthings"]
  questions: ["Hogyan integráljak egy SmartThings kapcsolót vagy csatlakozót a TapHome-mal?","Mit mér a SmartThings Switch/Plug TapHome sablon?","Hogyan generáljak SmartThings Personal Access Tokent a TapHome-hoz?","Miért szűnik meg a SmartThings integráció 24 óra után?","Hogyan találom meg a SmartThings Device ID-t a TapHome-hoz?","Több SmartThings eszközt is vezérelhetek a TapHome-ból?"]
---

# SmartThings Kapcsoló/Csatlakozó Teljesítményméréssel

Kommunikáció: Packet Parser → HTTP

- [SmartThings fejlesztői portál](https://developer.smartthings.com/)

## Integrációs útmutató

Ez a sablon bármely SmartThings-kompatibilis kapcsolót vagy csatlakozót teljesítményméréssel integrál a TapHome-ba. A kommunikáció a SmartThings Cloud REST API v1-en keresztül történik az `api.smartthings.com` címen HTTPS-en — a sablon nem kommunikál közvetlenül a fizikai eszközzel. Az eszköz lehet ZigBee, Z-Wave vagy Matter — amíg egy SmartThings-fiókhoz csatlakozik és switch, powerMeter és energyMeter képességeket biztosít, a sablon működni fog.

A sablont Csongor Varga készítette és egy BlitzWolf BW-SHP15 ZigBee csatlakozóval demonstrálta, de nem korlátozódik erre a modellre.

## Konfiguráció

A sablon két változót igényel, amelyeket az importálás után a TapHome-ban kell beállítani:

- **Token** — SmartThings Personal Access Token (PAT) a Bearer hitelesítéshez
- **DeviceId** — a céleszköz UUID-ja a SmartThings platformon

### Personal Access Token generálása

1. Menj az [account.smartthings.com/tokens](https://account.smartthings.com/tokens) oldalra és jelentkezz be Samsung-fiókkal
2. Kattints a **Generate new token** gombra és nevezd el (pl. „TapHome Integration")
3. Válaszd ki a **Devices** jogosultságot — ez szükséges az állapot olvasásához és parancsok küldéséhez
4. Kattints a **Generate Token** gombra és azonnal másold ki a tokent — ez az egyetlen lehetőség az érték lekérésére

> [!WARNING]
> A standard Personal Access Tokenek (2024. december 30. után létrehozva) csak **24 órán át** érvényesek. A tokent a lejárat előtt újra kell generálni és frissíteni a TapHome-ban, különben az integráció leáll. A korábbi tokenek hosszabb érvényességi idővel rendelkezhetnek.

### Device ID megkeresése

1. Jelentkezz be a [my.smartthings.com](https://my.smartthings.com/) oldalon
2. Keresd meg a céleszközt az eszközlistában
3. Másold ki a **Device ID**-t az eszköz részletező oldaláról — ez egy UUID karakterlánc (pl. `47eff6bf-83c9-4374-a367-b254759b486d`)

### Több eszköz hozzáadása

Minden SmartThings eszköz saját modulpéldányt igényel. Újabb eszköz hozzáadásához importáld újra a sablont és állíts be egy új DeviceId-t. Ugyanaz a Token minden modulban újrafelhasználható.

## Eszközképességek

### Kapcsolóvezérlés

A sablon kapcsolóként teszi elérhetővé az eszközt. Az állapot a SmartThings státusz válaszból olvasódik ki (`components.main.switch.switch.value` — `"on"` vagy `"off"`, 1/0-ra leképezve). A kapcsolóparancsok a `POST /v1/devices/{DeviceId}/commands` végponton keresztül küldhetők a `switch` képességgel.

Kapcsolóparancs küldése után a sablon 500 ms-ot vár és újraolvassa az eszköz állapotát, hogy megakadályozza az állapotkeveredést a parancs és a következő lekérdezési ciklus között. A kapcsoló 2,5 másodpercenként kerül lekérdezésre.

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

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

- **Valós idejű teljesítmény** — `components.main.powerMeter.power.value` wattban jelentve, a sablon kW-ra konvertálja (÷ 1000)
- **Összesített fogyasztás** — `components.main.energyMeter.energy.value` közvetlenül kWh-ban jelentve

A mérő csak olvasható és 15 másodpercenként kerül lekérdezésre.

### További képességek

A SmartThings API teljesítmény- és energia-egység karakterláncokat, eszköz-állapotot (health) és refresh képességet is biztosít az azonnali állapotfrissítés kikényszerítéséhez. Ezek egy jövőbeli sablonfrissítésben adhatók hozzá.

## Hibaelhárítás

### Az integráció 24 óra után leáll

A standard SmartThings PAT tokenek 24 óra után lejárnak. Generálj új tokent az [account.smartthings.com/tokens](https://account.smartthings.com/tokens) oldalon és frissítsd a Token változót a TapHome modulban. Ha a gyakori tokenfrissítés nem praktikus, ellenőrizd, hogy elérhető-e egy régebbi, hosszabb érvényességű token a fiókon.

### Az eszköz nem válaszol

1. Ellenőrizd, hogy a SmartThings eszköz online-e — nézd meg az állapotát a SmartThings alkalmazásban
2. Erősítsd meg, hogy a DeviceId változó megfelel a helyes eszköz UUID-nak
3. Teszteld az API-t manuálisan: `GET https://api.smartthings.com/v1/devices/{DeviceId}/status` az `Authorization: Bearer {Token}` fejléccel — JSON választ kell kapnod az eszköz állapotával
4. Győződj meg róla, hogy a Token rendelkezik a megfelelő jogosultsággal (Devices — olvasás és végrehajtás)

### A teljesítménymérés nullát mutat

1. Győződj meg róla, hogy az eszköz tényleg fogyaszt áramot — kapcsolj be egy csatlakoztatott fogyasztót
2. Ellenőrizd, hogy a SmartThings eszköz támogatja-e a `powerMeter` és `energyMeter` képességeket — nem minden kapcsoló jelenti a teljesítményadatokat
3. Kérdezd le manuálisan a státusz API-t és ellenőrizd, hogy a `components.main.powerMeter.power.value` nem nulla értéket ad-e vissza

> [!NOTE]
> Ez egy felhőalapú integráció — aktív internetkapcsolatot igényel a TapHome CCU-n. A sablon a Samsung szervereivel kommunikál, nem a helyi hálózaton lévő fizikai eszközzel.

## Elérhető eszközök 2

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

SmartThings Kapcsoló/Csatlakozó Modul

Egyéni változók

|                                                            |                                                                                                               |
|------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------|
| `Token` (string) = 0ead2552-e331-4355-b483-81d3898eb5ba    | SmartThings Personal Access Token az API hitelesítéshez (generálja az account.smartthings.com/tokens oldalon) |
| `DeviceId` (string) = 47eff6bf-83c9-4374-a367-b254759b486d | SmartThings eszköz UUID — azonosítja a cél kapcsolót vagy csatlakozót                                         |

Olvasás (modul)

```taphome
VAR response := SENDHTTPREQUEST("/v1/devices/"+DeviceId+"/status", "GET", "", "Authorization: Bearer "+Token);
IF response.IsSuccess
 StatusJson := response.Content;
ELSE
 ADDERROR(response.StatusCode + " (" + response.ReasonPhrase + ")");
END
```

Villamos mérő Villanyóra Csak olvasható

Energiafogyasztás mérés — pillanatnyi teljesítmény (kW) és kumulatív energia (kWh) a SmartThings Cloud API-n keresztül

numeric Egység: kW / kWh JSON

Változó: `DeviceId`

Összes fogyasztás olvasása

```taphome
VAR value := PARSEJSON(StatusJson, "components.main.energyMeter.energy.value", 1);
IF(ISNULL(value), NaN, value);
```

Igény olvasása

```taphome
VAR value := PARSEJSON(StatusJson, "components.main.powerMeter.power.value", 1);
IF(ISNULL(value), NaN, value / 1000);
```

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

boolean JSON

Értékek / Állapotok: ON · OFF

Kapcsoló állapot olvasása

```taphome
VAR value := PARSEJSON(StatusJson, "components.main.switch.switch.value", 1);
IF(ISNULL(value), NaN, if(value="on", 1, 0));
```

Kapcsoló állapot írása

```taphome
# Set Http request method, body and headers
VAR response := SENDHTTPREQUEST("/v1/devices/"+DeviceId+"/commands", 
"POST", 
"{\"commands\": [ { \"component\": \"main\", \"capability\": \"switch\", \"command\": \""+IF(St=1, "on", "off")+"\", \"arguments\": [] } ] }",
"Authorization: Bearer "+Token);


# Wait a little an read the state again to prevent state shuffle
SLEEP(500);
response := SENDHTTPREQUEST("/v1/devices/"+DeviceId+"/status", "GET", "", "Authorization: Bearer "+Token);
IF response.IsSuccess
 StatusJson := response.Content;
 # ADDINFO("StatusJson refreshed");
ELSE
 ADDERROR(response.StatusCode + " (" + response.ReasonPhrase + ")");
END
```

**Kapcsolat:** Packet Parser → HTTP

Lehetséges fejlesztések (4)

- Power Unit — Unit string for power reading (W), available in status response
- Energy Unit — Unit string for energy reading (kWh), available in status response
- Health Check — Device health/online status, available via SmartThings Health API
- Refresh — Force refresh device state via SmartThings refresh capability command

## Források

- TapHome Wiki — SmartThings Integration Guide
  
  [github.com](https://github.com/nygma2004/km/wiki/TapHome-Examples#integrating-smartthings-switch-or-plug-with-power-metering) 2026-03-28
- SmartThings API — Quick Start Guide
  
  [developer.smartthings.com](https://developer.smartthings.com/docs/getting-started/quickstart) 2026-03-28
- SmartThings Authorization and Permissions
  
  [developer.smartthings.com](https://developer.smartthings.com/docs/getting-started/authorization-and-permissions) 2026-03-28
- SmartThings Capabilities Reference (switch, powerMeter, energyMeter)
  
  [github.com](https://github.com/erikwilson/SmartThings-Documentation/blob/master/capabilities-reference.rst) 2026-03-28

## 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/)