zigbee-herdsman 3.1.0 → 3.1.1

package/dist/adapter/ember/uart/enums.js

@@ -0,0 +1,197 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NcpFailedCode = exports.AshReservedByte = exports.AshFrameType = void 0;
+/**
+ * Identify the type of frame from control byte.
+ *
+ * Control byte formats
+ *  +---------+----+----+----+----+----+----+----+----++---------+
+ *  |         | B7 | B6 | B5 | B4 | B3 | B2 | B1 | B0 ||  Range  |
+ *  +---------+----+----+----+----+----+----+----+----++---------+
+ *  | DATA    |  0 |   frameNum   | rF |    ackNum    ||0x00-0x7F|
+ *  +---------+----+----+----+----+----+----+----+----++---------+
+ *  | ACK     |  1 |  0 |  0 | pF | nF |    ackNum    ||0x80-0x9F|
+ *  | NAK     |  1 |  0 |  1 | pF | nF |    ackNum    ||0xA0-0xBF|
+ *  +---------+----+----+----+----+----+----+----+----++---------+
+ *  | RST     |  1 |  1 |  0 |  0 |  0 |  0 |  0 |  0 ||   0xC0  |
+ *  | RSTACK  |  1 |  1 |  0 |  0 |  0 |  0 |  0 |  1 ||   0xC1  |
+ *  | ERROR   |  1 |  1 |  0 |  0 |  0 |  0 |  1 |  0 ||   0xC2  |
+ *  +---------+----+----+----+----+----+----+----+----++---------+
+ *           rF = rFlag (retransmission flag)
+ *           nF = nFlag (receiver not ready flag, always 0 in frames sent by the NCP)
+ *           pF = flag reserved for future use
+ *           frameNum = DATA frame’s 3-bit sequence number
+ *           ackNum = acknowledges receipt of DATA frames up to, but not including, ackNum
+ *  Control byte values 0xC3-0xFE are unused, 0xFF is reserved.
+ */
+var AshFrameType;
+(function (AshFrameType) {
+    AshFrameType[AshFrameType["INVALID"] = -1] = "INVALID";
+    /**
+     * Carries all EZSP frames.
+     *
+     * [CONTROL, EZSP 0, EZSP 1, EZSP 2, EZSP n, CRC high, CRC low, FLAG]
+     *
+     * Notation used in documentation: DATA(F, A, R)
+     * - F: frame number (frmNum)
+     * - A: acknowledge number (ackNum)
+     * - R: retransmit flag (reTx)
+     *
+     * Example without pseudo-random sequence applied to Data Field:
+     * - EZSP “version” command: 00 00 00 02
+     * - DATA(2, 5, 0) = 25 00 00 00 02 1A AD 7E
+     * - EZSP “version” response: 00 80 00 02 02 11 30
+     * - DATA(5, 3, 0) = 53 00 80 00 02 02 11 30 63 16 7E
+     *
+     * Example with pseudo-random sequence applied to Data Field:
+     * - EZSP “version” command: 00 00 00 02
+     * - DATA(2, 5, 0) = 25 42 21 A8 56 A6 09 7E
+     * - EZSP “version” response: 00 80 00 02 02 11 30
+     * - DATA(5, 3, 0) = 53 42 A1 A8 56 28 04 82 96 23 7E
+     *
+     * Sent by: NCP, Host
+     */
+    AshFrameType[AshFrameType["DATA"] = 0] = "DATA";
+    /**
+     * Acknowledges receipt of a valid DATA frame.
+     *
+     * [CONTROL, CRC high, CRC low, FLAG]
+     *
+     * Notation used in documentation: ACK(A)+/-
+     * - A: acknowledge number (ackNum)
+     * - +/-: not ready flag (nRdy); “+” = “0” = “ready”; “-” = “1” = “not ready”
+     *
+     * Examples:
+     * - ACK(1)+ :81 60 59 7E
+     * - ACK(6)– : 8E 91 B6 7E
+     *
+     * Sent by: NCP, Host
+     */
+    AshFrameType[AshFrameType["ACK"] = 128] = "ACK";
+    /**
+     * Indicates receipt of a DATA frame with an error or that was discarded due to lack of memory.
+     *
+     * [CONTROL, CRC high, CRC low, FLAG]
+     *
+     * Notation used in documentation: NAK(A)+/-
+     * - A: acknowledge number (ackNum)
+     * - +/-: not ready flag (nRdy); “+” = “0” = “ready”; “-” = “1” = “not ready”
+     *
+     * Examples:
+     * - NAK(6)+ : A6 34 DC 7E
+     * - NAK(5)- : AD 85 B7 7E
+     *
+     * Sent by: NCP, Host
+     */
+    AshFrameType[AshFrameType["NAK"] = 160] = "NAK";
+    /**
+     * Requests the NCP to perform a software reset (valid even if the NCP is in the FAILED state).
+     *
+     * [CONTROL, CRC high, CRC low, FLAG]
+     *
+     * Notation used in documentation: RST()
+     *
+     * Example: C0 38 BC 7E
+     *
+     * Sent by: Host
+     */
+    AshFrameType[AshFrameType["RST"] = 192] = "RST";
+    /**
+     * Informs the Host that the NCP has reset and the reason for the reset.
+     *
+     * [CONTROL, version, reset code, CRC high, CRC low, FLAG]
+     *
+     * Notation used in documentation: RSTACK(V, C)
+     * - V: version
+     * - C: reset code
+     *
+     * Example: C1 02 02 9B 7B 7E
+     *
+     * Sent by: NCP
+     */
+    AshFrameType[AshFrameType["RSTACK"] = 193] = "RSTACK";
+    /**
+     * Informs the Host that the NCP detected a fatal error and is in the FAILED state.
+     *
+     * [CONTROL, version, error code, CRC high, CRC low, FLAG]
+     *
+     * Notation used in documentation: ERROR(V, C )
+     * - V: version
+     * - C: reset code
+     *
+     * Example: C2 01 52 FA BD 7E
+     *
+     * Sent by: NCP
+     */
+    AshFrameType[AshFrameType["ERROR"] = 194] = "ERROR";
+})(AshFrameType || (exports.AshFrameType = AshFrameType = {}));
+var AshReservedByte;
+(function (AshReservedByte) {
+    /**
+     * Marks the end of a frame.
+     *
+     * When a Flag Byte is received, the data received since the last Flag Byte or Cancel Byte
+     * is tested to see whether it is a valid frame. */
+    AshReservedByte[AshReservedByte["FLAG"] = 126] = "FLAG";
+    /**
+     * Indicates that the following byte is escaped.
+     *
+     * If the byte after the Escape Byte is not a reserved byte,
+     * bit 5 of the byte is complemented to restore its original value.
+     * If the byte after the Escape Byte is a reserved value, the Escape Byte has no effect. */
+    AshReservedByte[AshReservedByte["ESCAPE"] = 125] = "ESCAPE";
+    /**
+     * Resume transmission.
+     *
+     * Used in XON/XOFF flow control. Always ignored if received by the NCP.
+     */
+    AshReservedByte[AshReservedByte["XON"] = 17] = "XON";
+    /**
+     * Stop transmission.
+     *
+     * Used in XON/XOFF flow control. Always ignored if received by the NCP
+     */
+    AshReservedByte[AshReservedByte["XOFF"] = 19] = "XOFF";
+    /**
+     * Replaces a byte received with a low-level communication error (e.g., framing error) from the UART.
+     *
+     * When a Substitute Byte is processed, the data between the previous and the next Flag Bytes is ignored.
+     */
+    AshReservedByte[AshReservedByte["SUBSTITUTE"] = 24] = "SUBSTITUTE";
+    /**
+     * Terminates a frame in progress.
+     *
+     * A Cancel Byte causes all data received since the previous Flag Byte to be ignored.
+     * Note that as a special case, RST and RSTACK frames are preceded by Cancel Bytes to ignore any link startup noise.
+     */
+    AshReservedByte[AshReservedByte["CANCEL"] = 26] = "CANCEL";
+})(AshReservedByte || (exports.AshReservedByte = AshReservedByte = {}));
+/**
+ * The NCP enters the FAILED state if it detects one of the following errors:
+ * - An abnormal internal reset due to an error, failed assertion, or fault.
+ * - Exceeding the maximum number of consecutive acknowledgement timeouts.
+ *
+ * When the NCP enters the FAILED state, the NCP sends an ERROR frame containing a reset or error code
+ * and will reply to all subsequent frames received, except RST, with an ERROR frame.
+ * To reinitialize the ASH protocol, the Host must reset the NCP by either asserting the nRESET pin or sending the RST frame.
+ *
+ * The codes are returned by the NCP in the:
+ * - Reset Code byte of a RSTACK frame
+ * - Error Code byte of an ERROR frame.
+ *
+ * Silicon Labs wireless mesh chips can detect numerous reset fault causes beyond those in the table.
+ * When sent to the host, these new reset codes have 0x80 added to the value returned by their HAL’s reset code.
+ */
+var NcpFailedCode;
+(function (NcpFailedCode) {
+    NcpFailedCode[NcpFailedCode["RESET_UNKNOWN_REASON"] = 0] = "RESET_UNKNOWN_REASON";
+    NcpFailedCode[NcpFailedCode["RESET_EXTERNAL"] = 1] = "RESET_EXTERNAL";
+    NcpFailedCode[NcpFailedCode["RESET_POWERON"] = 2] = "RESET_POWERON";
+    NcpFailedCode[NcpFailedCode["RESET_WATCHDOG"] = 3] = "RESET_WATCHDOG";
+    NcpFailedCode[NcpFailedCode["RESET_ASSERT"] = 6] = "RESET_ASSERT";
+    NcpFailedCode[NcpFailedCode["RESET_BOOTLOADER"] = 9] = "RESET_BOOTLOADER";
+    NcpFailedCode[NcpFailedCode["RESET_SOFTWARE"] = 11] = "RESET_SOFTWARE";
+    NcpFailedCode[NcpFailedCode["ERROR_EXCEEDED_MAXIMUM_ACK_TIMEOUT_COUNT"] = 81] = "ERROR_EXCEEDED_MAXIMUM_ACK_TIMEOUT_COUNT";
+    NcpFailedCode[NcpFailedCode["CHIP_SPECIFIC_ERROR_RESET_CODE"] = 128] = "CHIP_SPECIFIC_ERROR_RESET_CODE";
+})(NcpFailedCode || (exports.NcpFailedCode = NcpFailedCode = {}));
+//# sourceMappingURL=enums.js.map

package/dist/adapter/ember/uart/enums.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"enums.js","sourceRoot":"","sources":["../../../../src/adapter/ember/uart/enums.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,IAAY,YAmGX;AAnGD,WAAY,YAAY;IACpB,sDAAY,CAAA;IACZ;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,+CAAQ,CAAA;IACR;;;;;;;;;;;;;;OAcG;IACH,+CAAU,CAAA;IACV;;;;;;;;;;;;;;OAcG;IACH,+CAAU,CAAA;IACV;;;;;;;;;;OAUG;IACH,+CAAU,CAAA;IACV;;;;;;;;;;;;OAYG;IACH,qDAAa,CAAA;IACb;;;;;;;;;;;;OAYG;IACH,mDAAY,CAAA;AAChB,CAAC,EAnGW,YAAY,4BAAZ,YAAY,QAmGvB;AAED,IAAY,eAuCX;AAvCD,WAAY,eAAe;IACvB;;;;uDAImD;IACnD,uDAAW,CAAA;IACX;;;;;+FAK2F;IAC3F,2DAAa,CAAA;IACb;;;;OAIG;IACH,oDAAU,CAAA;IACV;;;;OAIG;IACH,sDAAW,CAAA;IACX;;;;OAIG;IACH,kEAAiB,CAAA;IACjB;;;;;OAKG;IACH,0DAAa,CAAA;AACjB,CAAC,EAvCW,eAAe,+BAAf,eAAe,QAuC1B;AAED;;;;;;;;;;;;;;;GAeG;AACH,IAAY,aAUX;AAVD,WAAY,aAAa;IACrB,iFAAwB,CAAA;IACxB,qEAAkB,CAAA;IAClB,mEAAiB,CAAA;IACjB,qEAAkB,CAAA;IAClB,iEAAgB,CAAA;IAChB,yEAAoB,CAAA;IACpB,sEAAmB,CAAA;IACnB,0HAA+C,CAAA;IAC/C,uGAAqC,CAAA;AACzC,CAAC,EAVW,aAAa,6BAAb,aAAa,QAUxB"}

package/dist/adapter/ember/uart/parser.d.ts

@@ -0,0 +1,8 @@
+import { Transform, TransformCallback, TransformOptions } from 'node:stream';
+export declare class AshParser extends Transform {
+    private buffer;
+    constructor(opts?: TransformOptions);
+    _transform(chunk: Buffer, encoding: BufferEncoding, cb: TransformCallback): void;
+    _flush(cb: TransformCallback): void;
+}
+//# sourceMappingURL=parser.d.ts.map

package/dist/adapter/ember/uart/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../../../src/adapter/ember/uart/parser.ts"],"names":[],"mappings":"AAEA,OAAO,EAAC,SAAS,EAAE,iBAAiB,EAAE,gBAAgB,EAAC,MAAM,aAAa,CAAC;AAO3E,qBAAa,SAAU,SAAQ,SAAS;IACpC,OAAO,CAAC,MAAM,CAAS;gBAEJ,IAAI,CAAC,EAAE,gBAAgB;IAMjC,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,EAAE,EAAE,EAAE,iBAAiB,GAAG,IAAI;IAqBhF,MAAM,CAAC,EAAE,EAAE,iBAAiB,GAAG,IAAI;CAO/C"}

package/dist/adapter/ember/uart/parser.js

@@ -0,0 +1,37 @@
+"use strict";
+/* v8 ignore start */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AshParser = void 0;
+const node_stream_1 = require("node:stream");
+// import {logger} from '../../../utils/logger';
+const enums_1 = require("./enums");
+// const NS = 'zh:ember:uart:ash:parser';
+class AshParser extends node_stream_1.Transform {
+    buffer;
+    constructor(opts) {
+        super(opts);
+        this.buffer = Buffer.alloc(0);
+    }
+    _transform(chunk, encoding, cb) {
+        let data = Buffer.concat([this.buffer, chunk]);
+        let position;
+        while ((position = data.indexOf(enums_1.AshReservedByte.FLAG)) !== -1) {
+            // emit the frame via 'data' event
+            const frame = data.subarray(0, position + 1);
+            // expensive and very verbose, enable locally only if necessary
+            // logger.debug(`<<<< [FRAME raw=${frame.toString('hex')}]`, NS);
+            this.push(frame);
+            // remove the frame from internal buffer (set below)
+            data = data.subarray(position + 1);
+        }
+        this.buffer = data;
+        cb();
+    }
+    _flush(cb) {
+        this.push(this.buffer);
+        this.buffer = Buffer.alloc(0);
+        cb();
+    }
+}
+exports.AshParser = AshParser;
+//# sourceMappingURL=parser.js.map

package/dist/adapter/ember/uart/parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.js","sourceRoot":"","sources":["../../../../src/adapter/ember/uart/parser.ts"],"names":[],"mappings":";AAAA,qBAAqB;;;AAErB,6CAA2E;AAE3E,gDAAgD;AAChD,mCAAwC;AAExC,yCAAyC;AAEzC,MAAa,SAAU,SAAQ,uBAAS;IAC5B,MAAM,CAAS;IAEvB,YAAmB,IAAuB;QACtC,KAAK,CAAC,IAAI,CAAC,CAAC;QAEZ,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAClC,CAAC;IAEQ,UAAU,CAAC,KAAa,EAAE,QAAwB,EAAE,EAAqB;QAC9E,IAAI,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC;QAC/C,IAAI,QAAgB,CAAC;QAErB,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,uBAAe,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;YAC5D,kCAAkC;YAClC,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,EAAE,QAAQ,GAAG,CAAC,CAAC,CAAC;YAE7C,+DAA+D;YAC/D,iEAAiE;YACjE,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAEjB,oDAAoD;YACpD,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC;QACvC,CAAC;QAED,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QAEnB,EAAE,EAAE,CAAC;IACT,CAAC;IAEQ,MAAM,CAAC,EAAqB;QACjC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAEvB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAE9B,EAAE,EAAE,CAAC;IACT,CAAC;CACJ;AArCD,8BAqCC"}

package/dist/adapter/ember/uart/queues.d.ts

@@ -0,0 +1,84 @@
+/**
+ * Buffer to hold a DATA frame.
+ * Allocates `data` to `EZSP_MAX_FRAME_LENGTH` filled with zeroes.
+ */
+export declare class EzspBuffer {
+    /** uint8_t[EZSP_MAX_FRAME_LENGTH] */
+    data: Buffer;
+    link?: EzspBuffer;
+    /** uint8_t */
+    len: number;
+    constructor();
+}
+/**
+ * Simple queue (singly-linked list)
+ */
+export declare class EzspQueue {
+    tail?: EzspBuffer;
+    constructor();
+    /**
+     * Get the number of buffers in the queue.
+     * @returns
+     */
+    get length(): number;
+    get empty(): boolean;
+    /**
+     * Get a pointer to the buffer at the head of the queue.
+     * @returns
+     */
+    get head(): EzspBuffer;
+    /**
+     * Get a pointer to the Nth entry in the queue (the tail corresponds to N = 1).
+     *
+     * @param n
+     * @returns
+     */
+    getNthEntry(n: number): EzspBuffer | undefined;
+    /**
+     * Get a pointer to the entry before the specified entry (closer to the tail).
+     * If the buffer specified is undefined, the head entry is returned.
+     * If the buffer specified is the tail, undefined is returned.
+     * @param entry The buffer to look before.
+     * @returns
+     */
+    getPrecedingEntry(entry?: EzspBuffer): EzspBuffer | undefined;
+    /**
+     * Add a buffer to the tail of the queue.
+     * @param buf
+     */
+    addTail(buf: EzspBuffer): void;
+    /**
+     * Remove the buffer at the head of the queue.
+     * @returns The removed buffer.
+     */
+    removeHead(): EzspBuffer;
+    /**
+     * Remove the specified entry from the queue.
+     * @param entry
+     * @returns A pointer to the preceding entry (if any).
+     */
+    removeEntry(entry: EzspBuffer): EzspBuffer | undefined;
+}
+/**
+ * Simple free list (singly-linked list)
+ */
+export declare class EzspFreeList {
+    link?: EzspBuffer;
+    constructor();
+    /**
+     * Get the number of buffers in the free list.
+     * @returns
+     */
+    get length(): number;
+    /**
+     * Add a buffer to the free list.
+     * @param buf
+     */
+    freeBuffer(buf: EzspBuffer): void;
+    /**
+     * Get a buffer from the free list.
+     * @returns
+     */
+    allocBuffer(): EzspBuffer | undefined;
+}
+//# sourceMappingURL=queues.d.ts.map

package/dist/adapter/ember/uart/queues.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queues.d.ts","sourceRoot":"","sources":["../../../../src/adapter/ember/uart/queues.ts"],"names":[],"mappings":"AAOA;;;GAGG;AACH,qBAAa,UAAU;IACnB,qCAAqC;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,UAAU,CAAC;IACzB,cAAc;IACP,GAAG,EAAE,MAAM,CAAC;;CAOtB;AAED;;GAEG;AACH,qBAAa,SAAS;IACX,IAAI,CAAC,EAAE,UAAU,CAAC;;IAMzB;;;OAGG;IACH,IAAI,MAAM,IAAI,MAAM,CASnB;IAED,IAAI,KAAK,IAAI,OAAO,CAEnB;IAED;;;OAGG;IACH,IAAI,IAAI,IAAI,UAAU,CAYrB;IAED;;;;;OAKG;IACI,WAAW,CAAC,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS;IAkBrD;;;;;;OAMG;IACI,iBAAiB,CAAC,KAAK,CAAC,EAAE,UAAU,GAAG,UAAU,GAAG,SAAS;IAsBpE;;;OAGG;IACI,OAAO,CAAC,GAAG,EAAE,UAAU,GAAG,IAAI;IASrC;;;OAGG;IACI,UAAU,IAAI,UAAU;IAuB/B;;;;OAIG;IACI,WAAW,CAAC,KAAK,EAAE,UAAU,GAAG,UAAU,GAAG,SAAS;CAWhE;AAED;;GAEG;AACH,qBAAa,YAAY;IACd,IAAI,CAAC,EAAE,UAAU,CAAC;;IAMzB;;;OAGG;IACH,IAAI,MAAM,IAAI,MAAM,CASnB;IAED;;;OAGG;IACI,UAAU,CAAC,GAAG,EAAE,UAAU,GAAG,IAAI;IASxC;;;OAGG;IACI,WAAW,IAAI,UAAU,GAAG,SAAS;CAqB/C"}

package/dist/adapter/ember/uart/queues.js

@@ -0,0 +1,215 @@
+"use strict";
+/* v8 ignore start */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EzspFreeList = exports.EzspQueue = exports.EzspBuffer = void 0;
+const logger_1 = require("../../../utils/logger");
+const consts_1 = require("../ezsp/consts");
+const NS = 'zh:ember:uart:queues';
+/**
+ * Buffer to hold a DATA frame.
+ * Allocates `data` to `EZSP_MAX_FRAME_LENGTH` filled with zeroes.
+ */
+class EzspBuffer {
+    /** uint8_t[EZSP_MAX_FRAME_LENGTH] */
+    data;
+    link;
+    /** uint8_t */
+    len;
+    constructor() {
+        this.data = Buffer.alloc(consts_1.EZSP_MAX_FRAME_LENGTH); // inits to all-zeroes
+        this.link = undefined;
+        this.len = 0;
+    }
+}
+exports.EzspBuffer = EzspBuffer;
+/**
+ * Simple queue (singly-linked list)
+ */
+class EzspQueue {
+    tail;
+    constructor() {
+        this.tail = undefined;
+    }
+    /**
+     * Get the number of buffers in the queue.
+     * @returns
+     */
+    get length() {
+        let head = this.tail;
+        let count = 0;
+        for (count; head != undefined; count++) {
+            head = head.link;
+        }
+        return count;
+    }
+    get empty() {
+        return this.tail == undefined;
+    }
+    /**
+     * Get a pointer to the buffer at the head of the queue.
+     * @returns
+     */
+    get head() {
+        let head = this.tail;
+        if (head == undefined) {
+            throw new Error(`Tried to get head from an empty queue.`);
+        }
+        while (head.link != undefined) {
+            head = head.link;
+        }
+        return head;
+    }
+    /**
+     * Get a pointer to the Nth entry in the queue (the tail corresponds to N = 1).
+     *
+     * @param n
+     * @returns
+     */
+    getNthEntry(n) {
+        if (n === 0) {
+            throw new Error(`Asked for 0th element in queue.`);
+        }
+        let buf = this.tail;
+        while (--n) {
+            if (buf == undefined) {
+                throw new Error(`Less than N entries in queue.`);
+            }
+            buf = buf.link;
+        }
+        return buf;
+    }
+    /**
+     * Get a pointer to the entry before the specified entry (closer to the tail).
+     * If the buffer specified is undefined, the head entry is returned.
+     * If the buffer specified is the tail, undefined is returned.
+     * @param entry The buffer to look before.
+     * @returns
+     */
+    getPrecedingEntry(entry) {
+        let buf = this.tail;
+        if (buf === entry) {
+            return undefined;
+        }
+        else {
+            if (buf == undefined) {
+                throw new Error(`Tried to get preceding entry from an empty queue.`);
+            }
+            do {
+                if (buf.link === entry) {
+                    return buf;
+                }
+                buf = buf.link;
+            } while (buf != undefined);
+            throw new Error(`Buffer not in queue.`);
+        }
+    }
+    /**
+     * Add a buffer to the tail of the queue.
+     * @param buf
+     */
+    addTail(buf) {
+        if (buf) {
+            buf.link = this.tail;
+            this.tail = buf;
+        }
+        else {
+            throw new Error(`Called addTail with undefined buffer`);
+        }
+    }
+    /**
+     * Remove the buffer at the head of the queue.
+     * @returns The removed buffer.
+     */
+    removeHead() {
+        let head = this.tail;
+        if (head == undefined) {
+            throw new Error(`Tried to remove head from an empty queue.`);
+        }
+        if (head.link == undefined) {
+            this.tail = undefined;
+        }
+        else {
+            let prev;
+            do {
+                prev = head;
+                head = head.link;
+            } while (head.link != undefined);
+            prev.link = undefined;
+        }
+        return head;
+    }
+    /**
+     * Remove the specified entry from the queue.
+     * @param entry
+     * @returns A pointer to the preceding entry (if any).
+     */
+    removeEntry(entry) {
+        const buf = this.getPrecedingEntry(entry);
+        if (buf != undefined) {
+            buf.link = entry.link;
+        }
+        else {
+            this.tail = entry.link;
+        }
+        return buf;
+    }
+}
+exports.EzspQueue = EzspQueue;
+/**
+ * Simple free list (singly-linked list)
+ */
+class EzspFreeList {
+    link;
+    constructor() {
+        this.link = undefined;
+    }
+    /**
+     * Get the number of buffers in the free list.
+     * @returns
+     */
+    get length() {
+        let next = this.link;
+        let count = 0;
+        for (count; next != undefined; count++) {
+            next = next.link;
+        }
+        return count;
+    }
+    /**
+     * Add a buffer to the free list.
+     * @param buf
+     */
+    freeBuffer(buf) {
+        if (buf) {
+            buf.link = this.link;
+            this.link = buf;
+        }
+        else {
+            throw new Error(`Called freeBuffer with undefined buffer`);
+        }
+    }
+    /**
+     * Get a buffer from the free list.
+     * @returns
+     */
+    allocBuffer() {
+        const buf = this.link;
+        if (buf != undefined) {
+            this.link = buf.link;
+            buf.len = 0;
+            if (buf.data.length !== consts_1.EZSP_MAX_FRAME_LENGTH) {
+                // should never happen if buffers are handled properly, but just in case, re-alloc to max length
+                buf.data = Buffer.alloc(consts_1.EZSP_MAX_FRAME_LENGTH);
+                const e = new Error();
+                logger_1.logger.error(`Pre-allocated buffer had improper size and had to be re-allocated. ${e.stack}`, NS);
+            }
+            else {
+                // (void) memset(buffer->data, 0, EZSP_MAX_FRAME_LENGTH);
+                buf.data.fill(0);
+            }
+        }
+        return buf;
+    }
+}
+exports.EzspFreeList = EzspFreeList;
+//# sourceMappingURL=queues.js.map

package/dist/adapter/ember/uart/queues.js.map

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

package/dist/adapter/ember/uart/writer.d.ts

@@ -0,0 +1,14 @@
+import { Readable, ReadableOptions } from 'node:stream';
+export declare class AshWriter extends Readable {
+    private bytesToWrite;
+    constructor(opts?: ReadableOptions);
+    private writeBytes;
+    writeByte(byte: number): void;
+    writeAvailable(): boolean;
+    /**
+     * If there is anything to send, send to the port.
+     */
+    writeFlush(): void;
+    _read(): void;
+}
+//# sourceMappingURL=writer.d.ts.map

package/dist/adapter/ember/uart/writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"writer.d.ts","sourceRoot":"","sources":["../../../../src/adapter/ember/uart/writer.ts"],"names":[],"mappings":"AAEA,OAAO,EAAC,QAAQ,EAAE,eAAe,EAAC,MAAM,aAAa,CAAC;AAMtD,qBAAa,SAAU,SAAQ,QAAQ;IACnC,OAAO,CAAC,YAAY,CAAW;gBAEnB,IAAI,CAAC,EAAE,eAAe;IAMlC,OAAO,CAAC,UAAU;IAWX,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAI7B,cAAc,IAAI,OAAO;IAUhC;;OAEG;IACI,UAAU,IAAI,IAAI;IAMT,KAAK,IAAI,IAAI;CAChC"}

package/dist/adapter/ember/uart/writer.js

@@ -0,0 +1,45 @@
+"use strict";
+/* v8 ignore start */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AshWriter = void 0;
+const node_stream_1 = require("node:stream");
+// import {logger} from '../../../utils/logger';
+// const NS = 'zh:ember:uart:ash:writer';
+class AshWriter extends node_stream_1.Readable {
+    bytesToWrite;
+    constructor(opts) {
+        super(opts);
+        this.bytesToWrite = [];
+    }
+    writeBytes() {
+        const buffer = Buffer.from(this.bytesToWrite);
+        this.bytesToWrite = [];
+        // expensive and very verbose, enable locally only if necessary
+        // logger.debug(`>>>> [FRAME raw=${buffer.toString('hex')}]`, NS);
+        // this.push(buffer);
+        this.emit('data', buffer);
+    }
+    writeByte(byte) {
+        this.bytesToWrite.push(byte);
+    }
+    writeAvailable() {
+        if (this.readableLength < this.readableHighWaterMark) {
+            return true;
+        }
+        else {
+            this.writeFlush();
+            return false;
+        }
+    }
+    /**
+     * If there is anything to send, send to the port.
+     */
+    writeFlush() {
+        if (this.bytesToWrite.length) {
+            this.writeBytes();
+        }
+    }
+    _read() { }
+}
+exports.AshWriter = AshWriter;
+//# sourceMappingURL=writer.js.map

package/dist/adapter/ember/uart/writer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"writer.js","sourceRoot":"","sources":["../../../../src/adapter/ember/uart/writer.ts"],"names":[],"mappings":";AAAA,qBAAqB;;;AAErB,6CAAsD;AAEtD,gDAAgD;AAEhD,yCAAyC;AAEzC,MAAa,SAAU,SAAQ,sBAAQ;IAC3B,YAAY,CAAW;IAE/B,YAAY,IAAsB;QAC9B,KAAK,CAAC,IAAI,CAAC,CAAC;QAEZ,IAAI,CAAC,YAAY,GAAG,EAAE,CAAC;IAC3B,CAAC;IAEO,UAAU;QACd,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAC9C,IAAI,CAAC,YAAY,GAAG,EAAE,CAAC;QAEvB,+DAA+D;QAC/D,kEAAkE;QAElE,qBAAqB;QACrB,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,CAAC;IAEM,SAAS,CAAC,IAAY;QACzB,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACjC,CAAC;IAEM,cAAc;QACjB,IAAI,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,qBAAqB,EAAE,CAAC;YACnD,OAAO,IAAI,CAAC;QAChB,CAAC;aAAM,CAAC;YACJ,IAAI,CAAC,UAAU,EAAE,CAAC;YAElB,OAAO,KAAK,CAAC;QACjB,CAAC;IACL,CAAC;IAED;;OAEG;IACI,UAAU;QACb,IAAI,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,CAAC;YAC3B,IAAI,CAAC,UAAU,EAAE,CAAC;QACtB,CAAC;IACL,CAAC;IAEe,KAAK,KAAU,CAAC;CACnC;AA5CD,8BA4CC"}

package/dist/adapter/ember/utils/initters.d.ts

@@ -0,0 +1,20 @@
+import { NetworkCache } from '../adapter/emberAdapter';
+import { EmberAesMmoHashContext, SecManContext } from '../types';
+/**
+ * Initialize a network cache index with proper "invalid" values.
+ * @returns
+ */
+export declare const initNetworkCache: () => NetworkCache;
+/**
+ * This routine will initialize a Security Manager context correctly for use in subsequent function calls.
+ * @returns
+ */
+export declare const initSecurityManagerContext: () => SecManContext;
+/**
+ *  This routine clears the passed context so that a new hash calculation
+ *  can be performed.
+ *
+ *  @returns context A pointer to the location of hash context to clear.
+ */
+export declare const aesMmoHashInit: () => EmberAesMmoHashContext;
+//# sourceMappingURL=initters.d.ts.map

package/dist/adapter/ember/utils/initters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"initters.d.ts","sourceRoot":"","sources":["../../../../src/adapter/ember/utils/initters.ts"],"names":[],"mappings":"AAGA,OAAO,EAAC,YAAY,EAAC,MAAM,yBAAyB,CAAC;AAIrD,OAAO,EAAC,sBAAsB,EAAE,aAAa,EAAC,MAAM,UAAU,CAAC;AAE/D;;;GAGG;AACH,eAAO,MAAM,gBAAgB,QAAO,YAcnC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,0BAA0B,QAAO,aAU7C,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,cAAc,QAAO,sBAMjC,CAAC"}