IAMMETER Wi-Fi Licznik Energii: Lokalne API i Otwarte Interfejsy

IAMMETER Wi-Fi Licznik Energii: Lokalne API i Otwarte Interfejsy

IAMMETER Wi-Fi liczniki energii obsługują IAMMETER-Cloud, a także lokalne integracje z systemami zewnętrznymi.

Dostępne interfejsy obejmują:

• Lokalne HTTP API w sieci LAN
• Publikacja MQTT i MQTTS
• Modbus TCP
• Upload TCP/TLS
• Upload HTTP/HTTPS
• Samodzielna praca lokalna

Te interfejsy pozwalają licznikom IAMMETER działać jako otwarte źródła danych dla:

• Home Assistant i innych platform inteligentnego domu
• Automatyzacji Node-RED
• Samodzielnie hostowanych pulpitów nawigacyjnych
• Systemów PLC i SCADA
• Niestandardowych Systemów Zarządzania Energią (EMS)
• Niestandardowych Systemów Zarządzania Budynkiem (BMS)
• Zewnętrznych serwerów danych

Ten przewodnik opisuje najpierw bieżące oprogramowanie sprzętowe (firmware) i WebUI. Zrzuty ekranu i metody konfiguracji dla starszego oprogramowania są zachowane w końcowej sekcji Legacy.

Aby skorzystać z gotowej aplikacji opartej na tych możliwościach, zobacz Monitorowanie Energii Domowej, Monitorowanie Energii Słonecznej lub lokalne monitorowanie bez dostępu do Internetu.

1) Aktualizacja do Najnowszego Firmware

Oprogramowanie IAMMETER jest aktualizowane w sposób ciągły. Przed skonfigurowaniem integracji sprawdź aktualną wersję i kompatybilność modelu:

• Strona Wydań Firmware IAMMETER

Najnowsze oprogramowanie WebUI udostępnia bezpośrednio najczęściej używane opcje konfiguracyjne. Ręczne wywołania API konfiguracji, zachowane w dalszej części artykułu, są przydatne głównie przy utrzymywaniu starszych instalacji.

2) Wybór Trybu Pracy w Bieżącym WebUI

Wybierz tryb pracy w zależności od tego, dokąd licznik ma wysyłać dane lub jak ma działać lokalnie.

Tryb pracy kontroluje zachowanie przesyłania danych. Dostępność lokalnego API i Modbus TCP należy nadal sprawdzać dla modelu licznika, oprogramowania i wybranej integracji.

3) Dlaczego Otwarte Interfejsy Mają Znaczenie

Otwarte interfejsy pozwalają użytkownikom decydować, gdzie dane o energii elektrycznej są przetwarzane i przechowywane.

Typowe powody obejmują:

• Przechowywanie pomiarów w sieci lokalnej
• Wysyłanie telemetrii do istniejącego serwera
• Łączenie danych o energii z Home Assistant lub Node-RED
• Tworzenie niestandardowych pulpitów nawigacyjnych i alarmów
• Łączenie danych o energii elektrycznej z taryfami, logiką sterowania energią słoneczną lub obciążeniem
• Praca w miejscu z ograniczonym lub niestabilnym dostępem do Internetu

Dostęp przez chmurę i dostęp lokalny nie wykluczają się wzajemnie. Odpowiednia architektura zależy od tego, czy projekt potrzebuje raportów IAMMETER-Cloud, platformy lokalnej, serwera zewnętrznego czy kombinacji tych rozwiązań.

4) Wysyłanie Danych do Zewnętrznego Serwera

4.1 TCP i TLS

IAMMETER może wysyłać dane z licznika do punktu końcowego TCP lub TLS.

W bieżącym WebUI:

1. Wybierz tryb pracy TCP.
2. Wprowadź adres docelowy.
3. Skonfiguruj interwał przesyłania.
4. Zapisz ustawienia i zweryfikuj dane na serwerze odbierającym.

Dla serwera TCP użyj:

{domena-lub-ip}:{port}

Przykład:

abc.com:12345

Dla serwera TLS użyj:

tls://{domena-lub-ip}:{port}

Przykład:

tls://abc.com:12345

Bieżący przegląd oprogramowania dokumentuje minimalny interwał przesyłania wynoszący 2 sekundy. Potwierdź bieżące oprogramowanie i wydajność serwera odbierającego przed wybraniem krótkiego interwału.

4.2 MQTT i MQTTS

IAMMETER może publikować telemetrię bezpośrednio do zwykłego brokera MQTT lub używać MQTTS do szyfrowanego transportu w obsługiwanym oprogramowaniu.

W bieżącym WebUI:

1. Wybierz tryb pracy MQTT.
2. Wprowadź adres IP brokera lub domenę i port, używając odpowiedniego formatu MQTT lub MQTTS.
3. Wprowadź nazwę użytkownika i hasło brokera, gdy wymagane jest uwierzytelnienie.
4. Skonfiguruj interwał przesyłania.
5. Zapisz i zweryfikuj, czy wiadomości docierają do brokera.

Dla zwykłego MQTT, wprowadź adres brokera i port bez prefiksu mqtt://:

192.168.11.163:1883

Dla MQTTS, dołącz prefiks mqtts://:

mqtts://{adres-brokera-mqtt}:{port}

Przykład:

mqtts://broker.example.com:8883

Wsparcie MQTTS udokumentowane w aktualizacji oprogramowania z listopada 2025 ma następujące obecne ograniczenia:

• Obsługuje TLS 1.2 i niższe.
• Przesyłanie niestandardowego certyfikatu CA nie jest obsługiwane.
• Weryfikacja nazwy hosta nie jest obsługiwana.
• Certyfikaty klienckie do wzajemnego uwierzytelniania TLS nie są obsługiwane.

Te ograniczenia są ważne przy wyborze brokera i ocenie wymagań bezpieczeństwa wdrożenia.

Bieżący przegląd oprogramowania dokumentuje minimalny interwał przesyłania wynoszący 2 sekundy.

Home Assistant MQTT Discovery to dodatkowa funkcja wykrywania Home Assistant; nie jest wymagana dla każdej integracji MQTT. Zobacz:

• Przewodnik integracji MQTT IAMMETER
• MQTT Discovery w Home Assistant

Zmiana uploadInterval Zdalnie przez MQTT/MQTTS

W oprogramowaniu opisanym w aktualizacji z listopada 2025, licznik pracujący w trybie MQTT automatycznie subskrybuje:

device/{sn}/config

Opublikuj następujący JSON z innego klienta MQTT, aby zdalnie zmienić interwał przesyłania:

{"uploadInterval": 10}

Zastąp 10 wymaganym interwałem w sekundach, a {sn} numerem seryjnym licznika w temacie.

Ta zdalna konfiguracja MQTT różni się od starszej lokalnej metody /api/uploadinterval zachowanej w sekcji Legacy.

4.3 HTTP i HTTPS

IAMMETER może wysyłać dane do niestandardowego serwera HTTP/HTTPS.

W bieżącym WebUI:

1. Wybierz tryb pracy HTTP.
2. Wprowadź adres serwera i port.
3. Skonfiguruj interwał przesyłania.
4. Zapisz i zweryfikuj żądania na serwerze.

Bieżące oprogramowanie obsługuje zarówno domyślny port HTTPS, jak i niestandardowy port HTTPS.

Użyj jednego z tych formatów:

• Zwykły HTTP bez jawnego portu: {adres} — domyślnie port 80.
• Zwykły HTTP z niestandardowym portem: {adres}:{port}.
• HTTPS bez jawnego portu: https://{adres} — domyślnie port 443.
• HTTPS z niestandardowym portem: https://{adres}:{port} — używa określonego portu.

Prefiks https:// wybiera HTTPS. Port 443 nie jest już jedynym dostępnym portem dla HTTPS.

Przykłady:

api.example.com
api.example.com:8080
https://api.example.com
https://api.example.com:8443

Zobacz Nowe oprogramowanie dodaje MQTTS, zdalną konfigurację i niestandardowy port HTTPS po notatkę o wydaniu oprogramowania.

W przypadku obsługi ładunku po stronie serwera zobacz także Integracja IAMMETER z serwerem zewnętrznym.

5) Lokalny Odczyt Danych przez HTTP

Podłącz licznik do sieci LAN i żądaj danych z jego lokalnego adresu IP. Te żądania nie wymagają IAMMETER-Cloud.

Testuj API interaktywnie: Otwórz Eksplorator lokalnego API IAMMETER, wprowadź lokalny adres IP licznika i wybierz stronę testową WEM API. Eksplorator w stylu Swagger wyświetla dostępne lokalne API i umożliwia wysyłanie testowych żądań bezpośrednio z przeglądarki. Twoja przeglądarka i licznik IAMMETER muszą być w tej samej sieci LAN.

5.1 GET /api/monitorjson

Zwraca bieżące pomiary elektryczne w czasie rzeczywistym.

Standardowe dane obejmują wartości takie jak:

• Napięcie (Voltage)
• Prąd (Current)
• Moc czynna (Active power)
• kWh pobrana/importowana (Forward/import kWh)
• kWh oddana/eksportowana (Reverse/export kWh)
• Częstotliwość (Frequency)
• Współczynnik mocy (Power factor)

Przykładowa odpowiedź:

{
  "method": "uploadsn",
  "mac": "B0F8933C4F94",
  "version": "i.75.97.9",
  "server": "em",
  "SN": "3E0BAF87",
  "Datas": [
    [220.0, 9.99, 2198, 11.337, 11.201, 49.99, 1.00],
    [222.5, 9.99, 1100, 11.039, 10.908, 49.99, 0.50],
    [263.5, 9.99, 1213, 10.975, 10.846, 49.99, 0.55]
  ]
}

Liczba tablic pomiarowych zależy od modelu licznika i liczby kanałów.

Jeśli pomiar mocy biernej jest włączony w obsługiwanym modelu/oprogramowaniu, format odpowiedzi może zawierać dodatkowe pola. Zobacz Format danych pomiaru mocy biernej.

5.2 GET /api/monitor

Zwraca rozszerzoną odpowiedź w czasie rzeczywistym, która zawiera również informacje o Wi-Fi, takie jak:

• ssid — nazwa punktu dostępowego, z którym połączono
• sig — siła sygnału Wi-Fi

Użyj tego punktu końcowego, gdy integracja wymaga zarówno pomiarów elektrycznych, jak i podstawowego statusu Wi-Fi.

5.3 GET /api/wifidata

Zwraca informacje o oprogramowaniu sprzętowym, urządzeniu i konfiguracji sieci.

Przykład:

{
  "version": "i.75.97.9",
  "SN": "3E0BAF87",
  "mac": "B0F8933C4F94",
  "type": "PM",
  "ssid": "example-wifi",
  "ip": "192.168.11.62",
  "netmask": "255.255.255.0",
  "gw": "192.168.11.1",
  "dns": "192.168.11.1",
  "dhcp": 1,
  "runMode": "tcp",
  "uploadinterval": 60
}

Nie publikuj odpowiedzi zawierających numery seryjne urządzeń, adresy MAC, wewnętrzne adresowanie lub informacje o Wi-Fi, chyba że wartości zostały zanonimizowane.

6) Format JSON we Wszystkich Trybach Przesyłania

IAMMETER używa spójnej podstawowej struktury JSON pomiarów we wszystkich trybach HTTP, TCP, MQTT i lokalnym API. Zmniejsza to nakład pracy wymagany, gdy jeden system odbierający obsługuje wiele metod transportu.

Metoda transportu i koperta mogą nadal wpływać na sposób, w jaki odbiornik łączy się, uwierzytelnia lub ramkuje wiadomość. Zaimplementuj system odbierający zgodnie z udokumentowanym formatem dla wybranego trybu.

• Definicja danych JSON licznika energii IAMMETER

7) Modbus TCP

Liczniki IAMMETER obsługują Modbus TCP do bezpośredniej integracji w sieci LAN z kompatybilnymi klientami.

Typowi klienci obejmują:

• Home Assistant
• PLC
• Systemy SCADA
• Bramy przemysłowe
• Niestandardowe aplikacje Modbus

Referencje:

• Przegląd Modbus TCP IAMMETER
• Przegląd integracji z Home Assistant

Potwierdź model licznika, oprogramowanie sprzętowe, definicję rejestrów, interwał odpytywania i zachowanie klienta przed wdrożeniem.

8) Scenariusze Integracji

9) Podsumowanie Bieżącego Interfejsu i Zasoby

Dodatkowe zasoby:

• Najnowsze oprogramowanie
• Notatka o oprogramowaniu MQTTS i niestandardowym porcie HTTPS
• Samouczki wideo
• Definicja danych JSON
• Przegląd Modbus TCP
• Opracuj własny system
• Monitorowanie bez dostępu do Internetu

Lokalne API i otwarte protokoły IAMMETER umożliwiają rozpoczęcie od monitorowania w czasie rzeczywistym, a późniejsze dodanie niestandardowego EMS, samodzielnie hostowanego pulpitu nawigacyjnego lub przepływu automatyzacji.

10) Strony i Metody Konfiguracji Starszego Firmware (Legacy)

Poniższy materiał jest zachowany tylko dla liczników, które wciąż działają na starszym oprogramowaniu, lub dla użytkowników utrzymujących istniejącą integrację. W przypadku nowej instalacji zaktualizuj do najnowszego oprogramowania i użyj bieżącego WebUI, gdy wymagana opcja jest dostępna.

10.1 Strona Trybu Pracy Legacy

Starsze oprogramowanie używało następującej strony wyboru trybu pracy:

Układ i nazwy opcji mogą nie odpowiadać bieżącemu WebUI pokazanemu wcześniej w tym przewodniku.

10.2 Strona TCP/TLS Legacy

Starsze integracje oprogramowania mogą odwoływać się do tej strony konfiguracji TCP/TLS i powiązanego przewodnika:

• Starszy przewodnik integracji z serwerem zewnętrznym
• Starsze wideo przesyłania na serwer

10.3 Strona MQTT Legacy

Starsza dokumentacja MQTT używała tego interfejsu konfiguracyjnego:

W przypadku bieżącego przepływu pracy użyj instrukcji WebUI z wcześniejszej części artykułu oraz zaktualizowanego Przewodnika integracji MQTT.

10.4 Strona HTTP/HTTPS Legacy

Starsze oprogramowanie używało następującej strony docelowej HTTP/HTTPS:

Starszy przewodnik integracji jest zachowany w Przesyłanie przez HTTP/HTTPS.

W tym starszym przepływie pracy HTTPS był powiązany z domyślnym portem 443 i nie wymagał prefiksu https://. Bieżące oprogramowanie używa natomiast prefiksu https:// do wyboru HTTPS i obsługuje zarówno domyślny port 443, jak jawnie określony niestandardowy port.

10.5 Starsze API Konfiguracji (Legacy Configuration APIs)

Następujące lokalne wywołania API pojawiły się we wcześniejszych przepływach pracy konfiguracji. W bieżącym oprogramowaniu odpowiednie ustawienia powinny być normalnie konfigurowane przez WebUI, gdy opcja jest dostępna.

/api/uploadinterval?x=<sekundy>

Starsza metoda ustawiania interwału przesyłania poza chmurą.

/api/mqtt

Starsza metoda konfiguracji poświadczeń MQTT.

/api/netmetring

Starsza metoda włączania lub wyłączania trybu Net Energy Metering.

• Referencja Net Energy Metering

/api/ctcratio

Starsza metoda stosowania udokumentowanego mnożnika Phase-C w określonych scenariuszach split-phase lub zbalansowanych.

• Referencja CTC Ratio

/api/reactive

Starsza metoda włączania lub wyłączania pomiaru mocy biernej i energii biernej w obsługiwanym oprogramowaniu/modelach.

• Referencja mocy biernej

/api/ratio — tylko WEM3046T

WEM3046T używa zewnętrznych przekładników prądowych (CT) z wyjściami wtórnymi 5 A. Starsze instrukcje konfiguracji ustawiały przekładnię CT za pomocą:

/api/ratio?x={przekładnia_ct}

Przykład:

/api/ratio?x=400

Ten punkt końcowy jest specyficzny dla WEM3046T i jest nieprawidłowy dla innych modeli IAMMETER. W przypadku bieżącego oprogramowania użyj konfiguracji WebUI modelu, gdy jest dostępna.

Materiał Legacy zachowany do celów referencyjnych wstecz; bieżące instalacje powinny korzystać z najnowszego WebUI oprogramowania.