!Wärmepumpe mit Pufferspeichern im Technikraum
„Eine direkte Ansteuerung der Wärmepumpe ist nicht möglich.“ Dieser Satz steht im Modbus-Protokoll, das Lambda Wärmepumpen GmbH auf der eigenen Website zum Download anbietet (Version 1.0, Copyright 2026). Der nächste Satz macht ihn erträglich: Dasselbe Ergebnis lasse sich erreichen, indem man bestimmte Register des Pufferspeichers beschreibt, die Anforderung werde dann eins zu eins an die Wärmepumpe weitergegeben. Wer das Dokument durchliest, merkt schnell, dass Lambda sich die Schnittstelle gründlich überlegt hat. Und dass sie an ein paar Stellen anders funktioniert, als man es von einer Modbus-Wärmepumpe erwartet.
Das ist die Ausgangslage für Besitzer einer Lambda der EU-L-Serie, die ihre Anlage in Home Assistant holen wollen. Es gibt zwei Wege: eine fertige Integration über HACS oder eine eigene Modbus-Konfiguration in YAML. Beide laufen lokal über Modbus TCP, keiner braucht die Cloud. Dieser Artikel sortiert, wann welcher passt. Grundlage sind das Lambda-Dokument, die drei GitHub-Projekte, die Dokumentation von Home Assistant 2026.10.4 und die Analytics-Daten der Custom-Integrationen, alle gelesen am 31. Oktober 2026.
Was Lambda per Modbus anbietet
Zuerst die Regeln des Reglers, denn sie bestimmen alles Weitere.
- Die Lambda-Regelung ist immer Modbus-Server („Slave“). Sie kann nicht selbst Werte von anderen Geräten abfragen, etwa vom Wechselrichter. Alles, was in die Wärmepumpe hineinsoll, muss Home Assistant schicken.
- Gelesen wird ausschließlich mit Funktionscode 0x03 (Read Multiple Holding Registers). Geschrieben wird ausschließlich mit 0x10 (Write Multiple Registers), auch wenn es nur ein einzelnes Register ist.
- Nach einer Minute ohne Kommunikation schließt der Regler die Verbindung.
- Lesen ist werksseitig für alle Register freigeschaltet, das Schreiben der meisten ebenfalls. Ausnahmen nennt das Dokument an den entsprechenden Stellen.
Die Module laut Lambda-Dokument:
| Index | Modul | Beispiel |
|---|---|---|
| 0 | Allgemein, E-Manager (Subindex 1) | 0002 Außentemperatur, 0102 Netzbezug/Einspeisung |
| 1 | Wärmepumpe (bis zu fünf) | 1004 Vorlauf, 1005 Rücklauf, 1012 Stromaufnahme Frequenzumrichter |
| 2 | Warmwasserspeicher | 2002 Temperatur oben, 2050 Solltemperatur |
| 3 | Pufferspeicher | 3X06 bis 3X08 Anforderung an die Wärmepumpe |
| 4 | Thermische Solaranlage | 4X02 Kollektortemperatur |
| 5 | Heizkreis (bis zu zwölf) | 5X05 Vorlauf-Sollwert über Modbus, 5X50 Offset |
Weg 1: Die HACS-Integration
Mehrere Projekte tragen den Namen „Lambda“. Zwei davon sind echte Integrationen:
Lambda Heat Pumps von GuidoJeuken-6512 (Repository lambda_heat_pumps). Angelegt am 22. Mai 2025, letzter Push am 30. Oktober 2026, aktuelles Release V2.8.6 vom 5. September 2026, MIT-Lizenz, 64 Sterne. Laut Analytics-Seite von Home Assistant melden 334 Installationen die Integration (nur Nutzer, die Analytics freigeschaltet haben, 287 davon mit V2.8.6). Die Integration läuft als local_polling über pymodbus.
Lambda Heatpump von route662 (Repository Lambda-Heatpump). Angelegt im März 2025, letztes Release v1.4.0 vom 15. September 2025, letzter Push am 7. Oktober 2025, GPL-3.0, elf Sterne, 14 Installationen in der Analytics-Statistik. Sie liest Temperaturen, Energie und Status mit einstellbarem Intervall, mehr verspricht die README nicht.
Für die meisten ist die erste Integration die naheliegende. Die Einrichtung läuft über die Oberfläche: Name (die README nennt als Beispiel „EU08L“), Host, Port 502, Slave-ID 1 und die Firmware-Version des Reglers. Die Firmware entscheidet, welche Sensoren angelegt werden. Alles andere erkennt die Integration laut README selbst: Wärmepumpen, Boiler, Puffer, Solar und Heizkreise.
Was Sie bekommen:
- Sensoren für alle erkannten Module, dazu Takt-Zähler (Heizen, Warmwasser, Kühlen, Abtauen) und ein berechneter COP.
- Number-Entities für die Heizkurve. Laut Dokumentation lassen sich die drei Stützpunkte bei −22, 0 und +22 Grad Außentemperatur einstellen und ein Vorlauf-Offset von −10 bis +10 Kelvin schreiben. Der Offset liegt im Heizkreis auf Register 50, passend zu 5X50 im Lambda-Dokument.
- Climate-Entities für Warmwasser und Heizkreis, optional mit externem Raumthermometer.
- Eine Option für PV-Überschuss (mehr dazu unten).
- Aktionen, um beliebige Register zu lesen und zu schreiben.
Weg 2: Modbus-YAML
Der zweite Weg braucht keine Zusatzkomponente. Home Assistant bringt die Modbus-Integration selbst mit, und sie spricht Modbus TCP direkt.
Die bekannteste Vorlage stammt von Ralf Winter (Repository lambda-heatpump-modbus-tcp-HA): angelegt im Februar 2023, letzter Commit am 4. Dezember 2025, Apache-2.0, 66 Sterne. Die Datei enthält 68 Adressen, bezieht sich laut Kommentar auf die Lambda-Spezifikation vom 11. April 2023 und nennt als Gerätenamen „EU13L“. Der Autor schreibt in der README, er habe nicht alle Sensoren testen können, weil an seiner Anlage nicht alle Module vorhanden sind, die die Spezifikation beschreibt. Die Datei enthält nur lesende Sensoren, keine Schreibzugriffe.
Ein eigener Zuschnitt sieht so aus. Die Registeradressen stammen aus dem Lambda-Dokument, die Schlüssel aus der Modbus-Dokumentation von Home Assistant:
modbus:
- name: lambda
type: tcp
host: 192.168.1.120
port: 502
sensors:
- name: Lambda Außentemperatur
address: 2
input_type: holding
device_address: 1
data_type: int16
scale: 0.1
precision: 1
unit_of_measurement: "°C"
device_class: temperature
state_class: measurement
- name: Lambda Vorlauf Wärmepumpe
address: 1004
input_type: holding
device_address: 1
data_type: int16
scale: 0.01
precision: 2
unit_of_measurement: "°C"
device_class: temperature
state_class: measurement
- name: Lambda Stromaufnahme Verdichter
address: 1012
input_type: holding
device_address: 1
data_type: int16
unit_of_measurement: "W"
device_class: power
state_class: measurement
input_type: holding ist bei Home Assistant ohnehin der Standard und trifft genau den Funktionscode 0x03, den Lambda verlangt. Die IP-Adresse ist ein Platzhalter, Ihre steht im Router oder im Regler.
Beim Schreiben wird es heikler. Lambda akzeptiert nur 0x10. Home Assistant ruft laut Dokumentation bei einem Integer als Wert write_register (Funktionscode 06) auf, bei einer Liste mit einem Wert dagegen write_registers (Funktionscode 16). Wer also etwa den Heizkreis-Vorlauf auf 5X05 schreibt, muss den Wert als Liste übergeben, auch wenn es nur eine Zahl ist. Wer das übersieht, bekommt statt einer funktionierenden Automation eine Fehlermeldung im Log. Die Aktion modbus.write_register beschreibt die Dokumentation als Schreibzugriff auf „one or more Modbus holding registers“.
Register, die in der Praxis stolpern lassen
Zwei Stellen aus den Quellen, an denen Theorie und Anlage auseinandergehen.
32-Bit-Werte. Die elektrische Energieaufnahme (1020 und 1021) und die thermische Energieabgabe (1022 und 1023) kommen als INT32 in Wh, verteilt auf je zwei Register. In welcher Reihenfolge die beiden Hälften kommen, hängt von Gerät und Firmware ab. Die Dokumentation der HACS-Integration beschreibt es als häufigste Ursache für „völlig falsche, oft unrealistisch hohe oder niedrige Werte“. Seit V2.7.0 setzt die Integration die Reihenfolge anhand der Firmware vor (für V1.1.0-3K und V0.0.10-3K „low_first“), ein manueller Wert in der lambda_wp_config.yaml überschreibt das. Ralf Winters YAML hat dafür die auskommentierte Zeile swap: word bei beiden Energie-Sensoren: einkommentieren, wenn der Wert nicht stimmt.
Nicht belegte Register. Im GitHub-Diskussionsstrang #35 des Winter-Repositories hat Nutzer thecem im August 2025 an einer Anlage mit Firmware V0.0.8-3K beziehungsweise V1.1.0 alle Register durchprobiert. Einige im Dokument geführte Register waren nicht vorhanden, andere lieferten Platzhalterwerte: 62536 auf 5005, 32768 auf Registern, die nichts messen. 62536 ist als vorzeichenbehaftete Zahl gelesen −3000, bei Skalierung 0,1 also −300 Grad. 32768 ist 0x8000. Home Assistant kennt dafür nan_value, das einen solchen Wert als „unbekannt“ behandelt, auch als Hex-String wie 0x8000. Das ist eine Einschätzung, keine Empfehlung aus einer der Quellen: Wer lieber „unbekannt“ als −300 Grad im Verlauf sieht, setzt es bei Sensoren, die auf Ihrer Anlage nichts messen. Die HACS-Integration löst das anders und bietet disabled_registers in ihrer Konfigurationsdatei an, um fehlerhafte Adressen abzuschalten.
Dazu kommt ein weiterer Fund aus derselben Diskussion: Neben den dokumentierten Registern fand thecem weitere im Bereich 1024 bis 1033 und 1050 bis 1060, die im Lambda-Dokument nicht stehen. Die Bedeutung hat er selbst aus Wertemustern vermutet, die Tabelle kennzeichnet sie als Annahme. Für eine Konfiguration, die Bestand haben soll, gilt deshalb dieselbe Regel wie bei allen Modbus-Anlagen: Aufs Lambda-Dokument bauen, nicht auf Vermutungen.
PV-Überschuss und E-Manager
Hier unterscheidet sich Lambda am stärksten von anderen Herstellern. Der Regler hat einen eigenen E-Manager, und er will den Überschuss nicht abholen, sondern zugeschickt bekommen.
Das Lambda-Dokument beschreibt es in Abschnitt 4.3: Über Register 0102 lässt sich ein am Netzübergabepunkt gemessener Leistungswert (saldierter Überschuss oder Einspeisung) übermitteln. Zusätzlich muss die Verarbeitung auf dem Regler aktiviert werden: auf der Startseite den E-Manager öffnen, als Datenquelle „Modbus Client“ wählen, den Rest ähnlich wie beim Lambda-Smart-Meter einstellen. Ohne diesen Schritt landet der Wert im Register und geschieht nichts.
Die HACS-Integration übernimmt das Schreiben. Laut Dokumentation (Stand 4. August 2026) fragt sie einen Leistungssensor ab, rechnet kW in W um und schreibt ihn alle neun Sekunden auf Register 102. Drei Dinge daran sollte man vorher wissen:
- Die Option lässt sich nur mit höherem Zugriffslevel aktivieren und muss laut Dokumentation durch den Heizungsbauer eingestellt werden.
- Bleiben die Werte einige Minuten aus, erzeugt die Lambda einen Fehler. Die Dokumentation rät deshalb, die Option auch am Regler zu deaktivieren, wenn die Integration nicht mehr läuft.
- Liefert Ihre PV-Anlage den Überschuss als negative Zahl, soll ein Template-Sensor in Home Assistant positive Werte daraus machen. Das Lambda-Dokument selbst spricht von einem „saldierten“ Wert und führt 0102 in der Tabelle als UINT16. Was an Ihrem Regler als Überschuss ankommt, sehen Sie laut Integrationsdokumentation in der Lambda-Oberfläche.
Wer Lambda-Wärmepumpe und SG-Ready-Kontakte vergleichen will, findet die Grundlagen in Wärmepumpe in Home Assistant einbinden. Die Lambda-Schnittstelle schickt Leistung statt Zustandsstufen, ist also feiner als zwei Kontakte, aber auch aufwendiger.
Energie-Dashboard
Das Energie-Dashboard von Home Assistant verlangt für Verbrauchssensoren device_class: energy und state_class: total oder total_increasing. Genau so ist die Lambda-Energie in Ralf Winters YAML angelegt: Wh, Energy, total_increasing, bei den Registern 1020 und 1022.
Es gibt zwei Wege, und sie liefern Unterschiedliches:
- Mit der Integration bekommen Sie zusätzlich Energiesensoren je Betriebsart (Heizen, Warmwasser, Kühlen, Abtauen, bei Strom auch Standby) für Gesamt, Tag, Monat und Jahr. Die Dokumentation sagt ausdrücklich, dass diese Werte in der Integration berechnet werden, nicht aus der Lambda ausgelesen, und deshalb von den Werten im Regler abweichen können. Tages-, Monats- und Jahreswerte müssen sich erst aufbauen. Offsets für die Gesamtwerte gehören in kWh in die
lambda_wp_config.yaml. - Als Stromquelle lässt sich ein externer Zähler eintragen, die Dokumentation nennt als Beispiel einen Shelly 3EM vor der Wärmepumpe. Wer die Wärmepumpe ohnehin hinter einem eigenen Zähler hängen hat, kann diesen Wert nehmen statt der berechneten Lambda-Statistik. Wie das Dashboard grundsätzlich eingerichtet wird, steht in Home Assistant Energy-Dashboard einrichten.
Die Heizkurve nicht vergessen
Beide Wege können den Offset auf 5X50 schreiben (laut Lambda-Dokument Bereich −10 bis +10 K) oder den Vorlauf über 5X05 vorgeben. Wer das automatisieren will, sollte die Kurve vorher verstehen. Heizkurve in Home Assistant darstellen und anpassen zeigt, wie sich Auswirkungen sichtbar machen lassen. Als Vergleichsgröße taugt 5X07, die von der Lambda nach Heizkurve berechnete Soll-Vorlauftemperatur.
Wer eine andere Marke im Haus hat, vergleicht mit dem Aufbau bei LG Therma V in Home Assistant. Dort stritten zwei Registerkarten um dieselbe Anlage. Bei Lambda gibt es dagegen eine herstellerseitige Tabelle als Referenz.
Welcher Weg zu welchem Setup passt
- Standardanlage mit Heizkreis, Warmwasser, vielleicht PV, und Sie wollen schnell Ergebnisse. HACS-Integration von GuidoJeuken-6512. Modulerkennung, Heizkurve, COP und Energiesensoren sind eingebaut, und es gibt die größte Nutzerschaft.
- Sie wollen nur lesen, ein paar Sensoren, keine Zusatzkomponente. Modbus-YAML nach Ralf Winters Vorlage, zusammengestrichen auf die Register, die Ihre Anlage wirklich hat. Es hängt nur noch am Home-Assistant-Core, nicht an einem fremden Repository.
- Sie wollen PV-Überschuss einspeisen. Die Integration übernimmt das periodische Schreiben samt Einheiten. Per YAML geht es auch, aber Sie bauen die Wiederholung selbst und tragen das Risiko der Störmeldung.
- Mehrere Wärmepumpen, Puffer, Solarthermie. Die Integration erkennt Module automatisch. Per YAML duplizieren Sie Blöcke mit angepasstem Subindex, Winters Datei weist selbst darauf hin, beim Boiler die zweite Ziffer der Adresse um 1 zu erhöhen.
- Die Werte stimmen nicht. Erst die Registerreihenfolge der 32-Bit-Werte, dann die Firmware-Auswahl, dann
disabled_registersbeziehungsweisenan_value.
Unser Fazit
Positiv an der Lambda-Schnittstelle ist, dass der Hersteller sie selbst dokumentiert. Das macht die Wahl bei den Integrationen nicht einfacher: Die Integration von GuidoJeuken-6512 ist offensichtlich der Weg, den die Community gewählt hat, 334 Installationen gegen 14 bei der Alternative. Sie hat dafür einen Preis, nämlich die Abhängigkeit von jedem HA-Update. Der Fall mit HA 2026.9 hat das gezeigt, und er ging gut aus, weil der Maintainer schnell war. Wer das nicht möchte, schreibt sich 15 bis 20 Register selbst in die YAML und hat in ein paar Jahren immer noch dieselbe Konfiguration. Beides ist vernünftig. Nur beim Schreiben von PV-Werten sollte man nicht sparen: Dort ist die Integration der bequemere und der sicherere Weg.
Quellen (Stand: 31. Oktober 2026)
- Lambda Wärmepumpen GmbH, Modbus-Protokoll Version 1.0 (2026): lambda-wp.com, Downloads, Regler
- GitHub, GuidoJeuken-6512/lambda_heat_pumps: README, Release-Notizen V2.8.4 bis V2.8.6, Dokumentation (PV-Überschuss, Energieverbrauchsberechnung, FAQ falsche Sensorwerte), manifest.json
- Home Assistant Analytics, Custom Integrations: analytics.home-assistant.io/custom_integrations.json (Abruf 31.10.2026)
- GitHub, route662/Lambda-Heatpump: README, Releases, manifest.json
- GitHub, RalfWinter/lambda-heatpump-modbus-tcp-HA: README, YAML-Konfiguration, Discussion #35 (thecem, 16.08.2025)
- Home Assistant Dokumentation 2026.10.4: Modbus (home-assistant.io/integrations/modbus), Energy FAQ (home-assistant.io/docs/energy/faq)
- Guido, Lambda Wärmepumpen Integration für Home Assistant, homeassistant.com.de (Blog des Integrationsautors, nur als Sekundärquelle)