TapHome

Shelly Pro 4PM

Packet Parser → HTTP
Pridal
Posledná aktualizácia: 03. 2026
Shelly Pro 4PM

Shelly Pro 4PM je 4-kanálové inteligentné relé na DIN lištu so vstavaným meraním výkonu na kanál. Každý zo štyroch nezávislých výstupov dokáže spínať až 16 A (celkovo 40 A), čo ho robí vhodným na ovládanie svetelných okruhov, spotrebičov alebo záťaží v rozvádzači s individuálnym monitoringom energie na kanál. TapHome komunikuje so zariadením cez HTTP v lokálnej sieti — cloudové pripojenie nie je potrebné.

Šablóna používa zmiešaný prístup k API: Gen2+ RPC koncové body (/rpc/Switch.GetStatus?id=N) na čítanie merania energie a Gen1 koncové body (/relay/N?turn=on|off) na ovládanie relé. Obe generácie API sú podporované zariadením Pro 4PM kvôli spätnej kompatibilite. Zariadenie sa pripája cez WiFi alebo Ethernet (RJ45) a disponuje 1,8-palcovým farebným LCD displejom na lokálne sledovanie stavu.

Konfigurácia

Shelly Pro 4PM sa pripája cez WiFi alebo Ethernet. Počas importu šablóny TapHome zadajte IP adresu zariadenia (predvolená hodnota 192.168.0.1).

Autentifikácia musí byť na zariadení Shelly vypnutá pre integráciu s TapHome. TapHome nepodporuje HTTP Digest Auth používanú zariadeniami Gen2. Otvorte webové rozhranie Shelly (http://{ip-zariadenia}) → Settings → Authentication a uistite sa, že je vypnutá.

LAN kábel sa smie zapájať alebo odpájať len keď je zariadenie vypnuté. Pripojenie Ethernet kábla za chodu môže spôsobiť problémy.

Ak je na zariadení Shelly zapnutý režim ECO, môže spôsobovať výpadky komunikácie kvôli krátkym intervalom dotazovania šablóny (2,5–15 sekúnd). Vypnite režim ECO vo webovom rozhraní Shelly, ak zaznamenáte občasné problémy s pripojením.

Možnosti zariadenia

Meranie energie

Šablóna sprístupňuje štyri nezávislé zariadenia elektromera, jedno na kanál. Každý merač číta z /rpc/Switch.GetStatus?id=N (kde N je 0–3):

  • Okamžitý výkon — apower vo wattoch, šablóna konvertuje na kW
  • Celková spotreba — aenergy.total vo watthodinách, šablóna konvertuje na kWh

Kanál 1 sa dotazuje každých 2,5 sekundy pre rýchlejšiu odozvu. Kanály 2–4 sa dotazujú každých 15 sekúnd.

Merače sú len na čítanie — aktualizujú sa automaticky s každým cyklom dotazovania.

Ovládanie relé

Šablóna sprístupňuje štyri reléové spínacie zariadenia, jedno na kanál. Každé relé sa ovláda cez Gen1 koncový bod /relay/N?turn=on|off (kde N je 0–3).

Reléové spínače sú len na zápis — šablóna nečíta stav relé späť zo zariadenia. Aktuálny stav relé je možné odvodiť z príslušného elektromera: ak kanál hlási nenulovú spotrebu, relé je zapnuté. Budúca aktualizácia šablóny by mohla pridať spätnú väzbu stavu relé pomocou Gen2+ /rpc/Switch.GetStatus?id=N → pole output.

Senzor výkonu

Samostatné zariadenie senzora výkonu sprístupňuje surový aktívny výkon vo wattoch pre kanál 1 (čítaný z /rpc/Switch.GetStatus?id=0 → apower). Na rozdiel od elektromera, ktorý konvertuje na kW, tento senzor hlási hodnotu vo wattoch bez konverzie, čo je užitočné pre automatizácie vyžadujúce presnosť na úrovni wattov.

Servisná diagnostika

Šablóna sprístupňuje 13 servisných atribútov na monitoring zariadenia:

  • Informácie o zariadení — hostname, MAC adresa, čas zariadenia, uptime, využitie RAM
  • Tepelná ochrana — vnútorná teplota (°C), stav teploty (Normal / High / Very High), príznak prehriatia
  • Konektivita — cloud zapnutý/pripojený, MQTT pripojený, dostupná aktualizácia firmvéru
  • Ochrana výkonu — aktuálny maximálny limit výkonu (čítaný z /settings)
Servisné akcie

K dispozícii sú tri servisné akcie:

  • Nastavenie ochrany výkonu — nastaví maximálny limit výkonu (1–3500 W). Relé sa automaticky vypne, ak spotreba prekročí túto hodnotu.
  • Zapnutie cloudu — zapne alebo vypne pripojenie k Shelly Cloud
  • Reštart — spustí reštart zariadenia
Ďalšie možnosti

Shelly Pro 4PM tiež sprístupňuje napätie, prúd, účinník, frekvenciu a vnútornú teplotu na kanál vo svojej odpovedi /rpc/Switch.GetStatus. K dispozícii sú aj stavy fyzických prepínačov/tlačidiel (S1–S4), stav Ethernetu, Wi-Fi RSSI a natívne Gen2+ ovládanie relé s časovačom automatického vypnutia cez RPC API. Tieto možnosti môžu byť doplnené v budúcej aktualizácii šablóny.

Riešenie problémov

Zariadenie neodpovedá
  1. Overte, že Shelly je pripojený k WiFi alebo Ethernetu a má platnú IP adresu
  2. Skúste použiť mDNS hostname (shellypro4pm-AABBCCDDEE.local) namiesto IP adresy — IP sa mohla zmeniť po obnovení DHCP
  3. Otvorte http://{ip-zariadenia}/rpc/Shelly.GetDeviceInfo v prehliadači — ak odpovie JSON, zariadenie je dostupné
  4. Skontrolujte, že TapHome Core a Shelly sú v rovnakej sieti / VLAN
  5. Uistite sa, že autentifikácia je na zariadení Shelly vypnutá
Hodnoty výkonu ukazujú nulu
  1. Potvrďte, že záťaž je pripojená cez reléový výstup Shelly (O1–O4), nie obídená
  2. Skontrolujte, že relé je zapnuté — merač meria len keď cez relé preteká prúd
  3. Manuálne zavolajte /rpc/Switch.GetStatus?id=0 a overte, že apower vracia nenulovú hodnotu
  4. Overte správne ID kanála (id=0 pre Výstup 1, id=1 pre Výstup 2 atď.)
Neznámy stav relé

Reléové spínače v tejto šablóne sú len na zápis — posielajú príkazy zapnutia/vypnutia, ale nečítajú stav relé späť. Na overenie skutočného stavu relé:

  1. Skontrolujte príslušný elektromer — nenulový výkon znamená, že relé je zapnuté
  2. Pozrite sa na LED indikátory relé na prednom paneli zariadenia
  3. Otestujte manuálne cez prehliadač: http://{ip-zariadenia}/relay/0 vráti aktuálny stav relé v JSON
Varovanie pred prehriatím

Shelly Pro 4PM má vnútornú tepelnú ochranu. Ak teplota zariadenia prekročí bezpečné limity, temperature_status sa zmení na “High” alebo “Very High” a overtemperature sa zmení na true. Zabezpečte dostatočné vetranie v rozvádzači, najmä pri spínaní vysokých záťaží na viacerých kanáloch súčasne.

V1 vs V2 hardvér

Obe verzie používajú rovnaký firmvér a API. V2 (SPSW-104PE16EU) má vylepšené konektory — päť individuálnych skrutkových svoriek namiesto štyroch 2-svorkových blokov — a lepšiu elektrickú izoláciu LAN. Medzi verziami nie sú potrebné žiadne zmeny šablóny.

Gen2 zariadenia Shelly podporujú až 6 súčasných HTTP pripojení. Šablóna Shelly Pro 4PM používa až 5 súčasných koncových bodov na cyklus dotazovania (4 elektromery + stav modulu), čo ponecháva obmedzený priestor. Vyhnite sa dotazovaniu z príliš veľa systémov súčasne.

Ako nainštalovať v TapHome

Predpoklady

  • Zariadenie Shelly nainštalované a zapnuté
  • Lokálna Wi-Fi sieť (2,4 GHz)
  • TapHome CCU v rovnakej sieti

Krok 1 — Pripojte Shelly k Wi-Fi

Možnosť A — Aplikácia Shelly (odporúčané):

  1. Stiahnite si aplikáciu Shelly (iOS / Android)
  2. Klepnite na + → Add Device a postupujte podľa sprievodcu Bluetooth párovaním
  3. Po výzve zadajte svoje Wi-Fi prihlasovacie údaje

Možnosť B — AP režim (bez aplikácie):

  1. Pri prvom zapnutí zariadenie vytvorí hotspot: ShellyXXX-AABBCCDDEE
  2. Pripojte telefón/PC k tomuto hotspotu
  3. Otvorte http://192.168.33.1 → Internet & Security → Wi-Fi Mode - Client
  4. Zadajte SSID a heslo → Save

Shelly podporuje iba 2,4 GHz siete. 5 GHz siete sa pri skenovaní nezobrazia.

Krok 2 — Zistite IP adresu

Po pripojení k Wi-Fi zistite priradenú IP adresu jedným z nasledujúcich spôsobov:

  • Aplikácia Shelly: Detail zariadenia → Device info → IP adresa
  • Webové rozhranie Shelly: Pripojte sa k AP zariadenia pred nastavením Wi-Fi — IP sa zobrazí po uložení
  • DHCP tabuľka routera: Hľadajte hostname ako shelly1pm-AABBCCDDEE
  • mDNS: Pingnite shelly<model>-<mac>.local (napr. shelly1pm-AABBCCDDEE.local) z rovnakej siete

Priraďte zariadeniu Shelly statickú IP (DHCP rezerváciu) vo vašom routeri, aby sa adresa nezmenila po reštarte routera.

Krok 3 — Konfigurácia v TapHome

  1. V TapHome pridajte nový modul Packet Parser (HTTP)
  2. IP Address: zadajte IP z kroku 2 (napr. 192.168.1.50)
  3. Port: 80 (predvolený, nie je potrebné meniť)
  4. Importujte šablónu — TapHome bude pravidelne čítať /status pre zistenie stavu zariadenia

HTTP autentifikácia je na zariadeniach Shelly štandardne vypnutá. Ak ste povolili ochranu prihlásením, TapHome momentálne nepodporuje HTTP Basic Auth — pre integráciu s TapHome ponechajte autentifikáciu vypnutú.

Dostupné zariadenia

Shelly Pro 4PM Modul
Servisné akcie
Nastaviť ochranu výkonuNastaviť maximálny limit výkonu (1–3500 W) — relé sa automaticky vypne, ak spotreba prekročí túto hodnotu
Povoliť cloudPovoliť alebo zakázať pripojenie k Shelly Cloud
ReštartSpustiť reštart zariadenia
Vlastné premenné
StatusJson (string)
SettingsJson (string)
status (string) = 0

Shelly 4 Pro

Čítanie (modul)
VAR response := SENDHTTPREQUEST("/status", "GET");
StatusJson := response.Content;
Servisné akcie
Set power protection
Parametre: Maximum power (1–3500 Watts)
VAR response := SENDHTTPREQUEST("settings?max_power=" + Watts);
VAR contentJson := response.Content;
VAR limitSet := PARSEJSON(contentJson, "max_power");

"Power limit set to " + limitSet + "W"
Enable cloud
Parametre: Enable (Enable / Disable)
VAR response := SENDHTTPREQUEST("/settings/cloud?enabled=" + enable);
VAR contentJson := response.Content;
VAR wasEnabled := PARSEJSON(contentJson, "enabled");

IF(wasEnabled, "Cloud enabled", "Cloud disabled");
Reboot
VAR response := SENDHTTPREQUEST("/reboot");
VAR contentJson := response.Content;
VAR wasRebooted := PARSEJSON(contentJson, "ok");

IF(wasRebooted, "Reboot successful", "Error");
Elektromer kanál 1 Elektromer Len na čítanie

Meranie spotreby a energie pre výstup 1 — okamžitý výkon (kW) a celková spotreba (kWh)

numeric Jednotka: W / kWh

Elektromer kanál 1

Čítanie celkovej spotreby
return(parsejson(parsejson(status,"aenergy"), "total")/1000);
Čítanie odberu
return(parsejson(status,"apower")/1000);
Čítanie (modul)
var x := (sendhttprequest("/rpc/Switch.GetStatus?id=0"));
status := x.Content;
Elektromer kanál 2 Elektromer Len na čítanie

Meranie spotreby a energie pre výstup 2 — okamžitý výkon (kW) a celková spotreba (kWh)

numeric Jednotka: W / kWh

Elektromer kanál 2

Čítanie celkovej spotreby
return(parsejson(parsejson(status,"aenergy"), "total")/1000);
Čítanie odberu
return(parsejson(status,"apower")/1000);
Čítanie (modul)
var x := (sendhttprequest("/rpc/Switch.GetStatus?id=1"));
status := x.Content;
Elektromer kanál 3 Elektromer Len na čítanie

Meranie spotreby a energie pre výstup 3 — okamžitý výkon (kW) a celková spotreba (kWh)

numeric Jednotka: W / kWh

Elektromer kanál 3

Čítanie celkovej spotreby
return(parsejson(parsejson(status,"aenergy"), "total")/1000);
Čítanie odberu
return(parsejson(status,"apower")/1000);
Čítanie (modul)
var x := (sendhttprequest("/rpc/Switch.GetStatus?id=2"));
status := x.Content;
Elektromer kanál 4 Elektromer Len na čítanie

Meranie spotreby a energie pre výstup 4 — okamžitý výkon (kW) a celková spotreba (kWh)

numeric Jednotka: W / kWh

Elektromer kanál 4

Čítanie celkovej spotreby
return(parsejson(parsejson(status,"aenergy"), "total")/1000);
Čítanie odberu
return(parsejson(status,"apower")/1000);
Čítanie (modul)
var x := (sendhttprequest("/rpc/Switch.GetStatus?id=3"));
status := x.Content;
Relé kanál 2 Prepínač

Ovládanie relé pre výstup 2 (len zápis) — stav sa nečíta, odvodiť z elektromera

boolean
Hodnoty / Stavy: ON · OFF

Relé kanál 2

Zápis stavu prepínača
VAR path := "relay/1?turn=" + SWITCH(St, 0, "off", 1, "on","off");
SENDHTTPREQUEST(path);
Relé kanál 1 Prepínač

Ovládanie relé pre výstup 1 (len zápis) — stav sa nečíta, odvodiť z elektromera

boolean
Hodnoty / Stavy: ON · OFF

Relé kanál 1

Zápis stavu prepínača
VAR path := "relay/0?turn=" + SWITCH(St, 0, "off", 1, "on","off");
SENDHTTPREQUEST(path);
Senzor výkonu kanál 1 Premenná Len na čítanie

Surový činný výkon vo wattoch pre kanál 1 — samostatná hodnota senzora bez konverzie na kW

numeric Jednotka: W

Senzor výkonu kanál 1

Čítanie
return(parsejson(status,"apower"));
Čítanie (modul)
var x := (sendhttprequest("/rpc/Switch.GetStatus?id=0"));
status := x.Content;
Relé kanál 3 Prepínač

Ovládanie relé pre výstup 3 (len zápis) — stav sa nečíta, odvodiť z elektromera

boolean
Hodnoty / Stavy: ON · OFF

Relé kanál 3

Zápis stavu prepínača
VAR path := "relay/2?turn=" + SWITCH(St, 0, "off", 1, "on","off");
SENDHTTPREQUEST(path);
Relé kanál 4 Prepínač

Ovládanie relé pre výstup 4 (len zápis) — stav sa nečíta, odvodiť z elektromera

boolean
Hodnoty / Stavy: ON · OFF

Relé kanál 4

Zápis stavu prepínača
VAR path := "relay/3?turn=" + SWITCH(St, 0, "off", 1, "on","off");
SENDHTTPREQUEST(path);
Pripojenie: Packet Parser → HTTP
Možné vylepšenia (10)
  • Relay State Read — Switches have no readswitchstate script — relay state is not read back. Gen2+ /rpc/Switch.GetStatus?id=N provides output (boolean) for state feedback.
  • Voltage — Per-channel line voltage in V, available in /rpc/Switch.GetStatus response
  • Current — Per-channel load current in A, available in /rpc/Switch.GetStatus response
  • Power Factor — Per-channel power factor, available in /rpc/Switch.GetStatus response
  • Frequency — Network frequency in Hz, available in /rpc/Switch.GetStatus response
  • Per-Channel Temperature — Internal temperature in °C per switch component, available in /rpc/Switch.GetStatus response
  • Input States (S1-S4) — 4 physical switch/button inputs, available via /rpc/Input.GetStatus?id=0..3
  • Gen2+ Relay Control — Native Gen2+ relay control with toggle_after timer support. Template uses Gen1 /relay/N instead.
  • WiFi Status (SSID, IP, RSSI) — WiFi status including signal strength, available via Gen2+ RPC
  • Ethernet Status — Pro 4PM has RJ45 LAN port; Ethernet status (IP, link) available via /rpc/Ethernet.GetStatus

Zdroje