---
title: "SmartThings sklopka/utičnica s mjerenjem snage"
description: "SmartThings sklopka/utičnica s mjerenjem snage preko Cloud API-ja i HTTPS-a. Upravljajte uređajem i pratite potrošnju energije iz sustava TapHome."
url: "https://taphome.com/hr/compatibility/smartthings-switch-plug/"
language: hr
lastmod: 2026-03-28
generator: hugo
ai:
  topics: ["http","smart-plug","cloud-api","power-metering","smartthings"]
  questions: ["Kako integrirati SmartThings sklopku ili utičnicu sa sustavom TapHome?","Što mjeri predložak TapHome za SmartThings sklopku/utičnicu?","Kako generirati SmartThings Personal Access Token za TapHome?","Zašto integracija SmartThings prestaje raditi nakon 24 sata?","Kako pronaći SmartThings Device ID za TapHome?","Mogu li iz sustava TapHome upravljati većim brojem uređaja SmartThings?"]
---

# SmartThings sklopka/utičnica s mjerenjem snage

Komunikacija: Packet Parser → HTTP

- [Portal za razvojne programere SmartThings](https://developer.smartthings.com/)

## Upute za integraciju

Ovaj predložak integrira u TapHome bilo koju sklopku ili utičnicu s mjerenjem snage koja je kompatibilna sa SmartThings. Komunikacija se odvija preko SmartThings Cloud REST API-ja v1 na `api.smartthings.com` preko HTTPS-a, a predložak ne komunicira izravno s fizičkim uređajem. Uređaj može biti ZigBee, Z-Wave ili Matter: dovoljno je da je povezan s računom SmartThings i da nudi mogućnosti (capabilities) switch, powerMeter i energyMeter, pa će predložak raditi.

Predložak je izradio Csongor Varga i prikazao ga na ZigBee utičnici BlitzWolf BW-SHP15, ali nije ograničen na taj model.

## Konfiguracija

Predložak nakon uvoza zahtijeva postavljanje dviju varijabli u sustavu TapHome:

- **Token** — SmartThings Personal Access Token (PAT) koji se koristi za Bearer autentifikaciju
- **DeviceId** — UUID ciljnog uređaja na platformi SmartThings

### Generiranje tokena Personal Access Token

1. Otvorite [account.smartthings.com/tokens](https://account.smartthings.com/tokens) i prijavite se Samsung računom
2. Kliknite **Generate new token** i dodijelite mu naziv (npr. „TapHome Integration”)
3. Odaberite opseg dopuštenja **Devices**, koji je potreban za čitanje stanja i slanje naredbi
4. Kliknite **Generate Token** i odmah kopirajte token, jer je to jedina prilika da se vrijednost preuzme

> [!WARNING]
> Standardni tokeni Personal Access Token (izrađeni nakon 30. prosinca 2024.) vrijede **samo 24 sata**. Token treba ponovno generirati i ažurirati u sustavu TapHome prije isteka, inače integracija prestaje raditi. Stariji tokeni izrađeni prije tog datuma mogu vrijediti dulje.

### Pronalaženje Device ID-ja

1. Prijavite se na [my.smartthings.com](https://my.smartthings.com/)
2. Pronađite ciljni uređaj na popisu uređaja
3. Na stranici s pojedinostima uređaja kopirajte **Device ID**: to je UUID niz (npr. `47eff6bf-83c9-4374-a367-b254759b486d`)

### Dodavanje više uređaja

Svaki uređaj SmartThings zahtijeva vlastitu instancu modula. Za dodavanje drugog uređaja ponovno uvezite predložak i postavite novi DeviceId. Isti Token može se koristiti u svim modulima.

## Mogućnosti uređaja

### Upravljanje sklopkom

Predložak prikazuje uređaj kao sklopku. Stanje se čita iz odgovora o stanju SmartThings (`components.main.switch.switch.value` — `"on"` ili `"off"`, preslikano na 1/0). Naredbe sklopke šalju se preko `POST /v1/devices/{DeviceId}/commands` s mogućnošću `switch`.

Nakon slanja naredbe sklopki predložak čeka 500 ms i ponovno čita stanje uređaja, kako se stanje ne bi izmjenjivalo između naredbe i sljedećeg ciklusa očitavanja. Sklopka se očitava svakih 2,5 sekunde.

### Mjerenje snage

Ugrađeno brojilo energije čita dvije vrijednosti iz odgovora o stanju:

- **Trenutačna snaga** — `components.main.powerMeter.power.value` javlja se u vatima, a predložak je pretvara u kW (÷ 1000)
- **Ukupna potrošnja** — `components.main.energyMeter.energy.value` javlja se izravno u kWh

Brojilo je samo za čitanje i očitava se svakih 15 sekundi.

### Dodatne mogućnosti

SmartThings API nudi i tekstualne oznake jedinica snage i energije, stanje ispravnosti uređaja te mogućnost refresh za prisilno trenutačno ažuriranje stanja. Mogu se dodati u budućem ažuriranju predloška.

## Rješavanje problema

### Integracija prestaje raditi nakon 24 sata

Standardni SmartThings PAT tokeni istječu nakon 24 sata. Generirajte novi token na [account.smartthings.com/tokens](https://account.smartthings.com/tokens) i ažurirajte varijablu Token u modulu TapHome. Ako je često obnavljanje tokena nepraktično, provjerite je li na računu dostupan stariji token s duljom valjanošću.

### Uređaj ne odgovara

1. Provjerite je li uređaj SmartThings na mreži: pogledajte njegovo stanje u aplikaciji SmartThings
2. Provjerite odgovara li varijabla DeviceId ispravnom UUID-u uređaja
3. Ručno testirajte API: `GET https://api.smartthings.com/v1/devices/{DeviceId}/status` sa zaglavljem `Authorization: Bearer {Token}` treba vratiti JSON odgovor sa stanjem uređaja
4. Provjerite ima li Token ispravan opseg dopuštenja (Devices — čitanje i izvršavanje)

### Očitanja snage pokazuju nulu

1. Provjerite troši li uređaj stvarno snagu: uključite spojeno trošilo
2. Provjerite podržava li uređaj SmartThings mogućnosti `powerMeter` i `energyMeter`, jer ne javljaju sve sklopke snagu
3. Ručno pošaljite upit API-ju stanja i provjerite vraća li `components.main.powerMeter.power.value` vrijednost različitu od nule

> [!NOTE]
> Ovo je integracija preko oblaka: centralna jedinica TapHome (CCU) treba aktivnu internetsku vezu. Predložak komunicira sa Samsungovim poslužiteljima, a ne s fizičkim uređajem u lokalnoj mreži.

## Dostupni uređaji 2

Ovi se uređaji pojavljuju u TapHomeu nakon uvoza.

SmartThings sklopka/utičnica Modul

Prilagođene varijable

|                                                            |                                                                                                                   |
|------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------|
| `Token` (string) = 0ead2552-e331-4355-b483-81d3898eb5ba    | SmartThings Personal Access Token za autentifikaciju prema API-ju (generira se na account.smartthings.com/tokens) |
| `DeviceId` (string) = 47eff6bf-83c9-4374-a367-b254759b486d | UUID uređaja SmartThings — određuje ciljnu sklopku ili utičnicu                                                   |

Čitanje (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
```

Brojilo energije Brojilo električne energije Samo za čitanje

Mjerenje potrošnje snage i energije — trenutačna snaga (kW) i ukupna energija (kWh) preko SmartThings Cloud API-ja

numeric Jedinica: kW / kWh JSON

Varijabla: `DeviceId`

Čitanje ukupne potrošnje

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

Čitanje zahtjeva

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

Sklopka Sklopka Čitanje i pisanje

boolean JSON

Vrijednosti / stanja: ON · OFF

Čitanje stanja sklopke

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

Zapis stanja sklopke

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

**Povezivanje:** Packet Parser → HTTP

Moguća poboljšanja (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

## Izvori

- 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

## Povezana dokumentacija

- [Packet Parser Integration](https://taphome.com/hr/compatibility/packet-parser-guide/)
- [Packet Parser (HTTP, TCP, UDP, FTP, MQTT)](https://taphome.com/hr/docs/integration/packet-parser/)
- [Funkcije Packet parsera](https://taphome.com/hr/docs/script/packet-parser/)
- [Funkcije za raščlambu](https://taphome.com/hr/docs/script/parsing-functions/)

