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

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

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

X

Basti

Entwickler und Smart-Home-Enthusiast aus Deutschland. Ich entwickle Open-Source-Integrationen für Home Assistant (IDM Wärmepumpe, Violet Pool Controller), Modbus-Tools (ModBridge) und betreibe verschiedene Server-Dienste (Matrix, Seafile, SOGo).

GitHub →

Schreibe einen Kommentar