iobroker.poolcontrol 1.3.14 → 1.3.15

package/README.md

@@ -188,6 +188,23 @@ New features are added regularly – please refer to the changelog.
 ---
 
 ## Changelog
+### 1.3.15 (2026-05-08)
+
+- Added speech source cooldown handling for solar and time announcements
+- Added configurable `speech.sources.*` states for source-based speech control
+- Reduced excessive solar speech notifications during unstable weather conditions
+- Added persistent numeric runtime second states:
+  - `runtime.total_seconds`
+  - `runtime.today_seconds`
+  - `runtime.current_session_seconds`
+  - `runtime.season_total_seconds`
+- Improved runtime restore handling using numeric fallback logic
+- Fixed live runtime display consistency for total, today and season runtimes
+- Improved season runtime handling using `status.season_active`
+- Converted runtime helper timers to ioBroker adapter timer methods
+- Improved runtime timer cleanup and reset protection
+- Improved speech logging for skipped and cooldown-limited announcements
+
 ### 1.3.14 (2026-05-08)
 
 - Improved runtime handling and persistence
@@ -270,37 +287,6 @@ New features are added regularly – please refer to the changelog.
     - improves separation of solar control modes
     - stabilizes speech output behavior
 
-### 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
-
 ## Support
 - [ioBroker Forum](https://forum.iobroker.net/)  
 - [GitHub Issues](https://github.com/DasBo1975/ioBroker.poolcontrol/issues)

package/io-package.json

@@ -1,8 +1,21 @@
 {
   "common": {
     "name": "poolcontrol",
-    "version": "1.3.14",
+    "version": "1.3.15",
     "news": {
+      "1.3.15": {
+        "en": "Added speech source cooldown handling, improved solar/time speech control, added persistent runtime second states, improved runtime restore logic and converted runtime timers to ioBroker adapter timers.",
+        "de": "Sprachquellen mit Cooldown-Steuerung ergänzt, Solar-/Zeit-Sprachsteuerung verbessert, persistente Runtime-Sekundenstates hinzugefügt, Runtime-Wiederherstellung verbessert und Runtime-Timer auf ioBroker-Adapter-Timer umgestellt.",
+        "ru": "Добавлена ​​обработка перезарядки источника речи, улучшено управление речью по солнечной энергии и времени, добавлены постоянные секунды времени выполнения, улучшена логика восстановления времени выполнения и преобразованы таймеры времени выполнения в таймеры адаптера ioBroker.",
+        "pt": "Adicionado tratamento de resfriamento da fonte de fala, controle de fala solar/tempo aprimorado, segundos estados de tempo de execução persistentes adicionados, lógica de restauração de tempo de execução aprimorada e temporizadores de tempo de execução convertidos em temporizadores de adaptador ioBroker.",
+        "nl": "Afkoeling van spraakbronnen toegevoegd, verbeterde spraakcontrole op zonne-energie/tijd, persistente tweede runtime-statussen toegevoegd, verbeterde runtime-herstellogica en geconverteerde runtime-timers naar ioBroker-adaptertimers.",
+        "fr": "Ajout de la gestion du temps de recharge de la source vocale, du contrôle vocal solaire/temporel amélioré, ajout des seconds états d'exécution persistants, amélioration de la logique de restauration de l'exécution et conversion des minuteries d'exécution en minuteries d'adaptateur ioBroker.",
+        "it": "Aggiunta la gestione del raffreddamento della sorgente vocale, controllo vocale solare/ora migliorato, aggiunti secondi stati di runtime persistenti, logica di ripristino del runtime migliorata e timer di runtime convertiti in timer dell'adattatore ioBroker.",
+        "es": "Se agregó manejo de enfriamiento de la fuente de voz, control de voz solar/tiempo mejorado, se agregaron segundos estados de tiempo de ejecución persistentes, lógica de restauración de tiempo de ejecución mejorada y temporizadores de tiempo de ejecución convertidos en temporizadores de adaptador ioBroker.",
+        "pl": "Dodano obsługę schładzania źródła mowy, ulepszoną kontrolę mowy w czasie słonecznym/czasem, dodano trwałe drugie stany czasu wykonania, ulepszoną logikę przywracania w czasie wykonywania i przekonwertowano liczniki czasu działania na liczniki czasu adaptera ioBroker.",
+        "uk": "Додано обробку перезарядки джерела мовлення, покращено керування мовленням із сонячними променями/часом, додано постійні другі стани під час виконання, покращено логіку відновлення під час виконання та перетворено таймери часу виконання на таймери адаптера ioBroker.",
+        "zh-cn": "添加了语音源冷却处理、改进了太阳/时间语音控制、添加了持久运行时第二状态、改进了运行时恢复逻辑并将运行时计时器转换为 ioBroker 适配器计时器。"
+      },
       "1.3.14": {
         "en": "Improved runtime handling and persistence. Fixed season runtime calculation to use the correct season state, improved live runtime updates, added robust numeric runtime second states for safer persistence and recovery, and converted runtime timers to adapter-managed timers for better ioBroker compatibility.",
         "de": "Laufzeit-Handling und Persistenz verbessert. Saisonlaufzeit nutzt jetzt den korrekten Saison-Status, Live-Laufzeiten wurden vereinheitlicht, robuste Sekunden-States fuer Laufzeiten zur sicheren Wiederherstellung hinzugefuegt und Runtime-Timer auf adapterverwaltete Timer fuer bessere ioBroker-Kompatibilitaet umgestellt.",
@@ -54,19 +67,6 @@
         "pl": "Nowość: Dodano moduł oceny pH (chemistry.ph) z ręcznym i zewnętrznym wprowadzaniem danych, walidacją, obsługą miejsca pomiaru i zaleceniami. Nowość: Dodano moduł oceny TDS (chemistry.tds) z analizą trendów (24h, 7d, 30d), śledzeniem referencji i wynikami podsumowującymi (tekst/JSON/HTML). Poprawka: rozwiązano problem z przełączaniem mowy słonecznej między trybem standardowym i rozszerzonym. solarExtendedHelper nie zastępuje już mowy.solar_active w trybie standardowym.",
         "uk": "Нове: додано модуль оцінки pH (chemistry.ph) із ручним і зовнішнім введенням, перевіркою, обробкою місця вимірювання та рекомендаціями. Нове: додано модуль оцінки TDS (chemistry.tds) з ​​аналізом тенденцій (24 години, 7 днів, 30 днів), відстеженням посилань і підсумковими виходами (текст/JSON/HTML). Виправлення: вирішено проблему перемикання сонячної мови між стандартним і розширеним режимами. solarExtendedHelper більше не перезаписує speak.solar_active у стандартному режимі.",
         "zh-cn": "新增内容：添加了 pH 评估模块 (chemistry.ph)，具有手动和外部输入、验证、测量位置处理和建议。新增内容：添加了 TDS 评估模块 (chemistry.tds)，具有趋势分析（24 小时、7 天、30 天）、参考跟踪和摘要输出（文本/JSON/HTML）。修复：解决了标准模式和扩展模式之间的太阳能语音切换问题。在标准模式下，solarExtendedHelper 不再覆盖pepe.solar_active。"
-      },
-      "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循环逻辑。"
       }
     },
     "titleLang": {

package/lib/helpers/speechTextHelper.js

@@ -77,6 +77,14 @@ const speechTextHelper = {
             if (id.endsWith('solar.collector_warning')) {
                 const val = !!state.val;
 
+                const warnSpeech = !!(await this.adapter.getStateAsync('solar.warn_speech'))?.val;
+                if (!warnSpeech) {
+                    this.adapter.log.debug(
+                        '[speechTextHelper] Solar warning speech skipped (solar.warn_speech=false).',
+                    );
+                    return;
+                }
+
                 if (val) {
                     // Neue Warnung aktiv
                     const collectorTemp = Number(
@@ -100,6 +108,8 @@ const speechTextHelper = {
             // --- NEU: Reaktion auf Solarsteuerung ---
             if (id.endsWith('speech.solar_active')) {
                 const val = !!state.val;
+                const canSpeak = await this._canSendFromSource('solar');
+
                 // Pumpenstatus aktualisieren, damit auch im VIS korrekt sichtbar
                 if (val) {
                     await this.adapter.setStateAsync('pump.status', {
@@ -114,12 +124,20 @@ const speechTextHelper = {
                 }
                 if (val) {
                     const text = 'Die Poolpumpe wurde durch die Solarsteuerung eingeschaltet.';
-                    await this._sendSpeech(text);
-                    this.adapter.log.debug('[speechTextHelper] Solar control activated → announcement sent.');
+                    const sent = await this._sendSpeechFromSource('solar', text, canSpeak);
+                    this.adapter.log.debug(
+                        sent
+                            ? '[speechTextHelper] Solar control activated → announcement sent.'
+                            : '[speechTextHelper] Solar control activated → announcement skipped.',
+                    );
                 } else {
                     const text = 'Solarsteuerung beendet – Poolpumpe ausgeschaltet.';
-                    await this._sendSpeech(text);
-                    this.adapter.log.debug('[speechTextHelper] Solar control deactivated → announcement sent.');
+                    const sent = await this._sendSpeechFromSource('solar', text, canSpeak);
+                    this.adapter.log.debug(
+                        sent
+                            ? '[speechTextHelper] Solar control deactivated → announcement sent.'
+                            : '[speechTextHelper] Solar control deactivated → announcement skipped.',
+                    );
                 }
                 return;
             }
@@ -127,6 +145,7 @@ const speechTextHelper = {
             // --- NEU: Reaktion auf Zeitsteuerung ---
             if (id.endsWith('speech.time_active')) {
                 const val = !!state.val;
+                const canSpeak = await this._canSendFromSource('time');
 
                 // Pumpenstatus mitpflegen
                 if (val) {
@@ -135,16 +154,24 @@ const speechTextHelper = {
                         ack: true,
                     });
                     const text = 'Die Poolpumpe wurde durch die Zeitsteuerung eingeschaltet.';
-                    await this._sendSpeech(text);
-                    this.adapter.log.debug('[speechTextHelper] Time control activated → announcement sent.');
+                    const sent = await this._sendSpeechFromSource('time', text, canSpeak);
+                    this.adapter.log.debug(
+                        sent
+                            ? '[speechTextHelper] Time control activated → announcement sent.'
+                            : '[speechTextHelper] Time control activated → announcement skipped.',
+                    );
                 } else {
                     await this.adapter.setStateAsync('pump.status', {
                         val: 'AUS (Zeitsteuerung beendet)',
                         ack: true,
                     });
                     const text = 'Zeitsteuerung beendet – Poolpumpe ausgeschaltet.';
-                    await this._sendSpeech(text);
-                    this.adapter.log.debug('[speechTextHelper] Time control deactivated → announcement sent.');
+                    const sent = await this._sendSpeechFromSource('time', text, canSpeak);
+                    this.adapter.log.debug(
+                        sent
+                            ? '[speechTextHelper] Time control deactivated → announcement sent.'
+                            : '[speechTextHelper] Time control deactivated → announcement skipped.',
+                    );
                 }
                 return;
             }
@@ -155,6 +182,54 @@ const speechTextHelper = {
         }
     },
 
+    async _canSendFromSource(source) {
+        const enabled = !!(await this.adapter.getStateAsync(`speech.sources.${source}.enabled`))?.val;
+        if (!enabled) {
+            this.adapter.log.debug(`[speechTextHelper] Speech source "${source}" is disabled.`);
+            return false;
+        }
+
+        const cooldownMinutes = Number(
+            (await this.adapter.getStateAsync(`speech.sources.${source}.cooldown_minutes`))?.val || 0,
+        );
+        if (cooldownMinutes <= 0) {
+            return true;
+        }
+
+        const lastSentRaw = (await this.adapter.getStateAsync(`speech.sources.${source}.last_sent`))?.val;
+        const lastSentTs = Date.parse(String(lastSentRaw || ''));
+
+        if (!Number.isFinite(lastSentTs)) {
+            return true;
+        }
+
+        const elapsedMs = Date.now() - lastSentTs;
+        const cooldownMs = cooldownMinutes * 60 * 1000;
+
+        if (elapsedMs < cooldownMs) {
+            this.adapter.log.debug(
+                `[speechTextHelper] Speech source "${source}" skipped by cooldown (${cooldownMinutes} min).`,
+            );
+            return false;
+        }
+
+        return true;
+    },
+
+    async _sendSpeechFromSource(source, text, canSpeak) {
+        if (!canSpeak) {
+            return false;
+        }
+
+        await this._sendSpeech(text);
+        await this.adapter.setStateAsync(`speech.sources.${source}.last_sent`, {
+            val: new Date().toISOString(),
+            ack: true,
+        });
+
+        return true;
+    },
+
     /**
      * Sendet Text an speech.queue.
      *

package/lib/stateDefinitions/speechStates.js

@@ -285,6 +285,157 @@ async function createSpeechStates(adapter) {
 
     adapter.log.debug('[speechStates] Amazon Alexa quiet-time states checked and created.');
 
+    // ------------------------------------------------------------------
+    // FIX: Speech sources - user configurable message sources
+    // ------------------------------------------------------------------
+
+    await adapter.setObjectNotExistsAsync('speech.sources', {
+        type: 'channel',
+        common: {
+            name: {
+                en: 'Speech sources',
+                de: 'Sprachquellen',
+            },
+        },
+        native: {},
+    });
+
+    const speechSources = [
+        {
+            id: 'solar',
+            name: {
+                en: 'Solar control messages',
+                de: 'Solarsteuerung-Meldungen',
+            },
+            enabledName: {
+                en: 'Enable solar control messages',
+                de: 'Solarsteuerung-Meldungen aktivieren',
+            },
+            enabledDesc: {
+                en: 'Allows speech messages when the solar control switches the pump on or off',
+                de: 'Erlaubt Sprachmeldungen, wenn die Solarsteuerung die Pumpe ein- oder ausschaltet',
+            },
+            cooldownName: {
+                en: 'Solar message cooldown',
+                de: 'Solar-Meldungssperre',
+            },
+            cooldownDesc: {
+                en: 'Minimum time in minutes between solar control speech messages',
+                de: 'Mindestzeit in Minuten zwischen Solarsteuerung-Sprachmeldungen',
+            },
+            cooldownDefault: 30,
+        },
+        {
+            id: 'time',
+            name: {
+                en: 'Time control messages',
+                de: 'Zeitsteuerung-Meldungen',
+            },
+            enabledName: {
+                en: 'Enable time control messages',
+                de: 'Zeitsteuerung-Meldungen aktivieren',
+            },
+            enabledDesc: {
+                en: 'Allows speech messages when the time control switches the pump on or off',
+                de: 'Erlaubt Sprachmeldungen, wenn die Zeitsteuerung die Pumpe ein- oder ausschaltet',
+            },
+            cooldownName: {
+                en: 'Time control message cooldown',
+                de: 'Zeitsteuerung-Meldungssperre',
+            },
+            cooldownDesc: {
+                en: 'Minimum time in minutes between time control speech messages',
+                de: 'Mindestzeit in Minuten zwischen Zeitsteuerung-Sprachmeldungen',
+            },
+            cooldownDefault: 0,
+        },
+    ];
+
+    for (const source of speechSources) {
+        const baseId = `speech.sources.${source.id}`;
+
+        await adapter.setObjectNotExistsAsync(baseId, {
+            type: 'channel',
+            common: {
+                name: source.name,
+            },
+            native: {},
+        });
+
+        await adapter.setObjectNotExistsAsync(`${baseId}.enabled`, {
+            type: 'state',
+            common: {
+                name: source.enabledName,
+                desc: source.enabledDesc,
+                type: 'boolean',
+                role: 'switch',
+                read: true,
+                write: true,
+                def: true,
+                persist: true,
+            },
+            native: {},
+        });
+
+        const enabledState = await adapter.getStateAsync(`${baseId}.enabled`);
+        if (!enabledState || enabledState.val === null || enabledState.val === undefined) {
+            await adapter.setStateAsync(`${baseId}.enabled`, { val: true, ack: true });
+        }
+
+        await adapter.setObjectNotExistsAsync(`${baseId}.cooldown_minutes`, {
+            type: 'state',
+            common: {
+                name: source.cooldownName,
+                desc: source.cooldownDesc,
+                type: 'number',
+                role: 'level',
+                unit: 'min',
+                read: true,
+                write: true,
+                min: 0,
+                def: source.cooldownDefault,
+                persist: true,
+            },
+            native: {},
+        });
+
+        const cooldownState = await adapter.getStateAsync(`${baseId}.cooldown_minutes`);
+        if (!cooldownState || cooldownState.val === null || cooldownState.val === undefined) {
+            await adapter.setStateAsync(`${baseId}.cooldown_minutes`, {
+                val: source.cooldownDefault,
+                ack: true,
+            });
+        }
+
+        await adapter.setObjectNotExistsAsync(`${baseId}.last_sent`, {
+            type: 'state',
+            common: {
+                name: {
+                    en: 'Last message sent',
+                    de: 'Letzte gesendete Meldung',
+                },
+                desc: {
+                    en: 'Timestamp of the last speech message for this source',
+                    de: 'Zeitstempel der letzten Sprachmeldung dieser Quelle',
+                },
+                type: 'string',
+                role: 'value.time',
+                read: true,
+                write: false,
+                def: '',
+                persist: true,
+            },
+            native: {},
+        });
+
+        const lastSentState = await adapter.getStateAsync(`${baseId}.last_sent`);
+        if (!lastSentState || lastSentState.val === null || lastSentState.val === undefined) {
+            await adapter.setStateAsync(`${baseId}.last_sent`, { val: '', ack: true });
+        }
+    }
+
+    adapter.log.debug('[speechStates] Speech source states checked and created');
+
     // versteckte Dateien
 
     await adapter.setObjectNotExistsAsync('speech.solar_active', {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "iobroker.poolcontrol",
-  "version": "1.3.14",
+  "version": "1.3.15",
   "description": "Steuerung & Automatisierung für den Pool (Pumpe, Heizung, Ventile, Sensoren).",
   "author": "DasBo1975 <dasbo1975@outlook.de>",
   "homepage": "https://github.com/DasBo1975/ioBroker.poolcontrol",