Der neue Monatsrückblick für September 2026 ist online!

[TbsJah]

Neue DE Readme

0.8.0 (2026-09-14)

🚀 Features & Enhancements

• [Admin UI] Completely redesigned the adapter configuration interface (jsonConfig.json). Settings are now cleanly organized into logical tabs (Connection, Cycle Optimization, Idle Defaults, HUP, Circulation pump, etc.).
• [HUP Control] Added a new dynamic hardware voltage scale factor for the heating circulating pump (HUP). Users can now toggle between factor 100 (for Firmware V2.x) and factor 10 (for Firmware V3.x) to ensure full compatibility across different hardware generations.
• [Safety] Added a confirmation warning dialog to the Admin UI that alerts users to the importance of entering correct values when enabling "Force default values during idle".

🐛 Bugfixes

• [HUP Control] Fixed an incorrect conversion factor for registers 867 and 868 (nominal and minimal HUP voltage). This previously caused newer setups (like the Alpha Innotec LWCV series with FW V3.x) to calculate 1.0V instead of 10.0V, resulting in continuous "less than min" boundary warnings in the ioBroker log.

🛠 Refactoring & Under the Hood

• [Architecture] Extracted the heating circulating pump (HUP) logic from main.ts into a dedicated, isolated hupManager.ts file to improve code modularity and maintainability.
• [CI/CD] Added Node.js 26 to the GitHub Actions test matrix (test-and-release.yml) to ensure future compatibility.
• [TypeScript] Added the "rootDir": "./src" compiler option to tsconfig.json to resolve TS5011 build errors with newer TypeScript versions.

[Smolo]

Schaut, wirklich gut aus. Vielen vielen Dank und ein großes Lob für die Diagramme und Erklärungen im Adapter das ist eine tolle Idee :-)

Zwei Kleinigkeiten für die Zukunft:

1. Die Leerlauf Vorgaben würde ich gleich als zweiten Tab legen mit Verweis auf Heiztakt + HUP Steuerung das ist etwas unklar für Einsteiger
2. Kannst du noch eine Rundung bei den Laufzeiten ergänzen?

[MrMorpheus]

@tbsjah
Vielen Dank für die schnelle Anpassung! Ich habe die 0.8.0 inzwischen installiert. Mit Faktor 10 passen die HUP-Werte bei meiner Luxtronik V3.92.3 jetzt auch zu den Werten der Heizung selbst – AO1/AO2 werden dort ebenfalls mit 10,00 V angezeigt.

Sieht also so aus, als wäre das Skalierungsthema damit gelöst. Die dynamische HUP-Regelung teste ich erst nach weiterer Beobachtung im Heizbetrieb.

Danke für die schnelle Unterstützung und Weiterentwicklung des Adapters! ;-)

[TbsJah]

0.10.1 (2026-09-20)

🚀 Features & Improvements

• (Feature) Heating State String: Added the configured heating curve parallel offset to the status string (e.g., "Offset +3 °C") for better transparency.

🐛 Bugfixes

• (Fixed) Heating State String: Corrected a logic issue where the status incorrectly displayed "Reduced 0 °C" during a scheduled reduction window, even if the actual reduction delta was set to 0 K. It now correctly displays "Normal (Timer)".

0.10.0 (2026-09-20)

🚀 Features & Improvements

• (Added) Low Flow Outage Alerts: Implemented active monitoring for "low flow" (Durchfluss) shutdowns in the outage history. The adapter now proactively sends a notification when the heat pump stops due to flow issues, as the controller usually treats these as soft outages rather than hard errors. Includes a 60-minute cooldown to prevent notification spam.
• (Improved) Admin UI: Integrated a direct recommendation link for the OpenDTA analysis tool into the description text of the Backup & Diagnostics tab.

🛠 Chores / Under the Hood

• (Fixed) ESLint Validation: Added missing JSDoc comments in the backup manager to resolve code validation warnings during development.

0.9.2 (2026-09-20)

🛠 Refactoring & Under the Hood

• DTA Backup Logic & UI: Restructured the "Backup & Diagnostics" settings tab. Removed obsolete text log buttons (procerr, procparam) which are blocked on newer firmwares. Reclassified the DTA manual download buttons into "Live DTA" (forces a new memory flush via /NewProc) and "Existing DTA" (fetches the last auto-saved historical log via /proclog which might be 2-3 hours old).
• Automated Backup Naming: The automated background backup job now dynamically prefixes the downloaded file as either dta_live_ or dta_history_[...] depending on which endpoint was successfully queried, clearly indicating the recency of the data.

0.9.1 (2026-09-20)

🚀 Features & Improvements

• (Added) Backup & Diagnostics Tab: Introduced a new tab in the adapter settings for easy access to heat pump data. Added a recommendation and link for the OpenDTA project to help users analyze their downloaded .dta files.
• Automated DTA Backup: Integrated a time-based background cron job to fully automate the retrieval and storage of DTA log files directly into the ioBroker file system.
• Admin UI Diagnostics: Added a dedicated "Backup & Diagnostics" tab in the adapter settings featuring manual download buttons for DTA files and system logs, along with a recommendation link for the OpenDTA analysis tool.
• Intelligent Firmware Fallback: Improved the DTA download logic to automatically detect the heat pump's firmware version. It seamlessly supports newer models (via /NewProc) while automatically falling back to legacy endpoints (/proclog, /procdta, or /Webclient/procdta) for older heat pumps.

0.9.0 (2026-09-20)

🐛 Bugfixes
🔴 IMPORTANT:

• (Fixed) HUP Dynamic Voltage Control: Fixed an issue where the digital relay state (HUPout) was queried instead of the actual nominal voltage (heating_system_circ_pump_voltage_nominal). This previously caused the calculation logic to produce target voltages below the hardware limit (e.g. 1.25V), triggering "less than min 3" validation warnings in the log.
• (Fixed) Admin UI Backup Links: Fixed multiple issues with the manual download links in the Backup tab. The IP address placeholder was corrected (from {host} to ${data.host}) to resolve correctly. Additionally, 404 Not Found errors on newer firmware versions were fixed by routing links to the root web directory (/procdta, /procparam, /procerr) instead of the legacy /Webclient/ directory.

🚀 Features & Improvements

• (Added) German Translations for Error & Outage Codes: Added full German translations for all entries in ERROR_CODES and OUTAGE_CODES.
• (Improved) Multi-Language History Logs: The error log (Fehlerspeicher) and outage history (Abschaltungen) now dynamically output descriptions and fallbacks in the configured adapter language (de / en).
• (Added) Backup & Diagnostics Tab: Introduced a new tab in the adapter settings for easy access to heat pump data.
• (Added) Manual Downloads: Added direct buttons to manually download the parameter backup (procparam) and error log (procerr) via the heat pump's web server. The manual DTA download was split into two distinct steps ("1. Trigger DTA generation" and "2. Download DTA Log") to better reflect the hardware behavior.
• (Added) Automated DTA Backup & Custom Storage: Implemented a new scheduling feature (cron) to automatically trigger and download live DTA logs, saving them directly to the ioBroker file system. The default storage location is the root directory of the adapter's file system, but users can specify a custom subfolder (e.g., backup) which is automatically created and sanitized.
• (Improved) Firmware Agnostic Backup Downloads: The automated DTA backup manager now features an intelligent fallback mechanism. It attempts to download logs from both the root directory (/procdta) and the legacy subfolder (/Webclient/procdta), ensuring compatibility across all Luxtronik firmware versions (V1, V2, V3).

🛠 Refactoring & Under the Hood

• (Development) TypeScript Definitions: Added missing @types/node-schedule to the dev dependencies to resolve ESLint type-checking errors during the build process.

[TbsJah]

@smolo @mrmorpheus
Wichtiger Hinweis zum HUP-Fehler:
In der Version 0.9.0 habe ich einen Bug behoben, der höchstwahrscheinlich die Ursache für die falschen HUP-Werte war. Lief bei euch in den letzten Tagen schon die Heizung und konntet ihr mal prüfen, ob die Werte jetzt passen?

[TbsJah]

Neue Funktion
Backup DTA Download

[Smolo]

@TbsJah sagte:

@smolo @mrmorpheus
Wichtiger Hinweis zum HUP-Fehler:
In der Version 0.9.0 habe ich einen Bug behoben, der höchstwahrscheinlich die Ursache für die falschen HUP-Werte war. Lief bei euch in den letzten Tagen schon die Heizung und konntet ihr mal prüfen, ob die Werte jetzt passen?

Hey,

gestern hatte er bei mir noch mal 0V vermerkt (0.81) mit dem Update (0.10.1) hat er jetzt wieder auf 10v korrigiert. Ich werde das beobachten.

[TbsJah]

0.11.0 (2026-09-21)

• Improvements:
  • Added global rounding to 2 decimal places for all calculated telemetry values (e.g., converting operating seconds to hours). This provides a cleaner ioBroker state tree and prevents excessively long floating-point numbers from cluttering history databases (like InfluxDB).

0.10.4 (2026-09-21)

• Update Readme

0.10.3 (2026-09-21)

• Features & Improvements:

  • Optimized the automated DTA backup process by directly utilizing the /NewProc file stream, eliminating unnecessary artificial delays and stabilizing the heat pump controller.
  • Streamlined the backup configuration: Removed the custom file path input to prevent file system conflicts. Backups are now securely stored in the universally accessible global 0_userdata.0/luxtronik_backups/ directory.
  • Added a clear information box in the adapter configuration, explaining where to find the generated backup files within the ioBroker UI.

• Fixes:

  • Fixed the persistent not an object of type "meta" crash during DTA backups. The storage architecture was migrated away from isolated adapter namespaces to the robust, native 0_userdata.0 global storage, completely resolving folder creation permission issues on existing instances.
  • Corrected the dynamic file naming logic (dta_live_... vs. dta_history_...) to accurately reflect whether a live memory dump or a fallback history log was downloaded.

0.10.2 (2026-09-21)

• 🚀 Features:

  • Implemented automated DTA file backup management with customizable cron schedules and automatic meta-directory creation in the ioBroker file system.

• 🛠 Chores / Under the Hood

  • Enhanced TypeScript type checking, resolved strict ESLint warnings, and upgraded Node.js type definitions to support Node.js version 22.
  • Optimized image scaling and layout rendering in jsonConfig.json for cleaner adapter settings presentation.

[Smolo]

@TbsJah sagte:

0.11.0 (2026-09-21)

• Improvements:
  • Added global rounding to 2 decimal places for all calculated telemetry values (e.g., converting operating seconds to hours). This provides a cleaner ioBroker state tree and prevents excessively long floating-point numbers from cluttering history databases (like InfluxDB).

0.10.4 (2026-09-21)

• Update Readme

0.10.3 (2026-09-21)

• Features & Improvements:

  • Optimized the automated DTA backup process by directly utilizing the /NewProc file stream, eliminating unnecessary artificial delays and stabilizing the heat pump controller.
  • Streamlined the backup configuration: Removed the custom file path input to prevent file system conflicts. Backups are now securely stored in the universally accessible global 0_userdata.0/luxtronik_backups/ directory.
  • Added a clear information box in the adapter configuration, explaining where to find the generated backup files within the ioBroker UI.

• Fixes:

  • Fixed the persistent not an object of type "meta" crash during DTA backups. The storage architecture was migrated away from isolated adapter namespaces to the robust, native 0_userdata.0 global storage, completely resolving folder creation permission issues on existing instances.
  • Corrected the dynamic file naming logic (dta_live_... vs. dta_history_...) to accurately reflect whether a live memory dump or a fallback history log was downloaded.

0.10.2 (2026-09-21)

• 🚀 Features:

  • Implemented automated DTA file backup management with customizable cron schedules and automatic meta-directory creation in the ioBroker file system.

• 🛠 Chores / Under the Hood

  • Enhanced TypeScript type checking, resolved strict ESLint warnings, and upgraded Node.js type definitions to support Node.js version 22.
  • Optimized image scaling and layout rendering in jsonConfig.json for cleaner adapter settings presentation.

Bei der Release häufig kommt nicht mal NPM hinterher ^^

Update auf 0.11 ist heute Morgen eingespielt worden. Danke.

[TbsJah]

Ja, stimmt schon 😂
Aber jetzt erst einmal alle Fehler behoben (welche ich gefunden hatte)
Und Erweiterungen eingefügt

[Smolo]

Ich hab grad noch was gefunden^^ allerdings keine Zeit das per bei GitHub zu dokumentieren das geht erst wieder in 2-3 Tagen. Die neue Funktion für /proclog etc. funktioniert bei meiner WP nicht hier kommt nur ein 404 HTTP. Keine Ahnung ob die Funktion in V3.89.4 fehlt oder das gerätespezifisch ist?

[TbsJah]

Sollte nicht fehlen
eventuell anderer Aufruf

Was eigentlich immer gehen sollte ist http://IP_VON_LWP/NewProc bzw http://IP_VON_LWP/proclog (das ist aber dann -3h)

[Smolo]

@TbsJah sagte:

Sollte nicht fehlen
eventuell anderer Aufruf

Was eigentlich immer gehen sollte ist http://IP_VON_LWP/NewProc bzw http://IP_VON_LWP/proclog (das ist aber dann -3h)

Sehr seltsam.

Im Browser Funktioniert "NewProc" bei "proclog" kommt allerdings 404.

Wenn ich im Adapter NewProc verwende sag mir Edge allerdings "...kann nicht sicher herunter geladen werden."

[Chriz]

Hey @tbsjah

Vielen vielen Dank für das erneuern des Adapters.

Ich habe im alten Adapter von UncleSam eigentlich immer nur die Datenpunkte für den WW Sollwert und WW Hysterese mit einem kleinen JavaScript verändert.

Nun ist es so das ich in deinem Adapter im Log, bei jedem Schreibvorgang, Fehler bekomme:

luxtronik2-controller.0
2026-09-29 17:31:45.970	error	Failed to finalize downstream state change command event pipeline execution loop: Timeout writing TCP parameter 74.

luxtronik2-controller.0
2026-09-29 17:31:40.669	error	Failed to finalize downstream state change command event pipeline execution loop: Timeout writing TCP parameter 105.

Eine weitere Auswirkung ist dass der Luxtronik Controller anscheinend neu startet. per Webinterface verliere ich dann nämlich für 1min die Verbindung.

Die Werte werden vom Script in die Datenpunkte geschrieben
Dann springen die Werte aber nach ein paar Sekunden wieder zurück zum Ursprungswert, um dann bei dem vermutlichen Reglerneustart doch den Wert vom Script anzunehmen. Gleiches gilt bei händischem Schreiben der Werte.

Ich vermute also das die WP Steuerung bei jedem schreiben der Werte einen Neustart durchführt. Das würde auch erklären warum er heute jedesmal beim Schreiben von Werten die thermische Desinfektion gestartet hat. Diese ist nämlich auf Dienstag eingestellt und da der Regler neu startet denkt er vermutlich das er noch desinfizieren muss obwohl das gerade geschehen ist. Habe die thermische Desinfektion nun auf Mittwoch gelegt und damit war erstmal gut. Wobei mich das Problem natürlich weiterhin beschäftigt.

Vielleicht könntest du ja mal drauf schauen.
Hier mal ein paar Eckdaten:

Von deinem Adapter selbst habe ich alle Funktionen ausgeschaltet, da ich nur die Datenpunkte brauche und den Rest über mein Javascript steuere.

Hast du, oder auch gern jemand anderes, eine Idee was das ist bzw. wie ich den Adapter ohne Fehler zum laufen bekomme?

Vielen Dank schon jetzt, allein fürs Lesen ;)

[TbsJah]

@Chriz sagte:
Nun ist es so das ich in deinem Adapter im Log, bei jedem Schreibvorgang, Fehler bekomme:

luxtronik2-controller.0
2026-09-29 17:31:40.669	error	Failed to finalize downstream state change command event pipeline execution loop: Timeout writing TCP parameter 105.

Eine weitere Auswirkung ist dass der Luxtronik Controller anscheinend neu startet. per Webinterface verliere ich dann nämlich für 1min die Verbindung.

Der positive Punkt ist dass das lesen funktioniert und die Werte aktualisiert werden 👌
Das nächste Positive ist dass es mit dem alten Adapter von @unclesam auch funktioniert hat.
Also liegt es an meinem Adapter und nicht an deiner Anlage

Daher diese Vermutung
Der alte Luxtronik-Controller (V1.x) hat einen extrem schwachen, Single-Threaded-Netzwerkchip. Er kann strikt immer nur eine einzige TCP-Verbindung auf Port 8889 gleichzeitig verarbeiten.

Wie der alte Adapter es gemacht hat: Er hatte eine starre, globale Warteschlange. Es wurde alles hintereinander gemacht.

Der neue Adapter arbeitet asynchron. Es kann passieren, dass das regelmäßige Polling (updateData liest Werte) startet. Exakt in dieser Sekunde triggert die Takt-Optimierung oder der Nutzer einen Schreibbefehl (queueWrite). Der Adapter öffnet einen zweiten TCP-Socket, während der erste noch offen ist. ZACK! Die Steuerung der Wärmepumpe ist überfordert, der Netzwerk-Stack stürzt ab und das gesamte Gerät rebootet.

Weil die Anlage rebootet, bricht die Verbindung wortlos ab und der Adapter wirft den Timeout writing TCP parameter Fehler aus.

Daher habe ich für 1.x Firmware Anlagen (und nur für die) das Abfragen und Schreiben strikt getrennt.
Ich hoffe dass das schon die Lösung ist 🙏🏻

Prüfe bitte die neue 0.11.2

• Features & Verbesserungen:

  • Legacy Schreib-Modus (V1.x): Neue Option in den Verbindungseinstellungen für alte Wärmepumpen (Firmware V1.x). Dieser Modus verhindert den Fehler Timeout writing TCP parameter bei Controllern, die nach einem Schreibbefehl keine Netzwerk-Bestätigung (ACK) zurücksenden.
  • Dynamischer Hardware-Schutz: Der Adapter erkennt nun die installierte Firmware und passt die Pausenzeiten beim Schreiben dynamisch an (500ms für alte V1.x Anlagen, schnelle 100ms für moderne Anlagen).
  • Sicheres Runden von Werten: Alle Zahlenwerte, die an die Anlage gesendet werden, werden nun strikt zu Ganzzahlen gerundet. Dies verhindert Speicherfehler und Abstürze bei alten Controllern, die keine Fließkommazahlen verarbeiten können.
  • Visibility-Filter Hinweise: Der Hilfetext für das automatische Ausblenden nicht unterstützter Parameter wurde angepasst, um V1/V2-Nutzer vor Timeout-Fehlern zu warnen.

• Fehlerbehebungen (Bugfixes):

  • Wärmepumpen-Abstürze behoben: Es wurde ein globaler Lock zwischen dem Lese-Zyklus (Polling) und der Schreib-Warteschlange eingebaut. Lese- und Schreibvorgänge können sich nun nicht mehr überschneiden. Dies verhindert fatale Socket-Kollisionen, die alte V1.x Anlagen zum Absturz und Neustart gezwungen haben.
  • Objekt-Bereinigung repariert: Das Löschen von verwaisten Datenpunkten beim Adapter-Start erfolgt nun sequenziell statt parallel. Dadurch wird die ioBroker-Datenbank nicht mehr überlastet und alte Datenpunkte verschwinden zuverlässig aus dem Objektbaum.

[Chriz]

Danke für die ausführliche Nachricht! Top.

So habe ich deinen Adapter installiert, das führte aber zu Version 0.12.1.
Kann ich davon ausgehen dass das auch i.O. ist?
Ich bin nämlich zu doof eine bestimmte Version zu installieren. Weder per Github noch NPM hab ich es hinbekommen. Gemini meinte dann ich soll es machen wie im Screenshot. Nur so bin ich überhaupt an deinen Adapter rangekommen ;-)

Edit:
Hat leider nicht funktioniert, ein manuelles Schreiben des WW Sollwertes hat wieder die gleichen Fehler produziert.

luxtronik2-controller.0
2026-09-30 15:49:49.533	error	Failed to finalize downstream state change command event pipeline execution loop: Timeout writing TCP parameter 105.

Auch das Webinterface "lost connection". Also gehe ich da auch von einem Reglerneustart aus. :(

[TbsJah]

Mist!
Bei dem alten Adapter hatte es aber funktioniert? Wie?
Passiert das bei allen Werten?

[TbsJah]

@chriz noch eine Bitte
Bitte installiere über NPM oder über ioBroker direkt
Nicht über Datei oder GitHub! Dann kann ich bereits eventuelle Fehler bei der Installation ausschließen

Und noch einmal die Frage
Per UncleSam Adapter hat das Schreiben der Werte funktioniert? Wenn ja, wie hast du sie beschrieben

[TbsJah]

0.13.1 (2026-10-02)

• Fix (Circulation/ZIP): Fixed a bug where the Virtual_ZIP_Status datapoint would remain stuck on true when using external relays (e.g., Shelly), even though the hardware relay was correctly turned off. The state reset logic has been decoupled and is now guaranteed to execute, ensuring the ioBroker interface stays perfectly synchronized with the actual hardware state.

0.13.0 (2026-10-02)

• Bugfixes:
  • Critical DHW Target Fix: Fixed an issue where the hot water target temperature was incorrectly written to parameter 2 instead of 105. This resolves unexpected temperature jumps (e.g., to 65°C) and socket timeouts on various heat pump models.
  • Write Queue Timeout: Added a maximum wait timeout to the write queue lock for legacy V1.x firmware to prevent potential infinite loops during read-write collisions.
  • Backup Manager Multi-Instance Fix: The automated DTA backup cron job is now safely scoped to the specific adapter instance, preventing conflicts when running multiple heat pumps on the same ioBroker host.
• Under the Hood / Refactoring:
  • Centralized Typings: Completely refactored the TypeScript architecture by introducing a centralized LuxtronikAdapter interface (types.ts). Replaced all fragmented, local interfaces across sub-modules to ensure strict, project-wide type safety and better maintainability.

[TbsJah]

@chriz Das Thema hat mir keine Ruhe gelassen 🤦‍♂️
Bei der Überprüfung des kompletten Codes sind mir ein paar Sachen aufgefallen, die nun behoben sind. Hoffentlich löst die jetzige Version 0.13 damit dein Problem mit dem Schreiben.

Wenn nicht, habe ich ein TypeScript erstellt, mit dem du dich direkt im JS-Adapter mit der Wärmepumpe zum Testen verbinden kannst (komplett am Luxtronik-Adapter vorbei). Wichtig: Vor dem Ausführen unbedingt die Luxtronik-Instanz(en) stoppen, da sonst der Port blockiert ist!
Da finden wir dann hoffentlich schnell den Fehler.
Das Skript ist hier zu finden: Link

Spoiler

🛠 Troubleshooting / Error Analysis

Raw TCP Test Script (Test_Script.ts)

In rare cases (especially with older firmware versions like V1.x), connection drops or timeouts can occur when writing values (e.g., Timeout writing TCP parameter 105).

To determine whether the issue lies with the adapter or the heat pump itself, this repository includes an isolated test script (Test_Script.ts in the src folder). This script bypasses the adapter completely and communicates directly with the Luxtronik controller via raw TCP sockets. It tests read and write access by reading the hot water target value, slightly increasing it as a test, and immediately restoring the original value.

Execution in ioBroker:

1. 🛑 IMPORTANT: You must stop all running Luxtronik adapter instances in ioBroker (set them to "Red")! Older Luxtronik controllers only allow a single simultaneous network connection. If an adapter continues to run in the background, the port is blocked, and the script will inevitably run into a timeout.
2. Copy the content of the Test_Script.ts file into a new script in the ioBroker JavaScript adapter (select Type: TypeScript).
3. Adjust the HOST constant at the very top of the script to match the IP address of your heat pump.
4. Start the script and check the ioBroker log output.

Result Evaluation:

• ✅ SUCCESS: The script completes quickly and the heat pump acknowledges the write command. This means your system (and its firmware) accepts write commands without errors.
• ❌ TIMEOUT / ERROR: The script hangs during reading/writing or is rejected. This means the system physically refuses TCP communication. Common causes for this are blocked ports (by Loxone, FHEM, or other smart home systems), firmware protection mechanisms, or a crashed network card in the heat pump (a hard power reset of the heat pump often helps here). The adapter cannot bypass this deep-level network issue.