TapHome

Shelly Plus 1PM

Packet Parser → HTTP
Přidal
Poslední aktualizace: 06. 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

Našli jste problém s touto šablonou zařízení?

Napište nám, co nefunguje, co chybí, nebo jak by se měla šablona chovat. Vaše zpětná vazba nám pomáhá udržet katalog přesný.

Ověřeno TapHome

Chcete to použít ve svém TapHome jádře?

Otevřete tuto šablonu v zákaznickém portálu a použijte ji ve svém domově, nebo navrhněte úpravu a odešlete ji zpět do katalogu.

Otevřít v portálu