zigbee-herdsman 3.1.0 → 3.2.0

package/dist/adapter/z-stack/adapter/adapter-nv-memory.d.ts

@@ -0,0 +1,150 @@
+import { NvItemsIds, NvSystemIds } from '../constants/common';
+import * as Structs from '../structs';
+import { BuiltTable } from '../structs';
+import { Znp } from '../znp';
+/**
+ * Adapter non-volatile memory instrumentation. This class provides interface to interact
+ * with ZNP adapter's NV memory. Provided functionality covers basic operations from reading,
+ * writing and deleting keys to extended table manipulation.
+ */
+export declare class AdapterNvMemory {
+    memoryAlignment?: Structs.StructMemoryAlignment;
+    private znp;
+    constructor(znp: Znp);
+    /**
+     * Initialize NV memory driver by examining target and determining memory alignment.
+     */
+    init(): Promise<void>;
+    /**
+     * Reads a variable-length item from NV memory and returns buffer object. Read can be offset as required.
+     *
+     * @param id NV item identifier.
+     * @param offset Desired data offset to read from.
+     */
+    readItem(id: NvItemsIds, offset?: number): Promise<Buffer>;
+    /**
+     * Reads a variable-length item from NV memory and creates a builds a requested struct.
+     *
+     * @param id NV item identifier.
+     * @param offset Desired data offset to read from.
+     * @param useStruct Struct factory to use to wrap the data in.
+     */
+    readItem<R extends Structs.BuiltStruct, T extends R | Structs.BuiltTable<R>>(id: NvItemsIds, offset?: number, useStruct?: Structs.MemoryObjectFactory<T>): Promise<T>;
+    /**
+     * Writes data to adapter NV memory. Method fails if write fails.
+     *
+     * @param id NV item identifier.
+     * @param data Data to be written.
+     * @param offset Offset within NV item to write the data.
+     * @param autoInit Whether NV item should be automatically initialized if not present.
+     */
+    writeItem(id: NvItemsIds, data: Buffer | Structs.SerializableMemoryObject, offset?: number, autoInit?: boolean): Promise<void>;
+    /**
+     * Determines whether NV item is different from provided data and updates if necessary.
+     *
+     * @param id NV item identifier.
+     * @param data Desired NV item value.
+     * @param autoInit Whether NV item should be automatically initialized if not present.
+     */
+    updateItem(id: NvItemsIds, data: Buffer, autoInit?: boolean): Promise<void>;
+    /**
+     * Deletes an NV memory item.
+     *
+     * @param id NV item identifier.
+     */
+    deleteItem(id: NvItemsIds): Promise<void>;
+    /**
+     * Reads extended table entry (used by Z-Stack 3.x+). NV tables within newer Z-Stack releases include 16-bit `subId`
+     * identifying table entries.
+     *
+     * @param sysId SimpleLink system identifier.
+     * @param id NV item identifier.
+     * @param subId Entry index.
+     * @param offset Data offset to read from.
+     */
+    readExtendedTableEntry(sysId: NvSystemIds, id: NvItemsIds, subId: number, offset?: number): Promise<Buffer>;
+    readExtendedTableEntry<T extends Structs.BuiltStruct>(sysId: NvSystemIds, id: NvItemsIds, subId: number, offset?: number, useStruct?: Structs.MemoryObjectFactory<T>): Promise<T>;
+    /**
+     * Writes extended table entry (user by Z-Stack 3.x+). NV tables within newer Z-Stack releases include 16-bit `subId`
+     * identifying table tnreis.
+     *
+     * @param sysId SimpleLink system identifier.
+     * @param id NV item identifier.
+     * @param subId Entry index.
+     * @param data Data to write to the table.
+     * @param offset Offset to write at.
+     * @param autoInit Whether non-existent entry should be automatically initialized.
+     */
+    writeExtendedTableEntry(sysId: NvSystemIds, id: NvItemsIds, subId: number, data: Buffer, offset?: number, autoInit?: boolean): Promise<void>;
+    /**
+     * Reads a legacy NV table at defined index into raw `Buffer` object array. Providing maximum
+     * length is necessary in order to prevent invalid memory access.
+     *
+     * @param mode Only legacy mode is supported with this signature.
+     * @param id The item index at which the table starts.
+     * @param maxLength Maximum number of items the table may contain.
+     */
+    readTable(mode: 'legacy', id: NvItemsIds, maxLength: number): Promise<Buffer[]>;
+    /**
+     * Reads a legacy table at defined index into a table structure covering struct entries.
+     * Providing maximum length is necessary in order to prevent invalid memory access.
+     *
+     * @param mode Only legacy mode is supported with this signature.
+     * @param id The item index at which the table starts.
+     * @param maxLength Maximum number of items the table may contain.
+     * @param useTable Table factory to spawn a table and populate with retrieved data.
+     */
+    readTable<R extends Structs.BuiltStruct, T extends Structs.BuiltTable<R>>(mode: 'legacy', id: NvItemsIds, maxLength: number, useTable?: Structs.MemoryObjectFactory<T>): Promise<T>;
+    /**
+     * Reads an extended (Z-Stack 3.x.0+) table into raw `Buffer` object array.
+     * Maximum length is optional since the table boundary can be detected automatically.
+     *
+     * @param mode Only extended mode is supported with this signature.
+     * @param sysId SimpleLink system identifier.
+     * @param id Extended table NV index.
+     * @param maxLength Maximum number of entries to load from the table.
+     */
+    readTable(mode: 'extended', sysId: NvSystemIds, id: NvItemsIds, maxLength?: number): Promise<Buffer[]>;
+    /**
+     * Reads an extended (Z-Stack 3.x.0+) table into a table structure covering struct entries.
+     * Maximum length is optional since the table boundary can be detected automatically.
+     *
+     * @param mode Only extended mode is supported with this signature.
+     * @param sysId SimpleLink system identifier.
+     * @param id Extended table NV index.
+     * @param maxLength Maximum number of entries to load from the table.
+     * @param useTable Table factory to spawn a table and populate with retrieved data.
+     */
+    readTable<R extends Structs.BuiltStruct, T extends Structs.BuiltTable<R>>(mode: 'extended', sysId: NvSystemIds, id: NvItemsIds, maxLength?: number, useTable?: Structs.MemoryObjectFactory<T>): Promise<T>;
+    /**
+     * Writes a struct-based table structure into a legacy NV memory position.
+     *
+     * @param mode Only legacy mode is supported with this signature.
+     * @param id Start NV item index.
+     * @param table Table structure to write to NV memory.
+     */
+    writeTable<R extends Structs.BuiltStruct>(mode: 'legacy', id: NvItemsIds, table: BuiltTable<R>): Promise<void>;
+    /**
+     * Writes a struct-based table structure into an extended NV memory position.
+     *
+     * @param mode Only extended mode is supported with this signature.
+     * @param sysId SimpleLink system identifier.
+     * @param id Extended table NV item index.
+     * @param table Table structure to write to NV memory.
+     */
+    writeTable<R extends Structs.BuiltStruct>(mode: 'extended', sysId: NvSystemIds, id: NvItemsIds, table: BuiltTable<R>): Promise<void>;
+    /**
+     * Internal function to prevent occasional ZNP request failures.
+     *
+     * *Some timeouts were present when working with SimpleLink Z-Stack 3.x.0+.*
+     *
+     * @param fn Function to retry.
+     * @param retries Maximum number of retries.
+     */
+    private retry;
+    /**
+     * Internal function used by NV manipulation methods to check for correct driver initialization.
+     */
+    private checkMemoryAlignmentSetup;
+}
+//# sourceMappingURL=adapter-nv-memory.d.ts.map

package/dist/adapter/z-stack/adapter/adapter-nv-memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter-nv-memory.d.ts","sourceRoot":"","sources":["../../../../src/adapter/z-stack/adapter/adapter-nv-memory.ts"],"names":[],"mappings":"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"}

package/dist/adapter/z-stack/adapter/adapter-nv-memory.js

@@ -0,0 +1,280 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AdapterNvMemory = void 0;
+const node_assert_1 = __importDefault(require("node:assert"));
+const common_1 = require("../constants/common");
+const constants_1 = require("../unpi/constants");
+/**
+ * Adapter non-volatile memory instrumentation. This class provides interface to interact
+ * with ZNP adapter's NV memory. Provided functionality covers basic operations from reading,
+ * writing and deleting keys to extended table manipulation.
+ */
+class AdapterNvMemory {
+    memoryAlignment;
+    znp;
+    constructor(znp) {
+        this.znp = znp;
+    }
+    /**
+     * Initialize NV memory driver by examining target and determining memory alignment.
+     */
+    async init() {
+        /* use `ZCD_NV_NWKKEY` to determine if target platform uses memory alignment (length 21 = unaligned, length 24 = aligned) */
+        const rawNwkKey = await this.readItem(common_1.NvItemsIds.NWKKEY);
+        this.memoryAlignment = rawNwkKey.length === 21 ? 'unaligned' : 'aligned';
+    }
+    async readItem(id, offset = 0, useStruct) {
+        if (useStruct) {
+            this.checkMemoryAlignmentSetup();
+        }
+        const lengthResponse = await this.retry(() => this.znp.requestWithReply(constants_1.Subsystem.SYS, 'osalNvLength', { id }));
+        if (!lengthResponse?.payload?.length || lengthResponse?.payload?.length === 0) {
+            return null;
+        }
+        const length = lengthResponse.payload.length;
+        const buffer = Buffer.alloc(length);
+        while (offset < length) {
+            const readResponse = await this.retry(() => this.znp.request(constants_1.Subsystem.SYS, 'osalNvReadExt', { id, offset }));
+            /* v8 ignore start */
+            if (!readResponse) {
+                return null;
+            }
+            if (readResponse.payload?.status !== 0) {
+                throw new Error(`Received non-success status while reading NV (id=${id}, offset=${offset}, status=${readResponse.payload.status})`);
+            }
+            /* v8 ignore stop */
+            buffer.set(readResponse.payload.value, offset);
+            offset += readResponse.payload.value.length;
+        }
+        if (useStruct) {
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            return useStruct(buffer, this.memoryAlignment);
+        }
+        return buffer;
+    }
+    /**
+     * Writes data to adapter NV memory. Method fails if write fails.
+     *
+     * @param id NV item identifier.
+     * @param data Data to be written.
+     * @param offset Offset within NV item to write the data.
+     * @param autoInit Whether NV item should be automatically initialized if not present.
+     */
+    async writeItem(id, data, offset = 0, autoInit = true) {
+        this.checkMemoryAlignmentSetup();
+        const buffer = Buffer.isBuffer(data) ? data : data.serialize(this.memoryAlignment);
+        const lengthResponse = await this.retry(() => this.znp.requestWithReply(constants_1.Subsystem.SYS, 'osalNvLength', { id }));
+        const exists = lengthResponse.payload.length && lengthResponse.payload.length > 0;
+        if (!exists) {
+            /* v8 ignore next */
+            const initLength = buffer.length > 240 ? 240 : buffer.length;
+            /* v8 ignore start */
+            if (!autoInit) {
+                throw new Error(`Cannot write NV memory item which does not exist (id=${id})`);
+            }
+            /* v8 ignore stop */
+            const initResponse = await this.retry(() => this.znp.requestWithReply(constants_1.Subsystem.SYS, 'osalNvItemInit', { id, len: buffer.length, initlen: initLength, initvalue: buffer.slice(0, initLength) }, undefined, undefined, [common_1.ZnpCommandStatus.SUCCESS, common_1.ZnpCommandStatus.NV_ITEM_INITIALIZED]));
+            /* v8 ignore start */
+            if (initResponse.payload.status !== 0x09) {
+                throw new Error(`Failed to initialize NV memory item (id=${id}, name=${common_1.NvItemsIds[id]}, len=${buffer.length}, status=${initResponse.payload.status})`);
+            }
+            /* v8 ignore stop */
+        }
+        let remaining = buffer.length;
+        while (remaining > 0) {
+            /* v8 ignore next */
+            const writeLength = remaining > 240 ? 240 : remaining;
+            const dataOffset = buffer.length - remaining;
+            const writeData = buffer.slice(dataOffset, dataOffset + writeLength);
+            const writeResponse = await this.retry(() => this.znp.requestWithReply(constants_1.Subsystem.SYS, 'osalNvWriteExt', { id, offset: dataOffset, len: writeLength, value: writeData }));
+            /* v8 ignore start */
+            if (writeResponse.payload.status !== 0) {
+                throw new Error(`Received non-success status while writing NV (id=${id}, offset=${offset}, status=${writeResponse.payload.status})`);
+            }
+            /* v8 ignore stop */
+            remaining -= writeLength;
+        }
+    }
+    /**
+     * Determines whether NV item is different from provided data and updates if necessary.
+     *
+     * @param id NV item identifier.
+     * @param data Desired NV item value.
+     * @param autoInit Whether NV item should be automatically initialized if not present.
+     */
+    async updateItem(id, data, autoInit = true) {
+        this.checkMemoryAlignmentSetup();
+        const current = await this.readItem(id);
+        if (!current || !current.equals(data)) {
+            await this.writeItem(id, data, 0, autoInit);
+        }
+    }
+    /**
+     * Deletes an NV memory item.
+     *
+     * @param id NV item identifier.
+     */
+    async deleteItem(id) {
+        this.checkMemoryAlignmentSetup();
+        const lengthResponse = await this.retry(() => this.znp.requestWithReply(constants_1.Subsystem.SYS, 'osalNvLength', { id }));
+        const exists = lengthResponse.payload.length && lengthResponse.payload.length > 0;
+        if (exists) {
+            const deleteResponse = await this.retry(() => this.znp.requestWithReply(constants_1.Subsystem.SYS, 'osalNvDelete', { id, len: lengthResponse.payload.length }));
+            /* v8 ignore start */
+            if (!deleteResponse || ![common_1.ZnpCommandStatus.SUCCESS, common_1.ZnpCommandStatus.NV_ITEM_INITIALIZED].includes(deleteResponse.payload.status)) {
+                throw new Error(`Received non-success status while deleting NV (id=${id}, status=${deleteResponse.payload.status})`);
+            }
+            /* v8 ignore stop */
+        }
+    }
+    async readExtendedTableEntry(sysId, id, subId, offset, useStruct) {
+        this.checkMemoryAlignmentSetup();
+        const lengthResponse = await this.retry(() => this.znp.requestWithReply(constants_1.Subsystem.SYS, 'nvLength', { sysid: sysId, itemid: id, subid: subId }));
+        const exists = lengthResponse.payload.len && lengthResponse.payload.len > 0;
+        if (exists) {
+            const readResponse = await this.retry(() => this.znp.requestWithReply(constants_1.Subsystem.SYS, 'nvRead', {
+                sysid: sysId,
+                itemid: id,
+                subid: subId,
+                offset: offset || 0,
+                len: lengthResponse.payload.len,
+            }));
+            /* v8 ignore start */
+            if (readResponse.payload.status !== 0) {
+                throw new Error(`Received non-success status while reading NV extended table entry (sysId=${sysId}, id=${id}, subId=${subId}, offset=${offset}, status=${readResponse.payload.status})`);
+            }
+            /* v8 ignore stop */
+            /* v8 ignore next */
+            return useStruct ? useStruct(readResponse.payload.value) : readResponse.payload.value;
+        }
+        return null;
+    }
+    /**
+     * Writes extended table entry (user by Z-Stack 3.x+). NV tables within newer Z-Stack releases include 16-bit `subId`
+     * identifying table tnreis.
+     *
+     * @param sysId SimpleLink system identifier.
+     * @param id NV item identifier.
+     * @param subId Entry index.
+     * @param data Data to write to the table.
+     * @param offset Offset to write at.
+     * @param autoInit Whether non-existent entry should be automatically initialized.
+     */
+    async writeExtendedTableEntry(sysId, id, subId, data, offset, autoInit = true) {
+        this.checkMemoryAlignmentSetup();
+        const lengthResponse = await this.retry(() => this.znp.requestWithReply(constants_1.Subsystem.SYS, 'nvLength', { sysid: sysId, itemid: id, subid: subId }));
+        const exists = lengthResponse.payload.len && lengthResponse.payload.len > 0;
+        /* v8 ignore start */
+        if (!exists) {
+            if (!autoInit) {
+                throw new Error(`Cannot write NV memory extended table item which does not exist (sudId=${sysId}, id=${id}, subId=${subId})`);
+            }
+            const createResponse = await this.retry(() => this.znp.request(constants_1.Subsystem.SYS, 'nvCreate', { sysid: sysId, itemid: id, subid: subId, len: data.length }));
+            if (!createResponse || createResponse.payload.status !== common_1.ZnpCommandStatus.SUCCESS) {
+                throw new Error(`Failed to crate NV memory extended table item with status (sudId=${sysId}, id=${id}, subId=${subId})`);
+            }
+        }
+        /* v8 ignore stop */
+        const writeResponse = await this.retry(() => this.znp.requestWithReply(constants_1.Subsystem.SYS, 'nvWrite', {
+            sysid: sysId,
+            itemid: id,
+            subid: subId,
+            offset: offset || 0,
+            len: data.length,
+            value: data,
+        }));
+        /* v8 ignore start */
+        if (writeResponse.payload.status !== 0) {
+            throw new Error(`Received non-success status while writing NV extended table idem (sudId=${sysId}, id=${id}, subId=${subId}, offset=${offset}, status=${writeResponse.payload.status})`);
+        }
+        /* v8 ignore stop */
+    }
+    async readTable(mode, p1, p2, p3, p4) {
+        const sysId = mode === 'legacy' ? undefined : p1;
+        const id = (mode === 'legacy' ? p1 : p2);
+        const maxLength = (mode === 'legacy' ? p2 : p3);
+        const useTable = (mode === 'legacy' ? p3 : p4);
+        const rawEntries = [];
+        let entryOffset = 0;
+        let rawEntry = null;
+        if (mode === 'legacy') {
+            do {
+                rawEntry = await this.readItem(id + entryOffset++);
+                if (rawEntry) {
+                    rawEntries.push(rawEntry);
+                }
+            } while (rawEntry !== null && entryOffset < maxLength);
+        }
+        else {
+            do {
+                (0, node_assert_1.default)(sysId !== undefined);
+                rawEntry = await this.readExtendedTableEntry(sysId, id, entryOffset++);
+                if (rawEntry) {
+                    rawEntries.push(rawEntry);
+                }
+                /* v8 ignore next */
+            } while (rawEntry !== null && (!maxLength || entryOffset < maxLength));
+        }
+        /* v8 ignore next */
+        return useTable ? useTable(rawEntries) : rawEntries;
+    }
+    async writeTable(mode, p1, p2, p3) {
+        this.checkMemoryAlignmentSetup();
+        const sysId = mode === 'legacy' ? undefined : p1;
+        const id = (mode === 'legacy' ? p1 : p2);
+        const table = (mode === 'legacy' ? p2 : p3);
+        if (mode === 'legacy') {
+            for (const [index, entry] of table.entries.entries()) {
+                await this.writeItem(id + index, entry.serialize(this.memoryAlignment));
+            }
+        }
+        else {
+            (0, node_assert_1.default)(sysId !== undefined);
+            for (const [index, entry] of table.entries.entries()) {
+                await this.writeExtendedTableEntry(sysId, id, index, entry.serialize(this.memoryAlignment));
+            }
+        }
+    }
+    /**
+     * Internal function to prevent occasional ZNP request failures.
+     *
+     * *Some timeouts were present when working with SimpleLink Z-Stack 3.x.0+.*
+     *
+     * @param fn Function to retry.
+     * @param retries Maximum number of retries.
+     */
+    // @ts-expect-error always returns something or throws an error as retries >= 1
+    async retry(fn, retries = 3) {
+        (0, node_assert_1.default)(retries >= 1);
+        let i = 0;
+        while (i < retries) {
+            try {
+                const result = await fn();
+                return result;
+                /* v8 ignore start */
+            }
+            catch (error) {
+                if (i >= retries) {
+                    throw error;
+                }
+            }
+            i++;
+        }
+        /* v8 ignore stop */
+    }
+    /**
+     * Internal function used by NV manipulation methods to check for correct driver initialization.
+     */
+    checkMemoryAlignmentSetup() {
+        /* v8 ignore start */
+        if (this.memoryAlignment === undefined) {
+            throw new Error('adapter memory alignment unknown - has nv memory driver been initialized?');
+        }
+        /* v8 ignore stop */
+    }
+}
+exports.AdapterNvMemory = AdapterNvMemory;
+//# sourceMappingURL=adapter-nv-memory.js.map

package/dist/adapter/z-stack/adapter/adapter-nv-memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter-nv-memory.js","sourceRoot":"","sources":["../../../../src/adapter/z-stack/adapter/adapter-nv-memory.ts"],"names":[],"mappings":"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"}

package/dist/adapter/z-stack/adapter/endpoints.d.ts

@@ -0,0 +1,12 @@
+export declare const Endpoints: {
+    endpoint: number;
+    appprofid: number;
+    appdeviceid: number;
+    appdevver: number;
+    appnuminclusters: number;
+    appinclusterlist: number[];
+    appnumoutclusters: number;
+    appoutclusterlist: number[];
+    latencyreq: number;
+}[];
+//# sourceMappingURL=endpoints.d.ts.map

package/dist/adapter/z-stack/adapter/endpoints.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"endpoints.d.ts","sourceRoot":"","sources":["../../../../src/adapter/z-stack/adapter/endpoints.ts"],"names":[],"mappings":"AAqBA,eAAO,MAAM,SAAS;;;iBAjBL,MAAM;eACR,MAAM;sBACC,MAAM;sBACN,MAAM,EAAE;uBACP,MAAM;uBACN,MAAM,EAAE;gBACf,MAAM;GA8CrB,CAAC"}

package/dist/adapter/z-stack/adapter/endpoints.js

@@ -0,0 +1,84 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Endpoints = void 0;
+const cluster_1 = require("../../../zspec/zcl/definition/cluster");
+const Constants = __importStar(require("../constants"));
+const EndpointDefaults = {
+    appdeviceid: 0x0005,
+    appdevver: 0,
+    appnuminclusters: 0,
+    appinclusterlist: [],
+    appnumoutclusters: 0,
+    appoutclusterlist: [],
+    latencyreq: Constants.AF.networkLatencyReq.NO_LATENCY_REQS,
+};
+exports.Endpoints = [
+    { ...EndpointDefaults, endpoint: 1, appprofid: 0x0104 },
+    { ...EndpointDefaults, endpoint: 2, appprofid: 0x0101 },
+    // Required for https://github.com/Koenkk/zigbee-herdsman-converters/commit/d0fb06c2429171f327950484ea3dec80864637cc
+    { ...EndpointDefaults, endpoint: 3, appprofid: 0x0104 },
+    { ...EndpointDefaults, endpoint: 4, appprofid: 0x0107 },
+    { ...EndpointDefaults, endpoint: 5, appprofid: 0x0108 },
+    { ...EndpointDefaults, endpoint: 6, appprofid: 0x0109 },
+    { ...EndpointDefaults, endpoint: 8, appprofid: 0x0104 },
+    { ...EndpointDefaults, endpoint: 10, appprofid: 0x0104 },
+    {
+        ...EndpointDefaults,
+        endpoint: 11,
+        appprofid: 0x0104,
+        appdeviceid: 0x0400,
+        appnumoutclusters: 2,
+        appoutclusterlist: [cluster_1.Clusters.ssIasZone.ID, cluster_1.Clusters.ssIasWd.ID],
+        appnuminclusters: 2,
+        // genTime required for https://github.com/Koenkk/zigbee2mqtt/issues/10816
+        appinclusterlist: [cluster_1.Clusters.ssIasAce.ID, cluster_1.Clusters.genTime.ID],
+    },
+    // TERNCY: https://github.com/Koenkk/zigbee-herdsman/issues/82
+    { ...EndpointDefaults, endpoint: 0x6e, appprofid: 0x0104 },
+    { ...EndpointDefaults, endpoint: 12, appprofid: 0xc05e },
+    {
+        ...EndpointDefaults,
+        endpoint: 13,
+        appprofid: 0x0104,
+        appnuminclusters: 1,
+        appinclusterlist: [cluster_1.Clusters.genOta.ID],
+    },
+    // Insta/Jung/Gira: OTA fallback EP (since it's buggy in firmware 10023202 when it tries to find a matching EP for
+    // OTA - it queries for ZLL profile, but then contacts with HA profile)
+    { ...EndpointDefaults, endpoint: 47, appprofid: 0x0104 },
+    { ...EndpointDefaults, endpoint: 242, appprofid: 0xa1e0 },
+];
+//# sourceMappingURL=endpoints.js.map

package/dist/adapter/z-stack/adapter/endpoints.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"endpoints.js","sourceRoot":"","sources":["../../../../src/adapter/z-stack/adapter/endpoints.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,mEAA+D;AAC/D,wDAA0C;AAE1C,MAAM,gBAAgB,GAQlB;IACA,WAAW,EAAE,MAAM;IACnB,SAAS,EAAE,CAAC;IACZ,gBAAgB,EAAE,CAAC;IACnB,gBAAgB,EAAE,EAAE;IACpB,iBAAiB,EAAE,CAAC;IACpB,iBAAiB,EAAE,EAAE;IACrB,UAAU,EAAE,SAAS,CAAC,EAAE,CAAC,iBAAiB,CAAC,eAAe;CAC7D,CAAC;AAEW,QAAA,SAAS,GAAG;IACrB,EAAC,GAAG,gBAAgB,EAAE,QAAQ,EAAE,CAAC,EAAE,SAAS,EAAE,MAAM,EAAC;IACrD,EAAC,GAAG,gBAAgB,EAAE,QAAQ,EAAE,CAAC,EAAE,SAAS,EAAE,MAAM,EAAC;IACrD,oHAAoH;IACpH,EAAC,GAAG,gBAAgB,EAAE,QAAQ,EAAE,CAAC,EAAE,SAAS,EAAE,MAAM,EAAC;IACrD,EAAC,GAAG,gBAAgB,EAAE,QAAQ,EAAE,CAAC,EAAE,SAAS,EAAE,MAAM,EAAC;IACrD,EAAC,GAAG,gBAAgB,EAAE,QAAQ,EAAE,CAAC,EAAE,SAAS,EAAE,MAAM,EAAC;IACrD,EAAC,GAAG,gBAAgB,EAAE,QAAQ,EAAE,CAAC,EAAE,SAAS,EAAE,MAAM,EAAC;IACrD,EAAC,GAAG,gBAAgB,EAAE,QAAQ,EAAE,CAAC,EAAE,SAAS,EAAE,MAAM,EAAC;IACrD,EAAC,GAAG,gBAAgB,EAAE,QAAQ,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,EAAC;IACtD;QACI,GAAG,gBAAgB;QACnB,QAAQ,EAAE,EAAE;QACZ,SAAS,EAAE,MAAM;QACjB,WAAW,EAAE,MAAM;QACnB,iBAAiB,EAAE,CAAC;QACpB,iBAAiB,EAAE,CAAC,kBAAQ,CAAC,SAAS,CAAC,EAAE,EAAE,kBAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QAC/D,gBAAgB,EAAE,CAAC;QACnB,0EAA0E;QAC1E,gBAAgB,EAAE,CAAC,kBAAQ,CAAC,QAAQ,CAAC,EAAE,EAAE,kBAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;KAChE;IACD,8DAA8D;IAC9D,EAAC,GAAG,gBAAgB,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAC;IACxD,EAAC,GAAG,gBAAgB,EAAE,QAAQ,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,EAAC;IACtD;QACI,GAAG,gBAAgB;QACnB,QAAQ,EAAE,EAAE;QACZ,SAAS,EAAE,MAAM;QACjB,gBAAgB,EAAE,CAAC;QACnB,gBAAgB,EAAE,CAAC,kBAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;KACzC;IACD,kHAAkH;IAClH,uEAAuE;IACvE,EAAC,GAAG,gBAAgB,EAAE,QAAQ,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,EAAC;IACtD,EAAC,GAAG,gBAAgB,EAAE,QAAQ,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,EAAC;CAC1D,CAAC"}

package/dist/adapter/z-stack/adapter/manager.d.ts

@@ -0,0 +1,86 @@
+import { TsType } from '../../';
+import { StartupOptions } from '../models/startup-options';
+import { Znp } from '../znp';
+import { AdapterBackup } from './adapter-backup';
+import { AdapterNvMemory } from './adapter-nv-memory';
+import { ZStackAdapter } from './zStackAdapter';
+/**
+ * ZNP Adapter Manager is responsible for handling adapter startup, network commissioning,
+ * configuration backup and restore.
+ */
+export declare class ZnpAdapterManager {
+    nv: AdapterNvMemory;
+    backup: AdapterBackup;
+    private znp;
+    private adapter;
+    private options;
+    private nwkOptions;
+    constructor(adapter: ZStackAdapter, znp: Znp, options: StartupOptions);
+    /**
+     * Performs ZNP adapter startup. After this method returns the adapter is configured, endpoints are registered
+     * and network is ready to process frames.
+     */
+    start(): Promise<TsType.StartResult>;
+    /**
+     * Internal function to determine startup strategy. The strategy determination flow is described in
+     * [this GitHub issue comment](https://github.com/Koenkk/zigbee-herdsman/issues/286#issuecomment-761029689).
+     */
+    private determineStrategy;
+    /**
+     * Internal method to perform regular adapter startup in coordinator mode.
+     */
+    private beginStartup;
+    /**
+     * Internal method to perform adapter restore.
+     */
+    private beginRestore;
+    /**
+     * Internal method to perform new network commissioning. Network commissioning creates a new ZigBee
+     * network using the adapter.
+     *
+     * @param nwkOptions Options to configure the new network with.
+     * @param failOnCollision Whether process should throw an error if PAN ID collision is detected.
+     * @param writeConfiguredFlag Whether zigbee-herdsman `hasConfigured` flag should be written to NV.
+     */
+    private beginCommissioning;
+    /**
+     * Updates commissioning NV memory parameters in connected controller. This method should be invoked
+     * to configure network commissioning parameters or update the controller after restore.
+     *
+     * @param options Network options to set in NV memory.
+     */
+    private updateCommissioningNvItems;
+    /**
+     * Registers endpoints before beginning normal operation.
+     */
+    private registerEndpoints;
+    /**
+     * Adds endpoint to group.
+     *
+     * @param endpoint Endpoint index to add.
+     * @param group Target group index.
+     */
+    private addToGroup;
+    /**
+     * Internal method to reset the adapter.
+     */
+    private resetAdapter;
+    /**
+     * Internal method to reset adapter config and data.
+     */
+    private clearAdapter;
+    /**
+     * Transforms Z2M number-based network options to local Buffer-based options.
+     *
+     * This function also takes care of `dd:dd:dd:dd:dd:dd:dd:dd` extended PAN ID
+     * and replaces it with adapter IEEE address.
+     *
+     * @param options Source Z2M network options.
+     */
+    private parseConfigNetworkOptions;
+    /**
+     * Writes ZNP `hasConfigured` flag to NV memory. This flag indicates the adapter has been configured.
+     */
+    private writeConfigurationFlag;
+}
+//# sourceMappingURL=manager.d.ts.map

package/dist/adapter/z-stack/adapter/manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../../../src/adapter/z-stack/adapter/manager.ts"],"names":[],"mappings":"AAEA,OAAO,EAAC,MAAM,EAAC,MAAM,QAAQ,CAAC;AAQ9B,OAAO,EAAC,cAAc,EAAC,MAAM,2BAA2B,CAAC;AAKzD,OAAO,EAAC,GAAG,EAAC,MAAM,QAAQ,CAAC;AAC3B,OAAO,EAAC,aAAa,EAAC,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAC,eAAe,EAAC,MAAM,qBAAqB,CAAC;AAGpD,OAAO,EAAC,aAAa,EAAC,MAAM,iBAAiB,CAAC;AAS9C;;;GAGG;AACH,qBAAa,iBAAiB;IACnB,EAAE,EAAE,eAAe,CAAC;IACpB,MAAM,EAAE,aAAa,CAAC;IAE7B,OAAO,CAAC,GAAG,CAAM;IACjB,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,OAAO,CAAiB;IAEhC,OAAO,CAAC,UAAU,CAAwB;gBAEvB,OAAO,EAAE,aAAa,EAAE,GAAG,EAAE,GAAG,EAAE,OAAO,EAAE,cAAc;IAQ5E;;;OAGG;IACU,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC;IAmDjD;;;OAGG;YACW,iBAAiB;IAsK/B;;OAEG;YACW,YAAY;IAgB1B;;OAEG;YACW,YAAY;IA4C1B;;;;;;;OAOG;YACW,kBAAkB;IA6DhC;;;;;OAKG;YACW,0BAA0B;IAqCxC;;OAEG;YACW,iBAAiB;IAqB/B;;;;;OAKG;YACW,UAAU;IAUxB;;OAEG;YACW,YAAY;IAM1B;;OAEG;YACW,YAAY;IAO1B;;;;;;;OAOG;YACW,yBAAyB;IAmBvC;;OAEG;YACW,sBAAsB;CAOvC"}