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.
Verdichter-Schonung (Takt-Optimierung): Zusammenlegung von Heiz- und Warmwasserzyklen zur Reduzierung der Verdichterstarts.
Integrierte Aktionen (Makros): Vordefinierte Steuerungslogiken für Zwangsheizen, Warmwasseranforderung und die Zirkulationspumpe (ZIP) inkl. automatischem Rückfall auf Standardwerte.
Benutzerdefinierte Datenpunkte: Messwerte (Index 3004) und Parameter (Index 3003) können über die Adapter-Konfiguration hinzugefügt werden. Unix-Zeitstempel werden automatisch formatiert.
Automatisches Objekt-Management: Abgewählte oder gelöschte Datenpunkte und leere Ordnerstrukturen werden bei einem Adapter-Neustart automatisch aus ioBroker entfernt.
Benachrichtigungssystem: Fehlercodes der Wärmepumpe können direkt an Telegram oder das ioBroker-Benachrichtigungssystem gesendet werden.
Bewegungsmelder-Kopplung: Möglichkeit zur bedarfsgesteuerten Aktivierung der Zirkulationspumpe über vorhandene ioBroker-Bewegungssensoren.
ZIP Steuerung über externe Aktoren
Bilder
Changelog
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.
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.
Hey! Du scheinst an dieser Unterhaltung interessiert zu sein, hast aber noch kein Konto.
Hast du es satt, bei jedem Besuch durch die gleichen Beiträge zu scrollen? Wenn du dich für ein Konto anmeldest, kommst du immer genau dorthin zurück, wo du zuvor warst, und kannst dich über neue Antworten benachrichtigen lassen (entweder per E-Mail oder Push-Benachrichtigung). Du kannst auch Lesezeichen speichern und Beiträge positiv bewerten, um anderen Community-Mitgliedern deine Wertschätzung zu zeigen.
Mit deinem Input könnte dieser Beitrag noch besser werden 💗
