--- title: "Shelly PM Mini Gen3" description: "Monitoruj moc, napięcie, prąd i częstotliwość przez HTTP RPC API. Szablon TapHome dla Shelly PM Mini Gen3 — kompaktowy licznik Wi-Fi bez przekaźnika." url: "https://taphome.com/pl/compatibility/shelly-pm-mini-gen3/" language: pl lastmod: 2026-03-29 generator: hugo ai: topics: ["http","electric-meter","wifi","power-metering","mdns"] questions: ["Jak zintegrować Shelly PM Mini Gen3 z TapHome?","Co mierzy szablon Shelly PM Mini Gen3 w TapHome?","Jak podłączyć Shelly PM Mini Gen3 przez HTTP do TapHome?","Jaka jest różnica między Shelly PM Mini Gen3 a 1PM Gen3 w TapHome?","Dlaczego Shelly PM Mini Gen3 pokazuje zerowe wartości mocy?","Czy Shelly PM Mini Gen3 może przełączać obciążenia, czy jest tylko monitorem?"] --- # Shelly PM Mini Gen3 Komunikacja: Packet Parser → HTTP - [Strona produktu Shelly PM Mini Gen3](https://www.shelly.com/en/products/shop/shelly-pm-mini-gen3) > Adres w sieci > > TapHome łączy się z urządzeniem pod adresem podanym przy imporcie. Nadaj urządzeniu stały adres — rezerwację IP w routerze albo jego nazwę mDNS, jeśli ją obsługuje — inaczej integracja przestanie działać, gdy router zmieni adres. > > [Przygotowanie sieci](https://taphome.com/pl/docs/setup/network-preparation/) ## Poradnik integracji Shelly PM Mini Gen3 to ultrakompaktowy monitor mocy Wi-Fi (29 × 34 × 16 mm), który pasywnie mierzy zużycie elektryczne do 16 A / 3840 W przy 240 VAC. W odróżnieniu od Shelly 1PM Gen3, PM Mini Gen3 **nie ma przekaźnika** — nie może przełączać obciążeń. Instaluje się go szeregowo z monitorowanym obwodem, a mierzy prąd płynący przez jego zaciski. TapHome komunikuje się z urządzeniem przez HTTP za pomocą API Gen2+/Gen3 JSON-RPC 2.0 w sieci lokalnej — połączenie z chmurą nie jest wymagane. Szablon odpytuje endpoint komponentu PM1 (`/rpc/pm1.GetStatus?id=0`) o wszystkie dane pomiarowe. ## Konfiguracja Shelly PM Mini Gen3 łączy się przez Wi-Fi. Podczas importu szablonu do TapHome wprowadź adres IP urządzenia (domyślny placeholder `192.168.0.1`). > [!WARNING] > Uwierzytelnianie musi być **wyłączone** na urządzeniu Shelly dla integracji z TapHome. TapHome nie obsługuje HTTP Digest Auth używanego przez urządzenia Gen2+/Gen3. Otwórz interfejs webowy Shelly (`http://{device-ip}`) → Settings → Authentication i upewnij się, że jest wyłączone. > [!NOTE] > Jeśli tryb ECO jest włączony na urządzeniu Shelly, może powodować timeouty komunikacji z powodu szybkich interwałów odpytywania szablonu (1–1,5 sekundy). Wyłącz tryb ECO w interfejsie webowym Shelly, jeśli doświadczasz przerywanych problemów z łącznością. ## Możliwości urządzenia ### Pomiar mocy Wbudowany licznik energii odczytuje dwie wartości z odpowiedzi `/rpc/pm1.GetStatus?id=0`: - **Moc w czasie rzeczywistym** — `apower` raportowany w watach, szablon konwertuje na kW - **Całkowite zużycie** — `aenergy.total` raportowane w watogodzinach, szablon konwertuje na kWh Licznik udostępnia również dwa atrybuty serwisowe: - **Prąd elektryczny** — prąd obciążenia w amperach (pole `current`) - **Napięcie elektryczne** — napięcie zasilania w woltach (pole `voltage`) ### Indywidualne czujniki Szablon udostępnia trzy samodzielne urządzenia czujnikowe odczytywane z tego samego endpointu PM1: - **Prąd [A]** — prąd skuteczny w amperach - **Napięcie [V]** — napięcie skuteczne w woltach - **Częstotliwość [Hz]** — częstotliwość sieci AC w hercach Wszystkie czujniki są tylko do odczytu i aktualizują się automatycznie z każdym cyklem odpytywania (1,5-sekundowy interwał dla indywidualnych czujników, 1-sekundowy dla licznika energii). > [!NOTE] > Komponent PM1 **nie** udostępnia współczynnika mocy (`pf`) ani wewnętrznej temperatury — w odróżnieniu od komponentu Switch używanego w modelach z przekaźnikiem, takich jak Shelly 1PM Gen3. ### Dodatkowe możliwości Shelly PM Mini Gen3 udostępnia również minutowe dane energetyczne (`aenergy.by_minute`), diagnostykę WiFi (SSID, IP, RSSI), adres MAC urządzenia, czas pracy, wykorzystanie RAM i czas urządzenia w swoich odpowiedziach RPC. Firmware można zaktualizować przez `/rpc/Shelly.Update`, a urządzenie można zrestartować przez `/rpc/Shelly.Reboot`. Urządzenie funkcjonuje również jako BLE Gateway, łącząc czujniki Shelly BLU z siecią lokalną. Te możliwości mogą zostać dodane w przyszłej aktualizacji szablonu. ## Rozwiązywanie problemów ### Urządzenie nie odpowiada 1. Sprawdź, czy Shelly jest połączony z Wi-Fi i ma prawidłowy adres IP 2. Spróbuj użyć nazwy hosta mDNS (`shellypmmig3-AABBCCDDEE.local`) zamiast adresu IP — IP mógł się zmienić po odnowieniu DHCP 3. Otwórz `http://{device-ip}/rpc/Shelly.GetDeviceInfo` w przeglądarce — jeśli odpowie JSON-em, urządzenie jest osiągalne 4. Sprawdź, czy TapHome Core i Shelly są w tej samej sieci / VLAN 5. Potwierdź, że uwierzytelnianie jest wyłączone na urządzeniu Shelly ### Wartości mocy pokazują zero 1. Potwierdź, że obciążenie jest podłączone przez PM Mini Gen3 (prąd musi przepływać przez zaciski urządzenia) 2. Sprawdź, czy obwód jest pod napięciem — PM Mini Gen3 nie ma przekaźnika, więc monitoruje to, co przepływa przez przewód 3. Odpytaj `/rpc/pm1.GetStatus?id=0` ręcznie w przeglądarce i sprawdź, czy `apower` zwraca wartość różną od zera 4. Sprawdź, czy obciążenie faktycznie pobiera moc — urządzenie w trybie czuwania może pokazywać wartości bliskie zeru > [!WARNING] > Urządzenia Shelly Gen2+/Gen3 obsługują do **6 jednoczesnych połączeń HTTP**. Choć jest to znaczna poprawa w stosunku do Gen1 (2 połączenia), unikaj odpytywania z zbyt wielu systemów jednocześnie (TapHome, Home Assistant, własne skrypty), aby zapobiec wyczerpaniu połączeń. ## Jak zainstalować w TapHome ### Wymagania wstępne - Urządzenie Shelly zainstalowane i włączone - Lokalna sieć Wi-Fi (2,4 GHz) - TapHome CCU w tej samej sieci ### Krok 1 — Podłącz Shelly do Wi-Fi **Opcja A — Aplikacja Shelly (zalecana):** 1. Pobierz [aplikację Shelly](https://www.shelly.com/en/support/shelly-app) (iOS / Android) 2. Dotknij **+** → **Add Device** i postępuj zgodnie z kreatorem parowania Bluetooth 3. Wprowadź dane logowania Wi-Fi, gdy zostaniesz o to poproszony **Opcja B — Tryb AP (bez aplikacji):** 1. Przy pierwszym uruchomieniu urządzenie tworzy hotspot: `ShellyXXX-AABBCCDDEE` 2. Połącz telefon/PC z tym hotspotem 3. Otwórz `http://192.168.33.1` → **Internet & Security** → **Wi-Fi Mode - Client** 4. Wprowadź SSID i hasło → **Save** > [!NOTE] > Shelly obsługuje tylko sieci **2,4 GHz**. Sieci 5 GHz nie pojawią się podczas skanowania. ### Krok 2 — Znajdź adres IP Po połączeniu z Wi-Fi znajdź przypisany adres IP za pomocą jednej z poniższych metod: - **Aplikacja Shelly:** Szczegóły urządzenia → **Device info** → Adres IP - **Interfejs webowy Shelly:** Połącz się z AP urządzenia przed konfiguracją Wi-Fi — IP zostanie wyświetlone po zapisaniu - **Tabela DHCP routera:** Szukaj nazwy hosta takiej jak `shelly1pm-AABBCCDDEE` - **mDNS:** Pinguj `shelly-.local` (np. `shelly1pm-AABBCCDDEE.local`) z tej samej sieci > [!TIP] > Przypisz urządzeniu Shelly **statyczny IP** (rezerwację DHCP) w routerze, aby adres nie zmieniał się po ponownym uruchomieniu routera. ### Krok 3 — Konfiguracja w TapHome 1. W TapHome dodaj nowy moduł **Packet Parser (HTTP)** 2. **IP Address:** wprowadź IP z kroku 2 (np. `192.168.1.50`) 3. **Port:** `80` (domyślny, nie wymaga zmiany) 4. Zaimportuj szablon — TapHome będzie okresowo odpytywać `/status` w celu odczytu stanu urządzenia > [!NOTE] > Uwierzytelnianie HTTP jest domyślnie wyłączone na urządzeniach Shelly. Jeśli włączyłeś ochronę logowaniem, TapHome obecnie nie obsługuje HTTP Basic Auth — pozostaw uwierzytelnianie wyłączone dla integracji z TapHome. ## Dostępne urządzenia 4 Te urządzenia pojawią się w TapHome po imporcie. Shelly PM Mini Gen3 Moduł Zmienne niestandardowe Prąd Zmienna Tylko do odczytu numeric Jednostka: A Odczyt ```taphome return(parsejson(status,"current")); ``` Licznik energii Licznik energii Tylko do odczytu Pomiar zużycia energii — moc chwilowa (kW) i energia skumulowana (kWh) z pomiarem prądu i napięcia numeric Jednostka: kW / kWh Atrybuty serwisowe | | |----------------------| | Prąd elektryczny | | Napięcie elektryczne | Odczyt całkowitego zużycia ```taphome return(parsejson(parsejson(status,"aenergy"), "total")/1000); ``` Odczyt zapotrzebowania ```taphome return(parsejson(status,"apower")/1000); ``` Odczyt (moduł) ```taphome var x := (sendhttprequest("/rpc/pm1.GetStatus?id=0")); status := x.Content; ``` Atrybuty serwisowe ${current} \[a] ```taphome return(parsejson(status,"current")); ``` ${electric\_voltage} \[v] ```taphome return(parsejson(status,"voltage")); ``` Częstotliwość Zmienna Tylko do odczytu numeric Jednostka: Hz Odczyt ```taphome return(parsejson(status,"freq")); ``` Napięcie Zmienna Tylko do odczytu numeric Jednostka: V Odczyt ```taphome parsejson(status,"voltage") ``` **Połączenie:** Packet Parser → HTTP • Hostname: `shellypmmig3-{MAC}.local` Możliwe ulepszenia (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 ## Parametry importu Te wartości podajesz podczas importu pliku XML. | Pytanie w aplikacji | Domyślnie | |---------------------|---------------| | Adres IP | `192.168.0.1` | ## Źródła - Shelly Gen2+/Gen3 RPC API Reference [shelly-api-docs.shelly.cloud](https://shelly-api-docs.shelly.cloud/gen2/) 2026-03-27 - Shelly Gen2+ Switch Component API [shelly-api-docs.shelly.cloud](https://shelly-api-docs.shelly.cloud/gen2/ComponentsAndServices/Switch/) 2026-03-27 - Shelly Gen2+ System (Sys) Component API [shelly-api-docs.shelly.cloud](https://shelly-api-docs.shelly.cloud/gen2/ComponentsAndServices/Sys/) 2026-03-27 - Shelly Gen2+ WiFi Component API [shelly-api-docs.shelly.cloud](https://shelly-api-docs.shelly.cloud/gen2/ComponentsAndServices/WiFi/) 2026-03-27 - Home Assistant Shelly Integration [www.home-assistant.io](https://www.home-assistant.io/integrations/shelly/) 2026-03-27 - Shelly PM Mini Gen3 Knowledge Base [kb.shelly.cloud](https://kb.shelly.cloud/knowledge-base/shelly-pm-mini-gen3) 2026-03-29 ## Powiązana dokumentacja - [Integracja Packet Parser](https://taphome.com/pl/compatibility/packet-parser-guide/) - [Packet Parser (HTTP, TCP, UDP, FTP, MQTT)](https://taphome.com/pl/docs/integration/packet-parser/) - [Funkcje Packet parser](https://taphome.com/pl/docs/script/packet-parser/) - [Funkcje parsowania](https://taphome.com/pl/docs/script/parsing-functions/)