iobroker.zigbee 3.0.3 → 3.0.5

package/README.md

@@ -152,6 +152,11 @@ You can thank the authors by these links:
 
 -----------------------------------------------------------------------------------------------------
 ## Changelog
+### 3.0.5 (2025-08-27)
+* (asgothian) fix random error where devices are not shown due to illegal groups
+* (asgothian) drop support for node 18
+* (asgothian) Required node Versions Node 20.19.0 or 22.11.0 or newer (courtesy of ZH 4.4.1 / ZHC 24.8.0)
+
 ### 3.0.3 (2025-07-27)
 * (asgothian) fix 'icon' error for unknown devices
 * (asgothian) fix state for level.color.rgb role (hex_color, accepts only #rrggbb values

package/docs/de/readme.md

@@ -53,6 +53,9 @@ Je nach Fehlerbild gibt es verschiedene mögliche Ursachen dafür das der Herdsm
 - Löschen des NVBackups. In diesem Fall bleibt die Konfiguration im Adapter wie sie ist. Dieses **erzwingt** einen Neuaufbau des Netzwerkes so das in der Folge alle bereits angelernten Geräte zurückgesetzt und neu angelernt werden müssen.<br>
 Die Ausgaben im Log sind auch dazu geeignet bei der Suche nach einer Lösung im [ioBroker Forum](https://forum.iobroker.net) eingesetzt zu werden. Dazu bitte die Meldungen markieren und **als Text** im Forum posten.
 
+10. Nachdem das Zigbee-Subsystem sauber konfiguriert wurde und anstandslos startet muss der Haken bei 'Start the zigbee network automatically' (G) gesetzt werden. Erst dann startet der Adapter das Zigbee Netzwerk automatisch beim Start.
+
+
 ## Pairing
 Jedes ZigBee-Gerät (Schalter, Lampe, Sensor, …) muss mit dem Koordinator gekoppelt werden (Pairing):  <br>
 

package/docs/en/readme.md

@@ -51,7 +51,7 @@ Depending on the error, there are various possible reasons why Herdsman may not
 - Reading the data from the NV backup. In this case, the adapter's configuration is adjusted.
 - Deleting the NV backup. In this case, the adapter's configuration remains as it is. This **forces** a rebuild of the network, which subsequently requires all previously trained devices to be reset and retrained.<br>
 The log output can also be used to search for a solution in the [ioBroker Forum](https://forum.iobroker.net). Please highlight the messages and post them **as text** in the forum.
-
+10. Once the zigbee network is configured correctly and starts without issues,  it is time to set the adapter to automatically start the network at start. This is done by checking the checkbox labeled 'start the zigbee network automatically'.
 ## Pairing
 Each ZigBee device (switch, bulb, sensor, ...) must be paired with the coordinator (pairing):  <br>
 

package/io-package.json

@@ -1,8 +1,21 @@
 {
   "common": {
     "name": "zigbee",
-    "version": "3.0.3",
+    "version": "3.0.5",
     "news": {
+      "3.0.5": {
+        "en": "fix random error where devices are not shown due to illegal groups\ndrop support for node 18\nRequired node Versions Node 20.19.0 or 22.11.0 or newer (courtesy of ZH 4.4.1 / ZHC 24.8.0)",
+        "de": "fehler beheben, bei denen geräte wegen illegaler gruppen nicht angezeigt werden\ndrop-unterstützung für knoten 183\nErforderliche Knotenversionen Nr. 20.19.0 oder 22.11.0 oder neuer (courtesy of ZH 4.4.1 / ZHC 24.8.0)",
+        "ru": "исправить случайную ошибку, когда устройства не отображаются из-за незаконных групп\nподдержка drop для node 18\nТребуемый узел Версии Узел 20.19.0 или 22.11.0 или новее (документ ZH 4.4.1 / ZHC 24.8.0)",
+        "pt": "corrigir erro aleatório onde os dispositivos não são mostrados devido a grupos ilegais\nsuporte de gota para o nó 18\nNó necessário Versões Node 20.19.0 ou 22.11.0 ou mais recente (cortesia de ZH 4.4.1 / ZHC 24.8.0)",
+        "nl": "fix willekeurige fout wanneer apparaten niet worden getoond als gevolg van illegale groepen\ndrop ondersteuning voor knooppunt 18\nVereiste node Versies Node 20.19.0 of 22.11.0 of nieuwer (met dank aan ZH 4.4.1 / ZHC 24.8.0)",
+        "fr": "corriger une erreur aléatoire lorsque les appareils ne sont pas montrés en raison de groupes illégaux\nsupport de chute pour noeud 18\nVersion requise Node 20.19.0 ou 22.11.0 ou plus récent (avec la permission de ZH 4.4.1 / ZHC 248.0)",
+        "it": "correggere errore casuale in cui i dispositivi non vengono visualizzati a causa di gruppi illegali\nsupporto a goccia per nodo 18\nNodo richiesto Versioni Nodo 20.19.0 o 22.11.0 o più recente (cortesia di ZH 4.4.1 / ZHC 24.8.0)",
+        "es": "corregir errores aleatorios donde no se muestran dispositivos debido a grupos ilegales\napoyo a los nodos 18\nNodo requerido Versiones Nodo 20.19.0 o 22.11.0 o nuevo (cortesía de ZH 4.4.1 / ZHC 24.8.0)",
+        "pl": "naprawić błąd losowy w przypadku gdy urządzenia nie są wyświetlane z powodu nielegalnych grup\nobsługa zrzutu dla węzła 18\nWymagany węzeł Wersje Węzeł 20.19.0 lub 22.11.0 lub nowszy (uprzejmość ZH 4.4.1 / ZHC 24.8.0)",
+        "uk": "виправити випадкові помилки, де пристрої не відображаються через незаконні групи\nпідтримка крапель для вузла 18 років\nПотрібні версії вузла Node 20.19.0 або 22.11.0 або новачка (кількість ЗЗ 4.4.1 / ЗЖК 24.8.0)",
+        "zh-cn": "在设备因非法组而未显示时修复随机错误\n放弃节点支持 第 18 条\n要求的节点版本为20.19.0或22.11.0或更新(礼仪为ZH 4.4.1 / ZHC 24.8.0)"
+      },
       "3.0.3": {
         "en": "fix 'icon' error for unknown devices\nfix state for level.color.rgb role (hex_color, accepts only #rrggbb values\nZH 4.4.1\nZHC 23.72.1\npreparation for breaking change in ZHC 24.0.0",
         "de": "'icon' fehler für unbekannte geräte beheben\nfix zustand für level.color.rgb rolle (hex_color, akzeptiert nur #rrggbb werte\nZH 4.4.1\nZHC 23.72.1\nvorbereitung auf den Bruchwechsel in ZHC 24.0.0",
@@ -80,19 +93,6 @@
         "pl": "powrót do 2.0.2",
         "uk": "до 2.0.2",
         "zh-cn": "返回到2.0.2"
-      },
-      "2.0.3": {
-        "en": "fix configured info\nfix battery voltage (V -> mV)\nenable debug interface v1.0\nPush Zigbee-Herdsman to 3.5.7\nPush Zigbee-Herdsman-Converters to 23.1.1\nfix configure on message\nremove extra warning messages\nfix Adapter-Checker notes\nimprove base64 image detection\nremoved unused adaptert objects (info.groups, excludes) from adapter config\n",
-        "de": "die konfigurierten informationen\nbatteriespannung fixieren (V -> mV)\ndebug interface v1.0\nPush Zigbee-Herdsman auf 3.5.7\nPush Zigbee-Herdsman-Konverter auf 23.1.1\nkonfigurieren der nachricht\nzusätzliche warnmeldungen entfernen\nfix Adapter-Checker-Noten\nverbesserung der bilderkennung von base64\nentfernte ungenutzte adapterobjekte (info.groups, ausgenommen) von adapter config\n",
-        "ru": "исправить сконфигурированную информацию\nфиксировать напряжение батареи (V -> mV)\nвключить интерфейс отладки v1.0\nПодтолкнуть Зигби-Хердсмана к 3.5.7\nНажмите Zigbee-Herdsman-Converters на 23.1.1\nисправить конфигурацию на сообщение\nудалить дополнительные предупреждающие сообщения\nзаписи Adapter-Checker\nобнаружение изображений base64\nудаленные неиспользуемые объекты адаптера (info.groups, исключает) из конфигурации адаптера\n",
-        "pt": "corrigir informações configuradas\ncorrigir a tensão da bateria (V -> mV)\nenable debug interface v1.0\nEmpurre Zigbee-Herdsman para 3.5.7\nEmpurre Zigbee-Herdsman-Converters para 23.1.1\ncorrigir configurar na mensagem\nremover mensagens de aviso extra\ncorrigir notas Adapter-Checker\nmelhorar a detecção de imagem base64\nremoveu objetos adaptadores não utilizados (info.groups, exclui) da configuração do adaptador\n",
-        "nl": "fix geconfigureerde informatie\nvast te stellen batterijspanning (V -> mV)\ndebug interface v1.0 inschakelen\nDuw Zigbee-Herdsman naar 3.5.7\nDuw Zigbee-Herdsman-Converters naar 23.1.1\nfix configureren op bericht\nextra waarschuwingsberichten verwijderen\nfix Adapter-Checker notities\nverbeteren base64 beelddetectie\nverwijderd ongebruikte adapter objecten (info.groups, exclusief) uit adapter config\n",
-        "fr": "correction des informations configurées\ncorrection de la tension de la batterie (V -> mV)\nactive l'interface debug v1.0\nPoussez Zigbee-Herdsman à 3.5.7\nPousser Zigbee-Herdsman-Converters à 23.1.1\ncorrection de configuration sur le message\nsupprimer les messages d'avertissement supplémentaires\ncorrection des notes de l'adaptateur-vérificateur\naméliorer la détection d'image de base64\nobjets de l'adaptateurt supprimés (info.groups, exclut) de la configuration de l'adaptateur\n",
-        "it": "correzione delle informazioni configurate\ncorreggere la tensione della batteria (V -> mV)\nabilitare l'interfaccia di debug v1.0\nSpingere Zigbee-Herdsman a 3.5.7\nSpingere Zigbee-Herdsman-Converters a 23.1.1\ncorrezione configurare sul messaggio\nrimuovere i messaggi di avviso extra\nfissare le note dell'adattatore-Checker\nmigliorare il rilevamento delle immagini base64\nrimosso oggetti adattatori non utilizzati (info.groups, esclude) dalla configurazione dell'adattatore\n",
-        "es": "fijar información configurada\ntensión de batería de fijación (V - título mV)\nhabilitar interfaz de depuración v1.0\nEmpuja Zigbee-Herdsman a 3.5.7\nEmpuja Zigbee-Herdsman-Converters a 23.1.1\nfijar configuración en el mensaje\neliminar mensajes de advertencia extra\nfijar las notas de Adaptador-Checker\nmejorar la detección de imágenes base64\nobjetos de adaptador no usados (info.groups, excluye) de configuración de adaptador\n",
-        "pl": "naprawić skonfigurowane informacje\nstałe napięcie akumulatora (V - > mV)\nwłącz interfejs debugowania v1.0\nPush Zigbee-Herdsman do 3.5.7\nPush Zigbee- Herdsman- Konwertery do 23.1.1\nustaw konfigurację na wiadomości\nusuwa dodatkowe komunikaty ostrzegawcze\nfix Adapter- Notatki kontrolne\npoprawa wykrywania obrazu bazowego64\nusunięte niewykorzystane obiekty adaptert (info.groups, excluses) z konfiguracji adaptera\n",
-        "uk": "виправлено налаштовану інформацію\nфіксатор напруги акумулятора (В -> мВ)\nувімкнути інтерфейс налагодження v1.0\nPush Zigbee-Herdsman до 3.5.7\nPush Zigbee-Herdsman-Converters до 23.1.1\nфіксувати налаштування на повідомлення\nвидалити додаткові повідомлення попередження\nвиправити адаптер-Checker ноти\nполіпшення базового64 виявлення зображень\nвидалити невикористані об'єкти адаптера (info.groups, виключає) з налаштування адаптера\n",
-        "zh-cn": "修复已配置的信息\n固定电池电压(V - > mV)\n启用调试接口 v1.0\n将Zigbee-Herdsman推至3.5.7\n将Zigbee-Herdsman-Convers推向23.1.1\n固定信件的配置\n删除额外的警告信件\n修正适配器检查符\n改进基本64图像检测\n从适配器配置中删除未使用的适配对象( 信息组, 排除)\n"
       }
     },
     "titleLang": {
@@ -197,6 +197,58 @@
       }
     ],
     "messages": [
+      {
+        "condition": {
+          "operand": "and",
+          "rules": [
+            "oldVersion<3.0.0",
+            "newVersion>=3.0.0"
+          ]
+        },
+        "title": {
+          "en": "Important notice!",
+          "de": "Wichtiger Hinweis!",
+          "ru": "Важное замечание!",
+          "pt": "Notícia importante!",
+          "nl": "Belangrijke mededeling!",
+          "fr": "Avis important!",
+          "it": "Avviso IMPORTANTE!",
+          "es": "Noticia importante!",
+          "pl": "Ważna uwaga!",
+          "zh-cn": "重要通知!"
+        },
+        "text": {
+          "en": "\"BREAKING CHANGE. <br> Adapter version 3.x no longer automatically starts the zigbee network unless the adapter is configured to do so. When upgrading from a version <3.0, the option 'start the zigbee network automatically' needs to be set once the configuration of the adapter has been verified. Please check the documentation on Github for details",
+          "de": "\"BREAKING CHANGE. <br> Adapterversion 3.x startet das ZigBee-Netzwerk nicht mehr automatisch, es sei denn, der Adapter ist entsprechend konfiguriert. Beim Upgrade von einer Version <3.0 muss die Option 'ZigBee-Netzwerk automatisch starten' aktiviert werden, sobald die Konfiguration des Adapters überprüft wurde. Weitere Informationen finden Sie in der Dokumentation auf Github.",
+          "ru": "\"BREAKING CHANGE. <br> Адаптер версии 3.x больше не запускает сеть ZigBee автоматически, если только он не настроен соответствующим образом. При обновлении с версии ниже 3.0 необходимо включить опцию «Запускать сеть ZigBee автоматически» после проверки конфигурации адаптера. Подробности см. в документации на Github.",
+          "pt": "\"BREAKING CHANGE. <br> A versão 3. x do adaptador já não inicia a rede Zigbee automaticamente, a menos que o adaptador esteja configurado para tal. Ao atualizar a partir de uma versão inferior a 3.0, a opção 'iniciar a rede Zigbee automaticamente' necessita de ser definida após a verificação da configuração do adaptador. Consulte a documentação no GitHub para mais detalhes.",
+          "nl": "\"BREAKING CHANGE. <br> Adapterversie 3.x start het ZigBee-netwerk niet meer automatisch, tenzij de adapter hiervoor is geconfigureerd. Bij een upgrade vanaf een versie <3.0 moet de optie 'ZigBee-netwerk automatisch starten' worden ingeschakeld nadat de configuratie van de adapter is geverifieerd. Raadpleeg de documentatie op Github voor meer informatie.",
+          "fr": "\"BREAKING CHANGE. <br> La version 3.x de l'adaptateur ne démarre plus automatiquement le réseau Zigbee, sauf si l'adaptateur est configuré pour le faire. Lors d'une mise à niveau depuis une version antérieure à la version 3.0, l'option « Démarrer automatiquement le réseau Zigbee » doit être activée une fois la configuration de l'adaptateur vérifiée. Veuillez consulter la documentation sur GitHub pour plus de détails.",
+          "it": "\"BREAKING CHANGE. <br> La versione 3.x dell'adattatore non avvia più automaticamente la rete ZigBee, a meno che l'adattatore non sia configurato per farlo. Quando si esegue l'aggiornamento da una versione <3.0, è necessario impostare l'opzione 'Avvia automaticamente la rete ZigBee' una volta verificata la configurazione dell'adattatore. Per i dettagli, consultare la documentazione su Github.",
+          "es": "\"BREAKING CHANGE. <br> La versión 3.x del adaptador ya no inicia automáticamente la red Zigbee a menos que esté configurada para ello. Al actualizar desde una versión anterior a la 3.0, es necesario activar la opción 'Iniciar la red Zigbee automáticamente' una vez verificada la configuración del adaptador. Para más información, consulte la documentación en Github.",
+          "pl": "\"BREAKING CHANGE. <br> Wersja adaptera 3.x nie uruchamia już automatycznie sieci Zigbee, chyba że adapter jest odpowiednio skonfigurowany. Podczas aktualizacji z wersji <3.0, po zweryfikowaniu konfiguracji adaptera należy ustawić opcję 'Automatyczne uruchamianie sieci Zigbee'. Szczegółowe informacje można znaleźć w dokumentacji na Github.",
+          "uk": "\"BREAKING CHANGE. <br> Версія адаптера 3.x більше не запускає мережу ZigBee автоматично, якщо адаптер не налаштовано на це. Під час оновлення з версії <3.0 необхідно встановити опцію «автоматично запускати мережу ZigBee» після перевірки конфігурації адаптера. Будь ласка, перегляньте документацію на Github для отримання детальної інформації.",
+          "zh-cn": "\"BREAKING CHANGE. <br> 適配器 3.x 版不再自動啟動 Zigbee 網絡，除非適配器已配置為自動啟動。從低於 3.0 的版本升級時，需要在驗證適配器配置後設定「自動啟動 Zigbee 網路」選項。詳情請查看 Github 上的文件。"
+        },
+        "link": "https://github.com/ioBroker/ioBroker.zigbee/blob/master/README.md",
+        "level": "warn",
+        "linkText": {
+          "en": "Readme",
+          "de": "Liesmich",
+          "ru": "Прочти меня",
+          "pt": "Leia-me",
+          "nl": "Leesmij",
+          "fr": "Lisez-moi",
+          "it": "Leggimi",
+          "es": "Léame",
+          "pl": "Readme",
+          "zh-cn": "自述文件"
+        },
+        "buttons": [
+          "agree",
+          "cancel"
+        ]
+      },
       {
         "condition": {
           "operand": "and",

package/lib/commands.js

@@ -196,7 +196,7 @@ class Commands {
         }
         catch (error) {
             const msg = `Unable to read nvBackup ${error && error.message ? error.message : 'no message given'}`;
-            this.error(msg);
+            //this.error(msg);
             this.adapter.sendTo(from, command, {error:msg}, callback)
         }
     }
@@ -389,23 +389,25 @@ class Commands {
                                 if (groupmembers && groupmembers.length > 0) {
                                     const memberinfo = [];
                                     for (const member of groupmembers) {
-                                        if (groups) {
-                                            const grouparray = groups[member.ieee];
-                                            if (grouparray) {
-                                                if (!grouparray.includes(groupID)) {
-                                                    groups[member.ieee].push(groupID);
+                                        if (member && typeof member.ieee === 'string') {
+                                            if (groups) {
+                                                const grouparray = groups[member.ieee];
+                                                if (grouparray) {
+                                                    if (!grouparray.includes(groupID)) {
+                                                        groups[member.ieee].push(groupID);
+                                                    }
+                                                } else {
+                                                    groups[member.ieee] = [groupID];
                                                 }
+                                            }
+                                            const device = await this.adapter.getObjectAsync(`${this.adapter.namespace}.${member.ieee.substr(2)}`);
+                                            if (device) {
+                                                member.device = device.common.name;
                                             } else {
-                                                groups[member.ieee] = [groupID];
+                                                member.device = 'unknown';
                                             }
+                                            memberinfo.push(member);
                                         }
-                                        const device = await this.adapter.getObjectAsync(`${this.adapter.namespace}.${member.ieee.substr(2)}`);
-                                        if (device) {
-                                            member.device = device.common.name;
-                                        } else {
-                                            member.device = 'unknown';
-                                        }
-                                        memberinfo.push(member);
                                     }
                                     devInfo.memberinfo = memberinfo;
                                     this.debug(`memberinfo for ${match[1]}: ${JSON.stringify(devInfo.memberinfo)}`);
@@ -464,7 +466,7 @@ class Commands {
                     if (!id) {
                         for (const d of pairedDevices) {
                             const device = await this.zbController.resolveEntity(d.ieeeAddr);
-                            if (!device) {
+                            if (!device || !device.device) {
                                 continue;
                             }
                             const exists = devices.find((dev) => (dev._id && device.device.ieeeAddr === getZbId(dev._id)));

package/lib/exposes.js

@@ -412,14 +412,23 @@ function createFromExposes(model, def, device, log) {
                             return {...options, transition: transitionTime};
                         },
                         getter: payload => {
-                            if (typeof payload.color == 'object') {
-                                // Requires testing!
+                            try {
+                                // JSON
+                                const colorJSON = JSON.parse(payload.replaceAll("'",'"'));
+                                const numProp = Object.keys(colorJSON).length;
                                 if (hasMultipleProperties(colorJSON, ['r', 'g', 'b'], numProp)) {
                                     const hexstring = (colorJSON.r*65536 + colorJSON.g * 256 + colorJSON.b).toString(16).padStart(6);
                                     return `#${hexstring.substring(2)}`;
                                 }
+                                return undefined;
+                            }
+                            catch {
+                                // intentionally empty;
                             }
-                            if (typeof payload.color === 'string' && payload.color.startsWith('#')) return payload.color;
+                            if (payload.color.startsWith('#')) return payload.color;
+                            const p = payload.replace('0x', '');
+                            const m = p.match(/[0123456789abcdefABCDEF]+/);
+                            if (p.length < 7 && m && m[0].length == p.length) return '#000000'.substring(0, 7-p.length) + p;
                             return undefined;
                         },
                         epname: expose.endpoint,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "iobroker.zigbee",
-  "version": "3.0.3",
+  "version": "3.0.5",
   "author": {
     "name": "Kirov Ilya",
     "email": "kirovilya@gmail.com"
@@ -15,7 +15,7 @@
     }
   ],
   "engines": {
-    "node": ">=18"
+    "node": ">=20"
   },
   "optionalDependencies": {
     "serialport": "^13.0.0"
@@ -29,7 +29,7 @@
     "uri-js": "^4.4.1",
     "typescript": "^5.8.3",
     "zigbee-herdsman": "4.4.1",
-    "zigbee-herdsman-converters": "23.72.1"
+    "zigbee-herdsman-converters": "24.8.0"
   },
   "description": "Zigbee devices",
   "devDependencies": {
@@ -38,11 +38,11 @@
     "@alcalzone/release-script-plugin-license": "^3.7.0",
     "@alcalzone/release-script-plugin-manual-review": "^3.7.0",
     "@iobroker/testing": "^5.0.4",
-    "chai": "^5.1.2",
+    "chai": "^5.2.1",
     "chai-as-promised": "^7.1.1",
     "eslint": "^9.30.0",
     "eslint-config-prettier": "^9.1.0",
-    "eslint-plugin-prettier": "^5.5.1",
+    "eslint-plugin-prettier": "^5.5.3",
     "gulp": "^4.0.2",
     "gulp-jsdoc3": "^3.0.0",
     "gulp-replace": "^1.1.4",