Opracuj własny system monitorowania energii z IAMMETER

Opracuj własny system monitorowania energii z IAMMETER

Liczniki energii Wi-Fi IAMMETER zapewniają otwarte interfejsy danych dla programistów, integratorów systemów i klientów budujących własne oprogramowanie do monitorowania energii.

Możesz odczytywać pomiary bezpośrednio z licznika, pozwolić licznikowi przesyłać dane na własny serwer, wdrożyć samodzielnie hostowaną usługę IAMMETER lub zbudować aplikację na bazie interfejsów API IAMMETER-Cloud.

Ta strona jest przewodnikiem nawigacyjnym dla programistów przy wyborze architektury. Zawiera odnośniki do aktualnych definicji protokołów i dokumentów implementacyjnych, zamiast powielać każdy parametr API.

Jeśli Twoje pierwsze pytanie brzmi, czy licznik IAMMETER może działać bez dostępu do Internetu lub IAMMETER-Cloud, zacznij od Użycie licznika energii Wi-Fi bez Internetu lub chmury. Aby zapoznać się z porównaniem platform, zobacz Integracja samodzielnie hostowana i z otwartym kodem źródłowym.

1. Wybierz architekturę swojego systemu

Istnieją cztery główne sposoby wykorzystania danych IAMMETER we własnej aplikacji.

Architektura	Przepływ danych	Najlepiej dostosowana do	Wymagany IAMMETER-Cloud?
Odczytywanie licznika lokalnie	Aplikacja → Licznik	Pulpity LAN, automatyka, PLC i SCADA	Nie
Przesyłanie danych z licznika	Licznik → Serwer klienta lub broker	Niestandardowa chmura, EMS, BMS i backendy IoT	Nie
Wdrożenie samodzielnie hostowanego oprogramowania IAMMETER	Licznik → IAMMETER-Docker lub IAMMETER-Central → Aplikacja	Użytkownicy chcący mieć przechowywanie i API bez budowania pełnego backendu	Nie
Budowanie na API IAMMETER-Cloud	Licznik → IAMMETER-Cloud → Aplikacja	Aplikacje chcące wykorzystać dane i usługi IAMMETER-Cloud	Tak

Właściwy wybór zależy od tego, gdzie dane powinny być przechowywane, czy projekt wymaga działania niezależnego od Internetu, wymaganego częstotliwości odświeżania oraz ile rozwoju backendu chcesz utrzymywać.

2. Odczytywanie danych bezpośrednio z licznika

Wybierz tę architekturę, gdy aplikacja i licznik znajdują się w tej samej sieci lokalnej.

Licznik IAMMETER ← Lokalne HTTP API lub Modbus TCP ← Twoja aplikacja

Twoja aplikacja kontroluje interwał odpytywania i przechowuje dowolną historię, której potrzebuje. Żadna usługa chmurowa IAMMETER nie jest wymagana dla lokalnej ścieżki danych.

2.1 Lokalne HTTP API

Licznik udostępnia lokalne punkty końcowe HTTP do odczytu pomiarów, takich jak napięcie, prąd, moc czynna, energia pobrana i energia oddana.

Typowe punkty końcowe pomiarów obejmują:

• /api/monitorjson
• /api/monitor

Dostęp przez lokalne HTTP API jest praktycznym punktem startowym dla:

• niestandardowych pulpitów nawigacyjnych;
• skryptów uruchamianych na PC, NAS lub Raspberry Pi;
• integracji niskokodowych;
• aplikacji lokalnych, które nie wymagają odpytywania co sekundę.

Zobacz Przewodnik po lokalnym API IAMMETER i otwartych interfejsach po aktualne definicje punktów końcowych i przykłady.

2.2 Modbus TCP

Użyj Modbus TCP, gdy projekt wymaga:

• lokalnego odpytywania co sekundę;
• integracji z PLC lub SCADA;
• sterowania mocą w czasie rzeczywistym;
• integracji z przemysłowym EMS lub BMS;
• standardowego protokołu opartego na rejestrach.

Zobacz Przewodnik po rejestrach Modbus TCP IAMMETER i integracji.

2.3 Co musi zapewnić Twoja aplikacja

Bezpośredni odczyt lokalny zwraca pomiary z licznika. Twoja aplikacja pozostaje odpowiedzialna za wszelkie dodatkowe funkcje, których wymaga, w tym:

• przechowywanie danych;
• agregację godzinową, dzienną i miesięczną;
• pulpity nawigacyjne i raporty;
• użytkowników i uprawnienia;
• alarmy i logikę automatyzacji;
• kopie zapasowe i przechowywanie.

Jeśli nie chcesz budować tych funkcji backendu od podstaw, rozważ IAMMETER-Docker lub IAMMETER-Central.

3. Przesyłanie danych licznika bezpośrednio na własny serwer

Wybierz tę architekturę, gdy licznik ma inicjować połączenie i wysyłać dane do punktu końcowego zarządzanego przez Ciebie.

Licznik IAMMETER → MQTT/MQTTS, HTTP/HTTPS lub TCP/TLS → Twój serwer

Obecne oprogramowanie sprzętowe IAMMETER obsługuje kilka interfejsów przesyłania:

Interfejs	Składnik po stronie klienta	Typowe zastosowanie
MQTT / MQTTS	Broker MQTT i subskrybent	Platformy IoT, automatyzacja i potoki komunikatów
HTTP / HTTPS	Punkt końcowy HTTP	Backend REST, usługa chmurowa lub niestandardowy EMS
TCP / TLS	Serwer TCP	Niestandardowy kolektor i integracja na poziomie protokołu

Licznik i Twój serwer używają spójnej struktury JSON pomiarów IAMMETER we wszystkich obsługiwanych metodach przesyłania. Zapoznaj się z definicją danych przed implementacją własnego parsera.

Zasoby implementacyjne:

• Publikowanie danych IAMMETER na własnym brokerze MQTT
• Przesyłanie danych IAMMETER na serwer zewnętrzny
• Definicja JSON pomiarów IAMMETER
• Obecne oprogramowanie sprzętowe, lokalne API i otwarte interfejsy
• Najnowsze oprogramowanie sprzętowe IAMMETER i informacje o aktualizacji

Serwer w tej samej sieci LAN może działać bez dostępu do Internetu. Zdalny punkt końcowy nadal wymaga działającej trasy przez Internet, prywatną sieć WAN lub VPN.

4. Korzystanie z samodzielnie hostowanego oprogramowania IAMMETER

IAMMETER oferuje dwie opcje samodzielnego hostowania dla użytkowników, którzy chcą prywatnego wdrożenia danych bez implementowania każdego komponentu backendu samodzielnie.

4.1 IAMMETER-Docker

IAMMETER-Docker to system monitorowania energii o otwartym kodzie źródłowym, hostowany samodzielnie. Zapewnia lokalne zbieranie danych, podstawowe funkcje monitorowania, wykresy i API.

Jest ogólnie odpowiedni dla:

• osób prywatnych i programistów;
• wdrożeń na Raspberry Pi, mini PC i NAS;
• domowego monitorowania energii lub energii słonecznej w sieci prywatnej;
• projektów potrzebujących działającego interfejsu oraz API;
• użytkowników, którzy chcą opracować niestandardowy interfejs użytkownika na bazie gotowego backendu.

Kontynuuj z:

• Wdrożenie IAMMETER-Docker
• Zaawansowane funkcje IAMMETER-Docker
• Tryb offline rejestratora danych

4.2 IAMMETER-Central

IAMMETER-Central to samodzielnie hostowane oprogramowanie pośredniczące dla danych dla użytkowników korporacyjnych, instalatorów i integratorów systemów.

Koncentruje się na:

• rejestracji i zarządzaniu urządzeniami IAMMETER;
• przechowywaniu pomiarów liczników w bazie danych kontrolowanej przez klienta;
• udostępnianiu standardowych API dla aplikacji klienta;
• oddzielaniu pozyskiwania danych z urządzeń od systemu ERP, EMS, BMS lub frontendu klienta.

IAMMETER-Central nie próbuje zapewnić pełnej logiki biznesowej aplikacji do zarządzania energią. Jest przydatny, gdy klient chce mieć utrzymywaną warstwę pośredniczącą danych i zbuduje własny interfejs użytkownika lub funkcje biznesowe.

Zobacz Opcje samodzielnego hostowania IAMMETER po porównanie IAMMETER-Docker, IAMMETER-Central, platform z otwartym kodem źródłowym i bezpośredniej integracji serwerowej.

5. Budowanie na API IAMMETER-Cloud

Korzystanie z IAMMETER-Cloud to kolejny sposób na opracowanie niestandardowego pulpitu nawigacyjnego lub aplikacji. W tej architekturze licznik przesyła dane do IAMMETER-Cloud, a Twoja aplikacja pobiera dane udostępnione przez API IAMMETER-Cloud.

Licznik IAMMETER → IAMMETER-Cloud → API chmury → Twoja aplikacja

Ta opcja może zmniejszyć nakład prac programistycznych po stronie urządzenia i pozyskiwania danych, ale nie jest architekturą offline ani niezależną od chmury.

Jest odpowiednia, gdy:

• licznik już raportuje do IAMMETER-Cloud;
• Twoja aplikacja chce wykorzystać dane hostowane w chmurze;
• dostęp do Internetu jest dostępny;
• utrzymywanie całego potoku danych wewnątrz sieci lokalnej nie jest wymagane.

Zobacz Dokumentacja API IAMMETER-Cloud po obsługiwane operacje API i wymagania uwierzytelniania.

6. Integracja z istniejącą platformą o otwartym kodzie źródłowym

Zanim zbudujesz kompletny system monitorowania, sprawdź, czy istniejąca platforma już zapewnia funkcje przechowywania, pulpitu nawigacyjnego i automatyzacji, których potrzebujesz.

IAMMETER można zintegrować z:

• Home Assistant
• Node-RED
• OpenHAB
• ioBroker
• Zabbix
• ThingsBoard

Te strony specyficzne dla platform są przewodnikami implementacyjnymi. Po szersze porównanie skorzystaj z Przeglądu integracji samodzielnie hostowanej i z otwartym kodem źródłowym.

7. Wybierz najlepszy punkt startowy

Wymaganie projektu	Rekomendowany punkt startowy
Prosty skrypt lub pulpit LAN	Lokalne HTTP API
Lokalne dane co sekundę lub sterowanie przemysłowe	Modbus TCP
Istniejąca infrastruktura MQTT	Przesyłanie MQTT lub MQTTS
Istniejący backend webowy	Przesyłanie HTTP lub HTTPS
Niestandardowy kolektor socketowy	Przesyłanie TCP lub TLS
Gotowe do użycia prywatne monitorowanie dla indywidualnego użytkownika	IAMMETER-Docker
Oprogramowanie pośredniczące dla ERP, EMS lub BMS	IAMMETER-Central
Pulpit inteligentnego domu i automatyzacja	Home Assistant
Aplikacja zbudowana na istniejących danych IAMMETER-Cloud	API IAMMETER-Cloud

8. Lista kontrolna rozwoju

Przed implementacją potwierdź:

1. które pomiary i fazy zapewnia wybrany licznik;
2. czy dane będą odpytywane czy wypychane;
3. wymagany interwał aktualizacji;
4. czy system musi działać podczas przerwy w dostępie do Internetu;
5. gdzie będą przechowywane dane historyczne;
6. czy wymagany jest transport chroniony protokołem TLS;
7. w jaki sposób aplikacja będzie uwierzytelniać użytkowników i urządzenia;
8. czy IAMMETER-Cloud powinien pozostać częścią architektury;
9. wersja oprogramowania sprzętowego używana do walidacji;
10. w jaki sposób konfiguracja, logi i dane będą archiwizowane.

9. Powiązana dokumentacja

• Użycie IAMMETER bez Internetu lub IAMMETER-Cloud
• Lokalne API IAMMETER i otwarte interfejsy
• Przegląd integracji samodzielnie hostowanej i z otwartym kodem źródłowym
• Przesyłanie danych na serwer zewnętrzny
• Integracja licznika energii MQTT
• Integracja licznika energii Modbus TCP
• Opcje samodzielnego hostowania IAMMETER

Ostatnia aktualizacja: 16 lipca 2026 r.