iobroker.poolcontrol 1.3.11 → 1.3.13

package/README.md

@@ -188,6 +188,53 @@ New features are added regularly – please refer to the changelog.
 ---
 
 ## Changelog
+### 1.3.13 (2026-05-08)
+- (copilot) Adapter requires node.js >= 22 now
+- Fixed invalid `common.installedFrom` entry in `io-package.json`
+- Added German and English function overview documentation
+
+### 1.3.12 (2026-05-02)
+
+**Solar Insights – Calculation fix & structure improvement**
+
+- Fixed incorrect thermal power and energy calculation
+- Previously used collector – pool temperature → caused unrealistic values
+- Switched to correct physical calculation: return – flow (water delta)
+- Thermal power is now only calculated when:
+  - valid flow is available
+  - delta T > 0
+- Prevents unrealistic values (e.g. hundreds of kW or >100 kWh daily gain)
+- Stabilized daily gain and peak power calculation
+- No accumulation with invalid or missing data
+- Improved sensor logic:
+  - introduced `flow` and `water_delta`
+  - clear separation between flow and temperature delta
+- Increased transparency:
+  - new output: `thermal_delta_source = return_flow_delta`
+  - HTML and JSON outputs extended
+- Added new i18n key:
+  - `solar_insights_label_thermal_delta_source`
+
+**Photovoltaic Insights – Runtime & stability fix**
+
+- Fixed incorrect runtime calculation
+- Root cause: runtime was only calculated on state changes
+- Added internal periodic recalculation (every 60 seconds during PV runtime)
+- Runtime is now accumulated continuously and correctly
+- Logic unchanged:
+  - only real PV surplus runtime is counted (`pv_surplus_active && photovoltaicHelper`)
+  - no afterrun included
+- Improved calculation:
+  - runtime is now independent from pump power availability
+  - energy is only calculated with valid pump power
+- Increased stability:
+  - improved start detection (`starts_today`)
+  - more reliable time delta handling
+- Added daily reset:
+  - all daily values reset at midnight
+  - runtime, energy, savings, starts and active state cleared
+  - internal helper states reset
+
 ### 1.3.11 (2026-05-02)
 
 - (DasBo) New: pH evaluation module (`chemistry.ph`)
@@ -257,21 +304,6 @@ Fix: PV Circulation Logic
 - Fix: Added missing `debug.last_update` update on successful calculation
 - Improvement: General stability and plausibility improvements in solar insights and logbook processing
 
-### 1.3.7 (2026-04-23)
-
-Bugfixes
-- solarInsightsHelper: fixed detection of standard solar runtime, replaced non-existing solar.active with solar.request_active, improved reliability of solar_ran_today for normal solar setups
-- photovoltaicHelper: round surplus value in status text (avoid long decimal numbers), switched afterrun timer to adapter.setTimeout / clearTimeout
-
-### 1.3.6 (2026-04-21)
-
-frostHelper
-- Fixed incorrect pump shutdown when other helpers (e.g. photovoltaicHelper) are active
-- frostHelper now only disables the pump if it previously activated it itself
-- improved internal ownership logic for safer multi-helper interaction
-- corrected frost speech state handling (no longer based on current pump state)
-- switched timer to adapter.setInterval / adapter.clearInterval for better stability and ioBroker compliance
-
 ## Support
 - [ioBroker Forum](https://forum.iobroker.net/)  
 - [GitHub Issues](https://github.com/DasBo1975/ioBroker.poolcontrol/issues)

package/io-package.json

@@ -1,8 +1,34 @@
 {
   "common": {
     "name": "poolcontrol",
-    "version": "1.3.11",
+    "version": "1.3.13",
     "news": {
+      "1.3.13": {
+        "en": "Added German and English function overview documentation. Fixed invalid common.installedFrom entry in io-package.json.",
+        "de": "Deutsche und englische Funktionsübersicht ergänzt. Ungültigen common.installedFrom-Eintrag in der io-package.json korrigiert.",
+        "ru": "Добавлена ​​обзорная документация по функциям на немецком и английском языках. Исправлена ​​неверная запись common.installedFrom в io-package.json.",
+        "pt": "Adicionada documentação de visão geral das funções em alemão e inglês. Corrigida entrada common.installedFrom inválida em io-package.json.",
+        "nl": "Duitse en Engelse functieoverzichtdocumentatie toegevoegd. Ongeldige common.installedFrom-vermelding in io-package.json opgelost.",
+        "fr": "Ajout d'une documentation de présentation des fonctions en allemand et en anglais. Correction de l'entrée common.installedFrom invalide dans io-package.json.",
+        "it": "Aggiunta la documentazione panoramica delle funzioni in tedesco e inglese. Risolto il problema con la voce common.installedFrom non valida in io-package.json.",
+        "es": "Se agregó documentación de descripción general de funciones en alemán e inglés. Se corrigió la entrada common.installedFrom no válida en io-package.json.",
+        "pl": "Dodano dokumentację przeglądu funkcji w języku niemieckim i angielskim. Naprawiono nieprawidłowy wpis common.installedFrom w io-package.json.",
+        "uk": "Додано документацію щодо огляду функцій німецькою та англійською мовами. Виправлено недійсний запис common.installedFrom у io-package.json.",
+        "zh-cn": "添加了德语和英语功能概述文档。修复了 io-package.json 中无效的 common.installedFrom 条目。"
+      },
+      "1.3.12": {
+        "en": "Solar Insights calculation fixed and photovoltaic runtime tracking stabilized",
+        "de": "Solar Insights Berechnung korrigiert und Photovoltaik-Laufzeit stabilisiert",
+        "ru": "Исправлен расчет Solar Insights и стабилизировано отслеживание времени работы фотоэлектрических систем.",
+        "pt": "Cálculo do Solar Insights corrigido e rastreamento de tempo de execução fotovoltaico estabilizado",
+        "nl": "Solar Insights-berekening vast en tracking van fotovoltaïsche looptijd gestabiliseerd",
+        "fr": "Calcul de Solar Insights corrigé et suivi de la durée de fonctionnement photovoltaïque stabilisé",
+        "it": "Calcolo Solar Insights fisso e monitoraggio dell'autonomia fotovoltaica stabilizzato",
+        "es": "Cálculo de Solar Insights fijo y seguimiento del tiempo de funcionamiento fotovoltaico estabilizado",
+        "pl": "Naprawiono obliczenia Solar Insights i ustabilizowano śledzenie czasu działania fotowoltaiki",
+        "uk": "Виправлено розрахунок Solar Insights і стабілізовано відстеження часу роботи фотоелектричної системи",
+        "zh-cn": "Solar Insights 计算固定，光伏运行时间跟踪稳定"
+      },
       "1.3.11": {
         "en": "New: Added pH evaluation module (chemistry.ph) with manual and external input, validation, measurement location handling and recommendations. New: Added TDS evaluation module (chemistry.tds) with trend analysis (24h, 7d, 30d), reference tracking and summary outputs (text/JSON/HTML). Fix: Resolved solar speech toggle issue between standard and extended mode. solarExtendedHelper no longer overwrites speech.solar_active in standard mode.",
         "de": "Neu: pH-Auswertungsmodul (chemistry.ph) mit manueller und externer Eingabe, Validierung, Messort-Berücksichtigung und Handlungsempfehlungen. Neu: TDS-Auswertungsmodul (chemistry.tds) mit Trendanalyse (24h, 7 Tage, 30 Tage), Referenzwert-Verfolgung und Zusammenfassungen (Text/JSON/HTML). Fix: Problem mit Solar-Sprachausgabe zwischen Standard- und Extended-Modus behoben. Der solarExtendedHelper überschreibt speech.solar_active im Standard-Modus nicht mehr.",
@@ -41,32 +67,6 @@
         "pl": "Napraw duplikację dziennika słonecznego i nieprawidłowe wpisy, popraw stabilność dziennika i obsługę tekstu pogodowego; napraw obliczenia czasu działania Solar Insights i aktualizację znacznika czasu debugowania.",
         "uk": "Виправте дублювання сонячного журналу та недійсні записи, покращте стабільність журналу та обробку тексту погоди; виправити розрахунок часу виконання solar insights і налагодити оновлення часових позначок.",
         "zh-cn": "修复太阳能日志重复和无效条目，提高日志稳定性和天气文本处理；修复 Solar Insights 运行时计算和调试时间戳更新。"
-      },
-      "1.3.7": {
-        "en": "Fix solarInsights detection for standard solar (use solar.request_active instead of non-existing solar.active). photovoltaicHelper improvements: rounded surplus value in status text and switched afterrun timer to adapter.setTimeout/clearTimeout.",
-        "de": "Fix der solarInsights-Erkennung für Standard-Solar (Verwendung von solar.request_active statt nicht vorhandenem solar.active). Verbesserungen im photovoltaicHelper: Rundung des Überschusswerts im Status-Text und Umstellung des Afterrun-Timers auf adapter.setTimeout/clearTimeout.",
-        "ru": "Исправлено обнаружение SolarInsights для стандартной солнечной энергии (используйте Solar.request_active вместо несуществующего Solar.active). Улучшения photovoltaicHelper: округленное лишнее значение в тексте состояния и переключение таймера послезапуска на адаптер.setTimeout/clearTimeout.",
-        "pt": "Corrija a detecção do solarInsights para energia solar padrão (use solar.request_active em vez de solar.active inexistente). Melhorias no photovoltaicHelper: valor excedente arredondado no texto de status e temporizador pós-execução alterado para adaptador.setTimeout/clearTimeout.",
-        "nl": "Fix solarInsights-detectie voor standaard zonne-energie (gebruik solar.request_active in plaats van niet-bestaande solar.active). photovoltaicHelper-verbeteringen: afgeronde meerwaarde in statustekst en geschakelde nalooptimer naar adapter.setTimeout/clearTimeout.",
-        "fr": "Correction de la détection solarInsights pour l'énergie solaire standard (utilisez solar.request_active au lieu de solar.active inexistant). Améliorations de photovoltaicHelper : valeur excédentaire arrondie dans le texte d'état et minuterie de post-exécution commutée sur adapter.setTimeout/clearTimeout.",
-        "it": "Correggere il rilevamento di solarInsights per l'energia solare standard (utilizzare solar.request_active anziché solar.active inesistente). Miglioramenti di fotovoltaicoHelper: valore surplus arrotondato nel testo di stato e timer di postesecuzione commutato su Adapter.setTimeout/clearTimeout.",
-        "es": "Se corrigió la detección de solarInsights para energía solar estándar (use solar.request_active en lugar de solar.active no existente). Mejoras en photovoltaicHelper: valor excedente redondeado en el texto de estado y temporizador de posejecución cambiado a adaptor.setTimeout/clearTimeout.",
-        "pl": "Napraw wykrywanie solarInsights dla standardowej energii słonecznej (użyj solar.request_active zamiast nieistniejącego solar.active). Udoskonalenia programu photovoltaicHelper: zaokrąglona wartość nadwyżki w tekście statusu i przełączona licznik czasu afterrun na adapter.setTimeout/clearTimeout.",
-        "uk": "Виправте виявлення solarInsights для стандартної сонячної енергії (використовуйте solar.request_active замість неіснуючого solar.active). Покращення photovoltaicHelper: округлене надлишкове значення в тексті стану та переключений таймер післязапуску на adapter.setTimeout/clearTimeout.",
-        "zh-cn": "修复标准太阳能的 SolarInsights 检测（使用 Solar.request_active 而不是不存在的 Solar.active）。 PVHelper 改进：对状态文本中的剩余值进行四舍五入，并将 Afterrun 计时器切换为 adapter.setTimeout/clearTimeout。"
-      },
-      "1.3.6": {
-        "en": "Fix for frostHelper: prevents incorrect pump shutdown when other helpers (e.g. photovoltaic) are active. Frost protection now only disables the pump if it previously activated it itself. Improved speech state logic for frost indication. Switched frostHelper timer to adapter.setInterval for better stability and ioBroker compliance.",
-        "de": "Fix für frostHelper: verhindert falsches Abschalten der Pumpe, wenn andere Helper (z. B. Photovoltaik) aktiv sind. Frostschutz schaltet die Pumpe jetzt nur noch aus, wenn er sie zuvor selbst aktiviert hat. Sprach-State für Frostanzeige korrigiert. Timer im frostHelper auf adapter.setInterval umgestellt für bessere Stabilität und ioBroker-Konformität.",
-        "ru": "Исправление FrostHelper: предотвращает некорректное выключение насоса, когда активны другие помощники (например, фотоэлектрические). Защита от замерзания теперь отключает насос только в том случае, если он ранее активировал его сам. Улучшена логика речевого состояния для индикации замерзания. Таймер FrostHelper переключен на адаптер.setInterval для большей стабильности и соответствия требованиям ioBroker.",
-        "pt": "Correção parafrostHelper: evita o desligamento incorreto da bomba quando outros auxiliares (por exemplo, fotovoltaicos) estão ativos. A proteção contra congelamento agora só desativa a bomba se ela mesma a tiver ativado anteriormente. Lógica de estado de fala aprimorada para indicação de congelamento. Mudou o temporizadorfrostHelper para adaptador.setInterval para melhor estabilidade e conformidade com ioBroker.",
-        "nl": "Oplossing voor FrostHelper: voorkomt onjuiste pompuitschakeling wanneer andere helpers (bijv. fotovoltaïsche energie) actief zijn. De vorstbeveiliging schakelt de pomp nu alleen uit als deze deze eerder zelf heeft geactiveerd. Verbeterde spraakstatuslogica voor vorstindicatie. FrostHelper-timer omgeschakeld naar adapter.setInterval voor betere stabiliteit en ioBroker-compliance.",
-        "fr": "Correctif pour frostHelper : empêche un arrêt incorrect de la pompe lorsque d'autres assistants (par exemple photovoltaïques) sont actifs. La protection antigel désactive désormais la pompe uniquement si elle l'a activée elle-même auparavant. Logique d’état vocale améliorée pour l’indication de gel. La minuterie FrostHelper a été remplacée par adapter.setInterval pour une meilleure stabilité et une meilleure conformité à ioBroker.",
-        "it": "Correzione per FrostHelper: impedisce lo spegnimento errato della pompa quando altri helper (ad esempio fotovoltaico) sono attivi. La protezione antigelo ora disabilita la pompa solo se precedentemente l'aveva attivata da sola. Logica dello stato vocale migliorata per l'indicazione del gelo. Cambiato il timer FrostHelper su Adapter.setInterval per una migliore stabilità e conformità con ioBroker.",
-        "es": "Solución para frostHelper: evita el apagado incorrecto de la bomba cuando otros ayudantes (por ejemplo, fotovoltaicos) están activos. La protección contra heladas ahora solo desactiva la bomba si previamente la activó ella misma. Lógica de estado de voz mejorada para indicación de escarcha. Se cambió el temporizador frostHelper a adaptor.setInterval para una mejor estabilidad y cumplimiento de ioBroker.",
-        "pl": "Poprawka dla FrostHelper: zapobiega nieprawidłowemu wyłączeniu pompy, gdy aktywne są inne pomoce (np. fotowoltaiczne). Ochrona przed zamarzaniem wyłącza teraz pompę tylko wtedy, gdy wcześniej sama ją uruchomiła. Ulepszona logika stanu mowy dla sygnalizacji mrozu. Zmieniono licznik czasu FrostHelper na adapter.setInterval, aby zapewnić lepszą stabilność i zgodność z ioBrokerem.",
-        "uk": "Виправлення для frostHelper: запобігає неправильному вимкненню насоса, коли інші помічники (наприклад, фотоелектричні) активні. Захист від замерзання тепер вимикає насос лише в тому випадку, якщо він раніше сам його активував. Покращена логіка стану мови для індикації морозу. Перемкнуто таймер frostHelper на adapter.setInterval для кращої стабільності та відповідності ioBroker.",
-        "zh-cn": "修复霜助手：防止当其他助手（例如光伏）处于活动状态时错误地关闭泵。现在，防冻保护只会在泵之前自行激活的情况下禁用泵。改进了霜冻指示的语音状态逻辑。将frostHelper计时器切换为adapter.setInterval以获得更好的稳定性和ioBroker合规性。"
       }
     },
     "titleLang": {
@@ -133,8 +133,7 @@
       {
         "admin": ">=7.6.20"
       }
-    ],
-    "installedFrom": "file:///opt/iobroker/ioBroker.poolcontrol"
+    ]
   },
   "native": {},
   "objects": [],

package/lib/helpers/photovoltaicInsightsHelper.js

@@ -5,6 +5,7 @@ const { I18n } = require('@iobroker/adapter-core');
 const photovoltaicInsightsHelper = {
     adapter: null,
     checkTimer: null,
+    resetTimer: null,
     lastResultTimestamp: null,
     lastPvRuntimeActive: false,
 
@@ -12,6 +13,7 @@ const photovoltaicInsightsHelper = {
         this.adapter = adapter;
 
         void this._subscribeStates();
+        this._scheduleDailyReset();
         this._scheduleCheck(0);
 
         this.adapter.log.debug(
@@ -31,6 +33,79 @@ const photovoltaicInsightsHelper = {
         this._scheduleCheck(200);
     },
 
+    _scheduleDailyReset() {
+        if (this.resetTimer) {
+            this.adapter.clearTimeout(this.resetTimer);
+            this.resetTimer = null;
+        }
+
+        const now = new Date();
+        const next = new Date(now);
+        next.setDate(now.getDate() + 1);
+        next.setHours(0, 0, 5, 0);
+
+        const delay = Math.max(1000, next.getTime() - now.getTime());
+
+        this.resetTimer = this.adapter.setTimeout(async () => {
+            try {
+                await this.adapter.setStateChangedAsync('analytics.insights.photovoltaic.results.active_today', {
+                    val: false,
+                    ack: true,
+                });
+
+                await this.adapter.setStateChangedAsync('analytics.insights.photovoltaic.results.runtime_today_min', {
+                    val: 0,
+                    ack: true,
+                });
+
+                await this.adapter.setStateChangedAsync(
+                    'analytics.insights.photovoltaic.results.energy_used_today_kwh',
+                    {
+                        val: 0,
+                        ack: true,
+                    },
+                );
+
+                await this.adapter.setStateChangedAsync('analytics.insights.photovoltaic.results.savings_today_eur', {
+                    val: 0,
+                    ack: true,
+                });
+
+                await this.adapter.setStateChangedAsync('analytics.insights.photovoltaic.results.starts_today', {
+                    val: 0,
+                    ack: true,
+                });
+
+                this.lastResultTimestamp = null;
+                this.lastPvRuntimeActive = false;
+
+                await this.adapter.setStateChangedAsync('analytics.insights.photovoltaic.debug.last_update', {
+                    val: new Date().toISOString(),
+                    ack: true,
+                });
+
+                await this.adapter.setStateChangedAsync(
+                    'analytics.insights.photovoltaic.debug.last_recalculation_reason',
+                    {
+                        val: I18n.translate('photovoltaic_insights_debug_reason_daily_reset'),
+                        ack: true,
+                    },
+                );
+
+                await this.adapter.setStateChangedAsync('analytics.insights.photovoltaic.debug.debug_text', {
+                    val: I18n.translate('photovoltaic_insights_debug_text_daily_reset'),
+                    ack: true,
+                });
+
+                this.adapter.log.debug('[photovoltaicInsightsHelper] Daily reset executed');
+            } catch (err) {
+                this.adapter.log.warn(`[photovoltaicInsightsHelper] Daily reset failed: ${err.message}`);
+            }
+
+            this._scheduleDailyReset();
+        }, delay);
+    },
+
     _scheduleCheck(delayMs = 0) {
         if (this.checkTimer) {
             this.adapter.clearTimeout(this.checkTimer);
@@ -142,26 +217,36 @@ const photovoltaicInsightsHelper = {
 
         if (pvRuntimeActive && !this.lastPvRuntimeActive) {
             startsToday += 1;
-            this.lastResultTimestamp = now;
         }
 
-        if (pvRuntimeActive && this.lastResultTimestamp && Number.isFinite(pumpPowerW) && pumpPowerW > 0) {
+        if (pvRuntimeActive && this.lastResultTimestamp) {
             const deltaHours = (now - this.lastResultTimestamp) / 3600000;
 
             if (deltaHours > 0 && deltaHours <= 0.5) {
-                const energyDeltaKwh = (pumpPowerW * deltaHours) / 1000;
-
                 runtimeTodayMin = Number((runtimeTodayMin + deltaHours * 60).toFixed(2));
-                energyUsedTodayKwh = Number((energyUsedTodayKwh + energyDeltaKwh).toFixed(4));
 
-                if (Number.isFinite(electricityPriceEurKwh) && electricityPriceEurKwh > 0) {
-                    savingsTodayEur = Number((savingsTodayEur + energyDeltaKwh * electricityPriceEurKwh).toFixed(2));
+                if (Number.isFinite(pumpPowerW) && pumpPowerW > 0) {
+                    const energyDeltaKwh = (pumpPowerW * deltaHours) / 1000;
+
+                    energyUsedTodayKwh = Number((energyUsedTodayKwh + energyDeltaKwh).toFixed(4));
+
+                    if (Number.isFinite(electricityPriceEurKwh) && electricityPriceEurKwh > 0) {
+                        savingsTodayEur = Number(
+                            (savingsTodayEur + energyDeltaKwh * electricityPriceEurKwh).toFixed(4),
+                        );
+                    }
                 }
             }
         }
 
         if (pvRuntimeActive) {
             this.lastResultTimestamp = now;
+
+            // FIX:
+            // Während echter PV-Überschusslaufzeit regelmäßig weiterrechnen,
+            // auch wenn keine neuen State-Events eintreffen.
+            // Nachlauf ohne PV-Überschuss wird dadurch bewusst nicht gezählt.
+            this._scheduleCheck(60 * 1000);
         } else {
             this.lastResultTimestamp = null;
         }
@@ -300,6 +385,11 @@ const photovoltaicInsightsHelper = {
             this.adapter.clearTimeout(this.checkTimer);
             this.checkTimer = null;
         }
+
+        if (this.resetTimer) {
+            this.adapter.clearTimeout(this.resetTimer);
+            this.resetTimer = null;
+        }
     },
 };
 

package/lib/helpers/solarInsightsHelper.js

@@ -229,6 +229,8 @@ const solarInsightsHelper = {
             const collectorTemp = await this._readNumber('temperature.collector.current');
             const surfaceTemp = await this._readNumber('temperature.surface.current');
             const groundTemp = await this._readNumber('temperature.ground.current');
+            const flowTemp = await this._readNumber('temperature.flow.current'); // FIX: Vorlauf für echte Wärmeberechnung
+            const returnTemp = await this._readNumber('temperature.return.current'); // FIX: Rücklauf für echte Wärmeberechnung
             const outsideTemp = await this._readNumber('temperature.outside.current');
             const currentFlowLh = await this._readNumber('pump.live.flow_current_lh');
             const pumpCurrentPowerW = await this._readNumber('pump.live.current_power_w');
@@ -261,7 +263,10 @@ const solarInsightsHelper = {
                 availableSensors.push('ground');
             }
             if (flowAvailable) {
-                availableSensors.push('calculated_flow');
+                availableSensors.push('flow');
+            }
+            if (flowTempAvailable && returnAvailable) {
+                availableSensors.push('water_delta');
             }
             if (returnAvailable) {
                 availableSensors.push('return');
@@ -283,7 +288,10 @@ const solarInsightsHelper = {
                 usedSensors.push('ground');
             }
             if (flowUsed) {
-                usedSensors.push('calculated_flow');
+                usedSensors.push('flow');
+            }
+            if (flowTempAvailable && returnAvailable) {
+                usedSensors.push('water_delta');
             }
             if (returnUsed) {
                 usedSensors.push('return');
@@ -317,15 +325,20 @@ const solarInsightsHelper = {
             }
 
             let deltaTUsed = null;
-            if (Number.isFinite(collectorTemp) && Number.isFinite(poolReferenceTemp)) {
-                deltaTUsed = Number((collectorTemp - poolReferenceTemp).toFixed(2));
+
+            // FIX:
+            // Für thermische Leistung und Tagesertrag darf nicht Kollektor - Pool verwendet werden.
+            // Das überschätzt massiv, weil die Kollektortemperatur keine echte Wasser-Ausgangstemperatur ist.
+            // Für Energie/COP wird nur die echte Wasserdifferenz Rücklauf - Vorlauf verwendet.
+            if (Number.isFinite(returnTemp) && Number.isFinite(flowTemp)) {
+                deltaTUsed = Number((returnTemp - flowTemp).toFixed(2));
             }
 
             // --- Block 3: Thermische Leistung berechnen ---
             let thermalPowerW = null;
             let thermalPowerKW = null;
 
-            if (Number.isFinite(deltaTUsed) && Number.isFinite(currentFlowLh) && currentFlowLh > 0) {
+            if (Number.isFinite(deltaTUsed) && deltaTUsed > 0 && Number.isFinite(currentFlowLh) && currentFlowLh > 0) {
                 thermalPowerW = Number((currentFlowLh * deltaTUsed * 1.16).toFixed(2));
                 thermalPowerKW = Number((thermalPowerW / 1000).toFixed(3));
             }
@@ -425,6 +438,7 @@ const solarInsightsHelper = {
                 solar_effective_now: solarEffectiveNow,
                 pool_reference_source: poolReferenceSource,
                 flow_source: flowSource,
+                thermal_delta_source: 'return_flow_delta',
                 weather_correction_active: weatherCorrectionActive,
                 confidence_percent: confidencePercent,
                 used_sensors: usedSensors,
@@ -456,6 +470,7 @@ const solarInsightsHelper = {
                 `<b>${I18n.translate('solar_insights_label_solar_effective_now')}:</b> ${solarEffectiveNow}<br>`,
                 `<b>${I18n.translate('solar_insights_label_pool_reference_source')}:</b> ${poolReferenceSource}<br>`,
                 `<b>${I18n.translate('solar_insights_label_flow_source')}:</b> ${flowSource}<br>`,
+                `<b>${I18n.translate('solar_insights_label_thermal_delta_source')}:</b> return_flow_delta<br>`,
                 `<b>${I18n.translate('solar_insights_label_weather_correction_active')}:</b> ${weatherCorrectionActive}<br>`,
                 `<b>${I18n.translate('solar_insights_label_confidence')}:</b> ${confidencePercent} %<br>`,
                 `<b>${I18n.translate('solar_insights_label_used_sensors')}:</b> ${usedSensors.join(', ') || I18n.translate('solar_insights_value_none')}<br>`,
@@ -545,6 +560,7 @@ const solarInsightsHelper = {
                     available: availableSensors,
                     used: usedSensors,
                     mode: 'estimated_daily_gain',
+                    thermal_delta_source: 'return_flow_delta',
                     block: 7,
                 }),
                 ack: true,

package/lib/i18n/de.json

@@ -109,6 +109,7 @@
   "solar_insights_label_solar_effective_now": "Solar aktuell wirksam",
   "solar_insights_label_pool_reference_source": "Pool-Referenzquelle",
   "solar_insights_label_flow_source": "Durchflussquelle",
+  "solar_insights_label_thermal_delta_source": "Quelle Wärme-Delta",
   "solar_insights_label_weather_correction_active": "Wetterkorrektur aktiv",
   "solar_insights_label_confidence": "Vertrauen",
   "solar_insights_label_used_sensors": "Verwendete Sensoren",
@@ -185,6 +186,8 @@
   "photovoltaic_insights_debug_reason_no_pv_runtime": "Kein aktiver PV-Überschussbetrieb",
   "photovoltaic_insights_debug_text_pv_runtime_active": "PV-Überschuss ist aktiv und der Photovoltaik-Helper besitzt aktuell die Pumpe.",
   "photovoltaic_insights_debug_text_no_pv_runtime": "Aktuell wird keine PV-Laufzeit gezählt, weil entweder kein PV-Überschuss aktiv ist oder der Photovoltaik-Helper die Pumpe nicht besitzt.",
+  "photovoltaic_insights_debug_reason_daily_reset": "Täglicher Reset",
+  "photovoltaic_insights_debug_text_daily_reset": "Die täglichen Photovoltaik-Insights-Werte wurden zurückgesetzt.",
 
   "pH source state configured.": "pH-Quell-Datenpunkt konfiguriert.",
   "pH source state could not be subscribed.": "pH-Quell-Datenpunkt konnte nicht abonniert werden.",

package/lib/i18n/en.json

@@ -181,6 +181,7 @@
   "solar_insights_label_solar_effective_now": "Solar effective now",
   "solar_insights_label_pool_reference_source": "Pool reference source",
   "solar_insights_label_flow_source": "Flow source",
+  "solar_insights_label_thermal_delta_source": "Thermal delta source",
   "solar_insights_label_weather_correction_active": "Weather correction active",
   "solar_insights_label_confidence": "Confidence",
   "solar_insights_label_used_sensors": "Used sensors",
@@ -257,7 +258,8 @@
   "photovoltaic_insights_debug_reason_no_pv_runtime": "No active PV surplus operation",
   "photovoltaic_insights_debug_text_pv_runtime_active": "PV surplus is active and the photovoltaic helper currently owns the pump.",
   "photovoltaic_insights_debug_text_no_pv_runtime": "No PV runtime is currently counted because either no PV surplus is active or the photovoltaic helper does not own the pump.",
-
+  "photovoltaic_insights_debug_reason_daily_reset": "Daily reset",
+  "photovoltaic_insights_debug_text_daily_reset": "Photovoltaic insights daily values have been reset.",
   "pH source state configured.": "pH source state configured.",
   "pH source state could not be subscribed.": "pH source state could not be subscribed.",
   "No pH source state configured.": "No pH source state configured.",

package/lib/i18n/es.json

@@ -181,6 +181,7 @@
   "solar_insights_label_solar_effective_now": "Solar activo actualmente",
   "solar_insights_label_pool_reference_source": "Fuente de referencia del pool",
   "solar_insights_label_flow_source": "Fuente de caudal",
+  "solar_insights_label_thermal_delta_source": "Fuente delta térmica",
   "solar_insights_label_weather_correction_active": "Corrección meteorológica activa",
   "solar_insights_label_confidence": "Confianza",
   "solar_insights_label_used_sensors": "Sensores utilizados",
@@ -256,6 +257,8 @@
   "photovoltaic_insights_debug_reason_no_pv_runtime": "Sin operación activa con excedente FV",
   "photovoltaic_insights_debug_text_pv_runtime_active": "El excedente FV está activo y el helper fotovoltaico posee actualmente la bomba.",
   "photovoltaic_insights_debug_text_no_pv_runtime": "Actualmente no se cuenta ningún tiempo de funcionamiento FV porque no hay excedente FV activo o el helper fotovoltaico no posee la bomba.",
+  "photovoltaic_insights_debug_reason_daily_reset": "Reinicio diario",
+  "photovoltaic_insights_debug_text_daily_reset": "Los valores diarios de los insights fotovoltaicos han sido restablecidos.",
 
   "pH source state configured.": "Estado de origen de pH configurado.",
   "pH source state could not be subscribed.": "No se pudo suscribir el estado de origen de pH.",

package/lib/i18n/fr.json

@@ -181,6 +181,7 @@
   "solar_insights_label_solar_effective_now": "Solaire actif actuellement",
   "solar_insights_label_pool_reference_source": "Source de référence du pool",
   "solar_insights_label_flow_source": "Source de débit",
+  "solar_insights_label_thermal_delta_source": "Source du delta thermique",
   "solar_insights_label_weather_correction_active": "Correction météo active",
   "solar_insights_label_confidence": "Confiance",
   "solar_insights_label_used_sensors": "Capteurs utilisés",
@@ -256,6 +257,8 @@
   "photovoltaic_insights_debug_reason_no_pv_runtime": "Aucun fonctionnement actif sur surplus PV",
   "photovoltaic_insights_debug_text_pv_runtime_active": "Le surplus PV est actif et le helper photovoltaïque possède actuellement la pompe.",
   "photovoltaic_insights_debug_text_no_pv_runtime": "Aucun temps de fonctionnement PV n’est actuellement comptabilisé, car aucun surplus PV n’est actif ou le helper photovoltaïque ne possède pas la pompe.",
+  "photovoltaic_insights_debug_reason_daily_reset": "Réinitialisation quotidienne",
+  "photovoltaic_insights_debug_text_daily_reset": "Les valeurs quotidiennes des insights photovoltaïques ont été réinitialisées.",
 
   "pH source state configured.": "État source pH configuré.",
   "pH source state could not be subscribed.": "Impossible de s'abonner à l'état source pH.",

package/lib/i18n/it.json

@@ -181,6 +181,7 @@
   "solar_insights_label_solar_effective_now": "Solare attivo attualmente",
   "solar_insights_label_pool_reference_source": "Fonte di riferimento della piscina",
   "solar_insights_label_flow_source": "Fonte di flusso",
+  "solar_insights_label_thermal_delta_source": "Fonte delta termico",
   "solar_insights_label_weather_correction_active": "Correzione meteo attiva",
   "solar_insights_label_confidence": "Affidabilità",
   "solar_insights_label_used_sensors": "Sensori utilizzati",
@@ -256,6 +257,8 @@
   "photovoltaic_insights_debug_reason_no_pv_runtime": "Nessun funzionamento attivo con surplus FV",
   "photovoltaic_insights_debug_text_pv_runtime_active": "Il surplus FV è attivo e l'helper fotovoltaico possiede attualmente la pompa.",
   "photovoltaic_insights_debug_text_no_pv_runtime": "Attualmente non viene conteggiato alcun tempo di funzionamento FV perché non c'è surplus FV attivo oppure l'helper fotovoltaico non possiede la pompa.",
+  "photovoltaic_insights_debug_reason_daily_reset": "Reset giornaliero",
+  "photovoltaic_insights_debug_text_daily_reset": "I valori giornalieri degli insight fotovoltaici sono stati azzerati.",
 
   "pH source state configured.": "Stato sorgente pH configurato.",
   "pH source state could not be subscribed.": "Impossibile sottoscrivere lo stato sorgente pH.",

package/lib/i18n/nl.json

@@ -181,6 +181,7 @@
   "solar_insights_label_solar_effective_now": "Zonne-energie momenteel actief",
   "solar_insights_label_pool_reference_source": "Zwembadreferentiebron",
   "solar_insights_label_flow_source": "Debietbron",
+  "solar_insights_label_thermal_delta_source": "Bron thermisch verschil",
   "solar_insights_label_weather_correction_active": "Weercorrectie actief",
   "solar_insights_label_confidence": "Betrouwbaarheid",
   "solar_insights_label_used_sensors": "Gebruikte sensoren",
@@ -256,6 +257,8 @@
   "photovoltaic_insights_debug_reason_no_pv_runtime": "Geen actief PV-overschotbedrijf",
   "photovoltaic_insights_debug_text_pv_runtime_active": "PV-overschot is actief en de photovoltaic helper bezit momenteel de pomp.",
   "photovoltaic_insights_debug_text_no_pv_runtime": "Er wordt momenteel geen PV-looptijd geteld omdat er geen PV-overschot actief is of omdat de photovoltaic helper de pomp niet bezit.",
+  "photovoltaic_insights_debug_reason_daily_reset": "Dagelijkse reset",
+  "photovoltaic_insights_debug_text_daily_reset": "De dagelijkse fotovoltaïsche inzichten zijn gereset.",
 
   "pH source state configured.": "pH-bronstatus geconfigureerd.",
   "pH source state could not be subscribed.": "Kon niet abonneren op de pH-bronstatus.",

package/lib/i18n/pl.json

@@ -181,6 +181,7 @@
   "solar_insights_label_solar_effective_now": "Solary aktywne teraz",
   "solar_insights_label_pool_reference_source": "Źródło odniesienia basenu",
   "solar_insights_label_flow_source": "Źródło przepływu",
+  "solar_insights_label_thermal_delta_source": "Źródło różnicy temperatur",
   "solar_insights_label_weather_correction_active": "Korekcja pogodowa aktywna",
   "solar_insights_label_confidence": "Wiarygodność",
   "solar_insights_label_used_sensors": "Użyte czujniki",
@@ -256,6 +257,8 @@
   "photovoltaic_insights_debug_reason_no_pv_runtime": "Brak aktywnej pracy z nadwyżki PV",
   "photovoltaic_insights_debug_text_pv_runtime_active": "Nadwyżka PV jest aktywna, a helper fotowoltaiczny aktualnie posiada pompę.",
   "photovoltaic_insights_debug_text_no_pv_runtime": "Obecnie nie jest zliczany czas pracy PV, ponieważ nie ma aktywnej nadwyżki PV albo helper fotowoltaiczny nie posiada pompy.",
+  "photovoltaic_insights_debug_reason_daily_reset": "Reset dzienny",
+  "photovoltaic_insights_debug_text_daily_reset": "Dzienne dane fotowoltaiczne zostały zresetowane.",
 
   "pH source state configured.": "Skonfigurowano stan źródła pH.",
   "pH source state could not be subscribed.": "Nie można zasubskrybować stanu źródła pH.",

package/lib/i18n/pt.json

@@ -181,6 +181,7 @@
   "solar_insights_label_solar_effective_now": "Solar ativo no momento",
   "solar_insights_label_pool_reference_source": "Fonte de referência da piscina",
   "solar_insights_label_flow_source": "Fonte de fluxo",
+  "solar_insights_label_thermal_delta_source": "Fonte delta térmico",
   "solar_insights_label_weather_correction_active": "Correção meteorológica ativa",
   "solar_insights_label_confidence": "Confiabilidade",
   "solar_insights_label_used_sensors": "Sensores utilizados",
@@ -256,6 +257,8 @@
   "photovoltaic_insights_debug_reason_no_pv_runtime": "Nenhuma operação ativa com excedente FV",
   "photovoltaic_insights_debug_text_pv_runtime_active": "O excedente FV está ativo e o helper fotovoltaico possui atualmente a bomba.",
   "photovoltaic_insights_debug_text_no_pv_runtime": "Atualmente nenhum tempo de funcionamento FV é contado porque não há excedente FV ativo ou o helper fotovoltaico não possui a bomba.",
+  "photovoltaic_insights_debug_reason_daily_reset": "Reinício diário",
+  "photovoltaic_insights_debug_text_daily_reset": "Os valores diários de análise fotovoltaica foram redefinidos.",
 
   "pH source state configured.": "Estado de origem de pH configurado.",
   "pH source state could not be subscribed.": "Não foi possível subscrever o estado de origem de pH.",

package/lib/i18n/ru.json

@@ -181,6 +181,7 @@
   "solar_insights_label_solar_effective_now": "Солнечная система сейчас активна",
   "solar_insights_label_pool_reference_source": "Источник опорного значения бассейна",
   "solar_insights_label_flow_source": "Источник потока",
+  "solar_insights_label_thermal_delta_source": "Источник тепловой разницы",
   "solar_insights_label_weather_correction_active": "Погодная коррекция активна",
   "solar_insights_label_confidence": "Надёжность",
   "solar_insights_label_used_sensors": "Используемые датчики",
@@ -256,6 +257,8 @@
   "photovoltaic_insights_debug_reason_no_pv_runtime": "Нет активной работы от излишка PV",
   "photovoltaic_insights_debug_text_pv_runtime_active": "Излишек PV активен, и photovoltaic helper сейчас владеет насосом.",
   "photovoltaic_insights_debug_text_no_pv_runtime": "Время работы PV сейчас не учитывается, потому что либо нет активного излишка PV, либо photovoltaic helper не владеет насосом.",
+  "photovoltaic_insights_debug_reason_daily_reset": "Ежедневный сброс",
+  "photovoltaic_insights_debug_text_daily_reset": "Дневные значения фотогальванических данных были сброшены.",
 
   "pH source state configured.": "Состояние источника pH настроено.",
   "pH source state could not be subscribed.": "Не удалось подписаться на состояние источника pH.",

package/lib/i18n/uk.json

@@ -181,6 +181,7 @@
   "solar_insights_label_solar_effective_now": "Сонячна система зараз активна",
   "solar_insights_label_pool_reference_source": "Джерело опорного значення басейну",
   "solar_insights_label_flow_source": "Джерело потоку",
+  "solar_insights_label_thermal_delta_source": "Джерело теплової різниці",
   "solar_insights_label_weather_correction_active": "Погодні коригування активні",
   "solar_insights_label_confidence": "Надійність",
   "solar_insights_label_used_sensors": "Використані датчики",
@@ -256,6 +257,8 @@
   "photovoltaic_insights_debug_reason_no_pv_runtime": "Немає активної роботи від надлишку PV",
   "photovoltaic_insights_debug_text_pv_runtime_active": "Надлишок PV активний, і photovoltaic helper наразі володіє насосом.",
   "photovoltaic_insights_debug_text_no_pv_runtime": "Наразі час роботи PV не підраховується, оскільки або немає активного надлишку PV, або photovoltaic helper не володіє насосом.",
+  "photovoltaic_insights_debug_reason_daily_reset": "Щоденне скидання",
+  "photovoltaic_insights_debug_text_daily_reset": "Щоденні дані фотогальванічної аналітики були скинуті.",
 
   "pH source state configured.": "Стан джерела pH налаштовано.",
   "pH source state could not be subscribed.": "Не вдалося підписатися на стан джерела pH.",

package/lib/i18n/zh-cn.json

@@ -181,6 +181,7 @@
   "solar_insights_label_solar_effective_now": "当前太阳能有效",
   "solar_insights_label_pool_reference_source": "泳池参考来源",
   "solar_insights_label_flow_source": "流量来源",
+  "solar_insights_label_thermal_delta_source": "热量差来源",
   "solar_insights_label_weather_correction_active": "天气修正已启用",
   "solar_insights_label_confidence": "可信度",
   "solar_insights_label_used_sensors": "使用的传感器",
@@ -256,6 +257,8 @@
   "photovoltaic_insights_debug_reason_no_pv_runtime": "没有活跃的光伏余电运行",
   "photovoltaic_insights_debug_text_pv_runtime_active": "光伏余电处于激活状态，并且 photovoltaic helper 当前拥有泵。",
   "photovoltaic_insights_debug_text_no_pv_runtime": "当前未统计光伏运行时间，因为没有活跃的光伏余电，或者 photovoltaic helper 未拥有泵。",
+  "photovoltaic_insights_debug_reason_daily_reset": "每日重置",
+  "photovoltaic_insights_debug_text_daily_reset": "光伏分析的每日数据已重置。",
 
   "pH source state configured.": "已配置 pH 源状态。",
   "pH source state could not be subscribed.": "无法订阅 pH 源状态。",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "iobroker.poolcontrol",
-  "version": "1.3.11",
+  "version": "1.3.13",
   "description": "Steuerung & Automatisierung für den Pool (Pumpe, Heizung, Ventile, Sensoren).",
   "author": "DasBo1975 <dasbo1975@outlook.de>",
   "homepage": "https://github.com/DasBo1975/ioBroker.poolcontrol",
@@ -18,7 +18,7 @@
     "url": "git+https://github.com/DasBo1975/ioBroker.poolcontrol.git"
   },
   "engines": {
-    "node": ">= 20"
+    "node": ">= 22"
   },
   "dependencies": {
     "@iobroker/adapter-core": "^3.3.2"