iobroker.poolcontrol 1.3.31 → 1.3.32

package/README.md

@@ -271,6 +271,13 @@ New features are added regularly – please refer to the changelog.
 ---
 
 ## Changelog
+### 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.
@@ -295,16 +302,6 @@ New features are added regularly – please refer to the changelog.
 - 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,21 @@
 {
   "common": {
     "name": "poolcontrol",
-    "version": "1.3.31",
+    "version": "1.3.32",
     "news": {
+      "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.",
@@ -54,19 +67,6 @@
         "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,130 @@ 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 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;
+
+            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 +494,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/i18n/de.json

@@ -372,5 +372,13 @@
   "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."
 }

package/lib/i18n/en.json

@@ -399,5 +399,13 @@
   "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."
 }

package/lib/i18n/es.json

@@ -395,5 +395,14 @@
   "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."
 }
+

package/lib/i18n/fr.json

@@ -395,5 +395,13 @@
   "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."
 }

package/lib/i18n/it.json

@@ -395,5 +395,13 @@
   "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."
 }

package/lib/i18n/nl.json

@@ -395,5 +395,13 @@
   "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."
 }

package/lib/i18n/pl.json

@@ -395,5 +395,13 @@
   "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."
 }

package/lib/i18n/pt.json

@@ -395,5 +395,13 @@
   "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."
 }

package/lib/i18n/ru.json

@@ -395,5 +395,13 @@
   "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": "Активны несколько предупреждений проверки достоверности циркуляции."
 }

package/lib/i18n/uk.json

@@ -395,5 +395,13 @@
   "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": "Активні кілька попереджень перевірки правдоподібності циркуляції."
 }

package/lib/i18n/zh-cn.json

@@ -395,5 +395,13 @@
   "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": "存在多个循环合理性警告。"
 }

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,301 @@ 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: '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: false,
+                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/package.json

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