TapHome

Shelly PM Mini Gen3

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

Shelly PM Mini Gen3 je ultrakompaktní Wi-Fi monitor výkonu (29 × 34 × 16 mm), který pasivně měří elektrickou spotřebu do 16 A / 3840 W při 240 VAC. Na rozdíl od Shelly 1PM Gen3, PM Mini Gen3 nemá relé — nedokáže spínat zátěže. Instaluje se do série s monitorovaným obvodem a měří proud protékající jeho svorkami.

TapHome komunikuje se zařízením přes HTTP pomocí Gen2+/Gen3 JSON-RPC 2.0 API v lokální síti — cloudové připojení není potřeba. Šablona dotazuje endpoint komponenty PM1 (/rpc/pm1.GetStatus?id=0) pro všechna data měření výkonu.

Konfigurace

Shelly PM Mini Gen3 se připojuje přes Wi-Fi. Během importu šablony do TapHome zadejte IP adresu zařízení (výchozí placeholder 192.168.0.1).

Autentifikace musí být na zařízení Shelly vypnutá pro integraci s TapHome. TapHome nepodporuje HTTP Digest Auth používanou zařízeními Gen2+/Gen3. Otevřete webové rozhraní Shelly (http://{device-ip}) → Settings → Authentication a ujistěte se, že je vypnutá.

Pokud je na zařízení Shelly zapnutý ECO režim, může způsobit timeouty komunikace kvůli rychlým intervalům dotazování šablony (1–1,5 sekundy). Vypněte ECO režim ve webovém rozhraní Shelly, pokud zaznamenáte přerušovanou konektivitu.

Schopnosti zařízení

Měření výkonu

Vestavěný elektroměr čte dvě hodnoty z odpovědi /rpc/pm1.GetStatus?id=0:

  • Okamžitý výkonapower hlášený ve wattech, šablona konvertuje na kW
  • Celková spotřebaaenergy.total hlášená ve watthodinách, šablona konvertuje na kWh

Elektroměr také exponuje dva servisní atributy:

  • Elektrický proud — zátěžový proud v ampérech (pole current)
  • Elektrické napětí — napájecí napětí ve voltech (pole voltage)
Individuální senzory

Šablona poskytuje tři samostatná senzorová zařízení čtená ze stejného endpointu PM1:

  • Proud [A] — efektivní proud v ampérech
  • Napětí [V] — efektivní napětí ve voltech
  • Frekvence [Hz] — frekvence AC sítě v hertzích

Všechny senzory jsou pouze pro čtení a automaticky se aktualizují s každým dotazovacím cyklem (1,5sekundový interval pro individuální senzory, 1sekundový pro elektroměr).

Komponenta PM1 neexponuje účiník (pf) ani vnitřní teplotu — na rozdíl od komponenty Switch používané na modelech s relé, jako je Shelly 1PM Gen3.

Další schopnosti

Shelly PM Mini Gen3 také exponuje data energie po minutách (aenergy.by_minute), WiFi diagnostiku (SSID, IP, RSSI), MAC adresu zařízení, dobu provozu, využití RAM a čas zařízení ve svých RPC odpovědích. Firmware lze aktualizovat přes /rpc/Shelly.Update a zařízení lze restartovat přes /rpc/Shelly.Reboot. Zařízení také funguje jako BLE Gateway, propojující senzory Shelly BLU do lokální sítě. Tyto schopnosti mohou být přidány v budoucí aktualizaci šablony.

Řešení problémů

Zařízení neodpovídá
  1. Ověřte, že Shelly je připojen k Wi-Fi a má platnou IP adresu
  2. Zkuste použít mDNS hostname (shellypmmig3-AABBCCDDEE.local) místo IP adresy — IP se mohla změnit po obnovení DHCP
  3. Otevřete http://{device-ip}/rpc/Shelly.GetDeviceInfo v prohlížeči — pokud odpoví JSON-em, zařízení je dostupné
  4. Zkontrolujte, že TapHome Core a Shelly jsou ve stejné síti / VLAN
  5. Potvrďte, že autentifikace je na zařízení Shelly vypnutá
Hodnoty výkonu ukazují nulu
  1. Potvrďte, že zátěž je připojena přes PM Mini Gen3 (proud musí procházet svorkami zařízení)
  2. Ověřte, že obvod je pod napětím — PM Mini Gen3 nemá relé, takže monitoruje cokoliv, co protéká vodičem
  3. Dotažte /rpc/pm1.GetStatus?id=0 manuálně v prohlížeči a ověřte, že apower vrací nenulovou hodnotu
  4. Zkontrolujte, že zátěž skutečně odebírá výkon — zařízení v pohotovostním režimu může ukazovat téměř nulové hodnoty

Zařízení Shelly Gen2+/Gen3 podporují až 6 souběžných HTTP připojení. I když je to výrazné zlepšení oproti Gen1 (2 připojení), vyhněte se dotazování z příliš mnoha systémů současně (TapHome, Home Assistant, vlastní skripty), abyste předešli vyčerpání 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.1Internet & SecurityWi-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 PM Mini Gen3 Modul
Vlastní proměnné
Proud Proměnná Pouze ke čtení
numeric Jednotka: A

Proud

Čtení
return(parsejson(status,"current"));
Elektroměr Elektroměr Pouze ke čtení

Měření spotřeby energie — okamžitý výkon (kW) a celková spotřeba (kWh) s měřením proudu a napětí

numeric Jednotka: kW / kWh
Servisní atributy
Elektrický proud
Elektrické napětí

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/pm1.GetStatus?id=0"));
status := x.Content;
Servisní atributy
${current} [a]
return(parsejson(status,"current"));
${electric_voltage} [v]
return(parsejson(status,"voltage"));
Frekvence Proměnná Pouze ke čtení
numeric Jednotka: Hz

Frekvence

Čtení
return(parsejson(status,"freq"));
Napětí Proměnná Pouze ke čtení
numeric Jednotka: V

Napětí

Čtení
parsejson(status,"voltage")
Připojení: Packet Parser → HTTP
Možná vylepšení (8)
  • Energy by Minute — Energy data array per minute, available in pm1.GetStatus response — useful for detailed consumption graphs
  • WiFi Status (SSID, IP, Signal) — WiFi connection info; template has no module-level service_attributes — could be added for diagnostics
  • MAC Address — Device MAC address from Sys.GetStatus, not polled in current template
  • 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
  • Update Firmware — Firmware update via RPC; template has no module-level service_actions
  • Reboot — Device reboot via RPC; template has no module-level service_actions

Zdroje