iobroker.poolcontrol 1.3.22 → 1.3.23

package/README.md

@@ -188,6 +188,18 @@ New features are added regularly – please refer to the changelog.
 ---
 
 ## Changelog
+### 1.3.23 (2026-05-26)
+
+- Added extended temperature diagnostics for all temperature sensors:
+  - last valid value
+  - last valid value timestamp
+  - minutes since last value
+  - source status (`ok`, `warning`, `not_received`, `invalid_timestamp`)
+- Added automatic recovery mechanism for stalled temperature updates
+- Recovery runs only when a sensor enters warning state and uses cooldown protection
+- Switched temperature helper timers to ioBroker adapter timers
+- Improved visibility and troubleshooting for missing or delayed temperature updates
+
 ### 1.3.22 (2026-05-24)
 
 - Improved ORP pH reference synchronization
@@ -237,14 +249,6 @@ Features:
 - Fixed a rare synchronization issue where circulation counting could stop although pump live values were still available
 - Improved internal runtime synchronization
 
-### 1.3.18 (2026-05-11)
-
-- Fixed incorrect date display in the pH, ORP and TDS areas.
-- Time states with `value.time` are now stored as numeric timestamps instead of localized date strings.
-- Improved compatibility with ioBroker/Admin date handling.
-- Added backward-compatible handling for previously stored German date strings.
-- Kept history JSON output unchanged with readable date strings for users and VIS displays.
-
 ## Support
 - [ioBroker Forum](https://forum.iobroker.net/)  
 - [GitHub Issues](https://github.com/DasBo1975/ioBroker.poolcontrol/issues)

package/io-package.json

@@ -1,8 +1,21 @@
 {
   "common": {
     "name": "poolcontrol",
-    "version": "1.3.22",
+    "version": "1.3.23",
     "news": {
+      "1.3.23": {
+        "en": "Temperature diagnostics extended: Added new diagnostic states for all temperature sensors (last valid value, timestamp, minutes since last value, source status). Added self-healing/recovery mechanism for stalled or missing temperature events. Temperature helper updated to ioBroker-compliant timers.",
+        "de": "Temperaturbereich erweitert: Neue Diagnosewerte für alle Temperatursensoren ergänzt (letzter gültiger Wert, Zeitstempel, Minuten seit letztem Wert, Quellenstatus). Zusätzlich Selbstheilungs-/Recovery-Mechanismus für ausgefallene oder hängende Temperatur-Events ergänzt. Temperaturhelper auf ioBroker-konforme Timer umgestellt.",
+        "ru": "Расширенная диагностика температуры: добавлены новые диагностические состояния для всех датчиков температуры (последнее действительное значение, временная метка, минуты с момента последнего значения, состояние источника). Добавлен механизм самовосстановления/восстановления при остановке или отсутствии температурных событий. Помощник по температуре обновлен до таймеров, совместимых с ioBroker.",
+        "pt": "Diagnóstico de temperatura estendido: Adicionados novos estados de diagnóstico para todos os sensores de temperatura (último valor válido, carimbo de data/hora, minutos desde o último valor, status da fonte). Adicionado mecanismo de autocorreção/recuperação para eventos de temperatura paralisados ​​ou ausentes. Auxiliar de temperatura atualizado para temporizadores compatíveis com ioBroker.",
+        "nl": "Temperatuurdiagnostiek uitgebreid: Nieuwe diagnostische statussen toegevoegd voor alle temperatuursensoren (laatste geldige waarde, tijdstempel, minuten sinds laatste waarde, bronstatus). Zelfherstel-/herstelmechanisme toegevoegd voor vastgelopen of ontbrekende temperatuurgebeurtenissen. Temperatuurhelper bijgewerkt naar ioBroker-compatibele timers.",
+        "fr": "Diagnostics de température étendus : ajout de nouveaux états de diagnostic pour tous les capteurs de température (dernière valeur valide, horodatage, minutes depuis la dernière valeur, état de la source). Ajout d'un mécanisme d'auto-guérison/récupération pour les événements de température bloqués ou manquants. Assistant de température mis à jour avec des minuteries conformes à ioBroker.",
+        "it": "Diagnostica della temperatura estesa: aggiunti nuovi stati diagnostici per tutti i sensori di temperatura (ultimo valore valido, timestamp, minuti dall'ultimo valore, stato della sorgente). Aggiunto meccanismo di autoriparazione/recupero per eventi di temperatura bloccati o mancanti. Assistente per la temperatura aggiornato ai timer compatibili con ioBroker.",
+        "es": "Diagnóstico de temperatura extendido: se agregaron nuevos estados de diagnóstico para todos los sensores de temperatura (último valor válido, marca de tiempo, minutos desde el último valor, estado de fuente). Se agregó un mecanismo de autorreparación/recuperación para eventos de temperatura estancados o faltantes. Asistente de temperatura actualizado a temporizadores compatibles con ioBroker.",
+        "pl": "Rozszerzona diagnostyka temperatury: Dodano nowe stany diagnostyczne dla wszystkich czujników temperatury (ostatnia ważna wartość, znacznik czasu, minuty od ostatniej wartości, stan źródła). Dodano mechanizm samonaprawy/odzyskiwania w przypadku zablokowania lub braku zdarzeń związanych z temperaturą. Pomocnik temperatury zaktualizowany do timerów zgodnych z ioBroker.",
+        "uk": "Розширено діагностику температури: додано нові діагностичні стани для всіх датчиків температури (останнє дійсне значення, позначка часу, хвилини з останнього значення, статус джерела). Додано механізм самовідновлення/відновлення для зупинених або відсутніх температурних подій. Помічник температури оновлено до таймерів, сумісних із ioBroker.",
+        "zh-cn": "温度诊断扩展：为所有温度传感器添加了新的诊断状态（最后一个有效值、时间戳、自最后一个值以来的分钟数、源状态）。添加了针对停滞或丢失温度事件的自我修复/恢复机制。温度助手更新为符合 ioBroker 标准的计时器。"
+      },
       "1.3.22": {
         "en": "Improved ORP pH reference synchronization. The ORP helper now updates the pH reference independently from ORP value processing and immediately reflects pH state changes.",
         "de": "ORP-pH-Referenz verbessert. Der ORP-Helper aktualisiert die pH-Referenz jetzt unabhängig von der ORP-Wertverarbeitung und übernimmt pH-Änderungen sofort.",
@@ -54,19 +67,6 @@
         "pl": "Dodano funkcję samonaprawy w czasie wykonywania w przypadku zdarzeń związanych z nieudanym uruchomieniem pompy. Stabilizowane obliczenia czasu pracy i cyrkulacji dla opóźnionych lub filtrowanych aktualizacji przełączników pomp. Naprawiono rzadki problem z synchronizacją, w wyniku którego zliczanie cyrkulacji mogło zostać zatrzymane, mimo że wartości bieżące pompy były nadal dostępne. Ulepszona wewnętrzna synchronizacja środowiska wykonawczego.",
         "uk": "Додано самовідновлення під час виконання для пропущених подій запуску насоса. Стабілізований час роботи та обчислення циркуляції для відкладених або фільтрованих оновлень перемикача насоса. Виправлено рідкісну проблему синхронізації, через яку підрахунок циркуляції міг припинитися, хоча поточні значення насоса все ще були доступні. Покращена внутрішня синхронізація часу виконання.",
         "zh-cn": "为错过的泵启动事件添加了运行时自我修复功能。延迟或过滤泵开关更新的稳定运行时间和循环计算。修复了一个罕见的同步问题，即尽管泵的实时值仍然可用，但循环计数可能会停止。改进了内部运行时同步。"
-      },
-      "1.3.18": {
-        "en": "Fixed incorrect date display for pH, ORP and TDS time states by storing value.time states as numeric timestamps.",
-        "de": "Falsche Datumsanzeige für pH-, ORP- und TDS-Zeitzustände behoben, indem value.time-Zustände als numerische Zeitstempel gespeichert wurden.",
-        "ru": "Исправлено неправильное отображение даты для состояний времени pH, ОВП и TDS за счет сохранения состояний value.time в виде числовых меток времени.",
-        "pt": "Corrigida a exibição incorreta de data para estados de tempo de pH, ORP e TDS, armazenando estados de valor.tempo como carimbos de data/hora numéricos.",
-        "nl": "Foutieve datumweergave voor pH-, ORP- en TDS-tijdstatussen opgelost door value.time-statussen op te slaan als numerieke tijdstempels.",
-        "fr": "Correction de l'affichage incorrect de la date pour les états temporels pH, ORP et TDS en stockant les états value.time sous forme d'horodatages numériques.",
-        "it": "Risolto il problema con la visualizzazione errata della data per gli stati temporali pH, ORP e TDS memorizzando gli stati value.time come timestamp numerici.",
-        "es": "Se corrigió la visualización de fecha incorrecta para los estados de tiempo de pH, ORP y TDS al almacenar los estados de valor.hora como marcas de tiempo numéricas.",
-        "pl": "Naprawiono nieprawidłowe wyświetlanie daty dla stanów czasowych pH, ​​ORP i TDS poprzez przechowywanie stanów wartość.czas jako numeryczne znaczniki czasu.",
-        "uk": "Виправлено неправильне відображення дати для часових станів pH, ORP і TDS шляхом збереження станів value.time як числових позначок часу.",
-        "zh-cn": "通过将 value.time 状态存储为数字时间戳，修复了 pH、ORP 和 TDS 时间状态的不正确日期显示。"
       }
     },
     "titleLang": {

package/lib/helpers/temperatureHelper.js

@@ -20,10 +20,13 @@ const temperatureHelper = {
     minMax: {}, // { collector: { min, max }, ... }
     history: {}, // { sensorKey: [{ ts, val }, ...] }
     resetTimer: null,
+    diagnosticTimer: null,
+    recoveryLastRun: {}, // { sensorKey: timestamp }
 
     init(adapter) {
         this.adapter = adapter;
         this.sensors = this._collectActiveSensors(adapter);
+        this.recoveryLastRun = {};
 
         // Foreign-States abonnieren
         for (const id of Object.values(this.sensors)) {
@@ -39,6 +42,8 @@ const temperatureHelper = {
                         const val = Number(state.val);
                         this.values[key] = val;
                         await this._setCurrentValue(key, val);
+                        // NEU: Diagnosewerte für letzten gültigen Sensorwert aktualisieren
+                        await this._updateSensorDiagnostics(key, val, state, 'ok');
                         await this._updateMinMax(key, val);
                         adapter.log.debug(`[temperatureHelper] Initial value for ${key}: ${val} °C`);
                     } else {
@@ -67,6 +72,9 @@ const temperatureHelper = {
         // Reset um Mitternacht
         this._scheduleDailyReset();
 
+        // NEU: Diagnose-Timer für Sensor-Aktualität starten
+        this._scheduleSensorDiagnostics();
+
         adapter.log.debug(
             `[temperatureHelper] Aktiv: ${
                 Object.keys(this.sensors).length
@@ -121,6 +129,9 @@ const temperatureHelper = {
         // Aktuellen Wert setzen
         await this._setCurrentValue(key, num);
 
+        // NEU: Diagnosewerte für letzten gültigen Sensorwert aktualisieren
+        await this._updateSensorDiagnostics(key, num, state, 'ok');
+
         // Deltas berechnen
         await this._maybeWriteDelta('temperature.delta.collector_outside', this.values.collector, this.values.outside);
         await this._maybeWriteDelta('temperature.delta.surface_ground', this.values.surface, this.values.ground);
@@ -144,6 +155,34 @@ const temperatureHelper = {
         }
     },
 
+    // NEU: Diagnosewerte für gültige Temperatursensorwerte schreiben
+    async _updateSensorDiagnostics(key, value, state, status) {
+        const sourceTs = state && Number.isFinite(Number(state.ts)) ? Number(state.ts) : Date.now();
+        const isoTime = new Date(sourceTs).toISOString();
+        const minutesSince = Math.max(0, Math.round((Date.now() - sourceTs) / 60000));
+
+        try {
+            await this.adapter.setStateAsync(`temperature.${key}.last_valid_value`, {
+                val: value,
+                ack: true,
+            });
+            await this.adapter.setStateAsync(`temperature.${key}.last_valid_value_at`, {
+                val: isoTime,
+                ack: true,
+            });
+            await this.adapter.setStateAsync(`temperature.${key}.minutes_since_last_value`, {
+                val: minutesSince,
+                ack: true,
+            });
+            await this.adapter.setStateAsync(`temperature.${key}.source_status`, {
+                val: status,
+                ack: true,
+            });
+        } catch (err) {
+            this.adapter.log.warn(`[temperatureHelper] sensor diagnostics ${key} failed: ${err.message}`);
+        }
+    },
+
     async _maybeWriteDelta(stateId, a, b) {
         if (a === undefined || b === undefined) {
             return;
@@ -221,12 +260,90 @@ const temperatureHelper = {
         nextMidnight.setHours(24, 0, 0, 0);
         const msUntilMidnight = nextMidnight.getTime() - now.getTime();
 
-        this.resetTimer = setTimeout(() => {
-            this._resetMinMax();
+        this.resetTimer = this.adapter.setTimeout(async () => {
+            await this._resetMinMax();
             this._scheduleDailyReset(); // neu für nächsten Tag
         }, msUntilMidnight);
     },
 
+    // NEU: Sensor-Aktualität regelmäßig prüfen
+    _scheduleSensorDiagnostics() {
+        this.diagnosticTimer = this.adapter.setInterval(async () => {
+            for (const key of Object.keys(this.sensors)) {
+                try {
+                    const lastValidState = await this.adapter.getStateAsync(`temperature.${key}.last_valid_value_at`);
+                    const lastValidAt = lastValidState?.val;
+
+                    if (!lastValidAt) {
+                        await this.adapter.setStateAsync(`temperature.${key}.source_status`, {
+                            val: 'not_received',
+                            ack: true,
+                        });
+                        continue;
+                    }
+
+                    const lastTs = Date.parse(lastValidAt);
+                    if (!Number.isFinite(lastTs)) {
+                        await this.adapter.setStateAsync(`temperature.${key}.source_status`, {
+                            val: 'invalid_timestamp',
+                            ack: true,
+                        });
+                        continue;
+                    }
+
+                    const minutesSince = Math.max(0, Math.round((Date.now() - lastTs) / 60000));
+
+                    await this.adapter.setStateAsync(`temperature.${key}.minutes_since_last_value`, {
+                        val: minutesSince,
+                        ack: true,
+                    });
+
+                    await this.adapter.setStateAsync(`temperature.${key}.source_status`, {
+                        val: minutesSince <= 15 ? 'ok' : 'warning',
+                        ack: true,
+                    });
+
+                    if (minutesSince > 15) {
+                        await this._tryRecoverSensorValue(key, minutesSince);
+                    }
+                } catch (err) {
+                    this.adapter.log.warn(`[temperatureHelper] sensor diagnostic check ${key} failed: ${err.message}`);
+                }
+            }
+        }, 60 * 1000);
+    },
+
+    async _tryRecoverSensorValue(key, minutesSince) {
+        const sensorId = this.sensors[key];
+        if (!sensorId) {
+            return;
+        }
+
+        const now = Date.now();
+        const lastRun = this.recoveryLastRun[key] || 0;
+        if (now - lastRun < 10 * 60 * 1000) {
+            return;
+        }
+
+        this.recoveryLastRun[key] = now;
+        this.adapter.log.debug(
+            `[temperatureHelper] Recovery check started for ${key} (${sensorId}), stale for ${minutesSince} min`,
+        );
+
+        try {
+            const state = await this.adapter.getForeignStateAsync(sensorId);
+            if (!state || state.val === null || state.val === undefined || !Number.isFinite(Number(state.val))) {
+                this.adapter.log.debug(`[temperatureHelper] Recovery check failed for ${key}: no valid numeric value`);
+                return;
+            }
+
+            await this.handleStateChange(sensorId, state);
+            this.adapter.log.debug(`[temperatureHelper] Recovery check successful for ${key}: ${state.val}`);
+        } catch (err) {
+            this.adapter.log.debug(`[temperatureHelper] Recovery check failed for ${key}: ${err.message}`);
+        }
+    },
+
     async _resetMinMax() {
         this.adapter.log.debug('[temperatureHelper] Resetting daily min/max');
         for (const key of Object.keys(this.sensors)) {
@@ -264,9 +381,14 @@ const temperatureHelper = {
 
     cleanup() {
         if (this.resetTimer) {
-            clearTimeout(this.resetTimer);
+            this.adapter.clearTimeout(this.resetTimer);
             this.resetTimer = null;
         }
+
+        if (this.diagnosticTimer) {
+            this.adapter.clearInterval(this.diagnosticTimer);
+            this.diagnosticTimer = null;
+        }
     },
 };
 

package/lib/stateDefinitions/temperatureStates.js

@@ -214,6 +214,86 @@ async function createTemperatureStates(adapter) {
             },
             native: {},
         });
+
+        // NEU: Diagnose-States für letzte gültige Sensorwerte
+
+        await adapter.setObjectNotExistsAsync(`temperature.${sensorKey}.last_valid_value`, {
+            type: 'state',
+            common: {
+                name: {
+                    en: `Last valid value sensor ${label.en}`,
+                    de: `Letzter gueltiger Wert Sensor ${label.de}`,
+                },
+                desc: {
+                    en: `Last valid temperature value of the ${label.en} sensor`,
+                    de: `Letzter gueltiger Temperaturwert des Sensors ${label.de}`,
+                },
+                type: 'number',
+                role: 'value.temperature',
+                unit: '°C',
+                read: true,
+                write: false,
+            },
+            native: {},
+        });
+
+        await adapter.setObjectNotExistsAsync(`temperature.${sensorKey}.last_valid_value_at`, {
+            type: 'state',
+            common: {
+                name: {
+                    en: `Last valid value time sensor ${label.en}`,
+                    de: `Zeitpunkt letzter gueltiger Temperaturwert Sensor ${label.de}`,
+                },
+                desc: {
+                    en: `Timestamp of the last valid temperature value of the ${label.en} sensor`,
+                    de: `Zeitpunkt des letzten gueltigen Temperaturwertes des Sensors ${label.de}`,
+                },
+                type: 'string',
+                role: 'value.time',
+                read: true,
+                write: false,
+            },
+            native: {},
+        });
+
+        await adapter.setObjectNotExistsAsync(`temperature.${sensorKey}.minutes_since_last_value`, {
+            type: 'state',
+            common: {
+                name: {
+                    en: `Minutes since last value sensor ${label.en}`,
+                    de: `Minuten seit letztem Wert Sensor ${label.de}`,
+                },
+                desc: {
+                    en: `Minutes since the last valid temperature value of the ${label.en} sensor`,
+                    de: `Minuten seit dem letzten gueltigen Temperaturwert des Sensors ${label.de}`,
+                },
+                type: 'number',
+                role: 'value',
+                unit: 'min',
+                read: true,
+                write: false,
+            },
+            native: {},
+        });
+
+        await adapter.setObjectNotExistsAsync(`temperature.${sensorKey}.source_status`, {
+            type: 'state',
+            common: {
+                name: {
+                    en: `Source status sensor ${label.en}`,
+                    de: `Quellenstatus Sensor ${label.de}`,
+                },
+                desc: {
+                    en: `Diagnostic status of the configured source for the ${label.en} sensor`,
+                    de: `Diagnosestatus der konfigurierten Quelle fuer den Sensor ${label.de}`,
+                },
+                type: 'string',
+                role: 'text',
+                read: true,
+                write: false,
+            },
+            native: {},
+        });
     }
 
     // Reihenfolge wie in der Instanz-Config (jsonConfig)

package/package.json

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