KNX, Modbus und Wärmepumpe sicher in Home Assistant integrieren

Eine Wärmepumpe in Home Assistant sichtbar zu machen ist nützlich – Schreibzugriffe auf KNX oder Modbus sind aber eine andere Risikoklasse. Mein Grundsatz lautet deshalb: zuerst vollständig lesen, verstehen und visualisieren. Schreiben kommt nur für klar dokumentierte Datenpunkte infrage und wird niemals nebenbei getestet.

Diese Trennung macht ein Smart-Home-System nicht weniger leistungsfähig. Schon reine Telemetrie liefert Vorlauf, Rücklauf, Warmwasser, Betriebszustände, Verdichterstatus, Energie und viele weitere Werte für Dashboards, Statistiken und Fehleranalyse.

Die sichere Datenrichtung

Im ersten Ausbauschritt fließen Daten ausschließlich in eine Richtung:

Wärmepumpe / KNX / Modbus  →  Integration  →  Home Assistant  →  Dashboard

Home Assistant darf Werte empfangen und darstellen, sendet aber keine Sollwerte, Betriebsarten oder Telegramme zurück. Diese einfache Regel verhindert, dass ein falsch zugeordnetes Register oder eine vertauschte Gruppenadresse reale Anlagenparameter verändert.

Lesen heißt nicht automatisch harmlos

Auch beim Lesen gibt es Fallstricke:

• zu kurze Polling-Intervalle können Bus oder Steuerung belasten,
• Einheiten können verwechselt werden, etwa W und kW,
• skalierte Register benötigen Faktoren wie 0,1 oder 0,01,
• vorzeichenbehaftete Werte können als große positive Zahlen erscheinen,
• ein unbekannter Sensorwert ist nicht automatisch null,
• ein dokumentierter Sentinel ist noch kein sicherer Schreibwert.

Deshalb beginne ich mit wenigen Datenpunkten, plausibilisiere sie gegen die Herstelleranzeige und erweitere erst danach.

KNX-Gruppenadressen sauber dokumentieren

So startest du ohne Bus-Schreibzugriff

In Home Assistant unter Einstellungen → Geräte & Dienste → Integration hinzufügen → KNX zunächst nur den KNX/IP-Zugang einrichten. Für den allerersten Test besser eine bereits in ETS dokumentierte Status-Gruppenadresse auswählen. Im KNX-Projekt den Datenpunkttyp und die Lesbarkeit prüfen; eine beliebige Gruppenadresse ist kein sicherer Sensor. Ein beispielhafter Sensor-Eintrag in configuration.yaml sieht so aus:

knx:
  sensor:
    - name: "Beispiel Rücklauftemperatur"
      state_address: "1/2/3"
      type: temperature

1/2/3 ist ein Platzhalter, keine Adresse meiner Anlage. Keine address für Sollwerte, keine KNX-Schalter, keine Automationen und keine knx.send-Aktion ergänzen. Konfiguration unter Entwicklerwerkzeuge → YAML prüfen, erst dann Home Assistant neu laden beziehungsweise neu starten. Danach Sensorzustand mit der Herstelleranzeige vergleichen. Je nach KNX-Gerät löst die Ermittlung des Anfangswerts ein KNX-Read-Telegramm aus; falls wirklich ausschließlich passiv mitgehört werden darf, auch das im Gerätekonzept berücksichtigen.

Für jede Gruppenadresse gehören mindestens folgende Angaben in die Dokumentation:

• Gruppenadresse und eindeutiger Name,
• Datenpunkttyp, Einheit und Skalierung,
• Quelle und Ziel,
• Lesen, Schreiben, Übertragen und Aktualisieren,
• Verhalten nach Bus- oder Geräte-Neustart,
• Hinweis, ob der Punkt sicherheits- oder anlagenrelevant ist.

Gerade bei Heizungsdaten verhindert eine saubere ETS-Dokumentation, dass später ein vermeintlicher Statuswert mit einem Sollwert verwechselt wird.

Modbus: Registervertrag vor Automation

Für Modbus in Home Assistant nur dokumentierte Read-Register als Sensoren konfigurieren; write_type, switch oder schreibende Dienste bleiben außen vor. Vorher Host, Port, Slave-ID, Register-Offset und Datentyp aus der Dokumentation übernehmen. Ein ausgedachtes Registerbeispiel wäre gerade bei einer Wärmepumpe gefährlich – deshalb hier bewusst keine universelle Registeradresse. In Entwicklerwerkzeuge → Zustände die ersten Werte beobachten und mit der lokalen Anzeige vergleichen; bei unbekannten Werten die Konfiguration stoppen, nicht durch Trial-and-Error Registerbereiche abfragen.

Bei Modbus reicht eine Registernummer allein nicht. Benötigt werden Funktionscode, Datentyp, Byte-Reihenfolge, Skalierung, gültiger Wertebereich und Aktualisierungsintervall. Erst daraus entsteht ein belastbarer Registervertrag.

Ein gutes Lesesignal erfüllt drei Bedingungen:

1. Der Rohwert lässt sich reproduzierbar auslesen.
2. Der umgerechnete Wert entspricht der Anzeige der Anlage.
3. Mehrere Abfragen laufen ohne Timeout oder steigende Fehlerquote.

Bei meiner IDM-Anbindung bleibt die Prüfung neuer Datenpunkte daher standardmäßig lesend. Mehrere vollständige Poll-Zyklen ohne Verbindungsfehler sind aussagekräftiger als ein einzelner erfolgreicher Request.

Home Assistant richtig modellieren

In Home Assistant sollten Verfügbarkeit und Zustand getrennt behandelt werden. Ein Gerät, das gerade keine Antwort liefert, ist unavailable und nicht automatisch ausgeschaltet oder bei null Grad.

Für Energie- und Leistungswerte müssen Quell- und Anzeigeeinheit zusammenpassen. Wird ein Eingang in kW geliefert, im Dashboard aber als W angezeigt, braucht nicht nur der Text eine Multiplikation mit 1000. Auch Schwellenwerte, Pfeilrichtung und Aktivitätslogik müssen dieselbe Umrechnung verwenden.

Für eine übersichtliche Visualisierung nutze ich spezialisierte Lovelace-Karten wie meine GLT Flow Card. Animationen sollten aber nur laufen, wenn der zugrunde liegende Prozess wirklich aktiv ist – nicht bloß, weil ein Sensor existiert.

Wann Schreiben vertretbar wird

Ein Schreibzugriff kommt erst nach einer eigenen Freigabephase:

1. Hersteller- oder ETS-Dokumentation eindeutig prüfen,
2. Wertebereich und Einheit im Code begrenzen,
3. Offline- und Unit-Tests für Validierung und Kodierung,
4. Rollback- beziehungsweise Rückstellwert festlegen,
5. nur einen ungefährlichen Datenpunkt auswählen,
6. Testfenster und beobachtende Person festlegen,
7. physische Buswirkung separat und ausdrücklich freigeben.

Wichtig: Eine Zustimmung zu „Integration testen“ ist für mich keine Zustimmung, Telegramme an KNX oder Befehle an die Wärmepumpe zu senden.

Monitoring statt Steuerungsdrang

Die spannendsten Verbesserungen brauchen oft überhaupt keinen Schreibzugriff:

• Laufzeiten und Starts des Verdichters vergleichen,
• Temperaturspreizung und Durchfluss beobachten,
• Energieaufnahme und erzeugte Wärme gegenüberstellen,
• ungewöhnliche Zustandsfolgen erkennen,
• Benachrichtigungen bei echten Störungen auslösen,
• langfristige Veränderungen nach Software- oder Anlagenwartung messen.

Damit wird Home Assistant zum Diagnosewerkzeug, ohne die Regelstrategie der Wärmepumpe zu übernehmen.

Fazit

Eine gute KNX-/Modbus-Integration beginnt nicht mit einem Schalter, sondern mit korrekten Daten. Wer Einheiten, Skalierung, Verfügbarkeit und Datenrichtung sauber behandelt, erhält ein zuverlässiges Dashboard und eine belastbare Historie. Schreibfunktionen können später folgen – einzeln, begrenzt und bewusst freigegeben.

Passende Projekte: IDM Heatpump in Home Assistant · IDM Heatpump API · ModBridge für Modbus TCP/RTU