---
title: "Shelly EM"
description: "Snaga (kW), energija (kWh), napon i jalova snaga po kanalu te upravljanje relejem sklopnika preko HTTP-a ili MQTT-a. Predložak TapHome za Shelly EM Gen1."
url: "https://taphome.com/hr/compatibility/shelly-em/"
language: hr
lastmod: 2026-03-29
generator: hugo
ai:
  topics: ["http","mqtt","electric-meter","wifi","energy-metering","contactor-control","ct-clamp"]
  questions: ["Kako integrirati Shelly EM sa sustavom TapHome?","Što mjeri predložak TapHome za Shelly EM?","Kako spojiti Shelly EM preko HTTP-a na TapHome?","Kako spojiti Shelly EM preko MQTT-a na TapHome?","Može li Shelly EM pratiti energiju koju solarna elektrana predaje u mrežu?","Kako pomoću uređaja Shelly EM upravljati sklopnikom u sustavu TapHome?"]
---

# Shelly EM

Komunikacija: Packet Parser → HTTP

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

> Adresa u mreži
> 
> TapHome komunicira s uređajem na adresi unesenoj pri uvozu. Dodijelite uređaju stalnu adresu — rezervaciju IP adrese u usmjerivaču ili njegovo mDNS ime ako ga podržava — inače integracija prestaje raditi kada usmjerivač promijeni adresu.
> 
> [Priprema mreže](https://taphome.com/hr/docs/setup/network-preparation/)

## Upute za integraciju

Shelly EM je jednofazno brojilo energije s dva neovisna mjerna kanala i relejnim izlazom od 2 A za upravljanje sklopnikom. Na svaki se kanal spaja vanjski strujni transformator (CT) s razdvojivom jezgrom, dostupan u izvedbama od 50 A i 120 A, pa se dva zasebna strujna kruga mogu istodobno pratiti bez zahvata u instalaciju. TapHome se s uređajem povezuje lokalno preko Wi-Fi mreže, putem HTTP REST API-ja ili MQTT-a. Veza s oblakom nije potrebna.

Dostupna su dva predloška TapHome: **HTTP predložak** koji očitava REST krajnje točke uređaja i **MQTT predložak** koji podatke prima preko MQTT brokera. Oba daju ista tri uređaja: dva brojila energije (po jedno za svaki kanal) i sklopku za sklopnik.

## Konfiguracija

### HTTP predložak

HTTP predložak zahtijeva samo IP adresu uređaja (ili mDNS naziv hosta). TapHome svakih 15 sekundi očitava tri krajnje točke:

- `/emeter/0/`: podaci o energiji kanala 1
- `/emeter/1/`: podaci o energiji kanala 2
- `settings/relay/0`: stanje releja i provjera rasporeda

Skripta za čitanje na razini modula svaki odgovor sprema u korisničku varijablu (`emeterZero`, `emeterOne`, `status`), pa skripte pojedinih uređaja mogu raščlaniti podatke bez suvišnih HTTP poziva.

> [!NOTE]
> Predložak iz `settings/relay/0` provjerava i stanje rasporeda releja. Ako je na uređaju Shelly uključen interni raspored, predložak javlja pogrešku. Isključite raspored u web-sučelju Shelly kako ne bi bio u sukobu s automatizacijom TapHome.

### MQTT predložak

MQTT predložak zahtijeva IP adresu i port brokera te **Device ID** uređaja Shelly (oblik: `shellyem-XXXXXXXXXXXX`, gdje su X heksadecimalne znamenke MAC adrese). Device ID možete pronaći u web-sučelju Shelly pod **Settings** > **Device Info**.

Nakon uključivanja MQTT-a na Shelly EM (Internet & Security > Advanced — MQTT) TapHome se pretplaćuje na teme `shellies/shellyem-{deviceID}/` i podatke prima skriptama za primanje poruka.

> [!WARNING]
> Kod uređaja Shelly Gen1 uključivanje MQTT-a **isključuje Shelly Cloud**. MQTT i Shelly Cloud ne mogu raditi istodobno.

## Mogućnosti uređaja

### Mjerenje energije (po kanalu)

Svaki je kanal u sustavu TapHome prikazan kao zaseban uređaj vrste „Brojilo električne energije” koji daje:

- **Trenutačnu snagu**: djelatna snaga u kW (pretvara se iz W dijeljenjem s 1000)
- **Ukupnu energiju**: ukupna potrošena energija u kWh (HTTP: pretvara se iz Wh; MQTT: koristi trajnu temu `total` u Wh)

HTTP predložak čita polja `power` i `total` iz JSON odgovora `/emeter/{i}/`. MQTT predložak prati temu `emeter/{i}/energy` (vat-minute, dijeli se sa 60 000 za kWh) i temu `emeter/{i}/total` (vat-sati, ostaje sačuvana i nakon ponovnog pokretanja).

> [!TIP]
> MQTT tema `energy` vraća se na nulu pri ponovnom pokretanju uređaja. Za trajno praćenje energije predložak čita i temu `total` koja ostaje sačuvana nakon ponovnog pokretanja.

Svaki kanal ima i tri servisna atributa:

| Atribut | Jedinica | Opis |
|-----------|------|-------------|
| Napon | V | Efektivni (RMS) napon mreže |
| Predana energija | Wh | Ukupna energija predana u mrežu, za solarne elektrane i dvosmjerno mjerenje |
| Jalova snaga | VAR | Trenutačna jalova snaga |

> [!NOTE]
> MQTT predložak po kanalu daje samo napon kao servisni atribut. Jalova snaga i predana energija dostupne su samo u HTTP predlošku.

### Sklopka za sklopnik

Relejni izlaz u sustavu TapHome prikazan je kao uređaj vrste „Sklopka”. Relej je predviđen za **2 A / 230 V AC** i namijenjen je samo upravljanju sklopnikom, a ne izravnom uključivanju i isključivanju trošila.

- **HTTP:** čita `ison` iz `settings/relay/0` i upravlja preko `/relay/0?turn=on` ili `/relay/0?turn=off`
- **MQTT:** čita iz teme `shellies/shellyem-{id}/relay/0` i objavljuje `on`/`off` na `shellies/shellyem-{id}/relay/0/command`

> [!WARNING]
> Relej je predviđen za samo 2 A. Za trošila iznad te vrijednosti uvijek koristite vanjski sklopnik. Izravno spajanje trošila velike snage oštetit će relej.

### Dodatne mogućnosti

Shelly EM daje i faktor snage (0,00–1,00) i oznaku valjanosti mjerenja po kanalu, konfiguraciju pojedinog kanala (omjer strujnog transformatora, ograničenje najveće snage), poništavanje brojača energije, timer za automatsko isključivanje releja i jačinu Wi-Fi signala. Preko MQTT-a dostupne su i dodatne teme za trenutačnu snagu, jalovu snagu i predanu energiju po kanalu. Te se mogućnosti mogu dodati u budućem ažuriranju predloška.

## Rješavanje problema

### Uređaj ne odgovara (HTTP)

1. Provjerite je li Shelly EM spojen na Wi-Fi i ima li valjanu IP adresu
2. U pregledniku otvorite `http://{device-ip}/shelly`: ako odgovori JSON-om koji sadrži `"type":"SHEM"`, uređaj je dostupan
3. Provjerite jesu li centralna jedinica TapHome (CCU) i Shelly EM u istoj mreži / VLAN-u

### Nema podataka na jednom kanalu

1. Provjerite je li strujni transformator spojen na ispravnu utičnicu od 3,5 mm (kanal 0 ili kanal 1)
2. Provjerite teče li struja kroz praćeni vodič: strujni transformator mora obuhvaćati samo jedan vodič, a ne cijeli kabel
3. Ručno pošaljite upite `/emeter/0/` i `/emeter/1/` i provjerite jesu li vrijednosti `power` različite od nule

### MQTT poruke ne stižu

1. Provjerite je li MQTT uključen u web-sučelju Shelly (Internet & Security > Advanced — MQTT)
2. Provjerite jesu li adresa i port brokera ispravni i u uređaju Shelly i u postavkama modula TapHome
3. Provjerite odgovara li korisnička varijabla `deviceID` točno Device ID-u uređaja Shelly (npr. `B929CC`)
4. MQTT klijentom (npr. MQTT Explorer) pretplatite se na `shellies/#` i provjerite objavljuje li uređaj poruke

### Pogreška zbog sukoba s rasporedom

HTTP predložak provjerava polje `schedule` u `settings/relay/0`. Ako je na uređaju Shelly uključen interni raspored, predložak javlja pogrešku. Isključite raspored u web-sučelju Shelly (Settings > Relay > Schedule) i umjesto njega koristite automatizacije TapHome.

> [!WARNING]
> Uređaji Shelly Gen1 podržavaju samo **2 istodobne HTTP veze**. Ako TapHome i drugi sustav (npr. Home Assistant) istodobno očitavaju isti uređaj, komunikacija može postati nepouzdana. U okruženjima s više sustava razmislite o prelasku na MQTT predložak.

## Kako ga instalirati u TapHome

### Preduvjeti

- Uređaj Shelly ugrađen i uključen
- Lokalna Wi-Fi mreža (2,4 GHz)
- TapHome CCU u istoj mreži

### Korak 1 — Spojite Shelly na Wi-Fi

**Opcija A — aplikacija Shelly (preporučeno):**

1. Preuzmite [aplikaciju Shelly](https://www.shelly.com/en/support/shelly-app) (iOS / Android)
2. Dodirnite **+** → **Add Device** i slijedite čarobnjak za uparivanje preko Bluetootha
3. Kada se to zatraži, unesite podatke za prijavu na Wi-Fi

**Opcija B — način rada AP (bez aplikacije):**

1. Pri prvom uključivanju uređaj stvara pristupnu točku: `ShellyXXX-AABBCCDDEE`
2. Spojite telefon ili računalo na tu pristupnu točku
3. Otvorite `http://192.168.33.1` → **Internet & Security** → **Wi-Fi Mode - Client**
4. Unesite SSID i lozinku → **Save**

> [!NOTE]
> Shelly podržava samo mreže od **2,4 GHz**. Mreže od 5 GHz neće se prikazati pri skeniranju.

### Korak 2 — Pronađite adresu uređaja

Uređaji Shelly Gen1 podržavaju **mDNS** (Zeroconf). Uređaju možete pristupiti preko naziva hosta umjesto IP adrese:

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

Na primjer: `shelly1pm-AABBCCDDEE.local` (MAC adresa velikim slovima u heksadecimalnom zapisu, bez dvotočaka).

> [!TIP]
> **Preporučeno: koristite IP skener TapHome.** Otvorite aplikaciju TapHome i pokrenite **IP skener** (Postavke → Mreža → Skeniranje). Skener pronalazi uređaje u vašoj mreži i prikazuje IP adresu i mDNS naziv hosta. Za pouzdaniju vezu koristite **naziv hosta** umjesto IP adrese, jer ostaje isti i kada se IP adresa uređaja promijeni nakon ponovnog pokretanja usmjerivača.

**Drugi načini** za pronalaženje IP adrese:

- **Aplikacija Shelly:** detalji uređaja → **Device info** → IP adresa
- **Web-sučelje Shelly:** spojite se na AP uređaja prije postavljanja Wi-Fi mreže — IP adresa prikazuje se nakon spremanja
- **DHCP tablica usmjerivača:** potražite naziv hosta poput `shelly1pm-AABBCCDDEE`

### Korak 3 — Konfiguracija u sustavu TapHome

1. U sustavu TapHome dodajte novi modul **Packet Parser (HTTP)**
2. **Adresa:** unesite mDNS naziv hosta (npr. `shelly1pm-AABBCCDDEE.local`) ili IP adresu iz koraka 2
3. **Port:** `80` (zadano, nije potrebno mijenjati)
4. Uvezite predložak — TapHome će čitati `/status` kako bi očitao stanje uređaja

> [!NOTE]
> HTTP autentifikacija na uređajima Shelly zadano je isključena. Ako ste uključili zaštitu prijavom, TapHome trenutačno ne podržava HTTP Basic Auth — za integraciju sa sustavom TapHome ostavite autentifikaciju isključenom.

## Dostupni uređaji 3

Ovi se uređaji pojavljuju u TapHomeu nakon uvoza.

Shelly EM Modul

Prilagođene varijable

Čitanje (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
```

Brojilo energije — kanal 1 Brojilo električne energije Samo za čitanje

Trenutačna snaga (kW) i ukupna energija (kWh) sa strujnog transformatora na kanalu 1

numeric Jedinica: kW / kWh json\_path

Servisni atributi

|                  |                                                                                          |
|------------------|------------------------------------------------------------------------------------------|
| Napon            |                                                                                          |
| Predana energija | Ukupna energija predana u mrežu na kanalu 1 — za solarne elektrane i dvosmjerno mjerenje |
| Jalova snaga     |                                                                                          |

Čitanje ukupne potrošnje

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

Čitanje zahtjeva

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

Servisni atributi

Voltage \[V]

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

backward \[Wh]

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

reactive \[W]

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

Brojilo energije — kanal 2 Brojilo električne energije Samo za čitanje

Trenutačna snaga (kW) i ukupna energija (kWh) sa strujnog transformatora na kanalu 2

numeric Jedinica: kW / kWh json\_path

Servisni atributi

|                  |                                                                                          |
|------------------|------------------------------------------------------------------------------------------|
| Napon            |                                                                                          |
| Predana energija | Ukupna energija predana u mrežu na kanalu 2 — za solarne elektrane i dvosmjerno mjerenje |
| Jalova snaga     |                                                                                          |

Čitanje ukupne potrošnje

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

Čitanje zahtjeva

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

Servisni atributi

Voltage \[V]

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

backward \[Wh]

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

reactive \[W]

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

Sklopka za sklopnik Sklopka Čitanje i pisanje

Relejni izlaz 2 A za upravljanje sklopnikom — nije predviđen za izravno uključivanje i isključivanje trošila

boolean

Vrijednosti / stanja: ON · OFF

Čitanje stanja sklopke

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

Zapis stanja sklopke

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

**Povezivanje:** Packet Parser → HTTP • Naziv računala (hostname): `shellyem-{MAC}.local`

Moguća poboljšanja (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 uvoza

Ove vrijednosti unosite pri uvozu XML-a.

| Pitanje u aplikaciji | Zadano        |
|----------------------|---------------|
| IP adresa            | `192.168.0.1` |

## Izvori

- 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

## Povezana dokumentacija

- [Packet Parser Integration](https://taphome.com/hr/compatibility/packet-parser-guide/)
- [Packet Parser (HTTP, TCP, UDP, FTP, MQTT)](https://taphome.com/hr/docs/integration/packet-parser/)
- [Funkcije Packet parsera](https://taphome.com/hr/docs/script/packet-parser/)
- [Funkcije za raščlambu](https://taphome.com/hr/docs/script/parsing-functions/)

