TapHome

Shelly Plus 1PM

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:

shellyplus1pm-{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 Plus 1PM

Shelly Plus 1PM je kompaktni Wi-Fi relej Gen2+ s ugrađenim mjerenjem snage. Stane iza standardnog zidnog prekidača i može upravljati jednim strujnim krugom do 16 A (3500 W pri 230 V AC) ili 10 A (30 V DC). Uređaj podržava napajanje 110–240 VAC ili 24–30 VDC, pa je prikladan za instalacije na mrežnom naponu i za niskonaponske instalacije. TapHome s uređajem komunicira lokalno preko Wi-Fi mreže, pa veza s oblakom nije potrebna.

Dostupna su dva predloška TapHome: HTTP predložak, koji periodično očitava Gen2+ RPC API uređaja, i MQTT predložak, koji podatke prima preko MQTT brokera. Oba daju ista dva uređaja: brojilo energije i sklopku releja.

Konfiguracija

HTTP predložak

HTTP predložak traži samo IP adresu uređaja (u predlošku je unaprijed upisan primjer 192.168.0.1). TapHome očitava krajnju točku /rpc/Switch.GetStatus?id=0 i za stanje releja i za podatke o mjerenju snage. Modul sprema JSON odgovor u varijablu status, tako da ga skripte pojedinih uređaja mogu obraditi bez suvišnih HTTP poziva.

MQTT predložak

MQTT predložak pri uvozu traži tri parametra:

  • MQTT Broker IP — IP adresa MQTT brokera (ne samog uređaja Shelly)
  • MQTT Broker Port — zadano 1883
  • Shelly MQTT Client ID — oblik shellyplus1pm-{deviceid}, nalazi se u web-sučelju Shelly pod Settings > MQTT Settings > Client ID

Nakon što na uređaju Shelly Plus 1PM omogućite MQTT (Settings > MQTT), TapHome se pretplaćuje na shellyplus1pm-{deviceid}/status/switch:0 i naredbe za upravljanje objavljuje na shellyplus1pm-{deviceid}/command/switch:0.

Mogućnosti uređaja

Upravljanje relejem

Predložak daje relej kao uređaj vrste „Sklopka”. Stanje releja čita se iz polja output (logička vrijednost), a relejem se upravlja preko /rpc/Switch.Set?id=0 s on=true ili on=false (HTTP) ili objavom on/off na temu za naredbe (MQTT).

HTTP predložak očitava relej svakih 2,5 sekunde, pa se stanje prikazuje gotovo u stvarnom vremenu. MQTT predložak promjene prima čim nastanu, preko skripte za primanje poruka.

Mjerenje snage

Ugrađeno brojilo energije čita dvije vrijednosti iz odgovora Switch.GetStatus:

  • Trenutačna snaga — apower u vatima, predložak je pretvara u kW (dijeli s 1000)
  • Ukupna energija — aenergy.total u vatsatima, predložak je pretvara u kWh (dijeli s 1000)

Brojilo je samo za čitanje i automatski se osvježava pri svakom ciklusu očitavanja (HTTP) ili pri svakoj MQTT poruci o stanju.

HTTP predložak na brojilu energije daje i tri servisna atributa:

AtributJedinicaOpis
StrujaATrenutačna jakost struje
NaponVEfektivni (RMS) mrežni napon
Temperatura°CUnutarnja temperatura uređaja

MQTT predložak daje iste podatke (unutarnju temperaturu, napon i struju) kao servisne atribute modula, a čita ih iz sadržaja MQTT poruke o stanju.

Dodatne mogućnosti

Shelly Plus 1PM preko svojeg RPC API-ja daje i faktor snage, frekvenciju mreže, predanu energiju (za dvosmjerno mjerenje), stanje fizičkog ulaza, jačinu Wi-Fi signala, MAC adresu, vrijeme rada, zauzeće RAM-a i vrijeme uređaja. Dostupni su i radnja ažuriranja firmvera, ponovno pokretanje uređaja, timer za automatsko isključivanje, poništavanje brojača energije i postavljanje zaštite od prekoračenja snage. 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 spojen na Wi-Fi i ima li valjanu IP adresu
  2. Umjesto IP adrese pokušajte koristiti mDNS naziv hosta (shellyplus1pm-AABBCCDDEE.local): IP adresa se možda promijenila nakon obnove DHCP zakupa
  3. U pregledniku otvorite http://{device-ip}/rpc/Shelly.GetDeviceInfo: ako odgovori u obliku JSON, uređaj je dostupan
  4. Provjerite jesu li centralna jedinica TapHome (CCU) i Shelly u istoj mreži / VLAN-u
  5. Provjerite je li HTTP Digest Authentication isključena u web-sučelju Shelly: TapHome ne podržava zahtjeve s autentifikacijom
MQTT poruke ne stižu
  1. Provjerite je li MQTT omogućen u web-sučelju Shelly (Settings > MQTT)
  2. Provjerite jesu li adresa i port brokera ispravni i na uređaju Shelly i u postavkama modula TapHome
  3. Provjerite odgovara li korisnička varijabla plug1topic točno MQTT Client ID-ju uređaja Shelly (npr. shellyplus1pm-AABBCCDDEE)
  4. MQTT klijentom (npr. MQTT Explorer) pretplatite se na shellyplus1pm-# i provjerite objavljuje li uređaj poruke
Očitanje snage je nula
  1. Provjerite je li trošilo spojeno preko releja Shelly (a ne premošteno)
  2. Provjerite je li relej uključen: brojilo mjeri samo kada struja teče kroz relej
  3. Ručno pošaljite upit /rpc/Switch.GetStatus?id=0 i provjerite vraća li apower vrijednost različitu od nule
Spor odziv ili istek vremena
  1. Uređaji Gen2+ podržavaju do 6 istodobnih HTTP veza (Gen1 samo 2), ali izbjegavajte prečesto očitavanje iz više sustava
  2. Ako je u web-sučelju Shelly uključen način ECO, isključite ga: uređaj između očitavanja prelazi u stanje mirovanja, što pri kratkim intervalima očitavanja može uzrokovati istek vremena
  3. Koristite statičku IP adresu ili DHCP rezervaciju kako se adresa ne bi mijenjala
  4. Ako uređaj očitava više sustava, razmislite o prelasku na MQTT predložak: MQTT u potpunosti zaobilazi problem ograničenja broja veza

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 Plus 1PM Modul
Prilagođene varijable
Brojilo energije Brojilo električne energije Samo za čitanje

Trenutačna snaga (kW) i ukupna energija (kWh) s dijagnostikom struje, napona i temperature

numeric Jedinica: kW / kWh
Servisni atributi
Struja
Napon
Temperatura

Brojilo energije

Čitanje ukupne potrošnje
return(parsejson(parsejson(status,"aenergy"), "total")/1000);
Čitanje zahtjeva
return(parsejson(status,"apower")/1000);
Čitanje (modul)
var x := (sendhttprequest("/rpc/Switch.GetStatus?id=0"));
status := x.Content;
Servisni atributi
${current} [a]
return(parsejson(status,"current"));
${electric_voltage} [v]
return(parsejson(status,"voltage"));
${temp} [C]
return(parsejson(parsejson(status,"temperature"), "tC"));
Sklopka Sklopka
boolean
Vrijednosti / stanja: ON · OFF

Sklopka

Čitanje stanja sklopke
var x := (sendhttprequest("/rpc/Switch.GetStatus?id=0"));
status := x.Content;
return(PARSEJSON(status, "$.output", true));
Zapis stanja sklopke
VAR response := SENDHTTPREQUEST("rpc/Switch.Set?id=0&on=" + if(St,"true","false"));
IF response.IsSuccess = false
  ADDERROR(response.StatusCode);
END
Povezivanje: Packet Parser → HTTP • Naziv računala (hostname): shellyplus1pm-{MAC}.local
Moguća poboljšanja (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

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