iobroker.zigbee 1.5.6 → 1.6.8

package/main.js

@@ -30,6 +30,7 @@ const StatesController = require('./lib/statescontroller');
 const ExcludePlugin = require('./lib/exclude');
 const zigbeeHerdsmanConverters = require('zigbee-herdsman-converters');
 const vm = require('vm');
+const util = require('util');
 
 const createByteArray = function (hexString) {
     const bytes = [];
@@ -105,18 +106,46 @@ class Zigbee extends utils.Adapter {
         }
     }
 
+    sendError(error, message) {
+        if (this.supportsFeature && this.supportsFeature('PLUGINS')) {
+            const sentryInstance = this.getPluginInstance('sentry');
+            if (sentryInstance) {
+                const Sentry = sentryInstance.getSentryObject();
+                if (Sentry) {
+                    if (message) {
+                        Sentry.configureScope(scope => {
+                            scope.addBreadcrumb({
+                                type: "error", // predefined types
+                                category: "error message",
+                                level: Sentry.Severity.Error,
+                                message: message
+                            });
+                        });
+                    }
+                    if (typeof error == 'string') {
+                        Sentry.captureException(new Error(error));
+                    } else {
+                        Sentry.captureException(error);
+                    }
+                }
+            }
+        }
+    }
+
     filterError(errormessage, message, error) {
         if (error.code === undefined)
         {
             let em =  error.stack.match(/failed \((.+?)\) at/);
             if (!em) em = error.stack.match(/failed \((.+?)\)/);
             this.log.error(`${message} no error code (${(em ? em[1]:'undefined')})`);
+            this.sendError(error, `${message} no error code`);
             this.log.debug(`Stack trace for ${em}: ${error.stack}`);
             return;
         }
         const ecode = errorCodes[error.code];
         if (ecode === undefined) {
             this.log.error(errormessage);
+            this.sendError(error, errormessage);
             return;
         }
         switch (ecode.severity) {
@@ -126,14 +155,19 @@ class Zigbee extends utils.Adapter {
                 break;
             case E_WARN: this.log.warn(`${message}: Code ${error.code} (${ecode.message})`);
                 break;
-            case E_ERROR: this.log.error(`${message}: Code ${error.code} (${ecode.message})`);
+            case E_ERROR:
+                this.log.error(`${message}: Code ${error.code} (${ecode.message})`);
+                this.sendError(error, `${message}: Code ${error.code} (${ecode.message})`);
                 break;
-            default: this.log.error(`${message}: Code ${error.code} (malformed error)`);
+            default: 
+                this.log.error(`${message}: Code ${error.code} (malformed error)`);
+                this.sendError(error, `${message}: Code ${error.code} (malformed error)`);
         }
     }
 
-    debugLog (data) {
-        this.log.debug(data.slice(data.indexOf('zigbee-herdsman')));
+    debugLog (data, ...args) {
+        const message = (args) ? util.format(data, ...args) : data;
+        this.log.debug(message.slice(message.indexOf('zigbee-herdsman')));
     }
 
     async onReady() {
@@ -237,6 +271,7 @@ class Zigbee extends utils.Adapter {
             } else {
                 this.log.error(error);
             }
+            this.sendError(error, `Failed to start Zigbee`);
             if (this.reconnectCounter > 0) {
                 this.tryToReconnect();
             }
@@ -246,6 +281,7 @@ class Zigbee extends utils.Adapter {
     async onZigbeeAdapterDisconnected() {
         this.reconnectCounter = 5;
         this.log.error('Adapter disconnected, stopping');
+        this.sendError('Adapter disconnected, stopping');
         this.setState('info.connection', false, true);
         await this.callPluginMethod('stop');
         this.tryToReconnect();
@@ -281,25 +317,31 @@ class Zigbee extends utils.Adapter {
             const adapterType = this.config.adapterType || 'zstack';
             if (adapterType === 'zstack') {
                 if (configExtPanId != networkExtPanId) {
-                    // try to read from nvram
-                    const result = await this.zbController.herdsman.adapter.znp.request(
-                        1, // Subsystem.SYS
-                        'osalNvRead',
-                        {
-                            id: 45, // EXTENDED_PAN_ID
-                            len: 0x08,
-                            offset: 0x00,
-                        },
-                        null, [
-                            0, // ZnpCommandStatus.SUCCESS
-                            2, // ZnpCommandStatus.INVALID_PARAM
-                        ]
-                    );
-                    const nwExtPanId = '0x'+result.payload.value.reverse().toString('hex');
-                    this.log.debug(`Config value ${configExtPanId} : nw value ${nwExtPanId}`);
-                    if (configExtPanId != nwExtPanId) {
-                        networkExtPanId = nwExtPanId;
-                        needChange = true;
+                    try {
+                        // try to read from nvram
+                        const result = await this.zbController.herdsman.adapter.znp.request(
+                            1, // Subsystem.SYS
+                            'osalNvRead',
+                            {
+                                id: 45, // EXTENDED_PAN_ID
+                                len: 0x08,
+                                offset: 0x00,
+                            },
+                            null, [
+                                0, // ZnpCommandStatus.SUCCESS
+                                2, // ZnpCommandStatus.INVALID_PARAM
+                            ]
+                        );
+                        const nwExtPanId = '0x'+result.payload.value.reverse().toString('hex');
+                        this.log.debug(`Config value ${configExtPanId} : nw value ${nwExtPanId}`);
+                        if (configExtPanId != nwExtPanId) {
+                            networkExtPanId = nwExtPanId;
+                            needChange = true;
+                        }
+                    } catch (e) {
+                        this.log.error(`Unable to apply ExtPanID changes: ${e}`);
+                        this.sendError(e, `Unable to apply ExtPanID changes`);
+                        needChange = false;
                     }
                 } else {
                     needChange = true;
@@ -368,9 +410,6 @@ class Zigbee extends utils.Adapter {
 
     async onZigbeeEvent(type, entity, message){
         this.log.debug(`Type ${type} device ${safeJsonStringify(entity)} incoming event: ${safeJsonStringify(message)}`);
-        if (!entity.mapped) {
-            return;
-        }
         const device = entity.device,
             mappedModel = entity.mapped,
             model = (entity.mapped) ? entity.mapped.model : entity.device.modelID,
@@ -385,6 +424,17 @@ class Zigbee extends utils.Adapter {
         if (message.linkquality) {
             this.publishToState(devId, model, {linkquality: message.linkquality});
         }
+        // publish raw event to "from_zigbee"
+        // some cleanup
+        const msgForState = Object.assign({}, message);
+        delete msgForState['device'];
+        delete msgForState['endpoint'];
+        msgForState['endpoint_id'] = message.endpoint.ID;
+        this.publishToState(devId, model, {msg_from_zigbee: safeJsonStringify(msgForState)});
+        
+        if (!entity.mapped) {
+            return;
+        }
         let converters = mappedModel.fromZigbee.filter(c => c && c.cluster === cluster && (
             (c.type instanceof Array) ? c.type.includes(type) : c.type === type));
         if (!converters.length && type === 'readResponse') {
@@ -447,6 +497,10 @@ class Zigbee extends utils.Adapter {
         const entity = await this.zbController.resolveEntity(deviceId);
         this.log.debug(`entity: ${safeJsonStringify(entity)}`);
         const mappedModel = entity.mapped;
+        if (!mappedModel) {
+            this.log.debug(`No mapped model for ${model}`);
+            return;
+        }
         this.log.debug('Mapped Model: ' +  JSON.stringify(mappedModel));
 
         stateList.forEach(async(changedState) => {
@@ -494,6 +548,7 @@ class Zigbee extends utils.Adapter {
             const converter = mappedModel.toZigbee.find((c) => c && (c.key.includes(stateDesc.prop) || c.key.includes(stateDesc.setattr) || c.key.includes(stateDesc.id)));
             if (!converter) {
                 this.log.error(`No converter available for '${model}' with key '${stateDesc.id}' `);
+                this.sendError(`No converter available for '${model}' with key '${stateDesc.id}' `);
                 return;
             }
 
@@ -511,7 +566,7 @@ class Zigbee extends utils.Adapter {
 
             const epName = stateDesc.epname !== undefined ? stateDesc.epname : (stateDesc.prop || stateDesc.id);
             const key = stateDesc.setattr || stateDesc.prop || stateDesc.id;
-            this.log.debug(`convert ${key}, ${preparedValue}, ${safeJsonStringify(preparedOptions)}`);
+            this.log.debug(`convert ${key}, ${safeJsonStringify(preparedValue)}, ${safeJsonStringify(preparedOptions)}`);
 
             let target;
             if (model === 'group') {
@@ -536,13 +591,15 @@ class Zigbee extends utils.Adapter {
             try {
                 const result = await converter.convertSet(target, key, preparedValue, meta);
                 this.log.debug(`convert result ${safeJsonStringify(result)}`);
-                if (stateModel && !isGroup)
-                    this.acknowledgeState(deviceId, model, stateDesc, value);
-                // process sync state list
-                this.processSyncStatesList(deviceId, model, syncStateList);
-                if (isGroup) {
-                    await this.callPluginMethod('queryGroupMemberState', [deviceId, stateDesc]);
-                    this.acknowledgeState(deviceId, model, stateDesc, value);
+                if (result !== undefined) {
+                    if (stateModel && !isGroup)
+                        this.acknowledgeState(deviceId, model, stateDesc, value);
+                    // process sync state list
+                    this.processSyncStatesList(deviceId, model, syncStateList);
+                    if (isGroup) {
+                        await this.callPluginMethod('queryGroupMemberState', [deviceId, stateDesc]);
+                        this.acknowledgeState(deviceId, model, stateDesc, value);
+                    }
                 }
             } catch(error) {
                 this.filterError(`Error ${error.code} on send command to ${deviceId}.`+
@@ -574,6 +631,7 @@ class Zigbee extends utils.Adapter {
                 payload_obj = JSON.parse();
             } catch (e) {
                 this.log.error(`Unable to parse ${safeJsonStringify(payload)}: ${safeJsonStringify(e)}`);
+                this.sendError(e, `Unable to parse ${safeJsonStringify(payload)}: ${safeJsonStringify(e)}`);
                 return {success:false, error: `Unable to parse ${safeJsonStringify(payload)}: ${safeJsonStringify(e)}`};
             }
         } else if (typeof payload === 'object') {
@@ -590,15 +648,18 @@ class Zigbee extends utils.Adapter {
                 const entity = await this.zbController.resolveEntity(devID);
                 if (!entity) {
                     this.log.error(`Device ${safeJsonStringify(payload_obj.device)} not found`);
+                    this.sendError(`Device ${safeJsonStringify(payload_obj.device)} not found`);
                     return {success: false, error: `Device ${safeJsonStringify(payload_obj.device)} not found`};
                 }
                 const mappedModel = entity.mapped;
                 if (!mappedModel) {
                     this.log.error(`No Model for Device ${safeJsonStringify(payload_obj.device)}`);
+                    this.sendError(`No Model for Device ${safeJsonStringify(payload_obj.device)}`);
                     return {success: false, error: `No Model for Device ${safeJsonStringify(payload_obj.device)}`};
                 }
                 if (typeof payload_obj.payload !== 'object') {
                     this.log.error(`Illegal payload type for ${safeJsonStringify(payload_obj.device)}`);
+                    this.sendError(`Illegal payload type for ${safeJsonStringify(payload_obj.device)}`);
                     return {success: false, error: `Illegal payload type for ${safeJsonStringify(payload_obj.device)}`};
                 }
                 for (const key in payload_obj.payload) {
@@ -671,8 +732,10 @@ class Zigbee extends utils.Adapter {
                         await plugin[method]();
                     }
                 } catch (error) {
-                    if (error && !error.hasOwnProperty('code'))
+                    if (error && !error.hasOwnProperty('code')) {
                         this.log.error(`Failed to call '${plugin.constructor.name}' '${method}' (${error.stack})`);
+                        this.sendError(error, `Failed to call '${plugin.constructor.name}' '${method}'`);
+                    }
                     throw error;
                 }
             }
@@ -697,7 +760,10 @@ class Zigbee extends utils.Adapter {
             }
             callback();
         } catch (error) {
-            this.log.error(`Unload error (${error.stack})`);
+            if (error) {
+                this.log.error(`Unload error (${error.stack})`);
+            }
+            this.sendError(error, `Unload error`);
             callback();
         }
     }
@@ -707,10 +773,18 @@ class Zigbee extends utils.Adapter {
         let dbDir = path.join(utils.getAbsoluteInstanceDataDir(this), '');
         dbDir = dbDir.replace('.', '_');        
         
-        if (this.systemConfig && !fs.existsSync(dbDir)) fs.mkdirSync(dbDir);
+        if (this.systemConfig && !fs.existsSync(dbDir)) {
+            try {
+                fs.mkdirSync(dbDir);
+            } catch (e) {
+                this.log.error(`Cannot create directory ${dbDir}: ${e}`);
+                this.sendError(`Cannot create directory ${dbDir}: ${e}`);
+            }
+        }
         const port = this.config.port;
         if (!port) {
             this.log.error('Serial port not selected! Go to settings page.');
+            this.sendError('Serial port not selected! Go to settings page.');
         }
         const panID = parseInt(this.config.panID ? this.config.panID : 0x1a62);
         const channel = parseInt(this.config.channel ? this.config.channel : 11);
@@ -740,6 +814,7 @@ class Zigbee extends utils.Adapter {
             disablePing: this.config.disablePing,
             transmitPower: this.config.transmitPower,
             extPanIdFix: extPanIdFix,
+            startWithInconsistent: this.config.startWithInconsistent || false,
         };
     }
 
@@ -771,6 +846,7 @@ class Zigbee extends utils.Adapter {
                     if (data)
                         data = data.toString();
                     this.logToPairing('Error: ' + msg + '. ' + data, true);
+                    this.sendError('Error: ' + msg + '. ' + data);
                     break;
                 case 'debug':
                     logger = this.log.debug;
@@ -793,8 +869,6 @@ class Zigbee extends utils.Adapter {
             }
         }
     }
-
-
 }
 
 

package/package.json

@@ -1,73 +1,74 @@
-{
-  "name": "iobroker.zigbee",
-  "version": "1.5.6",
-  "author": {
-    "name": "Kirov Ilya",
-    "email": "kirovilya@gmail.com"
-  },
-  "bugs": {
-    "url": "https://github.com/ioBroker/ioBroker.zigbee/issues"
-  },
-  "contributors": [
-    {
-      "name": "Kirov Ilya",
-      "email": "kirovilya@gmail.com"
-    }
-  ],
-  "engines": {
-    "node": ">=10"
-  },
-  "dependencies": {
-    "zigbee-herdsman": "0.13.110",
-    "zigbee-herdsman-converters": "14.0.162",
-    "@iobroker/adapter-core": "^2.4.0",
-    "tar": "^6.0.5",
-    "typescript": "^4.0.5"
-  },
-  "description": "Zigbee devices",
-  "devDependencies": {
-    "@alcalzone/release-script": "^1.8.3",
-    "@iobroker/testing": "^2.4.2",
-    "axios": "^0.21.1",
-    "mixin-deep": "^1.3.2",
-    "chai": "^4.2.0",
-    "eslint": "^7.18.0",
-    "eslint-config-google": "*",
-    "gulp": "^4.0.0",
-    "lint-diff": "*",
-    "mocha": "^6.0.2"
-  },
-  "homepage": "https://github.com/ioBroker/ioBroker.zigbee",
-  "keywords": [
-    "ioBroker",
-    "zigbee",
-    "cc2531",
-    "cc2530",
-    "cc2538",
-    "cc2652",
-    "deconz",
-    "conbee",
-    "raspbee",
-    "ezsp",
-    "efr32"
-  ],
-  "license": "MIT",
-  "main": "main.js",
-  "optionalDependencies": {},
-  "readmeFilename": "README.md",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/ioBroker/ioBroker.zigbee.git"
-  },
-  "scripts": {
-    "test": "npm run test:package && npm run test:unit",
-    "docgen": "node support/docgen.js",
-    "test:package": "mocha test/package --exit",
-    "test:unit": "mocha test/unit --exit",
-    "test:integration": "mocha test/integration --exit",
-    "watch:parcel": "parcel admin/src/index.tsx -d admin/build --hmr-port 1235",
-    "test:js": "mocha --opts test/mocha.custom.opts",
-    "lint": "npm run lint:js",
-    "lint:js": "eslint"
-  }
-}
+{
+  "name": "iobroker.zigbee",
+  "version": "1.6.8",
+  "author": {
+    "name": "Kirov Ilya",
+    "email": "kirovilya@gmail.com"
+  },
+  "bugs": {
+    "url": "https://github.com/ioBroker/ioBroker.zigbee/issues"
+  },
+  "contributors": [
+    {
+      "name": "Kirov Ilya",
+      "email": "kirovilya@gmail.com"
+    }
+  ],
+  "engines": {
+    "node": ">=10"
+  },
+  "dependencies": {
+    "zigbee-herdsman": "0.13.178",
+    "zigbee-herdsman-converters": "14.0.339",
+    "@iobroker/adapter-core": "^2.4.0",
+    "tar": "^6.0.5",
+    "typescript": "^4.0.5"
+  },
+  "description": "Zigbee devices",
+  "devDependencies": {
+    "@alcalzone/release-script": "^2.2.0",
+    "@iobroker/testing": "^2.5.1",
+    "axios": "^0.21.1",
+    "mixin-deep": "^1.3.2",
+    "chai": "^4.2.0",
+    "eslint": "^7.18.0",
+    "eslint-config-google": "*",
+    "gulp": "^4.0.0",
+    "lint-diff": "*",
+    "mocha": "^6.0.2"
+  },
+  "homepage": "https://github.com/ioBroker/ioBroker.zigbee",
+  "keywords": [
+    "ioBroker",
+    "zigbee",
+    "cc2531",
+    "cc2530",
+    "cc2538",
+    "cc2652",
+    "deconz",
+    "conbee",
+    "raspbee",
+    "ezsp",
+    "efr32"
+  ],
+  "license": "MIT",
+  "main": "main.js",
+  "optionalDependencies": {},
+  "readmeFilename": "README.md",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ioBroker/ioBroker.zigbee.git"
+  },
+  "scripts": {
+    "test": "npm run test:package && npm run test:unit",
+    "docgen": "node support/docgen.js",
+    "test:package": "mocha test/package --exit",
+    "test:unit": "mocha test/unit --exit",
+    "test:integration": "mocha test/integration --exit",
+    "watch:parcel": "parcel admin/src/index.tsx -d admin/build --hmr-port 1235",
+    "test:js": "mocha --opts test/mocha.custom.opts",
+    "lint": "npm run lint:js",
+    "lint:js": "eslint",
+    "release": "release-script"
+  }
+}

package/support/docgen.js

@@ -1,93 +1,93 @@
-/**
- * This script generates the supported devices page.
- * 
- */
-
-let devices = [...require('zigbee-herdsman-converters').devices];
-
-for (const device of devices) {
-    if (device.whiteLabel) {
-        for (const whiteLabel of device.whiteLabel) {
-            const whiteLabelDevice = {
-                ...device,
-                model: whiteLabel.model,
-                vendor: whiteLabel.vendor,
-                description: whiteLabel.description,
-                whiteLabelOf: device,
-            };
-
-            delete whiteLabelDevice.whiteLabel;
-
-            devices.push(whiteLabelDevice);
-        }
-    }
-}
-
-devices = new Map(devices.map((d) => [d.model, d]));
-
-const Devices = require('../lib/devices');
-let iobDevices = Devices.devices;
-Devices.fillStatesWithExposes('');
-
-const iobCount = iobDevices.filter((d) => (!d.exposed)).length;
-iobDevices = new Map(iobDevices.map((d) => d.models.map((m) => [m, d])).flat());
-
-const fs = require('fs');
-const outputdir = process.argv[2];
-
-if (!outputdir) {
-    console.error('Please specify an output directory');
-}
-
-const file = 'Supported-devices.md';
-let text = `*NOTE: Automatically generated by 'npm run docgen'* \n\n` +
-    `Currently **${iobDevices.size}**(${iobCount} described in adapter) devices are supported.\n\n` +
-    `(⭐EXP) - means that the device is presented automatically, based on the 'exposes' from the zigbee-herdsman-converters.\n\n`;
-
-const logDevices = (devmodels) => {
-    let result = '';
-
-    devmodels.forEach((devmodel) => {
-        const iobDevice = iobDevices.get(devmodel);
-        const device = devices.get(devmodel);
-        const pathImg = (iobDevice.icon.startsWith('http')) ? devmodel : iobDevice.icon.replace(new RegExp('img/', 'g'), '').replace(new RegExp('.png', 'g'), '');
-        const icon = (iobDevice.icon.startsWith('http')) ? iobDevice.icon : `https://github.com/ioBroker/ioBroker.zigbee/raw/master/admin/${iobDevice.icon}`;
-        let brand;
-        const models = [];
-        let zmodels;
-        if (device.zigbeeModel) {
-            zmodels = device.zigbeeModel;
-        } else {
-            zmodels = [devmodel];
-        }
-        zmodels.forEach((modelId) => {
-            const re = /[^\x20-\x7E]+/g;
-            const model = modelId.replace(re, ' ');
-            const desc = `${device.description} (${device.supports})`;
-            const name = `**${device.model}${(iobDevice.exposed) ? ' (⭐EXP)': ''}**<br>`;
-            if (brand == undefined) {
-                brand= {
-                    name: name,
-                    desc: desc,
-                    pathImg: pathImg,
-                };
-            }
-            models.push(model);
-        });
-        const modelsStr = models.join(', ');
-        result += `| ${brand.name} (${modelsStr}) | ${brand.desc} |  ![${brand.pathImg}](${icon}) |\n`;
-    });
-
-    return result;
-};
-
-const vendors = Array.from(new Set([...iobDevices.keys()].map((m) => (devices.get(m)) ? devices.get(m).vendor : null)));
-vendors.sort();
-text += '|  Model | Description | Picture |\n';
-text += '| ------------- | ------------- | -------------------------- |\n';
-vendors.forEach((vendor) => {
-    text += `|  | **${vendor}**  |   |\n`;   
-    text += logDevices([...iobDevices.keys()].map((m) => devices.get(m)).filter((d) => d && d.vendor === vendor).map((d) => d.model));
-});
-
-fs.writeFileSync(outputdir + '/' + file, text);
+/**
+ * This script generates the supported devices page.
+ * 
+ */
+
+let devices = [...require('zigbee-herdsman-converters').devices];
+
+for (const device of devices) {
+    if (device.whiteLabel) {
+        for (const whiteLabel of device.whiteLabel) {
+            const whiteLabelDevice = {
+                ...device,
+                model: whiteLabel.model,
+                vendor: whiteLabel.vendor,
+                description: whiteLabel.description,
+                whiteLabelOf: device,
+            };
+
+            delete whiteLabelDevice.whiteLabel;
+
+            devices.push(whiteLabelDevice);
+        }
+    }
+}
+
+devices = new Map(devices.map((d) => [d.model, d]));
+
+const Devices = require('../lib/devices');
+let iobDevices = Devices.devices;
+Devices.fillStatesWithExposes('');
+
+const iobCount = iobDevices.filter((d) => (!d.exposed)).length;
+iobDevices = new Map(iobDevices.map((d) => d.models.map((m) => [m, d])).flat());
+
+const fs = require('fs');
+const outputdir = process.argv[2];
+
+if (!outputdir) {
+    console.error('Please specify an output directory');
+}
+
+const file = 'Supported-devices.md';
+let text = `*NOTE: Automatically generated by 'npm run docgen'* \n\n` +
+    `Currently **${iobDevices.size}**(${iobCount} described in adapter) devices are supported.\n\n` +
+    `(⭐EXP) - means that the device is presented automatically, based on the 'exposes' from the zigbee-herdsman-converters.\n\n`;
+
+const logDevices = (devmodels) => {
+    let result = '';
+
+    devmodels.forEach((devmodel) => {
+        const iobDevice = iobDevices.get(devmodel);
+        const device = devices.get(devmodel);
+        const pathImg = (iobDevice.icon.startsWith('http')) ? devmodel : iobDevice.icon.replace(new RegExp('img/', 'g'), '').replace(new RegExp('.png', 'g'), '');
+        const icon = (iobDevice.icon.startsWith('http')) ? iobDevice.icon : `https://github.com/ioBroker/ioBroker.zigbee/raw/master/admin/${iobDevice.icon}`;
+        let brand;
+        const models = [];
+        let zmodels;
+        if (device.zigbeeModel) {
+            zmodels = device.zigbeeModel;
+        } else {
+            zmodels = [devmodel];
+        }
+        zmodels.forEach((modelId) => {
+            const re = /[^\x20-\x7E]+/g;
+            const model = modelId.replace(re, ' ');
+            const desc = `${device.description} (${device.supports})`;
+            const name = `**${device.model}${(iobDevice.exposed) ? ' (⭐EXP)': ''}**<br>`;
+            if (brand == undefined) {
+                brand= {
+                    name: name,
+                    desc: desc,
+                    pathImg: pathImg,
+                };
+            }
+            models.push(model);
+        });
+        const modelsStr = models.join(', ');
+        result += `| ${brand.name} (${modelsStr}) | ${brand.desc} |  ![${brand.pathImg}](${icon}) |\n`;
+    });
+
+    return result;
+};
+
+const vendors = Array.from(new Set([...iobDevices.keys()].map((m) => (devices.get(m)) ? devices.get(m).vendor : null)));
+vendors.sort();
+text += '|  Model | Description | Picture |\n';
+text += '| ------------- | ------------- | -------------------------- |\n';
+vendors.forEach((vendor) => {
+    text += `|  | **${vendor}**  |   |\n`;   
+    text += logDevices([...iobDevices.keys()].map((m) => devices.get(m)).filter((d) => d && d.vendor === vendor).map((d) => d.model));
+});
+
+fs.writeFileSync(outputdir + '/' + file, text);