Daikin Altherma in Home Assistant: Onecta-Cloud, Modbus oder ESP32, und was Sie vorher wissen sollten

!Außeneinheit einer Wärmepumpe an einer Hauswand

Am 21. Juni 2026 schrieb ein Nutzer namens pdodell in den GitHub-Issue #690 der Daikin-Onecta-Integration, er habe ein Problem, das ihn seit Monaten ärgere: Sein Home Assistant verbrauche das Tageskontingent an Cloud-Anfragen, "even when the house is empty". Er hatte die Abfrage auf 30 Minuten von 8 bis 18 Uhr und auf 60 Minuten sonst gestellt. Rechnerisch hätte das für den Tag weit gereicht. Trotzdem waren die 200 Anfragen laut seiner Beschreibung weg, "before I even get out of bed". Der Entwickler Johnny Willemsen antwortete, es gebe pro Abfrage ein einziges Paket für alle Geräte, auch bei sieben Klimageräten. Am 1. Juli vermutete der Nutzer einen Zusammenhang mit Stromausfällen in Spanien: Home Assistant starte schneller als der Router, die Verbindung zu Daikin fehle, und der Zähler für das verbleibende Kontingent werde "unavailable". Als Notlösung baute er eine Automation, die die Integration neu lädt. Der Issue wurde ohne eindeutige Ursache geschlossen.

Daikin lässt Sie bei einer Altherma-Wärmepumpe mit drei völlig verschiedenen Mitteln an die Daten: über eine Cloud mit Tagesbudget, über eine lokale Schnittstelle, für die man teilweise Zubehör oder eine Freischaltung braucht, oder über ein Bastelkabel am Mainboard. Welche davon passt, hängt weniger vom Geschmack ab als davon, welche Altherma bei Ihnen im Keller hängt und welches Kommunikationsmodul eingebaut ist. Dieser Artikel sortiert das. Für die anderen Hersteller gibt es bei uns eigene Anleitungen, zum Beispiel für Vaillant per eBUS oder den Überblick zu Wärmepumpe, SG Ready und Home Assistant.

Weg 1: Onecta-Cloud, der einfache Einstieg

Die Integration heißt daikin_onecta, läuft über HACS und wird von Johnny Willemsen gepflegt. Auf GitHub hat sie rund 600 Sterne, die letzte Version im Repository ist 4.6.19 vom 4. September 2026, und Anfang Oktober wurde noch aktiv daran gearbeitet. Sie ersetzt die ältere daikin_residential_altherma, die nach dem 11. März 2024 nicht mehr funktionierte, weil Daikin seine Cloud umgebaut hatte (laut README der Vorgängerprojekte).

Sie müssen dafür selbst eine Anwendung im Daikin Developer Portal anlegen. Die README beschreibt es so: Konto auf developer.cloud.daikineurope.com mit derselben Anmeldemethode und derselben E-Mail-Adresse wie in der Onecta-App erstellen, Anwendung anlegen, als Redirect-URI https://my.home-assistant.io/redirect/oauth eintragen und Client-ID plus Secret in Home Assistant eintragen. Wer eine andere Mail-Adresse nimmt als in der App, sieht laut README keine Geräte. Im Onecta-Forenthread berichteten 2024 mehrere Nutzer, dass die Weiterleitung auf einer Daikin-Proxy-Seite hängen blieb. Hilfreich war bei zwei Leuten das Löschen der automatisch erzeugten Anmeldedaten und manuelles Eintragen, bei einem anderen der Wechsel von Firefox auf Edge oder Chrome, bei einem weiteren das Hinzufügen über die Home-Assistant-App auf dem Handy.

Der Haken steht im Daikin-Developer-Portal selbst. Jede Anwendung hat standardmäßig 200 Anfragen pro Tag und 20 pro Minute, und für private Entwickler lässt sich das nicht erhöhen (so die Angaben zum Developer Portal laut Daikin und dem Projekt daikin-controller-cloud). Rechnen wir das nach: Bei einer Abfrage alle 5 Minuten wären es 288 Anfragen am Tag, also zu viel. Alle 10 Minuten sind es 144, das geht noch, aber jeder Schaltbefehl und jeder Neustart frisst vom selben Konto. Die Integration lässt Sie deshalb ein Zeitfenster mit hoher Abfragefrequenz und eines mit niedriger einstellen, dazu eine Sperrzeit nach Befehlen. Das aktuelle Limit steht in der Systemintegrität von Home Assistant.

Was daraus folgt: Die Cloud eignet sich zum Anschauen und für gelegentliche Änderungen. Für eine Regelung, die auf PV-Überschuss reagiert, ist sie zu träge. Und der Entwickler sagt selbst, wo es klemmt: Die Integration wurde am 1. Oktober 2026 als Core-Integration in Home Assistant vorgeschlagen (Pull Request #183933), er hat den Antrag am selben Tag zurückgezogen, weil er den Code erst aufräumen will und die Änderungen zu groß wurden. Offiziell ist sie also noch nicht dabei, und das Rate-Limit-Verhalten wurde im September gerade umgebaut: Statt einer leeren Geräteliste meldet die Integration jetzt eine Wartezeit an den Coordinator zurück (PR #779).

Weg 2: Modbus TCP, lokal und ohne Tageslimit

Wer die Anlage auf dem lokalen Netz lesen will, hat bei der Altherma 3 und der Altherma 4 zwei Möglichkeiten, die sich leicht verwechseln lassen.

Altherma 3 mit dem Home Hub EKRHH oder der LAN-Karte. Die Modbus-Schnittstelle sitzt entweder in einem externen Modul (EKMBDXB7V, RS485, laut einem Installationsleitfaden von Modbuscloud 280 bis 380 Euro Händlerpreis) oder in der LAN-Karte (BRP069A78, bei neueren Modellen BRP069B45), die für Modbus TCP einen Lizenzschlüssel verlangt. Für den Home Hub EKRHH gibt es die HACS-Integration daikin-ha-ekrhh-modbus von gerione: Modbus TCP wird in der Onecta-App aktiviert, dort wählen Sie Anwendungsfall 3 oder 4, Port 502 ohne und 802 mit TLS. Das Projekt hat laut GitHub 24 Sterne, die letzte Version 1.0.7 stammt vom 30. März 2026. Mit Anwendungsfall 1 oder 2 funktioniert es nicht, das steht ausdrücklich im Readme. Die Registerliste liefert Daikin selbst in den Installationsunterlagen zum EKRHH, wie ein Nutzer in einer ESPAltherma-Diskussion im März 2024 verlinkte. Altherma 4 mit eingebautem Modbus. Hier braucht es nach der Dokumentation des Projekts joklee/ha_daikin_altherma4_modbus kein Zubehör, sondern eine Firmware-Einstellung: Im Installateurmodus unter Einstellungen, Netzwerk, Modbus wird Modbus TCP auf Port 502 aktiviert. Voraussetzung sind die Bedieneinheit MMI mit Version 2.2.0 oder höher, ein Ethernet-Kabel (WLAN geht nicht) und Home Assistant 2026.9 oder neuer. Die Integration meldet über 50 Sensoren, 26 Binärsensoren, 6 Schalter, über 20 Zahlenfelder und zwei Klima-Entitäten. Das Repository hat 30 Sterne, die letzte Version ist 0.7.1-dev vom 3. Oktober 2026, es ist also frisch und in Bewegung.

Zwei Warnungen des Autors nehmen wir ernst. Erstens: Es werden Einstellungen der Wärmepumpe verändert, "use at your own risk", und falsche Werte können die Anlage beschädigen oder die Garantie berühren. Zweitens: Wer sich auf Rücklauftemperatur, Delta-T, thermische Leistung oder CoP verlässt, soll die MMI-Firmware nicht auf 4.x aktualisieren (getestet mit 4.1.0), weil diese Werte danach nicht mehr stimmen. Dazu gibt es maximal drei gleichzeitige Verbindungen. Wer also Home Assistant, ein Monitoring-Tool und einen Installateur-Zugang parallel betreibt, läuft in die Grenze.

Dass die rohe Modbus-Abfrage ohne Vorlage mühsam ist, zeigt ein Beitrag im Home-Assistant-Forum vom 9. Juni 2026. Der Nutzer pe.synods las an einer Altherma mit Port 502 und Slave-ID 3 das Register 30775 und bekam Werte zwischen 700 und 3000, vermutlich die momentane Leistung. Viele Nachbarregister lieferten 4294967295 oder eine Modbus-Ausnahme. Eine Registerbeschreibung hatte er nicht, eine echte Antwort kam im Thread nicht, nur der Tipp, es mit der Custom-Integration Protocol Wizard zu probieren. Wir lesen das als Hinweis: Nehmen Sie eine fertige Integration mit hinterlegter Registerliste, statt selbst im Dunkeln zu raten.

Weg 3: ESPAltherma am X10A

Für ältere Anlagen ohne LAN-Karte oder wenn man auf Zubehör verzichten will, gibt es seit Jahren ESPAltherma von raomin: Ein ESP32 oder ESP8266 hängt über einen 5-poligen JST-Stecker an der seriellen Schnittstelle X10A der Wärmepumpe, liest die gewünschten Werte im festgelegten Takt aus und schickt sie als JSON per MQTT, sodass Home Assistant sie über MQTT Discovery findet. Optional lässt sich die Pumpe damit ein- und ausschalten. Das Projekt unterstützt laut README auch Rotex- und Hoval-Belaria-Geräte, hat rund 505 Sterne und wurde zuletzt Ende August 2026 angefasst. Sie brauchen PlatformIO und etwas Lust am Flashen. Dafür kostet der Spaß ein paar Euro Hardware und läuft komplett im Heimnetz.

Wie bei jedem Eingriff am Mainboard gilt: Das macht, wer sich mit Niederspannung auskennt. Im Zweifel macht es der Installateur. Eine Einbindung per ESP32 ist keine Herstellerfreigabe.

Welcher Weg passt zu Ihnen

Die Onecta-Cloud lässt sich mit den lokalen Wegen kombinieren. Das ist sogar sinnvoll: Die Cloud für Energieabrechnung und Statusanzeigen im Tagesbudget, die lokale Schnittstelle für alles, was schnell reagieren soll.

Was wir an Daikin ungewöhnlich finden

Bei Stiebel Eltron oder Vaillant fragt man, ob die Pumpe überhaupt eine Schnittstelle hat. Bei Daikin ist die Frage eher, wie viele es gibt: Cloud-API mit hartem Limit, Modbus je nach Baujahr in mehreren Ausführungen, serielle Schnittstelle am Mainboard. Die Altherma 4 holt die Schnittstelle ins Gerät selbst, was für Heimanwender das erste Mal wirklich komfortabel ist. Dass zugleich eine Firmware-Version laut Projektautor die Messwerte verfälschen kann, ist die Kehrseite.

Unser Rat: Wer bei einer Altherma 4 Modbus einschaltet, vergleicht die Werte zuerst mit dem Display, bevor er die Schalter und Zahlenfelder zum Steuern benutzt. Wer eine Altherma 3 hat, fragt zuerst den Installateur, ob Home Hub oder Lizenz schon verbaut sind, bevor er Geld ausgibt. Und wer die Cloud nutzt, schaut ins Systemlog, wie viele Anfragen am Tag tatsächlich verbraucht werden, und dreht den Takt herunter, bevor das Konto um 6 Uhr leer ist. Vor einem Home-Assistant-Update lohnt ein Blick in die Backup-Strategie.

---

Quellen: GitHub jwillemsen/daikin_onecta (README: Einrichtung, Redirect-URI, Konfigurationsoptionen, Systemintegrität; Issue #690 vom 21.06.2026; PR #779 und PR #790; Releases 4.6.x) · GitHub home-assistant/core PR #183933 (Core-Vorschlag, geschlossen am 01.10.2026) · Home-Assistant-Forum, Thread "Daikin Altherma heat pump integration using the new Onecta integration" (Einrichtungsprobleme 2024) · Daikin Developer Portal und daikin-controller-cloud (Limit 200 pro Tag, 20 pro Minute) · GitHub gerione/daikin-ha-ekrhh-modbus (EKRHH, Anwendungsfall 3 und 4, Ports 502/802, v1.0.7) · GitHub joklee/ha_daikin_altherma4_modbus (MMI 2.2.0, Firmware-Warnung 4.x, 3 Verbindungen, v0.7.1-dev) · Home-Assistant-Forum, Thread "Daikin Altherma + Modbus TCP" vom 09.06.2026 · Modbuscloud, "Daikin heat pump Modbus: an installer's guide for 2026" (EKMBDXB7V, BRP069A78 und B45, Lizenz) · GitHub raomin/ESPAltherma (X10A, MQTT) und Diskussion #407 (EKRHH).