Home Assistant-Energiezähler-Integration: MQTT, Modbus TCP und IAMMETER-Link

Home Assistant-Energiezähler-Integration: MQTT, Modbus TCP und IAMMETER-Link

IAMMETER-Energiezähler können mit Home Assistant über lokales HTTP, Modbus TCP oder MQTT integriert werden. Die beste Methode hängt davon ab, ob Sie eine offizielle Integration, eine UI-basierte Einrichtung, schnelle lokale Updates, MQTT Auto-Discovery oder die fortgesetzte Nutzung von IAMMETER Cloud bevorzugen.

Dieser Leitfaden vergleicht die verfügbaren Methoden und führt Sie zur entsprechenden Einrichtungsanleitung. Er deckt alle aktuellen IAMMETER-Energiezähler ab. Der eingestellte WEM3162 ist nicht enthalten.

Welche Home Assistant-Integration sollte ich verwenden?

Methode	Zählerseitige Einrichtung	Home Assistant-Einrichtung	Typisches Aktualisierungsintervall	Vollständig lokal	IAMMETER Cloud gleichzeitig	Auto-Discovery	Am besten geeignet für
Home Assistant Core	Zähler im LAN zugänglich halten	Integrierte IAMMETER-Integration in YAML hinzufügen	30 Sekunden	Ja	Ja	Nein	Benutzer, die eine offizielle integrierte Integration bevorzugen
Home Assistant Modbus	Modbus TCP im LAN bereitstellen	Integrierte Modbus-Integration und Sensoren in YAML konfigurieren	Konfigurierbar; üblich 1–5 Sekunden	Ja	Ja	Nein	Schnelle Überwachung und Echtzeit-Automationen
MQTT Manuell	MQTT-Broker in der Zähler-WebUI konfigurieren	MQTT-Integration aktivieren und Sensoren in YAML definieren	Konfigurierbar; neueste Firmware unterstützt bis zu 2 Sekunden	Ja, mit lokalem Broker	Nein	Nein	Benutzer, die benutzerdefinierte Topics und Sensoren benötigen
HACS HTTP	Zähler im LAN zugänglich halten	IAMMETER HTTP über HACS installieren und in der UI konfigurieren	60 Sekunden	Ja	Ja	SSDP-unterstützt	UI-Einrichtung ohne YAML
HACS Modbus	Modbus TCP im LAN bereitstellen	IAMMETER Modbus über HACS installieren und in der UI konfigurieren	Konfigurierbar; Standard 3 Sekunden	Ja	Ja	SSDP-unterstützt	Schnelle lokale Updates mit UI-Konfiguration
MQTT Discovery	Broker konfigurieren und HA MQTT Discovery in der Zähler-WebUI aktivieren	MQTT-Integration aktivieren; Sensoren werden automatisch erstellt	Konfigurierbar; neueste Firmware unterstützt bis zu 2 Sekunden	Ja, mit lokalem Broker	Nein	Ja	Die einfachste MQTT-Einrichtung

Kurze Empfehlungen:

• Wählen Sie Home Assistant Core, wenn Sie die offizielle integrierte Integration wünschen und ein Aktualisierungsintervall von 30 Sekunden ausreichend ist.
• Wählen Sie HACS HTTP, wenn Sie eine UI-Konfiguration bevorzugen und keine schnellen Updates benötigen.
• Wählen Sie HACS Modbus, wenn Sie eine UI-Konfiguration mit schnelleren lokalen Daten für Dashboards und Automationen wünschen.
• Wählen Sie Home Assistant Modbus, wenn Sie mit YAML vertraut sind und die volle Kontrolle über Register, Sensoren und Abfrageintervalle haben möchten.
• Wählen Sie MQTT Discovery, wenn Sie bereits MQTT verwenden und möchten, dass Home Assistant das Gerät und die Entitäten automatisch erstellt.
• Wählen Sie MQTT Manuell, wenn Sie die vollständige Kontrolle über MQTT-Topics, Vorlagen und Entitätsdefinitionen benötigen.

MQTT Manuell und MQTT Discovery ändern den Upload-Modus des Zählers auf MQTT. In diesen Modi lädt der Zähler nicht gleichzeitig Messwerte zu IAMMETER Cloud hoch. Lokale HTTP- und Modbus-TCP-Integrationen können weiterhin funktionieren, während der Zähler zu IAMMETER Cloud hochlädt.

1. Offizielle Home Assistant Core-Integration

Die offizielle IAMMETER-Integration ist in Home Assistant enthalten und liest die lokale HTTP-API des Zählers. Sie benötigt weder HACS noch eine Internetverbindung zwischen Home Assistant und dem Zähler.

Hauptmerkmale:

• wird in configuration.yaml konfiguriert;
• lokales HTTP-Polling alle 30 Sekunden;
• kann zusammen mit IAMMETER Cloud verwendet werden;
• importierte und exportierte Energie-Entitäten enthalten die Metadaten, die für das Home Assistant Energy Dashboard erforderlich sind;
• keine automatische Geräteerkennung.

Verwenden Sie diese Methode, wenn Stabilität und offizielle Home Assistant-Unterstützung wichtiger sind als schnelle Aktualisierungsraten.

• Offizielle IAMMETER-Integration in Home Assistant

2. Home Assistant Modbus TCP-Integration

Die integrierte Modbus-Integration von Home Assistant liest die lokalen Modbus-TCP-Register des Zählers. Sie eignet sich für leistungsbasierte Automationen, Solar-Überschusssteuerung und andere Anwendungen, die schnellere Updates benötigen.

Hauptmerkmale:

• wird in YAML konfiguriert;
• konfigurierbares scan_interval, üblich 1–5 Sekunden für Echtzeit-Automation;
• vollständig lokal und unabhängig vom Internet;
• kann zusammen mit IAMMETER Cloud verwendet werden;
• erfordert die korrekte Registeradresse, den Datentyp, den Skalierungsfaktor und die Energy Dashboard-Metadaten.

Verwenden Sie ein längeres Abfrageintervall, wenn keine sekundengenauen Daten erforderlich sind. Vermeiden Sie es, mehrere hochfrequente Modbus-Clients gegen denselben Zähler auszuführen.

• Home Assistant Modbus TCP-Energiezähler-Anleitung
• IAMMETER Modbus TCP-Registerkarte

3. HACS HTTP-Integration

Die IAMMETER HTTP Custom Integration bietet eine UI-basierte Alternative zur offiziellen YAML-Integration. Sie liest /monitorjson über das lokale Netzwerk und erstellt die entsprechenden Home Assistant-Entitäten.

Hauptmerkmale:

• wird über HACS installiert;
• wird über die Home Assistant-Benutzeroberfläche unter Devices & Services konfiguriert;
• lokales HTTP-Polling alle 60 Sekunden;
• SSDP kann die Geräteerkennung unterstützen;
• kompatibel mit IAMMETER Cloud und dem Energy Dashboard.

Verwenden Sie diese Methode, wenn Sie eine UI-Konfiguration bevorzugen und ein Aktualisierungsintervall von einer Minute ausreichend ist.

• IAMMETER HACS HTTP-Integration
• HACS HTTP-Einrichtungsanleitung

4. HACS Modbus-Integration

Die IAMMETER Modbus Custom Integration kombiniert lokales Modbus-TCP-Polling mit der Home Assistant-UI-Konfiguration. Sie ist die bequemste Option für Benutzer, die schnellere Updates benötigen, aber nicht jedes Register in YAML definieren möchten.

Hauptmerkmale:

• wird über HACS installiert und in der UI konfiguriert;

• konfigurierbares Abfrageintervall, mit einem Standardwert von 3 Sekunden in der aktualisierten Integration;

• lokaler Betrieb und Kompatibilität mit IAMMETER Cloud;

• erstellt Leistungs- und importierte/exportierte Energie-Entitäten mit den entsprechenden Home Assistant-Metadaten;

• unterstützt alle aktuellen IAMMETER-Zähler, mit unterschiedlichen Entitätenanzahlen für ein- und dreiphasige Modelle.

• IAMMETER HACS Modbus-Integration

• HACS Modbus-Einrichtungsanleitung

5. Manuelle MQTT-Integration

Im manuellen MQTT-Modus veröffentlicht der Zähler Messdaten an Ihren MQTT-Broker, und Sie definieren die entsprechenden Sensoren in Home Assistant.

Die zählerseitige Konfiguration und die Home Assistant-Konfiguration sind getrennt:

1. Konfigurieren Sie die Broker-Adresse, den Port, den Benutzernamen und das Passwort in der neuesten WebUI des Zählers.
2. Aktivieren Sie die MQTT-Integration in Home Assistant.
3. Definieren Sie die erforderlichen MQTT-Sensoren und JSON-Vorlagen in YAML.

Diese Methode ist nützlich, wenn mehrere Anwendungen dieselben Messwerte abonnieren müssen oder wenn Sie benutzerdefinierte Topics und Entitätsdefinitionen benötigen.

• Konfigurieren eines IAMMETER-Energiezählers mit einem MQTT-Server
• Manuelle MQTT-Energiezähler-Einrichtung für Home Assistant

6. Home Assistant MQTT Discovery

MQTT Discovery ist für Benutzer gedacht, die den geringsten manuellen Konfigurationsaufwand wünschen. Nachdem Sie den Broker konfiguriert und HA MQTT Discovery in der Zähler-WebUI aktiviert haben, erstellt Home Assistant automatisch das IAMMETER-Gerät und seine Entitäten.

Die generierten importierten und exportierten Energie-Entitäten enthalten:

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

Diese Attribute stellen die Metadaten bereit, die für die Verwendung im Home Assistant Energy Dashboard erforderlich sind.

MQTT Discovery wird von allen aktuellen IAMMETER-Energiezählern unterstützt. Einphasige und dreiphasige Modelle erstellen je nach ihren Messkanälen unterschiedliche Anzahlen von Entitäten.

• Home Assistant MQTT Discovery-Einrichtung
• IAMMETER MQTT Discovery-Anleitung
• Upgrade auf die neueste IAMMETER-Firmware

Unterstützte IAMMETER-Energiezähler

Alle aktuellen IAMMETER-Energiezähler unterstützen die oben beschriebenen Integrationsmethoden. Der Hauptunterschied in Home Assistant ist die Anzahl der Phasen oder Messkanäle und damit die Anzahl der erstellten Entitäten.

Modell	Typische Anwendung	Home Assistant-Unterstützung	Wichtiger Hinweis
WEM3080	Einphasige Energieüberwachung	Alle Methoden	Einphasige Entitäten
WEM2067	Einphasige Solar-Heimüberwachung	Alle Methoden	Zwei Messkanäle
WEM3080T	Dreiphasige Energieüberwachung	Alle Methoden	Dreiphasige Entitäten
WEM3050T	Dreiphasige oder Split-Phase-Heimüberwachung	Alle Methoden	Drei Messkanäle
WEM3080TD	Dreiphasen-/Dreileiter- und spezielle Verdrahtungsanwendungen	Alle Methoden	Entitäteninterpretation hängt vom Verdrahtungsmodus ab
WEM3046T / WEM3046TE	Dreiphasige Messung mit externen 5 A-Wandlern	Alle Methoden	Das externe Wandlerverhältnis anwenden, um primärseitige Werte zu erhalten

WEM3046T und WEM3046TE messen den 5-A-Sekundärausgang externer Stromwandler. Die Anwendung des Wandlerverhältnisses ist eine Anforderung dieser Messanordnung, keine Home Assistant-Kompatibilitätseinschränkung.

Verwenden von IAMMETER-Energie-Entitäten im Energy Dashboard

Das Home Assistant Energy Dashboard benötigt kumulative importierte und exportierte Energie-Entitäten in kWh, normalerweise mit:

• device_class: energy;
• state_class: total_increasing.

Die aktuellen Core-, HACS HTTP-, HACS Modbus- und MQTT Discovery-Integrationen stellen die erforderlichen Metadaten für ihre importierten/exportierten Energie-Entitäten bereit. Bei manueller Modbus- oder manueller MQTT-Konfiguration müssen Sie die korrekte Einheit, Geräteklasse und Zustandsklasse selbst hinzufügen.

Verwenden Sie keine momentane Leistungs-Entität in Watt als Ersatz für eine kumulative Energie-Entität in kWh.

Vorhandene Home Assistant-Energiedaten an IAMMETER Cloud senden

Die oben genannten Methoden bringen IAMMETER-Zählerdaten in Home Assistant. IAMMETER-Link arbeitet in die entgegengesetzte Richtung: Es lädt Energie-Entitäten, die bereits in Home Assistant vorhanden sind, zu einem IAMMETER Virtual Meter und IAMMETER Cloud hoch.

Dies ist nützlich, wenn ein Wechselrichter oder ein Drittanbieter-Zähler bereits eine Home Assistant-Integration hat, Sie aber auch IAMMETER Cloud-Dashboards, Berichte oder den Multi-Site-Zugriff nutzen möchten.

IAMMETER-Link bietet derzeit:

• HACS- und UI-basierte Konfiguration;

• ein- und dreiphasige Virtual-Meter-Zuordnung;

• ein Upload-Intervall von 300 Sekunden mit IAMMETER Basic;

• ein Upload-Intervall von 60 Sekunden mit IAMMETER Pro.

• Verbinden von Home Assistant-Energiegeräten mit IAMMETER Cloud

• IAMMETER-Link GitHub-Repository

Beispiele für die Energieüberwachung mit Home Assistant

Nach der Integration des Zählers können seine Echtzeit-Leistungs- und kumulativen Energiedaten verwendet werden für:

• Solarerzeugung, Haushaltsverbrauch und Netzbezug/-einspeisung;
• Echtzeit-Relaissteuerung mit Modbus TCP;
• Home Assistant- und Grafana-Dashboards;
• Solar-Überschuss-Laden von Elektrofahrzeugen;
• Solar-Überschuss-Warmwasserbereitung.

Hilfe benötigt?

Wenn Sie Fragen zu Firmware, Entitätenkonfiguration, Energy Dashboard-Einrichtung oder zur Auswahl einer Integrationsmethode haben, besuchen Sie das IAMMETER Community-Forum.