iobroker.smartloadmanager 0.2.0 → 0.4.1

package/README.md

@@ -32,6 +32,11 @@ It can optionally integrate `ioBroker.pvforecast` through `summary.JSONData`. Su
 	Placeholder for the next version (at the beginning of the line):
 	### **WORK IN PROGRESS**
 -->
+### 0.4.1 (2026-10-24)
+
+- (quorle) Make forecast configuration, data imports and decision notifications visible only in the debug log; report forecast decisions for percentage and battery consumers and limit identical notifications to once per five minutes.
+- (quorle) Clear cached forecast data and report missing, invalid or expired source data instead of silently retaining previous forecasts.
+
 ### 0.2.0 (2026-10-24)
 
 - (quorle) Added sustained PV forecast evaluation, configurable W/kW units, safety margins, minimum on/off times and limited forecast dip bridging.

package/docs/de/README.md

@@ -61,6 +61,15 @@ automatisch aus. Dafür `controlMode: 0` verwenden.
 
 `enableForecast` aktivieren, `forecastJsonDatapoint` etwa auf
 `pvforecast.0.summary.JSONData` setzen und beim Verbraucher `useForecast` aktivieren.
+Auch `pvforecast.0.plants.<Anlagenname>.JSONData` ist möglich; dann wird nur diese
+Anlage berücksichtigt. Die globale Aktivierung und „Prognose verwenden“ beim
+jeweiligen Verbraucher sind beide erforderlich. „Prognoseentscheidungsbenachrichtigungen“
+aktiviert die Prognosesteuerung nicht selbst und erzeugt erst bei einer tatsächlichen
+Prognoseentscheidung eine Nachricht. In 0.2.0 stehen Datenimporte nur im Debug-Log.
+Version 0.4.1 zeigt Konfiguration, Datenimporte und aktivierte
+Entscheidungsnachrichten nur im Debug-Log an. Gleiche Entscheidungsnachrichten werden
+innerhalb von fünf Minuten zusammengefasst. Für externe Nachrichten zusätzlich den
+Notification Manager oder einen Nachrichtendienst konfigurieren.
 Beispiel für das erwartete Format (Zeitstempel sind Unix-Millisekunden):
 
 ```js

package/docs/en/README.md

@@ -52,6 +52,13 @@ its existing device state unchanged; use `controlMode: 0` to switch it off.
 
 Enable `enableForecast`, select e.g. `pvforecast.0.summary.JSONData` as
 `forecastJsonDatapoint`, and enable `useForecast` for the consumer.
+Alternatively select `pvforecast.0.plants.<plant name>.JSONData` to use one plant.
+Both global forecast control and the individual consumer's forecast option must be
+enabled. Decision notifications do not enable forecast control and are emitted only
+when a forecast actually affects control. Version 0.2.0 logs imports at debug level.
+Version 0.4.1 logs configuration, imports and enabled decision
+notifications only at debug level, suppressing identical decisions for five minutes.
+External delivery additionally requires Notification Manager or a messenger service.
 The expected JSON array uses Unix timestamps in milliseconds:
 
 ```js

package/io-package.json

@@ -1,8 +1,21 @@
 {
   "common": {
     "name": "smartloadmanager",
-    "version": "0.2.0",
+    "version": "0.4.1",
     "news": {
+      "0.4.1": {
+        "en": "Fix forecast notifications for percentage and battery consumers, limit duplicate notifications, clear invalid forecast data and log all forecast diagnostics only at debug level.",
+        "de": "Prognosemeldungen für Prozent- und Batterieverbraucher korrigiert, doppelte Meldungen begrenzt, ungültige Prognosedaten verworfen und sämtliche Prognosediagnosen ausschließlich auf Debug-Stufe protokolliert.",
+        "ru": "Исправлены уведомления прогноза для процентных потребителей и батарей, ограничены повторы, очищены недействительные данные; диагностика прогноза выводится только на уровне debug.",
+        "pt": "Corrigidas notificações de previsão para consumidores percentuais e baterias, limitadas repetições, eliminados dados inválidos e diagnóstico apenas no nível debug.",
+        "nl": "Prognosemeldingen voor procentuele verbruikers en batterijen hersteld, herhalingen beperkt, ongeldige gegevens gewist en prognosediagnose uitsluitend op debugniveau gelogd.",
+        "fr": "Correction des notifications de prévision pour consommateurs en pourcentage et batteries, limitation des doublons, suppression des données invalides et diagnostic uniquement au niveau debug.",
+        "it": "Corrette le notifiche di previsione per utenze percentuali e batterie, limitati i duplicati, eliminati i dati non validi e diagnostica solo a livello debug.",
+        "es": "Corregidas las notificaciones de previsión para consumidores porcentuales y baterías, limitados los duplicados, borrados los datos inválidos y diagnóstico solo en nivel debug.",
+        "pl": "Poprawiono powiadomienia prognozy dla odbiorników procentowych i akumulatorów, ograniczono duplikaty, usunięto nieprawidłowe dane; diagnostyka wyłącznie na poziomie debug.",
+        "uk": "Виправлено повідомлення прогнозу для відсоткових споживачів і батарей, обмежено повтори, очищено недійсні дані; діагностика прогнозу лише на рівні debug.",
+        "zh-cn": "修复百分比用电设备和电池的预测通知，限制重复通知，清除无效预测数据，所有预测诊断仅在 debug 级别记录。"
+      },
       "0.2.0": {
         "en": "Added sustained PV forecast control and minimum run/off times; fixed consumer commands, percent regulation, battery control, time windows and timers; updated translations, tests and workflows.",
         "de": "PV-Prognosesteuerung und Mindestlaufzeiten ergänzt; Verbrauchersteuerung, Zeitfenster und Timer korrigiert; Übersetzungen, Tests und Workflows aktualisiert.",

package/main.js

@@ -22,6 +22,8 @@ class ZeroFeedIn extends utils.Adapter {
         // 🔮 Forecast (PV forecast integration)
         this.forecastEnabled = false;
         this.forecastJsonDatapoint = null;
+        this.forecastNotificationTimes = new Map();
+        this.forecastLogSignature = '';
         this.forecast = {
             power: 0,
             surplus: 0,
@@ -86,6 +88,17 @@ class ZeroFeedIn extends utils.Adapter {
             // 🔮 Forecast config (PV forecast integration)
             this.forecastEnabled = !!this.config.enableForecast;
             this.forecastJsonDatapoint = this.config.forecastJsonDatapoint || null;
+            this.log.debug(
+                `[Forecast] ${this.forecastEnabled ? 'Enabled' : 'Disabled'}; source: ${this.forecastJsonDatapoint || 'not configured'}; decision notifications: ${this.config.notifyForecast ? 'enabled' : 'disabled'}.`,
+            );
+            if (this.forecastEnabled && !this.forecastJsonDatapoint) {
+                this.log.debug('[Forecast] No JSON data point configured; forecast control cannot run.');
+            }
+            if (this.config.notifyForecast && !this.forecastEnabled) {
+                this.log.debug(
+                    '[Forecast] Decision notifications do not enable forecast control. Enable forecast control and select a JSON data point first.',
+                );
+            }
             if (this.forecastEnabled && this.forecastJsonDatapoint) {
                 this.forecast.unit = await this.detectForecastPowerUnit();
             }
@@ -118,6 +131,12 @@ class ZeroFeedIn extends utils.Adapter {
             }
 
             this.log.info(`Loaded consumers: ${this.consumerList.map(v => v.name).join(', ')}`);
+            if (this.forecastEnabled) {
+                const forecastConsumers = this.consumerList.filter(v => v.enabled && v.useForecast);
+                this.log.debug(
+                    `[Forecast] Enabled consumers using forecast: ${forecastConsumers.map(v => v.name).join(', ') || 'none; activate useForecast for the desired consumers'}.`,
+                );
+            }
 
             await this.checkAndCreateConsumerObjects();
             await this.createConsumerStates();
@@ -504,6 +523,19 @@ class ZeroFeedIn extends utils.Adapter {
     // =====================================================================
     // ========================= Forecast JSON parse =======================
     // =====================================================================
+    async clearForecast(reason) {
+        this.forecastLogSignature = '';
+        this.forecast.points = [];
+        this.forecast.power = 0;
+        this.forecast.surplus = 0;
+        this.forecast.minutes = 0;
+        this.forecast.lastUpdate = 0;
+        for (const field of ['power', 'surplus', 'minutes', 'lastUpdate']) {
+            await this.setStateAsync(`${this.namespace}.forecast.${field}`, { val: 0, ack: true });
+        }
+        this.log.debug(`[Forecast] ${reason}; forecast control is unavailable until valid data arrives.`);
+    }
+
     async processPvforecastJson() {
         try {
             if (!this.forecastEnabled || !this.forecastJsonDatapoint) {
@@ -512,6 +544,7 @@ class ZeroFeedIn extends utils.Adapter {
 
             const state = await this.getForeignStateAsync(this.forecastJsonDatapoint);
             if (!state || !state.val) {
+                await this.clearForecast('JSON data point is missing or empty');
                 return;
             }
 
@@ -521,13 +554,13 @@ class ZeroFeedIn extends utils.Adapter {
                     baseload: this.config.baseload || 0,
                 });
             } catch (error) {
-                this.forecast.points = [];
-                this.log.warn(`[Forecast] Invalid pvforecast JSON: ${error.message}`);
+                await this.clearForecast(`Invalid pvforecast JSON: ${error.message}`);
                 return;
             }
 
             const best = this.forecast.points[0];
             if (!best) {
+                await this.clearForecast('JSON contains no valid future forecast points');
                 return;
             }
             const power = best.power;
@@ -549,11 +582,15 @@ class ZeroFeedIn extends utils.Adapter {
                 ack: true,
             });
 
-            this.log.debug(
-                `[Forecast] ${this.forecast.points.length} values parsed (${this.forecast.unit || 'auto'}) - next: ${power}W in ${minutes}min`,
-            );
+            const signature = `${this.forecast.points.length}:${best.timestamp}:${power}:${best.surplus}`;
+            if (signature !== this.forecastLogSignature) {
+                this.log.debug(
+                    `[Forecast] ${this.forecast.points.length} values parsed (${this.forecast.unit || 'auto'}) - next: ${power}W in ${minutes}min`,
+                );
+                this.forecastLogSignature = signature;
+            }
         } catch (error) {
-            this.log.error(`[Forecast] Error processing pvforecast JSON: ${error.message}`);
+            this.log.debug(`[Forecast] Error processing pvforecast JSON: ${error.message}`);
         }
     }
 
@@ -656,17 +693,29 @@ class ZeroFeedIn extends utils.Adapter {
                 ack: true,
             });
         } catch (err) {
-            this.log.warn(`[Forecast] Failed to set forecastStatus: ${err.message}`);
+            this.log.debug(`[Forecast] Failed to set forecastStatus: ${err.message}`);
         }
     }
 
     async sendForecastNotification(type, message) {
         try {
             if (this.config.notifyForecast) {
+                const now = Date.now();
+                for (const [key, sentAt] of this.forecastNotificationTimes) {
+                    if (now - sentAt >= 5 * 60000) {
+                        this.forecastNotificationTimes.delete(key);
+                    }
+                }
+                const key = `${type}:${message}`;
+                if (this.forecastNotificationTimes.has(key)) {
+                    return;
+                }
+                this.log.debug(`[Forecast] ${message}`);
                 await this.sendNotification('smartloadmanager', 'notify', message);
+                this.forecastNotificationTimes.set(key, now);
             }
         } catch (err) {
-            this.log.warn(`[Forecast] Failed to send forecast notification: ${err.message}`);
+            this.log.debug(`[Forecast] Failed to send forecast notification: ${err.message}`);
         }
     }
 
@@ -1291,6 +1340,10 @@ class ZeroFeedIn extends utils.Adapter {
             if (newPercent < currentPercent && this.isForecastDelayingSwitchOff(v, currentSurplus, currentPower)) {
                 newPercent = currentPercent;
                 this.log.debug(`[Forecast] ${v.name}: holding ${currentPercent}% during a short forecast-backed dip`);
+                await this.sendForecastNotification(
+                    'percent',
+                    `${v.name}: holding ${currentPercent}% during a forecast-backed dip.`,
+                );
             }
 
             if (newPercent !== currentPercent) {
@@ -1410,6 +1463,10 @@ class ZeroFeedIn extends utils.Adapter {
                 powerToSet = Math.min(oldPower, v.performance || oldPower);
                 modeToSet = 2;
                 this.log.debug(`[Forecast] ${v.name}: holding ${powerToSet}W charging power during a short dip`);
+                await this.sendForecastNotification(
+                    'battery',
+                    `${v.name}: holding ${powerToSet}W charging power during a forecast-backed dip.`,
+                );
             }
 
             const oldMode = this.batteryControlModeDatapoint

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "iobroker.smartloadmanager",
-  "version": "0.2.0",
+  "version": "0.4.1",
   "description": "This adapter allows devices to be controlled via PV surplus and thus achieve zero feed-in.",
   "author": {
     "name": "quorle",