@ecopoesis/homebridge-dmx 0.2.0 → 0.4.0

package/dist/zoneAccessory.d.ts

@@ -1,14 +1,30 @@
 import type { PlatformAccessory } from 'homebridge';
-import { Zone } from './config.js';
+import { Fixture, Zone } from './config.js';
 import { StickController } from './controller.js';
 import type { DmxPlatform } from './platform.js';
+import { StateRegistry } from './stateRegistry.js';
 export declare class ZoneFixture {
     private readonly platform;
     private readonly zone;
     private readonly controllers;
-    private state;
+    private readonly registry;
     private pending;
-    constructor(platform: DmxPlatform, accessory: PlatformAccessory, zone: Zone, controllers: Map<string, StickController>);
-    private schedule;
+    private refreshPending;
+    private bulb;
+    constructor(platform: DmxPlatform, accessory: PlatformAccessory, zone: Zone, controllers: Map<string, StickController>, registry: StateRegistry);
+    /** Compute majority state across members, per characteristic. */
+    private majorityState;
+    /** A HomeKit set on the zone: build the new state from the current
+     *  majority + the patch the user is applying, write it into every
+     *  member, and trigger the controller after a small debounce so
+     *  multi-characteristic dispatch coalesces. */
+    private applyToMembers;
+    /** Debounced controller dispatch. Sends current registry state for each
+     *  member to the appropriate StickController. */
+    private scheduleDispatch;
+    /** Debounced refresh: when members change, push the new majority to
+     *  the zone's HomeKit characteristics. */
+    private scheduleRefresh;
 }
+export type _MemberRef = Fixture;
 //# sourceMappingURL=zoneAccessory.d.ts.map

package/dist/zoneAccessory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"zoneAccessory.d.ts","sourceRoot":"","sources":["../src/zoneAccessory.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAEV,iBAAiB,EAElB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAEnC,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAGjD,qBAAa,WAAW;IAKpB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAEzB,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,WAAW;IAP9B,OAAO,CAAC,KAAK,CAAqD;IAClE,OAAO,CAAC,OAAO,CAA+B;gBAG3B,QAAQ,EAAE,WAAW,EACtC,SAAS,EAAE,iBAAiB,EACX,IAAI,EAAE,IAAI,EACV,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC;IAkD5D,OAAO,CAAC,QAAQ;CAuBjB"}
+{"version":3,"file":"zoneAccessory.d.ts","sourceRoot":"","sources":["../src/zoneAccessory.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAEV,iBAAiB,EAElB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAE5C,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjD,OAAO,EAAE,aAAa,EAAgB,MAAM,oBAAoB,CAAC;AAEjE,qBAAa,WAAW;IAMpB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAEzB,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAT3B,OAAO,CAAC,OAAO,CAA+B;IAC9C,OAAO,CAAC,cAAc,CAA+B;IACrD,OAAO,CAAC,IAAI,CAAU;gBAGH,QAAQ,EAAE,WAAW,EACtC,SAAS,EAAE,iBAAiB,EACX,IAAI,EAAE,IAAI,EACV,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,EACzC,QAAQ,EAAE,aAAa;IAmD1C,iEAAiE;IACjE,OAAO,CAAC,aAAa;IAWrB;;;mDAG+C;IAC/C,OAAO,CAAC,cAAc;IAWtB;qDACiD;IACjD,OAAO,CAAC,gBAAgB;IAuBxB;8CAC0C;IAC1C,OAAO,CAAC,eAAe;CAqBxB;AAGD,MAAM,MAAM,UAAU,GAAG,OAAO,CAAC"}

package/dist/zoneAccessory.js

@@ -1,83 +1,146 @@
-// ZoneFixture — virtual HomeKit Lightbulb that dispatches to a set of
-// member fixtures. Setting any characteristic of the zone updates the
-// zone's local state, then calls controller.setFixture for each member
-// using the zone's current state. The single controller debounce
-// coalesces all member updates into one subprocess transaction.
+// ZoneFixture — virtual HomeKit Lightbulb that aggregates a set of member
+// fixtures.
 //
-// Per-member HomeKit accessories are NOT updated automatically. The user
-// has accepted this trade-off: last command wins, and partial overrides
-// of group commands are fine.
+// Reads: each .onGet returns the MAJORITY value of that characteristic
+// across the zone's members. Ties are broken in favour of the value held
+// by the alphabetically-first member. This gives a deterministic display
+// even when members are in split states.
+//
+// Writes: each .onSet updates every member's state in the registry (which
+// fires per-member change events so the individual fixture accessories
+// refresh their own HomeKit displays), then triggers the controller for
+// each member so the DMX wire reflects the change.
+//
+// When ANY member's state changes (by any path), the zone's HomeKit
+// characteristics push the new majority — so zones containing overlapping
+// members stay coherent with each other.
 import { CHARACTERISTIC_UPDATE_DELAY_MS } from './settings.js';
+import { pickMajority } from './stateRegistry.js';
 export class ZoneFixture {
     platform;
     zone;
     controllers;
-    state = { on: false, brightness: 100 };
+    registry;
     pending = null;
-    constructor(platform, accessory, zone, controllers) {
+    refreshPending = null;
+    bulb;
+    constructor(platform, accessory, zone, controllers, registry) {
         this.platform = platform;
         this.zone = zone;
         this.controllers = controllers;
+        this.registry = registry;
         const C = platform.Characteristic;
         const info = accessory.getService(platform.Service.AccessoryInformation);
         info?.setCharacteristic(C.Manufacturer, 'DMX')
             ?.setCharacteristic(C.Model, `Zone (${zone.members.length} fixtures)`)
             ?.setCharacteristic(C.SerialNumber, `zone-${zone.id}`);
-        const bulb = accessory.getService(platform.Service.Lightbulb)
-            ?? accessory.addService(platform.Service.Lightbulb, zone.name);
-        bulb.setCharacteristic(C.Name, zone.name);
-        // Always expose On.
-        bulb.getCharacteristic(C.On)
-            .onGet(() => this.state.on)
-            .onSet((v) => { this.state.on = Boolean(v); this.schedule(); });
+        this.bulb =
+            accessory.getService(platform.Service.Lightbulb)
+                ?? accessory.addService(platform.Service.Lightbulb, zone.name);
+        this.bulb.setCharacteristic(C.Name, zone.name);
         const has = (k) => zone.characteristics.includes(k);
+        this.bulb.getCharacteristic(C.On)
+            .onGet(() => this.majorityState().on)
+            .onSet((v) => this.applyToMembers({ on: Boolean(v) }));
         if (has('Brightness')) {
-            bulb.getCharacteristic(C.Brightness)
-                .onGet(() => this.state.brightness)
-                .onSet((v) => {
-                this.state.brightness = Number(v);
-                this.schedule();
-            });
+            this.bulb.getCharacteristic(C.Brightness)
+                .onGet(() => this.majorityState().brightness)
+                .onSet((v) => this.applyToMembers({ brightness: Number(v) }));
         }
         if (has('Hue')) {
-            bulb.getCharacteristic(C.Hue)
-                .onGet(() => this.state.hue ?? 0)
-                .onSet((v) => { this.state.hue = Number(v); this.schedule(); });
+            this.bulb.getCharacteristic(C.Hue)
+                .onGet(() => this.majorityState().hue ?? 0)
+                .onSet((v) => this.applyToMembers({ hue: Number(v) }));
         }
         if (has('Saturation')) {
-            bulb.getCharacteristic(C.Saturation)
-                .onGet(() => this.state.saturation ?? 0)
-                .onSet((v) => { this.state.saturation = Number(v); this.schedule(); });
+            this.bulb.getCharacteristic(C.Saturation)
+                .onGet(() => this.majorityState().saturation ?? 0)
+                .onSet((v) => this.applyToMembers({ saturation: Number(v) }));
         }
         if (has('ColorTemperature')) {
-            bulb.getCharacteristic(C.ColorTemperature)
-                .onGet(() => this.state.colorTemperatureMireds ?? 200)
-                .onSet((v) => {
-                this.state.colorTemperatureMireds = Number(v);
-                this.state.saturation = 0;
-                this.schedule();
-            });
+            this.bulb.getCharacteristic(C.ColorTemperature)
+                .onGet(() => this.majorityState().colorTemperatureMireds ?? 200)
+                .onSet((v) => this.applyToMembers({
+                colorTemperatureMireds: Number(v),
+                saturation: 0,
+            }));
+        }
+        // Refresh on any member change.
+        const memberIds = new Set(zone.members.map((m) => m.id));
+        registry.onChange((id) => {
+            if (memberIds.has(id))
+                this.scheduleRefresh();
+        });
+    }
+    /** Compute majority state across members, per characteristic. */
+    majorityState() {
+        const ss = this.zone.members.map((m) => ({ id: m.id, state: this.registry.get(m.id) }));
+        return {
+            on: pickMajority(ss.map((s) => ({ id: s.id, v: s.state.on }))) ?? false,
+            brightness: pickMajority(ss.map((s) => ({ id: s.id, v: s.state.brightness }))) ?? 100,
+            hue: pickMajority(ss.map((s) => ({ id: s.id, v: s.state.hue }))),
+            saturation: pickMajority(ss.map((s) => ({ id: s.id, v: s.state.saturation }))),
+            colorTemperatureMireds: pickMajority(ss.map((s) => ({ id: s.id, v: s.state.colorTemperatureMireds }))),
+        };
+    }
+    /** A HomeKit set on the zone: build the new state from the current
+     *  majority + the patch the user is applying, write it into every
+     *  member, and trigger the controller after a small debounce so
+     *  multi-characteristic dispatch coalesces. */
+    applyToMembers(patch) {
+        const next = { ...this.majorityState(), ...patch };
+        // Push the next state into every member's registry entry. This fires
+        // per-fixture change events so the individual StickFixture accessories
+        // refresh their own HomeKit displays.
+        for (const m of this.zone.members) {
+            this.registry.update(m.id, next);
         }
+        this.scheduleDispatch();
     }
-    schedule() {
+    /** Debounced controller dispatch. Sends current registry state for each
+     *  member to the appropriate StickController. */
+    scheduleDispatch() {
         if (this.pending)
             clearTimeout(this.pending);
         this.pending = setTimeout(() => {
             this.pending = null;
-            const s = this.state;
+            const s = this.majorityState();
             this.platform.log.info(`[zone:${this.zone.id}] HK set: on=${s.on} br=${s.brightness}` +
                 (s.hue != null ? ` h=${s.hue}` : '') +
                 (s.saturation != null ? ` s=${s.saturation}` : '') +
                 (s.colorTemperatureMireds != null ? ` ct=${s.colorTemperatureMireds}` : '') +
                 ` → ${this.zone.members.length} members`);
-            // Dispatch the zone's state to each member via that member's controller.
             for (const m of this.zone.members) {
                 const c = this.controllers.get(m.controller.id);
                 if (!c) {
                     this.platform.log.error(`zone "${this.zone.id}": no controller for "${m.id}"`);
                     continue;
                 }
-                c.setFixture(m, this.state);
+                c.setFixture(m, this.registry.get(m.id));
+            }
+        }, CHARACTERISTIC_UPDATE_DELAY_MS);
+    }
+    /** Debounced refresh: when members change, push the new majority to
+     *  the zone's HomeKit characteristics. */
+    scheduleRefresh() {
+        if (this.refreshPending)
+            clearTimeout(this.refreshPending);
+        this.refreshPending = setTimeout(() => {
+            this.refreshPending = null;
+            const s = this.majorityState();
+            const C = this.platform.Characteristic;
+            this.bulb.updateCharacteristic(C.On, s.on);
+            if (this.zone.characteristics.includes('Brightness')) {
+                this.bulb.updateCharacteristic(C.Brightness, s.brightness);
+            }
+            if (this.zone.characteristics.includes('Hue') && s.hue != null) {
+                this.bulb.updateCharacteristic(C.Hue, s.hue);
+            }
+            if (this.zone.characteristics.includes('Saturation') && s.saturation != null) {
+                this.bulb.updateCharacteristic(C.Saturation, s.saturation);
+            }
+            if (this.zone.characteristics.includes('ColorTemperature') && s.colorTemperatureMireds != null) {
+                this.bulb.updateCharacteristic(C.ColorTemperature, s.colorTemperatureMireds);
             }
         }, CHARACTERISTIC_UPDATE_DELAY_MS);
     }

package/dist/zoneAccessory.js.map

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

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ecopoesis/homebridge-dmx",
   "displayName": "DMX",
-  "version": "0.2.0",
+  "version": "0.4.0",
   "description": "Homebridge platform for DMX controllers (currently Nicolaudie Stick-DE3)",
   "license": "Apache-2.0",
   "type": "module",

package/src/config.ts

@@ -38,6 +38,7 @@ import path from 'node:path';
 import yaml from 'js-yaml';
 
 import { ChannelDef, ColorModel, HKCharacteristic } from './color/types.js';
+import { REFRESH_MINUTES_DEFAULT } from './settings.js';
 import { getColorModel } from './color/index.js';
 import { parseChannelName } from './color/parsers.js';
 
@@ -45,6 +46,7 @@ export interface ControllerSpec {
   id: string;            // unique handle, referenced from patch entries
   type: string;          // 'StickDE3' (only one supported today)
   ip: string;            // controller's static IP
+  refreshMinutes?: number; // idle keepalive: re-send state every N min (0 = off)
 }
 
 export interface ProfileSpec {
@@ -90,6 +92,7 @@ export interface Controller {
   id: string;
   type: ControllerType;
   ip: string;
+  refreshMinutes: number;
 }
 
 export interface Fixture {
@@ -159,7 +162,13 @@ export function loadConfig(rawJson: RawConfig, cwd?: string): LoadedConfig {
     if (!cs.ip || typeof cs.ip !== 'string') {
       throw new Error(`controller "${cs.id}": required field "ip" missing`);
     }
-    controllersById.set(cs.id, { id: cs.id, type: cs.type as ControllerType, ip: cs.ip });
+    const refreshMinutes = cs.refreshMinutes ?? REFRESH_MINUTES_DEFAULT;
+    if (typeof refreshMinutes !== 'number' || refreshMinutes < 0) {
+      throw new Error(`controller "${cs.id}": refreshMinutes must be a number >= 0 (0 disables)`);
+    }
+    controllersById.set(cs.id, {
+      id: cs.id, type: cs.type as ControllerType, ip: cs.ip, refreshMinutes,
+    });
   }
 
   // Profiles

package/src/controller.ts

@@ -15,7 +15,7 @@ import path from 'node:path';
 
 import { Fixture } from './config.js';
 import { HomeKitLightState } from './color/types.js';
-import { DEBOUNCE_MS } from './settings.js';
+import { DEBOUNCE_MS, REFRESH_CHECK_MS } from './settings.js';
 import { sleep } from './stick/protocol.js';
 
 const __filename = fileURLToPath(import.meta.url);
@@ -26,7 +26,9 @@ const SEND_DMX_PATH = path.resolve(__dirname, '..', 'tools', 'send_dmx.mjs');
 export class StickController {
   private targets = new Map<number, Uint8Array>();
   private lastChangeAt = 0;
+  private lastTxEndAt = 0;
   private streaming = false;
+  private refreshTimer?: NodeJS.Timeout;
   /** Tracks whether the very first subprocess in this controller's
    *  lifetime should set RUN_PROBE=1. After a Stick power-cycle (which
    *  we can't detect in-band) the probe is required to (re-)register
@@ -37,7 +39,31 @@ export class StickController {
     private readonly ip: string,
     private readonly log: Logger,
     private readonly debounceMs: number = DEBOUNCE_MS,
-  ) {}
+    private readonly refreshMs: number = 0,
+  ) {
+    if (refreshMs > 0) {
+      this.refreshTimer = setInterval(() => this.maybeRefresh(), REFRESH_CHECK_MS);
+      this.refreshTimer.unref?.();
+    }
+  }
+
+  /** Idle keepalive: the Stick wedges (sessions succeed, output dark) after
+   *  hours without traffic. Re-send the current universe state whenever the
+   *  controller has been idle for refreshMs. Also re-asserts state after an
+   *  out-of-band power-cycle of the Stick. */
+  private maybeRefresh(): void {
+    if (this.streaming || this.targets.size === 0) return;
+    const idleMs = Date.now() - Math.max(this.lastTxEndAt, this.lastChangeAt);
+    if (idleMs < this.refreshMs) return;
+    this.log.info(`keepalive refresh after ${Math.round(idleMs / 60_000)}m idle`);
+    this.needsProbe = true; // the Stick may have power-cycled while we were idle
+    this.streaming = true;
+    this.run().catch((e) => {
+      this.log.error('keepalive refresh crashed:', (e as Error).message);
+    }).finally(() => {
+      this.streaming = false;
+    });
+  }
 
   /** Stage a fixture's bytes into the universe target buffer and ensure
    *  the streaming loop is running. */
@@ -67,7 +93,9 @@ export class StickController {
   }
 
   /** Build the CLI args from current targets. Only non-zero channels are
-   *  passed — send_dmx initialises the universe to 0 so omission == 0. */
+   *  passed — send_dmx initialises the universe to 0 so omission == 0.
+   *  When everything is 0 (all lights off), send an explicit zero so
+   *  send_dmx still has at least one assignment to transact. */
   private buildArgs(): string[] {
     const args: string[] = [SEND_DMX_PATH, this.ip];
     for (const [u, arr] of this.targets) {
@@ -75,6 +103,10 @@ export class StickController {
         if (arr[i] !== 0) args.push(`${u},${i + 1}=${arr[i]}`);
       }
     }
+    if (args.length === 2 && this.targets.size > 0) {
+      const firstU = this.targets.keys().next().value as number;
+      args.push(`${firstU},1=0`);
+    }
     return args;
   }
 
@@ -115,6 +147,7 @@ export class StickController {
         });
       });
       const elapsedMs = Date.now() - startedAt;
+      this.lastTxEndAt = Date.now();
 
       if (exitCode === 0) {
         this.needsProbe = false;
@@ -129,8 +162,9 @@ export class StickController {
     }
   }
 
-  /** Shutdown hook. Subprocess approach has no long-lived state. */
+  /** Shutdown hook. Stop the keepalive timer; the subprocess approach has
+   *  no other long-lived state. */
   shutdown(): void {
-    /* no-op */
+    if (this.refreshTimer) clearInterval(this.refreshTimer);
   }
 }

package/src/platform.ts

@@ -17,8 +17,9 @@ import type {
 import { Controller, LoadedConfig, loadConfig, RawConfig } from './config.js';
 import { StickController } from './controller.js';
 import { StickFixture } from './platformAccessory.js';
+import { StateRegistry } from './stateRegistry.js';
 import { ZoneFixture } from './zoneAccessory.js';
-import { PLATFORM_NAME, PLUGIN_NAME } from './settings.js';
+import { DEBOUNCE_MS, PLATFORM_NAME, PLUGIN_NAME } from './settings.js';
 
 export class DmxPlatform implements DynamicPlatformPlugin {
   public readonly Service: typeof Service;
@@ -27,6 +28,7 @@ export class DmxPlatform implements DynamicPlatformPlugin {
 
   private cfg: LoadedConfig | null = null;
   private controllers = new Map<string, StickController>();
+  private registry = new StateRegistry();
 
   constructor(
     public readonly log: Logger,
@@ -66,7 +68,7 @@ export class DmxPlatform implements DynamicPlatformPlugin {
   private makeController(c: Controller): StickController {
     switch (c.type) {
       case 'StickDE3':
-        return new StickController(c.ip, this.log);
+        return new StickController(c.ip, this.log, DEBOUNCE_MS, c.refreshMinutes * 60_000);
       default:
         throw new Error(`unsupported controller type "${(c as Controller).type}"`);
     }
@@ -96,12 +98,12 @@ export class DmxPlatform implements DynamicPlatformPlugin {
       if (existing) {
         this.log.debug(`wiring cached accessory ${fx.id}`);
         existing.context.fixture = { id: fx.id, controllerId: fx.controller.id };
-        new StickFixture(this, existing, fx, controller);
+        new StickFixture(this, existing, fx, controller, this.registry);
       } else {
         this.log.info(`registering new accessory: ${fx.name} (${fx.id})`);
         const accessory = new this.api.platformAccessory(fx.name, uuid);
         accessory.context.fixture = { id: fx.id, controllerId: fx.controller.id };
-        new StickFixture(this, accessory, fx, controller);
+        new StickFixture(this, accessory, fx, controller, this.registry);
         this.api.registerPlatformAccessories(PLUGIN_NAME, PLATFORM_NAME, [accessory]);
         this.accessories.push(accessory);
       }
@@ -115,12 +117,12 @@ export class DmxPlatform implements DynamicPlatformPlugin {
       if (existing) {
         this.log.debug(`wiring cached zone ${zone.id}`);
         existing.context.zone = { id: zone.id };
-        new ZoneFixture(this, existing, zone, this.controllers);
+        new ZoneFixture(this, existing, zone, this.controllers, this.registry);
       } else {
         this.log.info(`registering new zone: ${zone.name} (${zone.id}, ${zone.members.length} members)`);
         const accessory = new this.api.platformAccessory(zone.name, uuid);
         accessory.context.zone = { id: zone.id };
-        new ZoneFixture(this, accessory, zone, this.controllers);
+        new ZoneFixture(this, accessory, zone, this.controllers, this.registry);
         this.api.registerPlatformAccessories(PLUGIN_NAME, PLATFORM_NAME, [accessory]);
         this.accessories.push(accessory);
       }

package/src/platformAccessory.ts

@@ -1,4 +1,8 @@
 // StickFixture — one HomeKit Lightbulb accessory per patched fixture.
+//
+// State is owned by the platform-wide StateRegistry. We read on .onGet,
+// write on .onSet, and subscribe to changes so the HomeKit-displayed
+// values track the registry (e.g. when a zone updates this fixture).
 
 import type {
   CharacteristicValue,
@@ -11,20 +15,18 @@ import { HomeKitLightState } from './color/types.js';
 import { StickController } from './controller.js';
 import type { DmxPlatform } from './platform.js';
 import { CHARACTERISTIC_UPDATE_DELAY_MS } from './settings.js';
+import { StateRegistry } from './stateRegistry.js';
 
 export class StickFixture {
-  /** Current HomeKit state we'll send to the Stick on the next push. */
-  private state: HomeKitLightState = { on: false, brightness: 100 };
-
-  /** Debounce timer for HomeKit's multi-characteristic dispatch
-   *  (Hue/Saturation/Brightness arrive as 3 separate set calls). */
   private pending: NodeJS.Timeout | null = null;
+  private bulb: Service;
 
   constructor(
     private readonly platform: DmxPlatform,
     private readonly accessory: PlatformAccessory,
     private readonly fixture: Fixture,
     private readonly controller: StickController,
+    private readonly registry: StateRegistry,
   ) {
     const C = platform.Characteristic;
     const info = accessory.getService(platform.Service.AccessoryInformation);
@@ -32,71 +34,91 @@ export class StickFixture {
         ?.setCharacteristic(C.Model, fixture.profile.name)
         ?.setCharacteristic(C.SerialNumber, fixture.id);
 
-    const bulb: Service =
+    this.bulb =
       accessory.getService(platform.Service.Lightbulb)
       ?? accessory.addService(platform.Service.Lightbulb, fixture.name);
 
-    bulb.setCharacteristic(C.Name, fixture.name);
+    this.bulb.setCharacteristic(C.Name, fixture.name);
 
     const chars = fixture.profile.model.characteristics;
 
-    bulb.getCharacteristic(C.On)
-      .onGet(() => this.state.on)
-      .onSet((v) => { this.state.on = Boolean(v); this.schedule(); });
+    this.bulb.getCharacteristic(C.On)
+      .onGet(() => registry.get(fixture.id).on)
+      .onSet((v) => {
+        registry.update(fixture.id, { on: Boolean(v) });
+        this.schedule();
+      });
 
     if (chars.includes('Brightness')) {
-      bulb.getCharacteristic(C.Brightness)
-        .onGet(() => this.state.brightness)
+      this.bulb.getCharacteristic(C.Brightness)
+        .onGet(() => registry.get(fixture.id).brightness)
         .onSet((v: CharacteristicValue) => {
-          this.state.brightness = Number(v);
+          registry.update(fixture.id, { brightness: Number(v) });
           this.schedule();
         });
     }
-
     if (chars.includes('Hue')) {
-      bulb.getCharacteristic(C.Hue)
-        .onGet(() => this.state.hue ?? 0)
+      this.bulb.getCharacteristic(C.Hue)
+        .onGet(() => registry.get(fixture.id).hue ?? 0)
         .onSet((v) => {
-          this.state.hue = Number(v);
-          // setting hue implies color mode (sat>0); leave saturation as-is
+          registry.update(fixture.id, { hue: Number(v) });
           this.schedule();
         });
     }
-
     if (chars.includes('Saturation')) {
-      bulb.getCharacteristic(C.Saturation)
-        .onGet(() => this.state.saturation ?? 0)
+      this.bulb.getCharacteristic(C.Saturation)
+        .onGet(() => registry.get(fixture.id).saturation ?? 0)
         .onSet((v) => {
-          this.state.saturation = Number(v);
+          registry.update(fixture.id, { saturation: Number(v) });
           this.schedule();
         });
     }
-
     if (chars.includes('ColorTemperature')) {
-      bulb.getCharacteristic(C.ColorTemperature)
-        .onGet(() => this.state.colorTemperatureMireds ?? 200)
+      this.bulb.getCharacteristic(C.ColorTemperature)
+        .onGet(() => registry.get(fixture.id).colorTemperatureMireds ?? 200)
         .onSet((v) => {
-          this.state.colorTemperatureMireds = Number(v);
-          // CCT mode: HomeKit toggles between color and white modes; we mirror
-          // by zeroing saturation when CCT is changed.
-          this.state.saturation = 0;
+          // CCT change implies white mode; zero saturation.
+          registry.update(fixture.id, {
+            colorTemperatureMireds: Number(v),
+            saturation: 0,
+          });
           this.schedule();
         });
     }
+
+    // Refresh HomeKit characteristics whenever this fixture's state changes
+    // in the registry (e.g. via a zone set, or another channel of itself).
+    registry.onChange((changedId) => {
+      if (changedId !== fixture.id) return;
+      this.pushFromRegistry();
+    });
+  }
+
+  private pushFromRegistry(): void {
+    const s = this.registry.get(this.fixture.id);
+    const C = this.platform.Characteristic;
+    const chars = this.fixture.profile.model.characteristics;
+    this.bulb.updateCharacteristic(C.On, s.on);
+    if (chars.includes('Brightness')) this.bulb.updateCharacteristic(C.Brightness, s.brightness);
+    if (chars.includes('Hue') && s.hue != null) this.bulb.updateCharacteristic(C.Hue, s.hue);
+    if (chars.includes('Saturation') && s.saturation != null) this.bulb.updateCharacteristic(C.Saturation, s.saturation);
+    if (chars.includes('ColorTemperature') && s.colorTemperatureMireds != null) {
+      this.bulb.updateCharacteristic(C.ColorTemperature, s.colorTemperatureMireds);
+    }
   }
 
   private schedule(): void {
     if (this.pending) clearTimeout(this.pending);
     this.pending = setTimeout(() => {
       this.pending = null;
-      const s = this.state;
+      const s = this.registry.get(this.fixture.id);
       this.platform.log.info(
         `[${this.fixture.id}] HK set: on=${s.on} br=${s.brightness}` +
         (s.hue != null ? ` h=${s.hue}` : '') +
         (s.saturation != null ? ` s=${s.saturation}` : '') +
         (s.colorTemperatureMireds != null ? ` ct=${s.colorTemperatureMireds}` : ''),
       );
-      this.controller.setFixture(this.fixture, this.state);
+      this.controller.setFixture(this.fixture, s);
     }, CHARACTERISTIC_UPDATE_DELAY_MS);
   }
 }

package/src/settings.ts

@@ -12,6 +12,17 @@ export const CHARACTERISTIC_UPDATE_DELAY_MS = 50;
  *  slider drag into one transaction. */
 export const DEBOUNCE_MS = 750;
 
+/** Idle keepalive. The Stick-DE3 drifts into a wedged state after hours
+ *  without traffic: sessions and the crypto handshake still succeed but
+ *  live DMX output goes dark (observed 2026-08-22..25; only a hard power
+ *  cycle recovers it). Re-sending the last-known state whenever the
+ *  controller has been idle this long keeps the device exercised and
+ *  re-asserts state after an out-of-band power-cycle. 0 disables. */
+export const REFRESH_MINUTES_DEFAULT = 30;
+
+/** How often the controller checks whether a keepalive refresh is due. */
+export const REFRESH_CHECK_MS = 60_000;
+
 /** Frame interval (40ms = 25Hz, matches HWM exactly). Unused by the
  *  subprocess controller — send_dmx.mjs's own FRAME_HZ env knob is what
  *  matters now. */