IDM Heatpump - Home Assistant Integration

KI-generiert

Die vollständige Dokumentation der IDM-Heatpump-Integration. Von der Installation bis zur Fehlerbehebung — mit allen Funktionen, Entitäten und Aktionen.

Für Modbus-Betrieb: Modbus TCP muss auf dem IDM Navigator/Regler unter Gebäudeleittechnik → Modbus TCP → Ein aktiviert sein. Siehe Installation & Einrichtung.

Was ist die IDM-Heatpump-Integration?

Die IDM-Heatpump-Home-Assistant-Integration verbindet Home Assistant mit den IDM-Navigator-Reglern von IDM EnergieSysteme GmbH. Sie ermöglicht lokale Überwachung und unterstützte Steuerungen über Modbus TCP — keine Cloud, kein Abo. Der Navigator 10 ist direkt hardwareseitig bestätigt; Navigator 2.0 und Navigator Pro befinden sich noch in der breiteren Kompatibilitätsvalidierung.

Zentrale Funktionen

Welche Bibliotheksversion gehört zu einem installierten Release?

Diese Dokumentation folgt dem aktuellen Quellstand und kann noch nicht veröffentlichte Bibliotheksupdates enthalten. Ihre Versionsangaben gelten nicht für jedes ältere installierte Release. Maßgeblich sind die Anforderungen im Manifest des jeweiligen Release-Tags, nicht in main. Beispielsweise pinnt das Manifest von 0.19.0 die API-Version 2.4.3. Diese Laufzeitversion ist unter 0.19.0 korrekt. Vergleiche den Integrations-/API-Versionssensor und die Diagnose mit deinem Release-Tag, bevor du eine neuere Angabe auf der aktuellen Website als Installationsfehler wertest.

CI, Release-Prüfung und Pages-Veröffentlichung gleichen aktuelle Angaben mit dem ausgecheckten Manifest ab. Die Bibliotheksautomatik synchronisiert sie; veröffentlichte Changelogs und Release-Nachweise bleiben historische Dokumente.

Aktuell in der 0.26-Reihe

Die aktuelle Funktionsübersicht umfasst:

Ab dieser Integrationslinie ist Home Assistant 2026.11.0 oder neuer erforderlich. Details und Änderungen zwischen einzelnen Versionen stehen im Changelog.

Differenztemperaturgeregelte Kreise

Für im Navigator entsprechend konfigurierte Kreise zeigt Home Assistant Speicher- und Referenztemperatur, die vorzeichenbehaftete Differenz und den Betriebsstatus. Wähle den Kreis sowohl in der normalen Heizkreisliste als auch in der Differenzregelung aus. Normale Heizungsregler werden für diese Kreise ausgeblendet; die Reglerkonfiguration wird nicht verändert. Siehe Konfiguration und Entitätszuordnung und Grenzen. Die Bestätigung auf Hardware mit Differenzregelung steht noch aus; Hysterese- und Schwellenregler sind nicht enthalten.

Smart Energy, Komfort und KI-Berichte

Optionale Energieauswertung, Komfortfunktionen und der experimentelle KI-Berater ergänzen die lokale Anlagenintegration. Automatische Steuerungen bleiben bis zur ausdrücklichen Aktivierung ausgeschaltet.

Starte mit iDM Smart Energy & Comfort für Aktivierung, Beispiele, Standardwerte und Grenzen, und mit dem Experimentellen KI-Berater für Einrichtung, Berichtsmodi, Datenschutz und das Dashboard.

Regler-Integration

• Systemüberwachung: Vorlauf, Rücklauf, Warmwasser, Außentemperatur, Druck, Durchfluss
• Heizkreise A–G: Bis zu 7 Heizkreise mit individueller Sollwert- und Modussteuerung
• Zonenmodule: Bis zu 10 Zonen mit jeweils bis zu 8 konfigurierbaren Räumen; die aktuelle Navigator-10-Hardware nutzt standardmäßig 6 Räume pro Modul.
• Solar & PV: Solare Warmwasserbereitung, PV-Überschussnutzung, Batterieüberwachung
• Energieüberwachung: Wärmemenge, Laufzeiten, Energiezähler
• Kaskade & Bivalenz: Steuerung mehrerer Wärmepumpen, Einbindung von Heizstäben
• GLT-Fernwartung: GLT-Temperaturanforderungen (zyklisches Schreiben)
• Fehlermanagement: Fehlererkennung, Fehlerquittierung, Diagnose-Export
• Optionales Web-Supplement: Navigator-Generation, Softwareversion, kompakte myIDM-ID, Diagnose des reinen Web-Betriebs und Navigator-10-Infosystem-Meldungen, ohne Modbus-Werte zu ersetzen; Standardintervall 30 Sekunden
• KNX-Bridge (optional): Bedient die IDM-KNX-Kommunikationsobjekte — mit denselben Objektnummern, Datenpunkttypen und Richtungen wie IDMs ETS-Beispielprojekt — über die Home-Assistant-KNX-Integration, sodass das Weinzierl-KNX-IP-BAOS-Gateway-Modul nicht mehr benötigt wird. Siehe KNX-Bridge.
• Raumtemperatur-Weiterleitung: Optionales Weiterleiten von Home-Assistant-Temperatursensoren in die externen IDM-Raumtemperatur-Register je Heizkreis
• Lesbare Diagnose: Interne IDM-Meldungen erscheinen mit Text plus strukturierten Code-/Text-Attributen
• Direkte lokale Modbus-Runtime: modbus-connection und tmodbus stellen die gemeinsame Verbindung oder den eigenen Fallback-Socket bereit; idm-heatpump-api behält die IDM-Register- und Sicherheitslogik

Plattformen & Entitäten

Schnellnavigation

Ich bin neu hier

1. Installation & Einrichtung
2. Konfiguration
3. Entitäten

Ich will automatisieren

1. iDM Smart Energy & Comfort
2. Konfiguration und Quellen-Zuordnung
3. Aktions-Referenz

Erkenntnisse und Nachweise

• Felderkenntnisse und Dokumentationspflege
• Predictive Advisor
• Telemetrie und Firmware-Orientierung

Ich habe ein Problem

1. Fehlerbehebung
2. Lokale Navigator-Weboberfläche
3. Modbus-Register
4. Stabilität & Release-Bereitschaft

Ich möchte beitragen

• Beitragsleitfaden

Technische Details

• Batch-Lesen: Nur exakt angrenzende, sich nicht überlappende Bereiche werden gruppiert, bis zu 40 Modbus-Wörter pro Anfrage
• Wertevalidierung: Nicht-verfügbar-Sentinelwerte werden als ungenutzt ausgelassen; verdächtige gruppierte Werte werden einzeln geprüft und für die Client-Sitzung unter Quarantäne gestellt
• Bibliotheksgestützt: Alle Register aus idm-heatpump
• Handlungsfähige Setup-Diagnose: Getrennte Meldungen für Hostname-/DNS-Fehler, abgelehntes oder deaktiviertes Modbus TCP, Timeouts, unerreichbare Endpunkte, falsche Slave-IDs, ungültige Web-PINs und nicht verfügbare Weboberflächen
• Sichtbare Runtime-Versionen: Die Versionen der Integration, von idm-heatpump-api, modbus-connection und tmodbus stehen in einem Diagnose-Sensor, in Diagnose-Exporten und in den Startprotokollen zur Verfügung
• Datentypen: FLOAT, UCHAR, INT8, INT16, UINT16, BOOL, BITFLAG
• EEPROM-Schutz: Sensible Register werden verfolgt und geschützt
• Transportgrenze: Rohe FC03/FC04-Lese- und FC16-Schreibvorgänge nutzen das exakte Paar modbus-connection>=4.12.7 / tmodbus[async-serial]>=0.6.2; 4.12.7 ist die Version der Verbindungsbibliothek, nicht die Version der IDM-Integration
• API-Grenze: idm-heatpump-api[web]==2.16.2 stellt Batching, Dekodierung und Schreibsicherheit bereit. Die API besitzt ihre eigene Exception-Hierarchie; die Integration nutzt den tmodbus-gestützten Socket ohne pymodbus-Abhängigkeit
• Automatische Wiederherstellung: API-Retry/Backoff plus Wiederverbindung nach Bedarf in der tmodbus-gestützten Verbindung
• Verbindungsbesitz: Jeder Eintrag nutzt nach Möglichkeit die gemeinsame Modbus-Verbindung von Home Assistant (owns_socket: false, supports_shared_connection: true); wenn diese nicht beansprucht werden kann, wird ein eigener Socket verwendet
• Validierungsstatus: Automatisierte Checks und Nur-Lese-Beobachtungen am Navigator 10 liegen vor; sie ersetzen keine kandidatenspezifische Clean-Install-, Langzeit- und breitere Modellvalidierung. Siehe Stabilität & Release-Bereitschaft.
• Navigator 10: Wärmesenken-Sensoren, Durchfluss (Sieb-Monitoring), Grundwassertemperaturen, Booster A/B
• Web-Supplement: Das Setup prüft bei Bedarf beide unterstützten lokalen Protokolle, speichert die erfolgreiche Navigator-Familie, verwendet ihre Session wieder und wiederholt während der normalen Laufzeit-Wiederherstellung nur genau dieses Protokoll
• Raum-Weiterleitung: Optionaler Schreibpfad mit Updates bei Zustandsänderung, periodischem Auffrischen sowie Toleranz- und Bereichsprüfungen

Links & Ressourcen

Dieses Wiki dokumentiert die IDM-Heatpump-Integration. Entwickelt von Xerolux