iobroker.poolcontrol 1.3.1 → 1.3.2

package/README.md

@@ -188,6 +188,15 @@ New features are added regularly – please refer to the changelog.
 ---
 
 ## Changelog
+### 1.3.2 (2026-04-17)
+
+- Fix: Solar Extended no longer interferes with controlHelper or timeHelper (prevents unwanted pump shutdown)
+- Fix: Solar Extended no longer interferes with standard solar mode
+- Fix: Improved handling of external actuator (clean ON/OFF behavior depending on Solar Extended state)
+- Improvement: Added stable delta hysteresis (delta_on / delta_off) to prevent switching fluctuations
+- Improvement: Replaced global timers with adapter timers in solarExtendedHelper
+- Cleanup: Removed duplicate reading of request_active state
+
 ### 1.3.1 (2026-04-17)
 
 - Fix: Solar Extended now correctly controls the pump
@@ -216,10 +225,6 @@ New features are added regularly – please refer to the changelog.
 - Afterrun now starts only once and runs reliably to completion
 - Proper cleanup when surplus becomes active again during afterrun
 
-### 1.2.20
-Release: 11.04.2026
-- (DasBo) Reduced unnecessary state writes in status and photovoltaic helpers. Summary and PV timestamps are now only updated when the functional result actually changes, making the adapter quieter without affecting existing logic.
-
 ## 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.1",
+    "version": "1.3.2",
     "news": {
+      "1.3.2": {
+        "en": "Fixed Solar Extended conflicts with controlHelper/timeHelper and standard solar mode, improved external actuator handling, added stable delta hysteresis, and aligned timer handling with adapter timers.",
+        "de": "Solar-Extended-Konflikte mit controlHelper/timeHelper und dem Standard-Solarmodus behoben, externe Aktorsteuerung verbessert, stabile Delta-Hysterese ergänzt und Timer auf Adapter-Timer umgestellt.",
+        "ru": "Исправлены конфликты Solar Extended с controlHelper/timeHelper и стандартным солнечным режимом, улучшено управление внешним приводом, добавлен стабильный дельта-гистерезис и согласована обработка таймера с таймерами адаптера.",
+        "pt": "Corrigidos conflitos Solar Extended com controlHelper/timeHelper e modo solar padrão, manuseio aprimorado do atuador externo, histerese delta estável adicionada e manuseio de temporizador alinhado com temporizadores adaptadores.",
+        "nl": "Vaste Solar Extended-conflicten met controlHelper/timeHelper en standaard zonnemodus, verbeterde afhandeling van externe actuatoren, toegevoegde stabiele delta-hysteresis en afgestemde timerafhandeling met adaptertimers.",
+        "fr": "Correction des conflits solaires étendus avec controlHelper/timeHelper et le mode solaire standard, gestion améliorée des actionneurs externes, ajout d'une hystérésis delta stable et gestion des minuteries alignées avec les minuteries de l'adaptateur.",
+        "it": "Risolti i conflitti Solar Extended con controlHelper/timeHelper e la modalità solare standard, migliore gestione dell'attuatore esterno, aggiunta isteresi delta stabile e gestione del timer allineata con i timer dell'adattatore.",
+        "es": "Se corrigieron los conflictos de Solar Extended con controlHelper/timeHelper y el modo solar estándar, manejo mejorado del actuador externo, histéresis delta estable agregada y manejo del temporizador alineado con temporizadores adaptadores.",
+        "pl": "Naprawiono konflikty Solar Extended z ControlHelper/timeHelper i standardowym trybem solarnym, ulepszono obsługę zewnętrznego siłownika, dodano stabilną histerezę delta i dostosowano obsługę timera z timerami adaptera.",
+        "uk": "Виправлено конфлікти Solar Extended з controlHelper/timeHelper і стандартним сонячним режимом, покращено обробку зовнішнього приводу, додано стабільний дельта-гістерезис і узгоджено обробку таймера з таймерами адаптера.",
+        "zh-cn": "修复了 Solar Extended 与 controlHelper/timeHelper 和标准太阳能模式的冲突，改进了外部执行器处理，添加了稳定的增量迟滞，以及与适配器计时器对齐的计时器处理。"
+      },
       "1.3.1": {
         "en": "Fix: Solar Extended now correctly controls the pump and integrates with existing solar status handling. The helper now uses speech.solar_active like the standard solar logic, ensuring consistent pump status display and behavior. Minor fixes and optimizations.",
         "de": "Fix: Solar Extended steuert jetzt korrekt die Pumpe und ist sauber in die bestehende Solar-Statuslogik integriert. Der Helper nutzt nun wie die Standard-Solarsteuerung den State speech.solar_active, wodurch Anzeige und Verhalten der Pumpe konsistent sind. Kleine Fehlerbehebungen und Optimierungen.",
@@ -54,19 +67,6 @@
         "pl": "Poprawka błędu: Naprawiono problem w pomocniku fotowoltaicznym polegający na niezamierzonym ponownym uruchomieniu licznika czasu dobiegu przy każdym ponownym obliczeniu bez nadwyżki PV. Może to znacznie opóźnić wyłączenie pompy. Dobieg rozpoczyna się teraz tylko raz, gdy kończy się nadwyżka i przebiega niezawodnie do końca. Zapewnia również właściwe czyszczenie, gdy nadwyżka stanie się ponownie aktywna podczas dobiegu.",
         "uk": "Виправлення помилки: виправлено проблему у фотоелектричному помічнику, через яку таймер післязапуску ненавмисно перезапускався під час кожного перерахунку без надлишку PV. Це може значно затримати зупинку насоса. Післязапуск тепер починається лише один раз, коли закінчується надлишок і працює надійно до кінця. Також забезпечує належне очищення, коли надлишки знову стають активними під час повторного циклу.",
         "zh-cn": "错误修复：修复了光伏助手中的一个问题，即每次重新计算时没有光伏剩余时，后运行计时器会无意中重新启动。这可能会显着延迟泵的关闭。现在，后运行仅在盈余结束时启动一次，并可靠地运行直至完成。还确保在后运行期间剩余物再次活跃时进行适当的清理。"
-      },
-      "1.2.20": {
-        "en": "Bugfix release. Reduced unnecessary state writes in the status and photovoltaic helpers. Summary timestamps and PV update timestamps are now only written when the related functional result actually changes. This makes the adapter noticeably quieter and avoids needless state updates without changing the existing control logic.",
-        "de": "Bugfix-Release. Reduziert unnötige State-Schreibvorgänge im Status- und Photovoltaik-Helper. Summary-Zeitstempel und PV-Aktualisierungszeitstempel werden jetzt nur noch dann geschrieben, wenn sich das zugehörige fachliche Ergebnis tatsächlich ändert. Dadurch arbeitet der Adapter spürbar ruhiger und vermeidet unnötige State-Updates, ohne die bestehende Steuerlogik zu verändern.",
-        "ru": "Выпуск с исправлением ошибок. Уменьшено количество ненужных записей в статусе и фотоэлектрических помощниках. Сводные временные метки и временные метки обновления PV теперь записываются только тогда, когда соответствующий функциональный результат действительно изменяется. Это делает адаптер заметно тише и позволяет избежать ненужных обновлений состояния без изменения существующей логики управления.",
-        "pt": "Lançamento de correção de bug. Gravações de estado desnecessárias reduzidas nos ajudantes de status e fotovoltaicos. Os carimbos de data e hora de resumo e os carimbos de data e hora de atualização do PV agora são gravados apenas quando o resultado funcional relacionado realmente muda. Isto torna o adaptador visivelmente mais silencioso e evita atualizações de estado desnecessárias sem alterar a lógica de controle existente.",
-        "nl": "Bugfix-release. Verminderde onnodige statusschrijven in de status en fotovoltaïsche helpers. Samenvattende tijdstempels en tijdstempels voor PV-updates worden nu alleen geschreven als het gerelateerde functionele resultaat daadwerkelijk verandert. Dit maakt de adapter merkbaar stiller en vermijdt onnodige statusupdates zonder de bestaande besturingslogica te veranderen.",
-        "fr": "Version de correction de bugs. Réduction des écritures d'état inutiles dans les aides d'état et photovoltaïques. Les horodatages récapitulatifs et les horodatages de mise à jour PV ne sont désormais écrits que lorsque le résultat fonctionnel associé change réellement. Cela rend l'adaptateur sensiblement plus silencieux et évite les mises à jour d'état inutiles sans modifier la logique de contrôle existante.",
-        "it": "Rilascio di correzione bug. Ridotte le scritture di stato non necessarie nello stato e gli aiutanti fotovoltaici. I timestamp di riepilogo e quelli di aggiornamento PV ora vengono scritti solo quando il relativo risultato funzionale cambia effettivamente. Ciò rende l'adattatore notevolmente più silenzioso ed evita aggiornamenti di stato inutili senza modificare la logica di controllo esistente.",
-        "es": "Lanzamiento de corrección de errores. Reducción de escrituras de estado innecesarias en el estado y ayudantes fotovoltaicos. Las marcas de tiempo de resumen y las marcas de tiempo de actualización de PV ahora solo se escriben cuando el resultado funcional relacionado realmente cambia. Esto hace que el adaptador sea notablemente más silencioso y evita actualizaciones de estado innecesarias sin cambiar la lógica de control existente.",
-        "pl": "Wydanie poprawek błędów. Redukcja zbędnych zapisów stanu w statusie i pomocnikach fotowoltaicznych. Sumaryczne znaczniki czasu i znaczniki czasu aktualizacji PV są teraz zapisywane tylko wtedy, gdy faktycznie zmienia się powiązany wynik funkcjonalny. Dzięki temu adapter jest zauważalnie cichszy i pozwala uniknąć niepotrzebnych aktualizacji stanu bez zmiany istniejącej logiki sterowania.",
-        "uk": "Реліз виправлення помилок. Зменшено непотрібні записи стану в статусі та фотоелектричні помічники. Підсумкові мітки часу та мітки часу оновлення PV тепер записуються лише тоді, коли відповідний функціональний результат фактично змінюється. Це робить адаптер помітно тихішим і дозволяє уникнути непотрібних оновлень стану без зміни існуючої логіки керування.",
-        "zh-cn": "错误修复版本。减少状态和光伏助手中不必要的状态写入。摘要时间戳和 PV 更新时间戳现在仅在相关功能结果实际更改时写入。这使得适配器明显更安静，并且在不改变现有控制逻辑的情况下避免了不必要的状态更新。"
       }
     },
     "titleLang": {

package/lib/helpers/solarExtendedHelper.js

@@ -26,12 +26,13 @@ const solarExtendedHelper = {
 
     _scheduleCheck() {
         if (this.checkTimer) {
-            clearInterval(this.checkTimer);
+            this.adapter.clearInterval(this.checkTimer);
         }
 
-        this.checkTimer = setInterval(() => this._checkSolarExtended(), 60 * 1000);
+        this.checkTimer = this.adapter.setInterval(() => this._checkSolarExtended(), 60 * 1000);
+
         // Beim Start sofort prüfen
-        this._checkSolarExtended();
+        void this._checkSolarExtended();
     },
 
     async _checkSolarExtended() {
@@ -52,7 +53,7 @@ const solarExtendedHelper = {
             const controlInverted = (await this.adapter.getStateAsync('solar.extended.control_inverted'))?.val === true;
 
             const oldEnabledByMaster = (await this.adapter.getStateAsync('solar.extended.enabled_by_master'))?.val;
-            const oldRequestActive = (await this.adapter.getStateAsync('solar.extended.request_active'))?.val;
+            const oldRequestActive = (await this.adapter.getStateAsync('solar.extended.request_active'))?.val === true;
             const oldActive = (await this.adapter.getStateAsync('solar.extended.active'))?.val;
             const oldBlocked = (await this.adapter.getStateAsync('solar.extended.blocked'))?.val;
             const oldBlockedBy = (await this.adapter.getStateAsync('solar.extended.blocked_by'))?.val;
@@ -148,11 +149,12 @@ const solarExtendedHelper = {
                     this.adapter.log.debug('[solarExtendedHelper] No valid temperatures available');
                 } else {
                     const delta = collector - pool;
+
+                    requestActive = oldRequestActive;
+
                     if (delta >= deltaOn && pool < maxTemperature) {
                         requestActive = true;
-                    }
-
-                    if (delta <= deltaOff || pool >= maxTemperature) {
+                    } else if (delta <= deltaOff || pool >= maxTemperature) {
                         requestActive = false;
                     }
 
@@ -178,10 +180,21 @@ const solarExtendedHelper = {
                 actorWriteValue = !actorWriteValue;
             }
 
+            // FIX:
+            // Definiert den AUS-Zustand des externen Aktors abhängig von der Invertierung.
+            const actorOffValue = controlInverted ? true : false;
+
             if (actorConfigOk) {
                 try {
-                    await this.adapter.setForeignStateAsync(controlObjectId, actorWriteValue, false);
-                    actorState = actorWriteValue;
+                    // FIX:
+                    // Der externe Aktor darf nur dann aktiv sein,
+                    // wenn Solar Extended tatsächlich selbst aktiv ist.
+                    // Bei Blockierung durch controlHelper/timeHelper
+                    // oder ohne eigene Anforderung wird der Aktor deaktiviert.
+                    const effectiveActorValue = !blocked ? actorWriteValue : actorOffValue;
+
+                    await this.adapter.setForeignStateAsync(controlObjectId, effectiveActorValue, false);
+                    actorState = effectiveActorValue;
 
                     if (!blocked) {
                         active = requestActive;
@@ -190,6 +203,8 @@ const solarExtendedHelper = {
                                 ? I18n.translate('extended active')
                                 : I18n.translate('extended inactive');
                         }
+                    } else {
+                        active = false;
                     }
                 } catch (err) {
                     blocked = true;
@@ -215,10 +230,16 @@ const solarExtendedHelper = {
                 });
             }
 
-            await this.adapter.setStateChangedAsync('pump.pump_switch', {
-                val: speechSolarActive,
-                ack: false,
-            });
+            // FIX:
+            // Den zentralen Pumpenschalter nur dann schreiben,
+            // wenn Solar Extended überhaupt der zuständige Solarmodus ist
+            // und keine höhere Fremdpriorität aktiv ist.
+            if (isExtendedMode && !isControlPriority && !isTimePriority) {
+                await this.adapter.setStateChangedAsync('pump.pump_switch', {
+                    val: speechSolarActive,
+                    ack: false,
+                });
+            }
 
             await this.adapter.setStateChangedAsync('solar.extended.enabled_by_master', {
                 val: enabledByMaster,
@@ -290,7 +311,7 @@ const solarExtendedHelper = {
 
     cleanup() {
         if (this.checkTimer) {
-            clearInterval(this.checkTimer);
+            this.adapter.clearInterval(this.checkTimer);
             this.checkTimer = null;
         }
     },

package/lib/helpers/solarHelper.js

@@ -23,11 +23,11 @@ const solarHelper = {
 
     _scheduleCheck() {
         if (this.checkTimer) {
-            clearInterval(this.checkTimer);
+            this.adapter.clearInterval(this.checkTimer);
         }
-        this.checkTimer = setInterval(() => this._checkSolar(), 60 * 1000);
+        this.checkTimer = this.adapter.setInterval(() => this._checkSolar(), 60 * 1000);
         // Beim Start sofort prüfen
-        this._checkSolar();
+        void this._checkSolar();
     },
 
     async _checkSolar() {
@@ -211,7 +211,7 @@ const solarHelper = {
 
     cleanup() {
         if (this.checkTimer) {
-            clearInterval(this.checkTimer);
+            this.adapter.clearInterval(this.checkTimer);
             this.checkTimer = null;
         }
     },

package/lib/helpers/timeHelper.js

@@ -23,11 +23,11 @@ const timeHelper = {
 
     _scheduleCheck() {
         if (this.checkTimer) {
-            clearInterval(this.checkTimer);
+            this.adapter.clearInterval(this.checkTimer);
         }
-        this.checkTimer = setInterval(() => this._checkWindows(), 60 * 1000);
+        this.checkTimer = this.adapter.setInterval(() => this._checkWindows(), 60 * 1000);
         // Beim Start sofort prüfen
-        this._checkWindows();
+        void this._checkWindows();
     },
 
     async _checkWindows() {
@@ -109,7 +109,7 @@ const timeHelper = {
 
     cleanup() {
         if (this.checkTimer) {
-            clearInterval(this.checkTimer);
+            this.adapter.clearInterval(this.checkTimer);
             this.checkTimer = null;
         }
     },

package/package.json

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