iobroker.poolcontrol 1.3.35 → 1.4.0

package/README.md

@@ -283,6 +283,14 @@ New features are added regularly – please refer to the changelog.
 ---
 
 ## Changelog
+### 1.4.0 (2026-06-29)
+
+- Added a reset button for pump learning to quickly clear learned values after a pump replacement or incorrect learning while keeping user settings intact.
+- Made the daily circulation factor writable and persistent. The adapter configuration is now only used as the initial value, allowing adjustments directly via states (e.g. VIS or HomePanel).
+- Added an optional temperature-dependent circulation factor that automatically increases the required daily circulation based on a selectable temperature sensor and configurable threshold.
+- Extended the existing time control with an optional interval mode. Each time window can now operate either continuously or in configurable intervals without introducing a new pump mode.
+- Added new diagnostic states and multilingual status messages to improve transparency and troubleshooting for the new circulation and time control features.
+
 ### 1.3.35 (2026-06-29)
 
 - Fixed an inconsistency in the daily circulation calculation.
@@ -313,10 +321,6 @@ New features are added regularly – please refer to the changelog.
 - 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.
-
 ## Archived Release History
 
 For older releases and archived version history see:

package/admin/i18n/de.json

@@ -135,6 +135,7 @@
     "The AI system (aiHelper & aiForecastHelper) retrieves weather data from Open-Meteo via HTTPS. It uses the geo-coordinates from the ioBroker system configuration (system.config › latitude/longitude). No data is stored or transmitted to third parties. Without valid geo-coordinates, the AI system cannot generate forecasts.": "Das KI-System (aiHelper & aiForecastHelper) ruft Wetterdaten von Open-Meteo über HTTPS ab. Es verwendet die Geokoordinaten aus der ioBroker-Systemkonfiguration (system.config › Breitengrad/Längengrad). Es werden keine Daten gespeichert oder an Dritte übermittelt. Ohne gültige Geokoordinaten kann das KI-System keine Prognosen erstellen.",
     "The PoolControl adapter works completely locally by default. Currently, only the AI features access weather data from Open-Meteo via encrypted HTTPS. Only the geo-coordinates stored in ioBroker (latitude and longitude) are transmitted. No additional data is stored or sent to third parties. Future optional internet services may be added, but they will always be clearly marked.": "Der PoolControl-Adapter arbeitet standardmäßig vollständig lokal. Derzeit greifen nur die KI-Funktionen über verschlüsseltes HTTPS auf Wetterdaten von Open-Meteo zu. Es werden ausschließlich die im ioBroker hinterlegten Geokoordinaten (Breitengrad und Längengrad) übermittelt. Es werden keine darüber hinausgehenden Daten gespeichert oder an Dritte weitergegeben. Zukünftige optionale Internetdienste können hinzugefügt werden, sie werden jedoch immer deutlich gekennzeichnet sein.",
     "These warning values are used as initial values when the datapoints are created for the first time. Later changes should be made via 'solar.warn_active', 'solar.warn_temp' and 'solar.warn_speech' or your visualization.": "Diese Warnwerte werden als Anfangswerte verwendet, wenn die Datenpunkte zum ersten Mal erstellt werden. Spätere Änderungen sollten über „solar.warn_active“, „solar.warn_temp“ und „solar.warn_speech“ oder Ihre Visualisierung vorgenommen werden.",
+    "This value is only the initial value for general.min_circulation_per_day. It is copied during first setup or when the state is empty or invalid. The effective value is the writable state general.min_circulation_per_day and can later be changed via VIS or HomePanel.": "Dieser Wert ist nur der Initialwert für general.min_circulation_per_day. Er wird bei der ersten Einrichtung oder bei leerem bzw. ungültigem State übernommen. Der wirksame Wert ist der beschreibbare State general.min_circulation_per_day und kann später per VIS oder HomePanel geändert werden.",
     "This value is used as the initial season status when the datapoint is created for the first time. Later changes should be made via 'status.season_active' or your visualization.": "Dieser Wert wird als anfänglicher Saisonstatus verwendet, wenn der Datenpunkt zum ersten Mal erstellt wird. Spätere Änderungen sollten über „status.season_active“ oder Ihre Visualisierung vorgenommen werden.",
     "Threshold for PV surplus (W)": "Schwelle für PV-Überschuss (W)",
     "Thursday": "Donnerstag",

package/admin/i18n/en.json

@@ -83,6 +83,7 @@
     "Note: The AI features are completely optional and can be disabled at any time via the 'ai.enabled' datapoint. Weather features (e.g. weather hints, pool tips, forecast for tomorrow) can also be individually enabled or disabled via 'ai.weather.switches.*'. The adapter uses the Open-Meteo service to generate weather data. For this, the geo-coordinates stored in ioBroker (latitude and longitude from system.config) are required.": "Note: The AI features are completely optional and can be disabled at any time via the 'ai.enabled' datapoint. Weather features (e.g. weather hints, pool tips, forecast for tomorrow) can also be individually enabled or disabled via 'ai.weather.switches.*'. The adapter uses the Open-Meteo service to generate weather data. For this, the geo-coordinates stored in ioBroker (latitude and longitude from system.config) are required.",
     "Note: The warning resets automatically once the temperature drops 10% below the configured threshold.": "Note: The warning resets automatically once the temperature drops 10% below the configured threshold.",
     "Note: These settings are mainly used as initial values when PoolControl is set up for the first time. Later operation should be done via the PoolControl datapoints or your visualization. Existing runtime datapoints are not overwritten on adapter restart.": "Note: These settings are mainly used as initial values when PoolControl is set up for the first time. Later operation should be done via the PoolControl datapoints or your visualization. Existing runtime datapoints are not overwritten on adapter restart.",
+    "This value is only the initial value for general.min_circulation_per_day. It is copied during first setup or when the state is empty or invalid. The effective value is the writable state general.min_circulation_per_day and can later be changed via VIS or HomePanel.": "This value is only the initial value for general.min_circulation_per_day. It is copied during first setup or when the state is empty or invalid. The effective value is the writable state general.min_circulation_per_day and can later be changed via VIS or HomePanel.",
     "Object ID Auxiliary pump 1": "Object ID Auxiliary pump 1",
     "Object ID Auxiliary pump 2": "Object ID Auxiliary pump 2",
     "Object ID Auxiliary pump 3": "Object ID Auxiliary pump 3",

package/admin/i18n/es.json

@@ -135,6 +135,7 @@
     "The AI system (aiHelper & aiForecastHelper) retrieves weather data from Open-Meteo via HTTPS. It uses the geo-coordinates from the ioBroker system configuration (system.config › latitude/longitude). No data is stored or transmitted to third parties. Without valid geo-coordinates, the AI system cannot generate forecasts.": "El sistema de inteligencia artificial (aiHelper y aiForecastHelper) recupera datos meteorológicos de Open-Meteo a través de HTTPS. Utiliza las coordenadas geográficas de la configuración del sistema ioBroker (system.config › latitud/longitud). No se almacenan ni se transmiten datos a terceros. Sin coordenadas geográficas válidas, el sistema de IA no puede generar pronósticos.",
     "The PoolControl adapter works completely locally by default. Currently, only the AI features access weather data from Open-Meteo via encrypted HTTPS. Only the geo-coordinates stored in ioBroker (latitude and longitude) are transmitted. No additional data is stored or sent to third parties. Future optional internet services may be added, but they will always be clearly marked.": "El adaptador PoolControl funciona de forma completamente local de forma predeterminada. Actualmente, solo las funciones de IA acceden a los datos meteorológicos de Open-Meteo a través de HTTPS cifrado. Sólo se transmiten las coordenadas geográficas almacenadas en ioBroker (latitud y longitud). No se almacenan ni envían datos adicionales a terceros. Se podrán añadir futuros servicios opcionales de internet, pero siempre estarán claramente marcados.",
     "These warning values are used as initial values when the datapoints are created for the first time. Later changes should be made via 'solar.warn_active', 'solar.warn_temp' and 'solar.warn_speech' or your visualization.": "Estos valores de advertencia se utilizan como valores iniciales cuando los puntos de datos se crean por primera vez. Los cambios posteriores deben realizarse a través de 'solar.warn_active', 'solar.warn_temp' y 'solar.warn_speech' o su visualización.",
+    "This value is only the initial value for general.min_circulation_per_day. It is copied during first setup or when the state is empty or invalid. The effective value is the writable state general.min_circulation_per_day and can later be changed via VIS or HomePanel.": "Este valor es solo el valor inicial para general.min_circulation_per_day. Se copia durante la primera configuración o cuando el estado está vacío o no es válido. El valor efectivo es el estado escribible general.min_circulation_per_day y puede modificarse posteriormente mediante VIS o HomePanel.",
     "This value is used as the initial season status when the datapoint is created for the first time. Later changes should be made via 'status.season_active' or your visualization.": "Este valor se utiliza como estado inicial de la temporada cuando se crea el punto de datos por primera vez. Los cambios posteriores deben realizarse a través de 'status.season_active' o su visualización.",
     "Threshold for PV surplus (W)": "Umbral de excedente fotovoltaico (W)",
     "Thursday": "Jueves",

package/admin/i18n/fr.json

@@ -135,6 +135,7 @@
     "The AI system (aiHelper & aiForecastHelper) retrieves weather data from Open-Meteo via HTTPS. It uses the geo-coordinates from the ioBroker system configuration (system.config › latitude/longitude). No data is stored or transmitted to third parties. Without valid geo-coordinates, the AI system cannot generate forecasts.": "Le système d'IA (aiHelper & aiForecastHelper) récupère les données météorologiques d'Open-Meteo via HTTPS. Il utilise les coordonnées géographiques de la configuration du système ioBroker (system.config › latitude/longitude). Aucune donnée n'est stockée ou transmise à des tiers. Sans coordonnées géographiques valides, le système d’IA ne peut pas générer de prévisions.",
     "The PoolControl adapter works completely locally by default. Currently, only the AI features access weather data from Open-Meteo via encrypted HTTPS. Only the geo-coordinates stored in ioBroker (latitude and longitude) are transmitted. No additional data is stored or sent to third parties. Future optional internet services may be added, but they will always be clearly marked.": "L'adaptateur PoolControl fonctionne entièrement localement par défaut. Actuellement, seules les fonctionnalités d’IA accèdent aux données météorologiques d’Open-Meteo via HTTPS crypté. Seules les coordonnées géographiques stockées dans ioBroker (latitude et longitude) sont transmises. Aucune donnée supplémentaire n'est stockée ou transmise à des tiers. De futurs services Internet optionnels pourront être ajoutés, mais ils seront toujours clairement indiqués.",
     "These warning values are used as initial values when the datapoints are created for the first time. Later changes should be made via 'solar.warn_active', 'solar.warn_temp' and 'solar.warn_speech' or your visualization.": "Ces valeurs d'avertissement sont utilisées comme valeurs initiales lorsque les points de données sont créés pour la première fois. Les modifications ultérieures doivent être apportées via 'solar.warn_active', 'solar.warn_temp' et 'solar.warn_speech' ou votre visualisation.",
+    "This value is only the initial value for general.min_circulation_per_day. It is copied during first setup or when the state is empty or invalid. The effective value is the writable state general.min_circulation_per_day and can later be changed via VIS or HomePanel.": "Cette valeur est uniquement la valeur initiale pour general.min_circulation_per_day. Elle est copiée lors de la première configuration ou lorsque l’état est vide ou invalide. La valeur effective est l’état modifiable general.min_circulation_per_day et peut ensuite être modifiée via VIS ou HomePanel.",
     "This value is used as the initial season status when the datapoint is created for the first time. Later changes should be made via 'status.season_active' or your visualization.": "Cette valeur est utilisée comme état initial de la saison lorsque le point de données est créé pour la première fois. Les modifications ultérieures doivent être apportées via « status.season_active » ou votre visualisation.",
     "Threshold for PV surplus (W)": "Seuil de surplus PV (W)",
     "Thursday": "Jeudi",

package/admin/i18n/it.json

@@ -135,6 +135,7 @@
     "The AI system (aiHelper & aiForecastHelper) retrieves weather data from Open-Meteo via HTTPS. It uses the geo-coordinates from the ioBroker system configuration (system.config › latitude/longitude). No data is stored or transmitted to third parties. Without valid geo-coordinates, the AI system cannot generate forecasts.": "Il sistema AI (aiHelper e aiForecastHelper) recupera i dati meteorologici da Open-Meteo tramite HTTPS. Utilizza le coordinate geografiche dalla configurazione del sistema ioBroker (system.config › latitudine/longitudine). Nessun dato viene memorizzato o trasmesso a terzi. Senza coordinate geografiche valide, il sistema AI non può generare previsioni.",
     "The PoolControl adapter works completely locally by default. Currently, only the AI features access weather data from Open-Meteo via encrypted HTTPS. Only the geo-coordinates stored in ioBroker (latitude and longitude) are transmitted. No additional data is stored or sent to third parties. Future optional internet services may be added, but they will always be clearly marked.": "Per impostazione predefinita, l'adattatore PoolControl funziona completamente localmente. Attualmente, solo le funzionalità AI accedono ai dati meteorologici da Open-Meteo tramite HTTPS crittografato. Vengono trasmesse solo le coordinate geografiche memorizzate in ioBroker (latitudine e longitudine). Nessun dato aggiuntivo viene memorizzato o inviato a terzi. Potranno essere aggiunti futuri servizi internet opzionali, ma saranno sempre chiaramente segnalati.",
     "These warning values are used as initial values when the datapoints are created for the first time. Later changes should be made via 'solar.warn_active', 'solar.warn_temp' and 'solar.warn_speech' or your visualization.": "Questi valori di avviso vengono utilizzati come valori iniziali quando i datapoint vengono creati per la prima volta. Le modifiche successive dovranno essere apportate tramite 'solar.warn_active', 'solar.warn_temp' e 'solar.warn_speech' o tramite la visualizzazione.",
+    "This value is only the initial value for general.min_circulation_per_day. It is copied during first setup or when the state is empty or invalid. The effective value is the writable state general.min_circulation_per_day and can later be changed via VIS or HomePanel.": "Questo valore è solo il valore iniziale per general.min_circulation_per_day. Viene copiato durante la prima configurazione o quando lo stato è vuoto o non valido. Il valore effettivo è lo stato scrivibile general.min_circulation_per_day e può essere modificato successivamente tramite VIS o HomePanel.",
     "This value is used as the initial season status when the datapoint is created for the first time. Later changes should be made via 'status.season_active' or your visualization.": "Questo valore viene utilizzato come stato stagionale iniziale quando il datapoint viene creato per la prima volta. Le modifiche successive dovrebbero essere apportate tramite \"status.season_active\" o la tua visualizzazione.",
     "Threshold for PV surplus (W)": "Soglia per surplus FV (W)",
     "Thursday": "Giovedì",

package/admin/i18n/nl.json

@@ -135,6 +135,7 @@
     "The AI system (aiHelper & aiForecastHelper) retrieves weather data from Open-Meteo via HTTPS. It uses the geo-coordinates from the ioBroker system configuration (system.config › latitude/longitude). No data is stored or transmitted to third parties. Without valid geo-coordinates, the AI system cannot generate forecasts.": "Het AI-systeem (aiHelper & aiForecastHelper) haalt weergegevens op van Open-Meteo via HTTPS. Het gebruikt de geocoördinaten van de ioBroker-systeemconfiguratie (system.config ›breedtegraad/lengtegraad). Er worden geen gegevens opgeslagen of doorgegeven aan derden. Zonder geldige geocoördinaten kan het AI-systeem geen voorspellingen genereren.",
     "The PoolControl adapter works completely locally by default. Currently, only the AI features access weather data from Open-Meteo via encrypted HTTPS. Only the geo-coordinates stored in ioBroker (latitude and longitude) are transmitted. No additional data is stored or sent to third parties. Future optional internet services may be added, but they will always be clearly marked.": "De PoolControl adapter werkt standaard volledig lokaal. Momenteel heeft alleen de AI-functie toegang tot weergegevens van Open-Meteo via gecodeerde HTTPS. Alleen de geocoördinaten die zijn opgeslagen in ioBroker (breedtegraad en lengtegraad) worden verzonden. Er worden geen aanvullende gegevens opgeslagen of verzonden naar derden. In de toekomst kunnen optionele internetdiensten worden toegevoegd, maar deze zullen altijd duidelijk worden gemarkeerd.",
     "These warning values are used as initial values when the datapoints are created for the first time. Later changes should be made via 'solar.warn_active', 'solar.warn_temp' and 'solar.warn_speech' or your visualization.": "Deze waarschuwingswaarden worden gebruikt als initiële waarden wanneer de datapunten voor de eerste keer worden aangemaakt. Latere wijzigingen moeten worden aangebracht via 'solar.warn_active', 'solar.warn_temp' en 'solar.warn_speech' of uw visualisatie.",
+    "This value is only the initial value for general.min_circulation_per_day. It is copied during first setup or when the state is empty or invalid. The effective value is the writable state general.min_circulation_per_day and can later be changed via VIS or HomePanel.": "Deze waarde is alleen de beginwaarde voor general.min_circulation_per_day. Hij wordt overgenomen bij de eerste installatie of wanneer de status leeg of ongeldig is. De effectieve waarde is de schrijfbare status general.min_circulation_per_day en kan later via VIS of HomePanel worden gewijzigd.",
     "This value is used as the initial season status when the datapoint is created for the first time. Later changes should be made via 'status.season_active' or your visualization.": "Deze waarde wordt gebruikt als de initiële seizoenstatus wanneer het datapunt voor de eerste keer wordt aangemaakt. Latere wijzigingen dienen via 'status.season_active' of uw visualisatie te worden doorgevoerd.",
     "Threshold for PV surplus (W)": "Drempel voor PV-overschot (W)",
     "Thursday": "Donderdag",

package/admin/i18n/pl.json

@@ -135,6 +135,7 @@
     "The AI system (aiHelper & aiForecastHelper) retrieves weather data from Open-Meteo via HTTPS. It uses the geo-coordinates from the ioBroker system configuration (system.config › latitude/longitude). No data is stored or transmitted to third parties. Without valid geo-coordinates, the AI system cannot generate forecasts.": "System AI (aiHelper i aiForecastHelper) pobiera dane pogodowe z Open-Meteo za pośrednictwem protokołu HTTPS. Wykorzystuje współrzędne geograficzne z konfiguracji systemu ioBroker (system.config › latitude/longitude). Żadne dane nie są przechowywane ani przekazywane osobom trzecim. Bez prawidłowych współrzędnych geograficznych system AI nie może generować prognoz.",
     "The PoolControl adapter works completely locally by default. Currently, only the AI features access weather data from Open-Meteo via encrypted HTTPS. Only the geo-coordinates stored in ioBroker (latitude and longitude) are transmitted. No additional data is stored or sent to third parties. Future optional internet services may be added, but they will always be clearly marked.": "Adapter PoolControl domyślnie działa całkowicie lokalnie. Obecnie tylko sztuczna inteligencja umożliwia dostęp do danych pogodowych z Open-Meteo za pośrednictwem szyfrowanego protokołu HTTPS. Przesyłane są tylko współrzędne geograficzne zapisane w ioBroker (szerokość i długość geograficzna). Żadne dodatkowe dane nie są przechowywane ani przesyłane osobom trzecim. W przyszłości mogą zostać dodane opcjonalne usługi internetowe, ale zawsze będą one wyraźnie oznaczone.",
     "These warning values are used as initial values when the datapoints are created for the first time. Later changes should be made via 'solar.warn_active', 'solar.warn_temp' and 'solar.warn_speech' or your visualization.": "Te wartości ostrzegawcze są używane jako wartości początkowe podczas tworzenia punktów danych po raz pierwszy. Późniejszych zmian należy dokonać poprzez 'solar.warn_active', 'solar.warn_temp' i 'solar.warn_speech' lub poprzez swoją wizualizację.",
+    "This value is only the initial value for general.min_circulation_per_day. It is copied during first setup or when the state is empty or invalid. The effective value is the writable state general.min_circulation_per_day and can later be changed via VIS or HomePanel.": "Ta wartość jest tylko wartością początkową dla general.min_circulation_per_day. Jest kopiowana podczas pierwszej konfiguracji albo gdy stan jest pusty lub nieprawidłowy. Wartością efektywną jest zapisywalny stan general.min_circulation_per_day, który można później zmieniać przez VIS lub HomePanel.",
     "This value is used as the initial season status when the datapoint is created for the first time. Later changes should be made via 'status.season_active' or your visualization.": "Ta wartość jest używana jako początkowy stan sezonu, gdy punkt danych jest tworzony po raz pierwszy. Późniejszych zmian należy dokonać poprzez 'status.season_active' lub swoją wizualizację.",
     "Threshold for PV surplus (W)": "Próg nadwyżki PV (W)",
     "Thursday": "Czwartek",

package/admin/i18n/pt.json

@@ -135,6 +135,7 @@
     "The AI system (aiHelper & aiForecastHelper) retrieves weather data from Open-Meteo via HTTPS. It uses the geo-coordinates from the ioBroker system configuration (system.config › latitude/longitude). No data is stored or transmitted to third parties. Without valid geo-coordinates, the AI system cannot generate forecasts.": "O sistema AI (aiHelper e aiForecastHelper) recupera dados meteorológicos do Open-Meteo via HTTPS. Ele usa as coordenadas geográficas da configuração do sistema ioBroker (system.config › latitude/longitude). Nenhum dado é armazenado ou transmitido a terceiros. Sem coordenadas geográficas válidas, o sistema de IA não pode gerar previsões.",
     "The PoolControl adapter works completely locally by default. Currently, only the AI features access weather data from Open-Meteo via encrypted HTTPS. Only the geo-coordinates stored in ioBroker (latitude and longitude) are transmitted. No additional data is stored or sent to third parties. Future optional internet services may be added, but they will always be clearly marked.": "O adaptador PoolControl funciona completamente localmente por padrão. Atualmente, apenas os recursos de IA acessam dados meteorológicos do Open-Meteo via HTTPS criptografado. Apenas as coordenadas geográficas armazenadas no ioBroker (latitude e longitude) são transmitidas. Nenhum dado adicional é armazenado ou enviado a terceiros. Futuros serviços opcionais de Internet poderão ser adicionados, mas estarão sempre claramente marcados.",
     "These warning values are used as initial values when the datapoints are created for the first time. Later changes should be made via 'solar.warn_active', 'solar.warn_temp' and 'solar.warn_speech' or your visualization.": "Esses valores de aviso são usados ​​como valores iniciais quando os pontos de dados são criados pela primeira vez. Alterações posteriores devem ser feitas por meio de 'solar.warn_active', 'solar.warn_temp' e 'solar.warn_speech' ou de sua visualização.",
+    "This value is only the initial value for general.min_circulation_per_day. It is copied during first setup or when the state is empty or invalid. The effective value is the writable state general.min_circulation_per_day and can later be changed via VIS or HomePanel.": "Este valor é apenas o valor inicial para general.min_circulation_per_day. É copiado na primeira configuração ou quando o estado está vazio ou inválido. O valor efetivo é o estado gravável general.min_circulation_per_day e pode ser alterado posteriormente via VIS ou HomePanel.",
     "This value is used as the initial season status when the datapoint is created for the first time. Later changes should be made via 'status.season_active' or your visualization.": "Este valor é usado como o status inicial da temporada quando o ponto de dados é criado pela primeira vez. Alterações posteriores devem ser feitas através de 'status.season_active' ou de sua visualização.",
     "Threshold for PV surplus (W)": "Limite para excedente fotovoltaico (W)",
     "Thursday": "Quinta-feira",

package/admin/i18n/ru.json

@@ -135,6 +135,7 @@
     "The AI system (aiHelper & aiForecastHelper) retrieves weather data from Open-Meteo via HTTPS. It uses the geo-coordinates from the ioBroker system configuration (system.config › latitude/longitude). No data is stored or transmitted to third parties. Without valid geo-coordinates, the AI system cannot generate forecasts.": "Система искусственного интеллекта (aiHelper и aiForecastHelper) получает данные о погоде из Open-Meteo через HTTPS. Он использует географические координаты из конфигурации системы ioBroker (system.config › широта/долгота). Никакие данные не сохраняются и не передаются третьим лицам. Без действительных географических координат система ИИ не может генерировать прогнозы.",
     "The PoolControl adapter works completely locally by default. Currently, only the AI features access weather data from Open-Meteo via encrypted HTTPS. Only the geo-coordinates stored in ioBroker (latitude and longitude) are transmitted. No additional data is stored or sent to third parties. Future optional internet services may be added, but they will always be clearly marked.": "Адаптер PoolControl по умолчанию работает полностью локально. В настоящее время только функции искусственного интеллекта получают доступ к данным о погоде из Open-Meteo через зашифрованный HTTPS. Передаются только географические координаты, хранящиеся в ioBroker (широта и долгота). Никакие дополнительные данные не сохраняются и не передаются третьим лицам. В будущем могут быть добавлены дополнительные интернет-услуги, но они всегда будут четко обозначены.",
     "These warning values are used as initial values when the datapoints are created for the first time. Later changes should be made via 'solar.warn_active', 'solar.warn_temp' and 'solar.warn_speech' or your visualization.": "Эти значения предупреждения используются в качестве начальных значений при первом создании точек данных. Позже изменения следует внести с помощью «solar.warn_active», «solar.warn_temp» и «solar.warn_speech» или вашей визуализации.",
+    "This value is only the initial value for general.min_circulation_per_day. It is copied during first setup or when the state is empty or invalid. The effective value is the writable state general.min_circulation_per_day and can later be changed via VIS or HomePanel.": "Это значение является только начальным значением для general.min_circulation_per_day. Оно копируется при первой настройке или если состояние пустое либо недействительное. Действующее значение хранится в доступном для записи состоянии general.min_circulation_per_day и позже может изменяться через VIS или HomePanel.",
     "This value is used as the initial season status when the datapoint is created for the first time. Later changes should be made via 'status.season_active' or your visualization.": "Это значение используется в качестве начального статуса сезона при первом создании точки данных. Более поздние изменения следует внести через «status. Season_active» или вашу визуализацию.",
     "Threshold for PV surplus (W)": "Порог для избытка фотоэлектрической энергии (Вт)",
     "Thursday": "Четверг",

package/admin/i18n/uk.json

@@ -135,6 +135,7 @@
     "The AI system (aiHelper & aiForecastHelper) retrieves weather data from Open-Meteo via HTTPS. It uses the geo-coordinates from the ioBroker system configuration (system.config › latitude/longitude). No data is stored or transmitted to third parties. Without valid geo-coordinates, the AI system cannot generate forecasts.": "Система AI (aiHelper & aiForecastHelper) отримує дані про погоду з Open-Meteo через HTTPS. Він використовує геокоординати з конфігурації системи ioBroker (system.config › широта/довгота). Жодні дані не зберігаються та не передаються третім особам. Без дійсних геокоординат система ШІ не може створювати прогнози.",
     "The PoolControl adapter works completely locally by default. Currently, only the AI features access weather data from Open-Meteo via encrypted HTTPS. Only the geo-coordinates stored in ioBroker (latitude and longitude) are transmitted. No additional data is stored or sent to third parties. Future optional internet services may be added, but they will always be clearly marked.": "Адаптер PoolControl за замовчуванням працює повністю локально. Наразі тільки функції ШІ отримують доступ до даних про погоду з Open-Meteo через зашифрований HTTPS. Передаються лише геокоординати, збережені в ioBroker (широта та довгота). Ніякі додаткові дані не зберігаються та не надсилаються третім особам. Майбутні додаткові інтернет-послуги можуть бути додані, але вони завжди будуть чітко позначені.",
     "These warning values are used as initial values when the datapoints are created for the first time. Later changes should be made via 'solar.warn_active', 'solar.warn_temp' and 'solar.warn_speech' or your visualization.": "Ці значення попередження використовуються як початкові значення, коли точки даних створюються вперше. Зміни слід вносити пізніше за допомогою 'solar.warn_active', 'solar.warn_temp' і 'solar.warn_speech' або вашої візуалізації.",
+    "This value is only the initial value for general.min_circulation_per_day. It is copied during first setup or when the state is empty or invalid. The effective value is the writable state general.min_circulation_per_day and can later be changed via VIS or HomePanel.": "Це значення є лише початковим значенням для general.min_circulation_per_day. Воно копіюється під час першого налаштування або якщо стан порожній чи недійсний. Дієве значення зберігається у доступному для запису стані general.min_circulation_per_day і згодом може змінюватися через VIS або HomePanel.",
     "This value is used as the initial season status when the datapoint is created for the first time. Later changes should be made via 'status.season_active' or your visualization.": "Це значення використовується як початковий статус сезону, коли точка даних створюється вперше. Пізніші зміни слід вносити через 'status.season_active' або вашу візуалізацію.",
     "Threshold for PV surplus (W)": "Поріг для надлишку PV (Вт)",
     "Thursday": "четвер",

package/admin/i18n/zh-cn.json

@@ -135,6 +135,7 @@
     "The AI system (aiHelper & aiForecastHelper) retrieves weather data from Open-Meteo via HTTPS. It uses the geo-coordinates from the ioBroker system configuration (system.config › latitude/longitude). No data is stored or transmitted to third parties. Without valid geo-coordinates, the AI system cannot generate forecasts.": "AI 系统（aiHelper 和 aiForecastHelper）通过 HTTPS 从 Open-Meteo 检索天气数据。它使用 ioBroker 系统配置（system.config › 纬度/经度）中的地理坐标。不会存储任何数据或将其传输给第三方。如果没有有效的地理坐标，人工智能系统就无法生成预测。",
     "The PoolControl adapter works completely locally by default. Currently, only the AI features access weather data from Open-Meteo via encrypted HTTPS. Only the geo-coordinates stored in ioBroker (latitude and longitude) are transmitted. No additional data is stored or sent to third parties. Future optional internet services may be added, but they will always be clearly marked.": "默认情况下，PoolControl 适配器完全在本地工作。目前，只有 AI 功能可以通过加密的 HTTPS 访问 Open-Meteo 的天气数据。仅传输存储在 ioBroker 中的地理坐标（纬度和经度）。不会存储任何额外数据或将其发送给第三方。未来可能会添加可选的互联网服务，但它们将始终被明确标记。",
     "These warning values are used as initial values when the datapoints are created for the first time. Later changes should be made via 'solar.warn_active', 'solar.warn_temp' and 'solar.warn_speech' or your visualization.": "首次创建数据点时，这些警告值将用作初始值。稍后的更改应通过“solar.warn_active”、“solar.warn_temp”和“solar.warn_speech”或您的可视化进行。",
+    "This value is only the initial value for general.min_circulation_per_day. It is copied during first setup or when the state is empty or invalid. The effective value is the writable state general.min_circulation_per_day and can later be changed via VIS or HomePanel.": "此值仅是 general.min_circulation_per_day 的初始值。首次设置时，或当状态为空或无效时，会复制该值。实际生效值是可写状态 general.min_circulation_per_day，之后可通过 VIS 或 HomePanel 修改。",
     "This value is used as the initial season status when the datapoint is created for the first time. Later changes should be made via 'status.season_active' or your visualization.": "当第一次创建数据点时，该值用作初始季节状态。稍后的更改应通过“status.season_active”或您的可视化进行。",
     "Threshold for PV surplus (W)": "光伏剩余阈值（W）",
     "Thursday": "周四",

package/admin/jsonConfig.json

@@ -67,6 +67,16 @@
           "lg": 3,
           "xl": 3
         },
+        "min_circulation_hint": {
+          "type": "staticText",
+          "text": "This value is only the initial value for general.min_circulation_per_day. It is copied during first setup or when the state is empty or invalid. The effective value is the writable state general.min_circulation_per_day and can later be changed via VIS or HomePanel.",
+          "newLine": true,
+          "xs": 12,
+          "sm": 12,
+          "md": 12,
+          "lg": 12,
+          "xl": 12
+        },
         "general_season_header": {
           "type": "header",
           "text": "Season Settings",

package/io-package.json

@@ -1,8 +1,21 @@
 {
   "common": {
     "name": "poolcontrol",
-    "version": "1.3.35",
+    "version": "1.4.0",
     "news": {
+      "1.4.0": {
+        "en": "Added pump learning reset button with multilingual status messages, made the daily circulation factor writable and persistent with instant recalculation, introduced temperature-dependent automatic circulation factor adjustment, and extended time control with optional interval operation including diagnostic status messages.",
+        "de": "Reset-Button für das Pumpen-Learning mit mehrsprachigen Statusmeldungen hinzugefügt, täglichen Umwälzfaktor beschreibbar und persistent gemacht inklusive sofortiger Neuberechnung, temperaturabhängige automatische Anpassung des Umwälzfaktors ergänzt sowie die Zeitsteuerung um einen optionalen Intervallbetrieb mit Diagnosestatus erweitert.",
+        "ru": "Добавлена ​​кнопка сброса обучения насоса с многоязычными сообщениями о состоянии, сделан дневной коэффициент циркуляции доступным для записи и постоянным с мгновенным перерасчетом, введена автоматическая регулировка коэффициента циркуляции в зависимости от температуры и расширенное управление временем с опциональной интервальной работой, включая диагностические сообщения о состоянии.",
+        "pt": "Adicionado botão de reinicialização de aprendizado da bomba com mensagens de status multilíngues, tornou o fator de circulação diário gravável e persistente com recálculo instantâneo, introduziu ajuste automático do fator de circulação dependente da temperatura e controle de tempo estendido com operação em intervalo opcional, incluindo mensagens de status de diagnóstico.",
+        "nl": "Pomplerende resetknop toegevoegd met meertalige statusberichten, de dagelijkse circulatiefactor beschrijfbaar en persistent gemaakt met onmiddellijke herberekening, temperatuurafhankelijke automatische aanpassing van de circulatiefactor geïntroduceerd en uitgebreide tijdcontrole met optionele intervalbediening inclusief diagnostische statusberichten.",
+        "fr": "Ajout d'un bouton de réinitialisation de l'apprentissage de la pompe avec messages d'état multilingues, rendu le facteur de circulation quotidien inscriptible et persistant avec un recalcul instantané, introduction d'un réglage automatique du facteur de circulation en fonction de la température et contrôle de temps étendu avec fonctionnement par intervalles en option, y compris des messages d'état de diagnostic.",
+        "it": "Aggiunto pulsante di ripristino dell'apprendimento della pompa con messaggi di stato multilingue, reso il fattore di circolazione giornaliero scrivibile e persistente con ricalcolo istantaneo, introdotta la regolazione automatica del fattore di circolazione dipendente dalla temperatura e controllo del tempo esteso con funzionamento a intervalli opzionale inclusi messaggi di stato diagnostici.",
+        "es": "Se agregó un botón de reinicio de aprendizaje de la bomba con mensajes de estado multilingües, se hizo que el factor de circulación diario sea escribible y persistente con recálculo instantáneo, se introdujo el ajuste automático del factor de circulación dependiente de la temperatura y se extendió el control de tiempo con operación de intervalo opcional que incluye mensajes de estado de diagnóstico.",
+        "pl": "Dodano przycisk resetowania uczenia pompy z wielojęzycznymi komunikatami o stanie, umożliwiono zapis i trwałość dziennego współczynnika cyrkulacji dzięki natychmiastowemu przeliczeniu, wprowadzono automatyczną regulację współczynnika cyrkulacji zależną od temperatury oraz rozszerzoną kontrolę czasu z opcjonalną pracą interwałową, w tym komunikatami diagnostycznymi o stanie.",
+        "uk": "Додано кнопку скидання навчання насоса з багатомовними повідомленнями про стан, зробив щоденний коефіцієнт циркуляції записуваним і постійним із миттєвим перерахунком, запровадив автоматичне регулювання коефіцієнта циркуляції залежно від температури та розширений контроль часу з додатковим інтервалом роботи, включаючи діагностичні повідомлення про стан.",
+        "zh-cn": "添加了具有多语言状态消息的泵学习重置按钮，使每日循环系数可写并通过即时重新计算保持不变，引入了与温度相关的自动循环系数调整，以及具有可选间隔操作（包括诊断状态消息）的延长时间控制。"
+      },
       "1.3.35": {
         "en": "Fixed daily circulation remaining calculation after changing pool size or minimum daily circulation.",
         "de": "Korrigiert die Berechnung der verbleibenden täglichen Umwälzung nach Änderung von Poolgröße oder Mindestumwälzung.",
@@ -54,19 +67,6 @@
         "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.",
-        "ru": "Исправлена ​​логика автоматического пополнения циркуляции при отсутствии датчиков температуры. Автоматическое пополнение теперь блокируется только при сравнении температур коллектора и бассейна, когда активно управление солнечной батареей и обе температуры действительны.",
-        "pt": "Lógica de recarga automática de circulação corrigida quando faltam sensores de temperatura. O reabastecimento automático agora só é bloqueado pela comparação da temperatura do coletor/piscina quando o controle solar está ativo e ambas as temperaturas são válidas.",
-        "nl": "Probleem opgelost met het automatisch bijvullen van de circulatie wanneer temperatuursensoren ontbreken. Het automatisch bijvullen wordt nu alleen geblokkeerd door de vergelijking van de collector-/zwembadtemperatuur als de zonneregeling actief is en beide temperaturen geldig zijn.",
-        "fr": "Correction de la logique de recharge automatique de la circulation lorsque les capteurs de température sont manquants. L'appoint automatique n'est désormais bloqué par la comparaison des températures capteur/piscine que lorsque le contrôle solaire est actif et que les deux températures sont valables.",
-        "it": "Risolta la logica di rabbocco della circolazione automatica in caso di mancanza dei sensori di temperatura. Il rabbocco automatico ora è bloccato solo dal confronto della temperatura collettore/piscina quando il controllo solare è attivo ed entrambe le temperature sono valide.",
-        "es": "Se corrigió la lógica de recarga de circulación automática cuando faltaban sensores de temperatura. La recarga automática ahora solo se bloquea mediante la comparación de temperatura del colector/piscina cuando el control solar está activo y ambas temperaturas son válidas.",
-        "pl": "Naprawiono logikę automatycznego uzupełniania cyrkulacji w przypadku braku czujników temperatury. Automatyczne uzupełnianie jest teraz blokowane tylko przez porównanie temperatur kolektora/basenu, gdy aktywna jest kontrola solarna i obie temperatury są prawidłowe.",
-        "uk": "Виправлена ​​логіка автоматичного доповнення циркуляції, коли датчики температури відсутні. Автоматичне поповнення тепер блокується лише шляхом порівняння температури колектора/басейну, коли активовано сонячне керування та обидві температури дійсні.",
-        "zh-cn": "修复了缺少温度传感器时的自动循环充值逻辑。现在，仅当太阳能控制处于活动状态并且两个温度都有效时，自动充值才会被收集器/池温度比较阻止。"
       }
     },
     "titleLang": {

package/lib/helpers/pumpHelper3.js

@@ -1,5 +1,7 @@
 'use strict';
 
+const { I18n } = require('@iobroker/adapter-core');
+
 /**
  * pumpHelper3.js
  * ----------------------------------------------------------
@@ -50,6 +52,7 @@ const pumpHelper3 = {
         this.adapter.subscribeStates('pump.pump_switch');
         this.adapter.subscribeStates('pump.live.current_power_w');
         this.adapter.subscribeStates('pump.live.flow_current_lh');
+        this.adapter.subscribeStates('pump.learning.reset');
 
         this.adapter.log.info('[pumpHelper3] Successfully initialized');
     },
@@ -66,6 +69,12 @@ const pumpHelper3 = {
         }
 
         try {
+            if (id.endsWith('pump.learning.reset') && state.ack === false && state.val === true) {
+                await this._resetLearningValues();
+                await this.adapter.setStateAsync('pump.learning.reset', { val: false, ack: true });
+                return;
+            }
+
             if (id.endsWith('pump.pump_switch')) {
                 const isOn = state.val === true;
                 if (isOn) {
@@ -246,15 +255,50 @@ const pumpHelper3 = {
         const tolerance = Number(toleranceState?.val) || 15;
 
         if (absPower <= tolerance && absFlow <= tolerance) {
-            return 'Pumpe läuft im Normalbereich';
+            return I18n.translate('Pump is running within the normal range');
         }
         if (devPower < -tolerance || devFlow < -tolerance) {
-            return 'Pumpe läuft unterhalb des Normalbereichs (möglicher Filterdruck)';
+            return I18n.translate('Pump is running below the normal range');
         }
         if (devPower > tolerance || devFlow > tolerance) {
-            return 'Pumpe läuft oberhalb des Normalbereichs (möglicher Luftstau)';
+            return I18n.translate('Pump is running above the normal range');
         }
-        return 'Pumpe außerhalb des bekannten Bereichs';
+        return I18n.translate('Pump is outside the known range');
+    },
+
+    async _resetLearningValues() {
+        const statesToReset = [
+            'pump.learning.learned_avg_flow_lh',
+            'pump.learning.learned_avg_power_w',
+            'pump.learning.learning_cycles_total',
+            'pump.learning.normal_range_flow_low',
+            'pump.learning.normal_range_flow_high',
+            'pump.learning.normal_range_power_low',
+            'pump.learning.normal_range_power_high',
+            'pump.learning.deviation_flow_percent',
+            'pump.learning.deviation_power_percent',
+        ];
+
+        for (const id of statesToReset) {
+            await this.adapter.setStateAsync(id, { val: 0, ack: true });
+        }
+
+        const resetText = I18n.translate('Pump learning values reset');
+
+        await this.adapter.setStateAsync('pump.learning.status_text', {
+            val: resetText,
+            ack: true,
+        });
+
+        this.currentSessionValues.power = [];
+        this.currentSessionValues.flow = [];
+        this._lastLearningStatus = '';
+        this._lastDevPower = 0;
+        this._lastDevFlow = 0;
+        this._lastDevWrite = 0;
+        this._lastLearningWrite = 0;
+
+        this.adapter.log.info('[pumpHelper3] Pump learning values reset.');
     },
 
     /**

package/lib/helpers/runtimeHelper.js

@@ -50,6 +50,10 @@ const runtimeHelper = {
 
         // Pumpenschalter überwachen
         this.adapter.subscribeStates('pump.pump_switch');
+        this.adapter.subscribeStates('general.min_circulation_per_day');
+        this.adapter.subscribeStates('control.circulation.temperature_factor.*');
+        this.adapter.subscribeStates('temperature.*_temp_active');
+        this.adapter.subscribeStates('temperature.*.current');
 
         // >>> NEU: Alte Werte aus States laden
         this._restoreFromStates()
@@ -113,6 +117,16 @@ const runtimeHelper = {
             return;
         }
 
+        const updatesCirculationTarget =
+            id.endsWith('general.min_circulation_per_day') ||
+            /control\.circulation\.temperature_factor\.(enabled|sensor|threshold_c|add_factor)$/.test(id) ||
+            /^.+\.temperature\.(surface|ground|flow|return|collector|outside)(_temp_active|\.current)$/.test(id);
+
+        if (updatesCirculationTarget) {
+            await this._updateCirculationTargets();
+            return;
+        }
+
         // FIX: Robuste Start-/Stop-Logik für pump.pump_switch
         if (id.endsWith('pump.pump_switch')) {
             if (state.val) {
@@ -227,21 +241,7 @@ const runtimeHelper = {
             await this.adapter.setStateAsync('runtime.start_count_today', { val: this.startCountToday, ack: true });
 
             // Poolparameter laden (vor Durchflussprüfung!)
-            const poolSize = (await this.adapter.getStateAsync('general.pool_size'))?.val || 0;
-            const minCirc = (await this.adapter.getStateAsync('general.min_circulation_per_day'))?.val || 1;
-
-            // Soll- und Restmenge immer direkt setzen – auch ohne Durchfluss
-            const dailyRequired = Math.round(poolSize * minCirc);
-
-            // Bestehenden Tageswert laden, damit daily_remaining unabhängig vom Live-Durchfluss konsistent bleibt
-            const oldTotal = Number((await this.adapter.getStateAsync('circulation.daily_total'))?.val || 0);
-            const remainingFromCurrentTotal = Math.max(dailyRequired - oldTotal, 0);
-
-            await this.adapter.setStateAsync('circulation.daily_required', { val: dailyRequired, ack: true });
-            await this.adapter.setStateAsync('circulation.daily_remaining', {
-                val: remainingFromCurrentTotal,
-                ack: true,
-            });
+            const { dailyRequired, oldTotal, remainingFromCurrentTotal } = await this._updateCirculationTargets();
 
             // Umwälzmenge berechnen
             // Reeller Durchflusswert aus pump.live.flow_current_lh
@@ -290,6 +290,112 @@ const runtimeHelper = {
         }
     },
 
+    _normalizeMinCirculation(value) {
+        const num = Number(value);
+        return Number.isFinite(num) && num >= 0.5 && num <= 3 ? num : null;
+    },
+
+    async _readMinCirculation() {
+        const configured = this._normalizeMinCirculation(this.adapter.config.min_circulation_per_day) ?? 1;
+        const state = await this.adapter.getStateAsync('general.min_circulation_per_day');
+        const current = this._normalizeMinCirculation(state?.val);
+
+        if (current !== null) {
+            return current;
+        }
+
+        await this.adapter.setStateAsync('general.min_circulation_per_day', { val: configured, ack: true });
+        return configured;
+    },
+
+    async _updateCirculationTargets() {
+        const poolSize = Number((await this.adapter.getStateAsync('general.pool_size'))?.val || 0);
+        const minCirc = await this._readMinCirculation();
+        const { effectiveFactor } = await this._calculateEffectiveMinCirculation(minCirc);
+        const dailyRequired = Math.round(poolSize * effectiveFactor);
+        const oldTotal = Number((await this.adapter.getStateAsync('circulation.daily_total'))?.val || 0);
+        const remainingFromCurrentTotal = Math.max(dailyRequired - oldTotal, 0);
+
+        await this.adapter.setStateAsync('circulation.daily_required', { val: dailyRequired, ack: true });
+        await this.adapter.setStateAsync('circulation.daily_remaining', {
+            val: remainingFromCurrentTotal,
+            ack: true,
+        });
+
+        return { dailyRequired, oldTotal, remainingFromCurrentTotal };
+    },
+
+    async _calculateEffectiveMinCirculation(baseFactor) {
+        const prefix = 'control.circulation.temperature_factor';
+        const writeResult = async (effectiveFactor, active, reason) => {
+            await this.adapter.setStateAsync('general.min_circulation_effective_per_day', {
+                val: effectiveFactor,
+                ack: true,
+            });
+            await this.adapter.setStateAsync('general.min_circulation_effective_reason', { val: reason, ack: true });
+            await this.adapter.setStateAsync(`${prefix}.active`, { val: active, ack: true });
+            await this.adapter.setStateAsync(`${prefix}.status`, { val: reason, ack: true });
+            return { effectiveFactor, active, reason };
+        };
+
+        const enabled = (await this.adapter.getStateAsync(`${prefix}.enabled`))?.val;
+        if (enabled !== true) {
+            return writeResult(baseFactor, false, enabled === false ? 'disabled' : 'invalid_config');
+        }
+
+        const validSensors = ['surface', 'ground', 'flow', 'return', 'collector', 'outside'];
+        const sensor = (await this.adapter.getStateAsync(`${prefix}.sensor`))?.val;
+        if (typeof sensor !== 'string' || !validSensors.includes(sensor)) {
+            return writeResult(baseFactor, false, 'invalid_sensor');
+        }
+
+        const thresholdRaw = (await this.adapter.getStateAsync(`${prefix}.threshold_c`))?.val;
+        const addFactorRaw = (await this.adapter.getStateAsync(`${prefix}.add_factor`))?.val;
+        const threshold = Number(thresholdRaw);
+        const addFactor = Number(addFactorRaw);
+        if (
+            thresholdRaw === null ||
+            thresholdRaw === undefined ||
+            thresholdRaw === '' ||
+            !Number.isFinite(threshold) ||
+            threshold < -20 ||
+            threshold > 60 ||
+            addFactorRaw === null ||
+            addFactorRaw === undefined ||
+            addFactorRaw === '' ||
+            !Number.isFinite(addFactor) ||
+            addFactor < 0 ||
+            addFactor > 2.5
+        ) {
+            return writeResult(baseFactor, false, 'invalid_config');
+        }
+
+        const sensorActive = (await this.adapter.getStateAsync(`temperature.${sensor}_temp_active`))?.val;
+        if (sensorActive !== true) {
+            return writeResult(baseFactor, false, 'sensor_inactive');
+        }
+
+        const temperatureRaw = (await this.adapter.getStateAsync(`temperature.${sensor}.current`))?.val;
+        const temperature = Number(temperatureRaw);
+        if (
+            temperatureRaw === null ||
+            temperatureRaw === undefined ||
+            temperatureRaw === '' ||
+            !Number.isFinite(temperature)
+        ) {
+            return writeResult(baseFactor, false, 'temperature_missing');
+        }
+
+        if (temperature < threshold) {
+            return writeResult(baseFactor, false, 'base');
+        }
+
+        const uncappedFactor = baseFactor + addFactor;
+        const effectiveFactor = Math.min(uncappedFactor, 3);
+        const reason = uncappedFactor > 3 ? 'temperature_factor_capped' : 'temperature_factor_active';
+        return writeResult(effectiveFactor, true, reason);
+    },
+
     async _updateCirculationPlausibility({
         dailyTotal,
         oldTotal,
@@ -538,10 +644,7 @@ const runtimeHelper = {
             await this.adapter.setStateAsync('circulation.daily_total', { val: 0, ack: true });
 
             // daily_required neu berechnen (optional, falls sich Poolgröße geändert hat)
-            const poolSize = (await this.adapter.getStateAsync('general.pool_size'))?.val || 0;
-            const minCirc = (await this.adapter.getStateAsync('general.min_circulation_per_day'))?.val || 1;
-            const dailyRequired = Math.round(poolSize * minCirc);
-            await this.adapter.setStateAsync('circulation.daily_required', { val: dailyRequired, ack: true });
+            const { dailyRequired } = await this._updateCirculationTargets();
 
             // 👉 daily_remaining neue berechnen auf Grundlage von daily_required
             await this.adapter.setStateAsync('circulation.daily_remaining', { val: dailyRequired, ack: true });