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

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

@@ -0,0 +1,348 @@
+import { describe, it, expect, vi, beforeEach } from "vitest";
+import { PACKET_SIZE } from "./transport.js";
+import { CmsisDapUsb, DapError, DapResponseMismatchError, DapTransferError, DP, AP, READ, WRITE, } from "./cmsis-dap.js";
+import { ConsoleLogging } from "../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: vi.fn(async () => {
+                this.isOpen = true;
+            })
+        });
+        Object.defineProperty(this, "close", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: vi.fn(async () => {
+                this.isOpen = false;
+            })
+        });
+        Object.defineProperty(this, "write", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: vi.fn(async (data) => {
+                this.written.push(new Uint8Array(data));
+            })
+        });
+        Object.defineProperty(this, "read", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: 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(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(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(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(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 ConsoleLogging();
+describe("CmsisDapUsb", () => {
+    let transport;
+    let dap;
+    beforeEach(() => {
+        transport = new MockTransport();
+        dap = new CmsisDapUsb(transport, logging);
+    });
+    describe("send", () => {
+        it("frames command with no data", async () => {
+            transport.queueOk(0x03); // DAP_DISCONNECT
+            await dap.send(0x03);
+            expect(transport.written.length).toBe(1);
+            expect(transport.written[0][0]).toBe(0x03);
+        });
+        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];
+            expect(sent[0]).toBe(0x11);
+            expect(sent[1]).toBe(0x01);
+            expect(sent[2]).toBe(0x02);
+        });
+        it("throws DapResponseMismatchError on wrong response command", async () => {
+            transport.queueResponse([0xff]); // wrong command byte
+            await expect(dap.send(0x03)).rejects.toThrow(DapResponseMismatchError);
+        });
+        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 expect(dap.send(0x03)).rejects.toThrow(DapError);
+        });
+        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);
+            expect(result.getUint8(0)).toBe(0x02);
+        });
+    });
+    describe("connect", () => {
+        it("sends DAP_CONNECT and succeeds with non-zero port", async () => {
+            transport.queueResponse([0x02, 0x01]); // SWD port
+            await dap.connect();
+            expect(transport.written[0][0]).toBe(0x02);
+        });
+        it("throws on DAP_CONNECT_FAILED (port 0)", async () => {
+            transport.queueResponse([0x02, 0x00]);
+            await expect(dap.connect()).rejects.toThrow("Mode not enabled");
+        });
+    });
+    describe("swjClock", () => {
+        it("sends frequency as little-endian uint32", async () => {
+            transport.queueOk(0x11);
+            await dap.swjClock(10_000_000);
+            const sent = transport.written[0];
+            expect(sent[0]).toBe(0x11);
+            const freq = new DataView(sent.buffer).getUint32(1, true);
+            expect(freq).toBe(10_000_000);
+        });
+    });
+    describe("swjSequence", () => {
+        it("prepends bit length to data", async () => {
+            transport.queueOk(0x12);
+            await dap.swjSequence(new Uint8Array([0xff, 0xff]));
+            const sent = transport.written[0];
+            expect(sent[0]).toBe(0x12);
+            expect(sent[1]).toBe(16); // 2 bytes * 8 bits
+            expect(sent[2]).toBe(0xff);
+            expect(sent[3]).toBe(0xff);
+        });
+    });
+    describe("configureTransfer", () => {
+        it("sends idle cycles, wait retry, and match retry", async () => {
+            transport.queueOk(0x04);
+            await dap.configureTransfer(0, 100, 0);
+            const sent = transport.written[0];
+            expect(sent[0]).toBe(0x04);
+            expect(sent[1]).toBe(0); // idle cycles
+            const view = new DataView(sent.buffer);
+            expect(view.getUint16(2, true)).toBe(100); // wait retry
+            expect(view.getUint16(4, true)).toBe(0); // match retry
+        });
+    });
+    describe("transfer", () => {
+        it("returns empty array for empty operations", async () => {
+            const result = await dap.transfer([]);
+            expect(result.length).toBe(0);
+            expect(transport.written.length).toBe(0);
+        });
+        it("frames a single write operation", async () => {
+            transport.queueTransferOk(1);
+            await dap.transfer([
+                { port: DP, mode: WRITE, register: 0x04, value: 0x12345678 },
+            ]);
+            const sent = transport.written[0];
+            expect(sent[0]).toBe(0x05); // DAP_TRANSFER
+            expect(sent[1]).toBe(0x00); // DAP index
+            expect(sent[2]).toBe(1); // op count
+            // Operation byte: port | mode | register
+            expect(sent[3]).toBe(DP | WRITE | 0x04);
+            const view = new DataView(sent.buffer);
+            expect(view.getUint32(4, true)).toBe(0x12345678);
+        });
+        it("returns read values", async () => {
+            transport.queueTransferOk(1, [0xdeadbeef]);
+            const result = await dap.transfer([
+                { port: AP, mode: READ, register: 0x0c },
+            ]);
+            expect(result.length).toBe(1);
+            expect(result[0]).toBe(0xdeadbeef);
+        });
+        it("handles mixed read/write and returns only read values", async () => {
+            transport.queueTransferOk(3, [0xaabbccdd, 0x11223344]);
+            const result = await dap.transfer([
+                { port: DP, mode: WRITE, register: 0x08, value: 0 },
+                { port: AP, mode: READ, register: 0x00 },
+                { port: AP, mode: READ, register: 0x0c },
+            ]);
+            expect(result.length).toBe(2);
+            expect(result[0]).toBe(0xaabbccdd);
+            expect(result[1]).toBe(0x11223344);
+        });
+        it("throws DapTransferError on FAULT response and clears abort", async () => {
+            // Transfer response: FAULT
+            const buffer = new Uint8Array(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 expect(dap.transfer([{ port: DP, mode: READ, register: 0x00 }])).rejects.toThrow(DapTransferError);
+            // Verify clearAbort was called
+            expect(transport.written.length).toBe(2);
+            expect(transport.written[1][0]).toBe(0x08);
+        });
+        it("throws on completed count mismatch", async () => {
+            const buffer = new Uint8Array(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 expect(dap.transfer([{ port: DP, mode: READ, register: 0x00 }])).rejects.toThrow("Transfer count mismatch");
+        });
+    });
+    describe("transferBlockRead", () => {
+        it("reads a block of values", async () => {
+            transport.queueBlockReadOk(3, [0x100, 0x200, 0x300]);
+            const result = await dap.transferBlockRead(AP, 0x0c, 3);
+            expect(result.length).toBe(3);
+            expect(result[0]).toBe(0x100);
+            expect(result[1]).toBe(0x200);
+            expect(result[2]).toBe(0x300);
+            const sent = transport.written[0];
+            expect(sent[0]).toBe(0x06); // DAP_TRANSFER_BLOCK
+            // send() prepends command byte, so data[3] (the operation byte) is at sent[4]
+            expect(sent[4]).toBe(AP | READ | 0x0c);
+        });
+        it("throws on count exceeding block size", async () => {
+            const maxWords = Math.floor(dap.blockSize / 4);
+            await expect(dap.transferBlockRead(AP, 0x0c, maxWords + 1)).rejects.toThrow("exceeds max");
+        });
+        it("throws DapTransferError on WAIT response", async () => {
+            const buffer = new Uint8Array(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 expect(dap.transferBlockRead(AP, 0x0c, 1)).rejects.toThrow(DapTransferError);
+        });
+    });
+    describe("transferBlockWrite", () => {
+        it("writes a block of values", async () => {
+            transport.queueBlockWriteOk(2);
+            await dap.transferBlockWrite(AP, 0x0c, new Uint32Array([0xaa, 0xbb]));
+            const sent = transport.written[0];
+            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
+            expect(view.getUint16(2, true)).toBe(2); // count
+            expect(sent[4]).toBe(AP | WRITE | 0x0c); // op byte
+            expect(view.getUint32(5, true)).toBe(0xaa);
+            expect(view.getUint32(9, true)).toBe(0xbb);
+        });
+        it("throws on count exceeding block size", async () => {
+            const maxWords = Math.floor(dap.blockSize / 4);
+            await expect(dap.transferBlockWrite(AP, 0x0c, new Uint32Array(maxWords + 1))).rejects.toThrow("exceeds max");
+        });
+    });
+    describe("drainStaleResponses", () => {
+        it("synchronizes immediately when first response matches", async () => {
+            // DAP_INFO response
+            transport.queueResponse([0x00, 0x03, 0x30, 0x2e, 0x31]);
+            await dap.drainStaleResponses();
+            expect(transport.written.length).toBe(1);
+            expect(transport.written[0][0]).toBe(0x00); // DAP_INFO
+        });
+        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
+            expect(transport.write).toHaveBeenCalledTimes(2);
+            expect(transport.read).toHaveBeenCalledTimes(3);
+        });
+    });
+    describe("open and close", () => {
+        it("delegates to transport", async () => {
+            await dap.open();
+            expect(transport.open).toHaveBeenCalled();
+            expect(dap.isOpen).toBe(true);
+            await dap.close();
+            expect(transport.close).toHaveBeenCalled();
+            expect(dap.isOpen).toBe(false);
+        });
+    });
+    describe("blockSize", () => {
+        it("is PACKET_SIZE minus header minus command byte", () => {
+            // PACKET_SIZE (64) - BLOCK_HEADER_SIZE (4) - 1 = 59
+            expect(dap.blockSize).toBe(59);
+        });
+    });
+});
+//# sourceMappingURL=cmsis-dap.test.js.map

package/build/esm/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/esm/usb/connection.d.ts

@@ -0,0 +1,81 @@
+import { DeviceConnection, FlashDataSource, FlashOptions } from "../device.js";
+import { Logging } from "../logging.js";
+import { SerialConnectionEventMap } 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<SerialConnectionEventMap> {
+    /**
+     * 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;