---
title: "Shelly Plug S"
description: "Priză inteligentă Wi-Fi Shelly Plug S cu contorizarea energiei. Monitorizați consumul și comandați aparatele de la distanță din TapHome, prin HTTP."
url: "https://taphome.com/ro/compatibility/shelly-plug-s/"
language: ro
lastmod: 2026-10-08
generator: hugo
ai:
  topics: ["http","smart-plug","electric-meter","wifi","relay","power-metering"]
  questions: ["Cum integrez Shelly Plug S cu TapHome?","Ce măsoară șablonul TapHome Shelly Plug S?","Cum conectez Shelly Plug S la TapHome prin HTTP?","De ce Shelly Plug S afișează valori zero ale puterii?","Poate TapHome să monitorizeze temperatura internă a Shelly Plug S?","Ce se întâmplă când Shelly Plug S se supraîncălzește?"]
---

# Shelly Plug S

Comunicație: Packet Parser → HTTP

- [Baza de cunoștințe Shelly Plug S](https://kb.shelly.cloud/knowledge-base/shelly-plug-s)

> Adresa în rețea
> 
> TapHome comunică cu dispozitivul la adresa introdusă la import. Atribuiți dispozitivului o adresă fixă — o rezervare IP în router sau numele său mDNS, dacă îl acceptă —, altfel integrarea nu mai funcționează când routerul schimbă adresa.
> 
> [Pregătirea rețelei](https://taphome.com/ro/docs/setup/network-preparation/)

## Ghid de integrare

Shelly Plug S este o priză inteligentă Wi-Fi compactă, cu contorizarea integrată a puterii. Se conectează direct la o priză de perete și poate comuta sarcini de până la 10 A (2300 W la 230 V). TapHome comunică cu dispozitivul prin HTTP în rețeaua locală — nu este necesară conexiunea la cloud.

Șablonul oferă comanda de pornire/oprire a releului, un contor electric care citește puterea consumată în timp real și energia consumată cumulată, precum și monitorizarea temperaturii interne.

## Configurare

Shelly Plug S comunică prin HTTP pe portul 80. Nu este necesară nicio configurare specială a protocolului — introduceți adresa IP a dispozitivului ca endpoint de conexiune în TapHome.

## Funcțiile dispozitivului

### Comanda releului

Șablonul oferă releul prizei ca dispozitiv de tip întrerupător. Starea releului se citește din `/settings/relay/0` (câmpul `ison`) și se comandă prin endpointul `/relay/0` cu `turn=on` sau `turn=off`. Intervalul de interogare pentru întrerupător este de 1 secundă.

> [!NOTE]
> Șablonul citește starea întrerupătorului din `/settings/relay/0` (configurația persistentă), nu din `/status` (starea curentă). În condiții normale ambele returnează aceeași valoare, dar după comutări rapide `/settings` poate conține date ușor depășite.

### Contorizarea puterii

Contorul electric încorporat citește două valori din endpointul `/meter/0`:

- **Puterea în timp real** — câmpul `power`, raportat în wați și convertit de șablon în kW
- **Consumul total** — câmpul `total`, raportat în wați-minut și convertit de șablon în kWh

Contorul este doar pentru citire și se actualizează la fiecare 15 secunde (interval de interogare configurabil).

### Monitorizarea temperaturii

Dispozitivul Întrerupător include un atribut de service care citește temperatura internă a prizei din endpointul `/status`. Astfel, temperatura dispozitivului poate fi monitorizată direct în TapHome, fără configurare suplimentară.

### Funcții suplimentare

API-ul Shelly Plug S oferă și un indicator de supratemperatură (oprirea automată a releului la ~95 °C), comanda LED-ului, un prag configurabil de protecție la depășirea puterii (implicit 2300 W), un temporizator de oprire automată, puterea semnalului Wi-Fi (RSSI) și un endpoint de repornire a dispozitivului. Acestea pot fi adăugate într-o actualizare viitoare a șablonului.

## Rezolvarea problemelor

### Dispozitivul nu răspunde

1. Verificați dacă Shelly este conectat la Wi-Fi și are o adresă IP validă
2. Încercați numele de gazdă mDNS (`shellyplug-s-AABBCCDDEE.local`) în locul adresei IP — adresa IP s-ar fi putut schimba după reînnoirea DHCP
3. Deschideți `http://{device-ip}/shelly` într-un browser — dacă răspunde, dispozitivul este accesibil
4. Verificați dacă unitatea centrală TapHome (CCU) și Shelly se află în aceeași rețea / VLAN

### Puterea afișată este zero

1. Verificați dacă aparatul conectat la Shelly Plug S este pornit
2. Verificați dacă releul este pornit — contorul măsoară doar când trece curent
3. Interogați manual `/meter/0` și verificați dacă câmpul `power` returnează o valoare diferită de zero

### Oprire la supratemperatură

Shelly Plug S are protecție termică internă. Dacă temperatura dispozitivului depășește ~95 °C, releul se oprește automat. Asigurați o ventilație adecvată în jurul prizei, mai ales la comutarea aparatelor de putere mare.

> [!WARNING]
> Dispozitivele Shelly Gen1 acceptă doar **2 conexiuni HTTP simultane**. Dacă TapHome și un alt sistem (de ex. Home Assistant) interoghează același dispozitiv în același timp, comunicarea poate deveni instabilă. Dacă dispozitivul este interogat și de un alt sistem, măriți intervalele de interogare din șablon (implicit 1 s pentru întrerupător, 15 s pentru contor), ca să nu suprasolicitați conexiunile.

## Cum se instalează în TapHome

### Cerințe preliminare

- Dispozitiv Shelly instalat și pornit
- Rețea Wi-Fi locală (2,4 GHz)
- TapHome CCU în aceeași rețea

### Pasul 1 — Conectați dispozitivul Shelly la Wi-Fi

**Varianta A — aplicația Shelly (recomandat):**

1. Descărcați [aplicația Shelly](https://www.shelly.com/en/support/shelly-app) (iOS / Android)
2. Atingeți **+** → **Add Device** și urmați asistentul de împerechere prin Bluetooth
3. Introduceți datele de conectare la Wi-Fi când vi se solicită

**Varianta B — modul AP (fără aplicație):**

1. La prima pornire, dispozitivul creează un hotspot: `ShellyXXX-AABBCCDDEE`
2. Conectați telefonul/PC-ul la acest hotspot
3. Deschideți `http://192.168.33.1` → **Internet & Security** → **Wi-Fi Mode - Client**
4. Introduceți SSID-ul și parola → **Save**

> [!NOTE]
> Shelly acceptă doar rețele de **2,4 GHz**. Rețelele de 5 GHz nu vor apărea la scanare.

### Pasul 2 — Găsiți adresa dispozitivului

Dispozitivele Shelly Gen1 acceptă **mDNS** (Zeroconf). Puteți accesa dispozitivul folosind un nume de gazdă în locul adresei IP:

```
shelly<model>-<MAC>.local
```

De exemplu: `shelly1pm-AABBCCDDEE.local` (adresa MAC în hexazecimal cu majuscule, fără două puncte).

> [!TIP]
> **Recomandat: folosiți Scanner IP din TapHome.** Deschideți aplicația TapHome și folosiți **Scanner IP** (Setări → Rețea → Scanare). Scannerul descoperă dispozitivele din rețea și afișează atât adresa IP, cât și numele de gazdă mDNS. Pentru o conexiune mai fiabilă folosiți **numele de gazdă** în locul adresei IP — acesta rămâne același chiar dacă adresa IP a dispozitivului se schimbă după o repornire a routerului.

**Metode alternative** pentru aflarea adresei IP:

- **Aplicația Shelly:** detaliile dispozitivului → **Device info** → adresa IP
- **Interfața web Shelly:** conectați-vă la AP-ul dispozitivului înainte de configurarea Wi-Fi — adresa IP se afișează după salvare
- **Tabelul DHCP al routerului:** căutați un nume de gazdă de forma `shelly1pm-AABBCCDDEE`

### Pasul 3 — Configurați dispozitivul în TapHome

1. În TapHome adăugați un nou modul **Packet Parser (HTTP)**
2. **Address:** introduceți numele de gazdă mDNS (de ex. `shelly1pm-AABBCCDDEE.local`) sau adresa IP de la pasul 2
3. **Port:** `80` (implicit, nu este necesară nicio modificare)
4. Importați șablonul — TapHome va interoga periodic `/status` pentru a citi starea dispozitivului

> [!NOTE]
> Autentificarea HTTP este dezactivată implicit pe dispozitivele Shelly. Dacă ați activat protecția prin autentificare, rețineți că TapHome nu acceptă momentan HTTP Basic Auth — pentru integrarea cu TapHome lăsați autentificarea dezactivată.

## Dispozitive disponibile 2

Aceste dispozitive apar în TapHome după import.

Shelly Plug S Modul

Variabile personalizate

Contor electric Contor electric Doar citire

Măsurarea puterii consumate și a energiei — putere instantanee (kW) și energie cumulată (kWh)

numeric Unitate: kW / kWh

Citirea consumului total

```taphome
# Simple HTTP Request:
VAR response := SENDHTTPREQUEST("/meter/0");
IF response.IsSuccess
 VAR content := response.Content;
 VAR responseHeaders := response.Headers;
 return(PARSEJSON(content,"total")/60000);
ELSE
 ADDERROR(response.StatusCode + " (" + response.ReasonPhrase + ")");
 RETURN(NaN);
END
#
# Set Http request method, body and headers
# VAR response := SENDHTTPREQUEST("/example/getValue", "GET", "some data", "header1:value1", "header2:value2", ...);
# OR
# VAR request := HTTPREQUEST("/example/getValue", "POST", "some data");
# request.headers := { "header1:value1", "header2:value2", ...};
# request.method := "GET";
# request.data := null;
# VAR response := SENDHTTPREQUEST(request);
#
#
# Send TCP, UDP data:
# VAR data1 := BYTECOLLECTION("0a bb ea df 01");
# SENDDATA(data1);
# VAR data2 := "{\"name\":\"John\", \"age\":32}";
# SENDDATA(data2);
# VAR data3 := TOBYTES("{\"name\":\"John\", \"age\":32}", "iso-8859-1");
# SENDDATA(data3);
# Process received TCP or UDP data and set device values in the Listener script
#
#
# Download data from FTP:
# FTPDOWNLOAD("filePath");
```

Citirea cererii

```taphome
VAR response := SENDHTTPREQUEST("/meter/0");
IF response.IsSuccess
 VAR content := response.Content;
 VAR responseHeaders := response.Headers;
 RETURN(PARSEJSON(content, "power")/1000);
END;


# Simple HTTP Request:
# VAR response := SENDHTTPREQUEST("/example/getValue");
# IF response.IsSuccess
#  VAR content := response.Content;
#  VAR responseHeaders := response.Headers;
#  RETURN(PARSEXML(content, "//element1/value1"));
# ELSE
#  ADDERROR(response.StatusCode + " (" + response.ReasonPhrase + ")");
#  RETURN(NaN);
# END
#
# Set Http request method, body and headers
# VAR response := SENDHTTPREQUEST("/example/getValue", "GET", "some data", "header1:value1", "header2:value2", ...);
# OR
# VAR request := HTTPREQUEST("/example/getValue", "POST", "some data");
# request.headers := { "header1:value1", "header2:value2", ...};
# request.method := "GET";
# request.data := null;
# VAR response := SENDHTTPREQUEST(request);
#
#
# Send TCP, UDP data:
# VAR data1 := BYTECOLLECTION("0a bb ea df 01");
# SENDDATA(data1);
# VAR data2 := "{\"name\":\"John\", \"age\":32}";
# SENDDATA(data2);
# VAR data3 := TOBYTES("{\"name\":\"John\", \"age\":32}", "iso-8859-1");
# SENDDATA(data3);
# Process received TCP or UDP data and set device values in the Listener script
#
#
# Download data from FTP:
# FTPDOWNLOAD("filePath");
```

Întrerupător Comutator Citire și scriere

boolean

Valori / Stări: ON · OFF

Citirea stării comutatorului

```taphome
VAR response := SENDHTTPREQUEST("/settings/relay/0");
IF response.IsSuccess
 VAR content := response.Content;
 VAR responseHeaders := response.Headers;
 return(PARSEJSON(content,"ison"));
ELSE
 ADDERROR(response.StatusCode + " (" + response.ReasonPhrase + ")");
 RETURN(NaN);
END
#
# Set Http request method, body and headers
# VAR response := SENDHTTPREQUEST("/example/getValue", "GET", "some data", "header1:value1", "header2:value2", ...);
# OR
# VAR request := HTTPREQUEST("/example/getValue", "POST", "some data");
# request.headers := { "header1:value1", "header2:value2", ...};
# request.method := "GET";
# request.data := null;
# VAR response := SENDHTTPREQUEST(request);
#
#
# Send TCP, UDP data:
# VAR data1 := BYTECOLLECTION("0a bb ea df 01");
# SENDDATA(data1);
# VAR data2 := "{\"name\":\"John\", \"age\":32}";
# SENDDATA(data2);
# VAR data3 := TOBYTES("{\"name\":\"John\", \"age\":32}", "iso-8859-1");
# SENDDATA(data3);
# Process received TCP or UDP data and set device values in the Listener script
#
#
# Download data from FTP:
# FTPDOWNLOAD("filePath");
```

Scrierea stării comutatorului

```taphome
# Simple HTTP Request:
#VAR response := SENDHTTPREQUEST("/relay/0?turn=toggle");
VAR response := SENDHTTPREQUEST("/relay/0?turn="+ if(St = 1, "on","off"));
IF response.IsSuccess = false
 ADDERROR(response.StatusCode);
END
# Set Http request method, body and headers
# VAR response := SENDHTTPREQUEST("/example/setValue", "GET", "value=" + St, "header1:value1", "header2:value2", ...);\r
# Or VAR request := HTTPREQUEST("/example/setValue");
# request.Method := "PUT";
# VAR response := SENDHTTPREQUEST(request);
#r
#
# Send TCP, UDP data:
# VAR data1 := "{\"name\":\"John\", \"age\":" + St + "}";
# SENDDATA(data1);
# VAR data2 := TOBYTES("{\"name\":\"John\", \"age\":" + St + "}", "iso-8859-1");
# SENDDATA(data2);
# You can process received TCP or UDP data in the Listener script
#
#
# Upload data to FTP:
# FTPUPLOAD("filePath", "somedata=" + St, "write"); # use "append" mode to append data to existing file
```

Atribute de service

Temperature

```taphome
VAR response := SENDHTTPREQUEST("/status");
IF response.IsSuccess
 VAR content := response.Content;
 VAR responseHeaders := response.Headers;
 RETURN(PARSEJSON(content, "temperature"));
END;
```

**Conexiune:** Packet Parser → HTTP • Nume gazdă: `shellyplug-s-{MAC}.local`

Îmbunătățiri posibile (7)

- Live relay state — Template reads from /settings/relay/0 instead of /status — /status has real-time state
- Overtemperature flag — Boolean flag in /status, triggers automatic relay shutdown at ~95°C
- LED control — Enable/disable status LED via settings endpoint
- Overpower protection threshold — Configurable maximum power limit (default 2300W), could be a service action
- Auto-off timer — Auto-off timer in seconds, could be added as switch parameter
- WiFi signal strength — WiFi RSSI in dBm, available in /status response
- Reboot — Device reboot endpoint, could be added as service action

## Parametri de import

Introduceți aceste valori când importați XML-ul.

| Solicitat în aplicație | Implicit      |
|------------------------|---------------|
| Adresă IP              | `192.168.0.1` |

## Surse

- Shelly Gen1 API Reference
  
  [shelly-api-docs.shelly.cloud](https://shelly-api-docs.shelly.cloud/gen1/) 2026-03-12
- Shelly Gen1 General Setup
  
  [kb.shelly.cloud](https://kb.shelly.cloud/knowledge-base/shelly-devices-general-setup) 2026-03-12
- Shelly Gen1 HTTP Integration
  
  [kb.shelly.cloud](https://kb.shelly.cloud/knowledge-base/shelly-http-integration) 2026-03-12
- Home Assistant Shelly Integration
  
  [www.home-assistant.io](https://www.home-assistant.io/integrations/shelly/) 2026-03-12
- Shelly Plug S Knowledge Base
  
  [kb.shelly.cloud](https://kb.shelly.cloud/knowledge-base/shelly-plug-s) 2026-03-13
- Shelly Plug S API Endpoints
  
  [shelly-api-docs.shelly.cloud](https://shelly-api-docs.shelly.cloud/gen1/#shelly-plug-plugs) 2026-03-13

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

