TapHome

Shelly Plus 1PM

Packet Parser → HTTP
Pridal
Posledná aktualizácia: 03. 2026
Shelly Plus 1PM

Shelly Plus 1PM je kompaktný Gen2+ Wi-Fi reléový spínač so vstavaným meraním výkonu. Zmestí sa za štandardný nástenný vypínač a dokáže ovládať jeden okruh do 16 A (3500 W pri 230 V AC) alebo 10 A (30 V DC). Zariadenie podporuje napájanie 110-240 VAC alebo 24-30 VDC, vďaka čomu je vhodné pre sieťové aj nízkonapäťové inštalácie. TapHome komunikuje so zariadením lokálne cez Wi-Fi — cloudové pripojenie nie je potrebné.

K dispozícii sú dve šablóny TapHome: HTTP šablóna, ktorá dotazuje Gen2+ RPC API zariadenia, a MQTT šablóna, ktorá prijíma dáta cez MQTT broker. Obe sprístupňujú rovnaké dve zariadenia — merač energie a reléový spínač.

Konfigurácia

HTTP šablóna

HTTP šablóna vyžaduje len IP adresu zariadenia (predvolená hodnota 192.168.0.1). TapHome dotazuje koncový bod /rpc/Switch.GetStatus?id=0 pre stav relé aj dáta merania výkonu. Modul ukladá JSON odpoveď do premennej status, aby jednotlivé skripty zariadení mohli parsovať dáta bez redundantných HTTP volaní.

MQTT šablóna

MQTT šablóna vyžaduje pri importe tri parametre:

  • IP adresa MQTT brokera — IP adresa MQTT brokera (nie samotného zariadenia Shelly)
  • Port MQTT brokera — predvolený 1883
  • MQTT Client ID zariadenia Shelly — formát shellyplus1pm-{deviceid}, nájdete vo webovom rozhraní Shelly v časti Settings > MQTT Settings > Client ID

Po aktivácii MQTT na Shelly Plus 1PM (Settings > MQTT) sa TapHome prihlási na odber shellyplus1pm-{deviceid}/status/switch:0 a ovládacie príkazy posiela na shellyplus1pm-{deviceid}/command/switch:0.

Možnosti zariadenia

Ovládanie relé

Šablóna sprístupňuje relé ako spínacie zariadenie. Stav relé sa číta z poľa output (boolean) a ovláda sa cez /rpc/Switch.Set?id=0 s parametrom on=true alebo on=false (HTTP) alebo publikovaním on/off na príkazový topic (MQTT).

HTTP šablóna dotazuje relé v 2,5-sekundovom intervale, čo poskytuje takmer okamžitú spätnú väzbu o stave. MQTT šablóna prijíma aktualizácie priebežne cez listener skript.

Meranie výkonu

Vstavaný merač energie číta dve hodnoty z odpovede Switch.GetStatus:

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

Merač je len na čítanie — aktualizuje sa automaticky s každým cyklom dotazovania (HTTP) alebo s každou MQTT stavovou správou.

HTTP šablóna sprístupňuje na merači energie aj tri servisné atribúty:

AtribútJednotkaPopis
PrúdAOkamžitý odoberaný prúd
NapätieVEfektívne sieťové napätie
Teplota°CVnútorná teplota zariadenia

MQTT šablóna sprístupňuje vnútornú teplotu, napätie a prúd ako servisné atribúty na úrovni modulu s rovnakými dátami, parsovanými z MQTT stavovej správy.

Ďalšie možnosti

Shelly Plus 1PM cez RPC API sprístupňuje aj účinník, sieťovú frekvenciu, vrátenú energiu (pre obojsmerné meranie), stav fyzického vstupu, silu Wi-Fi signálu, MAC adresu, dobu prevádzky, využitie RAM a čas zariadenia. K dispozícii sú aj akcia aktualizácie firmvéru, reštart zariadenia, časovač automatického vypnutia, reset počítadla energie a konfigurácia ochrany pred preťažením. Tieto možnosti môžu byť doplnené v budúcej aktualizácii šablóny.

Riešenie problémov

Zariadenie neodpovedá (HTTP)
  1. Overte, že Shelly je pripojený k Wi-Fi a má platnú IP adresu
  2. Skúste použiť mDNS hostname (shellyplus1pm-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 CCU a Shelly sú v rovnakej sieti / VLAN
  5. Uistite sa, že HTTP Digest autentifikácia je vypnutá vo webovom rozhraní Shelly — TapHome nepodporuje autentifikované požiadavky
MQTT správy neprichádzajú
  1. Overte, že MQTT je aktivované vo webovom rozhraní Shelly (Settings > MQTT)
  2. Potvrďte, že adresa a port brokera sú správne v zariadení Shelly aj v nastaveniach modulu TapHome
  3. Skontrolujte, že vlastná premenná plug1topic presne zodpovedá MQTT Client ID zariadenia Shelly (napr. shellyplus1pm-AABBCCDDEE)
  4. Použite MQTT klienta (napr. MQTT Explorer) na odber shellyplus1pm-# a overte, či zariadenie publikuje správy
Hodnoty výkonu ukazujú nulu
  1. Potvrďte, že záťaž je pripojená cez relé Shelly (nie obísená)
  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
Pomalá odozva alebo výpadky
  1. Gen2+ zariadenia podporujú až 6 súčasných HTTP pripojení (oproti 2 na Gen1) — vyhnite sa však nadmernému dotazovaniu z viacerých systémov
  2. Vypnite režim ECO vo webovom rozhraní Shelly, ak je zapnutý — prepína zariadenie do režimu spánku medzi dotazmi a môže spôsobovať výpadky pri krátkych intervaloch dotazovania
  3. Použite statickú IP alebo DHCP rezerváciu, aby nedochádzalo k zmenám adresy
  4. Zvážte prechod na MQTT šablónu v prostrediach s viacerými systémami — MQTT úplne obchádza problém limitu pripojení

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 Plus 1PM Modul
Vlastné premenné
Elektromer Elektromer Len na čítanie

Okamžitý výkon (kW) a celková spotreba (kWh) s diagnostikou prúdu, napätia a teploty

numeric Jednotka: kW / kWh
Servisné atribúty
Prúd
Napätie
Teplota

Elektromer

Čí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;
Servisné atribúty
${current} [a]
return(parsejson(status,"current"));
${electric_voltage} [v]
return(parsejson(status,"voltage"));
${temp} [C]
return(parsejson(parsejson(status,"temperature"), "tC"));
Spínač Prepínač
boolean
Hodnoty / Stavy: ON · OFF

Spínač

Čítanie stavu prepínača
var x := (sendhttprequest("/rpc/Switch.GetStatus?id=0"));
status := x.Content;
return(PARSEJSON(status, "$.output", true));
Zápis stavu prepínača
VAR response := SENDHTTPREQUEST("rpc/Switch.Set?id=0&on=" + if(St,"true","false"));
IF response.IsSuccess = false
  ADDERROR(response.StatusCode);
END
Pripojenie: Packet Parser → HTTP
Možné vylepšenia (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

Zdroje