---
title: "SmartThings Spínač/Zásuvka s Meraním Spotreby"
description: "SmartThings spínač/zásuvka s meraním spotreby cez SmartThings Cloud API. Ovládaj zapnutie/vypnutie a monitoruj spotrebu energie z TapHome cez HTTPS."
url: "https://taphome.com/sk/compatibility/smartthings-switch-plug/"
language: sk
lastmod: 2026-03-28
generator: hugo
ai:
  topics: ["http","smart-plug","cloud-api","power-metering","smartthings"]
  questions: ["Ako integrovať SmartThings spínač alebo zásuvku s TapHome?","Čo meria šablóna SmartThings Switch/Plug v TapHome?","Ako vygenerovať SmartThings Personal Access Token pre TapHome?","Prečo SmartThings integrácia prestane fungovať po 24 hodinách?","Ako nájsť SmartThings Device ID pre TapHome?","Dá sa ovládať viacero SmartThings zariadení z TapHome?"]
---

# SmartThings Spínač/Zásuvka s Meraním Spotreby

Komunikácia: Packet Parser → HTTP

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

## Návod na integráciu

Táto šablóna integruje ľubovoľný SmartThings-kompatibilný spínač alebo zásuvku s meraním spotreby do TapHome. Komunikácia prebieha cez SmartThings Cloud REST API v1 na `api.smartthings.com` cez HTTPS — šablóna nekomunikuje priamo s fyzickým zariadením. Zariadenie môže byť ZigBee, Z-Wave alebo Matter — pokiaľ je pripojené k SmartThings účtu a vystavuje schopnosti switch, powerMeter a energyMeter, šablóna bude fungovať.

Šablónu vytvoril Csongor Varga a demonštroval ju na ZigBee zásuvke BlitzWolf BW-SHP15, ale nie je obmedzená na tento model.

## Konfigurácia

Šablóna vyžaduje dve premenné nakonfigurované v TapHome po importe:

- **Token** — SmartThings Personal Access Token (PAT) používaný na Bearer autentifikáciu
- **DeviceId** — UUID cieľového zariadenia v platforme SmartThings

### Vygenerovanie Personal Access Tokenu

1. Prejdi na [account.smartthings.com/tokens](https://account.smartthings.com/tokens) a prihlás sa Samsung účtom
2. Klikni na **Generate new token** a pomenuj ho (napr. „TapHome Integration")
3. Vyber oprávnenie **Devices** — je potrebné na čítanie stavu a odosielanie príkazov
4. Klikni na **Generate Token** a okamžite skopíruj token — toto je jediná príležitosť na získanie hodnoty

> [!WARNING]
> Štandardné Personal Access Tokeny (vytvorené po 30. decembri 2024) sú platné iba **24 hodín**. Token musí byť pregenerovaný a aktualizovaný v TapHome pred vypršaním, inak integrácia prestane fungovať. Staršie tokeny vytvorené pred týmto dátumom môžu mať dlhšiu platnosť.

### Nájdenie Device ID

1. Prihlás sa na [my.smartthings.com](https://my.smartthings.com/)
2. Nájdi cieľové zariadenie v zozname zariadení
3. Skopíruj **Device ID** zo stránky s detailmi zariadenia — ide o UUID reťazec (napr. `47eff6bf-83c9-4374-a367-b254759b486d`)

### Pridanie viacerých zariadení

Každé SmartThings zariadenie vyžaduje vlastnú inštanciu modulu. Na pridanie ďalšieho zariadenia importuj šablónu znova a nakonfiguruj nové DeviceId. Rovnaký Token je možné použiť pre všetky moduly.

## Schopnosti zariadenia

### Ovládanie spínača

Šablóna vystavuje zariadenie ako spínač. Stav sa číta zo SmartThings status odpovede (`components.main.switch.switch.value` — `"on"` alebo `"off"`, mapované na 1/0). Príkazy spínača sa odosielajú cez `POST /v1/devices/{DeviceId}/commands` so schopnosťou `switch`.

Po odoslaní príkazu spínača šablóna čaká 500 ms a znovu načíta stav zariadenia, aby zabránila premiešaniu stavov medzi príkazom a ďalším cyklom pollingu. Spínač sa polluje každých 2,5 sekundy.

### Meranie spotreby

Vstavaný elektromer číta dve hodnoty zo status odpovede:

- **Okamžitý výkon** — `components.main.powerMeter.power.value` reportovaný vo wattoch, konvertovaný na kW šablónou (÷ 1000)
- **Celková spotreba** — `components.main.energyMeter.energy.value` reportovaná priamo v kWh

Elektromer je len na čítanie a polluje sa každých 15 sekúnd.

### Ďalšie schopnosti

SmartThings API tiež vystavuje reťazce jednotiek výkonu a energie, stav zariadenia (health) a schopnosť refresh na vynútenie okamžitej aktualizácie stavu. Tieto môžu byť pridané v budúcej aktualizácii šablóny.

## Riešenie problémov

### Integrácia prestane fungovať po 24 hodinách

Štandardné SmartThings PAT tokeny vypršia po 24 hodinách. Vygeneruj nový token na [account.smartthings.com/tokens](https://account.smartthings.com/tokens) a aktualizuj premennú Token v TapHome module. Ak je časté obnovovanie tokenu nepraktické, over, či je na účte dostupný starší token s dlhšou platnosťou.

### Zariadenie neodpovedá

1. Over, že SmartThings zariadenie je online — skontroluj jeho stav v aplikácii SmartThings
2. Potvrď, že premenná DeviceId zodpovedá správnemu UUID zariadenia
3. Otestuj API manuálne: `GET https://api.smartthings.com/v1/devices/{DeviceId}/status` s hlavičkou `Authorization: Bearer {Token}` — malo by vrátiť JSON odpoveď so stavom zariadenia
4. Uisti sa, že Token má správne oprávnenie (Devices — čítanie a vykonávanie)

### Meranie výkonu ukazuje nulu

1. Potvrď, že zariadenie skutočne spotrebúva energiu — zapni pripojenú záťaž
2. Over, že SmartThings zariadenie podporuje schopnosti `powerMeter` a `energyMeter` — nie všetky spínače reportujú výkon
3. Manuálne odošli dotaz na status API a over, že `components.main.powerMeter.power.value` vracia nenulovú hodnotu

> [!NOTE]
> Toto je cloudová integrácia — vyžaduje aktívne internetové pripojenie na TapHome CCU. Šablóna komunikuje so servermi Samsungu, nie s fyzickým zariadením v lokálnej sieti.

## Dostupné zariadenia 2

Tieto zariadenia sa po importe zobrazia v TapHome.

SmartThings Spínač/Zásuvka Modul

Vlastné premenné

|                                                            |                                                                                                          |
|------------------------------------------------------------|----------------------------------------------------------------------------------------------------------|
| `Token` (string) = 0ead2552-e331-4355-b483-81d3898eb5ba    | SmartThings Personal Access Token pre autentifikáciu API (vygenerujte na account.smartthings.com/tokens) |
| `DeviceId` (string) = 47eff6bf-83c9-4374-a367-b254759b486d | SmartThings UUID zariadenia — identifikuje cieľový spínač alebo zásuvku                                  |

Čítanie (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
```

Elektromer Elektromer Len na čítanie

Meranie spotreby energie — okamžitý výkon (kW) a kumulatívna energia (kWh) cez SmartThings Cloud API

numeric Jednotka: kW / kWh JSON

Premenná: `DeviceId`

Čítanie celkovej spotreby

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

Čítanie odberu

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

Spínač Prepínač Čítanie aj zápis

boolean JSON

Hodnoty / Stavy: ON · OFF

Čítanie stavu prepínača

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

Zápis stavu prepínača

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

**Pripojenie:** Packet Parser → HTTP

Možné vylepšenia (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

## Zdroje

- 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

## Súvisiaca dokumentácia

- [Integrácia Packet Parser](https://taphome.com/sk/compatibility/packet-parser-guide/)
- [Packet Parser (HTTP, TCP, UDP, FTP, MQTT)](https://taphome.com/sk/docs/integration/packet-parser/)
- [Funkcie Packet parsera](https://taphome.com/sk/docs/script/packet-parser/)
- [Parsovacie funkcie](https://taphome.com/sk/docs/script/parsing-functions/)