@meshbench/client 0.0.1 → 0.0.7

package/lib/device.mjs

@@ -46,6 +46,14 @@ export class Device {
    *  Held rather than clicked because the firmware cares: MeshCore wakes a
    *  sleeping display on a press and powers the board off on a long one, so a
    *  caller times the release itself - or uses `tap`, which does not hold. */
+  /** Restart the board, the way pressing its own reset button does.
+   *
+   *  Torn down and built again from the same flash: whatever the firmware
+   *  wrote survives and whatever it held in memory does not. */
+  async reset() {
+    await this._wb.call("board.reset", { node: this.name });
+  }
+
   async press(pin, down = true) {
     await this._wb.call("board.press", { node: this.name, pin, down });
   }

package/lib/sim.mjs

@@ -34,17 +34,16 @@ export class Sim {
     // The links first. Nothing that follows means anything against a matrix
     // that is still being measured.
     await this._wb.waitIdle(warmMs);
-    // Idle is not the same as measured. A warm that stopped to ask permission
-    // to download terrain finishes its own job row, so the wait above returns
-    // in a moment having waited for nothing: no link was measured, and every
-    // study after this would answer over free space.
-    const held = await this.state();
-    if (held.warm_held) {
-      const note = (held.ground || {}).note ||
-        "call terrain.allow to answer the question either way";
+    // Idle is not the same as measured. A warm that failed or was cancelled
+    // finishes its own job row, so the wait above returns having waited for
+    // nothing: no link was measured, and every study after this would answer
+    // over free space.
+    const now = await this.state();
+    if (!now.links_measured && !now.warming) {
+      const note = (now.ground || {}).note ||
+        "warm the links again before reading anything from this run";
       throw new MeshbenchError(
-        "the link measurement is held: no terrain has been downloaded and no " +
-        `link has been measured. ${note}`);
+        `no link has been measured, so nothing here can reach anything. ${note}`);
     }
     // Then every node that is not up, which firmware.start does and sim.start
     // does only when none of them are.

package/lib/workbench.mjs

@@ -298,6 +298,22 @@ export class Workbench {
     return (got || {}).tab || "";
   }
 
+  /** Open a node's board view and return the board it is showing.
+   *
+   *  The board in full: its panel, the controls for what it has wired, and what
+   *  its profile declares beside what the firmware left in the chip. Windowed
+   *  sessions only, for the same reason window() is, and refused for a node
+   *  running a host build: there is no board to show. */
+  async boardView(node) {
+    if (this.isHeadless) {
+      throw new Unavailable("node.boardview",
+        "this session has no interface attached, so there is nothing to show",
+        "unavailable");
+    }
+    const got = await this.call("node.boardview", { node: String(node) });
+    return (got || {}).board || "";
+  }
+
   // ---- the shape -------------------------------------------------------
 
   get nodes() { return new Nodes(this); }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@meshbench/client",
-  "version": "0.0.1",
+  "version": "0.0.7",
   "description": "Drive a running MeshBench workbench from Node over its control socket.",
   "license": "GPL-3.0-or-later",
   "type": "module",