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_heat_pumps

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
• Berechneter COP-Sensor basierend auf thermischer Energieausgabe und Stromverbrauch
• Sensoren für die Taktung der Wärmepumpe nach Betriebsart (total / daily / yesterday)
• Sesoren für die Stromverbrauchsmessung nach Betriebsart (Heizen / Warmwasser / Kühlen)
• Stromverbrauchssensor ist konfigurierbar (Shelly vor gesamter Wärmepumpe oder EMS)
• über den HACS installierbar

Installation

Installation über HACS:

1. HACS installieren (falls noch nicht geschehen)
   • Folge der offiziellen HACS-Installationsanleitung
2. Die Integration installieren
   • Suche in HACS nach „Lambda Heat Pumps“
   • Klicke auf „Herunterladen“ → Bestätige mit „Herunterladen“
3. Starte Home Assistant neu

Manuelle Installation:

Die manuelle Installation sollte nur gewählt werden, wenn über den HACS nicht installiert werden kann.
Der „main“ Branch im Github hat nicht immer eine stabile Version, besser ist es bei der manuellen Installation über ein veröffentlichtes Release zu gehen.

1. Kopieren der Dateien:
   • Im Github unter Releases aus dem letzten Release die SourceCode als Zip herunterladen.
   • Aus dem Zip aus dem Ordner custom_components/ den Ordner lambda_heat_pumps extrahieren
   • 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/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 manuell 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 wird automatisch ermittelt.
   • Firmware Version: 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.
Beim Heizkreis ist hier die Soll-Temperatur einstellbar, wenn eine Steuerung der Lambda über ein Raumthermostat erfolgt. Die Vorlauftemperatur ist nicht konfigurierbar, sie muss in der Lambda über die Heizkurve eingestellt werden.

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. Die Art der Überschuss Steuerung muss zu der Konfiguration in der Lambda passen.
Sollte eure PV-Anlage negative Werte bei PV-Überschuss angeben, macht einen Template Sensor in Home Assistant, damit positive Werte an die Lambda übergeben werden.
Die Werte werden alle 30 sec an die Lambda gesendet. Wenn die Lambda keine Werte über einige Minuten empfängt, so erzeugt sie einen Fehler, daher die Option in der Lambda immer wieder deaktivieren, wenn sie nicht mehr eingesetzt wird.

template:<br>  - sensor:<br>      - name: "Positiv Sensor"<br>        state: "{{ states('sensor.mein_sensor') | float(0) | abs }}"

template:<br>  - sensor:<br>      - name: "Positiv Sensor"<br>        state: "{{ states('sensor.mein_sensor') | float(0) | abs }}"

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.

Das Umbenennen von Entitäten ist nur noch in der Integration vorhanden, falls es jemand nutzt.
Viel besser ist es, die historischen Daten mit Home Assistat Mitteln an den neuen Sensor zu binden.
Wie das geht, ist hier beschreiben.

Weitere Einstellungsmöglichkeiten über die lambda_wp_config.yaml sind hier beschrieben. Lambda_wp_config.yaml