---
title: "Shelly EM"
description: "Putere (kW), energie (kWh), tensiune, putere reactivă per canal și comanda releului pentru contactor prin HTTP sau MQTT. Șablon TapHome Shelly EM Gen1."
url: "https://taphome.com/ro/compatibility/shelly-em/"
language: ro
lastmod: 2026-03-29
generator: hugo
ai:
  topics: ["http","mqtt","electric-meter","wifi","energy-metering","contactor-control","ct-clamp"]
  questions: ["Cum integrez Shelly EM cu TapHome?","Ce măsoară șablonul TapHome Shelly EM?","Cum conectez Shelly EM la TapHome prin HTTP?","Cum conectez Shelly EM la TapHome prin MQTT?","Poate Shelly EM să monitorizeze energia solară injectată în rețea?","Cum comand un contactor cu Shelly EM în TapHome?"]
---

# Shelly EM

Comunicație: Packet Parser → HTTP

- [Pagina produsului Shelly EM](https://www.shelly.com/en/products/shop/shelly-em)

> 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 EM este un contor electric monofazat cu două canale de măsurare independente și o ieșire de releu de 2 A pentru comanda unui contactor. Fiecare canal se conectează la un clește CT (transformator de curent) extern — disponibil în variantele de 50 A și 120 A —, ceea ce permite monitorizarea neinvazivă a două circuite separate în același timp. TapHome se integrează local cu dispozitivul, prin Wi-Fi, folosind fie API-ul HTTP REST, fie MQTT. Nu este necesară conexiunea la cloud.

Sunt disponibile două șabloane TapHome: un **șablon HTTP**, care interoghează endpointurile REST ale dispozitivului, și un **șablon MQTT**, care primește datele printr-un broker MQTT. Ambele oferă aceleași trei dispozitive — două contoare electrice (câte unul pe canal) și un întrerupător pentru contactor.

## Configurare

### Șablonul HTTP

Șablonul HTTP necesită doar adresa IP a dispozitivului (sau numele de gazdă mDNS). TapHome interoghează trei endpointuri la fiecare 15 secunde:

- `/emeter/0/` — datele de energie ale canalului 1
- `/emeter/1/` — datele de energie ale canalului 2
- `settings/relay/0` — starea releului și verificarea programării

Scriptul de citire de la nivelul modulului salvează fiecare răspuns într-o variabilă personalizată (`emeterZero`, `emeterOne`, `status`), astfel încât scripturile fiecărui dispozitiv să poată analiza datele fără apeluri HTTP redundante.

> [!NOTE]
> Șablonul verifică și starea programării releului din `settings/relay/0`. Dacă pe dispozitivul Shelly este activată programarea internă, șablonul generează o eroare — dezactivați programarea în interfața web Shelly pentru a evita conflictele cu automatizarea TapHome.

### Șablonul MQTT

Șablonul MQTT necesită adresa IP și portul brokerului, precum și **ID-ul dispozitivului** Shelly (format: `shellyem-XXXXXXXXXXXX`, unde X = cifrele hexazecimale ale adresei MAC). ID-ul dispozitivului se găsește în interfața web Shelly, la **Settings** > **Device Info**.

După activarea MQTT pe Shelly EM (Internet & Security > Advanced — MQTT), TapHome se abonează la topicurile `shellies/shellyem-{deviceID}/` și primește datele prin scripturi de ascultare.

> [!WARNING]
> La dispozitivele Shelly Gen1, activarea MQTT **dezactivează Shelly Cloud**. Cele două nu pot funcționa simultan.

## Funcțiile dispozitivului

### Contorizarea energiei (pe fiecare canal)

Fiecare canal apare în TapHome ca dispozitiv independent de tip contor electric și oferă:

- **Putere instantanee** — puterea activă în kW (convertită din W prin împărțire la 1000)
- **Energie cumulată** — energia totală consumată în kWh (HTTP: convertită din Wh; MQTT: folosește topicul persistent `total` în Wh)

Șablonul HTTP citește câmpurile `power` și `total` din răspunsul JSON `/emeter/{i}/`. Șablonul MQTT ascultă topicul `emeter/{i}/energy` (wați-minut; valoarea se împarte la 60 000 pentru kWh) și topicul `emeter/{i}/total` (wați-oră, persistent după repornire).

> [!TIP]
> Topicul MQTT `energy` se resetează la zero la repornirea dispozitivului. Pentru urmărirea persistentă a energiei, șablonul citește și topicul `total`, care se păstrează după repornire.

Fiecare canal oferă și trei atribute de service:

| Atribut | Unitate | Descriere |
|-----------|------|-------------|
| Tensiune | V | Tensiunea RMS a liniei |
| Energie returnată | Wh | Energia totală returnată în rețea — pentru contorizarea solară/bidirecțională |
| Putere reactivă | VAR | Puterea reactivă instantanee |

> [!NOTE]
> Șablonul MQTT oferă pe fiecare canal doar tensiunea ca atribut de service. Puterea reactivă și energia returnată sunt disponibile doar în șablonul HTTP.

### Întrerupătorul pentru contactor

Ieșirea releului apare în TapHome ca dispozitiv de tip întrerupător. Releul are un curent nominal de **2 A la 230 V AC** — este destinat doar comenzii unui contactor, nu comutării directe a sarcinii.

- **HTTP:** citește `ison` din `settings/relay/0` și comandă prin `/relay/0?turn=on` sau `/relay/0?turn=off`
- **MQTT:** citește din topicul `shellies/shellyem-{id}/relay/0` și publică `on`/`off` pe `shellies/shellyem-{id}/relay/0/command`

> [!WARNING]
> Releul are un curent nominal de doar 2 A. Pentru sarcinile care depășesc această valoare folosiți întotdeauna un contactor extern. Conectarea directă a sarcinilor de putere mare va deteriora releul.

### Funcții suplimentare

Shelly EM oferă și factorul de putere (0,00–1,00) și un indicator de validitate a măsurării pe fiecare canal, configurarea fiecărui canal (raportul CT, limita maximă de putere), resetarea contorului electric, un temporizator de oprire automată pentru releu și puterea semnalului Wi-Fi. Prin MQTT sunt disponibile și topicuri suplimentare pentru puterea în timp real, puterea reactivă și energia returnată pe fiecare canal. 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 EM este conectat la Wi-Fi și are o adresă IP validă
2. Deschideți `http://{device-ip}/shelly` într-un browser — dacă răspunde cu un JSON care conține `"type":"SHEM"`, dispozitivul este accesibil
3. Verificați dacă unitatea de control TapHome (CCU) și Shelly EM se află în aceeași rețea / VLAN

### Lipsesc datele pe un canal

1. Verificați dacă cleștele CT este conectat la mufa jack de 3,5 mm corectă (canalul 0 sau canalul 1)
2. Verificați dacă prin conductorul monitorizat trece curent — cleștele CT trebuie să cuprindă un singur conductor, nu întregul cablu
3. Interogați manual `/emeter/0/` și `/emeter/1/` pentru a confirma valori `power` diferite de zero

### Mesajele MQTT nu sosesc

1. Verificați dacă MQTT este activat în interfața web Shelly (Internet & Security > Advanced — MQTT)
2. Verificați dacă adresa și portul brokerului sunt corecte atât în dispozitivul Shelly, cât și în setările modulului TapHome
3. Verificați dacă variabila personalizată `deviceID` corespunde exact ID-ului dispozitivului Shelly (de ex. `B929CC`)
4. Folosiți un client MQTT (de ex. MQTT Explorer) pentru a vă abona la `shellies/#` și verificați dacă dispozitivul publică mesaje

### Eroare de conflict cu programarea

Șablonul HTTP verifică câmpul `schedule` din `settings/relay/0`. Dacă pe dispozitivul Shelly este activată programarea internă, șablonul raportează o eroare. Dezactivați programarea în interfața web Shelly (Settings > Relay > Schedule) — folosiți în schimb automatizările TapHome.

> [!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ă. În mediile cu mai multe sisteme, luați în considerare trecerea la șablonul MQTT.

## 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 3

Aceste dispozitive apar în TapHome după import.

Shelly EM Modul

Variabile personalizate

Citire (modul)

```taphome
VAR response := SENDHTTPREQUEST("settings/relay/0");
IF response.IsSuccess
 status := response.Content;
 IF PARSEJSON(status, "schedule")
  ADDERROR("Internal scheduling on");
 END
ELSE
 ADDERROR(response.StatusCode + " (" + response.ReasonPhrase + ")");
 RETURN(NaN);
END
response := SENDHTTPREQUEST("/emeter/0/");
IF response.IsSuccess
 emeterZero := response.Content;
ELSE
 ADDERROR(response.StatusCode + " (" + response.ReasonPhrase + ")");
 RETURN(NaN);
END
response := SENDHTTPREQUEST("/emeter/1/");
IF response.IsSuccess
 emeterOne := response.Content;
ELSE
 ADDERROR(response.StatusCode + " (" + response.ReasonPhrase + ")");
 RETURN(NaN);
END
```

Contor electric — canalul 1 Contor electric Doar citire

Putere instantanee (kW) și energie cumulată (kWh) de la cleștele CT de pe canalul 1

numeric Unitate: kW / kWh json\_path

Atribute de service

|                   |                                                                                                              |
|-------------------|--------------------------------------------------------------------------------------------------------------|
| Tensiune          |                                                                                                              |
| Energie returnată | Energia totală returnată în rețea pe canalul 1 — pentru instalațiile solare și cu contorizare bidirecțională |
| Putere reactivă   |                                                                                                              |

Citirea consumului total

```taphome
RETURN(PARSEJSON(emeterZero, "total")/1000);
```

Citirea cererii

```taphome
RETURN(PARSEJSON(emeterZero, "power")/1000);
```

Atribute de service

Voltage \[V]

```taphome
RETURN(PARSEJSON(emeterZero, "voltage"));
```

backward \[Wh]

```taphome
RETURN(PARSEJSON(emeterZero, "total_returned"));
```

reactive \[W]

```taphome
RETURN(PARSEJSON(emeterZero, "reactive"));
```

Contor electric — canalul 2 Contor electric Doar citire

Putere instantanee (kW) și energie cumulată (kWh) de la cleștele CT de pe canalul 2

numeric Unitate: kW / kWh json\_path

Atribute de service

|                   |                                                                                                              |
|-------------------|--------------------------------------------------------------------------------------------------------------|
| Tensiune          |                                                                                                              |
| Energie returnată | Energia totală returnată în rețea pe canalul 2 — pentru instalațiile solare și cu contorizare bidirecțională |
| Putere reactivă   |                                                                                                              |

Citirea consumului total

```taphome
RETURN(PARSEJSON(emeterOne, "total")/1000);
```

Citirea cererii

```taphome
RETURN(PARSEJSON(emeterOne, "power")/1000);
```

Atribute de service

Voltage \[V]

```taphome
RETURN(PARSEJSON(emeterOne, "voltage"));
```

backward \[Wh]

```taphome
RETURN(PARSEJSON(emeterOne, "total_returned"));
```

reactive \[W]

```taphome
RETURN(PARSEJSON(emeterOne, "reactive"));
```

Întrerupător pentru contactor Comutator Citire și scriere

Ieșire de releu de 2 A pentru comanda contactorului — nu este destinată comutării directe a sarcinii

boolean

Valori / Stări: ON · OFF

Citirea stării comutatorului

```taphome
RETURN(PARSEJSON(status, "ison"));
```

Scrierea stării comutatorului

```taphome
# Simple HTTP Request:
# VAR response := SENDHTTPREQUEST("/example/set/value=" + St);
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
```

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

Îmbunătățiri posibile (9)

- Power Factor — Power factor (0.00–1.00) per channel, available in /emeter/{i} and /status response. Not available via MQTT.
- Measurement Validity — Boolean flag indicating if the measurement is valid. Available per channel in /emeter/{i}.
- Per-Channel Configuration — CT ratio (ctrafos: 50/120), max\_power limit, appliance\_type. Could be exposed as service actions.
- Reset Energy Counters — Resets accumulated energy data for both channels. Available via HTTP GET and MQTT command topic.
- Auto-off Timer — Auto-off timer in seconds on relay endpoint. Could be added as service action parameter.
- WiFi Signal Strength — WiFi RSSI in dBm, available in /status response
- MQTT Real-time Power — Instantaneous power via MQTT (W). MQTT template uses energy+total topics instead.
- MQTT Reactive Power — Reactive power via MQTT (VAR). HTTP template has it as service attribute, MQTT template does not.
- MQTT Energy Returned — Energy returned to grid via MQTT (Wh). HTTP template has it as service attribute (backward), MQTT template does not.

## 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
- Shelly EM — API Endpoints & MQTT Topics
  
  [shelly-api-docs.shelly.cloud](https://shelly-api-docs.shelly.cloud/gen1/#shelly-em) 2026-03-29
- Shelly EM — Product Specifications
  
  [robomaterial.com](https://robomaterial.com/product/shelly-em-single-phase-energy-meter-with-contactor-control/) 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/)

