homebridge-viessmann-vicare 2.0.44 → 2.0.45

package/README.md

@@ -1033,7 +1033,7 @@ For issues and questions:
 
 ## 📈 Changelog
 
-### [2.0.44] - 2026-03-15
+### [2.0.45] - 2026-03-15
 #### Fixed
 - **Extended Heating state: HomeKit OFF while ViCare ON** — confirmed via live API: `forcedLastFromSchedule.active=True` is a schedule management artifact (always present), not an Extended Heating indicator. State now reads `comfort.active OR (programs.active === comfortFeatureSuffix)`. Deactivation uses `comfort.setTemperature` as fallback when `deactivate` is not executable (Vitodens).
 - **Extended Heating / comfort program: API-driven feature discovery** — removed hardcoded candidate list `['comfort', 'comfortHeating']`. Plugin now discovers the comfort program by scanning actual device features for any enabled `programs.*` that has an `activate` command, excluding known non-comfort programs. Works for Vitodens (`programs.comfort`), Vitocal gen3 (`programs.comfortHeating`), and any future device model without code changes.
@@ -1042,6 +1042,9 @@ For issues and questions:
 - **Device messages written at startup** — `setupDeviceAccessories` now calls `writeDeviceMessages` so the file exists immediately on startup, not only after the first update cycle.
 - **Compressor setpoint path: dynamic** — `heating.compressors.0.speed.setpoint` was hardcoded. Now derived from resolved `hpPaths.compressorMod` by replacing `.current` with `.setpoint` — correct for any device/compressor index.
 
+### [2.0.44] - 2026-03-15
+*(published separately)*
+
 ### [2.0.43] - 2026-03-15
 *(published separately)*
 

package/SETUP-GUIDE.md

@@ -1,8 +1,8 @@
-# Complete Setup Guide - v2.0.44
+# Complete Setup Guide - v2.0.45
 
 ## Overview
 
-This guide will walk you through setting up the Viessmann ViCare plugin v2.0.44 for Homebridge, including all the advanced features like intelligent caching, rate limiting protection, comprehensive configuration options, **complete localization support with custom names**, **CSV history logging**, **HTML diagnostic reports**, **energy system monitoring** (PV, battery, wallbox), and **heating schedule awareness** with visual bands in the HTML report, and **heat pump (Wärmepumpe) support** with automatic device detection.
+This guide will walk you through setting up the Viessmann ViCare plugin v2.0.45 for Homebridge, including all the advanced features like intelligent caching, rate limiting protection, comprehensive configuration options, **complete localization support with custom names**, **CSV history logging**, **HTML diagnostic reports**, **energy system monitoring** (PV, battery, wallbox), and **heating schedule awareness** with visual bands in the HTML report, and **heat pump (Wärmepumpe) support** with automatic device detection.
 
 ## Prerequisites
 
@@ -1157,7 +1157,7 @@ When reporting issues, include:
 
 ```json
 {
-    "plugin_version": "2.0.44",
+    "plugin_version": "2.0.45",
     "homebridge_version": "1.8.x",
     "node_version": "18.x.x",
     "heating_system": "Viessmann Model",
@@ -1228,7 +1228,7 @@ sudo systemctl restart homebridge
 
 ## Changelog
 
-### v2.0.44 (2026-03-15)
+### v2.0.45 (2026-03-15)
 **Multi-device robustness + API-driven feature discovery:**
 - **Comfort program discovery: API-driven** — scans actual device features instead of hardcoded name list. Supports Vitodens, Vitocal gen3, and future devices automatically.
 - **HC program normalisation: pattern-based** — `comfort*`/`normal*`/`reduced*` prefix matching instead of fixed map.
@@ -1236,6 +1236,9 @@ sudo systemctl restart homebridge
 - **Device messages written at startup** — available immediately, not only after first update cycle.
 - **Compressor setpoint path: dynamic** — derived from resolved `hpPaths.compressorMod`, no hardcoded device index.
 
+### v2.0.44 (2026-03-15)
+*(published separately)*
+
 ### v2.0.43 (2026-03-15)
 *(published separately)*
 

package/dist/accessories/heating-circuit-accessory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"heating-circuit-accessory.d.ts","sourceRoot":"","sources":["../../src/accessories/heating-circuit-accessory.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"heating-circuit-accessory.d.ts","sourceRoot":"","sources":["../../src/accessories/heating-circuit-accessory.ts"],"names":[],"mappings":"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"}

package/dist/accessories/heating-circuit-accessory.js

@@ -247,14 +247,15 @@ class ViessmannHeatingCircuitAccessory {
                 (hasForcedActivate && hasForcedDeactivate);
             if (hasAnyMethod) {
                 this.availableQuickSelections.push('extendedHeating');
-                // Initial state: comfort.active OR programs.active === comfortFeatureSuffix.
-                // NOTE: forcedLastFromSchedule.active is NOT used — it is True during normal
-                // schedule transitions and does not indicate Extended Heating is active.
+                // Initial state: OR of all three signals (same logic as update cycle).
                 const comfortActive = comfortProgram.properties?.active?.value || false;
+                const forcedActive = forcedProgram?.properties?.active?.value || false;
                 const activeProg = features.find(f => f.feature === `${circuitPrefix}.operating.programs.active`);
                 const activeIsComfort = activeProg?.properties?.value?.value === this.comfortFeatureSuffix;
-                this.states.ExtendedHeatingActive = comfortActive || activeIsComfort;
-                this.platform.log.debug(`HC${this.circuitNumber} ExtendedHeating initial: comfort.active=${comfortActive} programs.active=${activeProg?.properties?.value?.value} → ${this.states.ExtendedHeatingActive}`);
+                this.states.ExtendedHeatingActive = comfortActive || forcedActive || activeIsComfort;
+                this.platform.log.debug(`HC${this.circuitNumber} ExtendedHeating initial:` +
+                    ` comfort=${comfortActive} forced=${forcedActive} active=${activeProg?.properties?.value?.value}` +
+                    ` → ${this.states.ExtendedHeatingActive}`);
                 const activateExecutable = hasActivate?.isExecutable || false;
                 const deactivateExecutable = hasDeactivate?.isExecutable || false;
                 const setTempExecutable = hasSetTemperature?.isExecutable || false;
@@ -823,40 +824,45 @@ class ViessmannHeatingCircuitAccessory {
             }
             else {
                 // DEACTIVATING Extended Heating
-                // Try comfort.deactivate first (clean method)
-                const deactivateCmd = comfortProgram.commands?.['deactivate'];
-                if (deactivateCmd?.isExecutable) {
+                // Strategy: try all deactivation methods in order of likelihood to work.
+                // On Vitodens: forcedLastFromSchedule is the real mechanism → try it first.
+                // On other devices: comfort.deactivate may work directly.
+                const circuitPfx = `heating.circuits.${this.circuitNumber}`;
+                const forcedProgramNow = features.find(f => f.feature === `${circuitPfx}.operating.programs.forcedLastFromSchedule`);
+                let deactivated = false;
+                // Method 1: forcedLastFromSchedule.deactivate (Vitodens and others using this mechanism)
+                if (!deactivated && forcedProgramNow?.commands?.deactivate?.isExecutable) {
+                    const success = await this.platform.viessmannAPI.executeCommand(this.installation.id, this.gateway.serial, this.device.id, `${circuitPfx}.operating.programs.forcedLastFromSchedule`, 'deactivate', {});
+                    if (success) {
+                        deactivated = true;
+                        this.platform.log.info(`HC${this.circuitNumber} extended heating deactivated via forcedLastFromSchedule`);
+                    }
+                }
+                // Method 2: comfort.deactivate (devices where comfort is the primary mechanism)
+                if (!deactivated && comfortProgram.commands?.deactivate?.isExecutable) {
                     const success = await this.executeComfortCommand('deactivate', comfortProgram, false);
                     if (success) {
-                        this.states.ExtendedHeatingActive = false;
-                        this.platform.log.info(`Heating circuit ${this.circuitNumber} extended heating deactivated`);
-                        return;
+                        deactivated = true;
+                        this.platform.log.info(`HC${this.circuitNumber} extended heating deactivated via comfort.deactivate`);
                     }
                 }
-                // Fallback: setTemperature back to normal program temperature
-                // This works even when deactivate is not executable — reduces comfort temp
-                // back to normal level which effectively cancels the boost.
-                const setTempCmd = comfortProgram.commands?.['setTemperature'];
-                if (setTempCmd?.isExecutable) {
-                    const normalProgram = features.find(f => f.feature === `heating.circuits.${this.circuitNumber}.operating.programs.normal`);
+                // Method 3: comfort.setTemperature back to normal level
+                if (!deactivated && comfortProgram.commands?.setTemperature?.isExecutable) {
+                    const normalProgram = features.find(f => f.feature === `${circuitPfx}.operating.programs.normal`);
                     const normalTemp = normalProgram?.properties?.temperature?.value
                         ?? this.programTemperatures.normal
                         ?? 20;
-                    const success = await this.platform.viessmannAPI.executeCommand(this.installation.id, this.gateway.serial, this.device.id, `heating.circuits.${this.circuitNumber}.operating.programs.${this.comfortFeatureSuffix}`, 'setTemperature', { targetTemperature: normalTemp });
+                    const success = await this.platform.viessmannAPI.executeCommand(this.installation.id, this.gateway.serial, this.device.id, `${circuitPfx}.operating.programs.${this.comfortFeatureSuffix}`, 'setTemperature', { targetTemperature: normalTemp });
                     if (success) {
-                        this.states.ExtendedHeatingActive = false;
-                        this.platform.log.info(`Heating circuit ${this.circuitNumber} extended heating cancelled via setTemperature → ${normalTemp}°C`);
-                        return;
+                        deactivated = true;
+                        this.platform.log.info(`HC${this.circuitNumber} extended heating cancelled via setTemperature → ${normalTemp}°C`);
                     }
                 }
-                // Final fallback via tryAlternativeExtendedHeating
-                const success = await this.tryAlternativeExtendedHeating(false, comfortProgram, features);
-                if (success) {
+                if (deactivated) {
                     this.states.ExtendedHeatingActive = false;
-                    this.platform.log.info(`Heating circuit ${this.circuitNumber} extended heating deactivated using alternative method`);
                 }
                 else {
-                    throw new Error('Failed to deactivate extended heating mode');
+                    throw new Error('Failed to deactivate extended heating — no executable command found');
                 }
             }
         }
@@ -1491,21 +1497,30 @@ class ViessmannHeatingCircuitAccessory {
                 }
             }
         }
-        // Extended heating state: read from programs.active === comfortFeatureSuffix OR comfort.active.
-        // NOTE: forcedLastFromSchedule.active is NOT a reliable indicator — it is also True during
-        // normal schedule transitions (e.g. maintaining 'normal' outside active slots).
-        // The authoritative source is programs.active value or comfort.active property.
+        // Extended heating state — three signals in OR, all verified via live API:
+        //
+        // Vitodens (Ciriè, confirmed):
+        //   programs.active stays 'normal', comfort.active stays False
+        //   forcedLastFromSchedule.active = True when ON, False when OFF  ← real indicator here
+        //
+        // Vitocal gen3 / other devices:
+        //   programs.active may change to comfortFeatureSuffix
+        //   comfort.active may become True
+        //
+        // Using OR of all three signals covers all known device behaviours without assumptions.
         const comfortProgram = features.find(f => f.feature === `${circuitPrefix}.operating.programs.${this.comfortFeatureSuffix}`);
+        const forcedProgram = features.find(f => f.feature === `${circuitPrefix}.operating.programs.forcedLastFromSchedule`);
         const activeProg = features.find(f => f.feature === `${circuitPrefix}.operating.programs.active`);
         const comfortActive = comfortProgram?.properties?.active?.value ?? false;
+        const forcedActive = forcedProgram?.properties?.active?.value ?? false;
         const activeIsComfort = activeProg?.properties?.value?.value === this.comfortFeatureSuffix;
-        const extendedActive = comfortActive || activeIsComfort;
+        const extendedActive = comfortActive || forcedActive || activeIsComfort;
         if (extendedActive !== this.states.ExtendedHeatingActive) {
             this.states.ExtendedHeatingActive = extendedActive;
             anyProgramStateChanged = true;
-            if (!extendedActive) {
-            }
-            this.platform.log.debug(`HC${this.circuitNumber} ExtendedHeating: comfort.active=${comfortActive} activeProgram=${activeProg?.properties?.value?.value} → ${extendedActive}`);
+            this.platform.log.debug(`HC${this.circuitNumber} ExtendedHeating:` +
+                ` comfort=${comfortActive} forced=${forcedActive} active=${activeProg?.properties?.value?.value}` +
+                ` → ${extendedActive}`);
             if (extendedActive) {
                 this.states.HolidayActive = false;
                 this.states.HolidayAtHomeActive = false;

package/dist/settings.d.ts

@@ -9,7 +9,7 @@ export declare const PLUGIN_NAME = "homebridge-viessmann-vicare";
 /**
  * Plugin version for User-Agent and logging
  */
-export declare const PLUGIN_VERSION = "2.0.44";
+export declare const PLUGIN_VERSION = "2.0.45";
 /**
  * Default configuration values
  */

package/dist/settings.js

@@ -12,7 +12,7 @@ exports.PLUGIN_NAME = 'homebridge-viessmann-vicare';
 /**
  * Plugin version for User-Agent and logging
  */
-exports.PLUGIN_VERSION = '2.0.44';
+exports.PLUGIN_VERSION = '2.0.45';
 /**
  * Default configuration values
  */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "homebridge-viessmann-vicare",
-  "version": "2.0.44",
+  "version": "2.0.45",
   "description": "Complete Homebridge plugin for Viessmann ViCare heating systems with full control capabilities, advanced rate limiting protection, and intelligent cache management",
   "main": "dist/index.js",
   "scripts": {