Luxtronik in Home Assistant: lokal einbinden, und warum Firmware .90 bei jedem Schreibbefehl neu startet

!Wärmepumpe von Alpha Innotec an einem Gebäude

Am 19. August 2026 eröffnete ein Nutzer im GitHub-Repository der Luxtronik-Integration den Issue #761. Seine Novelan WZS81H hatte Firmware V1.90.0, und seit dem Update ließ sich nichts mehr schreiben. Egal ob Kühlmodus oder Warmwasser-Solltemperatur: Home Assistant schickte den Befehl, nach 60 Sekunden kam "Write error: timed out", und die Wärmepumpe startete neu. Lesen funktionierte tadellos. Der Entwickler, der den Fall betreute, fand im Log die Spur: dreizehn Abfragen hintereinander in je 0,112 Sekunden, dann ein Schreibbefehl, dann Stille. Die Steuerung meldete sich nicht ab, sie war einfach weg.

Fünf Tage später meldete ein zweiter Nutzer mit einer Novelan LAD9 und Firmware V2.90.0-12815 dasselbe. Er beschrieb den Ablauf genauer: Die Steuerung friert etwa zehn Sekunden ein, startet neu, und danach gilt der neue Wert tatsächlich. Dann schrieb er an Novelan. Der Hersteller spielte aus der Ferne V2.89 zurück, und die Integration lief wieder.

Das ist die Geschichte, die man kennen sollte, bevor man eine Luxtronik-Anlage mit Home Assistant verheiratet. Der Rest ist angenehm unspektakulär: Die Anbindung läuft lokal, braucht kein Konto und keine Cloud. Dieser Artikel zeigt Einrichtung und Optionen und erklärt, woran Sie die betroffene Firmware erkennen und was dagegen hilft. Für andere Hersteller haben wir Stiebel Eltron, NIBE und Panasonic Aquarea beschrieben, den Überblick zu SG Ready liefert Wärmepumpe, SG Ready und Home Assistant.

Was Luxtronik überhaupt ist

Luxtronik ist keine Marke, sondern der Regler. Er steckt in Wärmepumpen mehrerer Hersteller. Die README der Integration nennt Alpha Innotec, Siemens, Novelan, Roth, Elco, Buderus, Nibe und Wolf Heiztechnik. Die Hersteller-Liste ist die verlässlichste Orientierung, eine einfache Prüfung am Gerät kennen wir nicht. Ältere Reglergenerationen sind ein Sonderfall. Für Luxtronik 1 gibt es ein eigenes, kleines Community-Projekt (dkmouk/luxtronik1, entwickelt an einer Alpha Innotec LWC80), das wir nicht getestet haben und hier nur der Vollständigkeit halber nennen.

Die Integration: BenPru/luxtronik per HACS

Die Integration steht in HACS als Standardeintrag, das Repository hat 171 Sterne, die letzte Version 2026.10.06 erschien am 6. Oktober 2026. Sie baut auf der älteren Integration von Bouni auf (99 Sterne, letzter Push im September 2023) und ergänzt vorgefertigte Entitäten und eine komplette Einrichtung über die Oberfläche. Die Pflege hat der ursprüngliche Autor laut README an die Community übergeben, der aktuelle Entwickler ist rhammen.

Die Einrichtung ist kurz:

1. In HACS nach "Luxtronik" suchen und prüfen, dass es das Repository von BenPru ist, dann herunterladen und Home Assistant neu starten.
2. Unter Einstellungen, Geräte & Dienste sollte die Wärmepumpe automatisch auftauchen. Falls nicht, "Integration hinzufügen", Luxtronik wählen und die IP-Adresse eintragen.
3. Die Steuerung hängt per Netzwerkkabel im Heimnetz. Die README empfiehlt eine feste IP im Router. Die Verbindung geht auf Port 8889, das sieht man in den Konfigurationseinträgen aus den Issues.

Wichtig für die Version: Die aktuelle Integration verlangt Home Assistant 2026.8 oder neuer. Wer älter ist, installiert laut README die Version 2026.08.29, die letzte für ältere Core-Versionen.

Die Integration legt bis zu fünf Geräte an: Wärmepumpe, Heizung, Kühlung, Warmwasser und Lüftung. Kühlung, Warmwasser und Lüftung entstehen nur, wenn die Steuerung die Funktion meldet. Fehlt eine Entität aus der README, liegt es meistens an Hardware oder Firmware. Die README rät, dann zuerst nach einem Firmware-Update zu schauen, denn neue Firmware schaltet teils zusätzliche Sensoren frei.

Was in den Optionen steckt

Unter Konfigurieren finden Sie vier Einstellungen: einen externen Raumtemperatursensor (nur zur Anzeige, die Wärmepumpe regelt weiter nach ihrem eigenen Fühler), einen externen Leistungssensor für die COP-Berechnung, das Abfrageintervall und bei einem einfachen Raumgerät die Raumsolltemperatur.

Der Leistungssensor ist der interessanteste Punkt. Die Leistungsaufnahme, die die Steuerung selbst meldet, ist laut Dokumentation nicht immer genau. Mit einer Messsteckdose oder einem Zähler am Außengerät, zum Beispiel einem IR-Lesekopf am Zähler oder einem Shelly, rechnen Sie den COP mit echten Werten. Er ändert nur den Nenner des COP, nicht den Sensor "Aktuelle Leistungsaufnahme", und die erzeugte Wärme kommt immer von der Wärmepumpe.

Der Fehler: Firmware V1.90.0 und V2.90.0

Zurück zum Issue. Vom 19. August bis zum 13. September dauerte es, bis der Fehler eingegrenzt war. Der Maintainer schreibt selbst, dass er den ersten Nutzer zweimal um einen Test gebeten hat, der nicht funktionieren konnte.

Spur eins: die Integration. Version 2026.08.18 hatte eine Konfigurationsänderung gebracht, also lag der Verdacht nahe. Der Test, auf 2026.07.30 zurückzugehen, scheiterte aber zwangsläufig: Home Assistant lädt keinen Konfigurationseintrag mit höherer Versionsnummer als die Integration kennt. Die Nummer war in 2026.08.18 von 9 auf 10 gestiegen. Merken Sie sich das, falls Sie je eine Luxtronik-Version zurückrollen wollen: Es geht nicht ohne Weiteres. Spur zwei: myUplink. Laut dem ersten Nutzer hat Alpha Innotec das Portal myUplink eingebunden, er vermutete dort die Ursache. Der Nutzer mit der LAD9 schaltete die Fernwartung ab, die myUplink-Verbindung riss, und die Neustarts blieben. Damit war das Portal raus. Ebenso das zweite Vorhaben des Maintainers, die Integrationsversion zu bisecten: Es gab keine Regression, die man finden konnte. Die Lösung kam vom Nutzer, nicht vom Entwickler. Die Tabelle aus dem Issue vom 24. August: Eine Variable verändert, wieder zurückgeändert, Ergebnis kehrt sich um. Am 27. August lieferte der Nutzer mit der WZS81H einen Socket-Test nach, der ohne Home Assistant schreibt. Beide Schreibvarianten, auf der bestehenden Verbindung und auf einer frischen, endeten nach zehn Sekunden ohne Bestätigung, und die Steuerung war jedes Mal 102 Sekunden nicht erreichbar. Das Lesen blieb unauffällig. Zitat des Maintainers: Keine Änderung an der Integration kann den Neustart vermeiden. Am 28. August meldete ein dritter Nutzer, dass der Rückgang auf V2.89 bei ihm das Problem behoben habe.

Was die Integration seitdem anders macht

Die Version 2026.08.21 ändert zwei Dinge. Auf die Schreibbestätigung wartet die Integration jetzt höchstens fünf Sekunden statt sechzig, was auf einer gesunden Steuerung genügt: Dort kommt die Bestätigung nach 3 bis 4 Millisekunden (gemessen an einer Alpha Innotec MSW4-16). Und ein fehlgeschlagener Schreibbefehl bleibt nicht mehr in der Warteschlange und reist beim nächsten mit. Das macht den Fehler erträglicher, behebt ihn aber nicht.

Gilt der Weg zurück für jede Steuerung?

Nein, und das hat der Maintainer am 17. September nachträglich klargestellt. Die erste Ziffer der Firmware-Version bezeichnet die Reglerserie. V1.x und V2.x sind verschiedene Hardwaregenerationen, ein V1.x-Regler kann kein V2.89 aufspielen. Bestätigt sind zwei Rückgänge von V2.90.0 auf V2.89. Für V1.90.0 ist der Fehler bestätigt, ein Hersteller-Downgrade nicht. Ein Nutzer mit V1.90.0 schrieb am 20. September im Issue #806 (dort hatte eine Änderung des Zeitplan-Formats den Neustart ausgelöst), er sei auf V1.88.3 zurückgegangen, die er noch auf einem Stick hatte, und seitdem gehe das Schreiben wieder ohne Neustart. Ob Novelan für V1.x eine .89 zurückspielt, ist offen.

Was wir dazu nicht gefunden haben: eine Aussage von Alpha Innotec oder Novelan, ob eine reparierte Firmware kommt. Auch steht in keiner Quelle, was die Anlage in den zehn Sekunden Stillstand und beim Neustart mit laufendem Verdichter macht.

Was das praktisch heißt

• Lesen können Sie ohne Sorge. Sensoren, Energiedashboard und COP laufen mit der betroffenen Firmware. Im Test blieb die Steuerung beim Lesen erreichbar.
• Jede Automatisierung, die schreibt, löst einen Neustart aus. Im Issue gab es einen Fall mit vier Schaltvorgängen am Tag, jeder davon scheiterte. Dazu zählen Zahlenfelder, Schalter, Zeitpläne und die Warmwasser-Solltemperatur.
• Der Wert kommt trotzdem an. Bei der LAD9 war der neue Wert nach dem Neustart aktiv. Bei der WZS81H las ein späterer Dump den alten Wert, und der Maintainer nahm seine Annahme, die Werte kämen trotzdem an, dort zurück.
• Vor einem Firmware-Update: Die Integration bringt eine Update-Entität mit, die stündlich Alpha Innotecs Downloadportal prüft und die installierte Version anzeigt. Sie installiert nichts, das Einspielen läuft laut Dokumentation manuell, typischerweise per USB. Wer schreibend automatisiert und eine Version vor .90 hat, wartet besser, bis es dazu eine Aussage gibt.
• Bei betroffener Firmware: Installateur oder Hersteller um einen Rückgang auf die Version vor .90 bitten, per Fernwartung. Der Download ist laut Maintainer nicht öffentlich, es gibt immer nur das neueste Image.

Was die Integration kann, wenn sie schreiben darf

Die Funktionen, die über reines Lesen hinausgehen, sind der Grund für den Aufwand.

Warmwasser als Wärmespeicher bei PV-Überschuss. Die README führt das einfachste Muster auf: Bei Überschuss die Warmwasser-Solltemperatur anheben, zum Beispiel auf 55 Grad. Genauer steuert das Zahlenfeld "DHW Manual Frequency": 0 heißt automatisch, 20 bis 120 Hz zwingt den Verdichter während der Warmwasserbereitung auf diese Frequenz. Eine niedrigere Frequenz zieht weniger Leistung und braucht länger. Laut Dokumentation landet die tatsächliche Frequenz etwa 1 Hz unter dem Sollwert (Issue #674), prüfen Sie also am Sensor "Pump Frequency". Danach wieder auf 0 stellen, sonst dauert die Warmwasserbereitung an bewölkten Tagen zu lang. Smart Grid. Der Wähler "Smart Grid mode" spiegelt das Servicemenü der Steuerung: aus, +/-, SG 1.0 oder SG 1.1. Die Betriebsarten sind nicht austauschbar. SG 1.1 macht aus zwei geschlossenen Kontakten eine Leistungsbegrenzung, die bei einer Wärmepumpe ohne drehzahlgeregelten Verdichter das Gerät abschalten kann. Das ist eine Einstellung für die Inbetriebnahme, nicht für Automatisierungen. Wie das mit den Kontakten zusammenhängt, steht in unserem Artikel zu SG Ready. Zeitprogramme und Warmwasser-Sperrzeiten. Die Zeitpläne sind bearbeitbare Textfelder im Format HH:MM-HH:MM. Für die Warmwasser-Sperrzeiten warnt die Dokumentation: Sie bedeuten etwas anderes als die Heizungsplanung. Wer sie nutzt, liest vorher TIMER_SCHEDULES.md im Repository. Zirkulationspumpe. Die Doku warnt ausdrücklich davor, Parameter 85 als Ein-Aus-Schalter zu nutzen. Er legt fest, was der Ausgang ist (Zirkulationspumpe oder Ladepumpe), nicht ob er läuft. Ein älterer Rat im Issue #310 hatte genau das empfohlen. Stattdessen gibt es die Zeitplan-Entitäten.

Zwei Stolpersteine bei Updates

Die Integration selbst zieht Entitäten um. Die Version 2026.10.06 ersetzt die Lüftungs-Zeitplanfelder durch getrennte Tag- und Nachtpläne, die alten Entitäten werden entfernt, Automatisierungen und Karten müssen Sie von Hand umhängen. Auf Wärmepumpen ohne Solarthermie verschwinden die Solar-Entitäten (Solarpumpe, Kollektor, Puffer, Betriebsstunden und vier Zahlenfelder), die laut Release-Notiz auf vielen Geräten fälschlich angelegt waren. Wer eine Karte darauf hat, räumt sie auf. Die Abhängigkeit im Hintergrund. Laut den Issues verlangt die Integration die Python-Bibliothek luxtronik in der Version 0.3.14. Zwischen Home Assistant 2026.4 und 2026.5 schlug in einem Issue die automatische Installation solcher Abhängigkeiten bei mehreren HACS-Integrationen fehl, darunter luxtronik2 (Issue #171055 im Core-Repository). Der Melder schrieb im August, mit 2026.7 sei es verschwunden. Wer so etwas sieht: Log prüfen, ob die Bibliothek fehlt, und die Integration neu laden.

Welcher Weg passt zu Ihrer Anlage

Unser Fazit

Die Anbindung selbst ist unkompliziert: lokal, ohne Konto, mit vielen fertigen Entitäten. Das Risiko liegt in der Firmware. Ein Update des Herstellers kann das Schreiben unbrauchbar machen, und dann startet jede Automatisierung, die einen Wert setzt, die Wärmepumpe neu. Wer nur lesen will, ist davon nicht betroffen. Wer schreibend automatisiert, schaut vor jedem Firmware-Update in den Issue-Tracker und notiert sich die installierte Version, damit ein Rückgang beim Hersteller konkret angefragt werden kann.

---

Quellen: GitHub BenPru/luxtronik (README und ADVANCED_FEATURES.md, Release 2026.10.06 und 2026.08.21, Issue #761 vom 19.08. bis 13.09.2026 mit Korrektur vom 17.09., Issue #806 vom 17.09.2026, Issue #310, #674; DHW_TARGET_REGISTERS.md) · GitHub Bouni/luxtronik (Repository-Stand) · GitHub dkmouk/luxtronik1 · GitHub home-assistant/core, Issue #171055 vom 18.05.2026.