iobroker.poolcontrol 0.2.1 → 0.2.2

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,52 @@ 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.
-
-### 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.
+### **WORK IN PROGRESS**
 
-### 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.
+### 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.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.
-
-
-### 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.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 +150,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 +163,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,20 @@
 {
   "common": {
     "name": "poolcontrol",
-    "version": "0.2.1",
+    "version": "0.2.2",
     "news": {
+      "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.",
@@ -54,34 +66,8 @@
        "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 +145,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;
             }

package/lib/helpers/solarHelper.js

@@ -33,8 +33,8 @@ const solarHelper = {
     async _checkSolar() {
         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('[solarHelper] Vorrang durch ControlHelper aktiv – Solarregelung pausiert.');
                 return;
             }

package/lib/stateDefinitions/controlStates.js

@@ -118,6 +118,70 @@ async function createControlStates(adapter) {
         });
         await adapter.setStateAsync('control.pump.backwash_duration', { val: 1, ack: true });
 
+        // >>> NEU: Rückspülerinnerung
+        await adapter.setObjectNotExistsAsync('control.pump.backwash_reminder_active', {
+            type: 'state',
+            common: {
+                name: 'Rückspülerinnerung aktiv',
+                desc: 'Wenn aktiviert, erinnert der Adapter automatisch nach Ablauf des eingestellten Intervalls an die Rückspülung',
+                type: 'boolean',
+                role: 'switch',
+                read: true,
+                write: true,
+                def: false,
+            },
+            native: {},
+        });
+        await adapter.setStateAsync('control.pump.backwash_reminder_active', { val: false, ack: true });
+
+        await adapter.setObjectNotExistsAsync('control.pump.backwash_interval_days', {
+            type: 'state',
+            common: {
+                name: 'Rückspülerinnerung: Intervall (Tage)',
+                desc: 'Anzahl Tage, nach denen eine Erinnerung für die Rückspülung erfolgt',
+                type: 'number',
+                role: 'value.interval',
+                unit: 'Tage',
+                read: true,
+                write: true,
+                def: 7,
+                min: 1,
+                max: 60,
+            },
+            native: {},
+        });
+        await adapter.setStateAsync('control.pump.backwash_interval_days', { val: 7, ack: true });
+
+        await adapter.setObjectNotExistsAsync('control.pump.backwash_last_date', {
+            type: 'state',
+            common: {
+                name: 'Letzte Rückspülung (Datum)',
+                desc: 'Zeitstempel der letzten ausgeführten Rückspülung, dient der Erinnerungsberechnung',
+                type: 'string',
+                role: 'date',
+                read: true,
+                write: false,
+            },
+            native: {},
+        });
+        await adapter.setStateAsync('control.pump.backwash_last_date', { val: '', ack: true });
+
+        await adapter.setObjectNotExistsAsync('control.pump.backwash_required', {
+            type: 'state',
+            common: {
+                name: 'Rückspülung erforderlich',
+                desc: 'Wird automatisch auf true gesetzt, wenn die eingestellte Rückspülzeit überschritten wurde',
+                type: 'boolean',
+                role: 'indicator.alarm',
+                read: true,
+                write: false,
+                def: false,
+            },
+            native: {},
+        });
+        await adapter.setStateAsync('control.pump.backwash_required', { val: false, ack: true });
+
+        // ---------------------------------------------------------------------
         // Wartungsmodus aktiv
         await adapter.setObjectNotExistsAsync('control.pump.maintenance_active', {
             type: 'state',

package/lib/stateDefinitions/pumpStates.js

@@ -149,6 +149,25 @@ async function createPumpStates(adapter) {
     });
     await adapter.setStateAsync('pump.status', { val: 'AUS', ack: true });
 
+    // Aktiver Helfer (Vorrangsteuerung)
+    await adapter.setObjectNotExistsAsync('pump.active_helper', {
+        type: 'state',
+        common: {
+            name: 'Aktiver Helfer (Vorrangsteuerung)',
+            desc: 'Zeigt an, welcher Helper aktuell die Vorrangsteuerung der Pumpe übernommen hat (z. B. Control, Solar, Frost, Zeit, Heizung …)',
+            type: 'string',
+            role: 'text',
+            read: true,
+            write: false, // Nur intern schreibbar
+            hidden: false, // Sichtbar, damit Nutzer den aktiven Helper sehen kann
+        },
+        native: {},
+    });
+    await adapter.setStateAsync('pump.active_helper', {
+        val: '',
+        ack: true,
+    });
+
     // Pumpenfehler (bool)
     await adapter.setObjectNotExistsAsync('pump.error', {
         type: 'state',

package/main.js

@@ -15,6 +15,7 @@ const solarHelper = require('./lib/helpers/solarHelper');
 const frostHelper = require('./lib/helpers/frostHelper');
 const statusHelper = require('./lib/helpers/statusHelper');
 const controlHelper = require('./lib/helpers/controlHelper');
+const controlHelper2 = require('./lib/helpers/controlHelper2');
 const debugLogHelper = require('./lib/helpers/debugLogHelper');
 const speechTextHelper = require('./lib/helpers/speechTextHelper');
 const { createTemperatureStates } = require('./lib/stateDefinitions/temperatureStates');
@@ -93,6 +94,7 @@ class Poolcontrol extends utils.Adapter {
         frostHelper.init(this);
         statusHelper.init(this);
         controlHelper.init(this);
+        controlHelper2.init(this);
         debugLogHelper.init(this);
         speechTextHelper.init(this);
     }
@@ -129,6 +131,9 @@ class Poolcontrol extends utils.Adapter {
             if (controlHelper.cleanup) {
                 controlHelper.cleanup();
             }
+            if (controlHelper2.cleanup) {
+                controlHelper2.cleanup();
+            }
             if (speechTextHelper.cleanup) {
                 speechTextHelper.cleanup();
             }
@@ -191,6 +196,9 @@ class Poolcontrol extends utils.Adapter {
         if (id.includes('control.')) {
             controlHelper.handleStateChange(id, state);
         }
+        if (id.includes('control.')) {
+            controlHelper2.handleStateChange(id, state);
+        }
 
         await debugLogHelper.handleStateChange(id, state);
     }

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "iobroker.poolcontrol",
-  "version": "0.2.1", 
+  "version": "0.2.2",
   "description": "Steuerung & Automatisierung für den Pool (Pumpe, Heizung, Ventile, Sensoren).",
   "author": "DasBo1975 <dasbo1975@outlook.de>",
   "homepage": "https://github.com/DasBo1975/ioBroker.poolcontrol",
   "license": "MIT",
   "keywords": [
-    "ioBroker",  
+    "ioBroker",
     "pool",
     "pumpe",
     "solar",
@@ -24,6 +24,7 @@
     "@iobroker/adapter-core": "^3.3.2"
   },
   "devDependencies": {
+    "@alcalzone/release-script": "^4.0.0",
     "@iobroker/adapter-dev": "^1.5.0",
     "@iobroker/eslint-config": "^2.2.0",
     "@iobroker/testing": "^5.1.1",