Home Assistant + Stiebel Eltron LWZ R290: Modbus TCP vollständig einrichten

Die Stiebel Eltron LWZ R290 ist eine hervorragende Wärmepumpe — aber ihre Integration in Home Assistant ist alles andere als einfach. Nach stundenlanger Recherche, vielen fehlgeschlagenen Versuchen und direktem Austausch mit anderen Nutzern habe ich eine vollständig funktionierende Lösung gefunden. Diese Anleitung spart dir diese Stunden.

ℹ️

Voraussetzungen: Stiebel Eltron ISG (Internet Service Gateway) an IP 192.168.x.x, Port 502, Firmware ≥ 1.6.x, Controller Typ 551. Home Assistant mit installiertem Modbus-Integration.

1. Grundlagen: Was ist Modbus TCP?

Modbus TCP ist ein industrielles Kommunikationsprotokoll das über TCP/IP läuft. Das Stiebel Eltron ISG (Internet Service Gateway) fungiert als Modbus-Server — Home Assistant verbindet sich als Client und kann Messwerte lesen sowie Einstellungen schreiben.

Das ISG ist das kleine weiße Gerät das per LAN mit deinem Router verbunden wird. Es übersetzt die interne Kommunikation der Wärmepumpe in ein Netzwerkprotokoll. Wichtig: Das ISG muss eine feste IP-Adresse haben — am besten per DHCP-Reservierung im Router vergeben.

2. Der entscheidende Trick: Register −1 Offset

Das ist der häufigste Fehler bei dieser Integration. Die Stiebel Eltron Dokumentation listet Register-Adressen die um 1 höher sind als die tatsächlichen Modbus-Adressen. Register 514 in der Dokumentation entspricht also Register 513 in Home Assistant.

⚠️

Wichtig: Immer Dokumentations-Adresse minus 1 rechnen. Beispiel: Dokumentation sagt 514 → du verwendest 513 in der YAML-Konfiguration.

3. Funktionierende Register-Adressen

Nach ausgiebigem Testen sind das die verlässlich funktionierenden Register für Controller Typ 551 mit Firmware 1.6.4:

Sensor	Register (HA)	Datentyp	Einheit	Status
Vorlauftemperatur	513	int16	°C × 10	✓ Getestet
Rücklauftemperatur	514	int16	°C × 10	✓ Getestet
Außentemperatur	506	int16	°C × 10	✓ Getestet
Warmwassertemperatur	527	int16	°C × 10	✓ Getestet
Betriebsmodus	1500	uint16	—	✓ Getestet
Lüftungsstufe	—	—	—	✗ Controller 551 n.v.

Temperaturen werden als int16 mit Faktor 0.1 übertragen — ein Wert von 215 entspricht also 21.5°C. Das wird in der YAML-Konfiguration mit scale: 0.1 automatisch umgerechnet.

4. YAML-Konfiguration für configuration.yaml

Füge folgendes in deine configuration.yaml ein:

configuration.yaml

modbus:
  - name: "stiebel_eltron"
    type: tcp
    host: 192.168.2.173  # ← Deine ISG IP-Adresse
    port: 502
    sensors:
      - name: "WP Vorlauftemperatur"
        unique_id: wp_vorlauf
        slave: 1
        address: 513
        input_type: input
        data_type: int16
        scale: 0.1
        precision: 1
        unit_of_measurement: "°C"
        device_class: temperature
        state_class: measurement

      - name: "WP Rücklauftemperatur"
        unique_id: wp_ruecklauf
        slave: 1
        address: 514
        input_type: input
        data_type: int16
        scale: 0.1
        precision: 1
        unit_of_measurement: "°C"
        device_class: temperature
        state_class: measurement

      - name: "WP Außentemperatur"
        unique_id: wp_aussen
        slave: 1
        address: 506
        input_type: input
        data_type: int16
        scale: 0.1
        precision: 1
        unit_of_measurement: "°C"
        device_class: temperature
        state_class: measurement

      - name: "WP Warmwassertemperatur"
        unique_id: wp_warmwasser
        slave: 1
        address: 527
        input_type: input
        data_type: int16
        scale: 0.1
        precision: 1
        unit_of_measurement: "°C"
        device_class: temperature
        state_class: measurement

💡

Wichtig: input_type: input ist entscheidend — nicht holding. Das ist der zweithäufigste Fehler. Die ISG-Register sind als Input Register definiert, nicht als Holding Register.

5. Alternative: HACS Integration

Seit Home Assistant 2024.x gibt es auch eine offizielle HACS-Integration für Stiebel Eltron ISG. Diese ist einfacher einzurichten aber weniger flexibel als die direkte Modbus-Konfiguration. Für Einsteiger empfehle ich den HACS-Weg, für volle Kontrolle die manuelle YAML-Konfiguration.

Die HACS-Integration installierst du über Einstellungen → Geräte & Dienste → + Integration hinzufügen → Stiebel Eltron ISG. Du brauchst nur IP-Adresse und Port — den Rest erledigt die Integration automatisch.

6. Lovelace Dashboard einrichten

Mit folgender YAML-Karte bekommst du eine übersichtliche Darstellung aller Wärmepumpen-Werte:

Lovelace Dashboard YAML

type: entities
title: Wärmepumpe
entities:
  - entity: sensor.wp_vorlauftemperatur
    name: Vorlauf
    icon: mdi:thermometer-chevron-up
  - entity: sensor.wp_ruecklauftemperatur
    name: Rücklauf
    icon: mdi:thermometer-chevron-down
  - entity: sensor.wp_aussentemperatur
    name: Außen
    icon: mdi:thermometer
  - entity: sensor.wp_warmwassertemperatur
    name: Warmwasser
    icon: mdi:water-thermometer

7. Fazit

Die Integration funktioniert stabil sobald man den −1 Offset kennt und input_type: input statt holding verwendet. Ich nutze diese Konfiguration seit mehreren Monaten produktiv und sie läuft absolut zuverlässig.

Falls du Fragen zu deiner spezifischen Konfiguration hast oder weitere Register benötigst — schreib mir gerne direkt oder buche ein kostenloses Beratungsgespräch.

Die Lüftungssteuerung über Modbus bleibt leider für Controller-Typ 551 nicht verfügbar — das ISG gibt diese Register bei diesem Controller-Typ schlicht nicht frei. Hier hilft nur der direkte Service-Kontakt zu Stiebel Eltron.