homebridge-viessmann-vicare 2.0.75 → 2.0.76

package/CHANGELOG.md

@@ -3,6 +3,9 @@
 All notable changes to homebridge-viessmann-vicare.
 
 
+### [2.0.76] - 2026-09-26
+- fix: report web server (`reportServerPort`) could stop silently: it was started with `execFile`, which buffers the child output (1 MB max) and kills it when the buffer is full, especially with `debug: true`. It could also fail with the port still held by an orphan process after a restart. The server now runs as a supervised child process: output goes to the Homebridge log, errors and exits are logged, it restarts automatically with back-off (max 5 attempts) and it is stopped when Homebridge shuts down
+
 ### [2.0.75] - 2026-09-26
 - fix: history values equal to **0** were written as empty/NULL (`value || undefined`): daily/monthly gas, heat production and outside temperature of 0 now stored correctly (e.g. heating gas in summer)
 - fix: burner update statistics counted debounced updates as attempts (success rate shown ~50%): now only processed updates are counted

package/README.md

@@ -1095,6 +1095,9 @@ For issues and questions:
 
 ## 📈 Changelog
 
+### [2.0.76] - 2026-09-26
+- fix: report web server (`reportServerPort`) could stop silently: it was started with `execFile`, which buffers the child output (1 MB max) and kills it when the buffer is full, especially with `debug: true`. It could also fail with the port still held by an orphan process after a restart. The server now runs as a supervised child process: output goes to the Homebridge log, errors and exits are logged, it restarts automatically with back-off (max 5 attempts) and it is stopped when Homebridge shuts down
+
 ### [2.0.75] - 2026-09-26
 - fix: history values equal to **0** were written as empty/NULL (`value || undefined`): daily/monthly gas, heat production and outside temperature of 0 now stored correctly (e.g. heating gas in summer)
 - fix: burner update statistics counted debounced updates as attempts (success rate shown ~50%): now only processed updates are counted

package/SETUP-GUIDE.md

@@ -1,8 +1,8 @@
-# Complete Setup Guide - v2.0.75
+# Complete Setup Guide - v2.0.76
 
 ## Overview
 
-This guide will walk you through setting up the Viessmann ViCare plugin v2.0.75 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.76 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
 
@@ -1281,6 +1281,9 @@ sudo systemctl restart homebridge
 
 ## Changelog
 
+### v2.0.76 (2026-09-26)
+- fix: report web server supervised (no more silent stop / "Load failed"): logs, automatic restart, clean stop on shutdown
+
 ### v2.0.75 (2026-09-26)
 - fix: zero values (gas, heat, outside temperature) no longer stored as empty/NULL in CSV and MySQL
 - fix: burner update success rate, api-status plugin version, daily reference at local midnight

package/dist/platform.d.ts

@@ -15,6 +15,10 @@ export declare class ViessmannPlatform implements DynamicPlatformPlugin {
     private installations;
     private refreshTimer?;
     private healthMonitoringTimer?;
+    private reportServerChild?;
+    private reportServerRestarts;
+    private reportServerStopping;
+    private reportServerRestartTimer?;
     private isUpdating;
     private consecutiveErrors;
     private maxConsecutiveErrors;
@@ -24,6 +28,8 @@ export declare class ViessmannPlatform implements DynamicPlatformPlugin {
     constructor(log: Logger, config: ViessmannPlatformConfig & PlatformConfig, api: API);
     private validateConfig;
     private setupBurnerUpdateSystem;
+    private startReportServer;
+    private stopReportServer;
     private handleBurnerStatusUpdate;
     private updateAccessoriesWithBurnerStatus;
     private updateBoilerAccessoryBurnerStatus;

package/dist/platform.d.ts.map

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

package/dist/platform.js

@@ -55,6 +55,11 @@ class ViessmannPlatform {
     installations = [];
     refreshTimer;
     healthMonitoringTimer;
+    // Report server child process supervision
+    reportServerChild;
+    reportServerRestarts = 0;
+    reportServerStopping = false;
+    reportServerRestartTimer;
     isUpdating = false;
     consecutiveErrors = 0;
     maxConsecutiveErrors = 5;
@@ -122,14 +127,13 @@ class ViessmannPlatform {
                     const serverArgs = ['--port', String(reportPort), '--path', reportServerPath, '--timeout', String(reportTimeout)];
                     if (this.config.debug)
                         serverArgs.push('--debug');
-                    const { execFile } = require('child_process');
-                    const child = execFile(process.execPath, [reportScript, ...serverArgs], {
-                        detached: false,
-                        stdio: 'inherit',
-                    });
-                    child.on('error', (err) => {
-                        this.log.warn(`Report server failed to start: ${err.message}`);
-                    });
+                    // Supervised child process (2.0.76):
+                    // - spawn (not execFile): execFile buffers stdout (1 MB max) and ignores
+                    //   `stdio`, so with --debug the server was silently killed after a while
+                    // - output forwarded to the Homebridge log, exit/errors logged
+                    // - automatic restart with back-off (e.g. port still busy after a restart)
+                    // - child terminated on Homebridge shutdown (no orphan holding the port)
+                    this.startReportServer(reportScript, serverArgs, reportPort);
                     this.log.info('═'.repeat(60));
                     this.log.info('📊 Viessmann Report Server');
                     this.log.info(`   Open from any device: http://${lanIP}:${reportPort}`);
@@ -143,6 +147,7 @@ class ViessmannPlatform {
             }
         });
         this.api.on("shutdown" /* APIEvent.SHUTDOWN */, () => {
+            this.stopReportServer();
             if (this.refreshTimer) {
                 clearInterval(this.refreshTimer);
             }
@@ -191,6 +196,61 @@ class ViessmannPlatform {
         this.viessmannAPI.setBurnerUpdateCallback(this.handleBurnerStatusUpdate.bind(this));
         this.log.debug('🔥 Burner update system initialized');
     }
+    // 📊 Start the report web server as a supervised child process
+    startReportServer(script, args, port) {
+        const { spawn } = require('child_process');
+        const child = spawn(process.execPath, [script, ...args], { stdio: ['ignore', 'pipe', 'pipe'] });
+        this.reportServerChild = child;
+        const startedAt = Date.now();
+        const forward = (level) => (buf) => {
+            for (const line of buf.toString().split('\n')) {
+                const l = line.trim();
+                if (!l)
+                    continue;
+                if (level === 'warn' || /error|EADDRINUSE|failed/i.test(l)) {
+                    this.log.warn(`[ReportServer] ${l.replace(/^\[ReportServer\]\s*/, '')}`);
+                }
+                else {
+                    this.log.debug(`[ReportServer] ${l.replace(/^\[ReportServer\]\s*/, '')}`);
+                }
+            }
+        };
+        child.stdout?.on('data', forward('debug'));
+        child.stderr?.on('data', forward('warn'));
+        child.on('error', (err) => {
+            this.log.warn(`📊 Report server failed to start: ${err.message}`);
+        });
+        child.on('exit', (code, signal) => {
+            this.reportServerChild = undefined;
+            if (this.reportServerStopping)
+                return;
+            // A run longer than 10 minutes resets the back-off counter
+            if (Date.now() - startedAt > 10 * 60 * 1000)
+                this.reportServerRestarts = 0;
+            this.reportServerRestarts++;
+            if (this.reportServerRestarts > 5) {
+                this.log.error(`📊 Report server on port ${port} keeps stopping (code=${code} signal=${signal}) — giving up. ` +
+                    'Check that the port is free and restart Homebridge.');
+                return;
+            }
+            const delay = Math.min(5000 * Math.pow(2, this.reportServerRestarts - 1), 120000);
+            this.log.warn(`📊 Report server stopped (code=${code} signal=${signal}) — restarting in ${delay / 1000}s ` +
+                `(attempt ${this.reportServerRestarts}/5)`);
+            this.reportServerRestartTimer = setTimeout(() => this.startReportServer(script, args, port), delay);
+        });
+    }
+    // 📊 Stop the report server (Homebridge shutdown)
+    stopReportServer() {
+        this.reportServerStopping = true;
+        if (this.reportServerRestartTimer)
+            clearTimeout(this.reportServerRestartTimer);
+        try {
+            this.reportServerChild?.kill('SIGTERM');
+        }
+        catch {
+            // already gone
+        }
+    }
     // 🆕 NEW: Handle burner status updates from API
     async handleBurnerStatusUpdate(installationId, gatewaySerial, deviceId, burnerStatus, reason) {
         const updateKey = `${installationId}-${gatewaySerial}-${deviceId}`;

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.75";
+export declare const PLUGIN_VERSION = "2.0.76";
 /**
  * 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.75';
+exports.PLUGIN_VERSION = '2.0.76';
 /**
  * Default configuration values
  */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "homebridge-viessmann-vicare",
-  "version": "2.0.75",
+  "version": "2.0.76",
   "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": {