TapHome

Shelly PM Mini Gen3

Packet Parser → HTTP
Pridal
Posledná aktualizácia: 03. 2026
Shelly PM Mini Gen3

Shelly PM Mini Gen3 je ultrakompaktný Wi-Fi monitor výkonu (29 × 34 × 16 mm), ktorý pasívne meria elektrickú spotrebu do 16 A / 3840 W pri 240 VAC. Na rozdiel od Shelly 1PM Gen3, PM Mini Gen3 nemá relé — nedokáže spínať záťaže. Inštaluje sa do série s monitorovaným obvodom a meria prúd pretekajúci cez jeho svorky.

TapHome komunikuje so zariadením cez HTTP pomocou Gen2+/Gen3 JSON-RPC 2.0 API v lokálnej sieti — cloudové pripojenie nie je potrebné. Šablóna dotazuje endpoint komponentu PM1 (/rpc/pm1.GetStatus?id=0) pre všetky dáta merania výkonu.

Konfigurácia

Shelly PM Mini Gen3 sa pripája cez Wi-Fi. Počas importu šablóny do TapHome zadajte IP adresu zariadenia (predvolený placeholder 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+/Gen3. Otvorte webové rozhranie Shelly (http://{device-ip}) → Settings → Authentication a uistite sa, že je vypnutá.

Ak je na zariadení Shelly zapnutý ECO režim, môže spôsobiť timeouty komunikácie kvôli rýchlym intervalom dotazovania šablóny (1–1,5 sekundy). Vypnite ECO režim vo webovom rozhraní Shelly, ak zaznamenáte prerušovanú konektivitu.

Schopnosti zariadenia

Meranie výkonu

Vstavaný elektromer číta dve hodnoty z odpovede /rpc/pm1.GetStatus?id=0:

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

Elektromer tiež exponuje dva servisné atribúty:

  • Elektrický prúd — záťažový prúd v ampéroch (pole current)
  • Elektrické napätie — napájacie napätie vo voltoch (pole voltage)
Individuálne senzory

Šablóna poskytuje tri samostatné senzorové zariadenia čítané z rovnakého endpointu PM1:

  • Prúd [A] — efektívny prúd v ampéroch
  • Napätie [V] — efektívne napätie vo voltoch
  • Frekvencia [Hz] — frekvencia AC siete v hertzoch

Všetky senzory sú len na čítanie a automaticky sa aktualizujú s každým dotazovacím cyklom (1,5-sekundový interval pre individuálne senzory, 1-sekundový pre elektromer).

Komponent PM1 neexponuje účinník (pf) ani vnútornú teplotu — na rozdiel od komponentu Switch používaného na modeloch s relé, ako je Shelly 1PM Gen3.

Ďalšie schopnosti

Shelly PM Mini Gen3 tiež exponuje dáta energie po minútach (aenergy.by_minute), WiFi diagnostiku (SSID, IP, RSSI), MAC adresu zariadenia, dobu prevádzky, využitie RAM a čas zariadenia vo svojich RPC odpovediach. Firmvér sa dá aktualizovať cez /rpc/Shelly.Update a zariadenie sa dá reštartovať cez /rpc/Shelly.Reboot. Zariadenie tiež funguje ako BLE Gateway, premosťujúc senzory Shelly BLU do lokálnej siete. Tieto schopnosti môžu byť pridané v budúcej aktualizácii šablóny.

Riešenie problémov

Zariadenie neodpovedá
  1. Overte, že Shelly je pripojený k Wi-Fi a má platnú IP adresu
  2. Skúste použiť mDNS hostname (shellypmmig3-AABBCCDDEE.local) namiesto IP adresy — IP sa mohla zmeniť po obnovení DHCP
  3. Otvorte http://{device-ip}/rpc/Shelly.GetDeviceInfo v prehliadači — ak odpovie JSON-om, zariadenie je dostupné
  4. Skontrolujte, že TapHome Core a Shelly sú v rovnakej sieti / VLAN
  5. Potvrďte, že autentifikácia je na zariadení Shelly vypnutá
Hodnoty výkonu ukazujú nulu
  1. Potvrďte, že záťaž je pripojená cez PM Mini Gen3 (prúd musí pretekať cez svorky zariadenia)
  2. Overte, že obvod je pod napätím — PM Mini Gen3 nemá relé, takže monitoruje čokoľvek, čo preteká cez vodič
  3. Dotazujte /rpc/pm1.GetStatus?id=0 manuálne v prehliadači a overte, že apower vracia nenulovú hodnotu
  4. Skontrolujte, že záťaž skutočne odoberá výkon — zariadenie v pohotovostnom režime môže ukazovať takmer nulové hodnoty

Zariadenia Shelly Gen2+/Gen3 podporujú až 6 súbežných HTTP pripojení. Aj keď je to výrazné zlepšenie oproti Gen1 (2 pripojenia), vyhnite sa dotazovaniu z príliš veľa systémov súčasne (TapHome, Home Assistant, vlastné skripty), aby ste predišli vyčerpaniu 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 PM Mini Gen3 Modul
Vlastné premenné
Prúd Premenná Len na čítanie
numeric Jednotka: A

Prúd

Čítanie
return(parsejson(status,"current"));
Elektromer Elektromer Len na čítanie

Meranie spotreby energie — okamžitý výkon (kW) a celková spotreba (kWh) s meraním prúdu a napätia

numeric Jednotka: kW / kWh
Servisné atribúty
Elektrický prúd
Elektrické napätie

Elektromer

Čítanie celkovej spotreby
return(parsejson(parsejson(status,"aenergy"), "total")/1000);
Čítanie odberu
return(parsejson(status,"apower")/1000);
Čítanie (modul)
var x := (sendhttprequest("/rpc/pm1.GetStatus?id=0"));
status := x.Content;
Servisné atribúty
${current} [a]
return(parsejson(status,"current"));
${electric_voltage} [v]
return(parsejson(status,"voltage"));
Frekvencia Premenná Len na čítanie
numeric Jednotka: Hz

Frekvencia

Čítanie
return(parsejson(status,"freq"));
Napätie Premenná Len na čítanie
numeric Jednotka: V

Napätie

Čítanie
parsejson(status,"voltage")
Pripojenie: Packet Parser → HTTP
Možné vylepšenia (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