Für die deutsche Anleitung bitte weiter unten schauen.
Lambda Heat Pumps is a Home Assistant custom integration for Lambda heat pumps via Modbus/TCP.
HACS Installation:
- Install HACS (if not already done)
- Search for "Lambda heat pumps" and download the integration
- Restart Hoem assistant
- Go to Settings -> Devices and services -> Add integration and search for "Lambda Heat Pumps".
When setting up the integration, you will need to provide:
- Name: A name for your Lambda Heat Pump installation (e.g., "EU08L")
- Host: IP address or hostname of your Lambda controller
- Port: Modbus TCP port (default: 502)
- Slave ID: Modbus Slave ID (default: 1)
- Firmware Version: Select your Lambda controller's firmware version
- Everything else will be configured automatically.
The integration features automatic module detection and smart configuration:
- Auto-Detection: Automatically detects available modules (heat pumps, boilers, buffers, solar, heating circuits)
- Dynamic Entity Creation: Creates sensors and entities based on detected hardware
- Smart Defaults: Applies optimal settings for your specific Lambda configuration
- Configuration Validation: Prevents duplicate configurations and validates existing connections
The firmware version is only important to decide which sensors are available.
To find the firmware version follow this from the main screen:
- Click on the heat pump
- Click on the "i" button on the left
- Click on the button on the right that looks like a computer chip (last one)
After initial setup, you can modify additional settings in the integration options:
- Go to Configuration → Integrations
- Find your Lambda Heat Pump integration and click "Configure"
- Here you can adjust:
- Hot water temperature range (min/max)
- Heating circuit temperature range (min/max)
- Temperature step size
- Room thermostat control (using external sensors)
- PV surplus control for solar power integration
Features:
- Full Modbus/TCP Support: Complete support for Lambda heat pumps via Modbus/TCP
- Automatic Module Detection: Auto-detects available modules and creates appropriate entities
- Cycling Sensors: Comprehensive cycling counters for all operating modes (heating, hot water, cooling, defrost)
- Total, daily, yesterday, 2h, and 4h cycling sensors
- Automatic daily reset at midnight
- Configurable cycling offsets for counter adjustments
- Energy Consumption Sensors: Detailed energy tracking by operating mode
- Heating, hot water, cooling, and defrost energy consumption
- Monthly and yearly energy consumption tracking
- Configurable source sensors with automatic unit conversion (Wh/kWh/MWh)
- Smart sensor change detection to prevent incorrect calculations
- Heating Curve Configuration: Number entities for easy adjustment of heating curve support points
- Cold point (-22°C), mid point (0°C), and warm point (+22°C) configuration
- Flow line offset adjustment for fine-tuning the heating curve
- Bidirectional Modbus synchronization (reads from and writes to Modbus registers)
- Room Thermostat Control: External sensor integration for precise temperature control
- PV Surplus Control: Solar power integration for optimal energy usage
- Advanced Configuration: YAML-based configuration with debug logging
- Register Order Configuration: Configurable register order for 32-bit values from multiple 16-bit registers
Documentation:
Support:
Lambda Heat Pumps ist eine benutzerdefinierte Komponente für Home Assistant, die eine Verbindung zu Lambda Wärmepumpen über das Modbus TCP/RTU-Protokoll herstellt.
HACS Installation:
- HACS installieren (falls noch nicht geschehen)
- Custom Repository hinzufügen:
- HACS → Integrations → suche nach "lambda Heat Pumps"
- Integration herunterladen:
- „Lambda Heat Pumps“ auswählen und installieren
- Home Assistant neu starten
Bei der Einrichtung müssen Sie Folgendes angeben:
- Name: Ein Name für Ihre Lambda-Wärmepumpe (z. B. „EU08L")
- Host: IP-Adresse oder Hostname Ihres Lambda-Controllers
- Port: Modbus-TCP-Port (Standard: 502)
- Slave ID: Modbus-Slave-ID (Standard: 1)
- Firmware-Version: Firmware-Version Ihres Lambda-Controllers auswählen
- Alles andere wird automatisch konfiguriert
Die Integration bietet automatische Modulerkennung und intelligente Konfiguration:
- Auto-Detection: Erkennt automatisch verfügbare Module (Wärmepumpen, Kessel, Puffer, Solar, Heizkreise)
- Dynamische Entity-Erstellung: Erstellt Sensoren und Entities basierend auf erkanntem Hardware
- Intelligente Standardeinstellungen: Wendet optimale Einstellungen für Ihre spezifische Lambda-Konfiguration an
- Konfigurationsvalidierung: Verhindert doppelte Konfigurationen und validiert bestehende Verbindungen
Die Firmware-Version is nur wichtig um zu entscheiden welche Sensoren verfügbar sind.
Um die Firmware-Version zu finden, folgen Sie diesen Schritten am Hauptbildschirm:
- Klicken Sie auf die Wärmepumpe
- Klicken Sie auf die "i" Taste auf der linken Seite
- Klicken Sie auf die Taste auf der rechten Seite, die wie ein Computerchip aussieht (letzte Taste)
Nach der Ersteinrichtung können Sie zusätzliche Einstellungen in den Integrationsoptionen ändern:
- Gehen Sie zu „Konfiguration“ → „Integrationen“.
- Suchen Sie Ihre Lambda-Wärmepumpen-Integration und klicken Sie auf „Konfigurieren“.
- Hier können Sie Folgendes anpassen:
- Warmwassertemperaturbereich (min./max.)
- Heizkreistemperaturbereich (min./max.)
- Temperaturstufengröße
- Raumthermostatsteuerung (mit externen Sensoren)
- PV Überschuss zur Heizkurvenanhebung der Lambda
Die Integration bietet Number-Entities zur einfachen Konfiguration der Heizkurven-Parameter:
Für jeden Heizkreis (HC1, HC2, etc.) werden automatisch folgende Number-Entities erstellt:
-
Heizkurven-Stützpunkte:
number.*_hc1_heating_curve_cold_outside_temp- Kaltpunkt bei -22°Cnumber.*_hc1_heating_curve_mid_outside_temp- Mittelpunkt bei 0°Cnumber.*_hc1_heating_curve_warm_outside_temp- Warmpunkt bei +22°C
-
Vorlauf-Offset:
number.*_hc1_flow_line_offset_temperature- Vorlauf-Offset-Temperatur (-10°C bis +10°C)- Bidirektionale Modbus-Synchronisation: Liest den aktuellen Wert aus dem Modbus-Register und schreibt Änderungen direkt zurück
-
Raumthermostat-Parameter (wenn aktiviert):
number.*_hc1_room_thermostat_offset- Raumtemperatur-Offsetnumber.*_hc1_room_thermostat_factor- Raumtemperatur-Faktor
Die Number-Entities erscheinen automatisch in der Device-Konfiguration jedes Heizkreises:
- In Home Assistant: Gehen Sie zu Einstellungen → Geräte & Dienste
- Wählen Sie Ihren Heizkreis: Klicken Sie auf den entsprechenden Heizkreis (z.B. "HC1")
- Number-Entities finden: Scrollen Sie zu den Number-Entities
- Wert anpassen: Klicken Sie auf die gewünschte Entity und passen Sie den Wert an
Der Vorlauf-Offset ermöglicht eine feine Anpassung der berechneten Heizkurven-Vorlauftemperatur:
- Bereich: -10.0°C bis +10.0°C
- Schrittweite: 0.1°C
- Modbus-Register: Register 50 (relativ zur Base-Adresse des Heizkreises)
- Automatische Synchronisation: Der Wert wird automatisch aus dem Modbus-Register gelesen und bei Änderungen direkt zurückgeschrieben
Beispiel: Wenn die berechnete Heizkurven-Temperatur 35.0°C beträgt und Sie einen Offset von +2.0°C setzen, wird die tatsächliche Vorlauftemperatur auf 37.0°C erhöht.
Die drei Stützpunkte definieren die Heizkurve:
- Kaltpunkt (-22°C): Temperatur bei sehr kalten Außentemperaturen
- Mittelpunkt (0°C): Temperatur bei mittleren Außentemperaturen
- Warmpunkt (+22°C): Temperatur bei warmen Außentemperaturen
Die Integration interpoliert linear zwischen diesen Punkten basierend auf der aktuellen Außentemperatur.
Die Integration bietet umfassende Cycling-Sensoren und Energieverbrauchssensoren für detaillierte Überwachung Ihrer Lambda-Wärmepumpe:
- Betriebsmodi: Heizen, Warmwasser, Kühlen, Abtauen
- Zeiträume: Total, Täglich, Gestern, 2h, 4h
- Automatischer Reset: Tägliche Sensoren werden um Mitternacht zurückgesetzt
- Offset-Konfiguration: Anpassbare Zählerstände für Wärmepumpenwechsel
- Betriebsmodi: Heizen, Warmwasser, Kühlen, Abtauen
- Zeiträume: Täglich, Monatlich, Jährlich
- Konfigurierbare Quellsensoren: Beliebige Energiezähler als Datenquelle
- Automatische Einheitenkonvertierung: Wh/kWh/MWh
- Sensor-Wechsel-Erkennung: Intelligente Behandlung von Sensor-Änderungen
Die Sensoren werden automatisch erstellt und können über lambda_wp_config.yaml konfiguriert werden:
energy_consumption_sensors:
hp1:
sensor_entity_id: sensor.your_energy_meter
cycling_offsets:
hp1:
heating_cycling_total: 100
hot_water_cycling_total: 50
# Register-Reihenfolge für 32-Bit-Register (int32-Sensoren)
modbus:
int32_register_order: "high_first" # "high_first" oder "low_first" - Standard: "high_first"Die Integration unterstützt konfigurierbare Register-Reihenfolge für 32-Bit-Werte aus mehreren 16-Bit-Registern. Dies bezieht sich auf die Reihenfolge der Register (Register/Word Order) bei der Kombination mehrerer Register zu einem 32-Bit-Wert.
In der lambda_wp_config.yaml können Sie die Register-Reihenfolge festlegen:
# Modbus-Konfiguration
modbus:
# Register-Reihenfolge für 32-Bit-Register (int32-Sensoren)
# "high_first" = Höherwertiges Register zuerst (Standard)
# "low_first" = Niedrigwertiges Register zuerst
int32_register_order: "high_first" # oder "low_first"- "high_first": Standard für die meisten Lambda-Modelle (höherwertiges Register zuerst)
- "low_first": Erforderlich für bestimmte Lambda-Modelle oder Firmware-Versionen (niedrigwertiges Register zuerst)
- Rückwärtskompatibilität: Alte Config mit
int32_byte_orderoder alten Werten (big/little) wird automatisch erkannt und migriert
Falls Sie falsche Werte in den Sensoren sehen, versuchen Sie die andere Register-Reihenfolge-Einstellung.
Die Integration unterstützt die Steuerung der Wärmepumpe basierend auf verfügbarem PV-Überschuss. Diese Funktion ermöglicht es der Wärmepumpe, überschüssigen Solarstrom zu nutzen.
- PV-Überschuss-Erkennung: Automatische Überwachung der PV-Leistung
- Modbus-Register 102: Schreiben der aktuellen PV-Leistung in Watt
- Konfigurierbare Sensoren: Auswahl beliebiger PV-Leistungssensoren
- Automatische Aktualisierung: Regelmäßiges Schreiben der PV-Daten (standardmäßig alle 10 Sekunden)
- Einheitenkonvertierung: Automatische Umrechnung von kW in W
- PV-Überschuss aktivieren: In den Integration-Optionen "PV-Überschuss" aktivieren
- PV-Sensor auswählen: Einen PV-Leistungssensor auswählen (z.B. Template-Sensor für PV-Überschuss)
- Intervall anpassen: Das Schreibintervall in den Optionen konfigurieren
- Watt-Sensoren: Direkte Verwendung (z.B. 1500 W)
- Kilowatt-Sensoren: Automatische Umrechnung (z.B. 1.5 kW → 1500 W)
- Template-Sensoren: Für komplexe PV-Überschuss-Berechnungen
- Register 102: E-Manager Actual Power (globales Register)
- Wertebereich: -32768 bis 32767 (int16)
- Einheit: Watt
The integration provides comprehensive Cycling Sensors and Energy Consumption Sensors for detailed monitoring of your Lambda heat pump:
- Operating Modes: Heating, Hot Water, Cooling, Defrost
- Time Periods: Total, Daily, Yesterday, 2h, 4h
- Automatic Reset: Daily sensors reset at midnight
- Offset Configuration: Adjustable counters for heat pump replacement
- Operating Modes: Heating, Hot Water, Cooling, Defrost
- Time Periods: Daily, Monthly, Yearly
- Configurable Source Sensors: Any energy meter as data source
- Automatic Unit Conversion: Wh/kWh/MWh
- Sensor Change Detection: Intelligent handling of sensor changes
Sensors are automatically created and can be configured via lambda_wp_config.yaml:
energy_consumption_sensors:
hp1:
sensor_entity_id: sensor.your_energy_meter
cycling_offsets:
hp1:
heating_cycling_total: 100
hot_water_cycling_total: 50
# Register order for 32-bit registers (int32 sensors)
modbus:
int32_register_order: "high_first" # "high_first" or "low_first" - Default: "high_first"The integration supports configurable register order for 32-bit values from multiple 16-bit registers. This refers to the order of registers (Register/Word Order) when combining multiple registers into a 32-bit value.
In the lambda_wp_config.yaml you can set the register order:
# Modbus configuration
modbus:
# Register order for 32-bit registers (int32 sensors)
# "high_first" = High-order register first (Default)
# "low_first" = Low-order register first
int32_register_order: "high_first" # or "low_first"- "high_first": Default for most Lambda models (high-order register first)
- "low_first": Required for certain Lambda models or firmware versions (low-order register first)
- Backward Compatibility: Old config with
int32_byte_orderor old values (big/little) is automatically detected and migrated
If you see incorrect values in the sensors, try the other register order setting.
The integration supports controlling the heat pump based on available PV surplus. This feature allows the heat pump to utilize excess solar power.
- PV Surplus Detection: Automatic monitoring of PV power output
- Modbus Register 102: Writing current PV power in watts
- Configurable Sensors: Selection of any PV power sensors
- Automatic Updates: Regular writing of PV data (default: every 10 seconds)
- Unit Conversion: Automatic conversion from kW to W
- Enable PV Surplus: Activate "PV Surplus" in integration options
- Select PV Sensor: Choose a PV power sensor (e.g., template sensor for PV surplus)
- Adjust Interval: Configure the write interval in options
- Watt Sensors: Direct usage (e.g., 1500 W)
- Kilowatt Sensors: Automatic conversion (e.g., 1.5 kW → 1500 W)
- Template Sensors: For complex PV surplus calculations
- Register 102: E-Manager Actual Power (global register)
- Value Range: -32768 to 32767 (int16)
- Unit: Watts
The integration provides Number entities for easy configuration of heating curve parameters:
For each heating circuit (HC1, HC2, etc.), the following Number entities are automatically created:
-
Heating Curve Support Points:
number.*_hc1_heating_curve_cold_outside_temp- Cold point at -22°Cnumber.*_hc1_heating_curve_mid_outside_temp- Mid point at 0°Cnumber.*_hc1_heating_curve_warm_outside_temp- Warm point at +22°C
-
Flow Line Offset:
number.*_hc1_flow_line_offset_temperature- Flow line offset temperature (-10°C to +10°C)- Bidirectional Modbus Synchronization: Reads current value from Modbus register and writes changes directly back
-
Room Thermostat Parameters (when enabled):
number.*_hc1_room_thermostat_offset- Room temperature offsetnumber.*_hc1_room_thermostat_factor- Room temperature factor
The Number entities automatically appear in the device configuration of each heating circuit:
- In Home Assistant: Go to Settings → Devices & Services
- Select Your Heating Circuit: Click on the corresponding heating circuit (e.g., "HC1")
- Find Number Entities: Scroll to the Number entities
- Adjust Value: Click on the desired entity and adjust the value
The Flow Line Offset allows fine-tuning of the calculated heating curve flow temperature:
- Range: -10.0°C to +10.0°C
- Step Size: 0.1°C
- Modbus Register: Register 50 (relative to the heating circuit's base address)
- Automatic Synchronization: The value is automatically read from the Modbus register and written back directly when changed
Example: If the calculated heating curve temperature is 35.0°C and you set an offset of +2.0°C, the actual flow temperature will be increased to 37.0°C.
The three support points define the heating curve:
- Cold Point (-22°C): Temperature at very cold outside temperatures
- Mid Point (0°C): Temperature at moderate outside temperatures
- Warm Point (+22°C): Temperature at warm outside temperatures
The integration linearly interpolates between these points based on the current outside temperature.
If you do not use HACS, you can install the integration manually:
-
Create the folder
/config/custom_componentson your Home Assistant server if it does not exist. -
If you have terminal access to your Home Assistant server:
cd /config/custom_components - Download the integration from: https://github.com/GuidoJeuken-6512/lambda_heat_pumps - Copy the entire folder `lambda_heat_pumps` into `/config/custom_components/` on your Home Assistant server.
-
Restart Home Assistant to activate the integration.
- Log-Analyse: Aktiviere Debug-Logging für detaillierte Fehlerausgabe
- Häufige Probleme: Siehe Abschnitt „Troubleshooting“ unten
- Support:
MIT License. Nutzung auf eigene Gefahr. Siehe LICENSE.
- Web Dokumentation
- Quick Start (DE)
- FAQ (DE)
- Entwickler-Guide
- Modbus Register (DE/EN), EN
- Troubleshooting
- HACS Publishing Guide
Siehe Releases für Änderungen und Breaking Changes.
Developed with ❤️ for the Home Assistant Community