iobroker.poolcontrol 1.2.18 → 1.2.19

package/README.md

@@ -189,6 +189,14 @@ New features are added regularly – please refer to the changelog.
 
 ## Changelog
 
+## 1.2.19 (2026-04-10)
+
+- Fixed an interaction issue between `photovoltaicHelper` and `controlHelper` where automatic follow-up pumping could be stopped unexpectedly
+- photovoltaicHelper now respects controlHelper priority and no longer stops the pump while automatic follow-up pumping is active
+- Fixed an issue where `controlHelper` could remain in "nachpumpen" state if the pump was stopped externally
+- `photovoltaic.threshold_w` is now correctly synchronized with the instance configuration
+- Changes to the PV surplus threshold in adapter settings are now reliably reflected in the corresponding read-only datapoint
+
 ### 1.2.18
 Release: 07.04.2026
 - Fixed persistence issue for `status.season_active` (no longer overwritten on adapter start)

package/io-package.json

@@ -1,8 +1,21 @@
 {
   "common": {
     "name": "poolcontrol",
-    "version": "1.2.18",
+    "version": "1.2.19",
     "news": {
+      "1.2.19": {
+        "en": "Bugfix release. Fixes an interaction issue between photovoltaicHelper and controlHelper where automatic follow-up pumping could be interrupted unexpectedly. The photovoltaic stop logic now respects controlHelper priority and no longer stops the pump while automatic follow-up pumping is active. In addition, the read-only state photovoltaic.threshold_w is now synchronized correctly with the instance configuration so that changes in the adapter settings are reflected reliably in the visible datapoint.",
+        "de": "Bugfix-Release. Behebt ein Zusammenspielproblem zwischen photovoltaicHelper und controlHelper, durch das automatisches Nachpumpen unerwartet unterbrochen werden konnte. Die Abschaltlogik des PV-Helfers respektiert nun den Vorrang des controlHelper und stoppt die Pumpe nicht mehr, solange automatisches Nachpumpen aktiv ist. Zusätzlich wird der schreibgeschützte Datenpunkt photovoltaic.threshold_w jetzt korrekt mit der Instanzkonfiguration synchronisiert, sodass Änderungen in den Adaptereinstellungen zuverlässig im sichtbaren Datenpunkt übernommen werden.",
+        "ru": "Выпуск с исправлением ошибок. Устранена проблема взаимодействия между фотоэлектрическим помощником и controlHelper, из-за которой автоматическая последующая откачка могла неожиданно прерваться. Логика фотоэлектрической остановки теперь учитывает приоритет controlHelper и больше не останавливает насос, пока активна автоматическая последующая откачка. Кроме того, состояние только для чтения photovoltaic.threshold_w теперь правильно синхронизируется с конфигурацией экземпляра, так что изменения в настройках адаптера надежно отражаются в видимой точке данных.",
+        "pt": "Lançamento de correção de bug. Corrige um problema de interação entre photovoltaicHelper e controlHelper onde o bombeamento de acompanhamento automático poderia ser interrompido inesperadamente. A lógica de paragem fotovoltaica respeita agora a prioridade controlHelper e já não para a bomba enquanto o bombeamento de acompanhamento automático estiver ativo. Além disso, o estado somente leitura photovoltaic.threshold_w agora está sincronizado corretamente com a configuração da instância para que as alterações nas configurações do adaptador sejam refletidas de forma confiável no ponto de dados visível.",
+        "nl": "Bugfix-release. Er is een interactieprobleem opgelost tussen photovoltaicHelper en controlHelper waarbij automatisch napompen onverwacht kon worden onderbroken. De fotovoltaïsche stoplogica respecteert nu de prioriteit van controlHelper en stopt de pomp niet langer terwijl automatisch napompen actief is. Bovendien wordt de alleen-lezen status photovoltaic.threshold_w nu correct gesynchroniseerd met de instanceconfiguratie, zodat wijzigingen in de adapterinstellingen betrouwbaar worden weerspiegeld in het zichtbare datapunt.",
+        "fr": "Version de correction de bugs. Corrige un problème d'interaction entre photovoltaicHelper et controlHelper où le pompage de suivi automatique pouvait être interrompu de manière inattendue. La logique d'arrêt photovoltaïque respecte désormais la priorité controlHelper et n'arrête plus la pompe lorsque le pompage de suivi automatique est actif. De plus, l'état en lecture seule photovoltaic.threshold_w est désormais correctement synchronisé avec la configuration de l'instance afin que les modifications apportées aux paramètres de l'adaptateur soient reflétées de manière fiable dans le point de données visible.",
+        "it": "Rilascio di correzione bug. Risolve un problema di interazione tra fotovoltaicoHelper e controlHelper in cui il pompaggio automatico di follow-up poteva essere interrotto inaspettatamente. La logica di arresto fotovoltaico ora rispetta la priorità di controlHelper e non arresta più la pompa mentre è attivo il pompaggio di follow-up automatico. Inoltre, lo stato di sola lettura fotovoltaico.threshold_w è ora sincronizzato correttamente con la configurazione dell'istanza in modo che le modifiche nelle impostazioni dell'adattatore si riflettano in modo affidabile nel punto dati visibile.",
+        "es": "Lanzamiento de corrección de errores. Soluciona un problema de interacción entre photovoltaicHelper y controlHelper donde el bombeo de seguimiento automático podría interrumpirse inesperadamente. La lógica de parada fotovoltaica ahora respeta la prioridad de controlHelper y ya no detiene la bomba mientras el bombeo de seguimiento automático está activo. Además, el estado de solo lectura photovoltaic.threshold_w ahora está sincronizado correctamente con la configuración de la instancia para que los cambios en la configuración del adaptador se reflejen de manera confiable en el punto de datos visible.",
+        "pl": "Wydanie poprawek błędów. Rozwiązuje problem interakcji pomiędzy photovoltaicHelper i controlHelper, powodujący nieoczekiwane przerwanie automatycznego pompowania uzupełniającego. Logika zatrzymania fotowoltaiki uwzględnia teraz priorytet ControlHelper i nie zatrzymuje już pompy, gdy aktywne jest automatyczne pompowanie uzupełniające. Ponadto stan tylko do odczytu photovoltaic.threshold_w jest teraz poprawnie zsynchronizowany z konfiguracją instancji, dzięki czemu zmiany w ustawieniach adaptera są niezawodnie odzwierciedlane w widocznym punkcie danych.",
+        "uk": "Реліз виправлення помилок. Вирішує проблему взаємодії між photovoltaicHelper і controlHelper, через яку автоматичне подальше відкачування може бути несподівано перервано. Логіка фотоелектричної зупинки тепер враховує пріоритет controlHelper і більше не зупиняє насос, поки активна автоматична подальша перекачування. Крім того, стан тільки для читання photovoltaic.threshold_w тепер правильно синхронізовано з конфігурацією екземпляра, щоб зміни в налаштуваннях адаптера надійно відображалися у видимій точці даних.",
+        "zh-cn": "错误修复版本。修复了 PVHelper 和 controlHelper 之间的交互问题，其中自动后续泵送可能会意外中断。光伏停止逻辑现在尊重 controlHelper 优先级，并且在自动后续泵送处于活动状态时不再停止泵。此外，只读状态 PV.threshold_w 现在已与实例配置正确同步，以便适配器设置中的更改能够可靠地反映在可见数据点中。"
+      },
       "1.2.18": {
         "en": "Fixed persistence issues for season and frost states. Season_active is now no longer overwritten on adapter start. Frost protection settings are now stored persistently.",
         "de": "Persistenzprobleme für Saison- und Frost-States behoben. season_active wird beim Adapterstart nicht mehr überschrieben. Frostschutz-Einstellungen werden nun dauerhaft gespeichert.",
@@ -29,19 +42,6 @@
         "uk": "Виправлення: вирішено проблему, через яку кнопка скидання навчання тиску не спрацьовувала надійно. PumpHelper4 тепер явно підписується на свої відповідні внутрішні стани (наприклад, значення скидання та конфігурації), забезпечуючи правильну обробку подій і негайне виконання логіки скидання.",
         "zh-cn": "修复：解决了压力学习重置按钮无法可靠触发的问题。 PumpHelper4 现在显式订阅其相关的内部状态（例如重置和配置值），确保正确的事件处理和立即执行重置逻辑。"
       },
-      "1.2.16": {
-        "en": "Fix: Resolved an issue where the pressure learning reset button did not trigger reliably. The pumpHelper4 now explicitly subscribes to its relevant internal states (e.g. reset and configuration values), ensuring proper event handling and immediate execution of the reset logic.",
-        "de": "Fix: Problem behoben, bei dem der Reset-Button für das Druck-Lernsystem nicht zuverlässig ausgelöst wurde. Der pumpHelper4 abonniert nun explizit die relevanten eigenen States (z. B. Reset und Konfigurationswerte), wodurch die Eventverarbeitung und die sofortige Ausführung der Reset-Logik sichergestellt sind.",
-        "ru": "Исправление: решена проблема, из-за которой кнопка сброса обучения давлению не срабатывала надежно. PumpHelper4 теперь явно подписывается на соответствующие внутренние состояния (например, значения сброса и конфигурации), обеспечивая правильную обработку событий и немедленное выполнение логики сброса.",
-        "pt": "Correção: Resolvido um problema em que o botão de redefinição do aprendizado de pressão não acionava de maneira confiável. O pumpHelper4 agora assina explicitamente seus estados internos relevantes (por exemplo, valores de redefinição e configuração), garantindo o tratamento adequado de eventos e a execução imediata da lógica de redefinição.",
-        "nl": "Oplossing: een probleem opgelost waarbij de resetknop voor het leren van de druk niet betrouwbaar werd geactiveerd. De pumpHelper4 onderschrijft nu expliciet de relevante interne statussen (bijvoorbeeld reset- en configuratiewaarden), waardoor een juiste afhandeling van gebeurtenissen en onmiddellijke uitvoering van de resetlogica wordt gegarandeerd.",
-        "fr": "Correction : Résolution d'un problème où le bouton de réinitialisation de l'apprentissage de la pression ne se déclenchait pas de manière fiable. Le PumpHelper4 s'abonne désormais explicitement à ses états internes pertinents (par exemple, les valeurs de réinitialisation et de configuration), garantissant une gestion appropriée des événements et l'exécution immédiate de la logique de réinitialisation.",
-        "it": "Correzione: risolto un problema per cui il pulsante di ripristino dell'apprendimento della pressione non si attivava in modo affidabile. Il pumpHelper4 ora sottoscrive esplicitamente i suoi stati interni rilevanti (ad esempio valori di ripristino e configurazione), garantendo la corretta gestione degli eventi e l'esecuzione immediata della logica di ripristino.",
-        "es": "Solución: se resolvió un problema por el cual el botón de reinicio del aprendizaje de presión no se activaba de manera confiable. El pumpHelper4 ahora se suscribe explícitamente a sus estados internos relevantes (por ejemplo, valores de reinicio y configuración), lo que garantiza un manejo adecuado de eventos y la ejecución inmediata de la lógica de reinicio.",
-        "pl": "Poprawka: rozwiązano problem polegający na tym, że przycisk resetowania uczenia się ciśnienia nie uruchamiał się niezawodnie. PumpHelper4 teraz jawnie subskrybuje swoje odpowiednie stany wewnętrzne (np. wartości resetowania i konfiguracji), zapewniając prawidłową obsługę zdarzeń i natychmiastowe wykonanie logiki resetowania.",
-        "uk": "Виправлення: вирішено проблему, через яку кнопка скидання навчання тиску не спрацьовувала надійно. PumpHelper4 тепер явно підписується на свої відповідні внутрішні стани (наприклад, значення скидання та конфігурації), забезпечуючи правильну обробку подій і негайне виконання логіки скидання.",
-        "zh-cn": "修复：解决了压力学习重置按钮无法可靠触发的问题。 PumpHelper4 现在显式订阅其相关的内部状态（例如重置和配置值），确保正确的事件处理和立即执行重置逻辑。"
-      },
       "1.2.15": {
         "en": "Fix i18n usage (replace I18n.t with I18n.translate) to resolve adapter startup crash and restart loop on certain systems.",
         "de": "i18n-Nutzung korrigiert (I18n.t durch I18n.translate ersetzt), um Absturz beim Adapterstart und Restart-Loop auf bestimmten Systemen zu beheben.",

package/lib/helpers/controlHelper.js

@@ -131,10 +131,17 @@ async function _runDailyCirculationCheck() {
     }
 }
 
+async function _isAutoPumpingStillRunning() {
+    const activeHelper = (await adapter.getStateAsync('pump.active_helper'))?.val || '';
+    const pumpSwitch = !!(await adapter.getStateAsync('pump.pump_switch'))?.val;
+
+    return activeHelper === 'controlHelper' && pumpSwitch === true;
+}
+
 /**
  * Startet automatisches Nachpumpen.
  *
- * @param {number} missingLiter - Fehlende Umwälzmenge in Litern
+ * @param {number} missingLiter Fehlende Umwälzmenge in Litern
  */
 async function _startAutoPumping(missingLiter) {
     try {
@@ -160,6 +167,22 @@ async function _startAutoPumping(missingLiter) {
             const total = Math.round((await adapter.getStateAsync('circulation.daily_total'))?.val || 0);
             const required = Math.round((await adapter.getStateAsync('circulation.daily_required'))?.val || 0);
 
+            const stillRunning = await _isAutoPumpingStillRunning();
+            if (!stillRunning) {
+                adapter.clearInterval(autoPumpingInterval);
+                autoPumpingInterval = null;
+
+                adapter.log.warn(
+                    '[controlHelper] automatic pumping aborted because pump control was lost or pump_switch is no longer true.',
+                );
+
+                await adapter.setStateAsync('pump.mode', { val: previousPumpMode, ack: true });
+                await adapter.setStateAsync('pump.active_helper', { val: '', ack: true });
+                await adapter.setStateAsync('pump.reason', { val: '', ack: true });
+                previousPumpMode = null;
+                return;
+            }
+
             if (total >= required) {
                 adapter.clearInterval(autoPumpingInterval);
                 autoPumpingInterval = null;

package/lib/helpers/photovoltaicHelper.js

@@ -44,6 +44,7 @@ const photovoltaicHelper = {
         this.adapter.subscribeStates('photovoltaic.ignore_on_circulation');
         this.adapter.subscribeStates('status.season_active');
         this.adapter.subscribeStates('pump.mode');
+        this.adapter.subscribeStates('pump.active_helper');
 
         this._safeRecalc('init');
         this.adapter.log.info('[photovoltaicHelper] Initialization completed.');
@@ -76,8 +77,8 @@ const photovoltaicHelper = {
                 return;
             }
 
-            if (id.endsWith('status.season_active') || id.endsWith('pump.mode')) {
-                await this._safeRecalc('mode/season');
+            if (id.endsWith('status.season_active') || id.endsWith('pump.mode') || id.endsWith('pump.active_helper')) {
+                await this._safeRecalc('mode/season/owner');
                 return;
             }
         } catch (err) {
@@ -211,6 +212,11 @@ const photovoltaicHelper = {
         return this._maybeStopPump(false, afterrunMin, 'pv_ended_afterrun');
     },
 
+    async _isControlHelperPriorityActive() {
+        const activeHelper = (await this.adapter.getStateAsync('pump.active_helper'))?.val || '';
+        return activeHelper === 'controlHelper';
+    },
+
     async _maybeStartPump(reason) {
         if (this._desiredPump === true) {
             return;
@@ -226,6 +232,19 @@ const photovoltaicHelper = {
     },
 
     async _maybeStopPump(immediate, afterrunMin, tag) {
+        if (await this._isControlHelperPriorityActive()) {
+            if (this.afterrunTimer) {
+                clearTimeout(this.afterrunTimer);
+                this.afterrunTimer = null;
+            }
+            this._pvPumpHoldUntil = 0;
+            this._desiredPump = false;
+            this.adapter.log.debug(
+                `[photovoltaicHelper] Stop '${tag}' suppressed because controlHelper currently has priority.`,
+            );
+            return;
+        }
+
         if (immediate || !afterrunMin || afterrunMin <= 0) {
             if (this._desiredPump === false) {
                 return;
@@ -242,6 +261,14 @@ const photovoltaicHelper = {
             clearTimeout(this.afterrunTimer);
         }
         this.afterrunTimer = setTimeout(async () => {
+            if (await this._isControlHelperPriorityActive()) {
+                this.adapter.log.debug(
+                    '[photovoltaicHelper] Afterrun stop suppressed because controlHelper currently has priority.',
+                );
+                this._desiredPump = false;
+                return;
+            }
+
             const active = !!(await this.adapter.getStateAsync('photovoltaic.surplus_active'))?.val;
             if (active) {
                 this.adapter.log.debug('[photovoltaicHelper] Afterrun canceled – surplus active again.');

package/lib/stateDefinitions/photovoltaicStates.js

@@ -146,7 +146,7 @@ async function createPhotovoltaicStates(adapter) {
             unit: 'W',
             read: true,
             write: false,
-            def: 200,
+            def: Number(adapter.config?.threshold_w ?? 200),
         },
         {
             id: 'status_text',
@@ -212,6 +212,11 @@ async function createPhotovoltaicStates(adapter) {
         }
     }
 
+    await adapter.setStateAsync('photovoltaic.threshold_w', {
+        val: Number(adapter.config?.threshold_w ?? 200),
+        ack: true,
+    });
+
     adapter.log.info('[createPhotovoltaicStates] Initialization completed.');
 }
 

package/package.json

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