---
title: "Shelly Plus 1PM"
description: "Releu Wi-Fi Shelly Plus 1PM Gen2+ cu măsurarea puterii. Putere în timp real (kW), energie (kWh), tensiune, curent, temperatură prin HTTP/MQTT din TapHome."
url: "https://taphome.com/ro/compatibility/shelly-plus-1pm/"
language: ro
lastmod: 2026-03-29
generator: hugo
ai:
  topics: ["http","mqtt","electric-meter","wifi","relay","power-metering","gen2plus"]
  questions: ["Cum integrez Shelly Plus 1PM cu TapHome?","Ce măsoară șablonul TapHome pentru Shelly Plus 1PM?","Cum conectez Shelly Plus 1PM prin HTTP la TapHome?","Cum conectez Shelly Plus 1PM prin MQTT la TapHome?","Care este diferența dintre Shelly Plus 1PM și Shelly 1PM în TapHome?","De ce Shelly Plus 1PM afișează o putere zero?","Ce informații de diagnosticare sunt disponibile pentru Shelly Plus 1PM în TapHome?","Pot folosi MQTT în loc de HTTP pentru Shelly Plus 1PM?"]
---

# Shelly Plus 1PM

Comunicație: Packet Parser → HTTP

- [Pagina produsului Shelly Plus 1PM](https://www.shelly.com/en/products/shop/shelly-plus-1pm)
- [Documentația API Shelly Plus 1PM](https://shelly-api-docs.shelly.cloud/gen2/)

> 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 Plus 1PM este un releu Wi-Fi compact Gen2+ cu măsurarea integrată a puterii. Se montează în spatele unui întrerupător de perete standard și poate comanda un circuit de până la 16 A (3500 W la 230 V AC) sau 10 A (30 V DC). Dispozitivul acceptă alimentare la 110-240 VAC sau 24-30 VDC, fiind potrivit atât pentru instalații alimentate de la rețea, cât și pentru instalații de joasă tensiune. TapHome comunică cu dispozitivul local, prin Wi-Fi — nu este necesară conexiunea la cloud.

Sunt disponibile două șabloane TapHome: un **șablon HTTP**, care interoghează API-ul RPC Gen2+ al dispozitivului, și un **șablon MQTT**, care primește datele printr-un broker MQTT. Ambele oferă aceleași două dispozitive — un contor electric și un întrerupător cu releu.

## Configurare

### Șablonul HTTP

Șablonul HTTP necesită doar adresa IP a dispozitivului (valoarea implicită: `192.168.0.1`). TapHome interoghează endpointul `/rpc/Switch.GetStatus?id=0` atât pentru starea releului, cât și pentru datele de măsurare a puterii. Modulul păstrează răspunsul JSON în variabila `status`, astfel încât scripturile dispozitivelor individuale să îl poată analiza fără apeluri HTTP redundante.

### Șablonul MQTT

Șablonul MQTT necesită trei parametri la import:

- **MQTT Broker IP** — adresa IP a brokerului MQTT (nu a dispozitivului Shelly)
- **MQTT Broker Port** — implicit `1883`
- **Shelly MQTT Client ID** — în formatul `shellyplus1pm-{deviceid}`, se găsește în interfața web Shelly la **Settings** > **MQTT Settings** > **Client ID**

După activarea MQTT pe Shelly Plus 1PM (Settings > MQTT), TapHome se abonează la `shellyplus1pm-{deviceid}/status/switch:0` și publică comenzile de control pe `shellyplus1pm-{deviceid}/command/switch:0`.

## Funcțiile dispozitivului

### Comanda releului

Șablonul oferă releul ca dispozitiv de tip întrerupător. Starea releului se citește din câmpul `output` (boolean), iar releul se comandă prin `/rpc/Switch.Set?id=0` cu `on=true` sau `on=false` (HTTP) ori prin publicarea `on`/`off` pe topicul de comandă (MQTT).

Șablonul HTTP interoghează releul la un interval de 2,5 secunde, ceea ce asigură o actualizare a stării aproape în timp real. Șablonul MQTT primește actualizările imediat ce apar, prin scriptul de ascultare.

### Măsurarea puterii

Contorul electric integrat citește două valori din răspunsul Switch.GetStatus:

- **Putere instantanee** — `apower`, raportată în wați și convertită de șablon în kW (împărțire la 1000)
- **Energie cumulată** — `aenergy.total`, raportată în wați-oră și convertită de șablon în kWh (împărțire la 1000)

Contorul este doar pentru citire — se actualizează automat la fiecare ciclu de interogare (HTTP) sau la fiecare mesaj de stare MQTT.

Șablonul HTTP oferă și trei atribute de service pentru contorul electric:

| Atribut | Unitate | Descriere |
|-----------|------|-------------|
| Curent | A | Curentul consumat în acest moment |
| Tensiune | V | Tensiunea RMS a rețelei |
| Temperatură | °C | Temperatura internă a dispozitivului |

Șablonul MQTT oferă temperatura internă, tensiunea și curentul ca atribute de service la nivel de modul, cu aceleași date, preluate din mesajul de stare MQTT.

### Funcții suplimentare

Prin API-ul RPC, Shelly Plus 1PM furnizează și factorul de putere, frecvența rețelei, energia returnată (pentru contorizare bidirecțională), starea intrării fizice, puterea semnalului Wi-Fi, adresa MAC, timpul de funcționare, utilizarea RAM și ora dispozitivului. Sunt disponibile și acțiunea de actualizare a firmware-ului, repornirea dispozitivului, temporizatorul de oprire automată, resetarea contorului electric și configurarea protecției la depășirea puterii. Aceste funcții pot fi adăugate într-o actualizare viitoare a șablonului.

## Rezolvarea problemelor

### Dispozitivul nu răspunde (HTTP)

1. Verificați dacă Shelly este conectat la Wi-Fi și are o adresă IP validă
2. Încercați să folosiți numele de gazdă mDNS (`shellyplus1pm-AABBCCDDEE.local`) în locul adresei IP — adresa IP se poate schimba după reînnoirea DHCP
3. Deschideți `http://{device-ip}/rpc/Shelly.GetDeviceInfo` în browser — dacă răspunde cu JSON, dispozitivul este accesibil
4. Verificați dacă unitatea centrală TapHome (CCU) și Shelly sunt în aceeași rețea / VLAN
5. Asigurați-vă că autentificarea HTTP Digest este dezactivată în interfața web Shelly — TapHome nu acceptă cereri autentificate

### Mesajele MQTT nu ajung

1. Verificați dacă MQTT este activat în interfața web Shelly (Settings > MQTT)
2. Verificați dacă adresa și portul brokerului sunt corecte atât pe dispozitivul Shelly, cât și în setările modulului TapHome
3. Verificați dacă variabila personalizată `plug1topic` corespunde exact Client ID-ului MQTT al dispozitivului Shelly (de ex. `shellyplus1pm-AABBCCDDEE`)
4. Folosiți un client MQTT (de ex. MQTT Explorer) pentru a vă abona la `shellyplus1pm-#` și verificați dacă dispozitivul publică mesaje

### Puterea afișată este zero

1. Verificați dacă sarcina este conectată prin releul Shelly (nu ocolește releul)
2. Verificați dacă releul este pornit — contorul măsoară doar atunci când curentul trece prin releu
3. Interogați manual `/rpc/Switch.GetStatus?id=0` și verificați dacă `apower` returnează o valoare diferită de zero

### Răspuns lent sau erori de timeout

1. Dispozitivele Gen2+ acceptă până la 6 conexiuni HTTP simultane (față de 2 la Gen1) — evitați totuși interogarea excesivă din mai multe sisteme
2. Dezactivați modul ECO în interfața web Shelly, dacă este activat — acesta trece dispozitivul în repaus între interogări și poate provoca erori de timeout la intervale scurte de interogare
3. Folosiți o adresă IP statică sau o rezervare DHCP pentru a preveni schimbarea adresei
4. În medii cu mai multe sisteme, luați în considerare trecerea la șablonul MQTT — MQTT evită complet problema limitei de conexiuni

## 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 Plus 1PM Modul

Variabile personalizate

Contor electric Contor electric Doar citire

Putere instantanee (kW) și energie cumulată (kWh), cu diagnosticarea curentului, tensiunii și temperaturii

numeric Unitate: kW / kWh

Atribute de service

|             |
|-------------|
| Curent      |
| Tensiune    |
| Temperatură |

Citirea consumului total

```taphome
return(parsejson(parsejson(status,"aenergy"), "total")/1000);
```

Citirea cererii

```taphome
return(parsejson(status,"apower")/1000);
```

Citire (modul)

```taphome
var x := (sendhttprequest("/rpc/Switch.GetStatus?id=0"));
status := x.Content;
```

Atribute de service

${current} \[a]

```taphome
return(parsejson(status,"current"));
```

${electric\_voltage} \[v]

```taphome
return(parsejson(status,"voltage"));
```

${temp} \[C]

```taphome
return(parsejson(parsejson(status,"temperature"), "tC"));
```

Întrerupător Comutator Citire și scriere

boolean

Valori / Stări: ON · OFF

Citirea stării comutatorului

```taphome
var x := (sendhttprequest("/rpc/Switch.GetStatus?id=0"));
status := x.Content;
return(PARSEJSON(status, "$.output", true));
```

Scrierea stării comutatorului

```taphome
VAR response := SENDHTTPREQUEST("rpc/Switch.Set?id=0&on=" + if(St,"true","false"));
IF response.IsSuccess = false
  ADDERROR(response.StatusCode);
END
```

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

Îmbunătățiri posibile (16)

- Power Factor — Power factor value, available in Switch.GetStatus response for metered devices
- Network Frequency — AC network frequency in Hz, available in Switch.GetStatus response
- Returned Energy — Returned/exported energy in Wh, for bi-directional metering scenarios
- Input State — Physical switch/button input state, available via /rpc/Input.GetStatus?id=0
- WiFi SSID — Connected WiFi network name, available via /rpc/WiFi.GetStatus
- WiFi Signal Strength — WiFi RSSI in dBm, available via /rpc/WiFi.GetStatus
- IP Address — Device IP address, available via /rpc/WiFi.GetStatus
- MAC Address — Device MAC address, available via /rpc/Sys.GetStatus
- Uptime — Seconds since last reboot, available in Sys.GetStatus response
- RAM Usage — Total and free RAM in bytes, available in Sys.GetStatus response
- Device Time — Current device time in HH:MM format, available in Sys.GetStatus response
- Firmware Update — Trigger firmware update to stable channel, available via Shelly.Update RPC method
- Reboot — Reboot the device, available via Shelly.Reboot RPC method
- Auto-off Timer — Auto-reset timer in seconds via toggle\_after parameter, could be added as switch parameter
- Reset Energy Counters — Resets energy measurement counters (aenergy, ret\_aenergy)
- Overpower Protection — Configurable power limit threshold in Watts, relay turns off when exceeded

## 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 Gen2+/Gen3 RPC API Reference
  
  [shelly-api-docs.shelly.cloud](https://shelly-api-docs.shelly.cloud/gen2/) 2026-03-29
- Shelly Gen2+ Switch Component API
  
  [shelly-api-docs.shelly.cloud](https://shelly-api-docs.shelly.cloud/gen2/ComponentsAndServices/Switch/) 2026-03-29
- Shelly Gen2+ System (Sys) Component API
  
  [shelly-api-docs.shelly.cloud](https://shelly-api-docs.shelly.cloud/gen2/ComponentsAndServices/Sys/) 2026-03-29
- Shelly Gen2+ WiFi Component API
  
  [shelly-api-docs.shelly.cloud](https://shelly-api-docs.shelly.cloud/gen2/ComponentsAndServices/WiFi/) 2026-03-29
- Shelly Gen2+ MQTT Component API
  
  [shelly-api-docs.shelly.cloud](https://shelly-api-docs.shelly.cloud/gen2/ComponentsAndServices/Mqtt/) 2026-03-29
- Home Assistant Shelly Integration
  
  [www.home-assistant.io](https://www.home-assistant.io/integrations/shelly/) 2026-03-29
- Shelly Plus 1PM Knowledge Base — specs & wiring
  
  [kb.shelly.cloud](https://kb.shelly.cloud/knowledge-base/shelly-plus-1pm) 2026-03-29

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

