iobroker.poolcontrol 0.5.5 → 0.6.0

package/README.md

@@ -19,7 +19,8 @@ Er ermöglicht die Automatisierung von Pumpen-, Temperatur- und Solarsteuerung s
 ## Funktionen
 
 - **Pumpensteuerung**
-  - Betriebsmodi: Automatik, Manuell, Zeitsteuerung, Aus
+  - Betriebsmodi: Automatik, Automatik (PV), Manuell, Zeitsteuerung, Aus
+  - Automatik (PV) steuert die Pumpe abhängig vom Photovoltaik-Überschuss
   - Fehlererkennung (kein Stromverbrauch, Leistung trotz „AUS“, Überlast)
   - Sicherheitsfunktionen (Frostschutz, Überhitzungsschutz)
 
@@ -34,12 +35,24 @@ Er ermöglicht die Automatisierung von Pumpen-, Temperatur- und Solarsteuerung s
   - Kollektor-Warnung (mit automatischer Rücksetzung bei 10 % unter der Schwelle)
   - Optionale Sprachausgabe bei Warnung
 
+- **Photovoltaiksteuerung (ab v0.6.0)
+  - Automatische Pumpensteuerung auf Basis von PV-Erzeugung und Hausverbrauchs
+  - Einschaltlogik: Überschuss ≥ (Pumpen-Nennleistung + Sicherheitsaufschlag)
+  - Optionaler Nachlauf bei Wolkenphasen
+  - Ignorieren bei erreichter Tagesumwälzung
+  - Konfiguration über zwei Fremd-Objekt-IDs (power_generated_id, power_house_id)
+  - Neuer Pumpenmodus „Automatik (PV)
+
 - **Zeitsteuerung**
   - Bis zu 3 frei konfigurierbare Zeitfenster pro Woche
 
 - **Laufzeit & Umwälzung**
   - Zählt Laufzeiten (heute, gesamt)
   - Berechnet tägliche Umwälzung und Restmenge
+  - Rückspülerinnerung mit konfigurierbarem Intervall (z. B. alle 7 Tage)
+  - Anzeige der letzten Rückspülung inkl. Datum
+  - Automatische Rücksetzung nach erfolgter Rückspülung
+  - PV-Modus berücksichtigt Umwälzstatus (z. B. „Ignoriere bei Umwälzung erreicht“)
 
 - **Verbrauch & Kosten**
   - Auswertung eines externen kWh-Zählers
@@ -49,16 +62,19 @@ Er ermöglicht die Automatisierung von Pumpen-, Temperatur- und Solarsteuerung s
   **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).
 
+- **Statistiksystem**
+  - Bereich `analytics.statistics.*` mit Tages-, Wochen- und Monatswerten
+  - Automatische Berechnung von Min-, Max-, Durchschnitts- und Laufzeitwerten
+  - Vollständig persistente Datenpunkte (Überinstallationsschutz)
+  - HTML- und JSON-Zusammenfassungen pro Sensor und Gesamtübersicht
+
 - **Sprachausgaben**
   - Ausgabe über Alexa oder Telegram
   - Ansagen bei Pumpenstart/-stopp, Fehlern oder Temperaturschwellen
 
 - **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.
-
-  *Funktionen:*
-  - Auswahl des zu überwachenden Bereichs
+  - Interner Diagnosebereich für Debug- und Überwachungsfunktionen
+  - Auswahl des zu überwachenden Bereichs (z. B. Pumpe, Solar, Temperatur)
   - Fortlaufendes Log der letzten Änderungen
   - Manuelles Löschen des Logs möglich
 
@@ -90,26 +106,24 @@ Die Konfiguration erfolgt über Tabs im Admin-Interface:
 
 ## Geplante Erweiterungen
 
-- 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
+- Erweiterte PV- und Solar-Effizienzanalyse (COP-Berechnung, Tagesnutzen, Wetterintegration)
+- Statistik-Exportfunktion (CSV/Excel)
+- Diagnostic-Helper zur automatischen Systemprüfung
+- Erweiterung der Heizungs-/Wärmepumpenlogik (`heatHelper`)
+- Drucksensor-Integration zur Kesseldruck-Überwachung
+- Zweite Pumpe (z. B. Wärmetauscher oder Wärmepumpe)
+- Eigene Widgets für VIS/VIS2 (grafische Pool- und Solarvisualisierung)
+- Steuerung von Poolbeleuchtung, Ventilen und Gegenstromanlagen
+- Integration zusätzlicher Sensorboxen (z. B. TempBox, PressureBox, LevelBox)
+- KI- und Sprach-Assistenten-Erweiterung (Pool-Tagesbericht, Tipps, Sprachbefehle)
+
 
 ---
 
 ## Hinweis
 
-Der Adapter befindet sich aktuell in der Entwicklung.  
-Funktionen können sich ändern – bitte regelmäßig den Changelog beachten.
+Der Adapter befindet sich in aktiver Weiterentwicklung.
+Neue Funktionen werden regelmäßig ergänzt – bitte den Changelog beachten.
 
 ---
 
@@ -121,6 +135,15 @@ Funktionen können sich ändern – bitte regelmäßig den Changelog beachten.
 ## Changelog
 ### **WORK IN PROGRESS**
 
+## v0.6.0 (2025-11-03)
+- Einführung der vollständigen Photovoltaik-Steuerung mit automatischer Pumpenlogik  
+  (neuer Pumpenmodus `Automatik (PV)` unter `pump.mode`)
+- Adapter reagiert auf PV-Überschuss basierend auf konfigurierbarer Hausverbrauchs- und Erzeugungsleistung
+- Einschaltlogik: Pumpe EIN bei Überschuss ≥ (Nennleistung + Schwellwert)
+- Berücksichtigung von Saisonstatus, Nachlaufzeit und optionalem „Umwälzung erreicht“-Schutz
+- Automatische Migration ergänzt neuen Modus `auto_pv` in bestehenden Installationen
+- Verbesserte interne Logik, Persistenz und Debug-Protokollierung
+
 ## v0.5.5 (2025-11-01)
 - Endlosschleife in Statistik Woche und Monat behoben
 

package/admin/jsonConfig.json

@@ -862,7 +862,6 @@
         "speech_telegram_users": {
           "type": "text",
           "label": "Telegram-Empfänger (Benutzernamen, Komma-getrennt / leer = an alle Benutzer)",
-          "attr": "speech_telegram_users",
           "tooltip": "Beispiel: Dirk,Dennis (leer = an alle Benutzer senden)",
           "default": "",
           "xs": 12,
@@ -947,7 +946,7 @@
 	},
 	"consumption": {
 	  "type": "panel",
-	  "label": "Verbrauch & Kosten",
+	  "label": "PV, Verbrauch & Kosten",
 	  "items": {
 		"divider_cons1": {
 		  "type": "divider",
@@ -1003,7 +1002,59 @@
           "md": 12,
           "lg": 12,
           "xl": 12
-		}
+		},
+
+        "divider_pv1": {
+          "type": "divider",
+          "newLine": true
+        },
+        "pv_header": {
+          "type": "header",
+          "text": "Photovoltaik (Überschusserkennung)",
+          "size": 4,
+          "newLine": true,
+          "xs": 12,
+          "sm": 12,
+          "md": 12,
+          "lg": 12,
+          "xl": 12
+        },
+        "power_generated_id": {
+          "type": "objectId",
+          "label": "Objekt-ID PV-Erzeugungsleistung (W)",
+          "default": "",
+          "xs": 12,
+          "sm": 6,
+          "md": 6,
+          "lg": 6,
+          "xl": 6,
+          "tooltip": "Datenpunkt mit aktueller PV-Leistung (Watt)"
+        },
+        "power_house_id": {
+          "type": "objectId",
+          "label": "Objekt-ID Hausverbrauch (W)",
+          "default": "",
+          "xs": 12,
+          "sm": 6,
+          "md": 6,
+          "lg": 6,
+          "xl": 6,
+          "tooltip": "Datenpunkt mit aktuellem Hausverbrauch (Watt)"
+        },
+        "threshold_w": {
+          "type": "number",
+          "label": "Schwellwert für PV-Überschuss (W)",
+          "default": 200,
+          "min": 0,
+          "max": 2000,
+          "step": 50,
+          "xs": 12,
+          "sm": 3,
+          "md": 3,
+          "lg": 3,
+          "xl": 3,
+          "tooltip": "Ab welcher Differenz zwischen PV und Hausverbrauch ein Überschuss gilt"
+        }
 	  }
     },	
 	"help": {

package/io-package.json

@@ -1,8 +1,21 @@
 {
   "common": {
     "name": "poolcontrol",
-    "version": "0.5.5",
+    "version": "0.6.0",
     "news": {
+       "0.6.0": {
+         "en": "Added complete photovoltaic control with automatic pump management (mode 'Automatik (PV)'). The adapter can now react to PV surplus based on configurable house consumption and generation values. Includes migration for existing installations. Improved system consistency and internal logging.",
+         "de": "Vollständige Photovoltaik-Steuerung mit automatischer Pumpenlogik (Modus 'Automatik (PV)') hinzugefügt. Der Adapter reagiert nun auf PV-Überschuss anhand konfigurierbarer Hausverbrauchs- und Erzeugungswerte. Migration für bestehende Installationen integriert. Systemkonsistenz und interne Protokollierung verbessert.",
+         "ru": "Добавлено полное управление фотоэлектрической системой с автоматическим управлением насосом (режим 'Automatik (PV)'). Адаптер теперь реагирует на избыток PV на основе настраиваемых значений потребления и генерации. Включена миграция для существующих установок. Улучшена системная согласованность и внутреннее ведение журнала.",
+         "pt": "Adicionado controle fotovoltaico completo com gerenciamento automático da bomba (modo 'Automatik (PV)'). O adaptador agora reage ao excedente de PV com base nos valores configuráveis de consumo e geração da casa. Inclui migração para instalações existentes. Consistência do sistema e registro interno aprimorados.",
+         "nl": "Volledige fotovoltaïsche besturing toegevoegd met automatische pompbesturing (modus 'Automatik (PV)'). De adapter reageert nu op PV-overschot op basis van configureerbare huisverbruik- en opwekkingswaarden. Migratie voor bestaande installaties inbegrepen. Verbeterde systeemconsistentie en interne logboekregistratie.",
+         "fr": "Ajout du contrôle photovoltaïque complet avec gestion automatique de la pompe (mode 'Automatik (PV)'). L'adaptateur réagit désormais au surplus photovoltaïque en fonction des valeurs configurables de consommation et de production domestiques. Migration incluse pour les installations existantes. Cohérence du système et journalisation interne améliorées.",
+         "it": "Aggiunto controllo fotovoltaico completo con gestione automatica della pompa (modalità 'Automatik (PV)'). L'adattatore ora reagisce al surplus fotovoltaico in base ai valori configurabili di consumo e generazione domestici. Migrazione inclusa per le installazioni esistenti. Migliorata la coerenza del sistema e la registrazione interna.",
+         "es": "Se añadió control fotovoltaico completo con gestión automática de la bomba (modo 'Automatik (PV)'). El adaptador ahora reacciona al excedente fotovoltaico según los valores configurables de consumo y generación de la casa. Incluye migración para instalaciones existentes. Mejorada la coherencia del sistema y el registro interno.",
+         "pl": "Dodano pełną kontrolę fotowoltaiczną z automatycznym zarządzaniem pompą (tryb 'Automatik (PV)'). Adapter reaguje teraz na nadwyżkę PV w oparciu o konfigurowalne wartości zużycia i produkcji energii. Zawiera migrację dla istniejących instalacji. Poprawiono spójność systemu i wewnętrzne logowanie.",
+         "uk": "Додано повний фотогальванічний контроль з автоматичним керуванням насосом (режим 'Automatik (PV)'). Адаптер тепер реагує на надлишок PV на основі налаштовуваних значень споживання та генерації. Включено міграцію для існуючих установок. Покращено системну узгодженість і внутрішнє журналювання.",
+         "zh-cn": "新增完整的光伏控制与自动泵管理（模式“Automatik (PV)”）。适配器现在可根据可配置的家庭耗电与发电数值响应光伏盈余。包含对现有安装的迁移。改进了系统一致性和内部日志记录。"
+       },
        "0.5.5": {
          "en": "Fixed remaining timer recursion issue in weekly and monthly statistics to fully prevent infinite reset loops. Cleaned up jsonConfig structure and improved timer handling.",
          "de": "Verbleibende Timer-Rekursion in Wochen- und Monatsstatistik behoben, um Endlosschleifen beim Reset endgültig zu verhindern. jsonConfig-Struktur bereinigt und Timer-Handling verbessert.",
@@ -78,20 +91,7 @@
         "pl": "Dodano tygodniowe i miesięczne statystyki temperatury w analytics.statistics.temperature.week i analytics.statistics.temperature.month z automatycznymi podsumowaniami, niezależnymi pomocnikami i trwałymi punktami danych.",
         "uk": "Додано щотижневу та щомісячну статистику температури в analytics.statistics.temperature.week та analytics.statistics.temperature.month з автоматичними зведеннями, незалежними помічниками та постійними точками даних.",
         "zh-cn": "在 analytics.statistics.temperature.week 和 analytics.statistics.temperature.month 中添加了每周和每月温度统计，具有自动摘要、独立助手和持久数据点。"
-      },
-      "0.4.0": {
-        "en": "Added daily temperature statistics under analytics.statistics.temperature.today with automatic min/max/average tracking, JSON and HTML summaries, and midnight reset logic.",
-        "de": "Tägliche Temperaturstatistik unter analytics.statistics.temperature.today hinzugefügt mit automatischer Erfassung von Min-/Max-/Durchschnittswerten, JSON- und HTML-Zusammenfassungen sowie Mitternachts-Reset.",
-        "ru": "Добавлена ежедневная статистика температуры в analytics.statistics.temperature.today с автоматическим отслеживанием мин./макс./средних значений, JSON и HTML сводками и логикой сброса в полночь.",
-        "pt": "Adicionadas estatísticas diárias de temperatura em analytics.statistics.temperature.today com rastreamento automático de mínimo/máximo/média, resumos em JSON e HTML e redefinição automática à meia-noite.",
-        "nl": "Dagelijkse temperatuurstatistieken toegevoegd onder analytics.statistics.temperature.today met automatische min/max/gemiddelde tracking, JSON- en HTML-samenvattingen en middernachtreset.",
-        "fr": "Ajout de statistiques quotidiennes de température sous analytics.statistics.temperature.today avec suivi automatique min/max/moyenne, résumés JSON et HTML et réinitialisation automatique à minuit.",
-        "it": "Aggiunte statistiche giornaliere della temperatura in analytics.statistics.temperature.today con monitoraggio automatico di min/max/media, riepiloghi JSON e HTML e reset automatico a mezzanotte.",
-        "es": "Se añadieron estadísticas diarias de temperatura en analytics.statistics.temperature.today con seguimiento automático de mínimos/máximos/promedios, resúmenes en JSON y HTML y reinicio automático a medianoche.",
-        "pl": "Dodano dzienne statystyki temperatury w analytics.statistics.temperature.today z automatycznym śledzeniem wartości min/max/średnich, podsumowaniami JSON i HTML oraz resetem o północy.",
-        "uk": "Додано щоденну статистику температури в analytics.statistics.temperature.today з автоматичним відстеженням мін/макс/середніх значень, JSON і HTML зведеннями та скиданням опівночі.",
-        "zh-cn": "在 analytics.statistics.temperature.today 中添加了每日温度统计，具有自动最小/最大/平均跟踪、JSON 和 HTML 摘要以及午夜重置功能。"
-      }
+       }
 	},
     "titleLang": {
       "en": "PoolControl",

package/lib/helpers/migrationHelper.js

@@ -9,7 +9,7 @@
  * - Wird beim Adapterstart einmalig ausgeführt.
  * - Korrigiert veraltete Definitionen (z. B. Schreibrechte, persist-Flags, etc.)
  *
- * Version: 1.0.1
+ * Version: 1.0.2
  */
 
 const migrationHelper = {
@@ -31,6 +31,7 @@ const migrationHelper = {
             // ------------------------------------------------------
             await this._fixSpeechQueue();
             await this._fixSolarWarnActivePersist();
+            await this._fixPumpModeStates(); // NEU: PV-Automatik hinzufügen
 
             // Weitere Routinen folgen hier später:
             // await this._ensurePumpReason();
@@ -112,6 +113,39 @@ const migrationHelper = {
             this.adapter.log.warn(`[migrationHelper] Fehler bei Prüfung von ${id}: ${err.message}`);
         }
     },
+
+    // ------------------------------------------------------
+    // Migration: Ergänze neuen Pumpenmodus "Automatik (PV)"
+    // ------------------------------------------------------
+
+    /**
+     * Prüft den State pump.mode und ergänzt, falls nötig, den neuen
+     * Eintrag "auto_pv" → "Automatik (PV)".
+     * Dadurch wird der PV-Modus automatisch in bestehenden Installationen sichtbar.
+     */
+    async _fixPumpModeStates() {
+        const id = 'pump.mode';
+        try {
+            const obj = await this.adapter.getObjectAsync(id);
+            if (!obj) {
+                this.adapter.log.debug(`[migrationHelper] ${id} existiert nicht – keine Anpassung nötig.`);
+                return;
+            }
+
+            const states = obj.common?.states || {};
+            if (!states.auto_pv) {
+                states.auto_pv = 'Automatik (PV)';
+                this.adapter.log.info(`[migrationHelper] Ergänze neuen Modus "Automatik (PV)" in pump.mode`);
+                await this.adapter.extendObjectAsync(id, {
+                    common: { states },
+                });
+            } else {
+                this.adapter.log.debug(`[migrationHelper] pump.mode enthält bereits "Automatik (PV)".`);
+            }
+        } catch (err) {
+            this.adapter.log.warn(`[migrationHelper] Fehler bei Prüfung von ${id}: ${err.message}`);
+        }
+    },
 };
 
 module.exports = migrationHelper;

package/lib/helpers/photovoltaicHelper.js

@@ -0,0 +1,273 @@
+'use strict';
+
+/**
+ * photovoltaicHelper
+ * -------------------------------------------------------------
+ * - Liest PV-Erzeugung und Hausverbrauch (Foreign States aus Admin-Config)
+ * - Berechnet Überschussleistung und setzt Photovoltaik-States
+ * - Schaltet die Pumpe nur im Modus 'auto_pv' über pump.pump_switch
+ * - Respektiert Saison, Nachlaufzeit (Entprellung) und optionales "Umwälzung erreicht"
+ * - Einschaltlogik: Überschuss >= (pump_max_watt + threshold_w)
+ * -------------------------------------------------------------
+ */
+
+const photovoltaicHelper = {
+    adapter: null,
+    genId: null,
+    houseId: null,
+    afterrunTimer: null,
+    _pvPumpHoldUntil: 0,
+    _desiredPump: null,
+    _lastCalc: 0,
+
+    init(adapter) {
+        this.adapter = adapter;
+
+        this.genId = adapter.config?.power_generated_id || '';
+        this.houseId = adapter.config?.power_house_id || '';
+
+        if (!this.genId || !this.houseId) {
+            this.adapter.log.info(
+                '[photovoltaicHelper] PV-IDs in der Instanz-Konfiguration fehlen. Überschusserkennung bleibt passiv.',
+            );
+        } else {
+            try {
+                this.adapter.subscribeForeignStates(this.genId);
+                this.adapter.subscribeForeignStates(this.houseId);
+                this.adapter.log.info(`[photovoltaicHelper] Subscribed: PV="${this.genId}", Haus="${this.houseId}"`);
+            } catch (err) {
+                this.adapter.log.warn(`[photovoltaicHelper] Konnte Foreign-States nicht abonnieren: ${err.message}`);
+            }
+        }
+
+        this.adapter.subscribeStates('photovoltaic.afterrun_min');
+        this.adapter.subscribeStates('photovoltaic.ignore_on_circulation');
+        this.adapter.subscribeStates('status.season_active');
+        this.adapter.subscribeStates('pump.mode');
+
+        this._safeRecalc('init');
+        this.adapter.log.info('[photovoltaicHelper] Initialisierung abgeschlossen.');
+    },
+
+    async handleStateChange(id, state) {
+        if (!state) {
+            return;
+        }
+        try {
+            if (this.genId && id === this.genId) {
+                await this._updateNumberState('photovoltaic.power_generated_w', Number(state.val) || 0);
+                await this._safeRecalc('foreign:pv');
+                return;
+            }
+            if (this.houseId && id === this.houseId) {
+                await this._updateNumberState('photovoltaic.power_house_w', Number(state.val) || 0);
+                await this._safeRecalc('foreign:house');
+                return;
+            }
+
+            if (id.endsWith('photovoltaic.afterrun_min')) {
+                this.adapter.log.debug(`[photovoltaicHelper] Nachlaufzeit geändert auf ${Number(state.val) || 0} min`);
+                return;
+            }
+            if (id.endsWith('photovoltaic.ignore_on_circulation')) {
+                this.adapter.log.debug(
+                    `[photovoltaicHelper] Flag "PV ignorieren bei Umwälzung erreicht" = ${!!state.val}`,
+                );
+                return;
+            }
+
+            if (id.endsWith('status.season_active') || id.endsWith('pump.mode')) {
+                await this._safeRecalc('mode/season');
+                return;
+            }
+        } catch (err) {
+            this.adapter.log.warn(`[photovoltaicHelper] Fehler in handleStateChange: ${err.message}`);
+        }
+    },
+
+    async _recalc(_sourceTag = '') {
+        const now = Date.now();
+        if (now - this._lastCalc < 250) {
+            return;
+        }
+        this._lastCalc = now;
+
+        const seasonActive = !!(await this.adapter.getStateAsync('status.season_active'))?.val;
+        const pumpMode = (await this.adapter.getStateAsync('pump.mode'))?.val || 'auto';
+
+        const gen = Number((await this.adapter.getStateAsync('photovoltaic.power_generated_w'))?.val ?? 0) || 0;
+        const house = Number((await this.adapter.getStateAsync('photovoltaic.power_house_w'))?.val ?? 0) || 0;
+
+        // Schwelle & Pumpenleistung
+        const thresholdState = Number((await this.adapter.getStateAsync('photovoltaic.threshold_w'))?.val ?? NaN);
+        const threshold = Number.isFinite(thresholdState)
+            ? thresholdState
+            : Number(this.adapter.config?.threshold_w || 200);
+
+        const pumpMax = Number((await this.adapter.getStateAsync('pump.pump_max_watt'))?.val ?? 0);
+
+        const afterrunMin = Math.max(
+            0,
+            Number((await this.adapter.getStateAsync('photovoltaic.afterrun_min'))?.val ?? 0) || 0,
+        );
+        const ignoreOnCirc = !!((await this.adapter.getStateAsync('photovoltaic.ignore_on_circulation'))?.val ?? false);
+
+        // SAFETY: Solarüberhitzungsschutz
+        try {
+            const collectorWarning = !!(await this.adapter.getStateAsync('solar.collector_warning'))?.val;
+            if (collectorWarning) {
+                this.adapter.log.warn(
+                    '[photovoltaicHelper] Kollektorüberhitzung erkannt → Pumpe ZWANGSEIN (Sicherheits-Override aktiv)',
+                );
+                return this._maybeStartPump('solar_overheat_protection');
+            }
+        } catch (err) {
+            this.adapter.log.warn(`[photovoltaicHelper] Fehler beim Prüfen der Solarüberhitzung: ${err.message}`);
+        }
+
+        // Überschussberechnung
+        const surplus = Math.max(0, gen - house);
+        await this._updateNumberState('photovoltaic.power_surplus_w', surplus);
+
+        // **NEU:** Einschaltlogik = Pumpenleistung + Sicherheitsaufschlag
+        const requiredPower = pumpMax + threshold;
+        const surplusActive = surplus >= requiredPower && seasonActive;
+        await this._updateBoolState('photovoltaic.surplus_active', surplusActive);
+
+        const txt = surplusActive
+            ? `Überschuss aktiv (${surplus} W ≥ ${pumpMax}+${threshold} W)`
+            : `Kein Überschuss (${surplus} W < ${pumpMax}+${threshold} W)`;
+        await this._updateStringState('photovoltaic.status_text', txt);
+        await this._updateStringState('photovoltaic.last_update', new Date().toISOString());
+
+        // Saison/Modus prüfen
+        if (!seasonActive) {
+            this.adapter.log.debug('[photovoltaicHelper] Saison inaktiv → keine PV-Schaltlogik.');
+            return this._maybeStopPump(false, 0, 'season_inactive');
+        }
+        if (pumpMode !== 'auto_pv') {
+            this.adapter.log.debug(
+                `[photovoltaicHelper] Pumpenmodus ist '${pumpMode}' ≠ 'auto_pv' → keine PV-Schaltlogik.`,
+            );
+            return this._maybeStopPump(false, 0, 'mode_not_auto_pv');
+        }
+
+        // Optional: Umwälzung erreicht?
+        if (ignoreOnCirc) {
+            try {
+                const remainingState = await this.adapter.getForeignStateAsync(
+                    'poolcontrol.0.circulation.daily_remaining',
+                );
+                const remaining = Number(remainingState?.val ?? NaN);
+                if (Number.isFinite(remaining) && remaining <= 0) {
+                    this.adapter.log.debug(
+                        `[photovoltaicHelper] Tagesumwälzung erreicht (daily_remaining = ${remaining}) → PV-Steuerung ignoriert.`,
+                    );
+                    return this._maybeStopPump(false, afterrunMin, 'circulation_reached');
+                }
+            } catch (err) {
+                this.adapter.log.debug(
+                    `[photovoltaicHelper] daily_remaining konnte nicht gelesen werden: ${err.message}`,
+                );
+            }
+        }
+
+        // Schaltlogik
+        if (surplusActive) {
+            return this._maybeStartPump('pv_surplus');
+        }
+        return this._maybeStopPump(false, afterrunMin, 'pv_ended_afterrun');
+    },
+
+    async _maybeStartPump(reason) {
+        if (this._desiredPump === true) {
+            return;
+        }
+        this._desiredPump = true;
+        if (this.afterrunTimer) {
+            clearTimeout(this.afterrunTimer);
+            this.afterrunTimer = null;
+        }
+        this._pvPumpHoldUntil = 0;
+        this.adapter.log.info(`[photovoltaicHelper] Pumpe EIN (Grund: ${reason})`);
+        await this._setPumpSwitch(true);
+    },
+
+    async _maybeStopPump(immediate, afterrunMin, tag) {
+        if (immediate || !afterrunMin || afterrunMin <= 0) {
+            if (this._desiredPump === false) {
+                return;
+            }
+            this._desiredPump = false;
+            this.adapter.log.info(`[photovoltaicHelper] Pumpe AUS (${tag}, ohne Nachlauf)`);
+            await this._setPumpSwitch(false);
+            return;
+        }
+
+        const holdMs = Math.round(afterrunMin * 60 * 1000);
+        this._pvPumpHoldUntil = Date.now() + holdMs;
+        if (this.afterrunTimer) {
+            clearTimeout(this.afterrunTimer);
+        }
+        this.afterrunTimer = setTimeout(async () => {
+            const active = !!(await this.adapter.getStateAsync('photovoltaic.surplus_active'))?.val;
+            if (active) {
+                this.adapter.log.debug('[photovoltaicHelper] Nachlauf abgebrochen – Überschuss wieder aktiv.');
+                return;
+            }
+            this._desiredPump = false;
+            this.adapter.log.info('[photovoltaicHelper] Pumpe AUS (Nachlauf beendet)');
+            await this._setPumpSwitch(false);
+        }, holdMs);
+        this.adapter.log.debug(`[photovoltaicHelper] Nachlauf gestartet: ${afterrunMin} min (${tag})`);
+    },
+
+    async _setPumpSwitch(on) {
+        try {
+            await this.adapter.setStateAsync('pump.pump_switch', { val: !!on, ack: false });
+        } catch (err) {
+            this.adapter.log.warn(`[photovoltaicHelper] Konnte pump.pump_switch nicht setzen: ${err.message}`);
+        }
+    },
+
+    async _updateNumberState(id, val) {
+        try {
+            await this.adapter.setStateAsync(id, { val: Number(val) || 0, ack: true });
+        } catch (e) {
+            this.adapter.log.warn(`[photovoltaicHelper] setNumber ${id} fehlgeschlagen: ${e.message}`);
+        }
+    },
+    async _updateBoolState(id, val) {
+        try {
+            await this.adapter.setStateAsync(id, { val: !!val, ack: true });
+        } catch (e) {
+            this.adapter.log.warn(`[photovoltaicHelper] setBool ${id} fehlgeschlagen: ${e.message}`);
+        }
+    },
+    async _updateStringState(id, val) {
+        try {
+            await this.adapter.setStateAsync(id, { val: String(val ?? ''), ack: true });
+        } catch (e) {
+            this.adapter.log.warn(`[photovoltaicHelper] setString ${id} fehlgeschlagen: ${e.message}`);
+        }
+    },
+
+    async _safeRecalc(tag) {
+        try {
+            await this._recalc(tag);
+        } catch (err) {
+            this.adapter.log.warn(`[photovoltaicHelper] Recalc-Fehler (${tag}): ${err.message}`);
+        }
+    },
+
+    cleanup() {
+        if (this.afterrunTimer) {
+            clearTimeout(this.afterrunTimer);
+            this.afterrunTimer = null;
+        }
+        this._pvPumpHoldUntil = 0;
+        this._desiredPump = null;
+    },
+};
+
+module.exports = photovoltaicHelper;

package/lib/stateDefinitions/controlStates.js

@@ -151,10 +151,16 @@ async function createControlStates(adapter) {
                 role: 'date',
                 read: true,
                 write: false,
+                persist: true,
             },
             native: {},
         });
-        await adapter.setStateAsync('control.pump.backwash_last_date', { val: '', ack: true });
+
+        // 🟢 Überinstallationsschutz – nur schreiben, wenn kein Wert existiert
+        const existingLastDate = await adapter.getStateAsync('control.pump.backwash_last_date');
+        if (existingLastDate === null || existingLastDate.val === null || existingLastDate.val === undefined) {
+            await adapter.setStateAsync('control.pump.backwash_last_date', { val: '', ack: true });
+        }
 
         await adapter.setObjectNotExistsAsync('control.pump.backwash_required', {
             type: 'state',

package/lib/stateDefinitions/photovoltaicStates.js

@@ -0,0 +1,161 @@
+'use strict';
+
+/**
+ * createPhotovoltaicStates(adapter)
+ * -------------------------------------------------------------
+ * Legt alle States für den Photovoltaik-Bereich an.
+ * - persistente States
+ * - überinstallationsgeschützt (keine Überschreibung vorhandener Werte)
+ * - konsistent im Stil der übrigen State-Dateien
+ * -------------------------------------------------------------
+ */
+
+/**
+ * @param {object} adapter - ioBroker Adapterinstanz
+ * @returns {Promise<void>}
+ */
+async function createPhotovoltaicStates(adapter) {
+    adapter.log.debug('[createPhotovoltaicStates] Initialisierung gestartet.');
+
+    // --- Photovoltaik-Hauptordner ---
+    await adapter.setObjectNotExistsAsync('photovoltaic', {
+        type: 'channel',
+        common: { name: 'Photovoltaik (Überschusserkennung)' },
+        native: {},
+    });
+
+    // --- State-Liste ---
+    const states = [
+        {
+            id: 'power_generated_w',
+            name: 'PV-Erzeugungsleistung (W)',
+            desc: 'Aktuell erzeugte Leistung der PV-Anlage in Watt',
+            type: 'number',
+            role: 'value.power',
+            unit: 'W',
+            read: true,
+            write: false,
+            def: 0,
+        },
+        {
+            id: 'power_house_w',
+            name: 'Hausverbrauch (W)',
+            desc: 'Aktueller Stromverbrauch des Hauses in Watt',
+            type: 'number',
+            role: 'value.power',
+            unit: 'W',
+            read: true,
+            write: false,
+            def: 0,
+        },
+        {
+            id: 'power_surplus_w',
+            name: 'PV-Überschussleistung (W)',
+            desc: 'Berechneter Überschuss zwischen PV-Erzeugung und Hausverbrauch',
+            type: 'number',
+            role: 'value.power',
+            unit: 'W',
+            read: true,
+            write: false,
+            def: 0,
+        },
+        {
+            id: 'surplus_active',
+            name: 'PV-Überschuss aktiv',
+            desc: 'Zeigt an, ob aktuell ein PV-Überschuss vorliegt (true/false)',
+            type: 'boolean',
+            role: 'indicator',
+            read: true,
+            write: false,
+            def: false,
+        },
+        {
+            id: 'afterrun_min',
+            name: 'Nachlaufzeit (Minuten)',
+            desc: 'Dauer, wie lange die Pumpe nach Ende des PV-Überschusses weiterläuft',
+            type: 'number',
+            role: 'level',
+            unit: 'min',
+            read: true,
+            write: true,
+            def: 2,
+        },
+        {
+            id: 'ignore_on_circulation',
+            name: 'PV ignorieren, wenn Umwälzmenge erreicht',
+            desc: 'Wenn aktiviert, wird PV-Steuerung deaktiviert, sobald Tagesumwälzung erfüllt ist',
+            type: 'boolean',
+            role: 'switch.enable',
+            read: true,
+            write: true,
+            def: false,
+        },
+        {
+            id: 'threshold_w',
+            name: 'Schwellwert für PV-Überschuss (W)',
+            desc: 'Watt-Schwelle, ab der ein Überschuss erkannt wird',
+            type: 'number',
+            role: 'value',
+            unit: 'W',
+            read: true,
+            write: false,
+            def: 200,
+        },
+        {
+            id: 'status_text',
+            name: 'Statusmeldung (Text)',
+            desc: 'Klartextstatus der PV-Erkennung (z. B. Überschuss aktiv)',
+            type: 'string',
+            role: 'text',
+            read: true,
+            write: false,
+            def: '',
+        },
+        {
+            id: 'last_update',
+            name: 'Letzte Aktualisierung',
+            desc: 'Zeitstempel der letzten Berechnung der PV-Werte',
+            type: 'string',
+            role: 'date',
+            read: true,
+            write: false,
+            def: '',
+        },
+    ];
+
+    // --- States anlegen ---
+    for (const s of states) {
+        const id = `photovoltaic.${s.id}`;
+
+        await adapter.setObjectNotExistsAsync(id, {
+            type: 'state',
+            common: {
+                name: s.name,
+                desc: s.desc,
+                type: s.type,
+                role: s.role,
+                read: s.read,
+                write: s.write,
+                def: s.def,
+                unit: s.unit || '',
+                persist: true,
+            },
+            native: {},
+        });
+
+        // Überinstallationsschutz
+        const existing = await adapter.getStateAsync(id);
+        if (existing === null || existing === undefined) {
+            await adapter.setStateAsync(id, { val: s.def, ack: true });
+            adapter.log.debug(
+                `[createPhotovoltaicStates] Neuer State '${id}' initialisiert mit Default-Wert ${s.def}.`,
+            );
+        } else {
+            adapter.log.debug(`[createPhotovoltaicStates] State '${id}' bereits vorhanden – Wert bleibt erhalten.`);
+        }
+    }
+
+    adapter.log.info('[createPhotovoltaicStates] Initialisierung abgeschlossen.');
+}
+
+module.exports = { createPhotovoltaicStates };

package/lib/stateDefinitions/pumpStates.js

@@ -110,6 +110,7 @@ async function createPumpStates(adapter) {
             persist: true, // NEU: dauerhaft speichern
             states: {
                 auto: 'Automatik',
+                auto_pv: 'Automatik (PV)',
                 manual: 'Manuell',
                 off: 'Aus',
                 time: 'Zeit',

package/main.js

@@ -19,6 +19,7 @@ const consumptionHelper = require('./lib/helpers/consumptionHelper');
 const solarHelper = require('./lib/helpers/solarHelper');
 const frostHelper = require('./lib/helpers/frostHelper');
 const statusHelper = require('./lib/helpers/statusHelper');
+const photovoltaicHelper = require('./lib/helpers/photovoltaicHelper');
 const controlHelper = require('./lib/helpers/controlHelper');
 const controlHelper2 = require('./lib/helpers/controlHelper2');
 const debugLogHelper = require('./lib/helpers/debugLogHelper');
@@ -29,6 +30,7 @@ const { createPumpStates } = require('./lib/stateDefinitions/pumpStates');
 const { createPumpStates2 } = require('./lib/stateDefinitions/pumpStates2');
 const { createPumpStates3 } = require('./lib/stateDefinitions/pumpStates3');
 const { createSolarStates } = require('./lib/stateDefinitions/solarStates');
+const { createPhotovoltaicStates } = require('./lib/stateDefinitions/photovoltaicStates');
 const { createGeneralStates } = require('./lib/stateDefinitions/generalStates');
 const { createTimeStates } = require('./lib/stateDefinitions/timeStates');
 const { createRuntimeStates } = require('./lib/stateDefinitions/runtimeStates');
@@ -67,6 +69,9 @@ class Poolcontrol extends utils.Adapter {
         // --- Solarverwaltung ---
         await createSolarStates(this);
 
+        // --- Photovoltaik ---
+        await createPhotovoltaicStates(this);
+
         // --- Zeitsteuerung ---
         await createTimeStates(this);
 
@@ -113,6 +118,7 @@ class Poolcontrol extends utils.Adapter {
         speechHelper.init(this);
         consumptionHelper.init(this);
         solarHelper.init(this);
+        photovoltaicHelper.init(this);
         frostHelper.init(this);
         statusHelper.init(this);
         controlHelper.init(this);
@@ -225,6 +231,11 @@ class Poolcontrol extends utils.Adapter {
         } catch (e) {
             this.log.warn(`[consumptionHelper] Fehler in handleStateChange: ${e.message}`);
         }
+        try {
+            photovoltaicHelper.handleStateChange(id, state);
+        } catch (e) {
+            this.log.warn(`[photovoltaicHelper] Fehler in handleStateChange: ${e.message}`);
+        }
         try {
             statusHelper.handleStateChange(id, state);
         } catch (e) {
@@ -242,6 +253,17 @@ class Poolcontrol extends utils.Adapter {
             controlHelper2.handleStateChange(id, state);
         }
 
+        // --- Photovoltaik-Parameter ---
+        if (id.endsWith('photovoltaic.afterrun_min')) {
+            this.log.debug(`[onStateChange] Nachlaufzeit (PV) geändert auf ${state.val} Minuten`);
+            this.config.pv_afterrun_min = Number(state.val);
+        }
+
+        if (id.endsWith('photovoltaic.ignore_on_circulation')) {
+            this.log.debug(`[onStateChange] PV-Logik ignorieren bei Umwälzmenge = ${state.val}`);
+            this.config.pv_ignore_on_circulation = !!state.val;
+        }
+
         await debugLogHelper.handleStateChange(id, state);
     }
 }

package/package.json

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