Integracja licznika energii z Home Assistant: MQTT, Modbus TCP i IAMMETER-Link

Integracja licznika energii z Home Assistant: MQTT, Modbus TCP i IAMMETER-Link

Liczniki energii IAMMETER można zintegrować z Home Assistant za pomocą lokalnego HTTP, Modbus TCP lub MQTT. Najlepsza metoda zależy od tego, czy preferujesz oficjalną integrację, konfigurację przez interfejs, szybkie aktualizacje lokalne, automatyczne wykrywanie MQTT czy kontynuację korzystania z IAMMETER Cloud.

Ten przewodnik porównuje dostępne metody i kieruje do odpowiedniego poradnika konfiguracji. Obejmuje wszystkie obecne liczniki energii IAMMETER. Wycofany model WEM3162 nie jest uwzględniony.

Której integracji Home Assistant powinienem użyć?

Metoda	Konfiguracja po stronie licznika	Konfiguracja Home Assistant	Typowy interwał aktualizacji	W pełni lokalny	Równoczesne IAMMETER Cloud	Automatyczne wykrywanie	Dla kogo najlepsza
Home Assistant Core	Utrzymuj licznik dostępny w sieci LAN	Dodaj wbudowaną integrację IAMMETER w YAML	30 sekund	Tak	Tak	Nie	Użytkownicy preferujący oficjalną wbudowaną integrację
Home Assistant Modbus	Udostępnij Modbus TCP w sieci LAN	Skonfiguruj wbudowaną integrację Modbus i czujniki w YAML	Konfigurowalny; zwykle 1–5 sekund	Tak	Tak	Nie	Szybkie monitorowanie i automatyzacje w czasie rzeczywistym
MQTT Manual	Skonfiguruj broker MQTT w interfejsie WebUI licznika	Włącz integrację MQTT i zdefiniuj czujniki w YAML	Konfigurowalny; najnowsze oprogramowanie obsługuje do 2 sekund	Tak, z lokalnym brokerem	Nie	Nie	Użytkownicy potrzebujący niestandardowych tematów i czujników
HACS HTTP	Utrzymuj licznik dostępny w sieci LAN	Zainstaluj IAMMETER HTTP przez HACS i skonfiguruj w interfejsie	60 sekund	Tak	Tak	Wspomagane SSDP	Konfiguracja przez interfejs bez YAML
HACS Modbus	Udostępnij Modbus TCP w sieci LAN	Zainstaluj IAMMETER Modbus przez HACS i skonfiguruj w interfejsie	Konfigurowalny; domyślnie 3 sekundy	Tak	Tak	Wspomagane SSDP	Szybkie lokalne aktualizacje z konfiguracją przez interfejs
MQTT Discovery	Skonfiguruj broker i włącz HA MQTT Discovery w interfejsie WebUI licznika	Włącz integrację MQTT; czujniki są tworzone automatycznie	Konfigurowalny; najnowsze oprogramowanie obsługuje do 2 sekund	Tak, z lokalnym brokerem	Nie	Tak	Najprostsza konfiguracja MQTT

Szybkie rekomendacje:

• Wybierz Home Assistant Core, jeśli chcesz oficjalną wbudowaną integrację, a interwał 30-sekundowy jest wystarczający.
• Wybierz HACS HTTP, jeśli preferujesz konfigurację przez interfejs i nie potrzebujesz szybkich aktualizacji.
• Wybierz HACS Modbus, jeśli chcesz konfigurację przez interfejs z szybszymi danymi lokalnymi dla pulpitów i automatyzacji.
• Wybierz Home Assistant Modbus, jeśli czujesz się komfortowo z YAML i chcesz pełnej kontroli nad rejestrami, czujnikami i interwałami odpytywania.
• Wybierz MQTT Discovery, jeśli już używasz MQTT i chcesz, aby Home Assistant automatycznie tworzył urządzenie i encje.
• Wybierz MQTT Manual, jeśli potrzebujesz pełnej kontroli nad tematami MQTT, szablonami i definicjami encji.

MQTT Manual i MQTT Discovery zmieniają tryb przesyłania licznika na MQTT. W tych trybach licznik nie przesyła jednocześnie pomiarów do IAMMETER Cloud. Lokalne integracje HTTP i Modbus TCP mogą nadal działać, podczas gdy licznik przesyła dane do IAMMETER Cloud.

1. Oficjalna integracja Home Assistant Core

Oficjalna integracja IAMMETER jest dołączona do Home Assistant i odczytuje lokalne API HTTP licznika. Nie wymaga HACS ani połączenia internetowego między Home Assistant a licznikiem.

Główne cechy:

• konfigurowana w configuration.yaml;
• lokalne odpytywanie HTTP co 30 sekund;
• może być używana razem z IAMMETER Cloud;
• encje energii importowanej i eksportowanej zawierają metadane wymagane przez Home Assistant Energy Dashboard;
• brak automatycznego wykrywania urządzeń.

Użyj tej metody, gdy stabilność i oficjalne wsparcie Home Assistant są ważniejsze niż szybkie odświeżanie.

• Oficjalna integracja IAMMETER w Home Assistant

2. Integracja Home Assistant Modbus TCP

Wbudowana integracja Modbus Home Assistant odczytuje lokalne rejestry Modbus TCP licznika. Jest odpowiednia do automatyzacji opartych na mocy, sterowania nadwyżkami energii słonecznej i innych zastosowań wymagających szybszych aktualizacji.

Główne cechy:

• konfigurowana w YAML;
• konfigurowalny scan_interval, zwykle 1–5 sekund dla automatyzacji w czasie rzeczywistym;
• w pełni lokalna i niezależna od internetu;
• może być używana razem z IAMMETER Cloud;
• wymaga poprawnego adresu rejestru, typu danych, skali i metadanych Energy Dashboard.

Użyj dłuższego interwału odpytywania, gdy dane sekundowe nie są wymagane. Unikaj uruchamiania wielu klientów Modbus o wysokiej częstotliwości wobec tego samego licznika.

• Poradnik licznika energii Home Assistant Modbus TCP
• Mapa rejestrów Modbus TCP IAMMETER

3. Integracja HACS HTTP

Niestandardowa integracja IAMMETER HTTP zapewnia alternatywę opartą na interfejsie użytkownika dla oficjalnej integracji YAML. Odczytuje /monitorjson przez sieć lokalną i tworzy odpowiadające encje Home Assistant.

Główne cechy:

• instalowana przez HACS;
• konfigurowana przez interfejs Devices & Services Home Assistant;
• lokalne odpytywanie HTTP co 60 sekund;
• SSDP może wspomagać wykrywanie urządzeń;
• kompatybilna z IAMMETER Cloud i Energy Dashboard.

Użyj tej metody, gdy preferujesz konfigurację przez interfejs, a interwał odświeżania co minutę jest wystarczający.

• Integracja HACS HTTP IAMMETER
• Poradnik konfiguracji HACS HTTP

4. Integracja HACS Modbus

Niestandardowa integracja IAMMETER Modbus łączy lokalne odpytywanie Modbus TCP z konfiguracją przez interfejs Home Assistant. Jest to najwygodniejsza opcja dla użytkowników, którzy potrzebują szybszych aktualizacji, ale nie chcą definiować każdego rejestru w YAML.

Główne cechy:

• instalowana przez HACS i konfigurowana w interfejsie;

• konfigurowalny interwał skanowania, domyślnie 3 sekundy w zaktualizowanej integracji;

• lokalne działanie i kompatybilność z IAMMETER Cloud;

• tworzy encje mocy oraz energii importowanej/eksportowanej z odpowiednimi metadanymi Home Assistant;

• obsługuje wszystkie obecne liczniki IAMMETER, z różną liczbą encji dla modeli jednofazowych i trójfazowych.

• Integracja HACS Modbus IAMMETER

• Poradnik konfiguracji HACS Modbus

5. Ręczna integracja MQTT

W trybie ręcznym MQTT licznik publikuje dane pomiarowe do twojego brokera MQTT, a ty definiujesz odpowiadające czujniki w Home Assistant.

Konfiguracja po stronie licznika i konfiguracja Home Assistant są oddzielne:

1. Skonfiguruj adres brokera, port, nazwę użytkownika i hasło w najnowszym interfejsie WebUI licznika.
2. Włącz integrację MQTT w Home Assistant.
3. Zdefiniuj wymagane czujniki MQTT i szablony JSON w YAML.

Ta metoda jest przydatna, gdy kilka aplikacji musi subskrybować te same pomiary lub gdy potrzebujesz niestandardowych tematów i definicji encji.

• Konfiguracja licznika energii IAMMETER z serwerem MQTT
• Ręczna konfiguracja licznika energii MQTT dla Home Assistant

6. Home Assistant MQTT Discovery

MQTT Discovery jest przeznaczony dla użytkowników, którzy chcą jak najmniej ręcznej konfiguracji. Po skonfigurowaniu brokera i włączeniu HA MQTT Discovery w interfejsie WebUI licznika, Home Assistant automatycznie tworzy urządzenie IAMMETER i jego encje.

Wygenerowane encje energii importowanej i eksportowanej zawierają:

• unit_of_measurement: kWh;
• device_class: energy;
• state_class: total_increasing.

Te atrybuty dostarczają metadanych wymaganych do użycia w Home Assistant Energy Dashboard.

MQTT Discovery jest obsługiwany przez wszystkie obecne liczniki energii IAMMETER. Modele jednofazowe i trójfazowe tworzą różną liczbę encji zgodnie z ich kanałami pomiarowymi.

• Konfiguracja MQTT Discovery Home Assistant
• Poradnik MQTT Discovery IAMMETER
• Aktualizacja do najnowszego oprogramowania IAMMETER

Obsługiwane liczniki energii IAMMETER

Wszystkie obecne liczniki energii IAMMETER obsługują opisane powyżej metody integracji. Główną różnicą w Home Assistant jest liczba faz lub kanałów pomiarowych, a tym samym liczba tworzonych encji.

Model	Typowe zastosowanie	Wsparcie Home Assistant	Uwaga
WEM3080	Monitorowanie energii jednofazowej	Wszystkie metody	Encje jednofazowe
WEM2067	Monitorowanie domowej energii słonecznej jednofazowej	Wszystkie metody	Dwa kanały pomiarowe
WEM3080T	Monitorowanie energii trójfazowej	Wszystkie metody	Encje trójfazowe
WEM3050T	Monitorowanie domowe trójfazowe lub z podziałem faz	Wszystkie metody	Trzy kanały pomiarowe
WEM3080TD	Zastosowania trójfazowe/trójprzewodowe i specjalne okablowanie	Wszystkie metody	Interpretacja encji zależy od trybu okablowania
WEM3046T / WEM3046TE	Opomiarowanie trójfazowe z zewnętrznymi przekładnikami prądowymi 5 A	Wszystkie metody	Zastosuj przekładnię CT, aby uzyskać wartości po stronie pierwotnej

WEM3046T i WEM3046TE mierzą wtórne wyjście 5 A zewnętrznych przekładników prądowych. Zastosowanie przekładni CT jest wymogiem tego układu pomiarowego, a nie ograniczeniem kompatybilności z Home Assistant.

Używanie encji energii IAMMETER w Energy Dashboard

Home Assistant Energy Dashboard potrzebuje skumulowanych encji energii importowanej i eksportowanej w kWh, zwykle z:

• device_class: energy;
• state_class: total_increasing.

Obecne integracje Core, HACS HTTP, HACS Modbus i MQTT Discovery dostarczają wymaganych metadanych dla swoich encji energii importowanej/eksportowanej. Przy ręcznej konfiguracji Modbus lub ręcznej MQTT musisz samodzielnie dodać poprawną jednostkę, klasę urządzenia i klasę stanu.

Nie używaj encji mocy chwilowej w watach jako zastępstwa dla skumulowanej encji energii w kWh.

Wysyłanie istniejących danych energetycznych Home Assistant do IAMMETER Cloud

Powyższe metody wprowadzają dane z licznika IAMMETER do Home Assistant. IAMMETER-Link działa w przeciwnym kierunku: przesyła encje energii, które już istnieją w Home Assistant, do wirtualnego licznika IAMMETER i IAMMETER Cloud.

Jest to przydatne, gdy falownik lub licznik innej firmy ma już integrację z Home Assistant, ale chcesz również korzystać z pulpitów, raportów lub dostępu wielostanowiskowego IAMMETER Cloud.

IAMMETER-Link obecnie zapewnia:

• konfigurację przez HACS i interfejs;

• mapowanie wirtualnych liczników jednofazowych i trójfazowych;

• 300-sekundowy interwał przesyłania z IAMMETER Basic;

• 60-sekundowy interwał przesyłania z IAMMETER Pro.

• Podłączanie urządzeń energetycznych Home Assistant do IAMMETER Cloud

• Repozytorium GitHub IAMMETER-Link

Przykłady monitorowania energii w Home Assistant

Po zintegrowaniu licznika, jego dane o mocy w czasie rzeczywistym i skumulowanej energii mogą być używane do:

• monitorowania produkcji słonecznej, zużycia domowego oraz importu/eksportu z sieci;
• sterowania przekaźnikiem w czasie rzeczywistym za pomocą Modbus TCP;
• pulpitów Home Assistant i Grafana;
• ładowania EV nadwyżkami energii słonecznej;
• podgrzewania wody nadwyżkami energii słonecznej.

Potrzebujesz pomocy?

Jeśli masz pytania dotyczące oprogramowania, konfiguracji encji, konfiguracji Energy Dashboard lub wyboru metody integracji, odwiedź forum społeczności IAMMETER.