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

[TbsJah]

Aktuelle Test Version	0.20.4
Veröffentlichungsdatum	24.10.2026
Github Link	TbsJah/ioBroker.luxtronik2-controller
npm	iobroker.luxtronik2-controller

Beschreibung
Grundlage war der Luxtronik2 Adapter von @unclesam. Dieser ist aktuell etwas in die Jahre gekommen, bzw. hatte ich sehr viele Scripte drumherum gebaut, welche ich nun zu einem eigenen Adapter zusammengefasst habe.

Der Adapter läuft bei mir seit einiger Zeit stabil an meiner LWD50A, daher der Entschluss, ihn hier für alle zu veröffentlichen. Testen passiert natürlich auf eigene Gefahr!

Transparenzhinweis: Bei der Entwicklung und dem Code-Rewrite hatte ich Unterstützung von KI.

Dieser ioBroker-Adapter ermöglicht die lokale Steuerung und Überwachung von Wärmepumpen mit Luxtronik 2.x Steuerung (z. B. Alpha Innotec, Novelan). Der Adapter ist vollständig in TypeScript geschrieben.

Features

• Native TCP-Kommunikation: Direkte Verbindung zur Wärmepumpe ohne zusätzlichen Overhead.

• COP & JAZ (Effizienz-Rechner): Die Effizienz der Wärmepumpe kann nun direkt im Adapter berechnet und getrackt werden (Heute, 7 Tage, Monat, Jahr). Dabei wird live zwischen Heizen, Warmwasser und Gesamt getrennt. Es können die internen Luxtronik-Schätzwerte oder hochpräzise externe Zähler (z.B. Shelly 3EM per Objekt-ID) genutzt werden.

• Verdichter-Schonung (Takt-Optimierung): Zusammenlegung von Heiz- und Warmwasserzyklen zur Reduzierung der Verdichterstarts.

• Dynamische HUP-Regelung: Automatische Anpassung der Heizungsumwälzpumpe anhand der Vor- und Rücklauf-Spreizung zur maximalen Effizienz.

• Integrierte Aktionen (Makros): Vordefinierte Steuerungslogiken für Zwangsheizen, Warmwasseranforderung und die Zirkulationspumpe (ZIP) inkl. automatischem Rückfall auf Standardwerte.

• Bedarfsgerechte Zirkulation (ZIP): Steuerung der Zirkulationspumpe über vorhandene ioBroker-Bewegungssensoren oder direkt über externe Aktoren (z. B. Shelly) – ganz ohne Hardware-Eingriffe in die Wärmepumpe.

• Benutzerdefinierte Datenpunkte: Messwerte (Index 3004) und Parameter (Index 3003) können über die Adapter-Konfiguration flexibel hinzugefügt werden. Unix-Zeitstempel werden dabei automatisch lesbar formatiert.

• Erweiterte Status-Texte & Berechnungen: Live-Berechnung von Spreizung, thermischer Energie und detaillierte Text-Ausgabe der aktuellen Anlagenzustände (inkl. Offsets, Frostschutz und Kühlstatus).

• Intelligentes Benachrichtigungssystem: Fehlercodes und kritische Abschaltungen (wie Durchflussprobleme) können direkt an Telegram oder das ioBroker-Benachrichtigungssystem gesendet werden – inklusive Cooldown-Spamschutz.

• Automatisches DTA-Backup: Zeitgesteuerter Download der DTA-Diagnosedaten direkt aus der Wärmepumpe in den ioBroker-Speicher zur leichten Analyse (z. B. in OpenDTA)

• Automatisches Objekt-Management: Abgewählte oder gelöschte Datenpunkte sowie leere Ordnerstrukturen werden bei einem Adapter-Neustart automatisch und sauber aus dem ioBroker entfernt

• Breite Kompatibilität: Volle Unterstützung für ältere (V2.x) und neuere (V3.x) Firmware-Generationen (z. B. Alpha Innotec, Novelan) durch dynamische Skalierungsfaktoren.

Bilder

Spoiler

Changelog

Spoiler

0.20.4 (2026-10-24)

🔧 Maintenance & Compatibility

• Repository Checker Fixes: Addressed multiple warnings from the ioBroker repository checker.
• Node.js Requirement: Updated minimum Node.js requirement to >= 22 in package.json and io-package.json to meet current adapter standards.
• UI Layout: Added missing responsive size attributes (xs, sm, md, lg, xl) to elements in the new updates configuration tab.
• Translations: Added missing i18n translations for all supported languages in the configuration dropdown menus (COP sources and ZIP control mode).
• Metadata: Removed non-existent version entries from the news section in io-package.json.

✨ Features & Enhancements

• Notification Center: Introduced a dedicated notification category (lwpSystem) for firmware updates and system info to cleanly separate them from critical heat pump errors in the ioBroker UI.

0.20.1 (2026-10-22)

🐛 Bugfixes & Tweaks

• Modbus Factor Correction: Explicitly set the scaling factor for the heating target temperature offset (Luxtronik ID 1 / Holding 23) to 10 to correctly handle and display Modbus TCP values in tenths of a degree (e.g., 5.0 °C instead of 50).
• Configuration UI: Clarified the English and German labels for heating parameters (such as base point and parallel offset) in the adapter settings to prevent mapping confusion.

0.20.0 (2026-10-22)

🚀 Features & Enhancements

• Automatic Firmware Update Check: Added a background service to automatically check the official AIT download portal for new heat pump firmware updates.
• Update Notifications: Added a new configuration tab to set a custom cron schedule and enable optional Telegram notifications when a new firmware version is released.
• New Update Datapoints: Added firmware_available, firmware_update_available, and firmware_changelog to the system info tree to directly expose update states and release notes in ioBroker.
• Manual Trigger Button: Added a check_firmware button to manually initiate the update check process at any time.

0.19.6 (2026-10-22)

🚀 Features & Enhancements

• Defrost Request Datapoint: Added Information.03_Outputs.DefrostRequest2 (Defrost request) to monitor the active defrosting request of the heat pump directly from the RAM telemetry (Index 235).

• Defrost Request Datapoint: Added Information.03_Outputs.DefrostRequest (Defrost request) to monitor the active defrosting request of the heat pump directly from the RAM telemetry (Index 234).

0.19.4 (2026-10-20)

🔧 Compatibility & Maintenance

• Hybrid Modbus Value Persistence: Prevented native 3003 telemetry polling (EEPROM) from overwriting volatile parameters actively managed via Modbus TCP (RAM) in the ioBroker object tree.

0.19.3 (2026-10-20)

🔧 Compatibility & Maintenance

• Broader Node.js Compatibility: Adjusted Node.js removed { "node": ">=18.0.0" } in dependencies in io-package.json. T

0.19.2 (2026-10-20)

🔧 Compatibility & Maintenance

• Broader Node.js Compatibility: Adjusted Node.js engine requirement from >=22 down to >=18.0.0 in package.json and added { "node": ">=18.0.0" } to dependencies in io-package.json. This enables full compatibility with widely used Long-Term Support (LTS) releases (Node.js 18 and 20) while preventing installation on deprecated runtimes.
• Hybrid Modbus Value Persistence: Prevented native 3003 telemetry polling (EEPROM) from overwriting volatile parameters actively managed via Modbus TCP (RAM) in the ioBroker object tree.

0.19.0 (2026-10-19)

🚀 Features & UX Improvements

• Hybrid Modbus TCP Support: Introduced hybrid Modbus TCP support (modbus-serial) to write volatile parameters (e.g., target temperatures, heating curves, and coils/switches) directly into the Luxtronik RAM without causing EEPROM/flash memory wear, while continuing to read full telemetry via native port 8889/8214.
• Smart ZIP Configuration: Completely redesigned the Circulation Pump (ZIP) tab in the Admin UI. Introduced a dynamic dropdown (zip_control_mode) to intuitively switch between Internal Controller, External Actor (e.g., Shelly), and Modbus TCP (Coil 7), automatically hiding irrelevant settings to prevent misconfigurations.
• ZIP Countdown Timer: Added a new virtual datapoint (Information.03_Outputs.Virtual_ZIP_Remaining_Time) that displays the remaining runtime of the active circulation pump cycle in seconds.
• Seamless Migration: Implemented an automatic background migration routine to seamlessly upgrade existing user configurations to the new ZIP control logic without data loss.

🐛 Bugfixes

• Telegram Notifications UI: Fixed a logic issue in jsonConfig.json where the Telegram warning message was incorrectly displayed even when instances were installed and available, and fixed the broken icon on the test button.

📝 Documentation

• ARM Installation Notes: Added a troubleshooting note to the README clarifying that usocket, serialport, and node-gyp compilation errors on Raspberry Pi / ARM systems originate from optional serial dependencies and can be safely ignored.

0.18.2 (2026-10-17)

🔧 Maintenance & Repository Compliance

• Core Dependency Update: Raised minimum required js-controller dependency to >=7.0.7 in io-package.json to ensure compatibility with modern ioBroker environments (resolves E1057).
• Full i18n Localization for Admin UI: Added complete multi-language label sets (ru, pt, nl, fr, it, es, pl, uk, zh-cn) for COP power and thermal source selection dropdowns in jsonConfig.json (resolves W5611).
• Package News Cleanup: Removed unreleased intermediate tags (0.17.0, 0.16.1) from common.news in io-package.json to align strictly with published NPM releases (resolves W2004).
• CI/CD Security Compliance: Updated GitHub auto-merge workflows for Dependabot to adhere to GitHub's updated pull_request_target execution policies (PR #90 / Issue #89).
• Code Modernization: Migrated built-in Node.js module imports to use the explicit node: protocol prefix (e.g. node:fs, node:path).

0.18.1 (2026-10-13)

🐛 Bugfixes

• COP Database Persistence: Fixed a critical bug in the object manager's cleanup routine (cleanupStates). The internal database folder (hidden.cop_buckets) was missing from the exclusion list and got aggressively deleted upon every adapter restart, resulting in wiped COP histories and (null) values. The hidden states are now strictly protected against the cleanup process, ensuring long-term persistence for energy calculations.

0.18.1 (2026-10-13)

🐛 Bugfixes

• COP Database Persistence: Fixed a critical bug in the object manager's cleanup routine (cleanupStates). The internal database folder (hidden.cop_buckets) was missing from the exclusion list and got aggressively deleted upon every adapter restart, resulting in wiped COP histories and (null) values. The hidden states are now strictly protected against the cleanup process, ensuring long-term persistence for energy calculations.

0.18.0 (2026-10-12)

🚀 Features & Enhancements

• Smart PWM Pump Detection: The hupManager now automatically detects whether the heating circulation pump (HUP) is controlled via a PWM signal (verified by checking if heating_max_circ_pump_speed > 0%). If this is the case, the obsolete dynamic 0-10V voltage optimization is automatically bypassed. This saves system resources and prevents unnecessary write commands to the Luxtronik controller.

🐛 Bugfixes

• HUP Voltage Validation Fixed: Fixed an issue where ioBroker threw a warning ("nur zwischen 3 und 10 V erlaubt") in the log for HUP voltage values below 3V. The object definitions for minimum and nominal voltage have been explicitly updated to min: 0 and max: 10. This successfully overwrites lingering cache limits in the ioBroker database and allows the pump to transition into 0V standby mode without throwing errors.

0.17.3 (2026-10-12)

🚀 Features & Enhancements

• Persistent COP Counters: Raw energy counters (last_raw_power, last_raw_thermal) are now safely stored in the ioBroker database (hidden.cop_buckets) instead of volatile RAM. Consumption data is no longer lost during adapter instance or ioBroker host restarts, ensuring seamless and continuous delta calculation.

🐛 Bugfixes

• Anti-Flapping Protection for Energy Counters (Root-Cause Fix): Fixed a timing bug that caused the internal sum counters for thermal and electrical energy (thermalenergy_total, energy_total) to temporarily drop to 0 kWh. The calculation function (calculateSum) now blocks physically impossible negative jumps and only writes new sums if they are greater than or equal to the previous peak value.
• COP Operating State Recognition: The COP script no longer ignores energy increments for heating and hot water. The evaluation of the operating state (WP_BZ_akt) has been improved to reliably parse text strings with parentheses (e.g., "Warmwasser(1)" or "Heizbetrieb(0)"), correctly sorting the calculated deltas into their respective buckets (Heating / HotWater).
• CI/CD & Code Quality: Resolved strict ESLint rule violations (curly) in the copManager by adding block braces to single-line if conditions, allowing the GitHub Actions build pipeline to pass successfully.
• Core Anti-Flapping Protection for Energy Counters: Fixed a critical timing and raw data glitch where the heat pump occasionally transmits 0 kWh for cumulative energy counters. A strict validation gate was implemented directly into the core polling loop (main.ts). All incoming updates for energy, thermal, and power states are now intercepted and discarded if they are lower than the currently persisted ioBroker state. This prevents faulty zero-drops from ever reaching the database and ensures clean, continuously rising graphs in history adapters like InfluxDB.

0.17.2 (2026-10-11)

🛠 Bugfixes & Enhancements

• Log copManager: Fixed an issue regarding the log output in the COP calculation engine.

0.17.1 (2026-10-11)

🛠 Bugfixes & Enhancements

• Code Quality & CI/CD: Fixed ESLint no-prototype-builtins pipeline failures in objectManager.ts by replacing direct .hasOwnProperty() calls with safe Object.prototype.hasOwnProperty.call() methods.

0.17.0 (2026-10-11)

🚀 Features

• COP & Efficiency Calculator: Introduced a comprehensive COP (Coefficient of Performance) calculation engine to track heat pump efficiency.
• External Smart Meter Support: Users can now choose to use internal Luxtronik estimates or link high-precision external sensors (e.g., Shelly 3EM or M-Bus heat meters) via ioBroker Object IDs for power consumption and thermal energy generation.
• Granular Live Metrics: The adapter now dynamically analyzes the active operating state to split and calculate live daily COP values for "Total", "Heating", and "Hot Water" independently.
• Persistent Time Rollovers: Implemented a robust "snapshot" system with absolute virtual counters. The adapter automatically detects day, month, and year rollovers to persist data and guarantee accurate long-term calculations, even across adapter restarts or ioBroker reboots.
• Dedicated Efficiency UI: Added a new "Efficiency / COP" configuration tab to easily manage energy data sources and toggle the calculation engine.
• Connection & Polling Status: Added a new system datapoint info.lastUpdate. This state continuously tracks the exact timestamp of the last successful data retrieval, making it easy to monitor the adapter's health and polling activity in visualisations like VIS or Lovelace.

🛠 Bugfixes & Enhancements

• Object Tree Creation: Fixed an issue where hidden data buckets for the COP calculation were not created because parent directories were missing.
• Timestamp Formatting: Resolved a strict type mismatch error in the ioBroker log by correctly formatting info.lastUpdate as an ISO string instead of a numeric timestamp.
• State Properties & Code Quality: Resolved strict TypeScript and ESLint warnings (missing JSDoc annotations, missing read/write object definitions) in the new COP manager.
• Modernized ioBroker API: Replaced deprecated setStateAsync method calls with the modern, promise-based setState standard across the COP calculation engine.
• Config UI Sorting: Ensured the newly generated configuration tabs maintain a logical and consistent order across rebuilds.
• Internal Mapping: Restructured the info folder mapping to cleanly accommodate adapter-level metadata alongside hardware telemetry.

0.16.1 (2026-10-11)

🚀 Features

• Enhanced UI Layout: Improved the "Datapoints" settings tab layout to display up to 4 items side-by-side on larger screens for a better overview and improved usability.

🛠 Bugfixes & Enhancements

• State Cleanup Logic Fixed: Resolved an issue where unchecked datapoints (e.g., Room Thermostats) were not removed from the ioBroker object tree. The isStateEnabled logic now correctly handles undefined config states for dynamically generated checkboxes.

0.16.0 (2026-10-11)

🚀 Features

• Dynamic Admin UI Generation: The "Datapoints / Objects" configuration tab in the adapter settings is now fully auto-generated during the build process (prebuild). This ensures the UI is always 100% in sync with the underlying TypeScript state mappings.
• Category Master Switches: Added master toggle switches to the adapter settings. Users can now enable or disable entire hardware categories (e.g., Solar, Cooling, Ventilation) with a single click. This keeps the ioBroker object tree clean and significantly reduces unnecessary polling for unused features.
• Dynamic Protection for Critical States: System-critical datapoints are now protected dynamically via a required: true flag in the codebase. They are permanently locked (grayed out) in the UI and cannot be accidentally deleted or disabled by the user or the visibility filter.

🛠 Bugfixes & Enhancements

• Cycle Optimization Logic (Hot Water): Fixed a logic flaw where the adapter erroneously applied an artificial hot water target temperature increase while the heat pump was already actively running a hot water cycle. The trigger is now strictly limited to the end of regular heating cycles.
• Build Process Optimized: Integrated the UI generation script (generateConfig.ts) seamlessly into the NPM prebuild lifecycle, automatically patching the jsonConfig.json before typescript compilation.

0.15.1 (2026-10-10)

🛠 Bugfixes & Enhancements

• Admin UI (ZIP Control): Completely revised the explanatory text for the Circulation Pump (ZIP) settings in jsonConfig.json. Clarified the exact behavior of the "Disable base ZIP values" (zip_lWP_aktiv) option to prevent unintentional power cuts to external Wi-Fi relays (like Shelly) while maintaining EEPROM hardware protection.
• Testing Framework: Updated @iobroker/testing to version 6.3.0 to meet current repository standards.
• Changelog Formatting: Fixed Markdown header formatting to comply with ioBroker "Test and Release" requirements.

0.15.0 (2026-10-10)

####🚀 Features

• Modularized State Mapping: Restructured the massive stateMapping.ts into smaller, logically separated files (e.g., info.ts, settings.ts, actions.ts) to significantly improve code maintainability, readability, and scalability.
• Improved Admin UI (ZIP Control): Added comprehensive, scenario-based documentation to the Circulation Pump (ZIP) settings in the Admin interface (jsonConfig.json). It now clearly differentiates between continuous power setups (Scenario A) and heat-pump-powered setups (Scenario B). This prevents users from accidentally cutting power to external Wi-Fi relays (like Shelly) when using the EEPROM hardware protection feature.
• New Telemetry Data added: The adapter now automatically reads and creates crucial system values based on the BenPru standard: Compressor frequency (Index 231), Current heat output (Index 257), and Current power consumption (Index 268).
• Extended Shutdown Codes (Outage History): The internal database for heat pump shutdowns has been massively expanded. The adapter now recognizes and translates all 32 official Luxtronik shutdown reasons (e.g., Inverter pause, Hot gas pause, Limit power consumption) into detailed clear text (English & German). This ensures much more precise troubleshooting in the object tree and highly informative Telegram alerts.

####🛠 Bugfixes & Enhancements

• Critical Startup Crashes Fixed: Resolved multiple UNCAUGHT_EXCEPTION errors and communication aborts where the adapter crashed directly during initialization (onReady) or the polling loop. This was caused by missing hardcoded virtual data points (e.g., Regelung_Aktiv, thermalenergy_total, energy_total, opStateCoolingString) that were dropped during the state mapping modularization.
• ZIP Optimization Defaults: Fixed an issue where the circulation pump (ZIP) was unintentionally shut down (Hardware timers forced to 0 ON / 60 OFF) directly after installation. The logic and default values for zip_lWP_aktiv have been clarified to ensure users relying on the Luxtronik's internal power supply do not experience unexpected offline states of their smart relays.
• Visibility Filter (Command 3005) fixed: Resolved a major logic flaw in the cleanupStates function. Previously, the adapter ignored unsupported hardware components (like missing cooling or solar modules) but failed to delete their remnants from the ioBroker object tree. Obsolete datapoints and empty folders are now rigorously removed upon startup.
• Precise Visibility Mapping implemented: The hide-logic (Command 3005) no longer relies on broad folder names. Instead, it now uses the exact, manufacturer-specific visibility index (visiIndex) for every individual module to accurately show or hide features.
• HUP Optimization (Temperature Spread Control): Dynamic voltage adjustment of the heating circulation pump during heating operation now only triggers after the state has been active for at least 10 minutes and compressor 1 (VD1) is actively running. This prevents premature voltage shifts during startup phases before the thermal spread has stabilized.
• Outage & Malfunction Monitoring: Fixed tracking logic in checkAndSendOutageNotifications: Luxtronik outage code 0 (Heat pump malfunction / WP-Störung) is no longer erroneously skipped. Both low flow issues and direct heat pump shutdowns now reliably dispatch alarms via Telegram and the ioBroker Notification Center.

0.14.1 (2026-10-06)

• log entry for chunk reporting

0.14.0 (2026-10-06)

✨ New Features & Improvements

• Hardware Protection Shield implemented: Dynamic firmware verification before every write operation to protect against the reboot bug present in firmware versions 1.90.x and 2.90.x.
• Visibilities completely overhauled: The internal logic for command 3005 has been rewritten (dynamic detection of 1-byte and 4-byte arrays). The adapter now reads the visibility flags flawlessly across all firmware versions. Hiding non-existent hardware in the object tree now works perfectly for V1.x and V2.x systems without causing crashes or timeouts!

🛠 Bugfixes & Refactoring

• Adapter Configuration (UI): Removed outdated warning labels regarding the "Hide unsupported parameters" checkbox, as this feature is now completely stable across all controller generations.
• Network / WebSocket: The experimental password transmission for port 8214 has been completely removed, as the communication issue was proven to be caused by the manufacturer's firmware bug. The WebSocket connection for genuine V3.x firmwares operates cleanly again using the proven standard handshake.

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.

0.12.1 (2026-09-30)

• Bugfixes:
  • Fixed Null-Values on Startup: Virtual states for the circulation pump logic (Actions.Activate_Zip and 03_Outputs.Virtual_ZIP_Status) are now explicitly initialized to false during adapter startup. This prevents undefined null values in the object tree, ensuring immediate compatibility with visualizations and logic scripts (like Blockly) right from the first second.

0.12.0 (2026-09-30)

• ⚠️ BREAKING CHANGE:

  • The datapoint to manually trigger the circulation pump macro (Activate_Zip) has been moved from the Settings folder to the Actions folder for better UX. If you use this state in your scripts or visualizations, please update the datapoint path!

• Features & Improvements:

  • Virtual Circulation Pump (ZIP) Status: Added a new read-only indicator datapoint (Virtual_ZIP_Status) in the 03_Outputs folder. This datapoint mirrors the true state of the adapter's intelligent circulation pump macro in real-time. This is highly beneficial for users controlling the ZIP via external smart relays (e.g., Shelly) to avoid controller flash-wear, as it provides an accurate status even when the heat pump's internal display is bypassed.

0.11.2 (2026-09-30)

• Features & Improvements:

  • Legacy Write-Mode (V1.x): Added a new connection setting for older heat pumps (Firmware V1.x). This "Fire-and-Forget" mode prevents Timeout writing TCP parameter errors on controllers that do not send network acknowledgments after receiving a write command.
  • Dynamic Hardware Protection: The adapter now automatically detects your firmware version and adjusts network write delays dynamically (500ms for V1.x vs. 100ms for modern firmwares) to ensure maximum responsiveness without sacrificing stability.
  • Safe Payload Rounding: Enforced strict integer rounding (Math.round) for all numeric write payloads to prevent memory faults and crashes on older Luxtronik controllers.
  • Visibility Filter UX: Added a warning to the visibility filter configuration (Command 3005) to clarify that this feature requires Firmware V3.x and should be disabled on older systems to avoid startup timeouts.

• Bugfixes:

  • Fixed Heat Pump Crashes / Reboots: Implemented a global mutex lock between the polling cycle (updateData) and the write queue. This guarantees that read and write operations never overlap, preventing fatal network socket collisions that caused V1.x controllers to freeze and reboot.
  • Fixed Object Cleanup: Changed the mass deletion of orphaned objects and empty folders during adapter startup from parallel to sequential execution. This prevents the ioBroker database from being overloaded and silently dropping delete commands.

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.

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.

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.

0.7.3 (2026-09-07)

Bugfixes
-(Fixed) Timer Table Register Conflict: Resolved conflicting Luxtronik register IDs for Domestic Hot Water (DHW) Monday–Sunday schedules (WW_MoSo_Start1 to End5). These were previously mapped to registers 507–516 (colliding with Circulation timer registers) and have now been corrected to registers 406–415.

-(Fixed) Time-String Conversion on State Change: Fixed a parsing bug where manual updates to time strings (HH:MM / HH:MM:SS) on states marked with isDurationFormat or time-related roles were passed directly as strings instead of converting to seconds since midnight, preventing user-entered schedule values from persisting in the controller.

0.7.2 (2026-09-07)

Bugfixes

• (Fixed) Unintended Configuration Overwrites: Fixed a critical architectural flaw where the adapter blindly forced default values (e.g., hot water target temperature, heating curve) to the heat pump on every startup. The adapter is now 100% passive (read-only) upon installation until features are explicitly enabled.

• (Fixed) Strict Opt-In Logic: All internal condition checks for background automations (cycle optimization, ZIP optimization, idle resets) were refactored to strict opt-in logic (=== true), preventing unintended actions when settings have never been saved.

• (Fixed) Live Toggle for Cycle Optimization: Fixed an issue where the ioBroker switch Actions.Regelung_Aktiv was ignored during runtime. The optimization loop now evaluates this switch dynamically, allowing users to toggle the feature live via their dashboard.

• (Fixed) Hardware ZIP Timer Disable: Fixed a bug where a mismatched configuration key (zip_hardware_timer_disable instead of zip_lWP_aktiv) prevented the adapter from correctly disabling the hardware circulation pump timer for flash memory protection.

• (Fixed) "Heating after hot water" Reset: Restored missing logic that properly resets the "Heating after water" status back to false at the end of a cycle, preventing the system from getting stuck in this mode.

Features & Change

• (Changed) Forced DHW Safety Limit: Reduced the internal safety limit for temporary hot water target adjustments during forced DHW runs from 75°C to 70°C to better protect the system's high-pressure switch.

0.7.1 (2026-09-07)

Bugfixes

• (Fixed) Status Display: Fixed a logical evaluation bug where the operating state "Heating" (Code 0) was incorrectly overwritten and displayed as "No demand" (Code 5). Thanks to @michiproep for reporting!

• (Fixed) Temperature Values: Fixed a related issue where temperature readings of exactly 0 °C (e.g., average temperature, return target temperature, cooling release) were incorrectly replaced by internal fallback values (e.g., 1.5 °C).

0.7.0 (2026-09-04)

Features & Changes

• (Changed) Cycle Optimization & Forced Hot Water: To force a hot water cycle, the adapter now temporarily increases the hot water target temperature instead of modifying the hysteresis. This crucial safety improvement allows users to manually revert changes directly on the heat pump display without needing an installer password.
• (Changed) Disable default: Disabled reset to default values in idle mode by default on initial start
• (Removed) Hysteresis Protection: Removed all dynamic manipulations of the hot water hysteresis (e.g., during idle or active DHW cycles) to ensure installer-level settings remain untouched.
• (UI/Docs): Added detailed explanations and trigger rules for "Intelligent Cycle Optimization" and "Heating after hot water" directly to the admin configuration page.

Bugfixes

• Fixed adapter checker warning [W0066] by downgrading @types/node dependency to v22

0.6.6 (2026-08-31)

review / fix findings reported by claude based checker.
Extended minimum limit for temperature_outdoor_min from -20°C to -25°C
Lowered minimum allowed value for heating_curve_parallel_offset (base point) from 20°C to 15°C
Disabled dynamic cycle optimization / regulation by default on initial start

0.6.5 (2026-08-07)

• review / fix findings reported by claude based checker.

0.6.4 (2026-07-23)

• Refactoring

0.6.3 (2026-07-23)

Features & Enhancements

• External Actor Support for ZIP (100% Flash Safe): Added the ultimate hardware protection feature. Users can now configure a list of external actors (e.g., Shelly or Zigbee relays) via their object IDs in the Admin UI. When motion is detected, the adapter switches these relays directly, completely bypassing the heat pump and reducing Luxtronik EEPROM write cycles to absolute zero.
• External Actor Schedule Compliance: External ZIP actors now dynamically respect the Luxtronik ZIP time tables (Week, 5+2, or Individual days). Motion triggers will be cleanly ignored if they occur outside the permitted time windows, unless the user explicitly checks the "Disable Hardware ZIP Timers" option in the configuration.
• Hot Water Sync for External Actors: The adapter now automatically activates external circulation pump relays when the heat pump begins a hot water generation cycle, maximizing comfort at the tap with zero impact on flash memory wear.
• Global EEPROM Flash Protection (Read-Before-Write): Implemented a global interceptor for all hardware write commands (writePumpSafe). The adapter now caches the current heat pump parameters in real-time and strictly blocks any duplicate or redundant write requests before they are sent over the network.
• Automated Hardware-Safe ZIP Defaults: The adapter can now automatically enforce hardware-safe circulation pump schedules upon startup. Accounts for Luxtronik firmware behavior by intelligently setting the first start block to 00:01:00 (60 seconds) to prevent invalid zero-run rejections, while keeping ON-time at 0 min and OFF-time at 60 min.
• Admin UI - Flash Wear Statistics & Guidance: Expanded the ZIP configuration page with detailed educational information. Added hard data explaining that internal ZIP control causes between 4 and 14 physical write operations per activation, highly recommending the new external actor setup.
• Write Cycle Monitoring: Introduced two new virtual data points under System Info (write_cycles_today and write_cycles_total) to transparently track physical write operations sent to the heat pump. The daily counter automatically resets every night at midnight.
• Cooling Extension & Intelligent Status: Comprehensive integration of new cooling data points (e.g., cooling_status, cooling_configured, opStateCooling). Added the dynamically calculated opStateCoolingString.
• Admin UI - Notification Testing: Added a dedicated "Send Test Message" button to the configuration interface to easily verify Telegram and ioBroker Notification Center setups directly from the UI.
• Hardened ZIP Macro Execution: Reaffirmed and secured the ZIP demand-driven macro to exclusively use the deaeration program (Entlüftungsprogramm).
• New Flow Rate Datapoints: Added flow rate tracking for the heat source (flow_rate_heat_source, ID 173) and cooling (flow_rate_cooling, ID 254) to the state mapping.
• Extended Admin UI: All newly added cooling data points and the heat source flow rate can now be individually enabled or disabled via new checkboxes in the adapter configuration (jsonConfig.json).
• New Hardware Supported: Officially added the MSW2-9S heat pump to the model recognition (HP_TYPES).

Bugfixes

• Motion Sensor Cooldown Logic: Fixed an issue where the 10-minute anti-cycling cooldown for motion sensors was perpetually stuck when using external relays. The logic now correctly monitors the virtual Activate_Zip state's timestamp instead of the bypassed internal ZIPout state.
• Virtual State Reset: Fixed a bug where the Activate_Zip button/state remained true after an external relay timer expired, which broke subsequent cooldown calculations. It now cleanly resets to false when the run cycle finishes.
• External Actor State Detection: Fixed a logic flaw where the adapter incorrectly checked the internal heat pump state (ZIPout) instead of the external relay state to determine if the circulation pump was already running. It now dynamically checks getForeignStateAsync for configured actors, cleanly preventing redundant switch commands and allowing silent timer extensions if motion is re-detected.
• Timer Formatting in Objects: Fixed a bug where timer schedules (Heating, Hot Water, Circulation) were incorrectly displayed as raw seconds (e.g., 60 or 0). Applied the internal duration formatter (isDurationFormat: true) globally so all time tables natively and persistently display as HH:MM:SS (e.g., 00:01:00) in the ioBroker object tree.
• Admin UI i18n Compliance: Fixed missing language definitions (E5611) in the jsonConfig.json dropdown menus to strictly comply with the latest ioBroker repository checks.
• TypeScript/Linter Strictness: Fixed strictly typed linter errors (e.g., @typescript-eslint/no-floating-promises, no-redundant-type-constituents, and template literal typings) by correctly handling asynchronous database calls, replacing any with unknown, and strictly casting types.
• Missing Imports: Resolved compilation errors regarding missing helper functions (e.g., getDpPath) during module refactoring.
• Cooling Operating Hours: Fixed the hours_cooling datapoint. The value is now correctly read from real-time telemetry data (raw_value), resolving an issue where the timestamp "Jan 1, 1970" was incorrectly shown.
• Config Cleanup: Fixed an incorrect identifier in the admin UI (changed sync_Gerätezeit to sync_deviceTime) and removed unused/dead checkboxes.

Technical Changes (Under the Hood)

• Separation of Concerns (zipManager): Completely refactored the motion sensor and circulation pump logic. Extracted the event handling and startup initialization out of main.ts into zipManager.ts. It now also dynamically handles iterations over arrays of external actors.
• Network Queue Isolation: Extracted the core transmission queue (queueWrite, processQueue) from the main adapter class into rawFunctions.ts, achieving 100% isolation of TCP/WebSocket network logic from ioBroker state management.
• Comprehensive Code Refactoring (DRY): Created dedicated convert.ts and utils.ts modules to centralize time string formatting (timeStringToSeconds, formatTimerSecondsToTime) and generic helper functions (getNumber, delay).
• Global Time Refactoring: Centralized the duration and time calculation for status texts in the updateStatusStrings function.
• i18n Support for State Names: Updated the internal state definition (name: string | { en: string; de?: string }) to fully support translation objects, allowing natively translated datapoint names in the ioBroker object tree.

0.6.2 (2026-07-17)

Added

• Bilingual support (i18n): Full support for English and German (adapter settings, state names, dropdown menus, and dynamic status texts).
• Language selection: Added a new dropdown menu in the adapter settings to freely choose the preferred output language for the ioBroker object tree.
• Firmware 3.x compatibility: Implemented an intelligent fallback system that dynamically calculates the status texts (heatpump_state_string) and runtime (heatpump_duration) from the main operating state. This is required because modern Luxtronik controllers no longer transmit the old LCD text lines.

Fixed

• Incorrect heating state (Frost protection): Fixed an issue where a switched-off heating system was incorrectly displayed as "Frost protection". The code now evaluates the correct index for the heating operating state (opStateHeating / 125) instead of incorrectly calculating it via the parameter.
• Timer display: Restored the clean HH:MM:SS formatting in the ioBroker UI without the annoying "s" (seconds) by introducing an internal isDurationFormat flag.
• Timer glitch fixed: When the compressor is idle, 00:00:01 (1 second) was often incorrectly displayed. This is now cleanly filtered to 00:00:00.
• ioBroker Repo-Checker warnings: Added the missing write: true property to the timer table selection states (role: "level") to fix the E1011 error.

Technical

• Fixed ESLint warnings (dot-notation) for object properties.

0.6.1 (2026-07-17)

• Implemented fallback mechanism: Index 80 lc is used if 117-120 are empty.
  

[Susanne007]

Hallo zusammen,

herzlichen Dank für den neuen Adapter. Ich musste nun auch auf diesen umsteigen, da nach dem Firmwareupdate auf V3.92.1 der alte luxtronic 2.0 Adapter nicht mehr tut.

Ich habe aber gleich folgendes Problem: Der Adapter verändert mir meine eingestellte Heizkurve. Das möchte ich jedoch gar nicht. Kann man das irgendwie ausstellen?
Ich möchte generell nur "lesen" von meiner WP und erstmal nichts schreiben oder setzen.

Ich bekomme auch nach jedem Neustart des Adapters wie Warnung:
luxtronik2-controller.0
2026-08-27 22:53:57.558 warn State value to set for "luxtronik2-controller.0.Settings.06_SystemSettings.temperature_outdoor_min" has value "-22" less than min "-20"

Ich setzte dann wie von dir im anderen Thread beschrieben im Objekt-Editor das Limit auf -22. Dann hören auch die Warnungen im Log auf. Nach jedem Neustart ist der Wert aber wieder auf -20 und die Warnung kommt wieder.

[TbsJah]

@Susanne007 sagte:

Schau ich mir an
Deine Werte kannst du auch in der Konfig Seite setzen. Dann sollte nichts mehr überschrieben werden. oder erst einmal die Steuerung ausstellen

[Smolo]

@TbsJah sagte:

@Susanne007 sagte:

Schau ich mir an
Deine Werte kannst du auch in der Konfig Seite setzen. Dann sollte nichts mehr überschrieben werden. oder erst einmal die Steuerung ausstellen

Die Steuerung von Geräten sollte bei solchen Adaptern im Default immer deaktiviert sein um Probleme zu vermeiden.

Ich habe ihn grad bei mir Installiert und es schaut bezüglich Lesen ganz gut aus...Danke dafür :-) Allerdings gleich folgende Logmeldungen:

Roth ThermoTerra F6 (Sole Wärmepumpe)
MSW2-6S
V3.89.4

[TbsJah]

@Smolo sagte:
Die Steuerung von Geräten sollte bei solchen Adaptern im Default immer deaktiviert sein um Probleme zu vermeiden.

Stimmt, ist mir wohl für den eigenen Test durchgerutscht. 🤷🏼
Wird in der kommenden Version als Default mit aus gesetzt.

@Smolo sagte:
Ich habe ihn grad bei mir Installiert und es schaut bezüglich Lesen ganz gut aus...Danke dafür :-) Allerdings gleich folgende Logmeldungen:

Ich habe min Werte gesetzt für die Eingabe Werte.
Die kann ich noch weiter heruntersetzen.
Aber inwiefern macht eine Hysterese von 0,5 °C denn Sinn? Da läuft die Pumpe doch eigentlich nahezu durchgehend.

Kommt auch in der nächsten Version.
Instanz für den Adapter solange am besten auf Error stellen dann müllt dein Logo nicht zu.

[Smolo]

@TbsJah sagte:

@Smolo sagte:
Die Steuerung von Geräten sollte bei solchen Adaptern im Default immer deaktiviert sein um Probleme zu vermeiden.

Stimmt, ist mir wohl für den eigenen Test durchgerutscht. 🤷🏼
Wird in der kommenden Version als Default mit aus gesetzt.

Top

@Smolo sagte:
Ich habe ihn grad bei mir Installiert und es schaut bezüglich Lesen ganz gut aus...Danke dafür :-) Allerdings gleich folgende Logmeldungen:

Ich habe min Werte gesetzt für die Eingabe Werte.
Die kann ich noch weiter heruntersetzen.
Aber inwiefern macht eine Hysterese von 0,5 °C denn Sinn? Da läuft die Pumpe doch eigentlich nahezu durchgehend.

Meine Hysterese HR steht bei 1,5k (das ist bei meiner WP auch der Standardwert!) die Logmeldungen sind daher für mich nicht ganz einleuchtend. Ich kann mir höchstens vorstellen das es ein Problem wegen dem Nachkomma gibt und nicht wegen dem zu kleinen Wert.

Grundsätzlich solltest du da aber auch nicht eingreifen gegenüber der WP. Die Werte welche sie liefert solltest du auslesen wie Sie kommen d.h. die Wertebereiche sind auch entsprechend zu definieren. Ich würde hier lediglich viel zu große Werte oder Minusbereiche im Adapter ausschließen zwecks Fehleingaben. Speziell das automatische Übersteuern und unterschiedliche Wertebereiche sind keine gute Kombination ;-)

Nachtrag:

Deine 20 Grad vs. meiner gesetzten 18 Grad Rücklauf sind übrigens auch eine solche Thematik. Ich habe bei mir eine passive Kühlung integriert. Die WP Steuerung hat allerdings einen Bug in der installierten Version weil die Heizung bei Deaktivierung der Kühlung anspringt obwohl sie eigentlich deaktiviert ist und das kann ich nur mit dem niedrigeren Soll stoppen.

Kommt auch in der nächsten Version.
Instanz für den Adapter solange am besten auf Error stellen dann müllt dein Logo nicht zu.

Ich warte noch bis zur nächsten Version... wenn das soweit ist kann ich auch endlich meine WP Updaten

[TbsJah]

@Smolo sagte:
Meine Hysterese HR steht bei 1,5k (das ist bei meiner WP auch der Standardwert!) die Logmeldungen sind daher für mich nicht ganz einleuchtend.

Ein Komma sollte hier eigentlich absolut kein Problem darstellen, meine Anlage läuft beispielsweise problemlos auf 1,6 K.

Was mich an der Fehlermeldung allerdings stutzig macht, sind die Werte 0,81 und 1 bei der HUP. Entweder nutzt deine Solepumpe intern ein anderes Register (was ich mir bei demselben Regler kaum vorstellen kann), oder die Werte benötigen bei deinem Setup eine andere Konvertierung.

Könntest du dazu bitte ein Issue auf GitHub erstellen und zusätzlich deinen Dump (die Rohdaten) dort anhängen? Alternativ könntest du testweise eigene Datenpunkte für die im Log gemeldeten Warnungen anlegen, wie hier im Screenshot gezeigt:

Hier geht's zur Issue-Erstellung auf GitHub

@Smolo sagte:

Grundsätzlich solltest du da aber auch nicht eingreifen gegenüber der WP. Die Werte welche sie liefert solltest du auslesen wie Sie kommen ...

Noch eine kurze Anmerkung dazu, warum der Adapter hier meldet:
Ein Großteil der festgelegten Wertebereiche stammt direkt aus der offiziellen Dokumentation von Luxtronik – diese Grenzen sind also vom Hersteller bereits strikt vorgegeben. Andere Bereiche habe ich so definiert, wie sie in der Praxis für mich und meine Anlage Sinn ergeben, um Anlagenfehler zu vermeiden.

Ein Beispiel: Die HUP funktioniert hardwareseitig nicht mit weniger als 3V und lässt sich auch nicht anders einstellen. Der ZWE funktioniert hingegen überhaupt nur, wenn die HUP aktuell mit 7V läuft. Solche Abhängigkeiten sind leider nirgends offiziell dokumentiert. Da über den Adapter die Werte für den Regler durch den Anwender auch manuell gesetzt werden können, müssen (aus meiner Sicht) zwingend Grenzen etabliert werden, die weder unter- noch überschritten werden dürfen. Das dient rein dem Schutz vor bekannten Fehleingaben.

Wenn für bestimmte Konstellationen aber Bereiche erweitert oder angepasst werden müssen, meldet das einfach, dann passe ich es an! :)

@Smolo sagte:

Deine 20 Grad vs. meiner gesetzten 18 Grad Rücklauf sind übrigens auch eine solche Thematik. Ich habe bei mir eine passive Kühlung integriert. Die WP Steuerung hat allerdings einen Bug in der installierten Version weil die Heizung bei Deaktivierung der Kühlung anspringt obwohl sie eigentlich deaktiviert ist und das kann ich nur mit dem niedrigeren Soll stoppen.

Da muss ich kurz nachhaken, das habe ich nicht ganz verstanden: Meinst du hier einen echten Bug in der Steuerung bzw. der Firmware der Heizung selbst, oder vermutest du einen Bug in der Logik des Adapters?

[TbsJah]

Neue Version

0.6.6 (2026-08-31)

• review / fix findings reported by claude based checker.
• Extended minimum limit for temperature_outdoor_min from -20°C to -25°C
• Lowered minimum allowed value for heating_curve_parallel_offset (base point) from 20°C to 15°C
• Disabled dynamic cycle optimization / regulation by default on initial start

[Smolo]

@TbsJah sagte:

@Smolo sagte:
Meine Hysterese HR steht bei 1,5k (das ist bei meiner WP auch der Standardwert!) die Logmeldungen sind daher für mich nicht ganz einleuchtend.

Ein Komma sollte hier eigentlich absolut kein Problem darstellen, meine Anlage läuft beispielsweise problemlos auf 1,6 K.

Mit der neuen Version kamen jetzt keinerlei Fehlermeldungen mehr.

Was mich an der Fehlermeldung allerdings stutzig macht, sind die Werte 0,81 und 1 bei der HUP. Entweder nutzt deine Solepumpe intern ein anderes Register (was ich mir bei demselben Regler kaum vorstellen kann), oder die Werte benötigen bei deinem Setup eine andere Konvertierung.

Der Wert steht bei mir jetzt aktuell 3 und 7. Ich habe mal einen Historienwert drauf gelegt und beobachte das.

Könntest du dazu bitte ein Issue auf GitHub erstellen und zusätzlich deinen Dump (die Rohdaten) dort anhängen? Alternativ könntest du testweise eigene Datenpunkte für die im Log gemeldeten Warnungen anlegen, wie hier im Screenshot gezeigt:

Hier geht's zur Issue-Erstellung auf GitHub

Kannst du mir bezüglich Dumb auf die Sprünge helfen woher ich diesen beziehen soll? Ich schicke ihn dir dann gerne zu.

@Smolo sagte:

Grundsätzlich solltest du da aber auch nicht eingreifen gegenüber der WP. Die Werte welche sie liefert solltest du auslesen wie Sie kommen ...

Noch eine kurze Anmerkung dazu, warum der Adapter hier meldet:
Ein Großteil der festgelegten Wertebereiche stammt direkt aus der offiziellen Dokumentation von Luxtronik – diese Grenzen sind also vom Hersteller bereits strikt vorgegeben. Andere Bereiche habe ich so definiert, wie sie in der Praxis für mich und meine Anlage Sinn ergeben, um Anlagenfehler zu vermeiden.

Ein Beispiel: Die HUP funktioniert hardwareseitig nicht mit weniger als 3V und lässt sich auch nicht anders einstellen. Der ZWE funktioniert hingegen überhaupt nur, wenn die HUP aktuell mit 7V läuft. Solche Abhängigkeiten sind leider nirgends offiziell dokumentiert. Da über den Adapter die Werte für den Regler durch den Anwender auch manuell gesetzt werden können, müssen (aus meiner Sicht) zwingend Grenzen etabliert werden, die weder unter- noch überschritten werden dürfen. Das dient rein dem Schutz vor bekannten Fehleingaben.

Das ist vollkommen verständlich und korrekt. Komisch wird es nur wenn der Adapter von allein Werte ändert und man den Ausgangspunkt dann natürlich nicht kennt und auch nicht weiß ist das jetzt dauerhaft oder nicht. z.B. das Thema Zwangswarmwasser...im Code habe ich entnommen das er hier kurzfristig die Hysterse auf 1k setzt das ist doch korrekt oder?

Wenn für bestimmte Konstellationen aber Bereiche erweitert oder angepasst werden müssen, meldet das einfach, dann passe ich es an! :)

@Smolo sagte:

Deine 20 Grad vs. meiner gesetzten 18 Grad Rücklauf sind übrigens auch eine solche Thematik. Ich habe bei mir eine passive Kühlung integriert. Die WP Steuerung hat allerdings einen Bug in der installierten Version weil die Heizung bei Deaktivierung der Kühlung anspringt obwohl sie eigentlich deaktiviert ist und das kann ich nur mit dem niedrigeren Soll stoppen.

Da muss ich kurz nachhaken, das habe ich nicht ganz verstanden: Meinst du hier einen echten Bug in der Steuerung bzw. der Firmware der Heizung selbst, oder vermutest du einen Bug in der Logik des Adapters?

Nein das war auf die Firmware der Heizung bezogen. Ich hatte im Sommer den "lustigen" Effekt das die Heizung angesprungen ist wenn ich die Kühlung deaktiviert habe und das trotz der deaktivierter Heizung!

[TbsJah]

@Smolo sagte:

Kannst du mir bezüglich Dumb auf die Sprünge helfen woher ich diesen beziehen soll? Ich schicke ihn dir dann gerne zu.

Unter Actions - dann werden alle Werte für beide Register welche abgerufen werden können in das Log geschrieben

@Smolo sagte:

Thema Zwangswarmwasser...im Code habe ich entnommen das er hier kurzfristig die Hysterse auf 1k setzt das ist doch korrekt oder

Das stimmt, damit Heizen und Warmwasser während eines Verdichterstarts abgearbeitet werden. Der vorher eingestellte Werte wird nach Ablauf wieder eingestellt.
Das aber auch nur wenn die Regelung aktiv ist.

[Smolo]

@TbsJah sagte:

@Smolo sagte:

Kannst du mir bezüglich Dumb auf die Sprünge helfen woher ich diesen beziehen soll? Ich schicke ihn dir dann gerne zu.

Unter Actions - dann werden alle Werte für beide Register welche abgerufen werden können in das Log geschrieben

@Smolo sagte:

Thema Zwangswarmwasser...im Code habe ich entnommen das er hier kurzfristig die Hysterse auf 1k setzt das ist doch korrekt oder

Das stimmt, damit Heizen und Warmwasser während eines Verdichterstarts abgearbeitet werden. Der vorher eingestellte Werte wird nach Ablauf wieder eingestellt.
Das aber auch nur wenn die Regelung aktiv ist.

Ich finde das etwas gefährlich speziell weil manche nicht ins Installateurmenü kommen und dann im Fall der Fälle die Hysterese nicht zurückstellen können außer über deinen Adapter. Zusätzlich bekommt man das dann natürlich nicht mit das hier extern der Hysterse Wert verändert wurde.

Hast du dir mal die beiden Optionen angeschaut ob das Thema mit dem Extra Warmwasser zu regeln?`

[Smolo]

@TbsJah sagte:

@Smolo sagte:

Kannst du mir bezüglich Dumb auf die Sprünge helfen woher ich diesen beziehen soll? Ich schicke ihn dir dann gerne zu.

Unter Actions - dann werden alle Werte für beide Register welche abgerufen werden können in das Log geschrieben

LogMeldungen habe ich bisher keine mehr mit dem 0.66 Adapter. Soll ich dir den Dump trotzdem noch zuschicken?

[TbsJah]

@Smolo sagte:
Ich finde das etwas gefährlich speziell weil manche nicht ins Installateurmenü kommen und dann im Fall der Fälle die Hysterese nicht zurückstellen können außer über deinen Adapter. Zusätzlich bekommt man das dann natürlich nicht mit das hier extern der Hysterse Wert verändert wurde.

Hast du dir mal die beiden Optionen angeschaut ob das Thema mit dem Extra Warmwasser zu regeln?`

Vielen Dank für den berechtigten Einwand und die Screenshots! Das Argument mit dem passwortgeschützten Installateurmenü ist absolut valide.

Ich habe mir die beiden Funktionen ("Extra Warmwasser" und "Schnellladung") auf dem Regler natürlich schon genauer angesehen. Leider habe ich bisher keine Möglichkeit gefunden, diese speziellen Funktionen direkt per Code über die Schnittstelle zu provozieren.

Daher existiert aktuell der Workaround über die temporäre Parameteranpassung der Hysterese im Adapter. Dass hier extern eingegriffen wird, wird zur Nachvollziehbarkeit immerhin als Info im Log ausgegeben.

Um das Risiko bei einem eventuellen Adapterabsturz zu minimieren und das Ganze transparenter zu gestalten, werde ich für die nächste Version folgende Anpassungen umsetzen:

• ListenpunktBessere Dokumentation & Opt-in: Ich werde das Verhalten auf der Konfigurationsseite detaillierter beschreiben. Außerdem wird dieser Eingriff ein zusätzlicher, optionaler Punkt, den man bei aktiver Regelung erst explizit einschalten muss.

• ListenpunktSollwert statt Hysterese: Als technische Alternative könnte der Adapter einfach den Warmwassersollwert temporär erhöhen, anstatt die Hysterese anzupassen. Der große Vorteil: Sollte der Adapter während dieses Vorgangs tatsächlich abstürzen, kann der Anwender den Sollwert ganz einfach über das normale Benutzermenü direkt am Regler wieder korrigieren – ganz ohne Installateur-Code.

[TbsJah]

@Smolo sagte:
LogMeldungen habe ich bisher keine mehr mit dem 0.66 Adapter. Soll ich dir den Dump trotzdem noch zuschicken?

Wenn es jetzt sauber läuft, musst du dir die Mühe eigentlich nicht mehr machen 😊

Interessiert hätte es mich aus Entwicklersicht aber ehrlich gesagt schon, wie diese krummen Werte (gerade die 0,81 und 1 bei der HUP) überhaupt zustande gekommen sind. Falls du also mal zwei Minuten Zeit und Lust hast, kannst du mir den Dump gerne trotzdem per PN oder im GitHub-Issue anhängen – rein aus Neugier und um zu prüfen, ob bei deiner Firmware oder deinem Anlagentyp eventuell eine andere Skalierung oder Registerbelegung vorliegt.

Wenn für dich aktuell aber alles rund läuft, können wir es natürlich auch gerne einfach so belassen!

[Smolo]

@TbsJah sagte:

@Smolo sagte:
Ich finde das etwas gefährlich speziell weil manche nicht ins Installateurmenü kommen und dann im Fall der Fälle die Hysterese nicht zurückstellen können außer über deinen Adapter. Zusätzlich bekommt man das dann natürlich nicht mit das hier extern der Hysterse Wert verändert wurde.

Hast du dir mal die beiden Optionen angeschaut ob das Thema mit dem Extra Warmwasser zu regeln?`

Vielen Dank für den berechtigten Einwand und die Screenshots! Das Argument mit dem passwortgeschützten Installateurmenü ist absolut valide.

Ich habe mir die beiden Funktionen ("Extra Warmwasser" und "Schnellladung") auf dem Regler natürlich schon genauer angesehen. Leider habe ich bisher keine Möglichkeit gefunden, diese speziellen Funktionen direkt per Code über die Schnittstelle zu provozieren.

Eventuell hilft ein Dump vor und nach der Aktivierung der Option so das man die Flags vergleichen kann?

Daher existiert aktuell der Workaround über die temporäre Parameteranpassung der Hysterese im Adapter. Dass hier extern eingegriffen wird, wird zur Nachvollziehbarkeit immerhin als Info im Log ausgegeben.

Um das Risiko bei einem eventuellen Adapterabsturz zu minimieren und das Ganze transparenter zu gestalten, werde ich für die nächste Version folgende Anpassungen umsetzen:

• ListenpunktBessere Dokumentation & Opt-in: Ich werde das Verhalten auf der Konfigurationsseite detaillierter beschreiben. Außerdem wird dieser Eingriff ein zusätzlicher, optionaler Punkt, den man bei aktiver Regelung erst explizit einschalten muss.

• ListenpunktSollwert statt Hysterese: Als technische Alternative könnte der Adapter einfach den Warmwassersollwert temporär erhöhen, anstatt die Hysterese anzupassen. Der große Vorteil: Sollte der Adapter während dieses Vorgangs tatsächlich abstürzen, kann der Anwender den Sollwert ganz einfach über das normale Benutzermenü direkt am Regler wieder korrigieren – ganz ohne Installateur-Code.

Das hört sich auf jeden Fall besser an.

[TbsJah]

0.7.0 (2026-09-04)

Features & Changes

• (Changed) Cycle Optimization & Forced Hot Water: To force a hot water cycle, the adapter now temporarily increases the hot water target temperature instead of modifying the hysteresis. This crucial safety improvement allows users to manually revert changes directly on the heat pump display without needing an installer password.
• (Changed) Disable default: Disabled reset to default values in idle mode by default on initial start
• (Removed) Hysteresis Protection: Removed all dynamic manipulations of the hot water hysteresis (e.g., during idle or active DHW cycles) to ensure installer-level settings remain untouched.
• (UI/Docs): Added detailed explanations and trigger rules for "Intelligent Cycle Optimization" and "Heating after hot water" directly to the admin configuration page.

Bugfixes

• Fixed adapter checker warning [W0066] by downgrading @types/node dependency to v22

[TbsJah]

Sehr interessante Frage bezüglich dem Unterschied von den beiden Wasser Einstellungen
Link Github

[TbsJah]

0.7.2 (2026-09-07)

Bugfixes

• (Fixed) Unintended Configuration Overwrites: Fixed a critical architectural flaw where the adapter blindly forced default values (e.g., hot water target temperature, heating curve) to the heat pump on every startup. The adapter is now 100% passive (read-only) upon installation until features are explicitly enabled.

• (Fixed) Strict Opt-In Logic: All internal condition checks for background automations (cycle optimization, ZIP optimization, idle resets) were refactored to strict opt-in logic (=== true), preventing unintended actions when settings have never been saved.

• (Fixed) Live Toggle for Cycle Optimization: Fixed an issue where the ioBroker switch Actions.Regelung_Aktiv was ignored during runtime. The optimization loop now evaluates this switch dynamically, allowing users to toggle the feature live via their dashboard.

• (Fixed) Hardware ZIP Timer Disable: Fixed a bug where a mismatched configuration key (zip_hardware_timer_disable instead of zip_lWP_aktiv) prevented the adapter from correctly disabling the hardware circulation pump timer for flash memory protection.

• (Fixed) "Heating after hot water" Reset: Restored missing logic that properly resets the "Heating after water" status back to false at the end of a cycle, preventing the system from getting stuck in this mode.

Features & Change

• (Changed) Forced DHW Safety Limit: Reduced the internal safety limit for temporary hot water target adjustments during forced DHW runs from 75°C to 70°C to better protect the system's high-pressure switch.

0.7.1 (2026-09-07)

Bugfixes

• (Fixed) Status Display: Fixed a logical evaluation bug where the operating state "Heating" (Code 0) was incorrectly overwritten and displayed as "No demand" (Code 5). Thanks to @michiproep for reporting!

• (Fixed) Temperature Values: Fixed a related issue where temperature readings of exactly 0 °C (e.g., average temperature, return target temperature, cooling release) were incorrectly replaced by internal fallback values (e.g., 1.5 °C).

[TbsJah]

0.7.3 (2026-09-07)

Bugfixes
-(Fixed) Timer Table Register Conflict: Resolved conflicting Luxtronik register IDs for Domestic Hot Water (DHW) Monday–Sunday schedules (WW_MoSo_Start1 to End5). These were previously mapped to registers 507–516 (colliding with Circulation timer registers) and have now been corrected to registers 406–415.

-(Fixed) Time-String Conversion on State Change: Fixed a parsing bug where manual updates to time strings (HH:MM / HH:MM:SS) on states marked with isDurationFormat or time-related roles were passed directly as strings instead of converting to seconds since midnight, preventing user-entered schedule values from persisting in the controller.

[Smolo]

Ich habe eventuell einen Bug gefunden bin mir aber etwas unsicher ob es doch an etwas anderem lag. Ich habe letzte Woche die Hysterese Warmwasser auf 6k aktiviert hatte den Wert in die Historie gepackt. Als ich heute reingeschaut habe war er wieder bei 10k was mich extrem gewundert hat. Das einzige was die Logs vor einer Woche hergegeben hatten war die Tatsache das ich den Adapter zwischen Info / Silly umgestellt hatte. Gibt es eine Möglichkeit das der Adapter zuerst schreibt und danach einliesst und so eventuell einen alten Wert reinschreibt? Ich hatte den Wert nämlich direkt an der WP geändert und nicht über den Adapter und vorher war dieser Wert auf 10k eingestellt.