iobroker.poolcontrol 0.2.1 → 0.3.0

package/README.md

@@ -1,14 +1,18 @@
 # ioBroker.poolcontrol
 
-![Test and Release](https://github.com/DasBo1975/iobroker.poolcontrol/actions/workflows/test-and-release.yml/badge.svg)
+![Test and Release](https://github.com/DasBo1975/ioBroker.poolcontrol/actions/workflows/test-and-release.yml/badge.svg)
 ![npm](https://img.shields.io/npm/v/iobroker.poolcontrol?color=blue)
 ![Downloads](https://img.shields.io/npm/dm/iobroker.poolcontrol)
 ![Installs](https://iobroker.live/badges/poolcontrol-installed.svg)
 ![Stable](https://iobroker.live/badges/poolcontrol-stable.svg)
 [![License](https://img.shields.io/github/license/DasBo1975/ioBroker.poolcontrol?cacheSeconds=3600)](https://github.com/DasBo1975/ioBroker.poolcontrol/blob/main/LICENSE)
 
+---
+
+## Beschreibung
+
 Der Adapter **ioBroker.poolcontrol** dient zur Steuerung und Überwachung von Poolanlagen.  
-Er ermöglicht die Automatisierung von Pumpen, Temperatur- und Solarsteuerung sowie Verbrauchsauswertung.  
+Er ermöglicht die Automatisierung von Pumpen-, Temperatur- und Solarsteuerung sowie die Verbrauchsauswertung.
 
 ---
 
@@ -28,7 +32,7 @@ Er ermöglicht die Automatisierung von Pumpen, Temperatur- und Solarsteuerung so
 - **Solarsteuerung**
   - Ein-/Ausschaltgrenzen mit Hysterese
   - Kollektor-Warnung (mit automatischer Rücksetzung bei 10 % unter der Schwelle)
-  - Optional Sprachausgabe bei Warnung
+  - Optionale Sprachausgabe bei Warnung
 
 - **Zeitsteuerung**
   - Bis zu 3 frei konfigurierbare Zeitfenster pro Woche
@@ -41,14 +45,15 @@ Er ermöglicht die Automatisierung von Pumpen, Temperatur- und Solarsteuerung so
   - Auswertung eines externen kWh-Zählers
   - Tages-, Wochen-, Monats- und Jahresverbrauch
   - Berechnung der Stromkosten anhand konfigurierbarem Preis  
-    **Hinweis:**  
-    Details zum Verhalten der Verbrauchs- und Kostenwerte (z. B. bei Neustarts oder beim Wechsel des Stromzählers) finden Sie in der Datei [help.md](./help.md).
+
+  **Hinweis:**  
+  Details zum Verhalten der Verbrauchs- und Kostenwerte (z. B. bei Neustarts oder beim Wechsel des Stromzählers) finden Sie in der Datei [help.md](./help.md).
 
 - **Sprachausgaben**
   - Ausgabe über Alexa oder Telegram
   - Ansagen bei Pumpenstart/-stopp, Fehlern oder Temperaturschwellen
 
-- **Systemcheck (Diagnosebereich)**
+- **SystemCheck (Diagnosebereich)**
   Ab Version **0.2.0** enthält der Adapter einen neuen Diagnosebereich **SystemCheck**.  
   Er bietet interne Debug-Logs, mit denen bestimmte Teilbereiche (z. B. Pumpen-, Solar- oder Temperatursteuerung) gezielt überwacht werden können.
 
@@ -66,7 +71,7 @@ Er ermöglicht die Automatisierung von Pumpen, Temperatur- und Solarsteuerung so
 
 1. Adapter über ioBroker Admin installieren.  
 2. Instanz anlegen.  
-3. Konfiguration im Admin-Tab vornehmen: Pumpenleistung, Sensoren, Solar, Sprachausgaben, etc.  
+3. Konfiguration im Admin-Tab vornehmen: Pumpenleistung, Sensoren, Solar, Sprachausgaben usw.
 
 ---
 
@@ -88,81 +93,70 @@ Die Konfiguration erfolgt über Tabs im Admin-Interface:
 - Rückspülerinnerung (Intervall in Tagen, Erinnerung über State)  
 - Wartung Kesseldruck (maximaler Druck, Warnung bei Überschreitung)  
 - Weitere Komfortfunktionen nach Praxistests  
+- Kesseldruck-Wartung / Drucksensor-Warnung
+- PV-Überschuss-Steuerung (für z.B. Pumpe oder Wärmepumpe)
+- Zweite Pumpe (z.B. Wärmetauscher)
+- Statistikbereich 
+- Eigene Widgets für VIS/VIS2
+- Erweiterung Wärmepumpen-/Heizlogik
+- Steuerung von Poolbeleuchtung
+- Steuerung von Poolrobotern
+- Steuerung von elektrischen Ventilen 
+- Steuerung von Gegenstromanlagen
 
 ---
 
 ## Hinweis
 
 Der Adapter befindet sich aktuell in der Entwicklung.  
-Funktionen können sich ändern, bitte regelmäßig den Changelog beachten.  
+Funktionen können sich ändern – bitte regelmäßig den Changelog beachten.
 
 ---
 
 ## Dokumentation
-- [Help.md (ausführliche Beschreibung und Hinweise)](./help.md)
+- [help.md (ausführliche Beschreibung und Hinweise)](./help.md)
 
 ---
 
 ## Changelog
-Auszug, vollständige Liste siehe `io-package.json`:
-
-### 0.2.0 (2025-10-06)
-- Neuer Diagnosebereich **SystemCheck** für interne Debug-Logs und Analysen.
-- Möglichkeit, einzelne Adapterbereiche (z. B. Pumpe, Solar, Temperatur) gezielt zu überwachen.
-- Fortlaufendes Textprotokoll mit manueller Löschfunktion.
-- Alle bisherigen Debug-Funktionen aus `zz_debuglogs` in `SystemCheck.debug_logs` integriert.
-- Vorbereitung für zukünftige Diagnose-Erweiterungen (Export, Systemprüfung, Plausibilitäts-Checks).
-
-
-### 0.1.2
-- Verbesserung: Beim Adapterstart werden nun die letzten bekannten Temperaturwerte aller aktiven Sensoren (z. B. Oberfläche, Kollektor, Außentemperatur usw.) automatisch übernommen.  
-- Dadurch werden auch Sensoren korrekt angezeigt, die ihren Messwert nur selten aktualisieren (z. B. Homematic oder stromsparende Funk-Sensoren).  
-- Keine Änderung am Verhalten der restlichen Logik, reine Komfort- und Stabilitätsverbesserung.
+### **WORK IN PROGRESS**
 
-### 0.1.1
-- Fehlerbehebung: Endlosschleife zwischen `pump_switch` und externer Steckdose (`deviceId`) behoben, die bei bestimmten Smart-Steckdosen (z. B. Shelly, Tasmota, FritzDECT) auftreten konnte.  
-- Verbesserte Stabilität im `pumpHelper` durch interne Rückkopplungsprüfung.  
-- Keine Änderungen an bestehenden Konfigurationen erforderlich.
+### 0.3.0 (12.10.2025)
+**Neu:** Intelligentes Pumpen-Monitoring & Lernsystem
 
-### 0.1.0
-- Sprachausgabe über **E-Mail** hinzugefügt (konfigurierbar: Instanz, Empfänger, Betreff).
-- Erweiterung der Instanz-Konfiguration im Tab „Sprachausgaben“.
-  **Bugfixes**
-- Kleinere Korrekturen und Optimierungen in der Dokumentation (`help.md`).
-- Logging in `speechHelper` verbessert.
+- Hinzugefügt: **Reelle Durchflussberechnung** auf Basis der tatsächlichen Leistungsaufnahme.  
+- Neuer Bereich **`pump.live`** zur Live-Überwachung von Leistung, Durchfluss und prozentualer Auslastung.  
+- Die **tägliche Umwälzberechnung** verwendet nun den realen Durchflusswert anstelle eines Fixwerts.  
+- Neuer Lernbereich **`pump.learning`**:
+  - Lernt automatisch die durchschnittlichen Leistungs- und Durchflusswerte.  
+  - Bestimmt daraus einen dynamischen **Normalbereich (± 15 %)**.  
+  - Berechnet prozentuale Abweichungen und erstellt **textbasierte Statusmeldungen**.  
+  - Alle Lernwerte werden **persistent** gespeichert und bleiben auch nach Neustart erhalten.  
+- Vollständig **ereignisgesteuerte Logik** ohne zusätzliche Timer oder Polling-Zyklen.  
 
-### 0.0.10
-
-Statusübersicht
-Ab Version 0.0.10 gibt es einen eigenen Bereich `status.*` mit folgenden Datenpunkten:
-
-- **status.summary** → Textübersicht (Pumpe, Modus, Temperaturen, Laufzeit, Umwälzung)
-- **status.overview_json** → Übersicht als JSON (maschinenlesbar)
-- **status.last_summary_update** → Zeitpunkt der letzten Aktualisierung
-- **status.pump_last_start** → Letzter Pumpenstart (Zeitstempel)
-- **status.pump_last_stop** → Letztes Pumpenende (Zeitstempel)
-- **status.pump_was_on_today** → Boolean, ob die Pumpe heute lief
-- **status.pump_today_count** → Anzahl der Starts heute (Reset um Mitternacht)
-- **status.system_ok** → Boolean, ob das System fehlerfrei läuft
-- **status.system_warning** → Boolean, wenn eine Warnung aktiv ist
-- **status.system_warning_text** → Beschreibung der aktiven Warnung
-- **status.season_active** → Anzeige, ob die Poolsaison aktiv ist
-
-Diese Datenpunkte sind besonders für **VIS/vis2, Alexa- oder Telegram-Ausgaben** gedacht, da sie eine schnelle Übersicht über den aktuellen Poolstatus bieten.
+> Mit dieser Version beginnt die lernfähige Phase des PoolControl-Adapters:  
+> Deine Pumpe weiß jetzt selbst, was für sie „normal“ ist.
 
+---
 
-### 0.0.9
-- Laufzeit-, Umwälz-, Verbrauch-/Kosten- und Temperatur-Min/Max-States sind jetzt persistent  
-  (Werte bleiben nach Adapter-Neustart oder Stromausfall erhalten)
+### 0.2.2 (2025-10-08)
+- Einführung einer **automatischen Rückspülerinnerung** (neuer Bereich im ControlHelper2)
+- Erinnerung mit Intervall in Tagen und automatischer Rücksetzung nach erfolgter Rückspülung
+- Log- und Sprachausgabe bei Fälligkeit oder Überfälligkeit
+- Erweiterung des Control-Bereichs um zusätzliche States (backwash_reminder_active, interval_days, last_date, required)
+- Anpassung der main.js und controlStates zur Integration
+- Vorbereitung weiterer Wartungs- und Steuerungsfunktionen (Beleuchtung, Roboter, Ventile, Gegenstromanlage, Kesseldruck-Überwachung).
 
-### 0.0.8
-- Hilfetab in der Instanzkonfiguration hinzugefügt (mit Link zur GitHub-Dokumentation)
+---
 
-### 0.0.7
-- Help-Datei (`help.md`) und erste README-Version hinzugefügt
+### 0.2.0 (2025-10-06)
+- Neuer Diagnosebereich **SystemCheck** für interne Debug-Logs und Analysen.  
+- Möglichkeit, einzelne Adapterbereiche (z. B. Pumpe, Solar, Temperatur) gezielt zu überwachen.  
+- Fortlaufendes Textprotokoll mit manueller Löschfunktion.  
+- Alle bisherigen Debug-Funktionen aus `zz_debuglogs` in `SystemCheck.debug_logs` integriert.  
+- Vorbereitung für zukünftige Diagnose-Erweiterungen (Export, Systemprüfung, Plausibilitäts-Checks).
 
-### 0.0.1
-- initial release
+*(ältere Versionen siehe [io-package.json](./io-package.json))*  
 
 ---
 
@@ -174,7 +168,6 @@ Diese Datenpunkte sind besonders für **VIS/vis2, Alexa- oder Telegram-Ausgaben*
 
 ## Unterstützung der Adapterentwicklung
 Wenn Ihnen **ioBroker.poolcontrol** gefällt, denken Sie bitte über eine Spende nach:  
-
 ➡️ [Unterstützen via PayPal](https://www.paypal.com/donate?business=dirk.bertin@t-online.de)
 
 ---
@@ -188,6 +181,6 @@ Der Nutzer ist für die **sichere Installation und den Betrieb seiner Hardware**
 ---
 
 ## License
-Copyright (c) 2025 DasBo1975 <dasbo1975@outlook.de>
+Copyright (c) 2025 DasBo1975 <dasbo1975@outlook.de>  
 
-MIT License
+MIT License

package/io-package.json

@@ -1,8 +1,32 @@
 {
   "common": {
     "name": "poolcontrol",
-    "version": "0.2.1",
+    "version": "0.3.0",
     "news": {
+      "0.3.0": {
+        "en": "Added real pump flow calculation, live monitoring, and self-learning normal range system for pump analysis.",
+        "de": "Reelle Durchflussberechnung, Liveüberwachung und selbstlernendes Normalbereich-System zur Pumpenanalyse hinzugefügt.",
+        "ru": "Добавлен расчет реального расхода насоса, живой мониторинг и самообучающаяся система нормальных диапазонов для анализа насоса.",
+        "pt": "Adicionada cálculo de fluxo real da bomba, monitoramento ao vivo e sistema autoaprendente de faixa normal para análise da bomba.",
+        "nl": "Reële pompdebietberekening, livebewaking en zelflerend normaalbereiksysteem voor pompanalyse toegevoegd.",
+        "fr": "Ajout du calcul du débit réel de la pompe, de la surveillance en direct et d’un système de plage normale auto-apprenant pour l’analyse de la pompe.",
+        "it": "Aggiunto calcolo del flusso reale della pompa, monitoraggio live e sistema autoapprendente di intervallo normale per l'analisi della pompa.",
+        "es": "Se añadió el cálculo del caudal real de la bomba, la monitorización en vivo y un sistema de rango normal autoaprendente para el análisis de la bomba.",
+        "pl": "Dodano obliczanie rzeczywistego przepływu pompy, monitorowanie na żywo i samouczący się system normalnego zakresu do analizy pompy.",
+        "zh-cn": "添加了实际泵流量计算、实时监控以及用于泵分析的自学习正常范围系统。"
+        },
+      "0.2.2": {
+        "en": "Added automatic backwash reminder with speech and log notifications.",
+        "de": "Automatische Rückspülerinnerung mit Sprach- und Log-Benachrichtigung hinzugefügt.",
+        "ru": "Добавлено автоматическое напоминание о обратной промывке с голосовыми и журнальными уведомлениями.",
+        "pt": "Adicionado lembrete automático de retrolavagem com notificações de voz e registro.",
+        "nl": "Automatische terugspoelherinnering toegevoegd met spraak- en logmeldingen.",
+        "fr": "Ajout d’un rappel automatique de contre-lavage avec notifications vocales et journaux.",
+        "it": "Aggiunto promemoria automatico di controlavaggio con notifiche vocali e log.",
+        "es": "Recordatorio automático de contralavado añadido con notificaciones de voz y registro.",
+        "pl": "Dodano automatyczne przypomnienie o płukaniu wstecznym z powiadomieniami głosowymi i dziennikiem.",
+        "zh-cn": "添加了带语音和日志通知的自动反冲洗提醒。"
+      },
       "0.2.1": {
        "en": "Fixed the issue with invisible states for speech control and added proper internal variable handling.",
        "de": "Behebung des Problems mit unsichtbaren States für die Sprachsteuerung und hinzugefügte korrekte Handhabung interner Variablen.",
@@ -28,60 +52,8 @@
        "pl": "Nowy obszar diagnostyczny 'SystemCheck' dla wewnętrznych dzienników debugowania i przyszłych narzędzi analitycznych.",
        "uk": "Нова діагностична область 'SystemCheck' для внутрішніх журналів налагодження та майбутніх інструментів аналізу.",
        "zh-cn": "新的诊断区域“SystemCheck”，用于内部调试日志和未来的分析工具。"
-      },
-      "0.1.2": {
-       "en": "Improved: The last known temperature values of all active sensors are now read at adapter start. Sensors that report rarely are now displayed correctly.",
-       "de": "Verbesserung: Beim Adapterstart werden nun die letzten bekannten Temperaturwerte aller aktiven Sensoren übernommen. Sensoren, die nur selten Werte senden, werden jetzt korrekt angezeigt.",
-       "ru": "Улучшение: При запуске адаптера теперь считываются последние известные значения температуры всех активных датчиков.",
-       "pt": "Melhoria: Os últimos valores de temperatura conhecidos de todos os sensores ativos agora são lidos ao iniciar o adaptador.",
-       "nl": "Verbetering: Bij het starten van de adapter worden nu de laatst bekende temperatuurwaarden van alle actieve sensoren opgehaald.",
-       "fr": "Amélioration : les dernières valeurs de température connues de tous les capteurs actifs sont désormais lues au démarrage de l’adaptateur.",
-       "it": "Miglioramento: all'avvio dell'adattatore vengono ora letti gli ultimi valori di temperatura noti di tutti i sensori attivi.",
-       "es": "Mejora: ahora se leen al iniciar el adaptador los últimos valores de temperatura conocidos de todos los sensores activos.",
-       "pl": "Ulepszenie: podczas uruchamiania adaptera odczytywane są ostatnie znane wartości temperatury wszystkich aktywnych czujników.",
-       "uk": "Покращення: під час запуску адаптера тепер зчитуються останні відомі значення температури всіх активних датчиків.",
-       "zh-cn": "改进：适配器启动时现在会读取所有活动传感器的最后已知温度值。"
-      },
-      "0.1.1": {
-       "en": "Fixed endless loop between pump_switch and deviceId for some smart sockets",
-       "de": "Endlosschleife zwischen pump_switch und Steckdose (deviceId) behoben",
-       "ru": "Исправлен бесконечный цикл между pump_switch и deviceId для некоторых умных розеток",
-       "pt": "Corrigido loop infinito entre pump_switch e deviceId em algumas tomadas inteligentes",
-       "nl": "Eindeloze lus tussen pump_switch en deviceId voor sommige slimme stopcontacten opgelost",
-       "fr": "Correction d'une boucle infinie entre pump_switch et deviceId pour certaines prises intelligentes",
-       "it": "Corretto loop infinito tra pump_switch e deviceId per alcune prese intelligenti",
-       "es": "Corregido bucle infinito entre pump_switch y deviceId en algunos enchufes inteligentes",
-       "pl": "Naprawiono nieskończoną pętlę między pump_switch a deviceId dla niektórych inteligentnych gniazdek",
-       "uk": "Виправлено нескінченний цикл між pump_switch і deviceId для деяких розумних розеток",
-       "zh-cn": "修复了某些智能插座中 pump_switch 与 deviceId 之间的无限循环"
-      },
-      "0.1.0": {
-       "en": "Added speech output via E-Mail (configurable: instance, recipient, subject)",
-       "de": "Sprachausgabe per E-Mail hinzugefügt (konfigurierbar: Instanz, Empfänger, Betreff)",
-       "ru": "Добавлен вывод речи по электронной почте (настраивается: экземпляр, получатель, тема)",
-       "pt": "Adicionada saída de fala por e-mail (configurável: instância, destinatário, assunto)",
-       "nl": "Spraakuitvoer via e-mail toegevoegd (configureerbaar: instantie, ontvanger, onderwerp)",
-       "fr": "Ajout de la sortie vocale par e-mail (configurable : instance, destinataire, sujet)",
-       "it": "Aggiunta uscita vocale via e-mail (configurabile: istanza, destinatario, oggetto)",
-       "es": "Se agregó salida de voz por correo electrónico (configurable: instancia, destinatario, asunto)",
-       "pl": "Dodano wyjście głosowe przez e-mail (konfigurowalne: instancja, odbiorca, temat)",
-       "uk": "Додано озвучення електронною поштою (налаштовується: екземпляр, одержувач, тема)",
-       "zh-cn": "新增通过电子邮件的语音输出（可配置：实例、收件人、主题）"
-      },
-      "0.0.10": {
-       "en": "Added extended status overview with pump statistics, system flags and JSON summary",
-       "de": "Erweiterte Statusübersicht mit Pumpenstatistiken, Systemanzeigen und JSON-Zusammenfassung hinzugefügt",
-       "ru": "Добавлен расширенный обзор состояния с насосной статистикой, системными флагами и JSON-резюме",
-       "pt": "Adicionada visão geral de status estendida com estatísticas da bomba, sinalizadores do sistema e resumo em JSON",
-       "nl": "Uitgebreide statusoverzicht toegevoegd met pompstatistieken, systeemindicatoren en JSON-samenvatting",
-       "fr": "Aperçu du statut étendu ajouté avec statistiques de la pompe, indicateurs système et résumé JSON",
-       "it": "Aggiunta panoramica dello stato estesa con statistiche della pompa, indicatori di sistema e riepilogo JSON",
-       "es": "Añadida vista general de estado extendida con estadísticas de la bomba, indicadores del sistema y resumen en JSON",
-       "pl": "Dodano rozszerzony przegląd statusu ze statystykami pompy, flagami systemowymi i podsumowaniem JSON",
-       "uk": "Додано розширений огляд статусу зі статистикою насоса, системними прапорцями та зведенням JSON",
-       "zh-cn": "新增扩展状态概览，包括泵统计、系统标志和 JSON 摘要"
       }
-    },
+	},
     "titleLang": {
       "en": "PoolControl",
       "de": "PoolControl",
@@ -159,5 +131,5 @@
   },
   "objects": [],
   "instanceObjects": []
-  }
+}
 

package/lib/helpers/controlHelper.js

@@ -141,6 +141,7 @@ async function _startAutoPumping(missingLiter) {
 
         previousPumpMode = (await adapter.getStateAsync('pump.mode'))?.val || 'auto';
         await adapter.setStateAsync('pump.mode', { val: 'controlHelper', ack: true });
+        await adapter.setStateAsync('pump.active_helper', { val: 'controlHelper', ack: true });
         await adapter.setStateAsync('pump.reason', { val: 'nachpumpen', ack: true });
         await adapter.setStateAsync('pump.pump_switch', { val: true, ack: false });
 
@@ -157,6 +158,7 @@ async function _startAutoPumping(missingLiter) {
                 clearInterval(interval);
                 await adapter.setStateAsync('pump.pump_switch', { val: false, ack: false });
                 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;
 
@@ -199,6 +201,7 @@ async function handleStateChange(id, state) {
                 previousPumpMode = (await adapter.getStateAsync('pump.mode'))?.val || 'auto';
                 await adapter.setStateAsync('pump.mode', { val: 'controlHelper', ack: true });
                 await adapter.setStateAsync('pump.reason', { val: 'wartung', ack: true });
+                await adapter.setStateAsync('pump.active_helper', { val: 'controlHelper', ack: true });
                 await adapter.setStateAsync('pump.pump_switch', { val: false, ack: false });
                 adapter.log.info('[controlHelper] Wartungsmodus aktiviert. Automatik pausiert.');
 
@@ -207,6 +210,7 @@ async function handleStateChange(id, state) {
                 }
             } else {
                 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;
 
@@ -232,6 +236,7 @@ async function handleStateChange(id, state) {
             await adapter.setStateAsync('control.pump.backwash_active', { val: true, ack: true });
             await adapter.setStateAsync('control.pump.backwash_start', { val: false, ack: true });
             await adapter.setStateAsync('pump.mode', { val: 'controlHelper', ack: true });
+            await adapter.setStateAsync('pump.active_helper', { val: 'controlHelper', ack: true });
             await adapter.setStateAsync('pump.reason', { val: 'rückspülen', ack: true });
             await adapter.setStateAsync('pump.pump_switch', { val: true, ack: false });
 
@@ -250,6 +255,7 @@ async function handleStateChange(id, state) {
                     try {
                         await adapter.setStateAsync('pump.pump_switch', { val: false, ack: false });
                         await adapter.setStateAsync('pump.mode', { val: prevMode, ack: true });
+                        await adapter.setStateAsync('pump.active_helper', { val: '', ack: true });
                         await adapter.setStateAsync('pump.reason', { val: '', ack: true });
                         await adapter.setStateAsync('control.pump.backwash_active', { val: false, ack: true });
 

package/lib/helpers/controlHelper2.js

@@ -0,0 +1,195 @@
+'use strict';
+
+/**
+ * controlHelper2
+ * ----------------------------------------------
+ * Rückspülerinnerungs-Logik (eigenständig)
+ * ----------------------------------------------
+ * - täglicher Check um 12:00 Uhr (lokale Host-Zeit)
+ * - prüft Intervall und letzte Rückspülung
+ * - erzeugt Erinnerungen (Log + speech.queue)
+ * - setzt Erinnerung automatisch zurück, wenn Rückspülung startet
+ * ----------------------------------------------
+ */
+
+// NEU: Modulvariablen
+let adapter;
+let backwashReminderTimer = null;
+let lastReminderDay = null; // verhindert doppelte tägliche Meldungen
+
+// NEU: Initialisierung
+/**
+ * Initialisiert den Rückspülerinnerungs-Helper
+ *
+ * @param {import('iobroker').Adapter} a – ioBroker-Adapterinstanz
+ */
+function init(a) {
+    adapter = a;
+    adapter.log.info('[controlHelper2] Rückspülerinnerung initialisiert (täglicher Check um 12:00 Uhr).');
+
+    // Rückspülstart abonnieren, um Erinnerung zurückzusetzen
+    adapter.subscribeStates('control.pump.backwash_start');
+
+    // Täglichen Check planen
+    _scheduleBackwashReminder().catch(err =>
+        adapter.log.error(`[controlHelper2] Fehler bei _scheduleBackwashReminder(): ${err.message}`),
+    );
+}
+
+// NEU: Plant täglichen Timer um 12:00 Uhr lokale Zeit
+async function _scheduleBackwashReminder() {
+    try {
+        if (backwashReminderTimer) {
+            clearTimeout(backwashReminderTimer);
+        }
+
+        const now = new Date();
+        const next = new Date();
+        next.setHours(12, 0, 0, 0); // 12:00 Uhr lokale Zeit
+
+        // Wenn 12:00 Uhr heute schon vorbei ist → morgen
+        if (next <= now) {
+            next.setDate(next.getDate() + 1);
+        }
+
+        const diffMs = next - now;
+        adapter.log.debug(`[controlHelper2] Nächster Rückspülerinnerungs-Check geplant für ${next.toLocaleString()}`);
+
+        backwashReminderTimer = setTimeout(async () => {
+            await _runBackwashReminderCheck();
+            await _scheduleBackwashReminder(); // neu planen
+        }, diffMs);
+    } catch (err) {
+        adapter.log.error(`[controlHelper2] Fehler bei _scheduleBackwashReminder(): ${err.message}`);
+    }
+}
+
+// NEU: Führt täglichen Erinnerungs-Check aus
+async function _runBackwashReminderCheck() {
+    try {
+        adapter.log.debug('[controlHelper2] Starte Rückspülerinnerungs-Check ...');
+
+        const reminderActive = (await adapter.getStateAsync('control.pump.backwash_reminder_active'))?.val;
+        if (!reminderActive) {
+            adapter.log.debug('[controlHelper2] Rückspülerinnerung deaktiviert – Check übersprungen.');
+            return;
+        }
+
+        const intervalDays = Number((await adapter.getStateAsync('control.pump.backwash_interval_days'))?.val || 7);
+        const lastDateStr = (await adapter.getStateAsync('control.pump.backwash_last_date'))?.val || '';
+
+        const now = new Date();
+        const todayKey = now.toISOString().split('T')[0]; // yyyy-mm-dd
+
+        // Verhindert doppelte Erinnerungen am selben Tag
+        if (lastReminderDay === todayKey) {
+            adapter.log.debug('[controlHelper2] Erinnerung für heute bereits gesendet.');
+            return;
+        }
+
+        let daysSince = null;
+        if (lastDateStr) {
+            const lastDate = new Date(lastDateStr);
+            const diffMs = now - lastDate;
+            daysSince = Math.floor(diffMs / (1000 * 60 * 60 * 24));
+        }
+
+        if (daysSince === null) {
+            adapter.log.debug('[controlHelper2] Keine letzte Rückspülung bekannt – keine Erinnerung.');
+            return;
+        }
+
+        const notify = (await adapter.getStateAsync('control.pump.notifications_enabled'))?.val;
+        const speechEnabled = notify === true;
+
+        if (daysSince >= intervalDays) {
+            // Fällig oder überfällig
+            await adapter.setStateAsync('control.pump.backwash_required', { val: true, ack: true });
+            let text;
+
+            if (daysSince === intervalDays) {
+                text = 'Erinnerung: Rückspülung ist wieder fällig.';
+            } else {
+                const over = daysSince - intervalDays;
+                text = `Erinnerung: Rückspülung ist seit ${over} Tag${over === 1 ? '' : 'en'} überfällig.`;
+            }
+
+            adapter.log.info(`[controlHelper2] ${text}`);
+            if (speechEnabled) {
+                await _sendSpeech(text);
+            }
+
+            lastReminderDay = todayKey;
+        } else {
+            adapter.log.debug(`[controlHelper2] Rückspülung noch nicht fällig (${daysSince}/${intervalDays} Tage).`);
+        }
+    } catch (err) {
+        adapter.log.warn(`[controlHelper2] Fehler beim Erinnerungs-Check: ${err.message}`);
+    }
+}
+
+// NEU: Rücksetzung nach Rückspülstart
+/**
+ * Reagiert auf State-Änderungen (z. B. Rückspülstart).
+ *
+ * @param {string} id – Objekt-ID des geänderten States
+ * @param {ioBroker.State} state – Neuer State-Wert
+ */
+async function handleStateChange(id, state) {
+    try {
+        if (!state || state.ack) {
+            return;
+        }
+        if (!id.endsWith('control.pump.backwash_start') || !state.val) {
+            return;
+        }
+
+        adapter.log.debug('[controlHelper2] Rückspülstart erkannt – Erinnerung wird zurückgesetzt.');
+
+        await adapter.setStateAsync('control.pump.backwash_required', { val: false, ack: true });
+        await adapter.setStateAsync('control.pump.backwash_last_date', {
+            val: new Date().toISOString(),
+            ack: true,
+        });
+
+        const notify = (await adapter.getStateAsync('control.pump.notifications_enabled'))?.val;
+        if (notify) {
+            const text = 'Rückspülerinnerung wurde zurückgesetzt. Rückspülzyklus neu gestartet.';
+            adapter.log.info(`[controlHelper2] ${text}`);
+            await _sendSpeech(text);
+        }
+    } catch (err) {
+        adapter.log.warn(`[controlHelper2] Fehler bei handleStateChange(): ${err.message}`);
+    }
+}
+
+// NEU: Sprachausgabe
+async function _sendSpeech(text) {
+    if (!text) {
+        return;
+    }
+    try {
+        await adapter.setStateAsync('speech.queue', { val: text, ack: false });
+        adapter.log.debug(`[controlHelper2] Nachricht an speech.queue: ${text}`);
+    } catch (err) {
+        adapter.log.warn(`[controlHelper2] Fehler beim Senden an speech.queue: ${err.message}`);
+    }
+}
+
+// NEU: Aufräumen
+/**
+ * Stoppt den Rückspülerinnerungs-Timer und räumt Variablen auf.
+ *
+ * @returns {void}
+ */
+function cleanup() {
+    if (backwashReminderTimer) {
+        clearTimeout(backwashReminderTimer);
+        backwashReminderTimer = null;
+    }
+    lastReminderDay = null;
+    adapter.log.debug('[controlHelper2] Cleanup ausgeführt.');
+}
+
+// NEU: Exporte
+module.exports = { init, handleStateChange, cleanup };

package/lib/helpers/frostHelper.js

@@ -33,8 +33,8 @@ const frostHelper = {
     async _checkFrost() {
         try {
             // --- NEU: Vorrangprüfung durch ControlHelper ---
-            const pumpStatus = (await this.adapter.getStateAsync('pump.status'))?.val || '';
-            if (pumpStatus.includes('controlHelper')) {
+            const activeHelper = (await this.adapter.getStateAsync('pump.active_helper'))?.val || '';
+            if (activeHelper === 'controlHelper') {
                 this.adapter.log.debug('[frostHelper] Vorrang durch ControlHelper aktiv – Frostschutz pausiert.');
                 return;
             }