iobroker.zigbee2mqtt 3.1.1 → 3.2.0

package/README.md

@@ -22,77 +22,20 @@ This adapter allows to control the data points of the devices of a Zigbee2MQTT i
 [Adapter Documentation](https://github.com/arteck/ioBroker.zigbee2mqtt/blob/main/docs/wiki.md)
 
 ## Changelog
-### 3.1.1 (2026-04-21)
-* (arteck) fix connection handling
+### 3.2.0 (2026-04-26)
+* (arteck) del deprectated setStateAsync
 
-### 3.1.0 (2026-04-20)
-* (arteck) refactoring
+### 3.1.9 (2026-04-26)
+* (arteck) fix WS close
 
-### 3.0.22 (2026-04-12)
-* (arteck) Dependencies have been updated
+### 3.1.8 (2026-04-26)
+* (arteck) back to old dependency aedes
 
-### 3.0.21 (2026-01-29)
-* (arteck) add coordinator status info
+### 3.1.7 (2026-04-24)
+* (arteck) fix illuminance = 0
 
-### 3.0.20 (2026-01-29)
-* (arteck) check payload if undefined
-
-### 3.0.19 (2026-01-28)
-* (arteck) modify action dp
-
-### 3.0.18 (2026-01-28)
-* (arteck) typo
-
-### 3.0.17 (2026-01-28)
-* (arteck) typo
-
-### 3.0.16 (2026-01-28)
-* (arteck) fix action dp
-
-### 3.0.15 (2026-01-27)
-* (arteck) update
-
-### 3.0.14 (2026-01-27)
-* (arteck) back to sharp 0.33.5
-
-### 3.0.13 (2026-01-25)
-* (arteck) add action dp
-
-### 3.0.12 (2026-01-05)
-* (arteck) Dependencies have been updated
-* (MMeinhardt1) typo fix
-
-### 3.0.11 (2025-12-31)
--   (arteck) fix info.connection
-
-### 3.0.10 (2025-12-07)
--   (arteck) Dependencies have been updated
--   (bluefox) Changed role of `color_temp_startup` state to `level` to avoid double `level.temperature` in one device
--   (arteck) fix ZBMINIR2 inching DP
--   (arteck) delete DP colortempstartup
-
-### 3.0.9 (2025-06-19)
--   (bjoernbusch) queue up message parsing
--   (dotcom84) Support for non-default MQTT base topics
-
-### 3.0.8 (2025-06-08)
--   (arteck) fix device is deleted
--   (arteck) fix translation
-
-### 3.0.7 (2025-06-07)
--   (arteck) fix jsonconf
-
-### 3.0.6 (2025-05-31)
--   (arteck) settings restructure
--   (arteck) fix icon not found message
-
-.
-.
-.
-
-### 0.1.0 (2022-09-29)
-
--   (o0shojo0o) first release
+### 3.1.5 (2026-04-23)
+* (arteck) fix illuminance
 
 ## License
 

package/io-package.json

@@ -1,72 +1,98 @@
 {
   "common": {
     "name": "zigbee2mqtt",
-    "version": "3.1.1",
+    "version": "3.2.0",
     "news": {
-      "3.1.1": {
-        "en": "fix connection handling",
-        "de": "befestigungstechnik",
-        "ru": "фиксировать связь",
-        "pt": "corrigir o tratamento da ligação",
-        "nl": "fix verbinding handling",
-        "fr": "fixer la manipulation de la connexion",
-        "it": "gestione del collegamento",
-        "es": "corrección de conexión",
-        "pl": "naprawić obsługę połączenia",
-        "uk": "кріплення з'єднання",
-        "zh-cn": "固定连接处理"
+      "3.2.0": {
+        "en": "del deprectated setStateAsync",
+        "de": "del deprected setStateAsync",
+        "ru": "обсуждение StateAsync",
+        "pt": "del deprectated setStateAsync",
+        "nl": "del deprectated setStateAsync",
+        "fr": "set dépréciéStateAsync",
+        "it": "del set deprettatoStateAsync",
+        "es": "del deprectated setStateAsync",
+        "pl": "del deprectated setStateAsync",
+        "uk": "deprectated setStateAsync",
+        "zh-cn": "已贬值的设置"
       },
-      "3.0.21": {
-        "en": "add coordinator status info",
-        "de": "koordinator statusinfo hinzufügen",
-        "ru": "добавить информацию о статусе координатора",
-        "pt": "adicionar informações sobre o estado do coordenador",
-        "nl": "coordinator status info toevoegen",
-        "fr": "ajouter le statut du coordonnateur info",
-        "it": "aggiungere coordinate status info",
-        "es": "añadir información sobre el estado de coordinador",
-        "pl": "dodaj informacje o statusie koordynatora",
-        "uk": "додати інформацію про статус координатора",
-        "zh-cn": "添加协调员状态信息"
+      "3.1.9": {
+        "en": "fix WS close",
+        "de": "wS schließen",
+        "ru": "закрыть WS Close",
+        "pt": "corrigir WS fechar",
+        "nl": "wS sluiten herstellen",
+        "fr": "correction WS fermer",
+        "it": "fix WS chiudi",
+        "es": "arreglar WS close",
+        "pl": "fix WS close",
+        "uk": "застібка WS",
+        "zh-cn": "修复 WS 关闭"
       },
-      "3.0.20": {
-        "en": "check payload if undefined",
-        "de": "prüfen sie die nutzlast",
-        "ru": "проверьте полезную нагрузку, если не определено",
-        "pt": "verificar a carga útil se não for definida",
-        "nl": "payload controleren indien niet gedefinieerd",
-        "fr": "vérifier la charge utile si elle n'est pas définie",
-        "it": "controllare il carico utile se non definito",
-        "es": "check payload si no está definido",
-        "pl": "sprawdzanie ładunku użytecznego, jeżeli nie określono",
-        "uk": "перевірити навантаження, якщо не визначено",
-        "zh-cn": "检查未定义的有效载荷"
+      "3.1.8": {
+        "en": "back to old dependency aedes",
+        "de": "zurück zu den alten abhängigkeiten",
+        "ru": "возвращение к старой зависимости",
+        "pt": "voltar ao velho aedes dependência",
+        "nl": "terug naar oude afhankelijkheid",
+        "fr": "retour à de vieilles dépendances",
+        "it": "torna alla vecchia dipendenza",
+        "es": "volver a las viejas",
+        "pl": "powrót do dawnej zależności",
+        "uk": "назад до старих залежностей",
+        "zh-cn": "回到旧的依附物"
       },
-      "3.0.19": {
-        "en": "modify action dp",
-        "de": "änderung der aktion dp",
-        "ru": "модифицировать действие dp",
-        "pt": "modificar ação dp",
-        "nl": "actie dp wijzigen",
-        "fr": "modifier l'action dp",
-        "it": "modificare l'azione",
-        "es": "modificar la acción dp",
-        "pl": "modyfikacja działania dp",
-        "uk": "змінити дію dp",
-        "zh-cn": "修改动作 dp"
+      "3.1.7": {
+        "en": "fix illuminance = 0",
+        "de": "fixe beleuchtungsstärke = 0",
+        "ru": "фиксированная освещенность = 0",
+        "pt": "iluminação de fixação = 0",
+        "nl": "fix verlichtingssterkte = 0",
+        "fr": "fixer l'éclairage = 0",
+        "it": "illuminazione di correzione = 0",
+        "es": "iluminación de fijación = 0",
+        "pl": "podświetlenie = 0",
+        "uk": "фіксувати ілюмінанс = 0",
+        "zh-cn": "固定灯光=0"
       },
-      "3.0.18": {
-        "en": "typo",
-        "de": "typo",
-        "ru": "опечатка",
-        "pt": "erro de digitação",
-        "nl": "type",
-        "fr": "typo",
-        "it": "tipo",
-        "es": "typo",
-        "pl": "typo",
-        "uk": "типи",
-        "zh-cn": "类型"
+      "3.1.6": {
+        "en": "fix illuminance = 0",
+        "de": "fixe beleuchtungsstärke = 0",
+        "ru": "фиксированная освещенность = 0",
+        "pt": "iluminação de fixação = 0",
+        "nl": "fix verlichtingssterkte = 0",
+        "fr": "fixer l'éclairage = 0",
+        "it": "illuminazione di correzione = 0",
+        "es": "iluminación de fijación = 0",
+        "pl": "podświetlenie = 0",
+        "uk": "фіксувати ілюмінанс = 0",
+        "zh-cn": "固定灯光=0"
+      },
+      "3.1.5": {
+        "en": "fix illuminance",
+        "de": "befestigungsleuchten",
+        "ru": "фиксировать освещенность",
+        "pt": "fixar a iluminação",
+        "nl": "fix verlichtingssterkte",
+        "fr": "fixer l'éclairage",
+        "it": "illuminazione di correzione",
+        "es": "iluminación de fijación",
+        "pl": "podświetlenie",
+        "uk": "фіксувати ілюмінанс",
+        "zh-cn": "修补灯光"
+      },
+      "3.1.4": {
+        "en": "fix illuminance if not exists. we calculate it ourselves",
+        "de": "fixe beleuchtungsstärke, wenn nicht vorhanden. wir berechnen es selbst",
+        "ru": "установить свет, если его нет. мы сами вычисляем",
+        "pt": "fixar a iluminação se não existir. nós mesmos calculamos",
+        "nl": "fix verlichtingssterkte indien niet bestaat. we berekenen het zelf",
+        "fr": "fixer l'éclairage s'il n'existe pas. nous le calculons nous-mêmes",
+        "it": "fissare l'illuminazione se non esiste. noi lo calcoliamo noi stessi",
+        "es": "fijar la iluminación si no existe. lo calculamos nosotros mismos",
+        "pl": "naprawić oświetlenie, jeśli nie istnieje. sami to obliczymy",
+        "uk": "зафіксувати ілюмінанс, якщо не існує. ми розраховуємо самі",
+        "zh-cn": "如果不存在的话, 则固定灯光。 我们自己计算"
       }
     },
     "messages": [

package/lib/check.js

@@ -1,8 +1,10 @@
 /**
+ * Prüft die Zigbee2MQTT-Konfiguration auf veraltete/inkompatible Einstellungen
+ * und gibt Fehlermeldungen mit Korrekturhinweisen aus.
  *
- * @param config
- * @param log
- * @param version
+ * @param {object} config  Der config-Block aus dem bridge/info-Payload
+ * @param {object} log     Das ioBroker-Log-Objekt (this.log)
+ * @param {string} version Die Zigbee2MQTT-Versionsnummer (z.B. "1.35.0")
  */
 function checkConfig(config, log, version) {
     if (!config || !log) {
@@ -55,7 +57,7 @@ function checkConfig(config, log, version) {
         }
     }
     if (Object.values(checkAPIOptionsOutput).filter((x) => x === true).length > 0) {
-        if (checkAPIOptions.payload_contains_not_json === true ) {
+        if (checkAPIOptionsOutput.payload_contains_not_json === true) {
             log.error('===================================================');
             log.error(
                 'MQTT output type must "attribute_and_json" or "json" , therefore the adapter may process the states of the devices correctly!!!'

package/lib/colors.js

@@ -431,8 +431,8 @@ const namedColors = {
 function NamedColorToRGBstring(name) {
     const lowerName = name.toLowerCase();
     if (namedColors.hasOwnProperty(lowerName)) {
-return namedColors[lowerName].rgb;
-}
+        return namedColors[lowerName].rgb;
+    }
     return '#0088FF';
 }
 
@@ -444,13 +444,13 @@ function ParseColor(rgbstring) {
     if (typeof rgbstring === 'string') {
         const lowerName = rgbstring.toLowerCase();
         if (namedColors.hasOwnProperty(lowerName)) {
-rgbstring = namedColors[lowerName].rgb;
-}
+            rgbstring = namedColors[lowerName].rgb;
+        }
         rgbstring = rgbstring.trim();
         if (rgbstring.startsWith('#')) {
-rgbstring = rgbstring.slice(1);
-}
-        const val = parseInt(`0x${  rgbstring}`);
+            rgbstring = rgbstring.slice(1);
+        }
+        const val = parseInt(`0x${rgbstring}`);
         const oneColor = {};
         oneColor.r = Math.floor(val / (256 * 256));
         oneColor.g = Math.floor((val % (256 * 256)) / 256);
@@ -466,8 +466,8 @@ rgbstring = rgbstring.slice(1);
  */
 function NamedColorToRGB(name) {
     if (namedColors.hasOwnProperty(name)) {
-return ParseColor(namedColors[name].rgb);
-}
+        return ParseColor(namedColors[name].rgb);
+    }
     return { r: 0, g: 128, b: 255 };
 }
 module.exports = {

package/lib/deviceController.js

@@ -6,17 +6,32 @@ const rgb = require('./rgb.js');
 const ImageController = require('./imageController').ImageController;
 
 /**
+ * Prüft ob eine ieee_address in der kommaseparierten debugDevices-Liste enthalten ist.
+ * String.includes() würde Substring-Matches liefern (z.B. "0x12" trifft "0x1234").
  *
+ * @param {string} debugDevices
+ * @param {string} address
+ * @returns {boolean}
+ */
+function isDebugDevice(debugDevices, address) {
+    if (!debugDevices || !address) { return false; }
+    return String(debugDevices).split(',').map((s) => s.trim()).includes(address);
+}
+
+/**
+ * Verwaltet das Erstellen und Aktualisieren von Geräte- und Gruppenobjekten in ioBroker
+ * basierend auf den Zigbee2MQTT-Exposes.
  */
 class DeviceController {
     /**
+     * Erstellt eine neue DeviceController-Instanz.
      *
-     * @param adapter
-     * @param deviceCache
-     * @param groupCache
-     * @param config
-     * @param logCustomizations
-     * @param createCache
+     * @param {object} adapter           Die ioBroker-Adapter-Instanz
+     * @param {Array}  deviceCache       Gemeinsamer Cache aller bekannten Geräte
+     * @param {Array}  groupCache        Gemeinsamer Cache aller bekannten Gruppen
+     * @param {object} config            Adapter-Konfiguration
+     * @param {object} logCustomizations Debug/Filter-Einstellungen (debugDevices, logfilter)
+     * @param {object} createCache       Cache bereits erstellter ioBroker-Objekte
      */
     constructor(adapter, deviceCache, groupCache, config, logCustomizations, createCache) {
         this.adapter = adapter;
@@ -29,8 +44,10 @@ class DeviceController {
     }
 
     /**
+     * Erstellt Geräte-Definitionen aus dem bridge/devices-Payload von Zigbee2MQTT
+     * und befüllt den deviceCache neu.
      *
-     * @param devicesMessage
+     * @param {Array} devicesMessage Array mit Gerätedaten aus dem bridge/devices-Topic
      */
     async createDeviceDefinitions(devicesMessage) {
         // Fix 1: devicesMessage kann null/kein Array sein (z.B. leerer bridge/devices payload)
@@ -44,7 +61,7 @@ class DeviceController {
                 continue;
             }
 
-            if (this.logCustomizations.debugDevices.includes(devicesMessag.ieee_address)) {
+            if (isDebugDevice(this.logCustomizations.debugDevices, devicesMessag.ieee_address)) {
                 this.adapter.log.warn(
                     `--->>> fromZ2M -> ${devicesMessag.ieee_address} exposes: ${JSON.stringify(devicesMessag)}`
                 );
@@ -71,12 +88,13 @@ class DeviceController {
     }
 
     /**
+     * Erstellt die State-Definition für eine Zigbee2MQTT-Gruppe und legt sie im groupCache ab.
      *
-     * @param groupID
-     * @param ieee_address
-     * @param scenes
+     * @param {string} groupID      Friendly-Name der Gruppe (wird als ioBroker-ID verwendet)
+     * @param {string} ieee_address Interne Gruppen-ID (z.B. "group_1")
+     * @param {Array}  scenes       Liste der Szenen-Objekte ({id, name}) der Gruppe
      */
-    async defineGroupDevice(groupID, ieee_address, scenes) {
+    defineGroupDevice(groupID, ieee_address, scenes) {
         const brmPropName = this.adapter.config.brightnessMoveOnOff === true ? 'brightness_move_onoff' : 'brightness_move';
         const brsPropName = this.adapter.config.brightnessStepOnOff === true ? 'brightness_step_onoff' : 'brightness_step';
         const newDevice = {
@@ -187,6 +205,9 @@ class DeviceController {
                         if (payload.color_mode !== 'color_temp') {
                             return undefined;
                         }
+                        if (payload.color_temp == null) {
+                            return undefined;
+                        }
                         if (this.config.useKelvin === true) {
                             return utils.miredKelvinConversion(payload.color_temp);
                         }
@@ -233,7 +254,7 @@ class DeviceController {
             const sceneSate = {
                 id: `scene_${scene.id}`,
                 prop: `scene_recall`,
-                name: scene.name,
+                name: scene.name || `Scene ${scene.id}`,
                 icon: undefined,
                 role: 'button',
                 write: true,
@@ -251,8 +272,10 @@ class DeviceController {
     }
 
     /**
+     * Erstellt Gruppen-Definitionen aus dem bridge/groups-Payload von Zigbee2MQTT
+     * und befüllt den groupCache neu.
      *
-     * @param groupsMessage
+     * @param {Array} groupsMessage Array mit Gruppendaten aus dem bridge/groups-Topic
      */
     async createGroupDefinitions(groupsMessage) {
         // Fix 4: groupsMessage kann null/kein Array sein
@@ -266,15 +289,16 @@ class DeviceController {
             if (!groupMessage || groupMessage.id == null || !groupMessage.friendly_name) {
                 continue;
             }
-            if (this.logCustomizations.debugDevices.includes(String(groupMessage.id))) {
+            if (isDebugDevice(this.logCustomizations.debugDevices, String(groupMessage.id))) {
                 this.adapter.log.warn(`--->>> fromZ2M -> ${groupMessage.id} exposes: ${JSON.stringify(groupMessage)}`);
             }
-            await this.defineGroupDevice(groupMessage.friendly_name, `group_${groupMessage.id}`, groupMessage.scenes || []);
+            this.defineGroupDevice(groupMessage.friendly_name, `group_${groupMessage.id}`, groupMessage.scenes || []);
         }
     }
 
     /**
-     *
+     * Legt alle Geräte und Gruppen aus den Caches als ioBroker-Objekte an
+     * bzw. aktualisiert sie falls sich Name oder Beschreibung geändert haben.
      */
     async createOrUpdateDevices() {
         // Gruppen und Geräte getrennt verarbeiten
@@ -287,12 +311,14 @@ class DeviceController {
     }
 
     /**
-     * @param device
-     * @param isGroup
+     * Legt ein einzelnes Gerät oder eine Gruppe als ioBroker-Objekt an oder aktualisiert es.
+     *
+     * @param {object}  device   Das Gerät/Gruppen-Objekt aus dem Cache
+     * @param {boolean} isGroup  true = Gruppe, false = echtes Gerät
      */
     async _createOrUpdateSingleDevice(device, isGroup) {
-        let deviceName = await this.getDeviceName(device);
-        let description = await this.getDeviceDescription(device);
+        let deviceName = this.getDeviceName(device);
+        let description = this.getDeviceDescription(device);
 
         if (deviceName === '' && device.description) {
             deviceName = device.description;
@@ -304,7 +330,9 @@ class DeviceController {
             if (this.config.useEventInDesc === true) {
                 description = 'Device is disabled!';
             } else {
-                deviceName = `[Disabled] ${deviceName}`;
+                // Fallback auf ieee_address wenn kein friendly_name vorhanden
+                const label = deviceName || device.ieee_address;
+                deviceName = `[Disabled] ${label}`;
             }
         }
 
@@ -331,7 +359,12 @@ class DeviceController {
             }
 
             await this.adapter.extendObjectAsync(device.ieee_address, deviceObj);
-            this.createCache[device.ieee_address] = { name: deviceName, description: description };
+            // Bestehende State-Einträge im Cache bewahren – nur name/description aktualisieren
+            if (!this.createCache[device.ieee_address]) {
+                this.createCache[device.ieee_address] = {};
+            }
+            this.createCache[device.ieee_address].name        = deviceName;
+            this.createCache[device.ieee_address].description = description;
         }
 
         if (!Array.isArray(device.states)) {
@@ -358,7 +391,7 @@ class DeviceController {
 
                 const iobState = {
                     type: 'state',
-                    common: await this.copyAndCleanStateObj(state),
+                    common: this.copyAndCleanStateObj(state),
                     native: {},
                 };
 
@@ -369,13 +402,18 @@ class DeviceController {
     }
 
     /**
-     * Nur echte Geräte prüfen – Gruppen werden hier nie verarbeitet
+     * Prüft alle in ioBroker vorhandenen Geräte-Objekte gegen den deviceCache und markiert
+     * nicht mehr vorhandene Geräte als "[Removed]" bzw. setzt available auf false.
      */
     async checkAndProgressDeviceRemove() {
         let iobDevices = await this.adapter.getDevicesAsync();
-        // Nur nicht-entfernte, echte Geräte (keine Gruppen)
-        iobDevices = iobDevices.filter((x) => x.native && x.native.deviceRemoved === false);
-        iobDevices = iobDevices.filter((x) => x.native && x.native.groupDevice === false);
+        if (!iobDevices) {
+            return;
+        }
+        // Nur nicht-entfernte, echte Geräte (keine Gruppen) in einem Schritt filtern
+        iobDevices = iobDevices.filter((x) =>
+            x.native && x.native.deviceRemoved === false && x.native.groupDevice === false
+        );
 
         for (const iobDevice of iobDevices) {
             const idParts = iobDevice._id.split('.');
@@ -407,13 +445,17 @@ class DeviceController {
     }
 
     /**
+     * Aktualisiert die Geräte-ID im Cache wenn ein Gerät in Zigbee2MQTT umbenannt wurde.
      *
-     * @param messageObj
+     * @param {{ payload: { data: { from: string, to: string } } }} messageObj Die Rename-Nachricht
      */
     async renameDeviceInCache(messageObj) {
         if (!messageObj.payload || !messageObj.payload.data) {
             return;
         }
+        if (!messageObj.payload.data.from || !messageObj.payload.data.to) {
+            return;
+        }
         const renamedDevice = this.groupCache
             .concat(this.deviceCache)
             .find((x) => x.id === messageObj.payload.data.from);
@@ -423,9 +465,10 @@ class DeviceController {
     }
 
     /**
+     * Entfernt ein Gerät anhand seiner IEEE-Adresse aus dem angegebenen Cache-Array.
      *
-     * @param devices
-     * @param ieee_address
+     * @param {Array}  devices      Das Cache-Array (deviceCache oder groupCache)
+     * @param {string} ieee_address Die IEEE-Adresse des zu entfernenden Geräts
      */
     removeDeviceByIeee(devices, ieee_address) {
         const idx = devices.findIndex((x) => x.ieee_address === ieee_address);
@@ -435,10 +478,13 @@ class DeviceController {
     }
 
     /**
+     * Erstellt eine bereinigte Kopie eines State-Objekts ohne interne Laufzeit-Felder
+     * (getter, setter, prop, etc.) für die ioBroker-Objektdefinition.
      *
-     * @param state
+     * @param {object} state Das vollständige State-Objekt mit Laufzeit-Feldern
+     * @returns {object}     Das bereinigte State-Objekt für extendObjectAsync
      */
-    async copyAndCleanStateObj(state) {
+    copyAndCleanStateObj(state) {
         const iobState = { ...state };
         const blacklistedKeys = [
             'prop',
@@ -460,26 +506,33 @@ class DeviceController {
     }
 
     /**
+     * Gibt den Anzeigenamen eines Geräts zurück.
+     * Ist friendly_name gleich der IEEE-Adresse, wird ein leerer String zurückgegeben.
      *
-     * @param device
+     * @param {object} device Das Geräteobjekt aus dem Cache
+     * @returns {string}      Der Anzeigename oder ""
      */
     getDeviceName(device) {
         return device.id === device.ieee_address ? '' : device.id;
     }
 
     /**
+     * Gibt die Beschreibung eines Geräts zurück (oder "" wenn keine vorhanden).
      *
-     * @param device
+     * @param {object} device Das Geräteobjekt aus dem Cache
+     * @returns {string}      Die Beschreibung oder ""
      */
     getDeviceDescription(device) {
         return device.description ? device.description : '';
     }
 
     /**
+     * Verarbeitet die Antwort eines Coordinator-Check-Requests von Zigbee2MQTT
+     * und schreibt fehlende Router in die info-States.
      *
-     * @param payload
+     * @param {{ data: { missing_routers: Array } }} payload Der Antwort-Payload
      */
-    processCoordinatorCheck(payload) {
+    async processCoordinatorCheck(payload) {
         if (payload && payload.data && payload.data.missing_routers) {
             const missingRoutersCount = payload.data.missing_routers.length;
             this.adapter.setState('info.missing_routers', JSON.stringify(payload.data.missing_routers), true);