---
title: "Shelly 1PM"
description: "Releu Wi-Fi Shelly 1PM cu măsurarea puterii. Comanda unui circuit și monitorizarea consumului de putere în timp real prin HTTP din TapHome."
url: "https://taphome.com/ro/compatibility/shelly-1pm/"
language: ro
lastmod: 2026-03-12
generator: hugo
ai:
  topics: ["http","electric-meter","wifi","relay","power-metering"]
  questions: ["Cum se integrează Shelly 1PM cu TapHome?","Ce măsoară șablonul TapHome pentru Shelly 1PM?","Cum se conectează Shelly 1PM prin HTTP la TapHome?","De ce Shelly 1PM afișează puterea zero?","Cum se setează limita de protecție a puterii la Shelly 1PM din TapHome?","Ce funcții de diagnosticare sunt disponibile pentru Shelly 1PM în TapHome?"]
---

# Shelly 1PM

Comunicație: Packet Parser → HTTP

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

> 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 1PM este un releu Wi-Fi compact 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). TapHome comunică cu dispozitivul prin HTTP în rețeaua locală — nu este necesară conexiunea la cloud.

Șablonul oferă comanda releului și un contor electric care citește consumul de putere în timp real și consumul de energie cumulat.

## Configurare

Shelly 1PM se conectează prin Wi-Fi. La importul șablonului în TapHome, introduceți adresa IP a dispozitivului (valoarea implicită: `192.168.0.1`).

## Funcțiile dispozitivului

### Comanda releului

Șablonul oferă releul ca dispozitiv de tip întrerupător. Starea releului se citește din răspunsul `/status` (`relays[0].ison`), iar releul se comandă prin endpointul `/relay/0` cu `turn=on` sau `turn=off`.

### Măsurarea puterii

Contorul electric integrat citește două valori din răspunsul `/status`:

- **Putere în timp real** — `meters[0].power`, raportată în wați și convertită de șablon în kW
- **Consum total** — `meters[0].total`, raportat în wați-minut și convertit de șablon în kWh

Contorul este doar pentru citire — se actualizează automat la fiecare ciclu de interogare.

### Diagnosticare de service

Șablonul oferă 13 atribute de service pentru monitorizarea dispozitivului:

- **Informații despre dispozitiv** — numele de gazdă, adresa MAC, ora dispozitivului, timpul de funcționare, utilizarea RAM
- **Protecție termică** — temperatura internă (°C), starea temperaturii (Normal / High / Very High), indicatorul de supratemperatură
- **Conectivitate** — cloud activat/conectat, MQTT conectat, actualizare de firmware disponibilă
- **Protecție la depășirea puterii** — limita curentă de putere maximă (citită din `/settings`)

### Acțiuni de service

Sunt disponibile trei acțiuni de service:

- **Setare protecție la depășirea puterii** — setează limita de putere maximă (1–3500 W). Releul se oprește automat dacă consumul depășește această valoare.
- **Activare cloud** — activează sau dezactivează conectivitatea Shelly Cloud
- **Repornire** — repornește dispozitivul

### Funcții suplimentare

În răspunsul `/status`, Shelly 1PM oferă și tensiunea rețelei, puterea reactivă, starea intrării fizice și puterea semnalului Wi-Fi. La endpointul releului este disponibil un temporizator de oprire automată. Aceste funcții 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 să folosiți numele de gazdă mDNS (`shelly1pm-AABBCCDDEE.local`) în locul adresei IP — adresa IP se poate schimba după reînnoirea DHCP
3. Deschideți `http://{device-ip}/shelly` în browser — dacă răspunde, dispozitivul este accesibil
4. Verificați dacă unitatea centrală TapHome (CCU) și Shelly sunt în aceeași rețea / VLAN

### 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 `/status` și verificați dacă `meters[0].power` returnează o valoare diferită de zero

### Avertizare de supratemperatură

Shelly 1PM are protecție termică internă. Dacă temperatura dispozitivului depășește limitele sigure, `temperature_status` se schimbă în „High” sau „Very High”, iar `overtemperature` devine `true`. Asigurați o ventilație suficientă în jurul dispozitivului, mai ales la comutarea sarcinilor mari.

> [!WARNING]
> Dispozitivele Shelly Gen1 acceptă doar **2 conexiuni HTTP simultane**. Dacă TapHome și un alt sistem (de ex. Home Assistant) interoghează simultan același dispozitiv, comunicarea poate deveni instabilă. Folosiți un interval de interogare de 10–30 de secunde.

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

Atribute de service

|                                      |
|--------------------------------------|
| Protecție la depășirea puterii       |
| Nume de gazdă                        |
| Adresă MAC                           |
| Ora dispozitivului                   |
| Timp de funcționare                  |
| RAM                                  |
| Temperatura internă a dispozitivului |
| Stare temperatură                    |
| Actualizare FW                       |
| Cloud activat                        |
| Cloud conectat                       |
| MQTT conectat                        |
| Supraîncălzit                        |

Acțiuni de service

|                                       |
|---------------------------------------|
| Setare protecție la depășirea puterii |
| Activare cloud                        |
| Repornire                             |

Variabile personalizate

Citire (modul)

```taphome
VAR response := SENDHTTPREQUEST("/status", "GET");
StatusJson := response.Content;
```

Atribute de service

Power protection

```taphome
VAR response := SENDHTTPREQUEST("/settings", "GET");
SettingsJson := response.Content;

response := SENDHTTPREQUEST("/status", "GET");
StatusJson := response.Content;

PARSEJSON(SettingsJson, "max_power") + "W";
```

Host name

```taphome
PARSEJSON(SettingsJson, "device.hostname");
```

Mac address

```taphome
PARSEJSON(StatusJson, "mac");
```

Device time

```taphome
PARSEJSON(StatusJson, "time")
```

Uptime

```taphome
VAR upTimeSeconds := PARSEJSON(StatusJson, "uptime");
VAR days := FLOOR(upTimeSeconds/86400, 1);
uptimeSeconds := MOD(upTimeSeconds, 86400);
var hours := FLOOR(upTimeSeconds/3600, 1);
uptimeSeconds := MOD(upTimeSeconds, 3600);
var minutes := FLOOR(upTimeSeconds/60, 1);
days + "day(s) " + hours + "h " + minutes + "m"
```

RAM

```taphome
var ramTotal := PARSEJSON(StatusJson, "ram_total");
var ramFree := PARSEJSON(StatusJson, "ram_free");
ramFree + " bytes free of " + ramTotal
```

Internal device temperature

```taphome
PARSEJSON(StatusJson, "temperature") + "°C"
```

Temperature status

```taphome
PARSEJSON(StatusJson, "temperature_status");
```

FW update

```taphome
PARSEJSON(StatusJson, "has_update");
```

Cloud enabled

```taphome
PARSEJSON(StatusJson, "cloud.enabled");
```

Cloud connected

```taphome
PARSEJSON(StatusJson, "cloud.connected");
```

MQTT connected

```taphome
PARSEJSON(StatusJson, "mqtt.connected");
```

Overheated

```taphome
PARSEJSON(StatusJson, "overtemperature");
```

Acțiuni de service

Set power protection

Parametri: Maximum power (1–3500 Watts)

```taphome
VAR response := SENDHTTPREQUEST("settings?max_power=" + Watts);
VAR contentJson := response.Content;
VAR limitSet := PARSEJSON(contentJson, "max_power");

"Power limit set to " + limitSet + "W"
```

Enable cloud

Parametri: Enable (Enable / Disable)

```taphome
VAR response := SENDHTTPREQUEST("/settings/cloud?enabled=" + enable);
VAR contentJson := response.Content;
VAR wasEnabled := PARSEJSON(contentJson, "enabled");

IF(wasEnabled, "Cloud enabled", "Cloud disabled");
```

Reboot

```taphome
VAR response := SENDHTTPREQUEST("/reboot");
VAR contentJson := response.Content;
VAR wasRebooted := PARSEJSON(contentJson, "ok");

IF(wasRebooted, "Reboot successful", "Error");
```

Întrerupător Comutator Citire și scriere

boolean

Valori / Stări: ON · OFF

Citirea stării comutatorului

```taphome
VAR value := PARSEJSON(StatusJson, "relays[0].ison", 1);
IF(ISNULL(value), NaN, value);
```

Scrierea stării comutatorului

```taphome
VAR path := "relay/0?turn=" + SWITCH(St, 0, "off", 1, "on","off");
SENDHTTPREQUEST(path);
```

Contor electric Contor electric Doar citire

Măsurarea consumului de putere și de energie — putere instantanee (kW) și energie cumulată (kWh)

numeric Unitate: W / kWh

Citirea consumului total

```taphome
VAR total := PARSEJSON(StatusJson, "meters[0].total", 1);
IF(ISNULL(total), NaN, total / 60000.0);
```

Citirea cererii

```taphome
VAR power := PARSEJSON(StatusJson, "meters[0].power", 1);
IF(ISNULL(power), NaN, power / 1000.0);
```

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

Îmbunătățiri posibile (5)

- Voltage — Line voltage in V, available in /status response
- Reactive Power — Reactive power in VAR, available in /status response
- Input State — Physical input state (0/1), available in /status response
- WiFi Signal Strength — WiFi RSSI in dBm, available in /status response
- Auto-off Timer — Auto-off timer in seconds, could be added as service action or switch parameter

## 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
- Home Assistant Shelly Integration
  
  [www.home-assistant.io](https://www.home-assistant.io/integrations/shelly/) 2026-03-12

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

