lambda_wp_config.yaml Konfiguration¶

Die lambda_wp_config.yaml Datei ist die Hauptkonfigurationsdatei für erweiterte Einstellungen der Lambda Heat Pumps Integration. Sie ermöglicht es, Sensoreinstellungen, Energieverbrauchserfassung und Modbus-Kommunikationsparameter anzupassen.

Datei-Location¶

Die Konfigurationsdatei befindet sich im folgenden Verzeichnis:

/config/lambda_wp_config.yaml

Hinweis: Falls die Datei nicht existiert, wird sie beim ersten Start der Integration automatisch erstellt.

Datei bearbeiten¶

Über Home Assistant¶

1. Datei-Editor verwenden:
2. Installieren Sie das "File editor" oder "Studio Code Server" Add-on in Home Assistant
3. Öffnen Sie die Datei /config/lambda_wp_config.yaml
4. Bearbeiten Sie die Datei

5. Speichern Sie die Änderungen

6. SSH/Terminal-Zugriff:

7. Verwenden Sie SSH oder Terminal-Zugriff zu Ihrem Home Assistant
8. Navigieren Sie zum Verzeichnis /config/
9. Bearbeiten Sie die Datei mit einem Texteditor (z.B. nano oder vi)

YAML-Syntax beachten¶

⚠️ WICHTIG: YAML ist sehr empfindlich gegenüber Einrückungen und Syntax:

• Einrückungen: Verwenden Sie Leerzeichen (keine Tabs)
• Doppelpunkt: Nach jedem Schlüssel muss ein Doppelpunkt (:) folgen
• Bindestriche: Für Listen verwenden Sie Bindestriche (-)
• Anführungszeichen: Verwenden Sie Anführungszeichen für Strings mit Sonderzeichen

Tipp: Verwenden Sie einen YAML-Validator, um Syntaxfehler zu vermeiden.

Konfigurationsoptionen¶

1. Deaktivierte Register¶

Deaktiviert spezifische Modbus-Register, die nicht benötigt werden oder Probleme verursachen.

disabled_registers:
  - 2004  # boil1_actual_circulation_temp
  - 100000  # Beispiel deaktiviertes Register

Wann verwenden? - Register verursacht Fehler im Log - Register wird von Ihrer Firmware-Version nicht unterstützt - Register wird nicht benötigt und reduziert Modbus-Traffic z.B. nicht vorhandene Zirkulationspumpe

Beispiel:

disabled_registers:
  - 2004  # Kessel-Zirkulationstemperatur (nicht verfügbar)

2. Sensor-Name-Überschreibungen¶

Überschreibt Standard-Sensornamen für bessere Lesbarkeit oder Lokalisierung. Bitte sehr vorsichtig mit dieser Option sein und auf jeden Fall vorher ein Backup von Home Assistant machen Um hsitorische Daten anderer Sensoren zu übernehmen ist dieser Schritt besser geeignet: Historische Daten übernehmen

sensors_names_override:
  - id: hp1_flow_temp
    override_name: "Wohnzimmer Temperatur"
  - id: hp1_return_temp
    override_name: "Rücklauf Temperatur"

Wann verwenden? - bei Migration von einer anderen Lösung zu dieser Integration um historische Daten der alten Sensoren zu erhalten

Beispiel:

sensors_names_override:
  - id: hp1_flow_temp
    override_name: "Vorlauf Wohnzimmer"
  - id: hp1_return_temp
    override_name: "Rücklauf Wohnzimmer"
  - id: hp1_operating_state
    override_name: "Betriebszustand"

3. Cycling-Zähler-Offsets¶

Fügt Offsets zu Cycling-Zählern für Total-Sensoren hinzu. Nützlich beim Austausch von Wärmepumpen oder Zurücksetzen von Zählern.

cycling_offsets:
  hp1:
    heating_cycling_total: 1500    # HP1 hatte bereits 1500 Heizungszyklen
    hot_water_cycling_total: 800   # HP1 hatte bereits 800 Warmwasserzyklen
    cooling_cycling_total: 200     # HP1 hatte bereits 200 Kühlungszyklen
    defrost_cycling_total: 50      # HP1 hatte bereits 50 Abtauzyklen
    compressor_start_cycling_total: 5000  # HP1 hatte bereits 5000 Kompressor-Starts
  hp2:
    heating_cycling_total: 0       # HP2 startet frisch
    hot_water_cycling_total: 0     # HP2 startet frisch
    cooling_cycling_total: 0       # HP2 startet frisch
    defrost_cycling_total: 0       # HP2 startet frisch
    compressor_start_cycling_total: 0     # HP2 startet frisch

Wann verwenden? - Wärmepumpen-Austausch: Zählerstand der vorherigen Pumpe hinzufügen - Zähler-Reset: Manuelle Resets kompensieren - Historische Daten erhalten: Kontinuität der Daten beibehalten

Beispiel-Szenario: Wärmepumpen-Austausch

cycling_offsets:
  hp1:
    heating_cycling_total: 2500    # Alte Pumpe hatte 2500 Heizungszyklen
    hot_water_cycling_total: 1200  # Alte Pumpe hatte 1200 Warmwasserzyklen
    cooling_cycling_total: 300     # Alte Pumpe hatte 300 Kühlungszyklen
    defrost_cycling_total: 80      # Alte Pumpe hatte 80 Abtauzyklen

Weitere Informationen: Historische Daten übernehmen

4. Energieverbrauchs-Sensoren¶

Definiert welche Sensoren Basis-Energieverbrauchsdaten liefern. Standardmäßig verwendet die Integration die Lambda-eigenen Sensoren, aber Sie können externe Energiezähler (z.B. Shelly3EM) verwenden. Die Option sollte nur verwendet werden, wenn ein anderer Sensor genutzt wird. Der Lambda eigene Sensor wird automatisch verwendet.

energy_consumption_sensors:
  hp1:
    sensor_entity_id: "sensor.shelly_lambda_gesamt_leistung"  # Externer Verbrauchssensor
  hp2:
    sensor_entity_id: "sensor.lambda_wp_verbrauch2"  # Zweiter Verbrauchssensor

Standard-Sensoren: - HP1: sensor.eu08l_hp1_compressor_power_consumption_accumulated - HP2: sensor.eu08l_hp2_compressor_power_consumption_accumulated - HP3: sensor.eu08l_hp3_compressor_power_consumption_accumulated

Hinweis: Diese Sensoren müssen Energieverbrauchsdaten in Wh oder kWh liefern. Das System konvertiert automatisch zu kWh für die Berechnungen.

Beispiel: Externer Shelly3EM Sensor

energy_consumption_sensors:
  hp1:
    sensor_entity_id: "sensor.shelly3em_channel_1_energy"  # Shelly3EM Kanal 1

Weitere Informationen: Stromverbrauchsberechnung

5. Energieverbrauchs-Offsets¶

Fügt Offsets zu Energieverbrauchswerten für Total-Sensoren hinzu. Nützlich beim Austausch von Wärmepumpen oder Zurücksetzen von Zählern.

⚠️ WICHTIG: Alle Werte müssen in kWh angegeben werden!

energy_consumption_offsets:
  hp1:
    heating_energy_total: 0.0       # kWh Offset für HP1 Heizungs-Total
    hot_water_energy_total: 0.0     # kWh Offset für HP1 Warmwasser-Total
    cooling_energy_total: 0.0       # kWh Offset für HP1 Kühlungs-Total
    defrost_energy_total: 0.0       # kWh Offset für HP1 Abtau-Total
  hp2:
    heating_energy_total: 150.5     # Beispiel: HP2 verbrauchte bereits 150.5 kWh Heizung
    hot_water_energy_total: 45.25   # Beispiel: HP2 verbrauchte bereits 45.25 kWh Warmwasser
    cooling_energy_total: 12.8      # Beispiel: HP2 verbrauchte bereits 12.8 kWh Kühlung
    defrost_energy_total: 3.1       # Beispiel: HP2 verbrauchte bereits 3.1 kWh Abtau

Wann verwenden? - Wärmepumpen-Austausch: Energieverbrauch der vorherigen Pumpe hinzufügen - Zähler-Reset: Manuelle Resets kompensieren - Historische Daten erhalten: Energieverbrauchshistorie beibehalten

Beispiel-Szenario: Wärmepumpen-Austausch

energy_consumption_offsets:
  hp1:
    heating_energy_total: 5000.0    # Alte Pumpe verbrauchte 5000 kWh Heizung
    hot_water_energy_total: 2000.0  # Alte Pumpe verbrauchte 2000 kWh Warmwasser
    cooling_energy_total: 500.0     # Alte Pumpe verbrauchte 500 kWh Kühlung
    defrost_energy_total: 150.0     # Alte Pumpe verbrauchte 150 kWh Abtau

Hinweis: - Alle Werte müssen in kWh angegeben werden - Verwenden Sie Punkt (.) als Dezimaltrennzeichen in YAML - Offsets werden nur auf TOTAL-Sensoren angewendet, nicht auf Daily/Monthly/Yearly Sensoren

Weitere Informationen: Historische Daten übernehmen

6. Modbus-Konfiguration¶

Konfiguriert Modbus-Kommunikationsparameter für 32-Bit-Register.

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"

Optionen: - "high_first": Höherwertiges Register zuerst (Standard für die meisten Lambda-Modelle) - "low_first": Niedrigwertiges Register zuerst (für bestimmte Lambda-Modelle oder Firmware-Versionen)

Wann verwenden? - Falsche Werte in 32-Bit-Sensoren (z.B. Energieverbrauchssensoren) - Nach Firmware-Update, wenn Sensoren falsche Werte anzeigen - Bei bestimmten Lambda-Modellen, die eine andere Register-Reihenfolge benötigen

Beispiel: Falsche Werte korrigieren

modbus:
  int32_register_order: "low_first"  # Wechsel von "high_first" zu "low_first"

Hinweis: - Alte Config mit int32_byte_order oder alten Werten (big/little) wird automatisch erkannt und migriert - Nach Änderung Home Assistant neu starten

Weitere Informationen: Anpassungen der Sensoren abhängig von der Firmware

Vollständiges Beispiel¶

# Problematische Register deaktivieren
disabled_registers:
  - 2004  # boil1_actual_circulation_temp
  - 100000

# Sensornamen überschreiben 
sensors_names_override:
  - id: hp1_flow_temp
    override_name: "Wohnzimmer Temperatur"
  - id: hp1_return_temp
    override_name: "Rücklauf Temperatur"

# Cycling-Zähler-Offsets
cycling_offsets:
  hp1:
    heating_cycling_total: 0
    hot_water_cycling_total: 0
    cooling_cycling_total: 0
    defrost_cycling_total: 0
    compressor_start_cycling_total: 0
  hp2:
    heating_cycling_total: 1500
    hot_water_cycling_total: 800
    cooling_cycling_total: 200
    defrost_cycling_total: 50
    compressor_start_cycling_total: 5000

# Energieverbrauchs-Sensor-Konfiguration
energy_consumption_sensors:
  hp1:
    sensor_entity_id: "sensor.eu08l_hp1_compressor_power_consumption_accumulated"
  hp2:
    sensor_entity_id: "sensor.shelly_lambda_gesamt_leistung"  # Externer Sensor

# Energieverbrauchs-Offsets
energy_consumption_offsets:
  hp1:
    heating_energy_total: 0
    hot_water_energy_total: 0
    cooling_energy_total: 0
    defrost_energy_total: 0
  hp2:
    heating_energy_total: 150.5
    hot_water_energy_total: 45.2
    cooling_energy_total: 12.8
    defrost_energy_total: 3.1

# Modbus-Konfiguration
modbus:
  int32_register_order: "high_first"  # oder "low_first" für einige Geräte

Anwendung der Konfiguration¶

Schritt 1: Datei bearbeiten¶

1. Datei öffnen:
2. Öffnen Sie /config/lambda_heat_pumps/lambda_wp_config.yaml

3. Falls die Datei nicht existiert, wird sie beim nächsten Start automatisch erstellt

4. Konfiguration hinzufügen:

5. Fügen Sie die gewünschten Konfigurationsabschnitte hinzu
6. Verwenden Sie die Beispiele oben als Vorlage

7. Achten Sie auf korrekte YAML-Syntax

8. Datei speichern:

9. Speichern Sie die Datei
10. Überprüfen Sie die YAML-Syntax (z.B. mit einem Online-YAML-Validator)

Schritt 2: Home Assistant neu starten¶

1. Home Assistant neu starten:
2. Starten Sie Home Assistant vollständig neu

3. Die Konfiguration wird beim Start automatisch geladen

4. Überprüfen Sie die Logs:

5. Überprüfen Sie die Home Assistant Logs auf Konfigurationsfehler

6. Die Integration validiert die Konfiguration beim Start

7. Überprüfen Sie die Sensoren:

8. Überprüfen Sie, ob die Änderungen korrekt angewendet wurden
9. Überprüfen Sie die Sensor-Namen, Offsets, etc.

Häufige Probleme¶

"Ungültige YAML-Syntax"¶

Ursache: Syntaxfehler in der YAML-Datei

Lösung: - Verwenden Sie einen YAML-Validator zur Syntaxprüfung - Überprüfen Sie Einrückungen (nur Leerzeichen, keine Tabs) - Überprüfen Sie Doppelpunkte nach Schlüsseln - Überprüfen Sie Anführungszeichen für Strings

Beispiel-Fehler:

"Sensor nicht gefunden"¶

Ursache: Der konfigurierte Sensor existiert nicht oder ist nicht verfügbar

Lösung: - Überprüfen Sie, ob der Sensor in Home Assistant existiert (Dev-Tools) - Überprüfen Sie die Entity-ID (Groß-/Kleinschreibung beachten) - Überprüfen Sie die Logs auf Fehlermeldungen

Validierung¶

Die Integration validiert die Konfiguration automatisch beim Start:

• YAML-Syntax: Überprüfung der Datei-Syntax
• Sensor-Existenz: Überprüfung, ob konfigurierte Sensoren existieren
• Werte-Bereiche: Überprüfung von Temperatur- und Offset-Werten
• Log-Meldungen: Alle Probleme werden in den Logs protokolliert

Tipp: Überprüfen Sie die Home Assistant Logs nach jedem Neustart, um Konfigurationsfehler frühzeitig zu erkennen.

Nächste Schritte¶

Nach der Konfiguration der lambda_wp_config.yaml können Sie:

• Historische Daten übernehmen bei Wärmepumpenwechsel
• Stromverbrauchsberechnung mit externen Sensoren einrichten
• Anpassungen der Sensoren abhängig von der Firmware vornehmen