HOME ASSISTANT · PRZEWODNIK PO INTEGRACJI
Integracja licznika energii Home Assistant: MQTT, Modbus TCP i IAMMETER-Link
Liczniki energii IAMMETER można zintegrować z Home Assistant przez lokalny HTTP, Modbus TCP lub MQTT. Najlepsza metoda zależy od tego, czy preferujesz oficjalną integrację, konfigurację przez interfejs użytkownika, szybkie lokalne aktualizacje, automatyczne wykrywanie MQTT czy dalsze korzystanie z IAMMETER Cloud.
Ten przewodnik porównuje dostępne metody i kieruje do odpowiedniego przewodnika konfiguracji. Obejmuje wszystkie obecne liczniki energii IAMMETER. Wycofany model WEM3162 nie jest uwzględniony.
Na tej stronie
Której integracji Home Assistant powinienem użyć?
| Metoda | Konfiguracja po stronie licznika | Konfiguracja Home Assistant | Typowy interwał aktualizacji | W pełni lokalnie | Jednocześnie IAMMETER Cloud | Automatyczne wykrywanie | Najlepsze dla |
|---|---|---|---|---|---|---|---|
| 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 ręcznie | Skonfiguruj brokera MQTT w WebUI licznika | Włącz integrację MQTT i zdefiniuj czujniki w YAML | Konfigurowalny; najnowszy firmware obsługuje nawet 2 sekundy | 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 użytkownika | 60 sekund | Tak | Tak | Wspomagane przez SSDP | Konfiguracja przez interfejs użytkownika bez YAML |
| HACS Modbus | Udostępnij Modbus TCP w sieci LAN | Zainstaluj IAMMETER Modbus przez HACS i skonfiguruj w interfejsie użytkownika | Konfigurowalny; domyślnie 3 sekundy | Tak | Tak | Wspomagane przez SSDP | Szybkie lokalne aktualizacje z konfiguracją przez interfejs użytkownika |
| MQTT Discovery | Skonfiguruj brokera i włącz HA MQTT Discovery w WebUI licznika | Włącz integrację MQTT; czujniki są tworzone automatycznie | Konfigurowalny; najnowszy firmware obsługuje nawet 2 sekundy | Tak, z lokalnym brokerem | Nie | Tak | Najprostsza konfiguracja MQTT |
Szybkie zalecenia:
- Wybierz Home Assistant Core, jeśli chcesz oficjalnej wbudowanej integracji i wystarcza Ci 30-sekundowy interwał aktualizacji.
- Wybierz HACS HTTP, jeśli preferujesz konfigurację przez interfejs użytkownika i nie potrzebujesz szybkich aktualizacji.
- Wybierz HACS Modbus, jeśli chcesz konfigurację przez interfejs użytkownika z szybszymi lokalnymi danymi do pulpitów i automatyzacji.
- Wybierz Home Assistant Modbus, jeśli swobodnie posługujesz się YAML i chcesz mieć pełną kontrolę nad rejestrami, czujnikami i interwałami odpytywania.
- Wybierz MQTT Discovery, jeśli już używasz MQTT i chcesz, aby Home Assistant automatycznie utworzył urządzenie i encje.
- Wybierz MQTT ręcznie, jeśli potrzebujesz pełnej kontroli nad tematami MQTT, szablonami i definicjami encji.
MQTT ręcznie i MQTT Discovery zmieniają tryb wysyłania licznika na MQTT. W tych trybach licznik nie wysyła jednocześnie pomiarów do IAMMETER Cloud. Lokalne integracje HTTP i Modbus TCP mogą nadal działać, gdy licznik wysył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 z internetem 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 Panel energii Home Assistant;
- brak automatycznego wykrywania urządzeń.
Użyj tej metody, gdy stabilność i oficjalne wsparcie Home Assistant są ważniejsze niż szybkie częstotliwości odświeżania.
2. Integracja Home Assistant Modbus TCP
Wbudowana integracja Modbus w Home Assistant odczytuje lokalne rejestry Modbus TCP licznika. Nadaje się do automatyzacji opartych na mocy, sterowania nadwyżką energii słonecznej i innych zastosowań wymagających szybszych aktualizacji.
Główne cechy:
- konfigurowana w YAML;
- konfigurowalny
scan_interval, zwykle 1–5 sekund w automatyzacji w czasie rzeczywistym; - całkowicie lokalna i niezależna od internetu;
- może być używana razem z IAMMETER Cloud;
- wymaga prawidłowego adresu rejestru, typu danych, skali i metadanych Panelu energii.
Używaj dłuższego interwału odpytywania, gdy dane w skali sekund nie są wymagane. Unikaj uruchamiania wielu klientów Modbus o wysokiej częstotliwości wobec tego samego licznika.
3. Integracja HACS HTTP
Niestandardowa integracja IAMMETER HTTP zapewnia alternatywę opartą na interfejsie użytkownika dla oficjalnej integracji YAML. Odczytuje /monitorjson w sieci lokalnej i tworzy odpowiednie encje Home Assistant.
Główne cechy:
- instalowana przez HACS;
- konfigurowana przez interfejs Urządzenia i usługi Home Assistant;
- lokalne odpytywanie HTTP co 60 sekund;
- SSDP może wspomagać wykrywanie urządzeń;
- zgodna z IAMMETER Cloud i Panelem energii.
Użyj tej metody, jeśli preferujesz konfigurację przez interfejs użytkownika i wystarcza Ci jednominutowy interwał odświeżania.
4. Integracja HACS Modbus
Niestandardowa integracja IAMMETER Modbus łączy lokalne odpytywanie Modbus TCP z konfiguracją przez interfejs użytkownika Home Assistant. 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 użytkownika;
konfigurowalny interwał skanowania, domyślnie 3 sekundy w zaktualizowanej integracji;
działanie lokalne i zgodność 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.
5. Ręczna integracja MQTT
W trybie ręcznym MQTT licznik publikuje dane pomiarowe w Twoim brokerze MQTT, a Ty definiujesz odpowiednie czujniki w Home Assistant.
Konfiguracja po stronie licznika i konfiguracja Home Assistant są oddzielne:
- Skonfiguruj adres brokera, port, nazwę użytkownika i hasło w najnowszym WebUI licznika.
- Włącz integrację MQTT w Home Assistant.
- 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.
6. Home Assistant MQTT Discovery
MQTT Discovery jest przeznaczone dla użytkowników, którzy chcą jak najmniejszej liczby ręcznych konfiguracji. Po skonfigurowaniu brokera i włączeniu HA MQTT Discovery w WebUI licznika Home Assistant automatycznie tworzy urządzenie IAMMETER i jego encje.
Generowane encje energii importowanej i eksportowanej zawierają:
unit_of_measurement: kWh;device_class: energy;state_class: total_increasing.
Te atrybuty zapewniają metadane wymagane do użycia w Panelu energii Home Assistant.
MQTT Discovery jest obsługiwane przez wszystkie obecne liczniki energii IAMMETER. Modele jednofazowe i trójfazowe tworzą różną liczbę encji w zależności od kanałów pomiarowych.
Obsługiwane liczniki energii IAMMETER
Wszystkie obecne liczniki energii IAMMETER obsługują opisane powyżej metody integracji. Główna różnica w Home Assistant to liczba faz lub kanałów pomiarowych, a zatem liczba tworzonych encji.
| Model | Typowe zastosowanie | Obsługa Home Assistant | Ważna uwaga |
|---|---|---|---|
| WEM3080 | Monitorowanie energii jednofazowej | Wszystkie metody | Encje jednofazowe |
| WEM2067 | Monitorowanie jednofazowej domowej instalacji fotowoltaicznej | Wszystkie metody | Dwa kanały pomiarowe |
| WEM3080T | Monitorowanie energii trójfazowej | Wszystkie metody | Encje trójfazowe |
| WEM3050T | Monitorowanie domowe trójfazowe lub split-phase | Wszystkie metody | Trzy kanały pomiarowe |
| WEM3080TD | Zastosowania trójfazowe/trójprzewodowe i specjalne układy połączeń | Wszystkie metody | Interpretacja encji zależy od trybu okablowania |
| WEM3046T / WEM3046TE | Pomiar trójfazowy z zewnętrznymi przekładnikami prądowymi 5 A | Wszystkie metody | Zastosuj przekładnię zewnętrznego CT, aby uzyskać wartości po stronie pierwotnej |
WEM3046T i WEM3046TE mierzą 5 A wyjście wtórne zewnętrznych przekładników prądowych. Zastosowanie przekładni CT jest wymogiem tego układu pomiarowego, a nie ograniczeniem zgodności z Home Assistant.
Używanie encji energii IAMMETER w Panelu energii
Panel energii Home Assistant 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 zapewniają wymagane metadane dla swoich encji energii importowanej/eksportowanej. W przypadku ręcznej konfiguracji Modbus lub ręcznego MQTT musisz samodzielnie dodać prawidłową jednostkę, klasę urządzenia i klasę stanu.
Nie używaj encji mocy chwilowej w watach jako zamiennika skumulowanej encji energii w kWh.
Wysyłanie istniejących danych o energii z Home Assistant do IAMMETER Cloud
Powyższe metody przenoszą dane licznika IAMMETER do Home Assistant. IAMMETER-Link działa w przeciwnym kierunku: wysyła encje energii, które już istnieją w Home Assistant, do IAMMETER Virtual Meter i IAMMETER Cloud.
Jest to przydatne, gdy falownik lub licznik innego producenta ma już integrację z Home Assistant, ale chcesz także korzystać z pulpitów, raportów lub dostępu do wielu lokalizacji w IAMMETER Cloud.
IAMMETER-Link obecnie zapewnia:
konfigurację przez HACS i interfejs użytkownika;
mapowanie liczników wirtualnych jednofazowych i trójfazowych;
interwał wysyłania 300 sekund z IAMMETER Basic;
interwał wysyłania 60 sekund z IAMMETER Pro.
Połącz urządzenia energetyczne Home Assistant z IAMMETER Cloud
Przykłady monitorowania energii w Home Assistant
Po zintegrowaniu licznika jego dane o mocy w czasie rzeczywistym i skumulowanej energii można wykorzystać do:
- monitorowania wytwarzania energii słonecznej, zużycia w gospodarstwie domowym oraz importu/eksportu z sieci;
- sterowania przekaźnikiem w czasie rzeczywistym za pomocą Modbus TCP;
- pulpitów Home Assistant i Grafana;
- ładowania pojazdów elektrycznych nadwyżką energii słonecznej;
- podgrzewania wody nadwyżką energii słonecznej.
Potrzebujesz pomocy?
Jeśli masz pytania dotyczące firmware, konfiguracji encji, konfiguracji Panelu energii lub wyboru metody integracji, odwiedź forum społeczności IAMMETER.