TapHome

Shelly Plus 1PM

Packet Parser → HTTP
Přidal
Poslední aktualizace: 03. 2026
Shelly Plus 1PM

Shelly Plus 1PM je kompaktní Gen2+ Wi-Fi reléový spínač s vestavěným měřením výkonu. Vejde se za standardní nástěnný vypínač a dokáže ovládat jeden okruh do 16 A (3500 W při 230 V AC) nebo 10 A (30 V DC). Zařízení podporuje napájení 110-240 VAC nebo 24-30 VDC, díky čemuž je vhodné pro síťové i nízkonapěťové instalace. TapHome komunikuje se zařízením lokálně přes Wi-Fi — cloudové připojení není potřeba.

K dispozici jsou dvě šablony TapHome: HTTP šablona, která dotazuje Gen2+ RPC API zařízení, a MQTT šablona, která přijímá data přes MQTT broker. Obě zpřístupňují stejná dvě zařízení — měřič energie a reléový spínač.

Konfigurace

HTTP šablona

HTTP šablona vyžaduje pouze IP adresu zařízení (výchozí hodnota 192.168.0.1). TapHome dotazuje koncový bod /rpc/Switch.GetStatus?id=0 pro stav relé i data měření výkonu. Modul ukládá JSON odpověď do proměnné status, aby jednotlivé skripty zařízení mohly parsovat data bez redundantních HTTP volání.

MQTT šablona

MQTT šablona vyžaduje při importu tři parametry:

  • IP adresa MQTT brokera — IP adresa MQTT brokera (ne samotného zařízení Shelly)
  • Port MQTT brokera — výchozí 1883
  • MQTT Client ID zařízení Shelly — formát shellyplus1pm-{deviceid}, najdete ve webovém rozhraní Shelly v části Settings > MQTT Settings > Client ID

Po aktivaci MQTT na Shelly Plus 1PM (Settings > MQTT) se TapHome přihlásí k odběru shellyplus1pm-{deviceid}/status/switch:0 a ovládací příkazy posílá na shellyplus1pm-{deviceid}/command/switch:0.

Možnosti zařízení

Ovládání relé

Šablona zpřístupňuje relé jako spínací zařízení. Stav relé se čte z pole output (boolean) a ovládá se přes /rpc/Switch.Set?id=0 s parametrem on=true nebo on=false (HTTP) nebo publikováním on/off na příkazový topic (MQTT).

HTTP šablona dotazuje relé v 2,5sekundovém intervalu, což poskytuje téměř okamžitou zpětnou vazbu o stavu. MQTT šablona přijímá aktualizace průběžně přes listener skript.

Měření výkonu

Vestavěný měřič energie čte dvě hodnoty z odpovědi Switch.GetStatus:

  • Okamžitý výkon — apower ve wattech, šablona konvertuje na kW (dělení 1000)
  • Celková spotřeba energie — aenergy.total ve watthodinách, šablona konvertuje na kWh (dělení 1000)

Měřič je pouze ke čtení — aktualizuje se automaticky s každým cyklem dotazování (HTTP) nebo s každou MQTT stavovou zprávou.

HTTP šablona zpřístupňuje na měřiči energie také tři servisní atributy:

AtributJednotkaPopis
ProudAOkamžitý odebíraný proud
NapětíVEfektivní síťové napětí
Teplota°CVnitřní teplota zařízení

MQTT šablona zpřístupňuje vnitřní teplotu, napětí a proud jako servisní atributy na úrovni modulu se stejnými daty, parsovanými z MQTT stavové zprávy.

Další možnosti

Shelly Plus 1PM přes RPC API zpřístupňuje také účiník, síťovou frekvenci, vrácenou energii (pro obousměrné měření), stav fyzického vstupu, sílu Wi-Fi signálu, MAC adresu, dobu provozu, využití RAM a čas zařízení. K dispozici jsou také akce aktualizace firmwaru, restart zařízení, časovač automatického vypnutí, reset počítadla energie a konfigurace ochrany před přetížením. Tyto možnosti mohou být doplněny v budoucí aktualizaci šablony.

Řešení problémů

Zařízení neodpovídá (HTTP)
  1. Ověřte, že Shelly je připojen k Wi-Fi a má platnou IP adresu
  2. Zkuste použít mDNS hostname (shellyplus1pm-AABBCCDDEE.local) místo IP adresy — IP se mohla změnit po obnovení DHCP
  3. Otevřete http://{ip-zarizeni}/rpc/Shelly.GetDeviceInfo v prohlížeči — pokud odpoví JSON, zařízení je dostupné
  4. Zkontrolujte, že TapHome CCU a Shelly jsou ve stejné síti / VLAN
  5. Ujistěte se, že HTTP Digest autentifikace je vypnutá ve webovém rozhraní Shelly — TapHome nepodporuje autentifikované požadavky
MQTT zprávy nepřicházejí
  1. Ověřte, že MQTT je aktivováno ve webovém rozhraní Shelly (Settings > MQTT)
  2. Potvrďte, že adresa a port brokera jsou správné v zařízení Shelly i v nastavení modulu TapHome
  3. Zkontrolujte, že vlastní proměnná plug1topic přesně odpovídá MQTT Client ID zařízení Shelly (např. shellyplus1pm-AABBCCDDEE)
  4. Použijte MQTT klienta (např. MQTT Explorer) k odběru shellyplus1pm-# a ověřte, zda zařízení publikuje zprávy
Hodnoty výkonu ukazují nulu
  1. Potvrďte, že zátěž je připojena přes relé Shelly (ne obejitá)
  2. Zkontrolujte, že relé je zapnuté — měřič měří pouze když přes relé protéká proud
  3. Manuálně zavolejte /rpc/Switch.GetStatus?id=0 a ověřte, že apower vrací nenulovou hodnotu
Pomalá odezva nebo výpadky
  1. Gen2+ zařízení podporují až 6 současných HTTP připojení (oproti 2 na Gen1) — vyhněte se však nadměrnému dotazování z více systémů
  2. Vypněte režim ECO ve webovém rozhraní Shelly, pokud je zapnutý — přepíná zařízení do režimu spánku mezi dotazy a může způsobovat výpadky při krátkých intervalech dotazování
  3. Použijte statickou IP nebo DHCP rezervaci, aby nedocházelo ke změnám adresy
  4. Zvažte přechod na MQTT šablonu v prostředích s více systémy — MQTT zcela obchází problém limitu připojení

Jak nainstalovat v TapHome

Předpoklady

  • Zařízení Shelly nainstalované a zapnuté
  • Lokální Wi-Fi síť (2,4 GHz)
  • TapHome CCU ve stejné síti

Krok 1 — Připojte Shelly k Wi-Fi

Možnost A — Aplikace Shelly (doporučeno):

  1. Stáhněte si aplikaci Shelly (iOS / Android)
  2. Klepněte na + → Add Device a postupujte podle průvodce Bluetooth párováním
  3. Po výzvě zadejte své Wi-Fi přihlašovací údaje

Možnost B — AP režim (bez aplikace):

  1. Při prvním zapnutí zařízení vytvoří hotspot: ShellyXXX-AABBCCDDEE
  2. Připojte telefon/PC k tomuto hotspotu
  3. Otevřete http://192.168.33.1 → Internet & Security → Wi-Fi Mode - Client
  4. Zadejte SSID a heslo → Save

Shelly podporuje pouze 2,4 GHz sítě. 5 GHz sítě se při skenování nezobrazí.

Krok 2 — Zjistěte IP adresu

Po připojení k Wi-Fi zjistěte přiřazenou IP adresu jedním z následujících způsobů:

  • Aplikace Shelly: Detail zařízení → Device info → IP adresa
  • Webové rozhraní Shelly: Připojte se k AP zařízení před nastavením Wi-Fi — IP se zobrazí po uložení
  • DHCP tabulka routeru: Hledejte hostname jako shelly1pm-AABBCCDDEE
  • mDNS: Pingněte shelly<model>-<mac>.local (např. shelly1pm-AABBCCDDEE.local) ze stejné sítě

Přiřaďte zařízení Shelly statickou IP (DHCP rezervaci) ve vašem routeru, aby se adresa nezměnila po restartu routeru.

Krok 3 — Konfigurace v TapHome

  1. V TapHome přidejte nový modul Packet Parser (HTTP)
  2. IP Address: zadejte IP z kroku 2 (např. 192.168.1.50)
  3. Port: 80 (výchozí, není potřeba měnit)
  4. Importujte šablonu — TapHome bude pravidelně číst /status pro zjištění stavu zařízení

HTTP autentifikace je na zařízeních Shelly standardně vypnutá. Pokud jste povolili ochranu přihlášením, TapHome momentálně nepodporuje HTTP Basic Auth — pro integraci s TapHome ponechte autentifikaci vypnutou.

Dostupná zařízení

Shelly Plus 1PM Modul
Vlastní proměnné
Elektroměr Elektroměr Pouze ke čtení

Okamžitý výkon (kW) a celková spotřeba (kWh) s diagnostikou proudu, napětí a teploty

numeric Jednotka: kW / kWh
Servisní atributy
Proud
Napětí
Teplota

Elektroměr

Čtení celkové spotřeby
return(parsejson(parsejson(status,"aenergy"), "total")/1000);
Čtení odběru
return(parsejson(status,"apower")/1000);
Čtení (modul)
var x := (sendhttprequest("/rpc/Switch.GetStatus?id=0"));
status := x.Content;
Servisní atributy
${current} [a]
return(parsejson(status,"current"));
${electric_voltage} [v]
return(parsejson(status,"voltage"));
${temp} [C]
return(parsejson(parsejson(status,"temperature"), "tC"));
Spínač Přepínač
boolean
Hodnoty / Stavy: ON · OFF

Spínač

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