iobroker.poolcontrol 1.3.7 → 1.3.10

package/README.md

@@ -188,6 +188,48 @@ New features are added regularly – please refer to the changelog.
 ---
 
 ## Changelog
+### 1.3.10 (2026-05-01)
+
+New: Photovoltaic Insights
+- Introduced a new analytics module `analytics.insights.photovoltaic`
+- Tracks PV-based pump runtime, energy usage and estimated savings
+- New helper: `photovoltaicInsightsHelper`
+- New states: inputs, calculation, results, debug
+- Includes summary outputs (text, JSON, HTML)
+- Fully integrated with i18n translations
+
+Improvement: Active Helper Handling
+- Added consistent `pump.active_helper` ownership handling for:
+  - photovoltaicHelper
+  - solarHelper
+  - solarExtendedHelper
+- Each helper now:
+  - sets its own identifier when controlling the pump
+  - releases it when stopping
+  - does not override other active helpers
+- Ensures correct priority handling and prevents conflicts
+
+Improvement: PV Runtime Evaluation
+- Photovoltaic runtime is now only counted when:
+  - PV surplus is active
+  - AND photovoltaicHelper actually owns the pump
+- Enables accurate runtime, energy and savings calculation
+
+Fix: PV Circulation Logic
+- Fixed issue where pump stopped despite `photovoltaic.ignore_on_circulation = false`
+- Circulation check is now only applied when explicitly enabled
+
+### 1.3.9 (2026-04-24)
+
+- Fix: solarLogbookHelper no longer creates duplicate or unnecessary log entries (improved filtering & throttling logic)
+- Fix: Removed obsolete "no runtime today" entries once solar has actually run
+- Fix: Improved handling of weather summary text to avoid broken or cut-off sentences
+- Fix: solarLogbookHelper now updates `last_entry_time` only when a real log entry is written
+- Fix: solarInsightsHelper runtime calculation improved (no incorrect time accumulation on state changes)
+- Fix: solarInsightsHelper now correctly tracks previous solar state for more accurate active time calculation
+- 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
@@ -208,16 +250,6 @@ frostHelper
 - Fixed critical i18n issue in solarInsightsHelper and solarLogbookHelper that could lead to instability or crashes
 - Switched translation handling to I18n.translate() for stable and consistent i18n behavior
 
-### 1.3.4 (2026-04-19)
-
-- Fixed critical i18n issue in solarInsightsHelper and solarLogbookHelper that could lead to instability or crashes
-- Switched translation handling to I18n.translate() for stable and consistent i18n behavior
-
-### 1.3.3 (2026-04-18)
-
-- Added solar COP calculation to evaluate system efficiency
-- Added solar logbook helper with easy-to-read daily summaries for better user understanding
-
 ## 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.7",
+    "version": "1.3.10",
     "news": {
+      "1.3.10": {
+        "en": "Added photovoltaic insights (runtime, energy, savings) with new analytics states and helper. Improved active_helper ownership handling across photovoltaic, solar and extended solar helpers. Fixed PV circulation logic when ignore_on_circulation is disabled.",
+        "de": "Photovoltaik-Einblicke (Laufzeit, Energie, Einsparungen) mit neuen Analysezuständen und Hilfsfunktionen hinzugefügt. Verbesserte Handhabung des Active_Helper-Besitzes für Photovoltaik-, Solar- und erweiterte Solar-Helfer. Die PV-Zirkulationslogik wurde korrigiert, wenn „ignore_on_circulation“ deaktiviert ist.",
+        "ru": "Добавлены данные по фотоэлектрической энергии (время работы, энергия, экономия) с новыми аналитическими состояниями и помощником. Улучшено управление владением active_helper для фотоэлектрических, солнечных и расширенных солнечных помощников. Исправлена ​​логика циркуляции PV, когда ignore_on_circulation отключен.",
+        "pt": "Adicionados insights fotovoltaicos (tempo de execução, energia, economia) com novos estados analíticos e auxiliares. Melhor gerenciamento de propriedade de active_helper em ajudantes fotovoltaicos, solares e solares estendidos. Lógica de circulação fotovoltaica corrigida quando ignore_on_circulation está desativado.",
+        "nl": "Fotovoltaïsche inzichten toegevoegd (runtime, energie, besparingen) met nieuwe analysestatussen en helper. Verbeterde afhandeling van active_helper-eigendom voor fotovoltaïsche, zonne-energie en uitgebreide zonne-helpers. Vaste PV-circulatielogica wanneer negeer_on_circulatie is uitgeschakeld.",
+        "fr": "Ajout d'informations photovoltaïques (durée de fonctionnement, énergie, économies) avec de nouveaux états d'analyse et une nouvelle aide. Amélioration de la gestion de la propriété active_helper pour les assistants photovoltaïques, solaires et solaires étendus. Correction de la logique de circulation PV lorsque ignore_on_circulation est désactivé.",
+        "it": "Aggiunti approfondimenti sul fotovoltaico (autonomia, energia, risparmio) con nuovi stati di analisi e supporto. Migliorata la gestione della proprietà di active_helper tra gli helper fotovoltaici, solari e solari estesi. Risolta la logica di circolazione FV quando ignore_on_circulation è disabilitato.",
+        "es": "Se agregaron conocimientos fotovoltaicos (tiempo de ejecución, energía, ahorros) con nuevos estados analíticos y ayuda. Se mejoró el manejo de la propiedad de active_helper en los asistentes fotovoltaicos, solares y solares extendidos. Se corrigió la lógica de circulación de PV cuando ignore_on_circulation estaba deshabilitado.",
+        "pl": "Dodano statystyki fotowoltaiczne (czas pracy, energia, oszczędności) z nowymi stanami analitycznymi i pomocą. Ulepszona obsługa własności active_helper w przypadku fotowoltaiki, energii słonecznej i rozszerzonych pomocników energii słonecznej. Naprawiono logikę cyrkulacji PV, gdy ignorowanie_cyrkulacji jest wyłączone.",
+        "uk": "Додано статистику фотоелектричної системи (час роботи, енергія, економія) з новими аналітичними станами та помічником. Покращено керування правами власності active_helper на фотоелектричні, сонячні та розширені сонячні помічники. Виправлена ​​логіка циркуляції PV, коли ignore_on_circulation вимкнено.",
+        "zh-cn": "通过新的分析状态和帮助器添加了光伏见解（运行时间、能源、节省）。改进了跨光伏、太阳能和扩展太阳能助手的 active_helper 所有权处理。修复了禁用ignore_on_circulation时的PV循环逻辑。"
+      },
+      "1.3.9": {
+        "en": "Fix solar logbook duplication and invalid entries, improve log stability and weather text handling; fix solar insights runtime calculation and debug timestamp update.",
+        "de": "Behebung von doppelten und ungültigen Solar-Logbuch-Einträgen, Verbesserung der Log-Stabilität und Wettertext-Verarbeitung; Korrektur der Laufzeitberechnung im Solar-Insights-Bereich sowie Aktualisierung des Debug-Zeitstempels.",
+        "ru": "Исправьте дублирование журнала солнечной энергии и неверные записи, улучшите стабильность журнала и обработку текста о погоде; исправить расчет времени выполнения Solar Insights и обновить временную метку отладки.",
+        "pt": "Corrija a duplicação do diário de bordo solar e entradas inválidas, melhore a estabilidade do registro e o manuseio de textos meteorológicos; corrigir o cálculo do tempo de execução do Solar Insights e depurar a atualização do carimbo de data/hora.",
+        "nl": "Herstel het dupliceren van zonnelogboeken en ongeldige vermeldingen, verbeter de logstabiliteit en de verwerking van weerteksten; runtimeberekening van zonne-inzichten repareren en tijdstempelupdate debuggen.",
+        "fr": "Corrigez la duplication du journal solaire et les entrées invalides, améliorez la stabilité du journal et la gestion des textes météorologiques ; correction du calcul d'exécution des informations solaires et de la mise à jour de l'horodatage de débogage.",
+        "it": "Correggere la duplicazione del registro solare e le voci non valide, migliorare la stabilità del registro e la gestione del testo meteorologico; correggere il calcolo del runtime di Solar Insights e l'aggiornamento del timestamp di debug.",
+        "es": "Corrija la duplicación del libro de registro solar y las entradas no válidas, mejore la estabilidad del registro y el manejo de textos meteorológicos; corrige el cálculo del tiempo de ejecución de Solar Insights y la actualización de la marca de tiempo de depuración.",
+        "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.",
@@ -41,32 +67,6 @@
         "pl": "Naprawiono krytyczny problem i18n w programach solarInsightsHelper i solarLogbookHelper, który mógł prowadzić do niestabilności lub awarii. Przełączono obsługę tłumaczeń na I18n.translate(), aby zapewnić stabilne działanie.",
         "uk": "Виправлено критичну проблему i18n у solarInsightsHelper і solarLogbookHelper, яка могла призвести до нестабільності або збоїв. Перемкнуто обробку перекладу на I18n.translate(), щоб забезпечити стабільну роботу.",
         "zh-cn": "修复了 SolarInsightsHelper 和 SolarLogbookHelper 中可能导致不稳定或崩溃的关键 i18n 问题。将翻译处理切换为 I18n.translate() 以确保稳定运行。"
-      },
-      "1.3.4": {
-        "en": "Fixed critical i18n issue in solarInsightsHelper and solarLogbookHelper that could lead to instability or crashes. Switched translation handling to I18n.translate() to ensure stable operation.",
-        "de": "Kritischer i18n-Fehler in solarInsightsHelper und solarLogbookHelper behoben, der zu Instabilität oder Abstürzen führen konnte. Übersetzungen wurden auf I18n.translate() umgestellt, um einen stabilen Betrieb sicherzustellen.",
-        "ru": "Исправлена ​​критическая проблема i18n в SolarInsightsHelper и SolarLogbookHelper, которая могла привести к нестабильности или сбоям. Обработку перевода переключили на I18n.translate() для обеспечения стабильной работы.",
-        "pt": "Foi corrigido um problema crítico do i18n no solarInsightsHelper e no solarLogbookHelper que poderia causar instabilidade ou travamentos. Manipulação de tradução alterada para I18n.translate() para garantir uma operação estável.",
-        "nl": "Een kritiek i18n-probleem in solarInsightsHelper en solarLogbookHelper opgelost dat tot instabiliteit of crashes kon leiden. De verwerking van de vertalingen is gewijzigd naar I18n.translate() om een ​​stabiele werking te garanderen.",
-        "fr": "Correction d'un problème i18n critique dans solarInsightsHelper et solarLogbookHelper qui pouvait entraîner une instabilité ou des plantages. Gestion de la traduction commutée vers I18n.translate() pour garantir un fonctionnement stable.",
-        "it": "Risolto un problema critico i18n in solarInsightsHelper e solarLogbookHelper che poteva portare a instabilità o arresti anomali. Modificata la gestione della traduzione su I18n.translate() per garantire un funzionamento stabile.",
-        "es": "Se solucionó un problema crítico de i18n en solarInsightsHelper y solarLogbookHelper que podía provocar inestabilidad o fallas. Se cambió el manejo de traducción a I18n.translate() para garantizar un funcionamiento estable.",
-        "pl": "Naprawiono krytyczny problem i18n w programach solarInsightsHelper i solarLogbookHelper, który mógł prowadzić do niestabilności lub awarii. Przełączono obsługę tłumaczeń na I18n.translate(), aby zapewnić stabilne działanie.",
-        "uk": "Виправлено критичну проблему i18n у solarInsightsHelper і solarLogbookHelper, яка могла призвести до нестабільності або збоїв. Перемкнуто обробку перекладу на I18n.translate(), щоб забезпечити стабільну роботу.",
-        "zh-cn": "修复了 SolarInsightsHelper 和 SolarLogbookHelper 中可能导致不稳定或崩溃的关键 i18n 问题。将翻译处理切换为 I18n.translate() 以确保稳定运行。"
-      },
-      "1.3.3": {
-        "en": "Added solar COP calculation and solar logbook helper with human-readable daily entries based on solar insights.",
-        "de": "Solar-COP-Berechnung sowie Solar-Logbuch-Helper mit verständlichen Tages-Einträgen basierend auf Solar-Insights hinzugefügt.",
-        "ru": "Добавлен расчет солнечного КПД и помощник в журнале солнечной энергии с удобочитаемыми ежедневными записями на основе данных о солнечной энергии.",
-        "pt": "Adicionado cálculo de COP solar e auxiliar de diário de bordo solar com entradas diárias legíveis por humanos com base em insights solares.",
-        "nl": "Zonne-COP-berekening en zonne-logboekhulp toegevoegd met voor mensen leesbare dagelijkse gegevens op basis van zonne-inzichten.",
-        "fr": "Ajout du calcul du COP solaire et d'un assistant de journal de bord solaire avec des entrées quotidiennes lisibles par l'homme basées sur des informations solaires.",
-        "it": "Aggiunto il calcolo del COP solare e l'assistente del registro solare con voci giornaliere leggibili dall'uomo basate su informazioni solari.",
-        "es": "Se agregó un cálculo de COP solar y un asistente de registro solar con entradas diarias legibles por humanos basadas en conocimientos solares.",
-        "pl": "Dodano obliczenia COP energii słonecznej i pomocnika dziennika słonecznego z czytelnymi dla człowieka codziennymi wpisami opartymi na spostrzeżeniach dotyczących energii słonecznej.",
-        "uk": "Додано розрахунок COP сонячної енергії та помічник сонячного журналу із зрозумілими для людини щоденними записами на основі даних про сонячну енергію.",
-        "zh-cn": "添加了太阳能 COP 计算和太阳能日志助手，其中包含基于太阳能洞察的人类可读的每日条目。"
       }
     },
     "titleLang": {
@@ -133,7 +133,8 @@
       {
         "admin": ">=7.6.20"
       }
-    ]
+    ],
+    "installedFrom": "file:///opt/iobroker/ioBroker.poolcontrol"
   },
   "native": {},
   "objects": [],

package/lib/helpers/photovoltaicHelper.js

@@ -207,28 +207,29 @@ const photovoltaicHelper = {
             }
         }
 
-        // FIX: PV-Schaltlogik mit Prüfung der Umwälzung
+        // FIX: PV switching logic must only block on fulfilled circulation target if ignoreOnCirc is enabled
         if (surplusActive) {
-            try {
-                const remainingState = await this.adapter.getForeignStateAsync(
-                    'poolcontrol.0.circulation.daily_remaining',
-                );
-                const remaining = Number(remainingState?.val ?? NaN);
-
-                // RULE: Einschalten nur, wenn Umwälzung noch nicht erfüllt
-                if (Number.isFinite(remaining) && remaining <= 0) {
-                    this.adapter.log.info(
-                        `[photovoltaicHelper] Daily circulation target already reached (${remaining}) → pump stays OFF (no start despite surplus).`,
+            if (ignoreOnCirc) {
+                try {
+                    const remainingState = await this.adapter.getForeignStateAsync(
+                        'poolcontrol.0.circulation.daily_remaining',
                     );
-                    return this._maybeStopPump(true, 0, 'circulation_already_reached');
-                }
+                    const remaining = Number(remainingState?.val ?? NaN);
 
-                // RULE: Überschuss aktiv UND Umwälzung noch nicht erfüllt → einschalten
-                return this._maybeStartPump('pv_surplus');
-            } catch (err) {
-                this.adapter.log.warn(`[photovoltaicHelper] Error while checking daily_remaining: ${err.message}`);
-                return this._maybeStartPump('pv_surplus');
+                    // RULE: Start only if circulation target is not fulfilled yet
+                    if (Number.isFinite(remaining) && remaining <= 0) {
+                        this.adapter.log.info(
+                            `[photovoltaicHelper] Daily circulation target already reached (${remaining}) → pump stays OFF (no start despite surplus).`,
+                        );
+                        return this._maybeStopPump(true, 0, 'circulation_already_reached');
+                    }
+                } catch (err) {
+                    this.adapter.log.warn(`[photovoltaicHelper] Error while checking daily_remaining: ${err.message}`);
+                }
             }
+
+            // RULE: Surplus active and no circulation blocking active → switch on
+            return this._maybeStartPump('pv_surplus');
         }
 
         // RULE: Kein Überschuss → ggf. Nachlauf/Aus
@@ -249,6 +250,8 @@ const photovoltaicHelper = {
         }
         this._pvPumpHoldUntil = 0;
 
+        await this._setActiveHelperIfAllowed('photovoltaicHelper');
+
         if (this._desiredPump === true) {
             return;
         }
@@ -287,6 +290,7 @@ const photovoltaicHelper = {
             this._desiredPump = false;
             this.adapter.log.info(`[photovoltaicHelper] Pump OFF (${tag}, no afterrun)`);
             await this._setPumpSwitch(false);
+            await this._releaseActiveHelperIfOwned();
             return;
         }
 
@@ -321,6 +325,7 @@ const photovoltaicHelper = {
             this._desiredPump = false;
             this.adapter.log.info('[photovoltaicHelper] Pump OFF (afterrun finished)');
             await this._setPumpSwitch(false);
+            await this._releaseActiveHelperIfOwned();
         }, holdMs);
 
         this.adapter.log.debug(`[photovoltaicHelper] Afterrun started: ${afterrunMin} min (${tag})`);
@@ -334,6 +339,37 @@ const photovoltaicHelper = {
         }
     },
 
+    async _setActiveHelperIfAllowed(helperName) {
+        try {
+            const activeHelper = (await this.adapter.getStateAsync('pump.active_helper'))?.val || '';
+
+            if (activeHelper && activeHelper !== helperName) {
+                this.adapter.log.debug(
+                    `[photovoltaicHelper] Active helper not changed because '${activeHelper}' currently owns the pump.`,
+                );
+                return;
+            }
+
+            await this.adapter.setStateAsync('pump.active_helper', { val: helperName, ack: true });
+        } catch (err) {
+            this.adapter.log.warn(`[photovoltaicHelper] Could not set pump.active_helper: ${err.message}`);
+        }
+    },
+
+    async _releaseActiveHelperIfOwned() {
+        try {
+            const activeHelper = (await this.adapter.getStateAsync('pump.active_helper'))?.val || '';
+
+            if (activeHelper !== 'photovoltaicHelper') {
+                return;
+            }
+
+            await this.adapter.setStateAsync('pump.active_helper', { val: '', ack: true });
+        } catch (err) {
+            this.adapter.log.warn(`[photovoltaicHelper] Could not release pump.active_helper: ${err.message}`);
+        }
+    },
+
     async _updateNumberState(id, val) {
         try {
             await this.adapter.setStateAsync(id, { val: Number(val) || 0, ack: true });

package/lib/helpers/photovoltaicInsightsHelper.js

@@ -0,0 +1,306 @@
+'use strict';
+
+const { I18n } = require('@iobroker/adapter-core');
+
+const photovoltaicInsightsHelper = {
+    adapter: null,
+    checkTimer: null,
+    lastResultTimestamp: null,
+    lastPvRuntimeActive: false,
+
+    init(adapter) {
+        this.adapter = adapter;
+
+        void this._subscribeStates();
+        this._scheduleCheck(0);
+
+        this.adapter.log.debug(
+            '[photovoltaicInsightsHelper] Initialized (Block 1 inputs, Block 2 calculation, Block 3 results, Block 4 debug)',
+        );
+    },
+
+    handleStateChange(id, state) {
+        if (!state || state.ack !== true) {
+            return;
+        }
+
+        if (!this._isRelevantState(id)) {
+            return;
+        }
+
+        this._scheduleCheck(200);
+    },
+
+    _scheduleCheck(delayMs = 0) {
+        if (this.checkTimer) {
+            this.adapter.clearTimeout(this.checkTimer);
+            this.checkTimer = null;
+        }
+
+        this.checkTimer = this.adapter.setTimeout(() => {
+            this.checkTimer = null;
+            void this._updateInputs();
+        }, delayMs);
+    },
+
+    async _subscribeStates() {
+        const ids = [
+            'photovoltaic.power_surplus_w',
+            'photovoltaic.surplus_active',
+            'pump.live.current_power_w',
+            'pump.active_helper',
+        ];
+
+        for (const id of ids) {
+            await this.adapter.subscribeStatesAsync(id);
+        }
+
+        this.adapter.log.debug('[photovoltaicInsightsHelper] Subscribed to input states');
+    },
+
+    _isRelevantState(id) {
+        const ids = [
+            'photovoltaic.power_surplus_w',
+            'photovoltaic.surplus_active',
+            'pump.live.current_power_w',
+            'pump.active_helper',
+        ];
+
+        return ids.some(relevantId => id === relevantId || id.endsWith(`.${relevantId}`));
+    },
+
+    async _updateInputs() {
+        try {
+            const pvSurplusW = await this._readNumber('photovoltaic.power_surplus_w');
+            const pvSurplusActive = await this._readBoolean('photovoltaic.surplus_active');
+
+            const pumpPowerW = await this._readNumber('pump.live.current_power_w');
+
+            await this.adapter.setStateChangedAsync('analytics.insights.photovoltaic.inputs.pv_surplus_w', {
+                val: Number.isFinite(pvSurplusW) ? pvSurplusW : 0,
+                ack: true,
+            });
+
+            await this.adapter.setStateChangedAsync('analytics.insights.photovoltaic.inputs.pv_surplus_active', {
+                val: pvSurplusActive,
+                ack: true,
+            });
+
+            await this.adapter.setStateChangedAsync('analytics.insights.photovoltaic.inputs.pump_power_w', {
+                val: Number.isFinite(pumpPowerW) ? pumpPowerW : 0,
+                ack: true,
+            });
+
+            await this._updateCalculation();
+            await this._updateResults();
+
+            this.adapter.log.debug('[photovoltaicInsightsHelper] Inputs, calculation and results updated');
+        } catch (err) {
+            this.adapter.log.warn(`[photovoltaicInsightsHelper] Error updating inputs: ${err.message}`);
+        }
+    },
+
+    async _updateCalculation() {
+        await this.adapter.setStateChangedAsync('analytics.insights.photovoltaic.calculation.mode', {
+            val: I18n.translate('photovoltaic_insights_calculation_mode_daily'),
+            ack: true,
+        });
+
+        await this.adapter.setStateChangedAsync('analytics.insights.photovoltaic.calculation.price_source', {
+            val: I18n.translate('photovoltaic_insights_price_source_adapter_config'),
+            ack: true,
+        });
+
+        await this.adapter.setStateChangedAsync('analytics.insights.photovoltaic.calculation.note', {
+            val: I18n.translate('photovoltaic_insights_calculation_note_block_2'),
+            ack: true,
+        });
+    },
+
+    async _updateResults() {
+        const now = Date.now();
+
+        const pvSurplusActive = await this._readBoolean('photovoltaic.surplus_active');
+        const pumpPowerW = await this._readNumber('pump.live.current_power_w');
+        const activeHelper = await this._readString('pump.active_helper');
+        const electricityPriceEurKwh = Number(this.adapter.config.energy_price_eur_kwh);
+
+        const pvControlsPump = activeHelper === 'photovoltaicHelper';
+        const pvRuntimeActive = pvSurplusActive && pvControlsPump;
+
+        let runtimeTodayMin = await this._readNumber('analytics.insights.photovoltaic.results.runtime_today_min');
+        let energyUsedTodayKwh = await this._readNumber(
+            'analytics.insights.photovoltaic.results.energy_used_today_kwh',
+        );
+        let savingsTodayEur = await this._readNumber('analytics.insights.photovoltaic.results.savings_today_eur');
+        let startsToday = await this._readNumber('analytics.insights.photovoltaic.results.starts_today');
+
+        runtimeTodayMin = Number.isFinite(runtimeTodayMin) ? runtimeTodayMin : 0;
+        energyUsedTodayKwh = Number.isFinite(energyUsedTodayKwh) ? energyUsedTodayKwh : 0;
+        savingsTodayEur = Number.isFinite(savingsTodayEur) ? savingsTodayEur : 0;
+        startsToday = Number.isFinite(startsToday) ? startsToday : 0;
+
+        if (pvRuntimeActive && !this.lastPvRuntimeActive) {
+            startsToday += 1;
+            this.lastResultTimestamp = now;
+        }
+
+        if (pvRuntimeActive && this.lastResultTimestamp && Number.isFinite(pumpPowerW) && pumpPowerW > 0) {
+            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 (pvRuntimeActive) {
+            this.lastResultTimestamp = now;
+        } else {
+            this.lastResultTimestamp = null;
+        }
+
+        this.lastPvRuntimeActive = pvRuntimeActive;
+
+        const activeToday = runtimeTodayMin > 0 || startsToday > 0;
+
+        await this.adapter.setStateChangedAsync('analytics.insights.photovoltaic.results.active_today', {
+            val: activeToday,
+            ack: true,
+        });
+
+        await this.adapter.setStateChangedAsync('analytics.insights.photovoltaic.results.runtime_today_min', {
+            val: runtimeTodayMin,
+            ack: true,
+        });
+
+        await this.adapter.setStateChangedAsync('analytics.insights.photovoltaic.results.energy_used_today_kwh', {
+            val: energyUsedTodayKwh,
+            ack: true,
+        });
+
+        await this.adapter.setStateChangedAsync('analytics.insights.photovoltaic.results.savings_today_eur', {
+            val: savingsTodayEur,
+            ack: true,
+        });
+
+        await this.adapter.setStateChangedAsync('analytics.insights.photovoltaic.results.starts_today', {
+            val: startsToday,
+            ack: true,
+        });
+
+        const summaryText = I18n.translate('photovoltaic_insights_summary_text_block_3')
+            .replace('%s', runtimeTodayMin.toFixed(0))
+            .replace('%s', energyUsedTodayKwh.toFixed(2))
+            .replace('%s', savingsTodayEur.toFixed(2));
+
+        const summaryJson = {
+            mode: 'daily_pv_surplus_analysis',
+            pv_surplus_active: pvSurplusActive,
+            pv_controls_pump: pvControlsPump,
+            pv_runtime_active: pvRuntimeActive,
+            active_today: activeToday,
+            values: {
+                pv_surplus_w: await this._readNumber('photovoltaic.power_surplus_w'),
+                pump_power_w: Number.isFinite(pumpPowerW) ? pumpPowerW : null,
+                electricity_price_eur_kwh: Number.isFinite(electricityPriceEurKwh) ? electricityPriceEurKwh : null,
+                runtime_today_min: runtimeTodayMin,
+                energy_used_today_kwh: energyUsedTodayKwh,
+                savings_today_eur: savingsTodayEur,
+                starts_today: startsToday,
+            },
+            note: I18n.translate('photovoltaic_insights_calculation_note_block_2'),
+        };
+
+        const summaryHtml = [
+            '<div>',
+            `<b>${I18n.translate('photovoltaic_insights_label_mode')}:</b> ${I18n.translate('photovoltaic_insights_calculation_mode_daily')}<br>`,
+            `<b>${I18n.translate('photovoltaic_insights_label_pv_surplus_active')}:</b> ${pvSurplusActive}<br>`,
+            `<b>${I18n.translate('photovoltaic_insights_label_pv_controls_pump')}:</b> ${pvControlsPump}<br>`,
+            `<b>${I18n.translate('photovoltaic_insights_label_runtime_today')}:</b> ${runtimeTodayMin.toFixed(2)} min<br>`,
+            `<b>${I18n.translate('photovoltaic_insights_label_energy_used_today')}:</b> ${energyUsedTodayKwh.toFixed(4)} kWh<br>`,
+            `<b>${I18n.translate('photovoltaic_insights_label_savings_today')}:</b> ${savingsTodayEur.toFixed(2)} €<br>`,
+            `<b>${I18n.translate('photovoltaic_insights_label_starts_today')}:</b> ${startsToday}<br>`,
+            `<b>${I18n.translate('photovoltaic_insights_label_summary')}:</b> ${summaryText}`,
+            '</div>',
+        ].join('');
+
+        await this.adapter.setStateChangedAsync('analytics.insights.photovoltaic.results.summary_text', {
+            val: summaryText,
+            ack: true,
+        });
+
+        await this.adapter.setStateChangedAsync('analytics.insights.photovoltaic.results.summary_json', {
+            val: JSON.stringify(summaryJson),
+            ack: true,
+        });
+
+        await this.adapter.setStateChangedAsync('analytics.insights.photovoltaic.results.summary_html', {
+            val: summaryHtml,
+            ack: true,
+        });
+
+        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: pvRuntimeActive
+                ? I18n.translate('photovoltaic_insights_debug_reason_pv_runtime_active')
+                : I18n.translate('photovoltaic_insights_debug_reason_no_pv_runtime'),
+            ack: true,
+        });
+
+        await this.adapter.setStateChangedAsync('analytics.insights.photovoltaic.debug.debug_text', {
+            val: pvRuntimeActive
+                ? I18n.translate('photovoltaic_insights_debug_text_pv_runtime_active')
+                : I18n.translate('photovoltaic_insights_debug_text_no_pv_runtime'),
+            ack: true,
+        });
+    },
+
+    async _readState(id) {
+        try {
+            return await this.adapter.getStateAsync(id);
+        } catch {
+            return null;
+        }
+    },
+
+    async _readBoolean(id) {
+        const state = await this._readState(id);
+        return state ? state.val === true : false;
+    },
+
+    async _readNumber(id) {
+        const state = await this._readState(id);
+
+        if (!state || state.val === null || state.val === undefined || state.val === '') {
+            return null;
+        }
+
+        const value = Number(state.val);
+        return Number.isFinite(value) ? value : null;
+    },
+
+    async _readString(id) {
+        const state = await this._readState(id);
+        return state && state.val !== undefined ? String(state.val) : '';
+    },
+
+    cleanup() {
+        if (this.checkTimer) {
+            this.adapter.clearTimeout(this.checkTimer);
+            this.checkTimer = null;
+        }
+    },
+};
+
+module.exports = photovoltaicInsightsHelper;

package/lib/helpers/solarExtendedHelper.js

@@ -235,10 +235,18 @@ const solarExtendedHelper = {
             // wenn Solar Extended überhaupt der zuständige Solarmodus ist
             // und keine höhere Fremdpriorität aktiv ist.
             if (isExtendedMode && !isControlPriority && !isTimePriority) {
+                if (speechSolarActive) {
+                    await this._setActiveHelperIfAllowed('solarExtendedHelper');
+                } else {
+                    await this._releaseActiveHelperIfOwned();
+                }
+
                 await this.adapter.setStateChangedAsync('pump.pump_switch', {
                     val: speechSolarActive,
                     ack: false,
                 });
+            } else {
+                await this._releaseActiveHelperIfOwned();
             }
 
             await this.adapter.setStateChangedAsync('solar.extended.enabled_by_master', {
@@ -309,6 +317,37 @@ const solarExtendedHelper = {
         }
     },
 
+    async _setActiveHelperIfAllowed(helperName) {
+        try {
+            const activeHelper = (await this.adapter.getStateAsync('pump.active_helper'))?.val || '';
+
+            if (activeHelper && activeHelper !== helperName) {
+                this.adapter.log.debug(
+                    `[solarExtendedHelper] Active helper not changed because '${activeHelper}' currently owns the pump.`,
+                );
+                return;
+            }
+
+            await this.adapter.setStateAsync('pump.active_helper', { val: helperName, ack: true });
+        } catch (err) {
+            this.adapter.log.warn(`[solarExtendedHelper] Could not set pump.active_helper: ${err.message}`);
+        }
+    },
+
+    async _releaseActiveHelperIfOwned() {
+        try {
+            const activeHelper = (await this.adapter.getStateAsync('pump.active_helper'))?.val || '';
+
+            if (activeHelper !== 'solarExtendedHelper') {
+                return;
+            }
+
+            await this.adapter.setStateAsync('pump.active_helper', { val: '', ack: true });
+        } catch (err) {
+            this.adapter.log.warn(`[solarExtendedHelper] Could not release pump.active_helper: ${err.message}`);
+        }
+    },
+
     cleanup() {
         if (this.checkTimer) {
             this.adapter.clearInterval(this.checkTimer);