Luxtronik 2.0 / 2.1

Geräteprofil · Wärmepumpen

Hinweis: Dieses Profil basiert auf dem öffentlich dokumentierten (reverse-engineerten) Luxtronik-Protokoll.

Wärmepumpe mit Luxtronik 2.0 oder 2.1 Regler (u. a. Alpha Innotec, Novelan, weitere OEM-Varianten) mit Netzwerkanschluss am Regler.
Der Regler muss im Heimnetz erreichbar sein, TCP-Port 8889 (Standard der Luxtronik-Steuerung).
Kein Login nötig – der Port 8889 ist ohne Passwort zugänglich.

Dem Regler eine statische IP-Adresse geben (am Regler im Service-Menü unter TCP/IP oder per DHCP-Reservierung)
Skills → Add-ons: Profil importieren
IP-Adresse und Port 8889 eintragen

Status (Betriebszustand: Heizen, Warmwasser, Abtauen, EVU-Sperre, Keine Anforderung …)
Verdichter läuft (active), Störung (malfunction)
Außen-, Vorlauf-, Rücklauf- und Warmwassertemperatur
Warmwasser-Soll (lesen und setzen)
Betriebsart Heizung und Warmwasser (Automatik, Zusatzheizung, Party, Ferien, Aus – lesen und setzen)
Heizleistung und Leistungsaufnahme (nur neuere Firmware, sonst 0)
Wärmemengen Heizen / Warmwasser / Gesamt (nur mit Wärmemengenzähler, sonst 0)
Ausgeblendet: Außentemperatur-Mittelwert, Rücklauf-Soll, Heißgas, Wärmequelle Ein-/Austritt, detaillierter WP-Zustand, letzter Fehlercode aus dem Fehlerspeicher

Gelesen wird alle 30 s der Block „Berechnungen“ (Befehl 3004) und alle 60 s der Block „Parameter“ (Befehl 3003). Geschrieben wird mit Befehl 3002.

Firmware V1.90.x / V2.90.x: Bei diesen Firmware-Ständen kann jeder Schreibbefehl den Regler zum Absturz bringen (ein bekanntes Problem dieser Stände). Firmware-Stand im Informationsmenü des Reglers prüfen und auf diesen Ständen Betriebsart und Warmwasser-Soll nicht über nomos setzen.
Warmwasser-Soll: Ab Firmware x.88.3 gilt der Parameter 105 („Wunschwert“) – den setzt das Profil. Ältere Firmware ignoriert Parameter 105; dort das ausgeblendete Property Warmwasser-Soll setzen (Firmware vor x.88.3) verwenden (Parameter 2).
Störung wird aus der Statuszeile 1 des Reglers abgeleitet (Wert 4 = Fehler). Der „letzte Fehlercode“ stammt aus dem Fehlerspeicher und bleibt auch nach Behebung stehen.
Heizleistung / Leistungsaufnahme liefert nur neuere Firmware (Berechnungen 257 und 268). Bei älterer Firmware zeigt das Profil dort 0.
Zeigen alle Temperaturen dauerhaft 0,0 °C, schickt der Regler seine Antwort vermutlich in mehreren TCP-Paketen; das Profil erwartet sie in einem Stück. Dann bitte mit DEBUG-Log an den Support melden.
Das Profil hält eine dauerhafte TCP-Verbindung zum Regler. Andere Programme (ein zweites System, die Hersteller-App) können parallel stören – im Zweifel nur einen Client gleichzeitig verwenden.
Neuere Luxtronik-2.1-Firmware bietet zusätzlich eine WebSocket-Schnittstelle (Port 8214) und ab V3.90.1 eine Modbus-TCP-Schnittstelle (Port 502). Dieses Profil nutzt beides nicht, sondern den klassischen Port 8889.