iobroker.zigbee2mqtt 3.1.1 → 3.1.5

package/README.md

@@ -22,6 +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.5 (2026-04-23)
+* (arteck) fix illuminance
+
+### 3.1.4 (2026-04-23)
+* (arteck) fix illuminance if not exists. we calculate it ourselves
+
+### 3.1.3 (2026-04-23)
+* (arteck) fix illuminance_raw 
+* (arteck) fix illuminance
+* (arteck) fix action state
+
+### 3.1.2 (2026-04-23)
+* (arteck) add test
+
 ### 3.1.1 (2026-04-21)
 * (arteck) fix connection handling
 

package/io-package.json

@@ -1,8 +1,60 @@
 {
   "common": {
     "name": "zigbee2mqtt",
-    "version": "3.1.1",
+    "version": "3.1.5",
     "news": {
+      "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": "如果不存在的话, 则固定灯光。 我们自己计算"
+      },
+      "3.1.3": {
+        "en": "fix illuminance_raw \nfix illuminance\nfix action state",
+        "de": "fix illuminance raw\nbefestigungsleuchten\nfixer aktionszustand",
+        "ru": "осветительный прибор raw\nфиксировать освещенность\nопределить состояние",
+        "pt": "corrigir illuminance  raw\nfixar a iluminação\ncorrigir o estado da ação",
+        "nl": "fix illuminantie raw\nfix verlichtingssterkte\nfix actiestatus",
+        "fr": "correction de l'éclairage raw\nfixer l'éclairage\nfixer l'état d'action",
+        "it": "correzione illuminazione raw\nilluminazione di correzione\nfix azione stato",
+        "es": "iluminación raw\niluminación de fijación\nestado de acción",
+        "pl": "fix lightinance _ raw\npodświetlenie\nstan działania",
+        "uk": "фіксація талії raw\nфіксувати ілюмінанс\nфіксувати стан дії",
+        "zh-cn": "修补灯光  raw\n修补灯光\n固定动作状态"
+      },
+      "3.1.2": {
+        "en": "add test",
+        "de": "test hinzufügen",
+        "ru": "добавить тест",
+        "pt": "adicionar teste",
+        "nl": "test toevoegen",
+        "fr": "ajouter un essai",
+        "it": "aggiungere test",
+        "es": "agregar la prueba",
+        "pl": "dodać test",
+        "uk": "додати тест",
+        "zh-cn": "添加测试"
+      },
       "3.1.1": {
         "en": "fix connection handling",
         "de": "befestigungstechnik",
@@ -41,32 +93,6 @@
         "pl": "sprawdzanie ładunku użytecznego, jeżeli nie określono",
         "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.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": "类型"
       }
     },
     "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,30 +506,37 @@ 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);
-            this.adapter.setState('info.missing_routers_count', missingRoutersCount, true);
+            await this.adapter.setStateAsync('info.missing_routers', JSON.stringify(payload.data.missing_routers), true);
+            await this.adapter.setStateAsync('info.missing_routers_count', missingRoutersCount, true);
 
             if (missingRoutersCount > 0) {
                 const logLvl = this.config.coordinatorCheckLogLvl;

package/lib/exposes.js

@@ -726,9 +726,23 @@ async function createDeviceFromExposes(devicesMessag, adapter) {
                                 break;
 
                             case 'illuminance':
-                                // Z2M sendet 'illuminance' = Rohwert (kein lux)
-                                // 'illuminance_lux' = Wert in Lux → eigener case unten
-                                state = statesDefs.illuminance_raw;
+                                // Z2M sendet 'illuminance' = Rohwert (kein Lux)
+                                // Wir legen BEIDE States an:
+                                //   1. illuminance_raw  – der unveränderte Rohwert
+                                //   2. illuminance      – in Lux konvertiert (10^(raw/10000))
+                                // Damit bleiben bestehende Scripts auf illuminance_raw kompatibel
+                                // und neue Scripts können direkt illuminance (Lux) nutzen.
+                                pushToStates(statesDefs.illuminance_raw, expose.access);
+                                state = statesDefs.illuminance_from_raw;
+                                break;
+
+                            case 'illuminance_raw':
+                                // Gerät sendet payload.illuminance_raw direkt (eigener Expose-Typ)
+                                // Wir legen ebenfalls BEIDE States an:
+                                //   1. illuminance_raw  – der unveränderte Rohwert (prop='illuminance_raw')
+                                //   2. illuminance      – in Lux konvertiert (10^(raw/10000))
+                                pushToStates(statesDefs.illuminance_raw_direct, expose.access);
+                                state = statesDefs.illuminance_from_illuminance_raw;
                                 break;
 
                             case 'illuminance_lux':
@@ -1261,7 +1275,7 @@ async function createDeviceFromExposes(devicesMessag, adapter) {
                         const state = genState(prop);
                         // Workaround for FP1 new state (region_upsert)
                         if (!state) {
-                            break;
+                            continue;
                         }
 
                         state.prop          = expose.property;
@@ -1332,7 +1346,7 @@ async function createDeviceFromExposes(devicesMessag, adapter) {
         });
     }
 
-    const newDevice = {
+    return {
         id: deviceID,
         ieee_address: ieee_address,
         power_source: power_source,
@@ -1341,8 +1355,6 @@ async function createDeviceFromExposes(devicesMessag, adapter) {
         optionsValues: {},
         states: states,
     };
-
-    return newDevice;
 }
 
 module.exports = {