iobroker.miele-local 0.3.43 → 0.3.44

package/README.md

@@ -237,6 +237,9 @@ engineering work of the projects `MieleRESTServer` (akappner),
 	### **WORK IN PROGRESS**
 -->
 
+### 0.3.44
+- (SmarthomeElektroniker) History objects are only rewritten when they actually changed - this prevents an empty (null) point in the history adapter after every adapter restart
+
 ### 0.3.43
 
 - (SmarthomeElektroniker) All log messages are English now; diagnostic texts in states (`finding`, `check`, `progress`, `scanState`, `trendSize`), error messages and the CSV export too (review 2026-09-27)

package/io-package.json

@@ -1,7 +1,7 @@
 {
   "common": {
     "name": "miele-local",
-    "version": "0.3.43",
+    "version": "0.3.44",
     "titleLang": {
       "en": "Miele@local",
       "de": "Miele@local",
@@ -52,6 +52,19 @@
     "readme": "https://github.com/SmarthomeElektroniker/ioBroker.miele-local/blob/main/README.md",
     "loglevel": "info",
     "news": {
+      "0.3.44": {
+        "en": "History objects are only rewritten when they actually changed - no more empty (null) points in the history adapter after every restart",
+        "de": "History-Objekte werden nur noch geschrieben, wenn sie sich wirklich geändert haben - keine leeren (null) Punkte mehr im History-Adapter nach jedem Neustart",
+        "ru": "Объекты истории перезаписываются только при реальном изменении - больше нет пустых (null) точек в адаптере history после каждого перезапуска",
+        "pt": "Os objetos de histórico só são regravados quando realmente mudam - sem mais pontos vazios (null) no adaptador history após cada reinício",
+        "nl": "Historie-objecten worden alleen herschreven als ze echt gewijzigd zijn - geen lege (null) punten meer in de history-adapter na elke herstart",
+        "fr": "Les objets d'historique ne sont réécrits que s'ils ont réellement changé - plus de points vides (null) dans l'adaptateur history après chaque redémarrage",
+        "it": "Gli oggetti della cronologia vengono riscritti solo se sono effettivamente cambiati - niente più punti vuoti (null) nell'adattatore history dopo ogni riavvio",
+        "es": "Los objetos de historial solo se reescriben cuando realmente cambian - ya no hay puntos vacíos (null) en el adaptador history tras cada reinicio",
+        "pl": "Obiekty historii są zapisywane ponownie tylko przy rzeczywistej zmianie - koniec z pustymi (null) punktami w adapterze history po każdym restarcie",
+        "uk": "Об'єкти історії перезаписуються лише за реальної зміни - більше немає порожніх (null) точок в адаптері history після кожного перезапуску",
+        "zh-cn": "历史对象仅在实际更改时才会重写 - 每次重启后 history 适配器中不再出现空 (null) 点"
+      },
       "0.3.43": {
         "en": "All log messages, diagnostic texts in states, error messages and the CSV export are English now; the admin UI uses English i18n keys and the diagnostics tab is translated into all 11 languages.",
         "de": "Alle Logmeldungen, Diagnosetexte in Datenpunkten, Fehlermeldungen und der CSV-Export sind jetzt englisch; die Admin-Oberfläche nutzt englische i18n-Schlüssel, der Diagnose-Reiter ist in alle 11 Sprachen übersetzt.",
@@ -129,19 +142,6 @@
         "pl": "Identyfikatory obiektów są teraz w całości angielskie: \"sammlung\" zmieniono na \"collection\", \"befund\" na \"finding\", a \"laufendSeit\" na \"runningSince\". Przy pierwszym uruchomieniu adapter przenosi istniejące wartości na nowe identyfikatory; własne skrypty trzeba dostosować, a zapisana historia pozostaje pod starym identyfikatorem w adapterze history. Ponadto od wersji 0.3.5: woda jest odczytywana ze sprawdzonego pola DOP2 i pobierana w pierwszej kolejności z EcoFeedback urządzenia, wewnętrzne wartości urządzenia można tworzyć jako stany, osobna zakładka diagnostyczna z eksportem CSV zbiera pola surowe, a konfigurowalne interwały są ograniczane w czasie działania.",
         "uk": "Ідентифікатори об'єктів тепер повністю англійські: \"sammlung\" стало \"collection\", \"befund\" — \"finding\", \"laufendSeit\" — \"runningSince\". Під час першого запуску адаптер переносить наявні значення на нові ідентифікатори; власні скрипти потрібно оновити, а записана історія залишається зі старим ідентифікатором в адаптері history. Крім того, починаючи з 0.3.5: вода зчитується з перевіреного поля DOP2 і насамперед береться з EcoFeedback самого приладу, внутрішні величини приладу можна створювати як стани, окрема вкладка діагностики з експортом у CSV збирає сирі поля, а налаштовувані інтервали обмежуються під час роботи.",
         "zh-cn": "对象 ID 现已全部使用英文：\"sammlung\" 改为 \"collection\"，\"befund\" 改为 \"finding\"，\"laufendSeit\" 改为 \"runningSince\"。首次启动时，适配器会把已有数值迁移到新的 ID；自建脚本需要相应调整，已记录的历史数据仍以旧 ID 保留在 history 适配器中。此外自 0.3.5 起：用水量取自经过验证的 DOP2 字段，并优先来自设备自身的 EcoFeedback；设备内部数值可创建为数据点；独立的诊断选项卡支持导出 CSV 以收集原始字段；可配置的轮询间隔在运行时会被限制。"
-      },
-      "0.3.5": {
-        "en": "Fix: appliance status no longer flips to \"off\" during a running program, and the remaining time is read from the correct field. Frozen EcoFeedback values are no longer booked as consumption, requests are serialised per appliance, and a cycle survives an adapter restart. EcoFeedback is only requested while an appliance is actually running. Login instructions and datapoint names translated into all supported languages.",
-        "de": "Fix: Der Geraetestatus springt waehrend eines laufenden Programms nicht mehr auf \"Aus\", und die Restzeit wird aus dem richtigen Feld gelesen. Eingefrorene EcoFeedback-Werte werden nicht mehr als Verbrauch gebucht, Anfragen laufen je Geraet nacheinander, und ein Zyklus ueberlebt einen Adapter-Neustart. EcoFeedback wird nur noch abgefragt, solange ein Geraet laeuft. Login-Anleitung und Datenpunktnamen in alle unterstuetzten Sprachen uebersetzt.",
-        "ru": "Исправлено: во время работы программы статус прибора больше не переключается на «выкл.», а оставшееся время считывается из правильного поля. Застывшие значения EcoFeedback больше не учитываются как потребление, запросы к каждому прибору выполняются последовательно, а цикл сохраняется после перезапуска адаптера. EcoFeedback запрашивается только тогда, когда прибор действительно работает. Инструкции по входу и названия точек данных переведены на все поддерживаемые языки.",
-        "pt": "Correção: o estado do aparelho já não muda para \"desligado\" durante um programa em curso, e o tempo restante é lido do campo correto. Valores EcoFeedback congelados já não são contabilizados como consumo, os pedidos são serializados por aparelho e um ciclo sobrevive a um reinício do adaptador. O EcoFeedback só é pedido enquanto o aparelho está realmente a funcionar. Instruções de início de sessão e nomes dos pontos de dados traduzidos para todos os idiomas suportados.",
-        "nl": "Opgelost: de apparaatstatus springt tijdens een lopend programma niet meer naar \"uit\", en de resterende tijd wordt uit het juiste veld gelezen. Bevroren EcoFeedback-waarden worden niet meer als verbruik geboekt, verzoeken worden per apparaat na elkaar afgehandeld en een cyclus overleeft een herstart van de adapter. EcoFeedback wordt alleen opgevraagd terwijl een apparaat echt draait. Inloginstructies en datapuntnamen vertaald in alle ondersteunde talen.",
-        "fr": "Correction : l'état de l'appareil ne passe plus à « arrêt » pendant un programme en cours, et le temps restant est lu dans le bon champ. Les valeurs EcoFeedback figées ne sont plus comptabilisées comme consommation, les requêtes sont sérialisées par appareil et un cycle survit à un redémarrage de l'adaptateur. EcoFeedback n'est interrogé que lorsqu'un appareil fonctionne réellement. Instructions de connexion et noms des points de données traduits dans toutes les langues prises en charge.",
-        "it": "Correzione: lo stato dell'apparecchio non passa più a \"spento\" durante un programma in corso e il tempo rimanente viene letto dal campo corretto. I valori EcoFeedback bloccati non vengono più contabilizzati come consumo, le richieste vengono serializzate per apparecchio e un ciclo sopravvive a un riavvio dell'adattatore. EcoFeedback viene richiesto solo mentre un apparecchio è effettivamente in funzione. Istruzioni di accesso e nomi dei punti dati tradotti in tutte le lingue supportate.",
-        "es": "Corrección: el estado del aparato ya no cambia a \"apagado\" durante un programa en curso, y el tiempo restante se lee del campo correcto. Los valores EcoFeedback congelados ya no se contabilizan como consumo, las solicitudes se serializan por aparato y un ciclo sobrevive a un reinicio del adaptador. EcoFeedback solo se solicita mientras un aparato está realmente en funcionamiento. Instrucciones de inicio de sesión y nombres de puntos de datos traducidos a todos los idiomas compatibles.",
-        "pl": "Poprawka: stan urządzenia nie przełącza się już na „wyłączone” w trakcie trwającego programu, a pozostały czas jest odczytywany z właściwego pola. Zamrożone wartości EcoFeedback nie są już księgowane jako zużycie, zapytania są szeregowane dla każdego urządzenia, a cykl przetrwa ponowne uruchomienie adaptera. EcoFeedback jest odpytywany tylko wtedy, gdy urządzenie faktycznie pracuje. Instrukcje logowania i nazwy punktów danych przetłumaczono na wszystkie obsługiwane języki.",
-        "uk": "Виправлено: під час роботи програми статус приладу більше не перемикається на «вимк.», а час, що залишився, зчитується з правильного поля. Застиглі значення EcoFeedback більше не враховуються як споживання, запити до кожного приладу виконуються послідовно, а цикл зберігається після перезапуску адаптера. EcoFeedback запитується лише тоді, коли прилад справді працює. Інструкції з входу та назви точок даних перекладено всіма підтримуваними мовами.",
-        "zh-cn": "修复：程序运行期间设备状态不再跳变为“关闭”，剩余时间从正确的字段读取。冻结的 EcoFeedback 数值不再计为能耗，每台设备的请求按顺序处理，程序周期可在适配器重启后保留。仅在设备实际运行时才请求 EcoFeedback。登录说明和数据点名称已翻译为所有支持的语言。"
       }
     },
     "mode": "daemon",

package/lib/objektabgleich.js

@@ -0,0 +1,41 @@
+'use strict';
+
+const { isDeepStrictEqual } = require('node:util');
+
+/**
+ * Ob ein vorhandenes Objekt nachgezogen werden muss.
+ *
+ * Ein extendObject auf ein unveraendertes Objekt ist nicht harmlos: Jeder Schreibvorgang loest
+ * beim history-Adapter ein objectChange aus. Hat er den Datenpunkt nur ueber storeState in seiner
+ * Liste (ohne common.custom), sieht er darin ein Objekt ohne History-Einstellung, meldet
+ * "disabled logging" und setzt einen Leerpunkt (null) als Lueckenmarke. Am 25./27.09.2026 stand
+ * so nach jedem Adapterneustart eine Luecke im Verlauf der Waschmaschine.
+ *
+ * Verglichen werden nur die Felder, die der Adapter selbst setzt - was andere (custom, Aliase,
+ * Raumzuordnung) dazugeschrieben haben, zaehlt nicht als Abweichung.
+ *
+ * @param {object|null|undefined} vorhanden Das Objekt aus der Datenbank (oder nichts)
+ * @param {{type?: string, common?: object, native?: object}} soll Was der Adapter schreiben wuerde
+ * @returns {boolean} true, wenn das Objekt fehlt oder ein gesetztes Feld abweicht
+ */
+function mussNachziehen(vorhanden, soll) {
+    if (!vorhanden) {
+        return true;
+    }
+    if (soll.type && vorhanden.type !== soll.type) {
+        return true;
+    }
+    const ist = vorhanden.common || {};
+    for (const [schluessel, wert] of Object.entries(soll.common || {})) {
+        // undefined heisst "nicht setzen" - extendObject ueberginge es ebenso.
+        if (wert === undefined) {
+            continue;
+        }
+        if (!isDeepStrictEqual(ist[schluessel], wert)) {
+            return true;
+        }
+    }
+    return false;
+}
+
+module.exports = { mussNachziehen };

package/main.js

@@ -48,6 +48,7 @@ const { MielePushListener } = require('./lib/push');
 const enroll = require('./lib/enroll');
 const dop2 = require('./lib/dop2');
 const stats = require('./lib/stats');
+const { mussNachziehen } = require('./lib/objektabgleich');
 
 /*
  * EcoFeedback: DOP2-Leaf 2/6195 (bislang nur Waschmaschinen liefern ihn).
@@ -2003,6 +2004,21 @@ class MieleLocal extends utils.Adapter {
         this._statsCreated[deviceId] = true;
     }
 
+    /**
+     * extendObject nur, wenn das Objekt fehlt oder sich etwas geaendert hat.
+     *
+     * Ein unnoetiger Schreibvorgang setzt beim history-Adapter einen Leerpunkt in den Verlauf
+     * (siehe lib/objektabgleich.js) - bei jedem Adapterstart eine Luecke im Diagramm.
+     *
+     * @param {string} id Objekt-ID relativ zur Instanz
+     * @param {object} soll Objekt, wie extendObject es bekaeme
+     */
+    async objektNachziehen(id, soll) {
+        if (mussNachziehen(await this.getObjectAsync(id), soll)) {
+            await this.extendObjectAsync(id, soll);
+        }
+    }
+
     async ensureHistoryObjects(deviceId) {
         if (!this._histCreated) {
             this._histCreated = {};
@@ -2019,7 +2035,7 @@ class MieleLocal extends utils.Adapter {
          */
         await this.ensureSammlungObjects(deviceId);
         const de = this.config.germanNames !== false;
-        await this.extendObjectAsync(`${deviceId}.history`, {
+        await this.objektNachziehen(`${deviceId}.history`, {
             type: 'channel',
             common: { name: namen.text('Verlauf', 'History', de) },
             native: {},
@@ -2111,7 +2127,7 @@ class MieleLocal extends utils.Adapter {
         ];
         for (const [sub, name, typ, rolle, einheit, def] of defs) {
             const hDesc = namen.beschreibung(`history.${sub}`, de); // Schluessel = tatsaechliche ID
-            await this.extendObjectAsync(`${deviceId}.history.${sub}`, {
+            await this.objektNachziehen(`${deviceId}.history.${sub}`, {
                 type: 'state',
                 common: Object.assign(
                     { name, type: typ, role: rolle, unit: einheit || undefined, def, read: true, write: false },
@@ -2127,10 +2143,12 @@ class MieleLocal extends utils.Adapter {
          * so seinen alten, nur zweisprachigen Namen, bis das Geraet wieder lief - die Objektpruefung
          * des PR #6471 fand das am 11.09.2026 an der ausgeschalteten Spuelmaschine.
          */
-        if (await this.getObjectAsync(`${deviceId}.info.operatingHours`)) {
-            await this.extendObjectAsync(`${deviceId}.info.operatingHours`, {
-                common: { name: namen.text('Betriebsstunden gesamt', 'Total operating hours', de) },
-            });
+        const stunden = await this.getObjectAsync(`${deviceId}.info.operatingHours`);
+        if (stunden) {
+            const soll = { common: { name: namen.text('Betriebsstunden gesamt', 'Total operating hours', de) } };
+            if (mussNachziehen(stunden, soll)) {
+                await this.extendObjectAsync(`${deviceId}.info.operatingHours`, soll);
+            }
         }
         this._histCreated[deviceId] = true;
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "iobroker.miele-local",
-  "version": "0.3.43",
+  "version": "0.3.44",
   "description": "Connect modern Miele@Home appliances locally without the internet (MieleH256/DOP2).",
   "author": "Immanuel <github@freitag.online>",
   "license": "MIT",