TapHome

Shelly PM Mini Gen3

Packet Parser → HTTP
Dodane przez
Ostatnia aktualizacja: 03. 2026
Shelly PM Mini Gen3

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).

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.

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).

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

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 (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

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<model>-<mac>.local (np. shelly1pm-AABBCCDDEE.local) z tej samej sieci

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

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

Shelly PM Mini Gen3 Moduł
Zmienne niestandardowe
Prąd Zmienna Tylko do odczytu
numeric Jednostka: A

Prąd

Odczyt
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

Licznik energii

Odczyt całkowitego zużycia
return(parsejson(parsejson(status,"aenergy"), "total")/1000);
Odczyt zapotrzebowania
return(parsejson(status,"apower")/1000);
Odczyt (moduł)
var x := (sendhttprequest("/rpc/pm1.GetStatus?id=0"));
status := x.Content;
Atrybuty serwisowe
${current} [a]
return(parsejson(status,"current"));
${electric_voltage} [v]
return(parsejson(status,"voltage"));
Częstotliwość Zmienna Tylko do odczytu
numeric Jednostka: Hz

Częstotliwość

Odczyt
return(parsejson(status,"freq"));
Napięcie Zmienna Tylko do odczytu
numeric Jednostka: V

Napięcie

Odczyt
parsejson(status,"voltage")
Połączenie: Packet Parser → HTTP
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

Źródła