Licznik energii Wi-Fi IAMMETER: lokalna integracja i przewodnik po otwartym interfejsie

Licznik energii Wi-Fi IAMMETER: lokalna integracja i przewodnik po otwartym interfejsie

Dla programistów i integratorów systemów korzystających z mierników IAMMETERbezIAMMETER-Cloud.

Liczniki energii Wi-Fi IAMMETER zaprojektowano z myślą o integracji zarówno w chmurze, jak i lokalnej. Oferują one otwarte interfejsy API (HTTP, MQTT, Modbus/TCP), które umożliwiają deweloperom tworzenie własnych systemów zarządzania energią (EMS), systemów zarządzania budynkiem (BMS) lub platform automatyki inteligentnego domu.

Oprogramowanie sprzętowe IAMMETER jest stale aktualizowane. W tym dokumencie wymieniono wszystkie funkcje integracji lokalnej i otwartej obsługiwane przez najnowsze oprogramowanie sprzętowe.(Ciągle aktualizowane)

1) Aktualizacja oprogramowania sprzętowego

Najnowsze wersje oprogramowania sprzętowego można pobrać tutaj:

• Strona wydania oprogramowania sprzętowego (imeter.club): https://imeter.club/topic/11

2) Tryby pracy (bez chmury)

Wybierz tryb w zależności od sposobu integracji lub użytkowania urządzenia.

Interfejs użytkownika starszego oprogramowania układowego

Najnowsze oprogramowanie układoweInterfejs użytkownika WebUI

(Pozostałe części dokumentu pozostają niezmienione od najnowszej wersji.)

3) Integracja TCP/TLS/MQTT

3.1 TCP i TLS

Liczniki mogą przesyłać dane bezpośrednio do punktu końcowego TCP/TLS.

🔹 Nowa konfiguracja oprogramowania sprzętowego

Proces konfiguracji w najnowszym oprogramowaniu układowym jest podobny do tego w poprzednich wersjach.

Tryb pracy: TCP

Adres:

• W przypadku serwera TCP — wprowadź{domena}:{port}(np.,abc.com:12345).
• W przypadku serwera TLS — użyjtls://{domena}:{port}(np.,tls://abc.com:12345).

Interwał przesyłania:Minimalny odstęp czasu między wysyłaniem wynosi2 sekundy.

🔹 Konfiguracja starszego oprogramowania sprzętowego

• Przewodnik:Integracja z serwerami innych firm (TCP/TLS)
• Wideo:Prześlij dane dotyczące energii na serwer zewnętrzny

3.2 MQTT

🔹 Nowa konfiguracja oprogramowania sprzętowego

Tryb pracy: MQTT Adres:Wprowadź adres IP lub domenę z portem, np.192.168.11.163:1883 Nazwa użytkownika / Hasło:Dane uwierzytelniające brokera MQTT (opcjonalne, jeśli nie są wymagane przez brokera)

Interwał przesyłania:Minimalny odstęp wynosi2 sekundy. Odkrywanie HA MQTT: Włącz wykrywanie MQTT w Home Assistant

🔹 Konfiguracja starszego oprogramowania sprzętowego

Publikuj dane telemetryczne na lokalnym lub publicznym brokerze MQTT.

• Przewodnik:Przewodnik po integracji MQTT

4) Integracja HTTP/HTTPS

🔹 Konfiguracja starszego oprogramowania sprzętowego

Liczniki mogą przesyłać dane bezpośrednio na Twój serwer.

• Format danych jest identyczny jak w trybach TCP/MQTT.
• Można użyć dowolnego portu.
• Port443automatycznie włącza HTTPS.
• Detale:Prześlij przez HTTP/HTTPS

🔹 Nowa konfiguracja oprogramowania sprzętowego

Adres:Format wejściowy jest taki sam, jak w starszym oprogramowaniu sprzętowym.

• Jeżeli nie określono portu, domyślnym portem jest80.
• Tylko port443używa protokołu HTTPS POST; wszystkie inne porty używają protokołu HTTP POST.

5) Lokalny API (HTTP przez sieć LAN)

Uzyskaj dostęp do licznika lokalnie za pomocą jego adresu IP w sieci LAN — nie jest wymagane połączenie z chmurą.

5.1 POBIERZ /api/monitorjson

Zwraca dane pomiarowe w czasie rzeczywistym.Pola:Napięcie, prąd, moc czynna, zużycie energii w kWh (kierunek do przodu/do tyłu), częstotliwość, współczynnik mocy.

Przykład:

{
„metoda”: „uploadsn”,
„mac”: „B0F8933C4F94”,
„wersja”: „i.75.97.9”,
„serwer”: „em”,
„numer seryjny”: „3E0BAF87”,
„Dane”: [
[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]
]
}

📘 Rozszerzenie pomiaru mocy biernej

5.2 POBIERZ /api/monitor

Zaawansowana wersjamonitorjson, zawiera informacje o sygnale Wi-Fi:

• SSID(nazwa podłączonego punktu dostępowego)
• sygnatura(siła sygnału)

5.3 POBIERZ /api/wifidata

Zwraca konfigurację sieci i Wi-Fi.

{
„wersja”: „i.75.97.9”, „SN”: „3E0BAF87”, „mac”: „B0F8933C4F94”,
„typ”: „PM”, „ssid”: „CMCC-laohe”, „ip”: „192.168.11.62”,
„maska sieci”: „255.255.255.0”, „gw”: „192.168.11.253”,
„dns”: „114.114.114.114”, „dhcp”: 1, „runMode”: „tcp”, „uploadinterval”: 60
}

5.4 GET /api/uploadinterval?x=<sekundy>

Ustawia interwał przesyłania (w sekundach).

Działa w trybach innych niż chmurowe (TCP/HTTP/MQTT).

WNajnowsze oprogramowanie układowe, ten parametr można teraz skonfigurować bezpośrednio zInterfejs WebUI, bez konieczności ręcznego wywoływania API.

5.5 POBIERZ /api/mqtt

Konfiguruje dane uwierzytelniające MQTT. 📘Dokumentacja API konfiguracji MQTT

WNajnowsze oprogramowanie układowe, ten parametr można teraz skonfigurować bezpośrednio zInterfejs WebUI, bez konieczności ręcznego wywoływania API.

5.6 POBIERZ /api/netmetring

PrzełącznikiRozliczanie energii netto (NEM)tryb. 📘Włącz tryb NEM

WNajnowsze oprogramowanie układowe, ten parametr można teraz skonfigurować bezpośrednio zInterfejs WebUI, bez konieczności ręcznego wywoływania API.

5.7 POBIERZ /api/ctcratio

DostosowujeMnożnik fazy Cdla scenariuszy z rozdzieloną fazą/zrównoważonych.

• x=2podwaja odczyty fazy C (prąd, moc, kWh). 📘Wyjaśnienie współczynnika CTC

WNajnowsze oprogramowanie układowe, ten parametr można teraz skonfigurować bezpośrednio zInterfejs WebUI, bez konieczności ręcznego wywoływania API.

5.8 POBIERZ /api/reactive

Włącza lub wyłączaMoc bierna (Q)orazEnergia bierna (kVARh)pomiar. 📘Dokumentacja mocy biernej

WNajnowsze oprogramowanie układowe, ten parametr można teraz skonfigurować bezpośrednio zInterfejs WebUI, bez konieczności ręcznego wywoływania API.

5.9 POBIERZ /api/ratio (dostępne tylko dla WEM3046T)

PonieważWEM3046Twykorzystuje zewnętrzne tory prądowe zWyjścia wtórne 5A(np. 1000:5, 1500:5, 2000:5 itd.), zmierzone wartości (prąd, moc, energia) należy pomnożyć przez współczynnik CT.

Przykład:

/api/ratio?x=400

• Ustaw stosunek: /api/ratio?x={ct_ratio}
• Współczynnik zapytań: /api/ratio

TylkoWEM3046Tobsługuje zewnętrzne przekładniki prądowe 5A — ten interfejs API nie jest dostępny dla innych modeli.

6) Spójność formatu JSON

Wszystkie tryby komunikacji —HTTP, TCP, MQTT, lokalne API— użyj tej samej struktury JSON. 📘Definicja danych JSON

7) Obsługa Modbus/TCP

Mierniki IAMMETER obsługują natywnieModbus/TCP, umożliwiając bezpośrednią integrację zAsystent domowy, Sterowniki PLC, LubSCADAsystemy.

• Przegląd Modbus/TCP
• Przykład Home Assistant Modbus

8) Obsługiwane scenariusze integracji

9) Zasoby

• Wersje oprogramowania sprzętowego
• Samouczki wideo
• Definicja JSON
• Przegląd Modbus/TCP
• Opracuj własny system

10) Podsumowanie dla programistów

| Możliwości | Dostęp | Uwagi | | --------------------- | ------------------- | ---------------------------------- | | Dane lokalne w czasie rzeczywistym | Lokalny interfejs API |/api/monitorjson, /api/monitor| | Przesyłanie przez osoby trzecie | TCP/TLS, HTTP/HTTPS | Ten sam schemat danych | | Publikacja MQTT | Broker MQTT |/api/mqttAby ustawić dane uwierzytelniające | | Net metering | Lokalny interfejs API |/api/netmetring| | Moc/energia bierna | Lokalny API |/api/reaktywny| | Mnożnik fazy C | Lokalny API |/api/ctcratio?x=1 | | Współczynnik CT (WEM3046T) | Lokalny interfejs API |/api/ratio?x=` | | Modbus/TCP | Klient Modbus | Kompatybilny z HA/PLC/SCADA |

Ostatnia aktualizacja: 15 października 2025 r.