@ecopoesis/homebridge-dmx 0.1.0

package/dist/stick/kdf.js.map

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

package/dist/stick/protocol.d.ts

@@ -0,0 +1,28 @@
+import { Buffer } from 'node:buffer';
+export declare const TCP_PORT = 2431;
+export declare const UDP_DST_PORT = 2431;
+export declare const UDP_SRC_PORT = 2430;
+export declare const MAGIC: Buffer<ArrayBuffer>;
+export declare const LSAG: Buffer<ArrayBuffer>;
+export declare const P0: Buffer<ArrayBuffer>;
+export declare const AUTH_KEY: Buffer<ArrayBuffer>;
+export declare const Q_FALLBACK: Buffer<ArrayBuffer>;
+/** A monotonic 4-byte LE counter shared between TCP messages and UDP frame
+ *  fieldA. The Stick rejects out-of-order tokens. */
+export declare class Token {
+    private n;
+    constructor(start?: number);
+    next(): Buffer;
+    /** Current value without advancing. */
+    peek(): number;
+}
+/** Build a TCP/2431 message: magic(8) ‖ opcode(2 LE) ‖ ...body parts. */
+export declare function msg(magic: Buffer, opcode: number, ...parts: Buffer[]): Buffer;
+/** Find a Stick_3A / LSAG_ALL message of `opcode` and at least `minLen`
+ *  bytes inside the accumulating receive buffer. Returns the slice or null. */
+export declare function findMsg(rxBuf: Buffer, opcode: number, minLen: number): Buffer | null;
+/** Poll a predicate every 20ms until it returns non-null or `timeoutMs`
+ *  elapses. Returns the value or null on timeout. */
+export declare function waitFor<T>(predicate: () => T | null, timeoutMs: number): Promise<T | null>;
+export declare const sleep: (ms: number) => Promise<void>;
+//# sourceMappingURL=protocol.d.ts.map

package/dist/stick/protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../../src/stick/protocol.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,eAAO,MAAM,QAAQ,OAAO,CAAC;AAC7B,eAAO,MAAM,YAAY,OAAO,CAAC;AACjC,eAAO,MAAM,YAAY,OAAO,CAAC;AAEjC,eAAO,MAAM,KAAK,qBAA0B,CAAC;AAC7C,eAAO,MAAM,IAAI,qBAA0B,CAAC;AAI5C,eAAO,MAAM,EAAE,qBAAyD,CAAC;AAKzE,eAAO,MAAM,QAAQ,qBAAuD,CAAC;AAM7E,eAAO,MAAM,UAAU,qBAItB,CAAC;AAEF;qDACqD;AACrD,qBAAa,KAAK;IAChB,OAAO,CAAC,CAAC,CAAS;gBACN,KAAK,SAAO;IACxB,IAAI,IAAI,MAAM;IAKd,uCAAuC;IACvC,IAAI,IAAI,MAAM;CACf;AAED,yEAAyE;AACzE,wBAAgB,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAI7E;AAED;+EAC+E;AAC/E,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CASpF;AAED;qDACqD;AACrD,wBAAgB,OAAO,CAAC,CAAC,EACvB,SAAS,EAAE,MAAM,CAAC,GAAG,IAAI,EACzB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAWnB;AAED,eAAO,MAAM,KAAK,GAAI,IAAI,MAAM,KAAG,OAAO,CAAC,IAAI,CACR,CAAC"}

package/dist/stick/protocol.js

@@ -0,0 +1,78 @@
+// Wire-protocol constants + low-level helpers for the Stick-DE3 control
+// channel (TCP/2431) and the encrypted DMX stream (UDP/2431).
+//
+// Ported verbatim from tools/send_dmx.mjs (which is now frozen as the
+// reference implementation). All offsets / magic / opcodes here have been
+// reverse-engineered from the 2024-03-21 ESA2 HardwareManager binary; see
+// the [[stick-cipher-is-stream-not-aes]] memory note for the full RE trail.
+import { Buffer } from 'node:buffer';
+export const TCP_PORT = 2431;
+export const UDP_DST_PORT = 2431;
+export const UDP_SRC_PORT = 2430;
+export const MAGIC = Buffer.from('Stick_3A');
+export const LSAG = Buffer.from('LSAG_ALL');
+// 16-byte fixed plaintext header that every DMX frame starts with. Confirmed
+// constant across ≥2 independent sessions. Recovered from decrypted frames.
+export const P0 = Buffer.from('5b4e99da9685ad976c432b0a7ff9ffcc', 'hex');
+// HMAC-SHA256 key for the 0x48 TCP-auth handshake.
+//   = "#h.6xcKsGD{y}-z" (15 bytes), runtime-extracted from HardwareManager
+//     and verified against a captured 0x48 message.
+export const AUTH_KEY = Buffer.from('23682e3678634b7347447b797d2d7a', 'hex');
+// The Stick's static 0x0F pubkey. Constant across every observed session
+// (it's the "Q" the device claims as ephemeral but never actually rotates
+// in practice). Used as a fallback if the live 0x0F reply can't be parsed.
+// 64-byte little-endian wire form.
+export const Q_FALLBACK = Buffer.from('87ef58c2660c272b54a74bbc94cb8518108e370b7eed78456bd8d120c6b9ac0a' +
+    'd791e4ce698aea761679f4b92a3ecf2acd12bf9bc308ce0ba8cb96630871105e', 'hex');
+/** A monotonic 4-byte LE counter shared between TCP messages and UDP frame
+ *  fieldA. The Stick rejects out-of-order tokens. */
+export class Token {
+    n;
+    constructor(start = 0x80) { this.n = start; }
+    next() {
+        const b = Buffer.alloc(8);
+        b.writeUInt32LE(this.n++, 0);
+        return b;
+    }
+    /** Current value without advancing. */
+    peek() { return this.n; }
+}
+/** Build a TCP/2431 message: magic(8) ‖ opcode(2 LE) ‖ ...body parts. */
+export function msg(magic, opcode, ...parts) {
+    const op = Buffer.alloc(2);
+    op.writeUInt16LE(opcode, 0);
+    return Buffer.concat([magic, op, ...parts]);
+}
+/** Find a Stick_3A / LSAG_ALL message of `opcode` and at least `minLen`
+ *  bytes inside the accumulating receive buffer. Returns the slice or null. */
+export function findMsg(rxBuf, opcode, minLen) {
+    for (let o = 0; o + 10 <= rxBuf.length; o++) {
+        const head = rxBuf.subarray(o, o + 8);
+        if (!head.equals(MAGIC) && !head.equals(LSAG))
+            continue;
+        if (rxBuf.readUInt16LE(o + 8) !== opcode)
+            continue;
+        if (rxBuf.length < o + minLen)
+            continue;
+        return rxBuf.subarray(o, o + minLen);
+    }
+    return null;
+}
+/** Poll a predicate every 20ms until it returns non-null or `timeoutMs`
+ *  elapses. Returns the value or null on timeout. */
+export function waitFor(predicate, timeoutMs) {
+    return new Promise((resolve) => {
+        const deadline = Date.now() + timeoutMs;
+        const tick = () => {
+            const r = predicate();
+            if (r != null)
+                return resolve(r);
+            if (Date.now() > deadline)
+                return resolve(null);
+            setTimeout(tick, 20);
+        };
+        tick();
+    });
+}
+export const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
+//# sourceMappingURL=protocol.js.map

package/dist/stick/protocol.js.map

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

package/dist/stick/session.d.ts

@@ -0,0 +1,50 @@
+import dgram from 'node:dgram';
+export interface SessionOpts {
+    /** TCP/2431 control-channel target. */
+    port?: number;
+    /** Inter-message gap during handshake chatter (ms). Default 10. */
+    chatterMs?: number;
+    /** Settle after 0x2e enter-live before 0x10/0x11 (ms). Default 50. */
+    settle2eMs?: number;
+    /** Number of 0x70 sector reads (HWM-UI chatter). Default 0 = skip. */
+    sectors?: number;
+    /** Run HWM-style probe TCP connection before the live one. Default false. */
+    runProbe?: boolean;
+    /** Gap between probe close and go-live open (ms). Default 800. */
+    probeGapMs?: number;
+    /** Initial Token counter value. Default 0x80. */
+    tokenStart?: number;
+    /** Optional logger; default no-op. */
+    log?: (...args: unknown[]) => void;
+    /** Caller-owned UDP socket (bound to UDP_SRC_PORT 2430). When supplied,
+     *  the session uses it for DMX sends + does NOT close it on destroy().
+     *  Used by StickController to avoid the close-then-rebind cycle that
+     *  empirically poisons the Stick into rejecting subsequent sessions
+     *  inside a long-lived plugin process. */
+    udp?: dgram.Socket;
+}
+export declare class StickSession {
+    readonly ip: string;
+    private sock;
+    private udp;
+    /** When true, we own the UDP socket and must close it on destroy(). */
+    private ownsUdp;
+    private key;
+    private token;
+    private rxBuf;
+    private constructor();
+    /** Open the TCP/2431 control channel, run the handshake (auth → pre-DMX
+     *  chatter → ECDH → optional sector reads → go-live), and return a session
+     *  ready for `send()`. */
+    static connect(ip: string, opts?: SessionOpts): Promise<StickSession>;
+    /** Per-frame sequence counter (low byte). */
+    private seqCtr;
+    /** Send one encrypted DMX frame for `universe` (port=0 for A).
+     *  `channels` must be a 512-byte Uint8Array. */
+    send(channels: Uint8Array, universe?: number): void;
+    /** Dirty-close: UDP close + TCP RST. The Stick latches the last DMX values
+     *  it received (cf. memory note `stick-actually-latches-on-clean-disconnect`).
+     *  Idempotent. */
+    destroy(): void;
+}
+//# sourceMappingURL=session.d.ts.map

package/dist/stick/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/stick/session.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,MAAM,YAAY,CAAC;AAmE/B,MAAM,WAAW,WAAW;IAC1B,uCAAuC;IACvC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,mEAAmE;IACnE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sEAAsE;IACtE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,sEAAsE;IACtE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,6EAA6E;IAC7E,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,kEAAkE;IAClE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iDAAiD;IACjD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,sCAAsC;IACtC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;IACnC;;;;8CAI0C;IAC1C,GAAG,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC;CACpB;AAMD,qBAAa,YAAY;aAEL,EAAE,EAAE,MAAM;IAC1B,OAAO,CAAC,IAAI;IACZ,OAAO,CAAC,GAAG;IACX,uEAAuE;IACvE,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,GAAG;IACX,OAAO,CAAC,KAAK;IACb,OAAO,CAAC,KAAK;IARf,OAAO;IAWP;;8BAE0B;WACb,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,GAAE,WAAgB,GAAG,OAAO,CAAC,YAAY,CAAC;IAyJ/E,6CAA6C;IAC7C,OAAO,CAAC,MAAM,CAAK;IAEnB;oDACgD;IAChD,IAAI,CAAC,QAAQ,EAAE,UAAU,EAAE,QAAQ,SAAI,GAAG,IAAI;IAW9C;;sBAEkB;IAClB,OAAO,IAAI,IAAI;CAMhB"}

package/dist/stick/session.js

@@ -0,0 +1,301 @@
+// StickSession — TCP/2431 control channel + UDP/2431 encrypted DMX stream.
+//
+// Lifecycle:
+//   const session = await StickSession.connect(ip);
+//   session.send(channels, universe);     // one DMX frame
+//   // ...repeat at 25 Hz...
+//   session.destroy();                     // RST → Stick latches last values
+//
+// Ported from tools/send_dmx.mjs (frozen reference). Every env-var knob that
+// existed in the .mjs is now a SessionOpts field with the same default; the
+// env var remains as fallback so the CLI keeps its existing tuning behaviour.
+import net from 'node:net';
+import dgram from 'node:dgram';
+import crypto from 'node:crypto';
+import { Buffer } from 'node:buffer';
+import { AUTH_KEY, LSAG, MAGIC, Q_FALLBACK, TCP_PORT, Token, UDP_DST_PORT, UDP_SRC_PORT, findMsg, msg, sleep, waitFor, } from './protocol.js';
+// HWM-faithful UDP broadcasts. 4 magics × 3 bursts on UDP/2430, plus a
+// "LIGHTINGSOFT_XHL Hardware Manager" announce on UDP/24299. Verified
+// 2026-05-24: not optional — without them, sessions after a Stick
+// power-cycle silently fail to actually drive output even though the
+// TCP handshake reports go-live success.
+const DISCOVERY_MAGICS = ['LSAG_ALL', 'Stick_U1', 'Stick_3A', 'Siudi_7B'];
+const DISCOVERY_TAIL = Buffer.from('000014000000', 'hex');
+async function discoveryBroadcast(udp) {
+    for (let burst = 0; burst < 3; burst++) {
+        for (const m of DISCOVERY_MAGICS) {
+            const pkt = Buffer.concat([Buffer.from(m, 'ascii'), DISCOVERY_TAIL]);
+            await new Promise((r) => udp.send(pkt, 2430, '255.255.255.255', () => r()));
+        }
+        await sleep(25);
+    }
+}
+const XHL_HEADER = Buffer.from('4c49474854494e47534f46545f58484c' +
+    '0000000000000000' +
+    '14000000' +
+    '01000000', 'hex');
+async function announceHardwareManager(udp24299, instanceId) {
+    const body114 = Buffer.alloc(114 - 32);
+    instanceId.copy(body114, 0);
+    body114.writeUInt32LE(crypto.randomBytes(4).readUInt32LE(0), 8);
+    body114.writeUInt32LE(11, 12);
+    body114.write('Hardware Manager\0', 18, 'ascii');
+    const pkt114 = Buffer.concat([XHL_HEADER, body114]);
+    await new Promise((r) => udp24299.send(pkt114, 24299, '255.255.255.255', () => r()));
+    await sleep(25);
+    for (let i = 0; i < 2; i++) {
+        const tail = Buffer.concat([crypto.randomBytes(4), Buffer.from([0x0a + i * 2, 0])]);
+        const pkt46 = Buffer.concat([XHL_HEADER, instanceId, tail]);
+        await new Promise((r) => udp24299.send(pkt46, 24299, '255.255.255.255', () => r()));
+        await sleep(25);
+    }
+}
+import { deriveDmxKey, makeEphemeral, pointToWire, wireToPoint } from './kdf.js';
+import { buildFrame } from './frame.js';
+const env = (k) => process.env[k];
+const envNum = (k, fallback) => env(k) != null ? Number(env(k)) : fallback;
+export class StickSession {
+    ip;
+    sock;
+    udp;
+    ownsUdp;
+    key;
+    token;
+    rxBuf;
+    constructor(ip, sock, udp, 
+    /** When true, we own the UDP socket and must close it on destroy(). */
+    ownsUdp, key, token, rxBuf) {
+        this.ip = ip;
+        this.sock = sock;
+        this.udp = udp;
+        this.ownsUdp = ownsUdp;
+        this.key = key;
+        this.token = token;
+        this.rxBuf = rxBuf;
+    }
+    /** Open the TCP/2431 control channel, run the handshake (auth → pre-DMX
+     *  chatter → ECDH → optional sector reads → go-live), and return a session
+     *  ready for `send()`. */
+    static async connect(ip, opts = {}) {
+        const resolved = {
+            port: opts.port ?? TCP_PORT,
+            chatterMs: opts.chatterMs ?? envNum('CHATTER_MS', 10),
+            settle2eMs: opts.settle2eMs ?? envNum('SETTLE_2E_MS', 50),
+            sectors: opts.sectors ?? envNum('SECTORS', 0),
+            runProbe: opts.runProbe ?? env('RUN_PROBE') === '1',
+            probeGapMs: opts.probeGapMs ?? envNum('PROBE_GAP_MS', 800),
+            tokenStart: opts.tokenStart ?? 0x80,
+            log: opts.log ?? (() => undefined),
+        };
+        const log = resolved.log;
+        const token = new Token(resolved.tokenStart);
+        // UDP socket for the DMX stream + the HWM-faithful broadcasts. If the
+        // caller (the controller, when running in a long-lived plugin process)
+        // owns one, we reuse it; otherwise we create one for this session and
+        // close it on destroy(). See the comment on SessionOpts.udp.
+        let udp;
+        let ownsUdp = false;
+        if (opts.udp) {
+            udp = opts.udp;
+        }
+        else {
+            ownsUdp = true;
+            udp = dgram.createSocket({ type: 'udp4', reuseAddr: true });
+            await new Promise((res, rej) => {
+                udp.once('error', rej);
+                udp.bind(UDP_SRC_PORT, () => { udp.setBroadcast(true); res(); });
+            });
+        }
+        await discoveryBroadcast(udp);
+        const udp24299 = dgram.createSocket('udp4');
+        try {
+            await new Promise((res, rej) => {
+                udp24299.once('error', rej);
+                udp24299.bind(24299, () => { udp24299.setBroadcast(true); res(); });
+            });
+            const instanceId = crypto.randomBytes(8);
+            await announceHardwareManager(udp24299, instanceId);
+        }
+        finally {
+            udp24299.close();
+        }
+        await sleep(200);
+        if (resolved.runProbe) {
+            const probe = await openTcp(ip, resolved.port);
+            try {
+                const probeBuf = { v: Buffer.alloc(0) };
+                probe.on('data', (d) => { probeBuf.v = Buffer.concat([probeBuf.v, d]); });
+                await doAuth(probe, () => probeBuf.v, token, '[probe]', log);
+                // 0x00 → 0xc9 status registration
+                probe.write(msg(MAGIC, 0x00, Buffer.from('14000000', 'hex')));
+                await waitFor(() => findMsg(probeBuf.v, 0x00c9, 18), 1500);
+                // 0x011c — we know this is just AES-encrypted device-info; discard reply
+                probe.write(msg(MAGIC, 0x011c, token.next(), Buffer.from('01001600', 'hex')));
+                await waitFor(() => findMsg(probeBuf.v, 0x011c, 22), 2000);
+                // 0x007b — license query
+                probe.write(msg(MAGIC, 0x007b, token.next()));
+                await waitFor(() => findMsg(probeBuf.v, 0x007b, 22), 1500);
+                await sleep(150);
+            }
+            finally {
+                await new Promise((res) => probe.end(() => res()));
+            }
+            await sleep(resolved.probeGapMs);
+        }
+        const sock = await openTcp(ip, resolved.port);
+        const rxBuf = { v: Buffer.alloc(0) };
+        sock.on('data', (d) => { rxBuf.v = Buffer.concat([rxBuf.v, d]); });
+        await doAuth(sock, () => rxBuf.v, token, '[live]', log);
+        // Pre-DMX chatter — match send_dmx.mjs EXACTLY (which is empirically
+        // known to work multi-session from fresh processes). Earlier attempt
+        // to wait explicitly for 0xc9 in the middle may have been wrong.
+        for (const m of [
+            msg(MAGIC, 0x46, Buffer.alloc(4)),
+            msg(MAGIC, 0x09, Buffer.from('14000000', 'hex')),
+            msg(MAGIC, 0x09, Buffer.from('14000000', 'hex')),
+            msg(MAGIC, 0x00, Buffer.from('14000000', 'hex')),
+            msg(MAGIC, 0x011c, token.next(), Buffer.from('01001600', 'hex')),
+            msg(MAGIC, 0x05, Buffer.from('0200', 'hex')),
+        ]) {
+            sock.write(m);
+            await sleep(resolved.chatterMs);
+        }
+        if (findMsg(rxBuf.v, 0x00c9, 18))
+            log('0xc9 status received — session registered');
+        // 0x10 — crypto-state query
+        rxBuf.v = Buffer.alloc(0);
+        sock.write(msg(MAGIC, 0x10, token.next()));
+        const r10 = await waitFor(() => findMsg(rxBuf.v, 0x10, 22), 2000);
+        if (r10)
+            log(`0x10 crypto state: ${r10.readUInt32LE(0x12)}`);
+        rxBuf.v = Buffer.alloc(0);
+        // 0x0F — ECDH pubkey exchange
+        const ecdh = makeEphemeral();
+        const ourP256 = pointToWire(ecdh.getPublicKey(null, 'uncompressed'));
+        sock.write(msg(MAGIC, 0x0f, token.next(), ourP256));
+        const r0f = await waitFor(() => findMsg(rxBuf.v, 0x0f, 86), 3000);
+        let Qwire = Q_FALLBACK;
+        if (r0f != null) {
+            Qwire = r0f.subarray(0x16, 0x56);
+            log('0x0F ok — got Stick DMX pubkey');
+        }
+        else {
+            log('0x0F — no reply, using static Stick key');
+        }
+        const key = deriveDmxKey(ecdh, wireToPoint(Qwire));
+        log(`DMX key derived: ${key.toString('hex')}`);
+        // 6b. device sync — replicated byte-for-byte against a captured HWM session
+        sock.write(msg(MAGIC, 0x10, token.next()));
+        await sleep(resolved.chatterMs);
+        sock.write(msg(MAGIC, 0x75, token.next()));
+        await sleep(resolved.chatterMs);
+        sock.write(msg(MAGIC, 0x74, token.next()));
+        await sleep(resolved.chatterMs);
+        for (const p of ['0200000000', '0100000000', '0100000000', '02b37f0000']) {
+            sock.write(msg(MAGIC, 0x71, token.next(), Buffer.from(p, 'hex')));
+            await sleep(resolved.chatterMs);
+        }
+        // 0x70 sector reads — HWM commissioning-UI chatter; user-confirmed not
+        // required for go-live. Default 0; set SECTORS=N or sectors:N to include.
+        if (resolved.sectors > 0) {
+            const full = [0];
+            for (let s = 63; s <= 185; s++)
+                full.push(s);
+            const list = full.slice(0, resolved.sectors);
+            log(`0x70 device download (${list.length} sectors)`);
+            for (let i = 0; i < list.length; i++) {
+                const body = Buffer.alloc(5);
+                body.writeUInt32LE(list[i], 0);
+                body[4] = 1;
+                sock.write(msg(MAGIC, 0x70, token.next(), body));
+                await sleep(12);
+                if ((i & 0x1f) === 0x1f)
+                    rxBuf.v = Buffer.alloc(0);
+            }
+            await sleep(200);
+        }
+        rxBuf.v = Buffer.alloc(0);
+        // Enter live mode: 0x2e, settle, 0x10/0x11/0x10
+        sock.write(msg(MAGIC, 0x2e, Buffer.alloc(32)));
+        await sleep(resolved.chatterMs);
+        await sleep(resolved.settle2eMs);
+        sock.write(msg(MAGIC, 0x10, token.next()));
+        await sleep(resolved.chatterMs);
+        sock.write(msg(MAGIC, 0x11, token.next()));
+        const r11 = await waitFor(() => findMsg(rxBuf.v, 0x11, 22), 3000);
+        log(r11 ? 'live mode enabled (0x11 ok)' : '0x11 — no reply');
+        sock.write(msg(MAGIC, 0x10, token.next()));
+        const r10b = await waitFor(() => findMsg(rxBuf.v, 0x10, 22), 1500);
+        if (r10b)
+            log(`0x10 after 0x11 — crypto state ${r10b.readUInt32LE(0x12)}`);
+        return new StickSession(ip, sock, udp, ownsUdp, key, token, rxBuf.v);
+    }
+    /** Per-frame sequence counter (low byte). */
+    seqCtr = 0;
+    /** Send one encrypted DMX frame for `universe` (port=0 for A).
+     *  `channels` must be a 512-byte Uint8Array. */
+    send(channels, universe = 0) {
+        const frame = buildFrame({
+            key: this.key,
+            channels,
+            port: universe,
+            fieldA: this.token.next(),
+            seq: this.seqCtr++,
+        });
+        this.udp.send(frame, UDP_DST_PORT, this.ip, () => { });
+    }
+    /** Dirty-close: UDP close + TCP RST. The Stick latches the last DMX values
+     *  it received (cf. memory note `stick-actually-latches-on-clean-disconnect`).
+     *  Idempotent. */
+    destroy() {
+        if (this.ownsUdp) {
+            try {
+                this.udp.close();
+            }
+            catch { /* already closed */ }
+        }
+        try {
+            this.sock.destroy();
+        }
+        catch { /* already destroyed */ }
+    }
+}
+// ── internals ──────────────────────────────────────────────────────────────
+function openTcp(ip, port) {
+    return new Promise((res, rej) => {
+        const s = net.createConnection({ host: ip, port });
+        s.setTimeout(5000);
+        s.once('connect', () => { s.setTimeout(0); res(s); });
+        s.once('error', rej);
+        s.once('timeout', () => rej(new Error(`no response from ${ip}:${port}`)));
+    });
+}
+async function doAuth(sock, getBuf, token, tag, log) {
+    // 0x47 — LSAG_ALL hello; Stick replies with its 32-byte handshake key
+    sock.write(msg(LSAG, 0x47, token.next()));
+    const r47 = await waitFor(() => findMsg(getBuf(), 0x47, 54), 3000);
+    let stickKey = Buffer.alloc(32);
+    if (r47 != null) {
+        stickKey = Buffer.from(r47.subarray(0x16, 0x36));
+        log(`${tag} 0x47 ok`);
+    }
+    else {
+        log(`${tag} 0x47 — no reply`);
+    }
+    // 0x48 — authenticated handshake (HMAC-SHA256 of the 82-byte head)
+    const software = Buffer.alloc(32);
+    software.write('software');
+    const head48 = msg(LSAG, 0x48, token.next(), software, stickKey);
+    const mac48 = crypto.createHmac('sha256', AUTH_KEY).update(head48).digest();
+    sock.write(Buffer.concat([head48, mac48]));
+    const r48 = await waitFor(() => findMsg(getBuf(), 0x48, 22), 2000);
+    if (r48) {
+        const st = r48.readUInt32LE(0x12);
+        log(`${tag} 0x48 auth status: ${st}${st === 0 ? ' (ok)' : ' (REJECTED)'}`);
+    }
+    else {
+        log(`${tag} 0x48 — no reply`);
+    }
+    return stickKey;
+}
+//# sourceMappingURL=session.js.map

package/dist/stick/session.js.map

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

package/examples/dmx.yaml

@@ -0,0 +1,65 @@
+# Example homebridge-dmx config.
+#
+# Save this to e.g. /opt/containers/homebridge/dmx.yaml (path visible inside
+# the container as /homebridge/dmx.yaml) and reference it from Homebridge's
+# config.json with:
+#
+#   "platforms": [{
+#     "platform": "DMX",
+#     "yamlPath": "/homebridge/dmx.yaml"
+#   }]
+
+controllers:
+  # One entry per physical DMX controller. Currently only StickDE3 is
+  # supported; the abstraction is here so other controller types can be
+  # added later without rewriting your patch.
+  - id: main
+    type: StickDE3
+    ip: 192.168.96.2
+
+profiles:
+  # Fixture types. Each profile names a color model + the order its DMX
+  # channels appear in. "(Fine)" makes a channel the low byte of a 16-bit
+  # companion to the preceding channel. CCT channels carry their K range.
+  - name: WAC
+    colormodel: hsvcct
+    channel_order:
+      - Intensity
+      - Intensity (Fine)
+      - ColorTemp 1650-8000
+      - Saturation
+      - Hue
+
+  - name: CustomRGB
+    colormodel: rgb
+    channel_order:
+      - Blue
+      - Green
+      - Red
+
+  - name: Dimmer
+    colormodel: dimmer
+    channel_order:
+      - Intensity
+
+patch:
+  # One entry per physical fixture. `controller` is optional when only one
+  # controller is configured. `universe` defaults to A.
+  - id: a_down
+    name: A Down
+    type: WAC
+    controller: main
+    universe: A
+    start: 6
+
+  - id: post_light
+    name: Post Light
+    type: CustomRGB
+    controller: main
+    start: 100
+
+  - id: shed_dimmer
+    name: Shed Dimmer
+    type: Dimmer
+    controller: main
+    start: 200

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@ecopoesis/homebridge-dmx",
+  "displayName": "DMX",
+  "version": "0.1.0",
+  "description": "Homebridge platform for DMX controllers (currently Nicolaudie Stick-DE3)",
+  "license": "Apache-2.0",
+  "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ecopoesis/homebridge-dmx.git"
+  },
+  "engines": {
+    "node": ">=18.15.0",
+    "homebridge": ">=1.5.0"
+  },
+  "main": "dist/index.js",
+  "scripts": {
+    "build": "rimraf ./dist && tsc",
+    "watch": "npm run build && npm link && nodemon",
+    "stick": "npm run build && node dist/cli/stick.js"
+  },
+  "keywords": [
+    "homebridge-plugin",
+    "dmx",
+    "nicolaudie",
+    "stick-de3",
+    "wac"
+  ],
+  "devDependencies": {
+    "@types/node": "^18.0.0",
+    "homebridge": "^1.5.0",
+    "rimraf": "^3.0.2",
+    "typescript": "^5.0.0",
+    "@types/js-yaml": "^4.0.9"
+  },
+  "types": "./dist/index.d.ts",
+  "author": {
+    "name": "Mike Roberts",
+    "email": "miker@miker.org",
+    "url": "https://github.com/ecopoesis"
+  },
+  "dependencies": {
+    "js-yaml": "^4.1.1"
+  },
+  "bin": {
+    "stick": "dist/cli/stick.js"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}