TapHome

Shelly 3EM

Packet Parser → HTTP
Autor
Posljednje ažuriranje: 03. 2026

Ovaj uređaj podržava mDNS

Umjesto IP adrese uređaju možete pristupiti na adresi:

shelly3em-{MAC}.local

Zamijenite {MAC} MAC adresom svog uređaja (velika slova, bez dvotočaka).

TapHome podržava mDNS. Naziv računala (hostname) pouzdaniji je od statične IP adrese.

Shelly 3EM

Shelly 3EM trofazno je Wi-Fi brojilo energije s tri strujna transformatora s kliještima (CT) od 120 A i ugrađenim relejem nazivne struje 10 A za upravljanje sklopnikom. Za svaku fazu zasebno mjeri djelatnu snagu, napon, struju, faktor snage i ukupnu energiju. TapHome s uređajem komunicira u lokalnoj mreži, veza s oblakom nije potrebna.

Za ovaj uređaj dostupna su dva predloška TapHome: HTTP predložak (zadani, koristi periodično očitavanje REST API-ja) i MQTT predložak (koristi pretplatu na poruke preko brokera). Oba predloška daju iste uređaje: 3 brojila energije (jedno po fazi) i 1 sklopku sklopnika. Odaberite jedan protokol prema zahtjevima instalacije.

Hardversko spajanje

Shelly 3EM treba mrežno napajanje (110–230 V AC) spojeno na stezaljke L i N. Troja priložena strujna kliješta spajaju se redom na stezaljke CT1, CT2 i CT3. Izlaz releja za sklopnik nalazi se na stezaljci O (najviše 10 A).

Ugradnja strujnih kliješta
  • Svaka strujna kliješta stavljaju se oko faznog vodiča strujnog kruga koji se prati, vodič nije potrebno prekidati
  • Strelica na strujnim kliještima mora pokazivati u smjeru toka struje (od izvora prema trošilu)
  • Strujna kliješta mogu pratiti trofazni sustav (L1, L2, L3) ili tri neovisna jednofazna strujna kruga

Strujna kliješta NE stavljajte na fazni vodič prije nego što ih spojite na Shelly 3EM. Na spojnim kabelima transformatora može biti visok napon čak i kada je spojen samo transformator.

Upravljanje sklopnikom

Izlaz releja (stezaljka O) nazivno podnosi 10 A i može izravno uključivati i isključivati mala trošila ili upravljati svitkom vanjskog sklopnika za uključivanje i isključivanje većih trošila.

Konfiguracija

Postavljanje HTTP predloška

Pri uvozu predloška unesite IP adresu uređaja. Predložak očitava tri zasebne krajnje točke (/emeter/0, /emeter/1, /emeter/2) za podatke o energiji po fazama i /relay/0 za stanje sklopnika. Odgovor za svaku fazu sprema se u korisničku varijablu (emeter0, emeter1, emeter2) kako bi u svakom ciklusu očitavanja bilo što manje HTTP poziva.

Postavljanje MQTT predloška

MQTT predložak zahtijeva tri parametra uvoza:

ParametarOpisPrimjer
MQTT Broker IPAdresa MQTT brokera192.168.1.10
MQTT Broker PortPort brokera (zadano 1883)1883
Device IDZavršetak MAC adrese koji se koristi u MQTT temamaB929CC

Device ID (dID) je zadnjih 6 znakova MAC adrese velikim slovima u heksadecimalnom zapisu. Možete ga pronaći u web-sučelju Shelly pod Settings → Device Info ili preko GET http://{ip}/settings → polje mqtt.id.

Modul se pretplaćuje na shellies/shellyem3-{dID}/#, a skripte za primanje poruka usmjeravaju poruke emeter i relay za pojedine faze na odgovarajuće uređaje.

MQTT predložak koristi prefiks teme shellyem3-{dID}, a službena dokumentacija API-ja navodi shelly3em-{id}. Oba oblika rade, jer varijablu dID postavlja korisnik. Stvarni prefiks teme provjerite tako da se MQTT klijentom pretplatite na shellies/#.

Na uređajima Shelly Gen1 uključivanje MQTT-a isključuje Shelly Cloud. MQTT i Shelly Cloud ne mogu raditi istodobno. To je ograničenje firmvera.

Mogućnosti uređaja

Mjerenje energije po fazama

Predložak stvara tri brojila energije, po jedno za svaku fazu. Svako brojilo čita:

  • Djelatna snaga — trenutačna snaga u W, predložak je pretvara u kW (÷ 1000)
  • Ukupna potrošena energija — ukupna energija u Wh, predložak je pretvara u kWh (÷ 1000)

U HTTP predlošku svaka se faza čita iz svoje krajnje točke /emeter/{i}. U MQTT predlošku vrijednosti stižu na teme shellies/shellyem3-{dID}/emeter/{i}/power i .../total.

Električni parametri po fazama

Svako brojilo energije ima četiri servisna atributa:

  • Napon — efektivna vrijednost napona (V)
  • Struja — efektivna vrijednost struje (A)
  • Faktor snage — omjer djelatne i prividne snage (0,00–1,00)
  • Ukupna predana energija — energija predana u mrežu u Wh, korisna kod solarnih elektrana s dvosmjernim mjerenjem
Poništavanje brojača energije

Svaka faza ima servisnu radnju Poništi brojače koja briše brojače energije za tu fazu. U HTTP načinu poziva /emeter/{i}?reset_totals, a u MQTT načinu objavljuje reset_totals na temu shellies/shellyem3-{dID}/emeter/{i}/command.

Sklopka sklopnika

Predložak daje relej sklopnika kao sklopku. Stanje releja čita se iz /relay/0 → ison (HTTP) ili iz teme shellies/shellyem3-{dID}/relay/0 (MQTT), a relejem se upravlja preko /relay/0?turn=on|off (HTTP) ili teme .../relay/0/command (MQTT).

Dodatne mogućnosti

Shelly 3EM daje i jalovu snagu (VAR), oznaku valjanosti mjerenja po fazi (is_valid), zbroj snage sve tri faze (total_power iz /status), jačinu Wi-Fi signala, vrijeme rada uređaja, stanje ažuriranja firmvera, granične vrijednosti prekoračenja snage po fazi i izvoz povijesnih podataka o energiji (CSV). Na releju sklopnika dostupan je timer za automatsko isključivanje. Te se mogućnosti mogu dodati u nekom budućem ažuriranju predloška.

Rješavanje problema

Uređaj ne odgovara (HTTP)
  1. Provjerite je li Shelly 3EM spojen na Wi-Fi i ima li valjanu IP adresu
  2. U pregledniku otvorite http://{device-ip}/shelly. Ako se stranica otvori, uređaj je dostupan
  3. Provjerite jesu li TapHome Core i Shelly 3EM u istoj mreži / VLAN-u
Ne stižu MQTT poruke
  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 na uređaju Shelly i u predlošku TapHome
  3. Provjerite odgovara li korisnička varijabla dID stvarnom ID-ju uređaja: MQTT klijentom se pretplatite na shellies/# i provjerite koji prefiks teme uređaj koristi
  4. Provjerite radi li MQTT broker i je li dostupan i uređaju Shelly i centralnoj jedinici TapHome Core
Očitanja energije pokazuju nulu ili NaN
  1. Provjerite jesu li strujna kliješta ispravno spojena na stezaljke uređaja Shelly 3EM (CT1, CT2, CT3) i stavljena oko faznih vodiča
  2. Provjerite pokazuje li strelica na strujnim kliještima u ispravnom smjeru (od izvora prema trošilu)
  3. Ručno očitajte /emeter/0 i provjerite polje is_valid: false znači da su strujna kliješta odspojena ili neispravna
  4. Provjerite vrijednosti power i total: ako su obje 0, na tom strujnom krugu možda nema trošila

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. Ako uređaj treba pratiti više sustava, razmislite o korištenju MQTT predloška.

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

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:

1

shelly<model>-<MAC>.local

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

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

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

Shelly 3EM Modul
Prilagođene varijable
Brojilo energije (faza 1) Brojilo električne energije Samo za čitanje

Praćenje energije faze 1 — djelatna snaga (kW), ukupna energija (kWh), napon, struja, faktor snage i predana energija

numeric Jedinica: W / kWh
Servisni atributi
Faktor snage
Struja [A]
Napon [V]
Ukupna predana energija [Wh]Energija predana u mrežu — važno kod solarnih elektrana s dvosmjernim mjerenjem
Servisne radnje
Poništi brojače

Brojilo energije (faza 1)

Čitanje ukupne potrošnje
RETURN(todouble(PARSEjson(emeter0, "total"))/1000);
Čitanje zahtjeva
RETURN(todouble(PARSEjson(emeter0, "power"))/1000);
Čitanje (modul)
VAR response := SENDHTTPREQUEST("/emeter/0");
IF response.IsSuccess
 emeter0 := response.Content;
ELSE
 ADDERROR(response.StatusCode + " (" + response.ReasonPhrase + ")");
 RETURN(NaN);
END
Servisni atributi
power factor
RETURN(todouble(PARSEjson(emeter0, "pf")));
Current [A]
RETURN(PARSEjson(emeter0, "current"));
voltage [V]
RETURN(PARSEjson(emeter0, "voltage"));
Total returned energy [Wh]
RETURN(PARSEjson(emeter0, "total_returned"));
Servisne radnje
Reset total
sendhttprequest("/emeter/0?reset_totals");
Brojilo energije (faza 2) Brojilo električne energije Samo za čitanje

Praćenje energije faze 2 — djelatna snaga (kW), ukupna energija (kWh), napon, struja, faktor snage i predana energija

numeric Jedinica: W / kWh
Servisni atributi
Faktor snage
Struja [A]
Napon [V]
Ukupna predana energija [Wh]Energija predana u mrežu — važno kod solarnih elektrana s dvosmjernim mjerenjem
Servisne radnje
Poništi brojače

Brojilo energije (faza 2)

Čitanje ukupne potrošnje
RETURN(todouble(PARSEjson(emeter1, "total"))/1000);
Čitanje zahtjeva
RETURN(todouble(PARSEjson(emeter1, "power"))/1000);
Čitanje (modul)
VAR response := SENDHTTPREQUEST("/emeter/1");
IF response.IsSuccess
 emeter1 := response.Content;
ELSE
 ADDERROR(response.StatusCode + " (" + response.ReasonPhrase + ")");
 RETURN(NaN);
END
Servisni atributi
power factor
RETURN(PARSEjson(emeter1, "pf"));
current [A[
RETURN(PARSEjson(emeter1, "current"));
voltage [V]
RETURN(PARSEjson(emeter1, "voltage"));
total returned energy [Wh]
RETURN(PARSEjson(emeter1, "total_returned"));
Servisne radnje
reset total
sendhttprequest("/emeter/1?reset_totals");
Brojilo energije (faza 3) Brojilo električne energije Samo za čitanje

Praćenje energije faze 3 — djelatna snaga (kW), ukupna energija (kWh), napon, struja, faktor snage i predana energija

numeric Jedinica: W / kWh
Servisni atributi
Faktor snage
Struja [A]
Napon [V]
Ukupna predana energija [Wh]Energija predana u mrežu — važno kod solarnih elektrana s dvosmjernim mjerenjem
Servisne radnje
Poništi brojače

Brojilo energije (faza 3)

Čitanje ukupne potrošnje
RETURN(todouble(PARSEjson(emeter2, "total"))/1000);
Čitanje zahtjeva
RETURN(todouble(PARSEjson(emeter2, "power"))/1000);
Čitanje (modul)
var response := SENDHTTPREQUEST("/emeter/2");
IF response.IsSuccess
 emeter2 := response.Content;
ELSE
 ADDERROR(response.StatusCode + " (" + response.ReasonPhrase + ")");
 RETURN(NaN);
END
Servisni atributi
power factor
RETURN(PARSEjson(emeter2, "pf"));
current [A]
RETURN(PARSEjson(emeter2, "current"));
voltage [V]
RETURN(PARSEjson(emeter2, "voltage"));
Total returned energy [Wh]
RETURN(PARSEjson(emeter2, "total_returned"));
Servisne radnje
reset total
sendhttprequest("/emeter/2?reset_totals");
Sklopka sklopnika Sklopka

Ugrađeni relej sklopnika od 10 A za uključivanje i isključivanje trošila ili upravljanje vanjskim sklopnikom

boolean
Vrijednosti / stanja: ON · OFF

Sklopka sklopnika

Čitanje stanja sklopke
VAR response := SENDHTTPREQUEST("/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
Zapis stanja sklopke
VAR response := SENDHTTPREQUEST("/relay/0?turn=" + switch(St,1,"on","off"));
IF response.IsSuccess = false
 ADDERROR(response.StatusCode);
END
Povezivanje: Packet Parser → HTTP • Naziv računala (hostname): shelly3em-{MAC}.local
Moguća poboljšanja (10)
  • Reactive Power — Per-phase reactive power in VAR; available in /emeter/ response and via MQTT topic .../emeter/{i}/reactive_power
  • Measurement Validity — Boolean flag indicating whether CT clamp measurement is valid; useful for detecting disconnected CT
  • Total Power (3-phase sum) — Sum of active power across all 3 phases in W; available in /status but not in per-phase /emeter/ endpoints
  • WiFi Signal Strength — WiFi RSSI in dBm
  • Uptime — Device uptime in seconds; available in /status but template only polls /emeter/ endpoints, not /status
  • FW Update Available — Firmware update flag from /status
  • Auto-off Timer — Auto-off timer in seconds on contactor relay
  • Per-phase Power Protection — Per-phase overpower threshold; could be exposed as service attribute + action
  • Historical Energy Data (CSV) — Per-phase historical data export as CSV; not applicable for real-time integration
  • Reset All Energy History — Clears ALL stored energy history across all 3 phases; more destructive than per-phase reset_totals

Izvori

Pronašli ste problem s ovim predloškom uređaja?

Recite nam što ne radi, što nedostaje ili kako bi se predložak trebao ponašati. Vaše povratne informacije pomažu nam da katalog bude točan.

Provjerio TapHome

Želite ovo koristiti u svojoj centralnoj jedinici TapHome Core?

Otvorite ovaj predložak na portalu Customer Portal kako biste ga primijenili na jedan od svojih domova ili predložili poboljšanje i poslali ga natrag u katalog.

Otvorite na portalu