TapHome

Shelly 1PM Gen3

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:

shelly1pmg3-{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 1PM Gen3

Shelly 1PM Gen3 je kompaktni Wi-Fi relej 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 (pri 24–30 V DC). TapHome s uređajem komunicira preko HTTP-a putem JSON-RPC 2.0 API-ja za Gen2+/Gen3 u lokalnoj mreži, pa veza s oblakom nije potrebna.

Za razliku od izvornog Shelly 1PM (Gen1), koji koristi REST API s krajnjom točkom /status, inačica Gen3 koristi RPC API s pozivima metoda poput /rpc/Switch.GetStatus. Hardver Gen3 ima brži procesor ESP s 8 MB flash memorije, podržava do 6 istodobnih HTTP veza (Gen1 samo 2) i može se nadograditi na Matter.

Predložak omogućuje upravljanje relejem i daje brojilo energije koje očitava trenutačnu potrošnju snage i ukupnu potrošenu energiju.

Konfiguracija

Shelly 1PM Gen3 spaja se preko Wi-Fi mreže. Pri uvozu predloška u TapHome unesite IP adresu uređaja (u predlošku je unaprijed upisan primjer 192.168.0.1).

Za integraciju sa sustavom TapHome autentifikacija na uređaju Shelly mora biti isključena. TapHome ne podržava HTTP Digest Auth koji koriste uređaji Gen2+/Gen3. Otvorite web-sučelje Shelly (http://{device-ip}) → Settings → Authentication i provjerite je li isključena.

Ako je na uređaju Shelly uključen način ECO, može doći do isteka vremena komunikacije zbog kratkih intervala očitavanja koje koristi predložak (2,5–3 sekunde). Ako se veza povremeno prekida, isključite način ECO u web-sučelju Shelly.

Mogućnosti uređaja

Upravljanje relejem

Predložak daje relej kao uređaj vrste „Sklopka”. Stanje releja čita se iz odgovora /rpc/Switch.GetStatus?id=0 (polje output, logička vrijednost), a relejem se upravlja preko /rpc/Switch.Set?id=0&on=true ili on=false.

Mjerenje snage

Ugrađeno brojilo energije čita dvije vrijednosti iz odgovora /rpc/Switch.GetStatus?id=0:

  • Trenutačna snaga — apower u vatima, predložak je pretvara u kW
  • Ukupna potrošnja — aenergy.total u vatsatima, predložak je pretvara u kWh

Brojilo daje i tri servisna atributa:

  • Električna struja — struja trošila u amperima (polje current)
  • Električni napon — napon napajanja u voltima (polje voltage)
  • Temperatura — unutarnja temperatura uređaja u °C (polje temperature.tC)

Brojilo je samo za čitanje i automatski se osvježava pri svakom ciklusu očitavanja (interval od 15 sekundi).

Servisna dijagnostika

Predložak daje servisne atribute na razini modula za praćenje uređaja:

  • Wi-Fi — naziv spojene mreže (SSID)
  • IP adresa — trenutačna IP adresa uređaja u mreži
  • Jačina signala — Wi-Fi RSSI u dB
  • MAC — MAC adresa uređaja

Skripta za čitanje modula provjerava i dostupna ažuriranja firmvera te potrebu za ponovnim pokretanjem i prikazuje ih kao upozorenja u sučelju TapHome.

Servisne radnje

Na razini modula dostupne su dvije servisne radnje:

  • Ažuriraj firmver — pokreće ažuriranje firmvera na najnovije stabilno izdanje preko /rpc/Shelly.Update
  • Ponovno pokretanje — ponovno pokreće uređaj preko /rpc/Shelly.Reboot
Dodatne mogućnosti

Shelly 1PM Gen3 u odgovorima RPC daje i faktor snage, frekvenciju mreže (Hz), brojače vraćene / predane energije, stanje fizičkog ulaza (input:0), vrijeme rada uređaja, zauzeće RAM-a i vrijeme uređaja. Timer za automatsko isključivanje dostupan je preko parametra toggle_after, a zaštita od prekoračenja snage može se postaviti preko Switch.SetConfig → power_limit. Brojači energije mogu se poništiti preko /rpc/Switch.ResetCounters. Te se mogućnosti mogu dodati u budućem ažuriranju predloška.

Rješavanje problema

Uređaj ne odgovara
  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 (shelly1pmg3-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 formatu JSON, uređaj je dostupan
  4. Provjerite jesu li centralna jedinica TapHome Core i Shelly u istoj mreži / VLAN-u
  5. Provjerite je li autentifikacija na uređaju Shelly isključena
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
Upozorenje na pregrijavanje

Shelly 1PM Gen3 ima unutarnju toplinsku zaštitu. Ako temperatura uređaja prijeđe sigurnosne granice, očitanje temperature u servisnim atributima brojila raste. Osigurajte dovoljno prozračivanja oko uređaja, osobito pri dugotrajnom sklapanju velikih opterećenja.

Uređaji Shelly Gen2+/Gen3 podržavaju do 6 istodobnih HTTP veza. Iako je to znatno poboljšanje u odnosu na Gen1 (2 veze), izbjegavajte istodobno očitavanje iz previše sustava (TapHome, Home Assistant, vlastite skripte) kako se ne bi potrošile sve dostupne veze.

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 1PM Gen3 Modul
Servisni atributi
Wi-Fi
IP adresa
Jačina signala
MAC
Servisne radnje
Ažuriraj firmver
Ponovno pokretanje
Prilagođene varijable

Shelly 1PM Gen3

Čitanje (modul)
VAR response := SENDHTTPREQUEST("/rpc/Sys.GetStatus");
IF response.IsSuccess
    Sys.GetStatus := response.Content;
END

response := SENDHTTPREQUEST("/rpc/Sys.GetConfig");
IF response.IsSuccess
    Sys.GetConfig := response.Content;
END

response := SENDHTTPREQUEST("/rpc/WiFi.GetStatus");
IF response.IsSuccess
    WiFi.GetStatus := response.Content;
END

if ! ISNULL(parsejson(Sys.GetStatus, "available_updates.stable", true))
    addwarning("New firmware update is available");
end

if parsejson(Sys.GetStatus, "restart_required", true)
    addwarning("Restart required");
end
Servisni atributi
Wifi
PARSEJSON(WiFi.GetStatus, "ssid")
${ipAddress}
PARSEJSON(WiFi.GetStatus, "sta_ip")
${xml_signal_strength} [dB]
PARSEJSON(WiFi.GetStatus, "rssi")
MAC
PARSEJSON(Sys.GetStatus, "mac")
Servisne radnje
${xml_update_fw}
VAR response := SENDHTTPREQUEST("/rpc/Shelly.Update?stage=\"stable\"");
IF response.IsSuccess
    return("OK");
else
    return("Error");
END
Reboot
VAR response := SENDHTTPREQUEST("/rpc/Shelly.Reboot");
IF response.IsSuccess
    return("OK");
else
    return("Error");
END
Sklopka Sklopka
boolean
Vrijednosti / stanja: ON · OFF

Sklopka

Čitanje stanja sklopke
var x := (sendhttprequest("/rpc/Switch.GetStatus?id=0"));
var 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
Brojilo energije Brojilo električne energije Samo za čitanje

Mjerenje potrošnje snage i energije — trenutačna snaga (kW) i ukupna energija (kWh) s očitanjem struje, napona i temperature

numeric Jedinica: kW / kWh
Servisni atributi
Električna struja
Električni napon
Temperatura

Brojilo energije

Čitanje ukupne potrošnje
return(parsejson(parsejson(Switch.GetStatus,"aenergy"), "total")/1000);
Čitanje zahtjeva
return(parsejson(Switch.GetStatus,"apower")/1000);
Čitanje (modul)
VAR response := SENDHTTPREQUEST("/rpc/Switch.GetStatus?id=0");
IF response.IsSuccess
    Switch.GetStatus := response.Content;
END
Servisni atributi
${electric_current} [A]
return(parsejson(Switch.GetStatus,"current"));
${electric_voltage} [V]
return(parsejson(Switch.GetStatus,"voltage"));
${temperature} [°C]
return(parsejson(parsejson(Switch.GetStatus,"temperature"), "tC"));
Povezivanje: Packet Parser → HTTP • Naziv računala (hostname): shelly1pmg3-{MAC}.local
Moguća poboljšanja (10)
  • 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
  • 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
  • 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