---
title: "SmartThings Switch/Plug with Power Metering"
description: "Întrerupător/priză SmartThings cu măsurarea consumului prin SmartThings Cloud API. Porniți/opriți și monitorizați consumul din TapHome prin HTTPS."
url: "https://taphome.com/ro/compatibility/smartthings-switch-plug/"
language: ro
lastmod: 2026-03-28
generator: hugo
ai:
  topics: ["http","smart-plug","cloud-api","power-metering","smartthings"]
  questions: ["Cum integrez un întrerupător sau o priză SmartThings cu TapHome?","Ce măsoară șablonul TapHome pentru SmartThings Switch/Plug?","Cum generez un SmartThings Personal Access Token pentru TapHome?","De ce integrarea SmartThings nu mai funcționează după 24 de ore?","Cum găsesc Device ID-ul SmartThings pentru TapHome?","Pot controla mai multe dispozitive SmartThings din TapHome?"]
---

# SmartThings Switch/Plug with Power Metering

Comunicație: Packet Parser → HTTP

- [Portalul pentru dezvoltatori SmartThings](https://developer.smartthings.com/)

## Ghid de integrare

Acest șablon integrează în TapHome orice întrerupător sau priză compatibilă cu SmartThings, cu măsurarea consumului. Comunicația se realizează prin SmartThings Cloud REST API v1 (`api.smartthings.com`), folosind HTTPS — șablonul nu comunică direct cu dispozitivul fizic. Dispozitivul poate fi ZigBee, Z-Wave sau Matter — atât timp cât este conectat la un cont SmartThings și oferă capabilitățile switch, powerMeter și energyMeter, șablonul va funcționa.

Șablonul a fost creat de Csongor Varga și testat cu o priză ZigBee BlitzWolf BW-SHP15, dar nu este limitat la acest model.

## Configurare

După import, șablonul necesită configurarea a două variabile în TapHome:

- **Token** — un SmartThings Personal Access Token (PAT) folosit pentru autentificarea Bearer
- **DeviceId** — UUID-ul dispozitivului țintă în platforma SmartThings

### Generarea unui Personal Access Token

1. Accesați [account.smartthings.com/tokens](https://account.smartthings.com/tokens) și conectați-vă cu un cont Samsung
2. Faceți clic pe **Generate new token** și dați-i un nume (de ex. „TapHome Integration”)
3. Selectați domeniul de permisiuni **Devices** — este necesar pentru citirea stării și trimiterea comenzilor
4. Faceți clic pe **Generate Token** și copiați imediat tokenul — aceasta este singura ocazie de a obține valoarea

> [!WARNING]
> Personal Access Token-urile standard (create după 30 decembrie 2024) sunt valabile **doar 24 de ore**. Tokenul trebuie regenerat și actualizat în TapHome înainte de expirare, altfel integrarea nu va mai funcționa. Tokenurile mai vechi, create înainte de această dată, pot avea o valabilitate mai lungă.

### Găsirea Device ID-ului

1. Conectați-vă la [my.smartthings.com](https://my.smartthings.com/)
2. Găsiți dispozitivul țintă în lista de dispozitive
3. Copiați **Device ID** din pagina cu detaliile dispozitivului — este un șir UUID (de ex. `47eff6bf-83c9-4374-a367-b254759b486d`)

### Adăugarea mai multor dispozitive

Fiecare dispozitiv SmartThings necesită propria instanță de modul. Pentru a adăuga un alt dispozitiv, importați din nou șablonul și configurați un nou DeviceId. Același Token poate fi folosit pentru toate modulele.

## Funcțiile dispozitivului

### Controlul întrerupătorului

Șablonul oferă dispozitivul ca întrerupător. Starea se citește din răspunsul de stare SmartThings (`components.main.switch.switch.value` — `"on"` sau `"off"`, transformate în 1/0). Comenzile de comutare se trimit prin `POST /v1/devices/{DeviceId}/commands` cu capabilitatea `switch`.

După trimiterea unei comenzi de comutare, șablonul așteaptă 500 ms și citește din nou starea dispozitivului, pentru a evita oscilarea stării între comandă și următorul ciclu de interogare. Întrerupătorul este interogat la fiecare 2,5 secunde.

### Măsurarea consumului

Contorul electric integrat citește două valori din răspunsul de stare:

- **Puterea instantanee** — `components.main.powerMeter.power.value`, raportată în wați și convertită de șablon în kW (÷ 1000)
- **Consumul total** — `components.main.energyMeter.energy.value`, raportat direct în kWh

Contorul este doar pentru citire și este interogat la fiecare 15 secunde.

### Funcții suplimentare

API-ul SmartThings furnizează și unitățile de măsură pentru putere și energie (ca șiruri de caractere), starea de funcționare a dispozitivului și o capabilitate de reîmprospătare pentru forțarea unei actualizări imediate a stării. Acestea pot fi adăugate într-o actualizare viitoare a șablonului.

## Depanare

### Integrarea nu mai funcționează după 24 de ore

Tokenurile PAT SmartThings standard expiră după 24 de ore. Generați un token nou la [account.smartthings.com/tokens](https://account.smartthings.com/tokens) și actualizați variabila Token în modulul TapHome. Dacă reînnoirea frecventă a tokenului nu este practică, verificați dacă în cont este disponibil un token mai vechi, cu valabilitate mai lungă.

### Dispozitivul nu răspunde

1. Verificați dacă dispozitivul SmartThings este online — verificați starea lui în aplicația SmartThings
2. Verificați dacă variabila DeviceId corespunde UUID-ului corect al dispozitivului
3. Testați manual API-ul: `GET https://api.smartthings.com/v1/devices/{DeviceId}/status` cu antetul `Authorization: Bearer {Token}` — ar trebui să returneze un răspuns JSON cu starea dispozitivului
4. Asigurați-vă că Tokenul are domeniul de permisiuni corect (Devices — citire și execuție)

### Valorile puterii arată zero

1. Verificați dacă dispozitivul consumă efectiv energie — porniți consumatorul conectat
2. Verificați dacă dispozitivul SmartThings acceptă capabilitățile `powerMeter` și `energyMeter` — nu toate întrerupătoarele raportează puterea
3. Interogați manual API-ul de stare și verificați dacă `components.main.powerMeter.power.value` returnează o valoare diferită de zero

> [!NOTE]
> Aceasta este o integrare prin cloud — necesită o conexiune activă la internet pe unitatea centrală TapHome (CCU). Șablonul comunică cu serverele Samsung, nu cu dispozitivul fizic din rețeaua locală.

## Dispozitive disponibile 2

Aceste dispozitive apar în TapHome după import.

SmartThings Switch/Plug Modul

Variabile personalizate

|                                                            |                                                                                                                 |
|------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------|
| `Token` (string) = 0ead2552-e331-4355-b483-81d3898eb5ba    | SmartThings Personal Access Token pentru autentificarea la API (se generează pe account.smartthings.com/tokens) |
| `DeviceId` (string) = 47eff6bf-83c9-4374-a367-b254759b486d | UUID-ul dispozitivului SmartThings — identifică întrerupătorul sau priza țintă                                  |

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

Contor electric Contor electric Doar citire

Măsurarea puterii consumate și a energiei — puterea instantanee (kW) și energia cumulată (kWh) prin SmartThings Cloud API

numeric Unitate: kW / kWh JSON

Variabilă: `DeviceId`

Citirea consumului total

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

Citirea cererii

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

Întrerupător Comutator Citire și scriere

boolean JSON

Valori / Stări: ON · OFF

Citirea stării comutatorului

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

Scrierea stării comutatorului

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

**Conexiune:** Packet Parser → HTTP

Îmbunătățiri posibile (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

## Surse

- 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

## Documentație asociată

- [Packet Parser Integration](https://taphome.com/ro/compatibility/packet-parser-guide/)
- [Packet Parser (HTTP, TCP, UDP, FTP, MQTT)](https://taphome.com/ro/docs/integration/packet-parser/)
- [Funcții Packet parser](https://taphome.com/ro/docs/script/packet-parser/)
- [Funcții de parsare](https://taphome.com/ro/docs/script/parsing-functions/)

