@microbit/microbit-connection 0.9.0-apps.alpha.16 → 0.9.0-apps.alpha.18

package/build/cjs/usb/cmsis-dap.test.js

@@ -0,0 +1,350 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const transport_js_1 = require("./transport.js");
+const cmsis_dap_js_1 = require("./cmsis-dap.js");
+const logging_js_1 = require("../logging.js");
+// ---------------------------------------------------------------------------
+// Mock transport
+// ---------------------------------------------------------------------------
+class MockTransport {
+    constructor() {
+        Object.defineProperty(this, "isOpen", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: false
+        });
+        Object.defineProperty(this, "written", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: []
+        });
+        Object.defineProperty(this, "responses", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: []
+        });
+        Object.defineProperty(this, "open", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: vitest_1.vi.fn(async () => {
+                this.isOpen = true;
+            })
+        });
+        Object.defineProperty(this, "close", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: vitest_1.vi.fn(async () => {
+                this.isOpen = false;
+            })
+        });
+        Object.defineProperty(this, "write", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: vitest_1.vi.fn(async (data) => {
+                this.written.push(new Uint8Array(data));
+            })
+        });
+        Object.defineProperty(this, "read", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: vitest_1.vi.fn(async () => {
+                const response = this.responses.shift();
+                if (!response) {
+                    throw new Error("MockTransport: no responses queued");
+                }
+                return response;
+            })
+        });
+    }
+    /** Queue a raw response packet. */
+    queueResponse(bytes) {
+        const buffer = new Uint8Array(transport_js_1.PACKET_SIZE);
+        buffer.set(bytes);
+        this.responses.push(new DataView(buffer.buffer));
+    }
+    /** Queue a simple echo response (command byte + OK status). */
+    queueOk(command) {
+        this.queueResponse([command, 0x00]);
+    }
+    /** Queue a DAP_TRANSFER response with OK status and read values. */
+    queueTransferOk(opCount, readValues = []) {
+        const DAP_TRANSFER = 0x05;
+        const buffer = new Uint8Array(transport_js_1.PACKET_SIZE);
+        const view = new DataView(buffer.buffer);
+        view.setUint8(0, DAP_TRANSFER);
+        view.setUint8(1, opCount); // completed count
+        view.setUint8(2, 0x01); // TRANSFER_OK
+        readValues.forEach((val, i) => {
+            view.setUint32(3 + i * 4, val, true);
+        });
+        this.responses.push(new DataView(buffer.buffer));
+    }
+    /** Queue a DAP_TRANSFER_BLOCK read response. */
+    queueBlockReadOk(count, values) {
+        const DAP_TRANSFER_BLOCK = 0x06;
+        const buffer = new Uint8Array(transport_js_1.PACKET_SIZE);
+        const view = new DataView(buffer.buffer);
+        view.setUint8(0, DAP_TRANSFER_BLOCK);
+        view.setUint16(1, count, true);
+        view.setUint8(3, 0x01); // TRANSFER_OK
+        values.forEach((val, i) => {
+            view.setUint32(4 + i * 4, val, true);
+        });
+        this.responses.push(new DataView(buffer.buffer));
+    }
+    /** Queue a DAP_TRANSFER_BLOCK write response. */
+    queueBlockWriteOk(count) {
+        const DAP_TRANSFER_BLOCK = 0x06;
+        const buffer = new Uint8Array(transport_js_1.PACKET_SIZE);
+        const view = new DataView(buffer.buffer);
+        view.setUint8(0, DAP_TRANSFER_BLOCK);
+        view.setUint16(1, count, true);
+        view.setUint8(3, 0x01); // TRANSFER_OK
+        this.responses.push(new DataView(buffer.buffer));
+    }
+}
+// ---------------------------------------------------------------------------
+// Tests
+// ---------------------------------------------------------------------------
+const logging = new logging_js_1.ConsoleLogging();
+(0, vitest_1.describe)("CmsisDapUsb", () => {
+    let transport;
+    let dap;
+    (0, vitest_1.beforeEach)(() => {
+        transport = new MockTransport();
+        dap = new cmsis_dap_js_1.CmsisDapUsb(transport, logging);
+    });
+    (0, vitest_1.describe)("send", () => {
+        (0, vitest_1.it)("frames command with no data", async () => {
+            transport.queueOk(0x03); // DAP_DISCONNECT
+            await dap.send(0x03);
+            (0, vitest_1.expect)(transport.written.length).toBe(1);
+            (0, vitest_1.expect)(transport.written[0][0]).toBe(0x03);
+        });
+        (0, vitest_1.it)("frames command with data payload", async () => {
+            transport.queueOk(0x11); // DAP_SWJ_CLOCK
+            await dap.send(0x11, new Uint8Array([0x01, 0x02, 0x03, 0x04]));
+            const sent = transport.written[0];
+            (0, vitest_1.expect)(sent[0]).toBe(0x11);
+            (0, vitest_1.expect)(sent[1]).toBe(0x01);
+            (0, vitest_1.expect)(sent[2]).toBe(0x02);
+        });
+        (0, vitest_1.it)("throws DapResponseMismatchError on wrong response command", async () => {
+            transport.queueResponse([0xff]); // wrong command byte
+            await (0, vitest_1.expect)(dap.send(0x03)).rejects.toThrow(cmsis_dap_js_1.DapResponseMismatchError);
+        });
+        (0, vitest_1.it)("throws DapError on bad status for status-checked commands", async () => {
+            // DAP_DISCONNECT (0x03) is status-checked
+            transport.queueResponse([0x03, 0x01]); // non-zero status
+            await (0, vitest_1.expect)(dap.send(0x03)).rejects.toThrow(cmsis_dap_js_1.DapError);
+        });
+        (0, vitest_1.it)("does not check status for non-status-checked commands", async () => {
+            // DAP_CONNECT (0x02) is not in STATUS_CHECK_COMMANDS
+            transport.queueResponse([0x02, 0xff]); // non-zero byte 1 is fine
+            const result = await dap.send(0x02);
+            (0, vitest_1.expect)(result.getUint8(0)).toBe(0x02);
+        });
+    });
+    (0, vitest_1.describe)("connect", () => {
+        (0, vitest_1.it)("sends DAP_CONNECT and succeeds with non-zero port", async () => {
+            transport.queueResponse([0x02, 0x01]); // SWD port
+            await dap.connect();
+            (0, vitest_1.expect)(transport.written[0][0]).toBe(0x02);
+        });
+        (0, vitest_1.it)("throws on DAP_CONNECT_FAILED (port 0)", async () => {
+            transport.queueResponse([0x02, 0x00]);
+            await (0, vitest_1.expect)(dap.connect()).rejects.toThrow("Mode not enabled");
+        });
+    });
+    (0, vitest_1.describe)("swjClock", () => {
+        (0, vitest_1.it)("sends frequency as little-endian uint32", async () => {
+            transport.queueOk(0x11);
+            await dap.swjClock(10_000_000);
+            const sent = transport.written[0];
+            (0, vitest_1.expect)(sent[0]).toBe(0x11);
+            const freq = new DataView(sent.buffer).getUint32(1, true);
+            (0, vitest_1.expect)(freq).toBe(10_000_000);
+        });
+    });
+    (0, vitest_1.describe)("swjSequence", () => {
+        (0, vitest_1.it)("prepends bit length to data", async () => {
+            transport.queueOk(0x12);
+            await dap.swjSequence(new Uint8Array([0xff, 0xff]));
+            const sent = transport.written[0];
+            (0, vitest_1.expect)(sent[0]).toBe(0x12);
+            (0, vitest_1.expect)(sent[1]).toBe(16); // 2 bytes * 8 bits
+            (0, vitest_1.expect)(sent[2]).toBe(0xff);
+            (0, vitest_1.expect)(sent[3]).toBe(0xff);
+        });
+    });
+    (0, vitest_1.describe)("configureTransfer", () => {
+        (0, vitest_1.it)("sends idle cycles, wait retry, and match retry", async () => {
+            transport.queueOk(0x04);
+            await dap.configureTransfer(0, 100, 0);
+            const sent = transport.written[0];
+            (0, vitest_1.expect)(sent[0]).toBe(0x04);
+            (0, vitest_1.expect)(sent[1]).toBe(0); // idle cycles
+            const view = new DataView(sent.buffer);
+            (0, vitest_1.expect)(view.getUint16(2, true)).toBe(100); // wait retry
+            (0, vitest_1.expect)(view.getUint16(4, true)).toBe(0); // match retry
+        });
+    });
+    (0, vitest_1.describe)("transfer", () => {
+        (0, vitest_1.it)("returns empty array for empty operations", async () => {
+            const result = await dap.transfer([]);
+            (0, vitest_1.expect)(result.length).toBe(0);
+            (0, vitest_1.expect)(transport.written.length).toBe(0);
+        });
+        (0, vitest_1.it)("frames a single write operation", async () => {
+            transport.queueTransferOk(1);
+            await dap.transfer([
+                { port: cmsis_dap_js_1.DP, mode: cmsis_dap_js_1.WRITE, register: 0x04, value: 0x12345678 },
+            ]);
+            const sent = transport.written[0];
+            (0, vitest_1.expect)(sent[0]).toBe(0x05); // DAP_TRANSFER
+            (0, vitest_1.expect)(sent[1]).toBe(0x00); // DAP index
+            (0, vitest_1.expect)(sent[2]).toBe(1); // op count
+            // Operation byte: port | mode | register
+            (0, vitest_1.expect)(sent[3]).toBe(cmsis_dap_js_1.DP | cmsis_dap_js_1.WRITE | 0x04);
+            const view = new DataView(sent.buffer);
+            (0, vitest_1.expect)(view.getUint32(4, true)).toBe(0x12345678);
+        });
+        (0, vitest_1.it)("returns read values", async () => {
+            transport.queueTransferOk(1, [0xdeadbeef]);
+            const result = await dap.transfer([
+                { port: cmsis_dap_js_1.AP, mode: cmsis_dap_js_1.READ, register: 0x0c },
+            ]);
+            (0, vitest_1.expect)(result.length).toBe(1);
+            (0, vitest_1.expect)(result[0]).toBe(0xdeadbeef);
+        });
+        (0, vitest_1.it)("handles mixed read/write and returns only read values", async () => {
+            transport.queueTransferOk(3, [0xaabbccdd, 0x11223344]);
+            const result = await dap.transfer([
+                { port: cmsis_dap_js_1.DP, mode: cmsis_dap_js_1.WRITE, register: 0x08, value: 0 },
+                { port: cmsis_dap_js_1.AP, mode: cmsis_dap_js_1.READ, register: 0x00 },
+                { port: cmsis_dap_js_1.AP, mode: cmsis_dap_js_1.READ, register: 0x0c },
+            ]);
+            (0, vitest_1.expect)(result.length).toBe(2);
+            (0, vitest_1.expect)(result[0]).toBe(0xaabbccdd);
+            (0, vitest_1.expect)(result[1]).toBe(0x11223344);
+        });
+        (0, vitest_1.it)("throws DapTransferError on FAULT response and clears abort", async () => {
+            // Transfer response: FAULT
+            const buffer = new Uint8Array(transport_js_1.PACKET_SIZE);
+            const view = new DataView(buffer.buffer);
+            view.setUint8(0, 0x05);
+            view.setUint8(1, 0); // completed 0
+            view.setUint8(2, 0x04); // TRANSFER_FAULT
+            transport.responses.push(new DataView(buffer.buffer));
+            // clearAbort sends DAP_WRITE_ABORT (0x08), queue its response
+            transport.queueOk(0x08);
+            await (0, vitest_1.expect)(dap.transfer([{ port: cmsis_dap_js_1.DP, mode: cmsis_dap_js_1.READ, register: 0x00 }])).rejects.toThrow(cmsis_dap_js_1.DapTransferError);
+            // Verify clearAbort was called
+            (0, vitest_1.expect)(transport.written.length).toBe(2);
+            (0, vitest_1.expect)(transport.written[1][0]).toBe(0x08);
+        });
+        (0, vitest_1.it)("throws on completed count mismatch", async () => {
+            const buffer = new Uint8Array(transport_js_1.PACKET_SIZE);
+            const view = new DataView(buffer.buffer);
+            view.setUint8(0, 0x05);
+            view.setUint8(1, 0); // completed 0 but we sent 1
+            view.setUint8(2, 0x01); // TRANSFER_OK
+            transport.responses.push(new DataView(buffer.buffer));
+            transport.queueOk(0x08); // clearAbort
+            await (0, vitest_1.expect)(dap.transfer([{ port: cmsis_dap_js_1.DP, mode: cmsis_dap_js_1.READ, register: 0x00 }])).rejects.toThrow("Transfer count mismatch");
+        });
+    });
+    (0, vitest_1.describe)("transferBlockRead", () => {
+        (0, vitest_1.it)("reads a block of values", async () => {
+            transport.queueBlockReadOk(3, [0x100, 0x200, 0x300]);
+            const result = await dap.transferBlockRead(cmsis_dap_js_1.AP, 0x0c, 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);
+            const sent = transport.written[0];
+            (0, vitest_1.expect)(sent[0]).toBe(0x06); // DAP_TRANSFER_BLOCK
+            // send() prepends command byte, so data[3] (the operation byte) is at sent[4]
+            (0, vitest_1.expect)(sent[4]).toBe(cmsis_dap_js_1.AP | cmsis_dap_js_1.READ | 0x0c);
+        });
+        (0, vitest_1.it)("throws on count exceeding block size", async () => {
+            const maxWords = Math.floor(dap.blockSize / 4);
+            await (0, vitest_1.expect)(dap.transferBlockRead(cmsis_dap_js_1.AP, 0x0c, maxWords + 1)).rejects.toThrow("exceeds max");
+        });
+        (0, vitest_1.it)("throws DapTransferError on WAIT response", async () => {
+            const buffer = new Uint8Array(transport_js_1.PACKET_SIZE);
+            const view = new DataView(buffer.buffer);
+            view.setUint8(0, 0x06);
+            view.setUint16(1, 0, true);
+            view.setUint8(3, 0x02); // TRANSFER_WAIT
+            transport.responses.push(new DataView(buffer.buffer));
+            transport.queueOk(0x08); // clearAbort
+            await (0, vitest_1.expect)(dap.transferBlockRead(cmsis_dap_js_1.AP, 0x0c, 1)).rejects.toThrow(cmsis_dap_js_1.DapTransferError);
+        });
+    });
+    (0, vitest_1.describe)("transferBlockWrite", () => {
+        (0, vitest_1.it)("writes a block of values", async () => {
+            transport.queueBlockWriteOk(2);
+            await dap.transferBlockWrite(cmsis_dap_js_1.AP, 0x0c, new Uint32Array([0xaa, 0xbb]));
+            const sent = transport.written[0];
+            (0, vitest_1.expect)(sent[0]).toBe(0x06); // DAP_TRANSFER_BLOCK
+            const view = new DataView(sent.buffer);
+            // send() prepends command byte, so data offsets shift by 1:
+            // sent[0]=cmd, sent[1]=dap_index, sent[2..3]=count, sent[4]=op, sent[5..]=values
+            (0, vitest_1.expect)(view.getUint16(2, true)).toBe(2); // count
+            (0, vitest_1.expect)(sent[4]).toBe(cmsis_dap_js_1.AP | cmsis_dap_js_1.WRITE | 0x0c); // op byte
+            (0, vitest_1.expect)(view.getUint32(5, true)).toBe(0xaa);
+            (0, vitest_1.expect)(view.getUint32(9, true)).toBe(0xbb);
+        });
+        (0, vitest_1.it)("throws on count exceeding block size", async () => {
+            const maxWords = Math.floor(dap.blockSize / 4);
+            await (0, vitest_1.expect)(dap.transferBlockWrite(cmsis_dap_js_1.AP, 0x0c, new Uint32Array(maxWords + 1))).rejects.toThrow("exceeds max");
+        });
+    });
+    (0, vitest_1.describe)("drainStaleResponses", () => {
+        (0, vitest_1.it)("synchronizes immediately when first response matches", async () => {
+            // DAP_INFO response
+            transport.queueResponse([0x00, 0x03, 0x30, 0x2e, 0x31]);
+            await dap.drainStaleResponses();
+            (0, vitest_1.expect)(transport.written.length).toBe(1);
+            (0, vitest_1.expect)(transport.written[0][0]).toBe(0x00); // DAP_INFO
+        });
+        (0, vitest_1.it)("drains stale responses before synchronizing", async () => {
+            // First read returns stale response (e.g. from a previous DAP_TRANSFER)
+            transport.queueResponse([0x05, 0x01, 0x01]);
+            // Second read returns the DAP_INFO response
+            transport.queueResponse([0x00, 0x03, 0x30, 0x2e, 0x31]);
+            // One extra read to drain the queued DAP_INFO from attempt 0
+            transport.queueResponse([0x00, 0x03, 0x30, 0x2e, 0x31]);
+            await dap.drainStaleResponses();
+            // 2 DAP_INFO writes + 3 reads
+            (0, vitest_1.expect)(transport.write).toHaveBeenCalledTimes(2);
+            (0, vitest_1.expect)(transport.read).toHaveBeenCalledTimes(3);
+        });
+    });
+    (0, vitest_1.describe)("open and close", () => {
+        (0, vitest_1.it)("delegates to transport", async () => {
+            await dap.open();
+            (0, vitest_1.expect)(transport.open).toHaveBeenCalled();
+            (0, vitest_1.expect)(dap.isOpen).toBe(true);
+            await dap.close();
+            (0, vitest_1.expect)(transport.close).toHaveBeenCalled();
+            (0, vitest_1.expect)(dap.isOpen).toBe(false);
+        });
+    });
+    (0, vitest_1.describe)("blockSize", () => {
+        (0, vitest_1.it)("is PACKET_SIZE minus header minus command byte", () => {
+            // PACKET_SIZE (64) - BLOCK_HEADER_SIZE (4) - 1 = 59
+            (0, vitest_1.expect)(dap.blockSize).toBe(59);
+        });
+    });
+});
+//# sourceMappingURL=cmsis-dap.test.js.map

package/build/cjs/usb/cmsis-dap.test.js.map

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

package/build/cjs/usb/connection.d.ts

@@ -0,0 +1,96 @@
+import { BackgroundErrorData, ConnectionStatusChange, DeviceConnection, FlashDataSource, FlashOptions } from "../device.js";
+import { Logging } from "../logging.js";
+import { type SerialData } from "./serial-events.js";
+export declare const DeviceSelectionMode: {
+    /**
+     * Attempts to connect to known device, otherwise asks which device to
+     * connect to.
+     */
+    readonly AlwaysAsk: "AlwaysAsk";
+    /**
+     * Attempts to connect to known device, otherwise attempts to connect to any
+     * allowed devices. If that fails, asks which device to connect to.
+     */
+    readonly UseAnyAllowed: "UseAnyAllowed";
+};
+export type DeviceSelectionMode = (typeof DeviceSelectionMode)[keyof typeof DeviceSelectionMode];
+export interface MicrobitUSBConnectionOptions {
+    /**
+     * Determines logging behaviour for events, errors, and logs.
+     */
+    logging?: Logging;
+    /**
+     * Determines how a device should be selected.
+     */
+    deviceSelectionMode?: DeviceSelectionMode;
+    /**
+     * Whether to automatically pause the USB connection when the browser tab
+     * becomes hidden and reconnect when it becomes visible again.
+     *
+     * When enabled, the connection transitions to PAUSED instead of staying
+     * connected while the tab is hidden. This frees the USB interface for
+     * other tabs or processes.
+     *
+     * @default true
+     */
+    pauseOnHidden?: boolean;
+}
+export interface MicrobitUSBConnection extends DeviceConnection {
+    readonly type: "usb";
+    addEventListener(type: "status", listener: (data: ConnectionStatusChange) => void): void;
+    addEventListener(type: "backgrounderror", listener: (data: BackgroundErrorData) => void): void;
+    addEventListener(type: "beforerequestdevice", listener: () => void): void;
+    addEventListener(type: "afterrequestdevice", listener: () => void): void;
+    addEventListener(type: "flash", listener: () => void): void;
+    addEventListener(type: "serialdata", listener: (data: SerialData) => void): void;
+    addEventListener(type: "serialreset", listener: () => void): void;
+    removeEventListener(type: "status", listener: (data: ConnectionStatusChange) => void): void;
+    removeEventListener(type: "backgrounderror", listener: (data: BackgroundErrorData) => void): void;
+    removeEventListener(type: "beforerequestdevice", listener: () => void): void;
+    removeEventListener(type: "afterrequestdevice", listener: () => void): void;
+    removeEventListener(type: "flash", listener: () => void): void;
+    removeEventListener(type: "serialdata", listener: (data: SerialData) => void): void;
+    removeEventListener(type: "serialreset", listener: () => void): void;
+    /**
+     * Write serial data to the device.
+     *
+     * @param data The data to write.
+     * @returns A promise that resolves when the write is complete.
+     * @throws {DeviceError} with code `not-connected` if there is no connection.
+     */
+    serialWrite(data: string): Promise<void>;
+    /**
+     * Gets micro:bit deviceId.
+     *
+     * Cached after the first successful connection until {@link clearDevice}
+     * is called, so remains available after disconnection.
+     *
+     * @returns the device id.
+     * @throws {DeviceError} with code `not-connected` if no device has been connected.
+     */
+    getDeviceId(): number;
+    /**
+     * Sets device request exclusion filters.
+     */
+    setRequestDeviceExclusionFilters(exclusionFilters: USBDeviceFilter[]): void;
+    flash(dataSource: FlashDataSource, options: FlashOptions): Promise<void>;
+    /**
+     * Gets micro:bit device.
+     *
+     * @returns the USB device or undefined if there is no connection.
+     */
+    getDevice(): USBDevice | undefined;
+    /**
+     * Resets the micro:bit in software.
+     */
+    softwareReset(): Promise<void>;
+}
+/**
+ * A WebUSB connection factory.
+ */
+export declare const createUSBConnection: (options?: MicrobitUSBConnectionOptions) => MicrobitUSBConnection;
+/**
+ * Applying WebUSB device filter. Exported for testing.
+ * Based on: https://wicg.github.io/webusb/#enumeration
+ */
+export declare const applyDeviceFilters: (device: USBDevice, filters: USBDeviceFilter[], exclusionFilters: USBDeviceFilter[]) => boolean;