iobroker.poolcontrol 1.3.31 → 1.3.33

package/README.md

@@ -36,6 +36,7 @@ It provides automation for pumps, heating, solar and photovoltaic control as wel
 
 - **Solar Control**
   - Collector on/off thresholds with hysteresis
+  - Live collector-surface delta for dashboards and scripts
   - Collector warning threshold
   - Optional speech output for warnings
   - Automatic reset logic
@@ -43,10 +44,12 @@ It provides automation for pumps, heating, solar and photovoltaic control as wel
 - **Solar Extended**
   - Separate control for external solar actuators
   - Delta on/off thresholds
+  - Live collector-pool reference delta for dashboards and scripts
   - Maximum pool temperature limits
   - Diagnostic and reason states
   - Priority and block logic
   - Status section under `solar.extended.*`
+  - Runtime changes to `solar.extended.pool_temperature_source` are applied automatically; because Solar Extended uses a cyclic check interval, calculation, control logic, and `solar.extended.collector_pool_reference_delta` may take up to approximately 60 seconds to update.
 
 - **Photovoltaic Control**
   - Pump control based on PV surplus and household consumption
@@ -271,6 +274,20 @@ New features are added regularly – please refer to the changelog.
 ---
 
 ## Changelog
+### 1.3.33 (2026-06-18)
+
+- Added live delta states for standard solar and Solar Extended control:
+  - `solar.collector_surface_delta`
+  - `solar.extended.collector_pool_reference_delta`
+- Documented that runtime changes to `solar.extended.pool_temperature_source` are applied automatically, but may take up to approximately 60 seconds due to the Solar Extended cyclic check interval.
+
+### 1.3.32 (2026-06-08)
+
+- Added circulation plausibility diagnostics for daily circulation calculations.
+- Added detection of implausible pump power values, flow rates and daily circulation volume jumps.
+- Added detailed diagnostic states under `circulation.plausibility` for troubleshooting and analysis.
+- Improved diagnostics for circulation calculations without changing existing pump, PV or solar control logic.
+
 ### 1.3.31 (2026-06-07)
 
 - Fixed automatic circulation top-up logic when temperature sensors are missing. Automatic top-up is now only blocked by collector/pool temperature comparison when solar control is active and both temperatures are valid.
@@ -289,22 +306,6 @@ New features are added regularly – please refer to the changelog.
 - Fixed missing initialization of season and solar warning runtime states from adapter configuration.
 - Added admin UI information about initial configuration values and runtime datapoint control.
 
-### 1.3.28 (2026-06-03)
-
-- Added configurable startup power check timeout for pump monitoring (`pump.startup_power_check_timeout_sec`).
-- Default behavior remains unchanged (5 seconds).
-- Improved compatibility with delayed power measurements from smart plugs and power meters.
-
-### 1.3.27 (2026-05-30)
-
-- Added new Chemistry Tools section
-- Added pH Plus Calculator
-- Added pH Minus Calculator
-- Added Salt Calculator
-- Added validation, result texts and error handling for all calculators
-- Added automatic pool volume prefill support
-- Expanded documentation and function overviews
-
 ## Archived Release History
 
 For older releases and archived version history see:

package/io-package.json

@@ -1,8 +1,34 @@
 {
   "common": {
     "name": "poolcontrol",
-    "version": "1.3.31",
+    "version": "1.3.33",
     "news": {
+      "1.3.33": {
+        "en": "Added live delta states for standard solar and Solar Extended control. Documented Solar Extended pool reference runtime update behavior.",
+        "de": "Live-Delta-Datenpunkte für Standard-Solar und Solar Extended ergänzt. Laufzeitverhalten der Solar-Extended-Poolreferenz dokumentiert.",
+        "ru": "Добавлены дельта-состояния в реальном времени для стандартного и расширенного управления солнечной энергией. Документированное поведение обновления во время выполнения ссылки на расширенный пул Solar.",
+        "pt": "Adicionados estados delta ao vivo para controle solar padrão e solar estendido. Comportamento de atualização de tempo de execução de referência do pool Solar Extended documentado.",
+        "nl": "Live deltatoestanden toegevoegd voor standaard zonne-energie en Solar Extended-regeling. Gedocumenteerd runtime-updategedrag van de Solar Extended-poolreferentie.",
+        "fr": "Ajout d'états delta en direct pour le contrôle solaire standard et solaire étendu. Comportement documenté de la mise à jour du runtime de référence du pool Solar Extended.",
+        "it": "Aggiunti stati delta live per il controllo solare standard e Solar Extended. Comportamento documentato dell'aggiornamento runtime di riferimento del pool Solar Extended.",
+        "es": "Se agregaron estados delta en vivo para control solar estándar y solar extendido. Comportamiento de actualización del tiempo de ejecución de referencia del grupo Solar Extended documentado.",
+        "pl": "Dodano stany delta na żywo dla standardowego sterowania solarnego i Solar Extended. Udokumentowane zachowanie aktualizacji środowiska uruchomieniowego referencyjnej puli Solar Extended.",
+        "uk": "Додано живі дельта-стани для стандартного сонячного та розширеного керування Solar. Задокументована поведінка оновлення середовища виконання довідкового пулу Solar Extended.",
+        "zh-cn": "为标准太阳能和太阳能扩展控制添加了实时增量状态。记录了 Solar Extended 池参考运行时更新行为。"
+      },
+      "1.3.32": {
+        "en": "Added circulation plausibility diagnostics. New checks detect implausible pump power, flow rates, and daily circulation jumps. Added detailed diagnostic states under circulation.plausibility to simplify troubleshooting and analysis of circulation calculations.",
+        "de": "Plausibilitätsdiagnose für die Umwälzberechnung hinzugefügt. Neue Prüfungen erkennen unplausible Pumpenleistungen, Durchflusswerte und Sprünge der Tagesumwälzung. Detaillierte Diagnose-States unter circulation.plausibility erleichtern die Fehlersuche und Analyse der Umwälzberechnung.",
+        "ru": "Добавлена ​​диагностика достоверности циркуляции. Новые проверки выявляют неправдоподобную мощность насоса, скорость потока и скачки суточной циркуляции. Добавлены подробные диагностические состояния в разделе «циркуляция.достоверность» для упрощения поиска и устранения неисправностей и анализа расчетов циркуляции.",
+        "pt": "Adicionados diagnósticos de plausibilidade de circulação. Novas verificações detectam potências de bomba, taxas de fluxo e saltos diários de circulação implausíveis. Adicionados estados de diagnóstico detalhados em circulação.plausibilidade para simplificar a solução de problemas e a análise de cálculos de circulação.",
+        "nl": "Diagnostiek van circulatieplausibiliteit toegevoegd. Nieuwe controles detecteren onwaarschijnlijk pompvermogen, debieten en dagelijkse circulatiesprongen. Gedetailleerde diagnostische statussen toegevoegd onder circulatie.plausibiliteit om probleemoplossing en analyse van circulatieberekeningen te vereenvoudigen.",
+        "fr": "Ajout de diagnostics de plausibilité de la circulation. De nouveaux contrôles détectent une puissance de pompe, des débits et des sauts de circulation quotidiens invraisemblables. Ajout d'états de diagnostic détaillés sous circulation.plausibilité pour simplifier le dépannage et l'analyse des calculs de circulation.",
+        "it": "Aggiunta diagnostica di plausibilità della circolazione. Nuovi controlli rilevano potenza della pompa, portate e salti di circolazione giornalieri non plausibili. Aggiunti stati diagnostici dettagliati in circolazione.plausibilità per semplificare la risoluzione dei problemi e l'analisi dei calcoli della circolazione.",
+        "es": "Se agregaron diagnósticos de plausibilidad de circulación. Las nuevas comprobaciones detectan potencias de bombeo, caudales y saltos diarios de circulación inverosímiles. Se agregaron estados de diagnóstico detallados bajo circulación. Plausibilidad para simplificar la resolución de problemas y el análisis de los cálculos de circulación.",
+        "pl": "Dodano diagnostykę wiarygodności obiegu. Nowe kontrole wykrywają nieprawdopodobną moc pompy, natężenie przepływu i codzienne skoki cyrkulacji. Dodano szczegółowe stany diagnostyczne w obszarze cyrkulacja.wiarygodność, aby uprościć rozwiązywanie problemów i analizę obliczeń cyrkulacji.",
+        "uk": "Додана діагностика вірогідності циркуляції. Нові перевірки виявляють неправдоподібну потужність насоса, швидкість потоку та щоденні стрибки циркуляції. Додано детальні діагностичні стани під циркуляцією. Правдоподібність для спрощення пошуку несправностей і аналізу розрахунків циркуляції.",
+        "zh-cn": "添加了循环合理性诊断。新的检查可以检测到难以置信的泵功率、流量和每日循环跳跃。在循环下添加了详细的诊断状态。合理性以简化循环计算的故障排除和分析。"
+      },
       "1.3.31": {
         "en": "Fixed automatic circulation top-up logic when temperature sensors are missing. Automatic top-up is now only blocked by collector/pool temperature comparison when solar control is active and both temperatures are valid.",
         "de": "Fehler in der automatischen Nachpump-Logik bei fehlenden Temperatursensoren behoben. Das automatische Nachpumpen wird jetzt nur noch durch den Kollektor-/Pooltemperaturvergleich blockiert, wenn die Solarsteuerung aktiv ist und beide Temperaturwerte gültig vorliegen.",
@@ -41,32 +67,6 @@
         "pl": "Dodano usługę Pool Insights V1 z obserwacjami, oceną stanu i obsługą środowiska wykonawczego i18n. Ulepszone generowanie tekstu Pool Insights i usunięta zależność od zewnętrznych bloków podsumowań. Naprawiono brakującą inicjalizację stanów wykonawczych sezonu i ostrzeżenia słonecznego z konfiguracji adaptera. Dodano uwagi do interfejsu administratora wyjaśniające wartości początkowe w porównaniu z kontrolą punktów danych w czasie wykonywania.",
         "uk": "Додано Pool Insights V1 із спостереженнями, оцінкою стану та підтримкою i18n під час виконання. Покращено створення тексту Pool Insights і видалено залежність від зовнішніх блоків підсумків. Виправлено відсутність ініціалізації сезону та станів попередження про сонячне світло з конфігурації адаптера. Додано примітки інтерфейсу користувача адміністратора, що пояснюють початкові значення та керування точкою даних під час виконання.",
         "zh-cn": "添加了 Pool Insights V1，具有观察、状态评估和运行时 i18n 支持。改进了 Pool Insights 文本生成并消除了对外部摘要块的依赖。修复了适配器配置中缺少季节和太阳警告运行时状态初始化的问题。添加了管理 UI 注释，解释初始值与运行时数据点控制。"
-      },
-      "1.3.28": {
-        "en": "Added configurable startup power check timeout for pump monitoring (5-10 seconds). Improved compatibility with delayed power measurements from smart plugs and power meters.",
-        "de": "Konfigurierbares Timeout für die Leistungsprüfung nach Pumpenstart (5-10 Sekunden) hinzugefügt. Kompatibilität mit verzögert aktualisierten Leistungswerten von Smart-Steckdosen und Leistungsmessern verbessert.",
-        "ru": "Добавлен настраиваемый тайм-аут проверки мощности при запуске для мониторинга насоса (5–10 секунд). Улучшена совместимость с измерениями мощности с задержкой от интеллектуальных розеток и измерителей мощности.",
-        "pt": "Adicionado tempo limite de verificação de energia de inicialização configurável para monitoramento da bomba (5 a 10 segundos). Compatibilidade aprimorada com medições de energia atrasadas de plugues inteligentes e medidores de energia.",
-        "nl": "Configureerbare time-out voor stroomcontrole bij opstarten toegevoegd voor pompbewaking (5-10 seconden). Verbeterde compatibiliteit met vertraagde stroommetingen van slimme stekkers en stroommeters.",
-        "fr": "Ajout d'un délai d'expiration configurable pour la vérification de l'alimentation au démarrage pour la surveillance de la pompe (5 à 10 secondes). Compatibilité améliorée avec les mesures de puissance retardées des prises intelligentes et des compteurs de puissance.",
-        "it": "Aggiunto timeout configurabile del controllo dell'alimentazione all'avvio per il monitoraggio della pompa (5-10 secondi). Compatibilità migliorata con misurazioni di potenza ritardate da prese intelligenti e misuratori di potenza.",
-        "es": "Se agregó un tiempo de espera de verificación de energía de inicio configurable para el monitoreo de la bomba (5-10 segundos). Compatibilidad mejorada con mediciones de potencia retrasadas de enchufes inteligentes y medidores de potencia.",
-        "pl": "Dodano konfigurowalny limit czasu sprawdzania mocy rozruchowej dla monitorowania pompy (5-10 sekund). Poprawiona kompatybilność z opóźnionymi pomiarami mocy z inteligentnych wtyczek i mierników mocy.",
-        "uk": "Додано настроюваний тайм-аут перевірки живлення при запуску для моніторингу насоса (5-10 секунд). Покращена сумісність із затримкою вимірювання потужності від розумних розеток і лічильників.",
-        "zh-cn": "添加了用于泵监控的可配置启动电源检查超时（5-10 秒）。改进了与智能插头和功率计的延迟功率测量的兼容性。"
-      },
-      "1.3.27": {
-        "en": "Added new Chemistry Tools with pH Plus Calculator, pH Minus Calculator and Salt Calculator. Added validation, result texts, error handling and automatic pool volume prefill. Expanded documentation and function overviews.",
-        "de": "Neuen Bereich Chemistry Tools mit pH-Plus-Rechner, pH-Minus-Rechner und Salz-Rechner hinzugefügt. Validierungen, Ergebnistexte, Fehlerbehandlung und automatische Vorbelegung des Poolvolumens ergänzt. Dokumentation und Funktionsübersichten erweitert.",
-        "ru": "Добавлены новые химические инструменты с калькулятором pH плюс, калькулятором pH минус и калькулятором соли. Добавлена ​​проверка, тексты результатов, обработка ошибок и автоматическое предварительное заполнение объема пула. Расширенная документация и обзоры функций.",
-        "pt": "Adicionadas novas ferramentas de química com calculadora pH Plus, calculadora pH menos e calculadora de sal. Adicionados validação, textos de resultados, tratamento de erros e preenchimento automático do volume do pool. Documentação expandida e visões gerais de funções.",
-        "nl": "Nieuwe chemiehulpmiddelen toegevoegd met pH Plus-calculator, pH-minuscalculator en Zoutcalculator. Validatie, resultaatteksten, foutafhandeling en automatisch vooraf invullen van poolvolumes toegevoegd. Uitgebreide documentatie en functieoverzichten.",
-        "fr": "Ajout de nouveaux outils de chimie avec calculateur de pH Plus, calculateur de pH Moins et calculateur de sel. Ajout de la validation, des textes de résultats, de la gestion des erreurs et du pré-remplissage automatique du volume du pool. Documentation étendue et aperçus des fonctions.",
-        "it": "Aggiunti nuovi strumenti di chimica con calcolatore di pH più, calcolatore di pH meno e calcolatore di sale. Aggiunta convalida, testi dei risultati, gestione degli errori e precompilazione automatica del volume del pool. Documentazione estesa e panoramiche delle funzioni.",
-        "es": "Se agregaron nuevas herramientas de química con calculadora de pH Plus, calculadora de pH Minus y calculadora de sal. Se agregó validación, textos de resultados, manejo de errores y precarga automática del volumen del grupo. Documentación ampliada y descripciones generales de funciones.",
-        "pl": "Dodano nowe narzędzia chemiczne z kalkulatorem pH Plus, kalkulatorem pH Minus i kalkulatorem soli. Dodano weryfikację, teksty wyników, obsługę błędów i automatyczne wstępne wypełnianie objętości puli. Rozszerzona dokumentacja i przeglądy funkcji.",
-        "uk": "Додано нові хімічні інструменти з калькулятором pH Plus, калькулятором pH мінус і калькулятором солі. Додано перевірку, тексти результатів, обробку помилок і автоматичне попереднє заповнення обсягу пулу. Розширена документація та огляд функцій.",
-        "zh-cn": "添加了新的化学工具，包括 pH 加计算器、pH 减计算器和盐计算器。添加了验证、结果文本、错误处理和自动池容量预填充。扩展的文档和功能概述。"
       }
     },
     "titleLang": {

package/lib/helpers/runtimeHelper.js

@@ -22,6 +22,8 @@ const runtimeHelper = {
     resetTimer: null,
     liveTimer: null, // Timer für Live-Updates
     syncTimer: null, // FIX: Timer zur Selbstheilung bei verpasstem Pumpenstart/-stopp
+    lastPlausibilityDailyTotal: null,
+    lastPlausibilityCheckTs: null,
 
     /**
      * Initialisiert den Runtime-Helper.
@@ -236,9 +238,21 @@ const runtimeHelper = {
 
             // Umwälzmenge berechnen
             // Reeller Durchflusswert aus pump.live.flow_current_lh
-            const liveFlowLh = (await this.adapter.getStateAsync('pump.live.flow_current_lh'))?.val || 0;
+            const liveFlowLh = Number((await this.adapter.getStateAsync('pump.live.flow_current_lh'))?.val || 0);
+
+            // Bestehende Werte für Total/Remaining laden
+            const oldTotal = Number((await this.adapter.getStateAsync('circulation.daily_total'))?.val || 0);
+            const oldRemaining = Number((await this.adapter.getStateAsync('circulation.daily_remaining'))?.val || 0);
 
             if (liveFlowLh <= 0) {
+                await this._updateCirculationPlausibility({
+                    dailyTotal: oldTotal,
+                    oldTotal,
+                    liveFlowLh,
+                    dailyRequired,
+                    effectiveToday,
+                    currentSessionSeconds,
+                });
                 this.adapter.log.debug('[runtimeHelper] No live flow value available, calculation skipped');
                 return;
             }
@@ -247,9 +261,14 @@ const runtimeHelper = {
             const dailyTotal = Math.round((effectiveToday / 3600) * liveFlowLh);
             const dailyRemaining = Math.max(dailyRequired - dailyTotal, 0);
 
-            // Bestehende Werte für Total/Remaining laden
-            const oldTotal = (await this.adapter.getStateAsync('circulation.daily_total'))?.val || 0;
-            const oldRemaining = (await this.adapter.getStateAsync('circulation.daily_remaining'))?.val || 0;
+            await this._updateCirculationPlausibility({
+                dailyTotal,
+                oldTotal,
+                liveFlowLh,
+                dailyRequired,
+                effectiveToday,
+                currentSessionSeconds,
+            });
 
             // Nur schreiben, wenn tatsächlich sinnvolle Livewerte vorliegen
             if (liveFlowLh > 0 && dailyTotal > 0) {
@@ -268,6 +287,152 @@ const runtimeHelper = {
         }
     },
 
+    async _updateCirculationPlausibility({
+        dailyTotal,
+        oldTotal,
+        liveFlowLh,
+        dailyRequired,
+        effectiveToday,
+        currentSessionSeconds,
+    }) {
+        try {
+            const nowMs = Date.now();
+            const nowIso = new Date(nowMs).toISOString();
+            const readNumber = async id => {
+                const value = Number((await this.adapter.getStateAsync(id))?.val);
+                return Number.isFinite(value) ? value : 0;
+            };
+            const write = (id, val) => this.adapter.setStateAsync(`circulation.plausibility.${id}`, { val, ack: true });
+
+            const enabledState = await this.adapter.getStateAsync('circulation.plausibility.000_enabled');
+            const plausibilityEnabled = enabledState?.val === false ? false : true;
+
+            const currentPower = await readNumber('pump.current_power');
+            const pumpMaxWatt = await readNumber('pump.pump_max_watt');
+            const pumpPowerLph = await readNumber('pump.pump_power_lph');
+            const flowValue = Number.isFinite(Number(liveFlowLh)) ? Number(liveFlowLh) : 0;
+            const flowAvailable = flowValue > 0;
+            const currentTotal = Number.isFinite(Number(dailyTotal)) ? Number(dailyTotal) : 0;
+            const previousTotal =
+                this.lastPlausibilityDailyTotal === null ? Number(oldTotal) || 0 : this.lastPlausibilityDailyTotal;
+
+            if (!plausibilityEnabled) {
+                await write('00_status', 'disabled');
+                await write('01_level', 'info');
+                await write('02_message_key', 'circulation_plausibility_disabled');
+                await write('03_last_update', nowIso);
+                await write('10_power_warning', false);
+                await write('20_flow_warning', false);
+                await write('30_jump_warning', false);
+                await write('40_last_daily_total', previousTotal);
+                await write('41_current_daily_total', currentTotal);
+                await write('42_delta_liters', 0);
+                await write('43_elapsed_seconds', 0);
+                await write('44_max_plausible_delta_liters', 0);
+
+                this.lastPlausibilityDailyTotal = currentTotal;
+                this.lastPlausibilityCheckTs = nowMs;
+                return;
+            }
+
+            const powerLimit = pumpMaxWatt > 0 ? pumpMaxWatt * 1.2 : 0;
+            const flowLimit = pumpPowerLph > 0 ? pumpPowerLph * 1.2 : 0;
+            let powerWarning = currentPower > 0 && powerLimit > 0 && currentPower > powerLimit;
+            let flowWarning = flowAvailable && flowLimit > 0 && flowValue > flowLimit;
+
+            let elapsedSeconds = 0;
+            let deltaLiters = 0;
+            let maxPlausibleDelta = 0;
+            let jumpWarning = false;
+            const hasPreviousCheck = this.lastPlausibilityCheckTs !== null && this.lastPlausibilityDailyTotal !== null;
+
+            if (hasPreviousCheck) {
+                elapsedSeconds = Math.max(0, Math.round((nowMs - this.lastPlausibilityCheckTs) / 1000));
+                deltaLiters = Math.max(0, currentTotal - this.lastPlausibilityDailyTotal);
+
+                if (elapsedSeconds > 0 && elapsedSeconds <= 3600 && pumpPowerLph > 0) {
+                    maxPlausibleDelta = (pumpPowerLph * 1.5 * elapsedSeconds) / 3600;
+                    jumpWarning = deltaLiters > maxPlausibleDelta;
+                }
+            }
+
+            if (!flowAvailable) {
+                flowWarning = false;
+                jumpWarning = false;
+            }
+
+            const warningCount = [powerWarning, flowWarning, jumpWarning].filter(Boolean).length;
+            let status = 'ok';
+            let level = 'ok';
+            let messageKey = 'circulation_plausibility_ok';
+
+            if (warningCount > 0) {
+                status = 'warning';
+                level = 'warning';
+                if (warningCount > 1) {
+                    messageKey = 'circulation_plausibility_multiple_warnings';
+                } else if (powerWarning) {
+                    messageKey = 'circulation_plausibility_power_warning';
+                } else if (flowWarning) {
+                    messageKey = 'circulation_plausibility_flow_warning';
+                } else {
+                    messageKey = 'circulation_plausibility_daily_total_jump_warning';
+                }
+            } else if (!flowAvailable) {
+                status = 'unchecked';
+                level = 'info';
+                messageKey = 'circulation_plausibility_no_flow';
+            }
+
+            await write('00_status', status);
+            await write('01_level', level);
+            await write('02_message_key', messageKey);
+            await write('03_last_update', nowIso);
+            await write('10_power_warning', powerWarning);
+            await write('11_power_value_w', currentPower > 0 ? currentPower : 0);
+            await write('12_power_limit_w', powerLimit > 0 ? powerLimit : 0);
+            await write('20_flow_warning', flowWarning);
+            await write('21_flow_value_lh', flowAvailable ? flowValue : 0);
+            await write('22_flow_limit_lh', flowLimit > 0 ? flowLimit : 0);
+            await write('24_flow_available', flowAvailable);
+            await write('30_jump_warning', jumpWarning);
+            await write('31_jump_value_liters', deltaLiters);
+            await write('32_jump_limit_liters', maxPlausibleDelta);
+            await write('40_last_daily_total', previousTotal);
+            await write('41_current_daily_total', currentTotal);
+            await write('42_delta_liters', deltaLiters);
+            await write('43_elapsed_seconds', elapsedSeconds);
+            await write('44_max_plausible_delta_liters', maxPlausibleDelta);
+
+            if (powerWarning) {
+                await write('13_power_warning_at', nowIso);
+            }
+            if (flowWarning) {
+                await write('23_flow_warning_at', nowIso);
+            }
+            if (jumpWarning) {
+                await write('33_jump_warning_at', nowIso);
+            }
+
+            this.lastPlausibilityDailyTotal = currentTotal;
+            this.lastPlausibilityCheckTs = nowMs;
+
+            if (warningCount > 0) {
+                this.adapter.log.warn(
+                    `[runtimeHelper] Circulation plausibility warning: power=${powerWarning}, flow=${flowWarning}, jump=${jumpWarning}, dailyTotal=${currentTotal}, delta=${deltaLiters}, maxDelta=${maxPlausibleDelta}`,
+                );
+            } else {
+                this.adapter.log.debug(
+                    `[runtimeHelper] Circulation plausibility updated (status=${status}, dailyTotal=${currentTotal}, flow=${flowValue}, required=${dailyRequired}, effectiveToday=${effectiveToday}, currentSession=${currentSessionSeconds})`,
+                );
+            }
+        } catch (err) {
+            this.adapter.log.warn(
+                `[runtimeHelper] Error while updating circulation plausibility states: ${err.message}`,
+            );
+        }
+    },
+
     _formatTime(seconds) {
         seconds = Math.max(0, Math.floor(seconds));
         const h = Math.floor(seconds / 3600);
@@ -351,6 +516,17 @@ const runtimeHelper = {
             this.runtimeToday = 0;
             this.startCountToday = 0;
             this.lastOn = this.isRunning ? Date.now() : null;
+            this.lastPlausibilityDailyTotal = 0;
+            this.lastPlausibilityCheckTs = Date.now();
+
+            await this.adapter.setStateAsync('circulation.plausibility.40_last_daily_total', { val: 0, ack: true });
+            await this.adapter.setStateAsync('circulation.plausibility.41_current_daily_total', { val: 0, ack: true });
+            await this.adapter.setStateAsync('circulation.plausibility.42_delta_liters', { val: 0, ack: true });
+            await this.adapter.setStateAsync('circulation.plausibility.43_elapsed_seconds', { val: 0, ack: true });
+            await this.adapter.setStateAsync('circulation.plausibility.44_max_plausible_delta_liters', {
+                val: 0,
+                ack: true,
+            });
 
             // Laufzeiten zurücksetzen
             await this._updateStates();

package/lib/helpers/solarExtendedHelper.js

@@ -69,6 +69,35 @@ const solarExtendedHelper = {
             const isTimePriority = activeHelper === 'timeHelper';
             const actorConfigOk = controlObjectId !== '' && (controlType === 'boolean' || controlType === 'socket');
 
+            const poolReferenceStateId =
+                poolTemperatureSource === 'ground'
+                    ? 'temperature.ground.current'
+                    : poolTemperatureSource === 'surface'
+                      ? 'temperature.surface.current'
+                      : '';
+            const collectorDeltaState = await this.adapter.getStateAsync('temperature.collector.current');
+            const poolReferenceDeltaState = poolReferenceStateId
+                ? await this.adapter.getStateAsync(poolReferenceStateId)
+                : null;
+            const collectorDeltaValue = collectorDeltaState?.val;
+            const poolReferenceDeltaValue = poolReferenceDeltaState?.val;
+            const collectorDeltaNumber = Number(collectorDeltaValue);
+            const poolReferenceDeltaNumber = Number(poolReferenceDeltaValue);
+            const extendedDeltaValid =
+                collectorDeltaValue !== null &&
+                collectorDeltaValue !== undefined &&
+                collectorDeltaValue !== '' &&
+                poolReferenceDeltaValue !== null &&
+                poolReferenceDeltaValue !== undefined &&
+                poolReferenceDeltaValue !== '' &&
+                Number.isFinite(collectorDeltaNumber) &&
+                Number.isFinite(poolReferenceDeltaNumber);
+
+            await this.adapter.setStateChangedAsync('solar.extended.collector_pool_reference_delta', {
+                val: extendedDeltaValid ? Number((collectorDeltaNumber - poolReferenceDeltaNumber).toFixed(2)) : null,
+                ack: true,
+            });
+
             let configOk = false;
             let requestActive = false;
             let active = false;

package/lib/helpers/solarHelper.js

@@ -71,8 +71,26 @@ const solarHelper = {
             const hysteresis = (await this.adapter.getStateAsync('solar.hysteresis_active'))?.val;
 
             // Temperaturen laden
-            const collector = Number((await this.adapter.getStateAsync('temperature.collector.current'))?.val);
-            const pool = Number((await this.adapter.getStateAsync('temperature.surface.current'))?.val); // Oberfläche = Pooltemp
+            const collectorState = await this.adapter.getStateAsync('temperature.collector.current');
+            const poolState = await this.adapter.getStateAsync('temperature.surface.current');
+            const collectorValue = collectorState?.val;
+            const poolValue = poolState?.val;
+            const collector = Number(collectorValue);
+            const pool = Number(poolValue); // Oberfläche = Pooltemp
+            const solarDeltaValid =
+                collectorValue !== null &&
+                collectorValue !== undefined &&
+                collectorValue !== '' &&
+                poolValue !== null &&
+                poolValue !== undefined &&
+                poolValue !== '' &&
+                Number.isFinite(collector) &&
+                Number.isFinite(pool);
+
+            await this.adapter.setStateChangedAsync('solar.collector_surface_delta', {
+                val: solarDeltaValid ? Number((collector - pool).toFixed(2)) : null,
+                ack: true,
+            });
 
             // NEU: Absicherung gegen ungültige Werte
             if (isNaN(collector) || isNaN(pool)) {

package/lib/i18n/de.json

@@ -372,5 +372,14 @@
   "pool_insights_observation_pv_runtime_today": "PV-Unterstützung lief heute {minutes} Minuten.",
   "pool_insights_observation_ph_evaluation_available": "Eine pH-Bewertung ist verfügbar.",
   "pool_insights_observation_tds_evaluation_available": "Eine TDS-Bewertung ist verfügbar.",
-  "pool_insights_observation_orp_evaluation_available": "Eine ORP-Bewertung ist verfügbar."
+  "pool_insights_observation_orp_evaluation_available": "Eine ORP-Bewertung ist verfügbar.",
+
+  "circulation_plausibility_initializing": "Die Plausibilitätsprüfung der Umwälzberechnung wird initialisiert.",
+  "circulation_plausibility_ok": "Die Plausibilitätsprüfung der Umwälzberechnung ist in Ordnung.",
+  "circulation_plausibility_no_flow": "Für die Umwälzberechnung ist kein gültiger Live-Durchflusswert verfügbar.",
+  "circulation_plausibility_power_warning": "Die Pumpenleistung ist im Verhältnis zur konfigurierten Maximalleistung unplausibel hoch.",
+  "circulation_plausibility_flow_warning": "Der berechnete Durchfluss ist im Verhältnis zur konfigurierten Nennförderleistung unplausibel hoch.",
+  "circulation_plausibility_daily_total_jump_warning": "Das Tagesumwälzvolumen ist schneller gestiegen als physikalisch plausibel.",
+  "circulation_plausibility_multiple_warnings": "Mehrere Plausibilitätswarnungen zur Umwälzberechnung sind aktiv.",
+  "circulation_plausibility_disabled": "Die Plausibilitätsprüfung der Umwälzberechnung ist deaktiviert."
 }

package/lib/i18n/en.json

@@ -399,5 +399,14 @@
   "pool_insights_observation_pv_runtime_today": "PV support ran for {minutes} minutes today.",
   "pool_insights_observation_ph_evaluation_available": "A pH evaluation is available.",
   "pool_insights_observation_tds_evaluation_available": "A TDS evaluation is available.",
-  "pool_insights_observation_orp_evaluation_available": "An ORP evaluation is available."
+  "pool_insights_observation_orp_evaluation_available": "An ORP evaluation is available.",
+
+  "circulation_plausibility_initializing": "Circulation plausibility check is initializing.",
+  "circulation_plausibility_ok": "Circulation plausibility check is OK.",
+  "circulation_plausibility_no_flow": "No valid live flow value is available for the circulation calculation.",
+  "circulation_plausibility_power_warning": "Pump power is implausibly high compared to the configured maximum power.",
+  "circulation_plausibility_flow_warning": "Calculated flow rate is implausibly high compared to the configured nominal flow.",
+  "circulation_plausibility_daily_total_jump_warning": "Daily circulation volume increased faster than physically plausible.",
+  "circulation_plausibility_multiple_warnings": "Multiple circulation plausibility warnings are active.",
+  "circulation_plausibility_disabled": "Circulation plausibility check is disabled."
 }

package/lib/i18n/es.json

@@ -395,5 +395,15 @@
   "pool_insights_observation_pv_runtime_today": "La asistencia PV funcionó hoy durante {minutes} minutos.",
   "pool_insights_observation_ph_evaluation_available": "Hay una evaluación de pH disponible.",
   "pool_insights_observation_tds_evaluation_available": "Hay una evaluación de TDS disponible.",
-  "pool_insights_observation_orp_evaluation_available": "Hay una evaluación de ORP disponible."
+  "pool_insights_observation_orp_evaluation_available": "Hay una evaluación de ORP disponible.",
+
+    "circulation_plausibility_initializing": "La comprobación de plausibilidad de la circulación se está inicializando.",
+  "circulation_plausibility_ok": "La comprobación de plausibilidad de la circulación es correcta.",
+  "circulation_plausibility_no_flow": "No hay un valor válido de caudal disponible para el cálculo de la circulación.",
+  "circulation_plausibility_power_warning": "La potencia de la bomba es excesiva en relación con la potencia máxima configurada.",
+  "circulation_plausibility_flow_warning": "El caudal calculado es excesivo en relación con el caudal nominal configurado.",
+  "circulation_plausibility_daily_total_jump_warning": "El volumen diario de circulación ha aumentado más rápido de lo físicamente plausible.",
+  "circulation_plausibility_multiple_warnings": "Hay varias advertencias de plausibilidad de circulación activas.",
+  "circulation_plausibility_disabled": "La comprobación de plausibilidad de la circulación está desactivada."
 }
+

package/lib/i18n/fr.json

@@ -395,5 +395,14 @@
   "pool_insights_observation_pv_runtime_today": "L’assistance PV a fonctionné pendant {minutes} minutes aujourd’hui.",
   "pool_insights_observation_ph_evaluation_available": "Une évaluation du pH est disponible.",
   "pool_insights_observation_tds_evaluation_available": "Une évaluation TDS est disponible.",
-  "pool_insights_observation_orp_evaluation_available": "Une évaluation ORP est disponible."
+  "pool_insights_observation_orp_evaluation_available": "Une évaluation ORP est disponible.",
+
+  "circulation_plausibility_initializing": "La vérification de plausibilité de la circulation est en cours d'initialisation.",
+  "circulation_plausibility_ok": "La vérification de plausibilité de la circulation est correcte.",
+  "circulation_plausibility_no_flow": "Aucune valeur de débit valide n'est disponible pour le calcul de circulation.",
+  "circulation_plausibility_power_warning": "La puissance de la pompe est anormalement élevée par rapport à la puissance maximale configurée.",
+  "circulation_plausibility_flow_warning": "Le débit calculé est anormalement élevé par rapport au débit nominal configuré.",
+  "circulation_plausibility_daily_total_jump_warning": "Le volume quotidien de circulation a augmenté plus rapidement que physiquement plausible.",
+  "circulation_plausibility_multiple_warnings": "Plusieurs avertissements de plausibilité de circulation sont actifs.",
+  "circulation_plausibility_disabled": "La vérification de plausibilité de la circulation est désactivée."
 }

package/lib/i18n/it.json

@@ -395,5 +395,14 @@
   "pool_insights_observation_pv_runtime_today": "Il supporto PV ha funzionato oggi per {minutes} minuti.",
   "pool_insights_observation_ph_evaluation_available": "È disponibile una valutazione pH.",
   "pool_insights_observation_tds_evaluation_available": "È disponibile una valutazione TDS.",
-  "pool_insights_observation_orp_evaluation_available": "È disponibile una valutazione ORP."
+  "pool_insights_observation_orp_evaluation_available": "È disponibile una valutazione ORP.",
+
+  "circulation_plausibility_initializing": "Il controllo di plausibilità della circolazione è in fase di inizializzazione.",
+  "circulation_plausibility_ok": "Il controllo di plausibilità della circolazione è corretto.",
+  "circulation_plausibility_no_flow": "Non è disponibile un valore di flusso valido per il calcolo della circolazione.",
+  "circulation_plausibility_power_warning": "La potenza della pompa è eccessivamente alta rispetto alla potenza massima configurata.",
+  "circulation_plausibility_flow_warning": "La portata calcolata è eccessivamente alta rispetto alla portata nominale configurata.",
+  "circulation_plausibility_daily_total_jump_warning": "Il volume giornaliero di circolazione è aumentato più velocemente di quanto fisicamente plausibile.",
+  "circulation_plausibility_multiple_warnings": "Sono attivi più avvisi di plausibilità della circolazione.",
+  "circulation_plausibility_disabled": "Il controllo di plausibilità della circolazione è disattivato."
 }

package/lib/i18n/nl.json

@@ -395,5 +395,14 @@
   "pool_insights_observation_pv_runtime_today": "PV-ondersteuning liep vandaag {minutes} minuten.",
   "pool_insights_observation_ph_evaluation_available": "Er is een pH-beoordeling beschikbaar.",
   "pool_insights_observation_tds_evaluation_available": "Er is een TDS-beoordeling beschikbaar.",
-  "pool_insights_observation_orp_evaluation_available": "Er is een ORP-beoordeling beschikbaar."
+  "pool_insights_observation_orp_evaluation_available": "Er is een ORP-beoordeling beschikbaar.",
+
+  "circulation_plausibility_initializing": "De plausibiliteitscontrole van de circulatie wordt geïnitialiseerd.",
+  "circulation_plausibility_ok": "De plausibiliteitscontrole van de circulatie is in orde.",
+  "circulation_plausibility_no_flow": "Er is geen geldige debietwaarde beschikbaar voor de circulatieberekening.",
+  "circulation_plausibility_power_warning": "Het pompvermogen is onwaarschijnlijk hoog ten opzichte van het ingestelde maximale vermogen.",
+  "circulation_plausibility_flow_warning": "Het berekende debiet is onwaarschijnlijk hoog ten opzichte van het ingestelde nominale debiet.",
+  "circulation_plausibility_daily_total_jump_warning": "Het dagelijkse circulatievolume is sneller gestegen dan fysiek plausibel.",
+  "circulation_plausibility_multiple_warnings": "Er zijn meerdere waarschuwingen voor circulatie-plausibiliteit actief.",
+  "circulation_plausibility_disabled": "De plausibiliteitscontrole van de circulatie is uitgeschakeld."
 }

package/lib/i18n/pl.json

@@ -395,5 +395,14 @@
   "pool_insights_observation_pv_runtime_today": "Wsparcie PV działało dziś przez {minutes} minut.",
   "pool_insights_observation_ph_evaluation_available": "Dostępna jest ocena pH.",
   "pool_insights_observation_tds_evaluation_available": "Dostępna jest ocena TDS.",
-  "pool_insights_observation_orp_evaluation_available": "Dostępna jest ocena ORP."
+  "pool_insights_observation_orp_evaluation_available": "Dostępna jest ocena ORP.",
+
+  "circulation_plausibility_initializing": "Trwa inicjalizacja kontroli wiarygodności obiegu.",
+  "circulation_plausibility_ok": "Kontrola wiarygodności obiegu jest prawidłowa.",
+  "circulation_plausibility_no_flow": "Brak prawidłowej wartości przepływu dla obliczeń obiegu.",
+  "circulation_plausibility_power_warning": "Moc pompy jest nienaturalnie wysoka względem skonfigurowanej mocy maksymalnej.",
+  "circulation_plausibility_flow_warning": "Obliczony przepływ jest nienaturalnie wysoki względem skonfigurowanego przepływu nominalnego.",
+  "circulation_plausibility_daily_total_jump_warning": "Dzienna objętość obiegu wzrosła szybciej niż jest to fizycznie możliwe.",
+  "circulation_plausibility_multiple_warnings": "Aktywnych jest kilka ostrzeżeń dotyczących wiarygodności obiegu.",
+  "circulation_plausibility_disabled": "Kontrola wiarygodności obiegu jest wyłączona."
 }

package/lib/i18n/pt.json

@@ -395,5 +395,14 @@
   "pool_insights_observation_pv_runtime_today": "O apoio PV funcionou hoje durante {minutes} minutos.",
   "pool_insights_observation_ph_evaluation_available": "Está disponível uma avaliação de pH.",
   "pool_insights_observation_tds_evaluation_available": "Está disponível uma avaliação TDS.",
-  "pool_insights_observation_orp_evaluation_available": "Está disponível uma avaliação ORP."
+  "pool_insights_observation_orp_evaluation_available": "Está disponível uma avaliação ORP.",
+
+  "circulation_plausibility_initializing": "A verificação de plausibilidade da circulação está a ser inicializada.",
+  "circulation_plausibility_ok": "A verificação de plausibilidade da circulação está correta.",
+  "circulation_plausibility_no_flow": "Não existe um valor de caudal válido para o cálculo da circulação.",
+  "circulation_plausibility_power_warning": "A potência da bomba é excessivamente elevada em relação à potência máxima configurada.",
+  "circulation_plausibility_flow_warning": "O caudal calculado é excessivamente elevado em relação ao caudal nominal configurado.",
+  "circulation_plausibility_daily_total_jump_warning": "O volume diário de circulação aumentou mais rapidamente do que seria fisicamente plausível.",
+  "circulation_plausibility_multiple_warnings": "Existem vários avisos de plausibilidade da circulação ativos.",
+  "circulation_plausibility_disabled": "A verificação de plausibilidade da circulação está desativada."
 }

package/lib/i18n/ru.json

@@ -395,5 +395,14 @@
   "pool_insights_observation_pv_runtime_today": "Поддержка PV сегодня работала {minutes} минут.",
   "pool_insights_observation_ph_evaluation_available": "Доступна оценка pH.",
   "pool_insights_observation_tds_evaluation_available": "Доступна оценка TDS.",
-  "pool_insights_observation_orp_evaluation_available": "Доступна оценка ORP."
+  "pool_insights_observation_orp_evaluation_available": "Доступна оценка ORP.",
+
+  "circulation_plausibility_initializing": "Инициализируется проверка достоверности циркуляции.",
+  "circulation_plausibility_ok": "Проверка достоверности циркуляции выполнена успешно.",
+  "circulation_plausibility_no_flow": "Нет допустимого значения потока для расчёта циркуляции.",
+  "circulation_plausibility_power_warning": "Мощность насоса слишком велика по сравнению с настроенной максимальной мощностью.",
+  "circulation_plausibility_flow_warning": "Расчётный поток слишком велик по сравнению с настроенным номинальным потоком.",
+  "circulation_plausibility_daily_total_jump_warning": "Суточный объём циркуляции увеличился быстрее, чем это физически возможно.",
+  "circulation_plausibility_multiple_warnings": "Активны несколько предупреждений проверки достоверности циркуляции.",
+  "circulation_plausibility_disabled": "Проверка достоверности циркуляции отключена."
 }

package/lib/i18n/uk.json

@@ -395,5 +395,14 @@
   "pool_insights_observation_pv_runtime_today": "Підтримка PV сьогодні працювала {minutes} хвилин.",
   "pool_insights_observation_ph_evaluation_available": "Доступна оцінка pH.",
   "pool_insights_observation_tds_evaluation_available": "Доступна оцінка TDS.",
-  "pool_insights_observation_orp_evaluation_available": "Доступна оцінка ORP."
+  "pool_insights_observation_orp_evaluation_available": "Доступна оцінка ORP.",
+
+  "circulation_plausibility_initializing": "Ініціалізується перевірка правдоподібності циркуляції.",
+  "circulation_plausibility_ok": "Перевірка правдоподібності циркуляції успішна.",
+  "circulation_plausibility_no_flow": "Відсутнє коректне значення потоку для розрахунку циркуляції.",
+  "circulation_plausibility_power_warning": "Потужність насоса надто висока відносно налаштованої максимальної потужності.",
+  "circulation_plausibility_flow_warning": "Розрахований потік надто високий відносно налаштованого номінального потоку.",
+  "circulation_plausibility_daily_total_jump_warning": "Добовий обсяг циркуляції збільшився швидше, ніж це фізично можливо.",
+  "circulation_plausibility_multiple_warnings": "Активні кілька попереджень перевірки правдоподібності циркуляції.",
+  "circulation_plausibility_disabled": "Перевірку правдоподібності циркуляції вимкнено."
 }

package/lib/i18n/zh-cn.json

@@ -395,5 +395,14 @@
   "pool_insights_observation_pv_runtime_today": "今天 PV 支持运行了 {minutes} 分钟。",
   "pool_insights_observation_ph_evaluation_available": "已有 pH 评估。",
   "pool_insights_observation_tds_evaluation_available": "已有 TDS 评估。",
-  "pool_insights_observation_orp_evaluation_available": "已有 ORP 评估。"
+  "pool_insights_observation_orp_evaluation_available": "已有 ORP 评估。",
+
+  "circulation_plausibility_initializing": "循环合理性检查正在初始化。",
+  "circulation_plausibility_ok": "循环合理性检查正常。",
+  "circulation_plausibility_no_flow": "没有可用于循环计算的有效流量值。",
+  "circulation_plausibility_power_warning": "泵功率相对于配置的最大功率异常偏高。",
+  "circulation_plausibility_flow_warning": "计算出的流量相对于配置的额定流量异常偏高。",
+  "circulation_plausibility_daily_total_jump_warning": "每日循环量增长速度超过物理合理范围。",
+  "circulation_plausibility_multiple_warnings": "存在多个循环合理性警告。",
+  "circulation_plausibility_disabled": "循环合理性检查已禁用。"
 }

package/lib/stateDefinitions/runtimeStates.js

@@ -14,6 +14,7 @@
  * - circulation.daily_total
  * - circulation.daily_required
  * - circulation.daily_remaining
+ * - circulation.plausibility.*
  *
  * States sind persistent - behalten Werte über Neustart
  *
@@ -341,6 +342,313 @@ async function createRuntimeStates(adapter) {
         },
         native: {},
     });
+
+    // -------------------------------------------------------------------------
+    // --- Plausibility check for circulation calculation ---
+    await adapter.setObjectNotExistsAsync('circulation.plausibility', {
+        type: 'channel',
+        common: {
+            name: {
+                en: 'Plausibility check for circulation calculation',
+                de: 'Plausibilitätsprüfung der Umwälzberechnung',
+            },
+        },
+        native: {},
+    });
+
+    const plausibilityStates = [
+        {
+            id: '000_enabled',
+            type: 'boolean',
+            role: 'switch',
+            write: true,
+            def: true,
+            name: { en: 'Enable plausibility check', de: 'Plausibilitätsprüfung aktivieren' },
+            desc: {
+                en: 'Enables or disables the circulation plausibility check.',
+                de: 'Aktiviert oder deaktiviert die Plausibilitätsprüfung der Umwälzberechnung.',
+            },
+        },
+        {
+            id: '00_status',
+            type: 'string',
+            role: 'text',
+            def: 'unchecked',
+            name: { en: 'Plausibility check status', de: 'Status der Plausibilitätsprüfung' },
+            desc: {
+                en: 'Current status of the circulation plausibility check',
+                de: 'Aktueller Status der Plausibilitätsprüfung für die Umwälzberechnung',
+            },
+        },
+        {
+            id: '01_level',
+            type: 'string',
+            role: 'text',
+            def: 'info',
+            states: { ok: 'ok', info: 'info', warning: 'warning' },
+            name: { en: 'Plausibility check level', de: 'Bewertungsstufe der Plausibilitätsprüfung' },
+            desc: {
+                en: 'Severity level of the circulation plausibility check',
+                de: 'Bewertungsstufe der Plausibilitätsprüfung für die Umwälzberechnung',
+            },
+        },
+        {
+            id: '02_message_key',
+            type: 'string',
+            role: 'text',
+            def: 'circulation_plausibility_initializing',
+            name: { en: 'Plausibility message key', de: 'Meldungsschlüssel der Plausibilitätsprüfung' },
+            desc: {
+                en: 'Technical message key for the current plausibility result',
+                de: 'Technischer Meldungsschlüssel für das aktuelle Plausibilitätsergebnis',
+            },
+        },
+        {
+            id: '03_last_update',
+            type: 'string',
+            role: 'date',
+            def: '',
+            name: { en: 'Last plausibility check', de: 'Letzte Plausibilitätsprüfung' },
+            desc: {
+                en: 'Timestamp of the last circulation plausibility check',
+                de: 'Zeitpunkt der letzten Plausibilitätsprüfung der Umwälzberechnung',
+            },
+        },
+        {
+            id: '10_power_warning',
+            type: 'boolean',
+            role: 'indicator',
+            def: false,
+            name: { en: 'Power warning', de: 'Warnung bei Pumpenleistung' },
+            desc: {
+                en: 'Indicates that the current pump power is implausibly high compared to the configured maximum power',
+                de: 'Zeigt an, dass die aktuelle Pumpenleistung im Verhältnis zur konfigurierten Maximalleistung unplausibel hoch ist',
+            },
+        },
+        {
+            id: '11_power_value_w',
+            type: 'number',
+            role: 'value.power',
+            unit: 'W',
+            def: 0,
+            name: { en: 'Measured pump power', de: 'Gemessene Pumpenleistung' },
+            desc: {
+                en: 'Pump power value used during the last plausibility warning or check',
+                de: 'Pumpenleistungswert, der bei der letzten Plausibilitätswarnung oder Prüfung verwendet wurde',
+            },
+        },
+        {
+            id: '12_power_limit_w',
+            type: 'number',
+            role: 'value.power',
+            unit: 'W',
+            def: 0,
+            name: { en: 'Pump power warning limit', de: 'Warngrenze der Pumpenleistung' },
+            desc: {
+                en: 'Calculated warning limit for the pump power',
+                de: 'Berechnete Warngrenze für die Pumpenleistung',
+            },
+        },
+        {
+            id: '13_power_warning_at',
+            type: 'string',
+            role: 'date',
+            def: '',
+            name: { en: 'Power warning timestamp', de: 'Zeitpunkt der Pumpenleistungswarnung' },
+            desc: {
+                en: 'Timestamp of the last pump power plausibility warning',
+                de: 'Zeitpunkt der letzten Plausibilitätswarnung zur Pumpenleistung',
+            },
+        },
+        {
+            id: '20_flow_warning',
+            type: 'boolean',
+            role: 'indicator',
+            def: false,
+            name: { en: 'Flow warning', de: 'Warnung bei Durchfluss' },
+            desc: {
+                en: 'Indicates that the calculated flow rate is implausibly high compared to the configured nominal flow',
+                de: 'Zeigt an, dass der berechnete Durchfluss im Verhältnis zur konfigurierten Nennförderleistung unplausibel hoch ist',
+            },
+        },
+        {
+            id: '21_flow_value_lh',
+            type: 'number',
+            role: 'value',
+            unit: 'l/h',
+            def: 0,
+            name: { en: 'Calculated flow rate', de: 'Berechneter Durchfluss' },
+            desc: {
+                en: 'Flow rate value used during the last plausibility warning or check',
+                de: 'Durchflusswert, der bei der letzten Plausibilitätswarnung oder Prüfung verwendet wurde',
+            },
+        },
+        {
+            id: '22_flow_limit_lh',
+            type: 'number',
+            role: 'value',
+            unit: 'l/h',
+            def: 0,
+            name: { en: 'Flow warning limit', de: 'Warngrenze des Durchflusses' },
+            desc: {
+                en: 'Calculated warning limit for the flow rate',
+                de: 'Berechnete Warngrenze für den Durchfluss',
+            },
+        },
+        {
+            id: '23_flow_warning_at',
+            type: 'string',
+            role: 'date',
+            def: '',
+            name: { en: 'Flow warning timestamp', de: 'Zeitpunkt der Durchflusswarnung' },
+            desc: {
+                en: 'Timestamp of the last flow plausibility warning',
+                de: 'Zeitpunkt der letzten Plausibilitätswarnung zum Durchfluss',
+            },
+        },
+        {
+            id: '24_flow_available',
+            type: 'boolean',
+            role: 'indicator',
+            def: false,
+            name: { en: 'Flow value available', de: 'Durchflusswert verfügbar' },
+            desc: {
+                en: 'Indicates whether a valid live flow value was available for the circulation calculation',
+                de: 'Zeigt an, ob ein gültiger Live-Durchflusswert für die Umwälzberechnung verfügbar war',
+            },
+        },
+        {
+            id: '30_jump_warning',
+            type: 'boolean',
+            role: 'indicator',
+            def: false,
+            name: { en: 'Daily circulation jump warning', de: 'Warnung bei Sprung der Tagesumwälzung' },
+            desc: {
+                en: 'Indicates that the daily circulation volume increased faster than physically plausible',
+                de: 'Zeigt an, dass das Tagesumwälzvolumen schneller gestiegen ist als physikalisch plausibel',
+            },
+        },
+        {
+            id: '31_jump_value_liters',
+            type: 'number',
+            role: 'value.volume',
+            unit: 'l',
+            def: 0,
+            name: { en: 'Daily circulation volume jump', de: 'Sprung des Tagesumwälzvolumens' },
+            desc: {
+                en: 'Detected increase of the daily circulation volume since the previous plausibility check',
+                de: 'Erkannter Anstieg des Tagesumwälzvolumens seit der vorherigen Plausibilitätsprüfung',
+            },
+        },
+        {
+            id: '32_jump_limit_liters',
+            type: 'number',
+            role: 'value.volume',
+            unit: 'l',
+            def: 0,
+            name: { en: 'Maximum plausible volume increase', de: 'Maximal plausibler Volumenzuwachs' },
+            desc: {
+                en: 'Maximum plausible circulation volume increase for the elapsed time',
+                de: 'Maximal plausibler Umwälzvolumen-Zuwachs für die vergangene Zeit',
+            },
+        },
+        {
+            id: '33_jump_warning_at',
+            type: 'string',
+            role: 'date',
+            def: '',
+            name: { en: 'Daily circulation jump warning timestamp', de: 'Zeitpunkt der Sprungwarnung' },
+            desc: {
+                en: 'Timestamp of the last implausible daily circulation jump warning',
+                de: 'Zeitpunkt der letzten Warnung wegen eines unplausiblen Sprungs der Tagesumwälzung',
+            },
+        },
+        {
+            id: '40_last_daily_total',
+            type: 'number',
+            role: 'value.volume',
+            unit: 'l',
+            def: 0,
+            name: { en: 'Previous daily circulation volume', de: 'Vorheriges Tagesumwälzvolumen' },
+            desc: {
+                en: 'Daily circulation volume used as previous value for the plausibility check',
+                de: 'Tagesumwälzvolumen, das als vorheriger Wert für die Plausibilitätsprüfung verwendet wurde',
+            },
+        },
+        {
+            id: '41_current_daily_total',
+            type: 'number',
+            role: 'value.volume',
+            unit: 'l',
+            def: 0,
+            name: { en: 'Current daily circulation volume', de: 'Aktuelles Tagesumwälzvolumen' },
+            desc: {
+                en: 'Current daily circulation volume used for the plausibility check',
+                de: 'Aktuelles Tagesumwälzvolumen, das für die Plausibilitätsprüfung verwendet wurde',
+            },
+        },
+        {
+            id: '42_delta_liters',
+            type: 'number',
+            role: 'value.volume',
+            unit: 'l',
+            def: 0,
+            name: { en: 'Daily circulation volume change', de: 'Änderung des Tagesumwälzvolumens' },
+            desc: {
+                en: 'Difference between current and previous daily circulation volume',
+                de: 'Differenz zwischen aktuellem und vorherigem Tagesumwälzvolumen',
+            },
+        },
+        {
+            id: '43_elapsed_seconds',
+            type: 'number',
+            role: 'value',
+            unit: 's',
+            def: 0,
+            name: { en: 'Elapsed time since previous check', de: 'Zeit seit vorheriger Prüfung' },
+            desc: {
+                en: 'Elapsed time since the previous circulation plausibility check',
+                de: 'Vergangene Zeit seit der vorherigen Plausibilitätsprüfung der Umwälzberechnung',
+            },
+        },
+        {
+            id: '44_max_plausible_delta_liters',
+            type: 'number',
+            role: 'value.volume',
+            unit: 'l',
+            def: 0,
+            name: { en: 'Maximum plausible change', de: 'Maximal plausible Änderung' },
+            desc: {
+                en: 'Maximum plausible daily circulation volume change for the elapsed time',
+                de: 'Maximal plausible Änderung des Tagesumwälzvolumens für die vergangene Zeit',
+            },
+        },
+    ];
+
+    for (const state of plausibilityStates) {
+        const id = `circulation.plausibility.${state.id}`;
+        await adapter.setObjectNotExistsAsync(id, {
+            type: 'state',
+            common: {
+                name: state.name,
+                desc: state.desc,
+                type: state.type,
+                role: state.role,
+                read: true,
+                write: state.write === true,
+                persist: true,
+                def: state.def,
+                ...(state.unit ? { unit: state.unit } : {}),
+                ...(state.states ? { states: state.states } : {}),
+            },
+            native: {},
+        });
+
+        const existing = await adapter.getStateAsync(id);
+        if (!existing || existing.val === null || existing.val === undefined) {
+            await adapter.setStateAsync(id, { val: state.def, ack: true });
+        }
+    }
 }
 
 module.exports = {

package/lib/stateDefinitions/solarExtendedStates.js

@@ -305,6 +305,28 @@ async function createSolarExtendedStates(adapter) {
         });
     }
 
+    await adapter.setObjectNotExistsAsync(`${channelId}.collector_pool_reference_delta`, {
+        type: 'state',
+        common: {
+            name: {
+                en: 'Collector-pool reference delta',
+                de: 'Delta Kollektor - Poolreferenz',
+            },
+            desc: {
+                en: 'Current temperature difference between collector and the selected pool reference temperature for extended solar control',
+                de: 'Aktuelle Temperaturdifferenz zwischen Kollektor und der gewählten Pool-Referenztemperatur der erweiterten Solarsteuerung',
+            },
+            type: 'number',
+            role: 'value.temperature',
+            unit: '°C',
+            read: true,
+            write: false,
+            def: null,
+            persist: false,
+        },
+        native: {},
+    });
+
     await adapter.setObjectNotExistsAsync(`${channelId}.active`, {
         type: 'state',
         common: {

package/lib/stateDefinitions/solarStates.js

@@ -6,6 +6,7 @@
  * - solar.hysteresis_active
  * - solar.temp_on (Einschaltgrenze)
  * - solar.temp_off (Ausschaltgrenze)
+ * - solar.collector_surface_delta
  * - solar.collector_warning (Warnung aktiv)
  * - solar.warn_active (Warnlogik aktivieren/deaktivieren)
  * - solar.warn_temp (Warnschwelle °C)
@@ -196,6 +197,28 @@ async function createSolarStates(adapter) {
         ack: true,
     });
 
+    await adapter.setObjectNotExistsAsync('solar.collector_surface_delta', {
+        type: 'state',
+        common: {
+            name: {
+                en: 'Collector-surface delta',
+                de: 'Delta Kollektor - Oberfläche',
+            },
+            desc: {
+                en: 'Current temperature difference between collector and pool surface temperature',
+                de: 'Aktuelle Temperaturdifferenz zwischen Kollektor und Pooloberfläche',
+            },
+            type: 'number',
+            role: 'value.temperature',
+            unit: '°C',
+            read: true,
+            write: false,
+            def: null,
+            persist: false,
+        },
+        native: {},
+    });
+
     // Warnung Kollektortemperatur aktiv
     await adapter.setObjectNotExistsAsync('solar.collector_warning', {
         type: 'state',

package/package.json

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