homebridge-eliot-smart-control 1.6.2 → 1.6.3

package/CHANGELOG.md

@@ -6,6 +6,25 @@ adheres to [semantic versioning](https://semver.org/spec/v2.0.0.html).
 
 ## [Unreleased]
 
+## [1.6.3] — 2026-09-21
+
+### Changed
+
+- **The hardware tools stay out of the npm package.** `tools/` is a workbench
+  for a Raspberry Pi with a dongle attached, not something an install needs:
+  117 kB of it shipped to every user, a dozen scripts of which drive the desk
+  and one of which drives it to the floor. Finding a dongle, the one thing a
+  user might have wanted from it, is the scan button in the config UI.
+
+### Removed
+
+- **Fourteen single-question probes.** Each was written to settle one point
+  about the protocol — whether `VELOCITY` bites, whether a memory move can be
+  interrupted, what `VERSION` answers — and each of those answers, with the
+  measurements behind it, is written up in `docs/PROTOCOL.md`. The scripts were
+  the scaffolding, and the reference is the thing that was being built. What
+  remains in `tools/` is the eight that answer a question you can still have.
+
 ## [1.6.2] — 2026-09-21
 
 ### Changed
@@ -411,7 +430,8 @@ First release.
   verified against hardware, including the measured travel speed and stopping
   distance.
 
-[Unreleased]: https://github.com/rummeyer/homebridge-eliot-smart-control/compare/v1.6.2...HEAD
+[Unreleased]: https://github.com/rummeyer/homebridge-eliot-smart-control/compare/v1.6.3...HEAD
+[1.6.3]: https://github.com/rummeyer/homebridge-eliot-smart-control/compare/v1.6.2...v1.6.3
 [1.6.2]: https://github.com/rummeyer/homebridge-eliot-smart-control/compare/v1.6.1...v1.6.2
 [1.6.1]: https://github.com/rummeyer/homebridge-eliot-smart-control/compare/v1.6.0...v1.6.1
 [1.6.0]: https://github.com/rummeyer/homebridge-eliot-smart-control/compare/v1.5.2...v1.6.0

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "homebridge-eliot-smart-control",
   "displayName": "Eliot Smart Control",
-  "version": "1.6.2",
+  "version": "1.6.3",
   "description": "Homebridge plugin for the Eliot sit-stand desk with the Smart Dongle, over Bluetooth LE",
   "license": "MIT",
   "author": "Oliver Rummeyer",
@@ -51,7 +51,6 @@
   "files": [
     "dist",
     "homebridge-ui",
-    "tools",
     "docs",
     "!docs/*.png",
     "config.schema.json",

package/tools/conflict-test.js

@@ -1,67 +0,0 @@
-#!/usr/bin/env node
-/**
- * What happens when the handset is used during a plugin move? THIS MOVES THE
- * DESK, and expects a person to push back against it.
- *
- *   npm run build && node tools/conflict-test.js <MAC>
- *
- * Drives a long way through the normal closed loop and logs every height
- * report and every outcome, so the control box's arbitration between two
- * commanders is visible afterwards.
- */
-import { Desk } from '../dist/eliot/desk.js';
-import { DeskLink } from '../dist/eliot/link.js';
-
-const MAC = (process.argv[2] || '').toUpperCase();
-if (!/^([0-9A-F]{2}:){5}[0-9A-F]{2}$/.test(MAC)) {
-  console.error('Usage: node tools/conflict-test.js <MAC>');
-  process.exit(1);
-}
-
-const t0 = Date.now();
-const stamp = () => `${String((Date.now() - t0) / 1000).padStart(6)}s`;
-const say = (m) => console.log(`${stamp()} ${m}`);
-const log = { debug: () => {}, info: (m) => say(`      ${m}`), warn: (m) => say(`WARN  ${m}`), error: (m) => say(`ERROR ${m}`) };
-const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
-const waitConnected = (l, ms) =>
-  l.connected ? Promise.resolve() : new Promise((res) => {
-    const t = setTimeout(res, ms);
-    l.once('connected', () => { clearTimeout(t); res(); });
-  });
-
-const link = new DeskLink(MAC, log);
-const desk = new Desk(link, log, { idlePollMs: 0 });
-
-let last = null;
-desk.on('change', (s) => {
-  const line = `${s.heightMm} mm  ${s.position}%  ziel ${s.target}%  ${s.moving ?? 'steht'}`;
-  if (line !== last) { last = line; say(`      ${line}`); }
-});
-
-await desk.start();
-await waitConnected(link, 60_000);
-await sleep(3000);
-
-const s0 = desk.state;
-if (!s0.ready) { console.error('kein zustand'); await desk.close(); process.exit(1); }
-
-// A long move, well inside the limits, so there is room to fight over.
-const up = s0.position < 50;
-const target = up ? Math.min(s0.position + 40, 90) : Math.max(s0.position - 40, 10);
-say(`start ${s0.heightMm} mm (${s0.position}%), fahre nach ${target}% — ${up ? 'HOCH' : 'RUNTER'}`);
-say(`>>> JETZT AM HANDSET DIE GEGENRICHTUNG DRUECKEN: ${up ? 'RUNTER' : 'HOCH'} <<<`);
-
-const outcome = await desk.moveTo(target);
-say(`ERGEBNIS: ${outcome}`);
-
-await sleep(3000);
-const s1 = desk.state;
-say(`danach: ${s1.heightMm} mm (${s1.position}%), ziel ${s1.target}%, ${s1.moving ?? 'steht'}`);
-say(outcome === 'stalled'
-  ? 'DEUTUNG: der regelkreis hat den widerstand erkannt und aufgegeben — gewuenscht'
-  : outcome === 'arrived'
-    ? 'DEUTUNG: durchgefahren — entweder wurde nicht gedrueckt, oder das plugin gewinnt'
-    : `DEUTUNG: ${outcome} — siehe hoehenverlauf oben`);
-
-await desk.close();
-process.exit(0);

package/tools/desk-test.js

@@ -1,75 +0,0 @@
-#!/usr/bin/env node
-/**
- * End-to-end test of Desk against real hardware. THIS MOVES THE DESK.
- *
- *   npm run build && node tools/desk-test.js <MAC> <percent> [percent…]
- *
- * Drives to each position in turn through the same path HomeKit will use, and
- * prints every state change on the way.
- */
-import { Desk } from '../dist/eliot/desk.js';
-import { DeskLink } from '../dist/eliot/link.js';
-
-const MAC = (process.argv[2] || '').toUpperCase();
-const TARGETS = process.argv.slice(3).map(Number);
-
-if (!/^([0-9A-F]{2}:){5}[0-9A-F]{2}$/.test(MAC) || !TARGETS.length || TARGETS.some(Number.isNaN)) {
-  console.error('Usage: node tools/desk-test.js <MAC> <percent> [percent…]');
-  process.exit(1);
-}
-
-const t0 = Date.now();
-const stamp = () => `${String((Date.now() - t0) / 1000).padStart(6)}s`;
-const say = (m) => console.log(`${stamp()} ${m}`);
-const log = { debug: () => {}, info: (m) => say(`      ${m}`), warn: (m) => say(`WARN  ${m}`), error: (m) => say(`ERROR ${m}`) };
-const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
-
-/**
- * `start()` resolves after the first connect attempt, successful or not — the
- * retry runs in the background. A tool that checks `connected` straight after
- * therefore reports failure whenever the first attempt misses, which it often
- * does when the dongle has just been released by something else.
- */
-const waitConnected = (l, ms) =>
-  l.connected
-    ? Promise.resolve()
-    : new Promise((resolve) => {
-        const timer = setTimeout(resolve, ms);
-        l.once('connected', () => { clearTimeout(timer); resolve(); });
-      });
-
-
-const link = new DeskLink(MAC, log);
-const desk = new Desk(link, log, { idlePollMs: 0 });
-
-let last = '';
-desk.on('change', (s) => {
-  const line = `${s.position}% (${s.heightMm} mm) target ${s.target}% ${s.moving ?? 'at rest'}`;
-  if (line !== last) {
-    last = line;
-    say(`      ${line}`);
-  }
-});
-
-await desk.start();
-await waitConnected(link, 60_000);
-await sleep(2500);
-
-if (!desk.state.connected || desk.state.position === null) {
-  console.error('No usable state — is the Eliot app holding the dongle?');
-  await desk.close();
-  process.exit(1);
-}
-
-say(`start: ${desk.state.position}% at ${desk.state.heightMm} mm, range ${desk.minMm}-${desk.maxMm} mm`);
-
-for (const target of TARGETS) {
-  say(`==> moveTo(${target}%)`);
-  const outcome = await desk.moveTo(target);
-  await sleep(2500);
-  const s = desk.state;
-  say(`<== ${outcome}: ${s.position}% at ${s.heightMm} mm (asked ${target}%, off by ${s.position - target}%)`);
-}
-
-await desk.close();
-process.exit(0);

package/tools/eco-test.js

@@ -1,68 +0,0 @@
-#!/usr/bin/env node
-/**
- * Does LOW_POWER (0x18) change the travel speed? THIS MOVES THE DESK.
- *
- * If it does, the setting can be read back by timing a move — which matters,
- * because the control box will not report it on this connection.
- *
- * Same direction, same distance, three times over, so the ramp cannot
- * flatter one setting over another.
- */
-import { DeskLink } from '../dist/eliot/link.js';
-import { Cmd, Report, heightParams, readHeight } from '../dist/eliot/protocol.js';
-
-const MAC = (process.argv[2] || '').toUpperCase();
-const LOW = 780, HIGH = 1000;
-
-const t0 = Date.now();
-const say = (m) => console.log(`${String((Date.now() - t0) / 1000).padStart(6)}s ${m}`);
-const log = { debug: () => {}, info: () => {}, warn: () => {}, error: (m) => say(`ERR ${m}`) };
-const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
-
-let height = null;
-const link = new DeskLink(MAC, log);
-link.on('frame', (f) => { if (f.command === Report.HEIGHT) height = readHeight(f.params); });
-
-await link.start();
-await (link.connected ? Promise.resolve() : new Promise((res) => {
-  const t = setTimeout(res, 60000); link.once('connected', () => { clearTimeout(t); res(); });
-}));
-if (!link.connected) { console.error('nicht verbunden'); process.exit(1); }
-
-await link.send(Cmd.WAKE); await sleep(700);
-await link.send(Cmd.SETTINGS); await sleep(1200);
-
-async function driveTo(target) {
-  const samples = [];
-  const on = (f) => { if (f.command === Report.HEIGHT) samples.push([Date.now(), readHeight(f.params)]); };
-  link.on('frame', on);
-  await link.send(Cmd.GOTO_HEIGHT, heightParams(target));
-  let still = 0, prev = height;
-  while (still < 2500) {
-    await sleep(200);
-    if (height !== prev) { prev = height; still = 0; } else still += 200;
-  }
-  link.off('frame', on);
-  // Middle 60% only: that is cruise, without either ramp.
-  const moving = samples.filter(([, h]) => Math.abs(h - target) > 4);
-  if (moving.length < 6) return null;
-  const a = moving[Math.floor(moving.length * 0.2)];
-  const b = moving[Math.floor(moving.length * 0.8)];
-  const secs = (b[0] - a[0]) / 1000;
-  return secs > 0 ? Math.abs(b[1] - a[1]) / secs : null;
-}
-
-say(`start ${height} mm`);
-for (const value of [0, 1, 0]) {
-  await link.send(Cmd.GOTO_HEIGHT, heightParams(LOW));
-  let still = 0, prev = height;
-  while (still < 2000) { await sleep(200); if (height !== prev) { prev = height; still = 0; } else still += 200; }
-
-  await link.send(Cmd.LOW_POWER, [value]);
-  await sleep(1500);
-  const speed = await driveTo(HIGH);
-  say(`LOW_POWER ${value} (${value ? 'eco an' : 'eco aus'}): marschgeschwindigkeit ${speed ? speed.toFixed(1) : '?'} mm/s`);
-}
-
-await link.close();
-process.exit(0);