@microbit/microbit-connection 0.9.0-apps.alpha.15 → 0.9.0-apps.alpha.17

package/build/cjs/usb/arm-debug.test.js

@@ -0,0 +1,333 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const device_js_1 = require("../device.js");
+const logging_js_1 = require("../logging.js");
+const arm_debug_js_1 = require("./arm-debug.js");
+const cmsis_dap_js_1 = require("./cmsis-dap.js");
+// ---------------------------------------------------------------------------
+// Mock DAP
+// ---------------------------------------------------------------------------
+/**
+ * Creates a mock Dap that records transfer calls and returns configurable
+ * values. By default all methods resolve successfully.
+ *
+ * Read operations auto-respond from a register map (keyed by "port:register")
+ * when no queued results are available, making tests resilient to changes in
+ * the number or ordering of internal transfer calls.
+ */
+function createMockDap() {
+    // Track all transfer calls for assertions
+    const transferCalls = [];
+    // Queue of return values for transfer() — takes priority over registers.
+    const transferResults = [];
+    // Queue of return values for transferBlockRead()
+    const blockReadResults = [];
+    // Register map for auto-responding to reads when the queue is empty.
+    const registers = new Map();
+    let _isOpen = false;
+    const mock = {
+        get isOpen() {
+            return _isOpen;
+        },
+        blockSize: 59, // same as real CmsisDapUsb (64 - 4 - 1)
+        transferCalls,
+        registers,
+        queueTransferResult(...values) {
+            transferResults.push(new Uint32Array(values));
+        },
+        queueBlockReadResult(...values) {
+            blockReadResults.push(new Uint32Array(values));
+        },
+        open: vitest_1.vi.fn(async () => {
+            _isOpen = true;
+        }),
+        close: vitest_1.vi.fn(async () => {
+            _isOpen = false;
+        }),
+        send: vitest_1.vi.fn(async () => new DataView(new ArrayBuffer(64))),
+        clearAbort: vitest_1.vi.fn(async () => { }),
+        swjSequence: vitest_1.vi.fn(async () => { }),
+        swjClock: vitest_1.vi.fn(async () => { }),
+        connect: vitest_1.vi.fn(async () => { }),
+        disconnect: vitest_1.vi.fn(async () => { }),
+        configureTransfer: vitest_1.vi.fn(async () => { }),
+        drainStaleResponses: vitest_1.vi.fn(async () => { }),
+        transfer: vitest_1.vi.fn(async (ops) => {
+            transferCalls.push([...ops]);
+            if (transferResults.length > 0) {
+                return transferResults.shift();
+            }
+            // Auto-respond: return values for READ ops from the register map.
+            const readValues = [];
+            for (const op of ops) {
+                if (op.mode === cmsis_dap_js_1.READ) {
+                    readValues.push(registers.get(`${op.port}:${op.register}`) ?? 0);
+                }
+            }
+            return new Uint32Array(readValues);
+        }),
+        transferBlockRead: vitest_1.vi.fn(async () => {
+            return blockReadResults.shift() ?? new Uint32Array(0);
+        }),
+        transferBlockWrite: vitest_1.vi.fn(async () => { }),
+    };
+    return mock;
+}
+// CTRL/STAT power-up ACK bits (must match arm-debug.ts constants)
+const CSYSPWRUPACK = 1 << 31;
+const CDBGPWRUPACK = 1 << 29;
+const POWER_UP_ACK = (CSYSPWRUPACK | CDBGPWRUPACK) >>> 0;
+// AP registers
+const AP_DRW = 0x0c;
+const logging = new logging_js_1.ConsoleLogging();
+// DP registers (matching arm-debug.ts constants)
+const DP_DPIDR = 0x0;
+const DP_CTRL_STAT = 0x4;
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/**
+ * Set up register map values so the SWD connect sequence succeeds.
+ * Unlike a queue-based approach, this is resilient to changes in the
+ * number or ordering of internal transfer calls during connect.
+ */
+function setupConnectRegisters(dap) {
+    dap.registers.set(`${cmsis_dap_js_1.DP}:${DP_DPIDR}`, 0x0bb11477);
+    dap.registers.set(`${cmsis_dap_js_1.DP}:${DP_CTRL_STAT}`, POWER_UP_ACK);
+}
+// ---------------------------------------------------------------------------
+// Tests
+// ---------------------------------------------------------------------------
+(0, vitest_1.describe)("ArmDebugSwd", () => {
+    let dap;
+    let adi;
+    (0, vitest_1.beforeEach)(() => {
+        dap = createMockDap();
+        adi = new arm_debug_js_1.ArmDebugSwd(dap, logging);
+    });
+    (0, vitest_1.describe)("connect", () => {
+        (0, vitest_1.it)("runs the SWD init sequence", async () => {
+            setupConnectRegisters(dap);
+            await adi.connect();
+            // Transport opened
+            (0, vitest_1.expect)(dap.open).toHaveBeenCalled();
+            // SWD protocol setup
+            (0, vitest_1.expect)(dap.swjClock).toHaveBeenCalledWith(10_000_000);
+            (0, vitest_1.expect)(dap.connect).toHaveBeenCalled();
+            (0, vitest_1.expect)(dap.configureTransfer).toHaveBeenCalledWith(0, 100, 0);
+            // 4 SWJ sequences (line reset, SWD select, line reset, idle)
+            (0, vitest_1.expect)(dap.swjSequence).toHaveBeenCalledTimes(4);
+            // DP register operations happened
+            (0, vitest_1.expect)(dap.transfer).toHaveBeenCalled();
+        });
+        (0, vitest_1.it)("skips if already connected", async () => {
+            setupConnectRegisters(dap);
+            await adi.connect();
+            vitest_1.vi.mocked(dap.open).mockClear();
+            await adi.connect();
+            (0, vitest_1.expect)(dap.open).not.toHaveBeenCalled();
+        });
+        (0, vitest_1.it)("retries on DapResponseMismatchError", async () => {
+            // First attempt: swjClock throws mismatch
+            vitest_1.vi.mocked(dap.swjClock).mockRejectedValueOnce(new cmsis_dap_js_1.DapResponseMismatchError(0x11, 0x05));
+            // clearAbort on the failed attempt
+            vitest_1.vi.mocked(dap.clearAbort).mockResolvedValueOnce(undefined);
+            // Second attempt succeeds
+            setupConnectRegisters(dap);
+            await adi.connect();
+            (0, vitest_1.expect)(dap.drainStaleResponses).toHaveBeenCalledTimes(1);
+            (0, vitest_1.expect)(dap.swjClock).toHaveBeenCalledTimes(2);
+        });
+        (0, vitest_1.it)("throws after exhausting retries", async () => {
+            vitest_1.vi.mocked(dap.swjClock).mockRejectedValue(new cmsis_dap_js_1.DapResponseMismatchError(0x11, 0x05));
+            await (0, vitest_1.expect)(adi.connect(2)).rejects.toThrow(cmsis_dap_js_1.DapResponseMismatchError);
+            (0, vitest_1.expect)(dap.drainStaleResponses).toHaveBeenCalledTimes(1);
+        });
+        (0, vitest_1.it)("rethrows non-mismatch errors immediately", async () => {
+            vitest_1.vi.mocked(dap.swjClock).mockRejectedValueOnce(new Error("USB gone"));
+            await (0, vitest_1.expect)(adi.connect()).rejects.toThrow("USB gone");
+            (0, vitest_1.expect)(dap.drainStaleResponses).not.toHaveBeenCalled();
+        });
+    });
+    (0, vitest_1.describe)("disconnect", () => {
+        (0, vitest_1.it)("disconnects and closes transport", async () => {
+            setupConnectRegisters(dap);
+            await adi.connect();
+            await adi.disconnect();
+            (0, vitest_1.expect)(dap.disconnect).toHaveBeenCalled();
+            (0, vitest_1.expect)(dap.close).toHaveBeenCalled();
+        });
+        (0, vitest_1.it)("is a no-op if not connected", async () => {
+            await adi.disconnect();
+            (0, vitest_1.expect)(dap.disconnect).not.toHaveBeenCalled();
+            (0, vitest_1.expect)(dap.close).not.toHaveBeenCalled();
+        });
+        (0, vitest_1.it)("falls back to clearAbort if disconnect fails", async () => {
+            setupConnectRegisters(dap);
+            await adi.connect();
+            vitest_1.vi.mocked(dap.disconnect).mockRejectedValueOnce(new Error("fail"));
+            await adi.disconnect();
+            (0, vitest_1.expect)(dap.clearAbort).toHaveBeenCalled();
+            (0, vitest_1.expect)(dap.close).toHaveBeenCalled();
+        });
+    });
+    (0, vitest_1.describe)("reinit", () => {
+        (0, vitest_1.it)("resets state and reconnects without closing", async () => {
+            setupConnectRegisters(dap);
+            await adi.connect();
+            vitest_1.vi.mocked(dap.open).mockClear();
+            vitest_1.vi.mocked(dap.close).mockClear();
+            // reinit calls connectOnce which needs the full sequence
+            setupConnectRegisters(dap);
+            await adi.reinit();
+            // open is called again (connectOnce opens transport)
+            (0, vitest_1.expect)(dap.open).toHaveBeenCalled();
+            // close was NOT called (reinit doesn't close)
+            (0, vitest_1.expect)(dap.close).not.toHaveBeenCalled();
+        });
+    });
+    (0, vitest_1.describe)("readMem32 / writeMem32", () => {
+        (0, vitest_1.beforeEach)(async () => {
+            setupConnectRegisters(dap);
+            await adi.connect();
+            dap.transferCalls.length = 0;
+        });
+        (0, vitest_1.it)("reads a 32-bit value from memory", async () => {
+            dap.queueTransferResult(0xdeadbeef);
+            const value = await adi.readMem32(0x10000010);
+            (0, vitest_1.expect)(value).toBe(0xdeadbeef);
+            // Should have generated ops for CSW, TAR, and DRW read
+            const ops = dap.transferCalls[0];
+            (0, vitest_1.expect)(ops.some((op) => op.register === AP_DRW && op.mode === cmsis_dap_js_1.READ)).toBe(true);
+        });
+        (0, vitest_1.it)("writes a 32-bit value to memory", async () => {
+            await adi.writeMem32(0x10000010, 0x12345678);
+            const ops = dap.transferCalls[0];
+            const drwWrite = ops.find((op) => op.register === AP_DRW && op.mode === cmsis_dap_js_1.WRITE);
+            (0, vitest_1.expect)(drwWrite).toBeDefined();
+            (0, vitest_1.expect)(drwWrite.value).toBe(0x12345678);
+        });
+    });
+    (0, vitest_1.describe)("register caching", () => {
+        (0, vitest_1.beforeEach)(async () => {
+            setupConnectRegisters(dap);
+            await adi.connect();
+            dap.transferCalls.length = 0;
+        });
+        (0, vitest_1.it)("caches DP_SELECT and skips redundant writes", async () => {
+            // First read: all ops including DP_SELECT
+            await adi.readMem32(0x10000010);
+            const firstCallOpCount = dap.transferCalls[0].length;
+            // Second read at same address: DP_SELECT should be cached
+            await adi.readMem32(0x10000010);
+            const secondCallOpCount = dap.transferCalls[1].length;
+            (0, vitest_1.expect)(secondCallOpCount).toBeLessThan(firstCallOpCount);
+        });
+        (0, vitest_1.it)("invalidates cache on transfer error", async () => {
+            // First read succeeds, populating cache
+            await adi.readMem32(0x10000010);
+            // Second read: cache is warm, fewer ops
+            await adi.readMem32(0x10000010);
+            const cachedCallOpCount = dap.transferCalls[1].length;
+            // Third read fails — this invalidates the cache
+            vitest_1.vi.mocked(dap.transfer).mockRejectedValueOnce(new Error("fault"));
+            await (0, vitest_1.expect)(adi.readMem32(0x10000010)).rejects.toThrow("fault");
+            // Fourth read: cache should be invalidated, more ops than cached
+            await adi.readMem32(0x10000010);
+            const afterErrorOpCount = dap.transferCalls[2].length;
+            (0, vitest_1.expect)(afterErrorOpCount).toBeGreaterThan(cachedCallOpCount);
+        });
+    });
+    (0, vitest_1.describe)("readBlock", () => {
+        (0, vitest_1.beforeEach)(async () => {
+            setupConnectRegisters(dap);
+            await adi.connect();
+            dap.transferCalls.length = 0;
+        });
+        (0, vitest_1.it)("reads a small block in a single chunk", async () => {
+            dap.queueBlockReadResult(0x100, 0x200, 0x300);
+            const result = await adi.readBlock(0x20000000, 3);
+            (0, vitest_1.expect)(result.length).toBe(3);
+            (0, vitest_1.expect)(result[0]).toBe(0x100);
+            (0, vitest_1.expect)(result[1]).toBe(0x200);
+            (0, vitest_1.expect)(result[2]).toBe(0x300);
+            (0, vitest_1.expect)(dap.transferBlockRead).toHaveBeenCalledTimes(1);
+        });
+        (0, vitest_1.it)("splits reads at TAR auto-increment page boundaries", async () => {
+            // Address near a 1KB boundary: 0x200003F0 is 0x10 (16) bytes from the
+            // 1KB boundary at 0x20000400, so 4 words fit in the first page.
+            const address = 0x200003f0;
+            const count = 8; // 4 words in first page + 4 in next
+            dap.queueBlockReadResult(1, 2, 3, 4);
+            dap.queueBlockReadResult(5, 6, 7, 8);
+            const result = await adi.readBlock(address, count);
+            (0, vitest_1.expect)(result.length).toBe(8);
+            (0, vitest_1.expect)(Array.from(result)).toEqual([1, 2, 3, 4, 5, 6, 7, 8]);
+            (0, vitest_1.expect)(dap.transferBlockRead).toHaveBeenCalledTimes(2);
+        });
+    });
+    (0, vitest_1.describe)("writeBlock", () => {
+        (0, vitest_1.beforeEach)(async () => {
+            setupConnectRegisters(dap);
+            await adi.connect();
+            dap.transferCalls.length = 0;
+        });
+        (0, vitest_1.it)("writes a small block in a single chunk", async () => {
+            await adi.writeBlock(0x20000000, new Uint32Array([0xaa, 0xbb]));
+            (0, vitest_1.expect)(dap.transferBlockWrite).toHaveBeenCalledTimes(1);
+            const call = vitest_1.vi.mocked(dap.transferBlockWrite).mock.calls[0];
+            (0, vitest_1.expect)(call[0]).toBe(cmsis_dap_js_1.AP);
+            (0, vitest_1.expect)(call[1]).toBe(AP_DRW);
+            (0, vitest_1.expect)(Array.from(call[2])).toEqual([0xaa, 0xbb]);
+        });
+        (0, vitest_1.it)("splits writes at TAR auto-increment page boundaries", async () => {
+            const address = 0x200003f0; // 16 bytes (4 words) from 1KB boundary
+            await adi.writeBlock(address, new Uint32Array([1, 2, 3, 4, 5, 6, 7, 8]));
+            (0, vitest_1.expect)(dap.transferBlockWrite).toHaveBeenCalledTimes(2);
+            const firstChunk = vitest_1.vi.mocked(dap.transferBlockWrite).mock.calls[0][2];
+            const secondChunk = vitest_1.vi.mocked(dap.transferBlockWrite).mock.calls[1][2];
+            (0, vitest_1.expect)(Array.from(firstChunk)).toEqual([1, 2, 3, 4]);
+            (0, vitest_1.expect)(Array.from(secondChunk)).toEqual([5, 6, 7, 8]);
+        });
+    });
+    (0, vitest_1.describe)("transferSequence", () => {
+        (0, vitest_1.beforeEach)(async () => {
+            setupConnectRegisters(dap);
+            await adi.connect();
+            dap.transferCalls.length = 0;
+        });
+        (0, vitest_1.it)("executes groups as separate transfers and concatenates results", async () => {
+            const callsBefore = dap.transferCalls.length;
+            dap.queueTransferResult(0x11);
+            dap.queueTransferResult(0x22);
+            const result = await adi.transferSequence([
+                [{ port: cmsis_dap_js_1.DP, mode: cmsis_dap_js_1.READ, register: 0x00 }],
+                [{ port: cmsis_dap_js_1.DP, mode: cmsis_dap_js_1.READ, register: 0x04 }],
+            ]);
+            // Two new transfer calls for our two groups
+            (0, vitest_1.expect)(dap.transferCalls.length - callsBefore).toBe(2);
+            (0, vitest_1.expect)(result.length).toBe(2);
+            (0, vitest_1.expect)(result[0]).toBe(0x11);
+            (0, vitest_1.expect)(result[1]).toBe(0x22);
+        });
+    });
+    (0, vitest_1.describe)("waitFor", () => {
+        (0, vitest_1.it)("throws DeviceError on timeout", async () => {
+            await (0, vitest_1.expect)((0, arm_debug_js_1.waitFor)(() => Promise.resolve(false), 1)).rejects.toThrow(device_js_1.DeviceError);
+        });
+    });
+    (0, vitest_1.describe)("resetState", () => {
+        (0, vitest_1.it)("allows reconnecting after reset", async () => {
+            setupConnectRegisters(dap);
+            await adi.connect();
+            adi.resetState();
+            // Should be able to connect again (connectOnce won't skip)
+            setupConnectRegisters(dap);
+            await adi.connect();
+            // open called twice
+            (0, vitest_1.expect)(dap.open).toHaveBeenCalledTimes(2);
+        });
+    });
+});
+//# sourceMappingURL=arm-debug.test.js.map

package/build/cjs/usb/arm-debug.test.js.map

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

package/build/cjs/{board-serial-info.d.ts → usb/board-serial-info.d.ts}

@@ -3,12 +3,13 @@
  *
  * SPDX-License-Identifier: MIT
  */
-import { BoardId } from "./board-id.js";
+import { BoardId } from "../board-id.js";
 export declare class BoardSerialInfo {
     id: BoardId;
     familyId: string;
     hic: string;
     constructor(id: BoardId, familyId: string, hic: string);
+    static fromSerial(serial: string, log: (msg: string) => void): BoardSerialInfo;
     static parse(device: USBDevice, log: (msg: string) => void): BoardSerialInfo;
     eq(other: BoardSerialInfo): boolean;
 }

package/build/cjs/{board-serial-info.js → usb/board-serial-info.js}

@@ -6,7 +6,7 @@ exports.BoardSerialInfo = void 0;
  *
  * SPDX-License-Identifier: MIT
  */
-const board_id_js_1 = require("./board-id.js");
+const board_id_js_1 = require("../board-id.js");
 class BoardSerialInfo {
     constructor(id, familyId, hic) {
         Object.defineProperty(this, "id", {
@@ -28,19 +28,22 @@ class BoardSerialInfo {
             value: hic
         });
     }
-    static parse(device, log) {
-        const serial = device.serialNumber;
-        if (!serial) {
-            throw new Error("Could not detected ID from connected board.");
-        }
+    static fromSerial(serial, log) {
         if (serial.length !== 48) {
-            log(`USB serial number unexpected length: ${serial.length}`);
+            log(`Serial number unexpected length: ${serial.length}`);
         }
         const id = serial.substring(0, 4);
         const familyId = serial.substring(4, 8);
         const hic = serial.slice(-8);
         return new BoardSerialInfo(board_id_js_1.BoardId.parse(id), familyId, hic);
     }
+    static parse(device, log) {
+        const serial = device.serialNumber;
+        if (!serial) {
+            throw new Error("Could not detected ID from connected board.");
+        }
+        return BoardSerialInfo.fromSerial(serial, log);
+    }
     eq(other) {
         return (other.id === this.id &&
             other.familyId === this.familyId &&

package/build/cjs/usb/board-serial-info.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"board-serial-info.js","sourceRoot":"","sources":["../../../src/usb/board-serial-info.ts"],"names":[],"mappings":";;;AAAA;;;;GAIG;AACH,gDAAyC;AAEzC,MAAa,eAAe;IAC1B,YACS,EAAW,EACX,QAAgB,EAChB,GAAW;QAFlB;;;;mBAAO,EAAE;WAAS;QAClB;;;;mBAAO,QAAQ;WAAQ;QACvB;;;;mBAAO,GAAG;WAAQ;IACjB,CAAC;IAEJ,MAAM,CAAC,UAAU,CAAC,MAAc,EAAE,GAA0B;QAC1D,IAAI,MAAM,CAAC,MAAM,KAAK,EAAE,EAAE,CAAC;YACzB,GAAG,CAAC,oCAAoC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;QAC3D,CAAC;QACD,MAAM,EAAE,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAClC,MAAM,QAAQ,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QACxC,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QAC7B,OAAO,IAAI,eAAe,CAAC,qBAAO,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,QAAQ,EAAE,GAAG,CAAC,CAAC;IAC/D,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,MAAiB,EAAE,GAA0B;QACxD,MAAM,MAAM,GAAG,MAAM,CAAC,YAAY,CAAC;QACnC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;QACjE,CAAC;QACD,OAAO,eAAe,CAAC,UAAU,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACjD,CAAC;IAED,EAAE,CAAC,KAAsB;QACvB,OAAO,CACL,KAAK,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE;YACpB,KAAK,CAAC,QAAQ,KAAK,IAAI,CAAC,QAAQ;YAChC,KAAK,CAAC,GAAG,KAAK,IAAI,CAAC,GAAG,CACvB,CAAC;IACJ,CAAC;CACF;AAhCD,0CAgCC"}

package/build/cjs/usb/board-serial-info.test.d.ts

@@ -0,0 +1 @@
+export {};

package/build/cjs/usb/board-serial-info.test.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * (c) 2021, Micro:bit Educational Foundation and contributors
+ *
+ * SPDX-License-Identifier: MIT
+ */
+const board_id_js_1 = require("../board-id.js");
+const board_serial_info_js_1 = require("./board-serial-info.js");
+const vitest_1 = require("vitest");
+(0, vitest_1.describe)("BoardSerialInfo", () => {
+    const valid = {
+        serialNumber: "9904360251974e450039900a00000041000000009796990b",
+    };
+    const weirdLength = {
+        serialNumber: "9904360251974e450039900a000000410000000097969",
+    };
+    const missing = { serialNumber: "" };
+    const log = vitest_1.vi.fn();
+    (0, vitest_1.afterEach)(() => {
+        log.mockReset();
+    });
+    (0, vitest_1.it)("throws if serialNumber missing", () => {
+        (0, vitest_1.expect)(() => board_serial_info_js_1.BoardSerialInfo.parse(missing, log)).toThrowError();
+        (0, vitest_1.expect)(log.mock.calls).toEqual([]);
+    });
+    (0, vitest_1.it)("parses serials", () => {
+        const result = board_serial_info_js_1.BoardSerialInfo.parse(valid, log);
+        (0, vitest_1.expect)(result).toEqual({
+            id: board_id_js_1.BoardId.parse("9904"),
+            familyId: "3602",
+            hic: "9796990b",
+        });
+        (0, vitest_1.expect)(log.mock.calls).toEqual([]);
+    });
+    (0, vitest_1.it)("logs if unexpected length", () => {
+        const result = board_serial_info_js_1.BoardSerialInfo.parse(weirdLength, log);
+        (0, vitest_1.expect)(result).toEqual({
+            id: board_id_js_1.BoardId.parse("9904"),
+            familyId: "3602",
+            hic: "00097969",
+        });
+        (0, vitest_1.expect)(log.mock.calls).toEqual([["Serial number unexpected length: 45"]]);
+    });
+});
+//# sourceMappingURL=board-serial-info.test.js.map

package/build/cjs/usb/board-serial-info.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"board-serial-info.test.js","sourceRoot":"","sources":["../../../src/usb/board-serial-info.test.ts"],"names":[],"mappings":";;AAAA;;;;GAIG;AACH,gDAAyC;AACzC,iEAAyD;AACzD,mCAA6D;AAE7D,IAAA,iBAAQ,EAAC,iBAAiB,EAAE,GAAG,EAAE;IAC/B,MAAM,KAAK,GAAG;QACZ,YAAY,EAAE,kDAAkD;KACpD,CAAC;IACf,MAAM,WAAW,GAAG;QAClB,YAAY,EAAE,+CAA+C;KACjD,CAAC;IACf,MAAM,OAAO,GAAG,EAAE,YAAY,EAAE,EAAE,EAAe,CAAC;IAClD,MAAM,GAAG,GAAG,WAAE,CAAC,EAAE,EAAE,CAAC;IACpB,IAAA,kBAAS,EAAC,GAAG,EAAE;QACb,GAAG,CAAC,SAAS,EAAE,CAAC;IAClB,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,gCAAgC,EAAE,GAAG,EAAE;QACxC,IAAA,eAAM,EAAC,GAAG,EAAE,CAAC,sCAAe,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC,YAAY,EAAE,CAAC;QAEjE,IAAA,eAAM,EAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,gBAAgB,EAAE,GAAG,EAAE;QACxB,MAAM,MAAM,GAAG,sCAAe,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QACjD,IAAA,eAAM,EAAC,MAAM,CAAC,CAAC,OAAO,CAAC;YACrB,EAAE,EAAE,qBAAO,CAAC,KAAK,CAAC,MAAM,CAAC;YACzB,QAAQ,EAAE,MAAM;YAChB,GAAG,EAAE,UAAU;SAChB,CAAC,CAAC;QAEH,IAAA,eAAM,EAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,2BAA2B,EAAE,GAAG,EAAE;QACnC,MAAM,MAAM,GAAG,sCAAe,CAAC,KAAK,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC;QACvD,IAAA,eAAM,EAAC,MAAM,CAAC,CAAC,OAAO,CAAC;YACrB,EAAE,EAAE,qBAAO,CAAC,KAAK,CAAC,MAAM,CAAC;YACzB,QAAQ,EAAE,MAAM;YAChB,GAAG,EAAE,UAAU;SAChB,CAAC,CAAC;QAEH,IAAA,eAAM,EAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,qCAAqC,CAAC,CAAC,CAAC,CAAC;IAC5E,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/build/cjs/usb/cdc-saturation.d.ts

@@ -0,0 +1,36 @@
+/**
+ * (c) 2026, Micro:bit Educational Foundation and contributors
+ *
+ * SPDX-License-Identifier: MIT
+ */
+/**
+ * CDC pipeline saturation
+ *
+ * DAPLink's CDC serial path and WebUSB vendor serial reads share the same
+ * UART ring buffer. After a physical USB connection, CDC consumes early
+ * serial bytes before our vendor reads can get them, causing truncated
+ * output. See: https://github.com/ARMmbed/DAPLink/issues/903
+ *
+ * Workaround: before flashing, push dummy data through the target's UART
+ * to fill DAPLink's internal buffers. When nobody is reading from the CDC
+ * serial port, the CDC TX buffer fills first, then cdc_process_event()
+ * stops pulling from the UART RX ring buffer, and that fills too. Once
+ * both are full, all subsequent UART data overflows harmlessly and
+ * post-flash serial output is left for our vendor reads.
+ *
+ * V1 (nRF51) uses a Thumb blob for the legacy byte-at-a-time UART.
+ * V2 (nRF52833) uses SWD register writes to trigger a UARTE DMA transfer.
+ *
+ * V1 DAPLink defaults to 9600 baud on fresh USB connection, so we call
+ * setBaudrate(115200) before saturation to ensure DAPLink can decode the
+ * bytes we send.
+ */
+import { BoardVersion } from "../device.js";
+import { Logging } from "../logging.js";
+import { type USBDeviceWrapper } from "./device-wrapper.js";
+/**
+ * Push dummy data through the target's UART to fill DAPLink's internal
+ * CDC buffers, preventing CDC from consuming post-flash serial output.
+ * Must be called while the target is halted.
+ */
+export declare function saturateCdcPipeline(device: USBDeviceWrapper, boardVersion: BoardVersion, logging: Logging): Promise<void>;