Die IDM Heatpump Integration für Home Assistant bindet IDM-Wärmepumpen mit Navigator 2.0, 10 oder Pro vollständig und 100 % lokal per Modbus TCP ein – ohne Cloud, ohne Portfreigaben, ohne Herstellerportal. Auslesen war gestern: Die Integration überwacht und steuert die komplette Wärmepumpe, vom Heizkreis bis zur Warmwasser-Temperatur.
Was du bekommst
Die Integration erzeugt Entitäten aus der erkannten Gerätetheit – dynamisch je nach Modell, aktivierten Heizkreisen und Zonen:
| Plattform | Entitäten |
|---|---|
| Sensor | Temperaturen (Vorlauf, Rücklauf, Warmwasser, Außen), Drücke, Durchflüsse, Energie, PV, Solar, Kaskade, Laufzeiten, Diagnose |
| Binary Sensor | Störungen, Kompressor, Heiz-/Kühl-/Warmwasser-Anforderung |
| Number (schreibbar) | Sollwerte, Temperaturen, Grenzwerte, GLT-Parameter, Leistungsbegrenzungen |
| Select | Systemmodus, Heizkreismodi, Solarmodus, ISC-Modus |
| Switch | Externe Heiz-/Kühl-/Warmwasser-Anforderung, Einmal-Ladung Warmwasser |
| Climate | Pro Heizkreis (A–G) und pro Zonen-Raum: Heizen/Kühlen mit Solltemperatur |
| Water Heater | Warmwasser-Solltemperatur mit Ist-Temperatur-Rückmeldung |
| Button | Störungen quittieren, optional Warmwasser-Boost starten/abbrechen |
Dazu kommen Features, die im Alltag den Unterschied machen:
- Heizkreise A–G mit individuellen Sollwerten und Modi – bis zu 7 Kreise pro Gerät
- Zonenmodule: bis zu 10 Zonen mit bis zu 8 konfigurierbaren Räumen je Zone, inklusive Raumthermostat-Funktion
- Raumtemperatur-Weiterleitung: Home-Assistant-Temperatursensoren (z. B. aus deinen Thermostaten) in die externen Raumtemperatur-Register der IDM schreiben – konfigurierbar pro Heizkreis
- Solar & PV: Solar-Warmwasser und PV-Überschuss-Nutzung integriert
- Kaskade & Bivalenz: Mehrfach-Wärmepumpen und Heizstab-Einbindung
- Fehlermanagement: Störungen als klartextige Meldungen, quittierbar, mit Diagnose-Export
Experimentell: KNX ohne das IDM-Gateway-Modul
IDM verkauft KNX-Konnektivität für den Navigator als Zubehör-Modul (Weinzierl KNX IP BAOS 774). Die optionale KNX-Bridge der Integration macht dieses Modul überflüssig: Sie veröffentlicht die Wärmepumpe mit denselben Kommunikationsobjekten, Objektnummern und Datenpunktypen wie IDMs eigenes ETS-Beispielprojekt – 654 Objekte, gemappt auf die Modbus-Register des Navigators. Sie ist kein eigener KNX-Stack, sondern fährt die Home-Assistant-KNX-Integration, die du ohnehin hast: Tunneling, Routing und KNX Secure kommen von dort. Die komplette Gruppenadress-Tabelle exportierst du per Service für ETS. (Noch experimentell, standardmäßig deaktiviert.)
Installation
1. HACS – Integration hinzufügen
HACS → Integrations → ⋮ → Custom Repositories
URL: https://github.com/Xerolux/idm-heatpump-hass | Category: Integration
→ "IDM Heatpump" herunterladen → Home Assistant neu starten2. Modbus TCP an der Wärmepumpe aktivieren (Voraussetzung für den vollen Funktionsumfang):
Am IDM Navigator: Gebäudeleittechnik (BMS / GLT) → Modbus TCP → EinDanach die IP-Adresse notieren – Standardwerte sind Port 502 und Slave-ID 1. Je nach Navigator-Generation heißt das Menü anders oder hängt an der Zugangsebene; wenn die Option fehlt oder gesperrt ist, hilft der Heizungsbauer bzw. der iDM-Service weiter.
3. Integration einrichten:
Einstellungen → Geräte & Dienste → Integration hinzufügen → "IDM Heatpump"
IP der Wärmepumpe, Port 502, Slave-ID 1 → Heizkreise & Zonen wählen → FertigWenn etwas nicht funktioniert: geführte Diagnose
Der Einrichtungsdialog erzählt dir, was genau schiefläuft – statt „Setup failed“: unbekannter Host, abgelehnte/deaktivierte Modbus-TCP-Verbindung, Timeout, Netzwerk unerreichbar, falsche Slave-ID, falscher Web-PIN. Und der „Aktuelle Verbindung testen“-Dialog im Rekonfigurieren-Menü prüft gespeicherte Verbindungen read-only – ohne Register zu schreiben oder Einstellungen zu ändern.
Technik mit Ansage
- EEPROM-Schutz: 88 EEPROM-sensitive Register werden getrackt und vor übermäßigem Beschreiben geschützt
- Batch-Reading: nur exakt benachbarte, nicht überlappende Registerbereiche werden gebündelt – bis 40 Wörter pro Request
- Eigene API-Schicht: Alle Registerdefinitionen kommen aus idm-heatpump-api – einer eigenen Bibliothek mit Modell-Erkennung, Dekodierung und Schreibsicherheit; der direkte Modbus-Transport läuft über
tmodbus - Lesbare Diagnose: ein Diagnose-Sensor zeigt die Versionen von Integration, API und Modbus-Laufzeit; Exporte zensieren Hosts, Ports und PINs
Stabile Verbindungen, schöne Visualisierung
Zwei ergänzende Projekte passen hier perfekt: ModBridge setzt sich als sauberer Modbus-Proxy zwischen Home Assistant und Wärmepumpe und löst die klassischen Probleme (zu gleichzeitige Verbindungen, träge Antworten) – und die GLT Flow Card macht aus den ganzen Entitäten eine professionelle Anlagenvisualisierung mit animierten Medienströmen.
Voraussetzungen
- Home Assistant 2026.8.1+ und HACS
- IDM Navigator 2.0 / 10 / Pro mit aktiviertem Modbus TCP (Port 502)
- Optional: lokaler Navigator-Web-PIN für zusätzliche read-only Web-Diagnose
Fazit
Vorlauftemperaturen, Heizkreise, Zonen, Warmwasser, Solar, PV, Störungen – die komplette IDM-Wärmepumpe, lokal und schreibbar in Home Assistant, mit einer Diagnose-Qualität, die Einrichtungsfehler in Sekunden statt Stunden aufklärt. Wer eine IDM-Anlage besitzt und Home Assistant nutzt, sollte hier sofort zugreifen.
Projekt unterstützen: ⭐ auf GitHub, Feedback und Fehlerberichte in die Community-Diskussionen – oder die Entwicklung über Buy Me a Coffee unterstützen.