Lambda Wärmepumpen Integration für Home Assistant

Ich habe für Home Assistant eine Integration geschrieben, die eine Lambda Wärmepumpe auslesen und steuern kann.
Die Nutzung des Codes, oder der gesamten Integration erfolgt auf eigne Gefahr, und es ist keine offizielle Integration vom Hersteller der Wärmpumpe.

Der Code ist hier zu finden: https://github.com/GuidoJeuken-6512/lambda_wp_hacs

Diese benutzerdefinierte Integration ermöglicht die Einbindung von Lambda Wärmepumpen in Home Assistant über das Modbus/TCP Protokoll. Sie liest Sensordaten aus und ermöglicht die Steuerung von Klima-Entitäten (z.B. Warmwasser, Heizkreis).

Wenn jemand mitarbeiten möchte, so kann er sich gern melden!.

Features

• Auslesen diverser Sensoren der Wärmepumpe (Temperaturen, Zustände, Energieverbrauch etc.).
• Steuerung der Zieltemperatur für Warmwasser und Heizkreise über climate-Entitäten.
• Dynamische Anpassung der Sensoren basierend auf der Firmware-Version.
• Konfiguration über die Home Assistant UI (Integration).
• Steuerung der Lambda mit einem Raum-Thermostat je Heizkreis
• Steuerung der Lambda bei PV-Überschuss
• Ausschließen bestimmter Register
• Umbenennen bestimmter Sensoren, um historische Daten im Home Assistant zu behalten
• Anpassen des Intervalls zum Auslesen der Sensoren

Installation

Im Moment gibt es nur ein manuelle Installation, an einer direkten Installation über den HACS arbeite ich noch.

Installation über HACS:

1. HACS installieren (falls noch nicht geschehen)
   • Folge der offiziellen HACS-Installationsanleitung
2. Benutzerdefiniertes Repository hinzufügen
   • Öffne HACS in Home Assistant
   • Gehe zu Integrationen
   • Klicke auf das Dreipunkt-Menü (⋮) → „Benutzerdefinierte Repositorys“
   • Füge die Repository-URL ein: GuidoJeuken-6512/lambda_wp_hacs
   • Wähle Kategorie: „Integration“
3. Die Integration installieren
   • Suche in HACS nach „Lambda Heat Pumps“
   • Klicke auf „Herunterladen“ → Bestätige mit „Herunterladen“
4. Starte Home Assistant neu

Manuelle Installation:

1. Kopieren der Dateien:
   • Kopieren Sie den gesamten Ordner „lambda_heat_pumps" (mit allen enthaltenen Dateien wie __init__.py, sensor.py, manifest.json etc.) in Ihren "custom_components“ Ordner innerhalb Ihres Home Assistant Konfigurationsverzeichnisses.
   • Pfad: <HA-Konfigurationsordner>/custom_components/<code>lambda_heat_pumps/
   • wenn der Ordner „/custom_components/“ nicht vorhanden ist, bitte vorher anlegen.
   • Das Anlegen der Ordner und kopieren der Files kann z.B. über das addon „File editor“ erfolgen
2. Neustart von Home Assistant:
   • Starten Sie Home Assistant neu, damit die neue Integration erkannt wird.

Konfiguration

1. Integration hinzufügen:
   • Gehen Sie in Home Assistant zu Einstellungen -> Geräte & Dienste.
   • Klicken Sie unten rechts auf Integration hinzufügen.
   • Suchen Sie nach „Lambda Heat Pumps“ und wählen Sie die Integration aus.
2. Verbindungsdaten eingeben:
   • Name: Ein beliebiger Name für Ihre Wärmepumpe (z.B. „Lambda Wärmepumpe“).
     • Die Sensoren bekommen den Namen als Prefix!
     • Wenn vorher die modbus Variante zum Auslesen der Lambda verwendet wird, muss hier der entsprechende Name eingegeben werden. (z.B. EU08L)
   • Host: Die IP-Adresse Ihrer Lambda Wärmepumpe im Netzwerk (z.B. 192.168.1.100).
   • Port: Der Modbus/TCP Port (Standard ist 502).
   • Slave ID: Die Modbus Slave ID Ihrer Wärmepumpe (Standard ist 1).
   • Die Anzahl der verschiedenen Lambda Komponenten angeben.
   • Legacy Modbus-Namen: Dann wird ein Namensschema verwendet, dass gleich zu den Namen des „alten“ Modbus-Scriptes ist. Damit sollten die historischen Daten der Lambda erhalten bleiben.
   • Firmware Version (noch nicht implementiert): Wählen Sie die passende Firmware-Version Ihrer Wärmepumpe aus. Dies beeinflusst, welche Sensoren verfügbar sind. Die Firmware Version kannst du in der Lambda Remote Konsole sehen.
3. Abschließen:
   • Klicken Sie auf Senden. Die Integration wird nun eingerichtet und die entsprechenden Entitäten (Sensoren, Klima) sollten in Home Assistant erscheinen.

Optionen

Nach der Einrichtung können Sie einige Optionen über Einstellungen -> Geräte & Dienste -> Lambda Heat Pumps -> Konfigurieren anpassen:
Um die Optionen „Raumthermostat Steuerung“ und „PV-Überschuss“ nutzen zu können, müssen vorher in der Lambda bestimmte Konfigurationen vorgenommen werden. Siehe dazu weiter unten!

Temperaturbereiche: Minimale und maximale Zieltemperaturen für Warmwasser und Heizkreis.

Firmware Version: Ändern der Firmware-Version (erfordert einen Neustart der Integration).

Die Nutzung eines Raum-Thermostat je Heizkreis. Diese Steuerung dafür muss in der Lambda freigeschaltet werden. Dann kann das Register 5×04 mit dem Wert eines Thermometers beschrieben werden.
Pro Heizkreis kann in den Optionen der Integration ein Thermometer ausgewählt werden.

Raum-Thermostat Steuerung
Wird diese Option aktiviert, so steuert die Lambda mit dem eingestellten DeltaWert ihr Heizkurve nach.
Ist der Raum wärmer als die Solltemperatur, so regelt die Lambda die Heizkurve runter, ansonsten erhöht sie die Heizkurve.
In der Home Assistant Integration wird nach Aktivierung der Option pro Heizkreis ein Thermometer abgefragt. Anhand der Temperaturwerte diese Thermometers wird die Lambda dann entsprechend regeln.

In der Lambda muss für die Raumthermostat-Steuerung in allen Heizkreisen der Raumgerätetyp auf „ModBus Client“ stehen

PV-Überschuss
Die Lambda kann ihre Leistung erhöhen, wenn PV-Überschuss vorliegt. Dazu bekommt sie die Information per Modbus, das Register 102 wird mit „W“ PV Überschuss beschreiben.
Dazu wird beim Konfigurieren der Option ein Sensor der Klasse „Power“ abgefragt. Der Wert in W, kW wird umgerechnet, wird dann an die Lambda per Modbus auf des Register 102 geschrieben. Die Lambda regelt dann ihre Leistung hoch, wenn viel PV Überschuss vorhanden ist.

In der Lambda müssen vorher folgende Einstellungen gesetzt sein, der PV-Überschuss ist dann auch in Oberfläche der Lambda sichtbar:

Register ausschließen

Es kommt vor, das bestimmte Lambda-Wärmepumpen eine andere Konfiguration haben. Bei mir ist z.B. keine Zirkulationspumpe in der Wärmepumpe konfiguriert, da ich diese direkt aus Home Assistant steuere.
Dann kommt es im Home Assistant zu Warnungen im Log, das bestimmte Register der Lambda nicht ausgelesen werden können.

Diese lassen sich dann gezielt ausschließen.
Dazu in der lambda_wp_conig.yaml im HauptVerzeichnis von Home Assistant die Adressen eintragen, die nicht ausgelesen werden sollen.
Hier der Screenshot meiner Konfiguration.

Sensor Namen umbenennen

Um historische Werte in Home Assistant zu behalten, kann es notwendig sein, alte Namen für bestimmte Sensoren zu behalten. Dies kann konfiguriert werden.
Dazu in der lambda_wp_config.yaml im HauptVerzeichnis von Home Assistant den Originalnamen und den Namen, der benutzt werden soll eintragen und die Integration neue laden.

ToDos, offene Punkte in ihrer Reihenfolge zur Bearbeitung

• die Übersetzungen funktionieren nicht überall
• Veröffentlichen der Integration im HACS
• Template Sensoren (JAZ / COP / Taktung…)