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

package/build/cjs/usb/daplink.test.js

@@ -0,0 +1,290 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const cmsis_dap_js_1 = require("./cmsis-dap.js");
+const logging_js_1 = require("../logging.js");
+const daplink_js_1 = require("./daplink.js");
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+const logging = new logging_js_1.ConsoleLogging();
+/** Create a DataView response with a command echo and status/length byte. */
+function makeResponse(command, secondByte, extraBytes = []) {
+    const buf = new ArrayBuffer(64);
+    const view = new DataView(buf);
+    view.setUint8(0, command);
+    view.setUint8(1, secondByte);
+    extraBytes.forEach((b, i) => view.setUint8(2 + i, b));
+    return view;
+}
+function createMockDap() {
+    return {
+        isOpen: true,
+        blockSize: 59,
+        send: vitest_1.vi.fn(),
+        clearAbort: vitest_1.vi.fn(),
+        swjSequence: vitest_1.vi.fn(),
+        swjClock: vitest_1.vi.fn(),
+        connect: vitest_1.vi.fn(),
+        disconnect: vitest_1.vi.fn(),
+        configureTransfer: vitest_1.vi.fn(),
+        open: vitest_1.vi.fn(),
+        close: vitest_1.vi.fn(),
+        transfer: vitest_1.vi.fn(),
+        transferBlockRead: vitest_1.vi.fn(),
+        transferBlockWrite: vitest_1.vi.fn(),
+        drainStaleResponses: vitest_1.vi.fn(),
+    };
+}
+function createMockAdi(dap) {
+    return {
+        dap,
+        get isOpen() {
+            return true;
+        },
+        readMem32: vitest_1.vi.fn(),
+        writeMem32: vitest_1.vi.fn(),
+        readMem32Ops: vitest_1.vi.fn(() => []),
+        writeMem32Ops: vitest_1.vi.fn(() => []),
+        readBlock: vitest_1.vi.fn(),
+        writeBlock: vitest_1.vi.fn(),
+        transferSequence: vitest_1.vi.fn(),
+        resetState: vitest_1.vi.fn(),
+        connect: vitest_1.vi.fn(),
+        disconnect: vitest_1.vi.fn(),
+        reinit: vitest_1.vi.fn(),
+    };
+}
+// ---------------------------------------------------------------------------
+// DapLinkSerial
+// ---------------------------------------------------------------------------
+(0, vitest_1.describe)("DapLinkSerial", () => {
+    let dap;
+    let serial;
+    (0, vitest_1.beforeEach)(() => {
+        dap = createMockDap();
+        serial = new daplink_js_1.DapLinkSerial(dap, logging);
+    });
+    (0, vitest_1.describe)("getBaudrate", () => {
+        (0, vitest_1.it)("reads baud rate from READ_SETTINGS response", async () => {
+            const response = new DataView(new ArrayBuffer(64));
+            response.setUint8(0, daplink_js_1.DAPLINK_VENDOR_READ_SETTINGS);
+            response.setUint32(1, 115200, true);
+            vitest_1.vi.mocked(dap.send).mockResolvedValueOnce(response);
+            const baud = await serial.getBaudrate();
+            (0, vitest_1.expect)(baud).toBe(115200);
+            (0, vitest_1.expect)(dap.send).toHaveBeenCalledWith(daplink_js_1.DAPLINK_VENDOR_READ_SETTINGS);
+        });
+    });
+    (0, vitest_1.describe)("setBaudrate", () => {
+        (0, vitest_1.it)("sends baud rate via WRITE_SETTINGS", async () => {
+            vitest_1.vi.mocked(dap.send).mockResolvedValueOnce(new DataView(new ArrayBuffer(64)));
+            await serial.setBaudrate(9600);
+            (0, vitest_1.expect)(dap.send).toHaveBeenCalledWith(daplink_js_1.DAPLINK_VENDOR_WRITE_SETTINGS, vitest_1.expect.any(Uint8Array));
+            const payload = vitest_1.vi.mocked(dap.send).mock.calls[0][1];
+            const sentBaud = new DataView(payload.buffer).getUint32(0, true);
+            (0, vitest_1.expect)(sentBaud).toBe(9600);
+        });
+    });
+    (0, vitest_1.describe)("read", () => {
+        (0, vitest_1.it)("returns decoded string when data is available", async () => {
+            const text = "Hi";
+            const encoded = new TextEncoder().encode(text);
+            const response = new DataView(new ArrayBuffer(64));
+            response.setUint8(0, daplink_js_1.DAPLINK_VENDOR_SERIAL_READ);
+            response.setUint8(1, encoded.length);
+            encoded.forEach((b, i) => response.setUint8(2 + i, b));
+            vitest_1.vi.mocked(dap.send).mockResolvedValueOnce(response);
+            const result = await serial.read();
+            (0, vitest_1.expect)(result).toBe("Hi");
+        });
+        (0, vitest_1.it)("returns undefined when no data", async () => {
+            vitest_1.vi.mocked(dap.send).mockResolvedValueOnce(makeResponse(daplink_js_1.DAPLINK_VENDOR_SERIAL_READ, 0));
+            const result = await serial.read();
+            (0, vitest_1.expect)(result).toBeUndefined();
+        });
+    });
+    (0, vitest_1.describe)("write", () => {
+        (0, vitest_1.it)("sends encoded string with length prefix", async () => {
+            vitest_1.vi.mocked(dap.send).mockResolvedValueOnce(new DataView(new ArrayBuffer(64)));
+            await serial.write("AB");
+            (0, vitest_1.expect)(dap.send).toHaveBeenCalledWith(daplink_js_1.DAPLINK_VENDOR_SERIAL_WRITE, vitest_1.expect.any(Uint8Array));
+            const payload = vitest_1.vi.mocked(dap.send).mock.calls[0][1];
+            (0, vitest_1.expect)(payload[0]).toBe(2); // length
+            (0, vitest_1.expect)(payload[1]).toBe(0x41); // 'A'
+            (0, vitest_1.expect)(payload[2]).toBe(0x42); // 'B'
+        });
+    });
+    (0, vitest_1.describe)("drain", () => {
+        (0, vitest_1.it)("reads until empty", async () => {
+            // Two reads with data, then one empty
+            const text = new TextEncoder().encode("x");
+            const withData = new DataView(new ArrayBuffer(64));
+            withData.setUint8(1, 1);
+            withData.setUint8(2, text[0]);
+            vitest_1.vi.mocked(dap.send)
+                .mockResolvedValueOnce(withData)
+                .mockResolvedValueOnce(withData)
+                .mockResolvedValueOnce(makeResponse(0, 0)); // empty
+            await serial.drain();
+            (0, vitest_1.expect)(dap.send).toHaveBeenCalledTimes(3);
+        });
+        (0, vitest_1.it)("does nothing when already empty", async () => {
+            vitest_1.vi.mocked(dap.send).mockResolvedValueOnce(makeResponse(0, 0));
+            await serial.drain();
+            (0, vitest_1.expect)(dap.send).toHaveBeenCalledTimes(1);
+        });
+    });
+    (0, vitest_1.describe)("startPolling / stopPolling", () => {
+        (0, vitest_1.it)("calls onData for each read and stops when requested", async () => {
+            const received = [];
+            let callCount = 0;
+            vitest_1.vi.mocked(dap.send).mockImplementation(async () => {
+                callCount++;
+                if (callCount <= 2) {
+                    const resp = new DataView(new ArrayBuffer(64));
+                    resp.setUint8(1, 1);
+                    resp.setUint8(2, 0x41 + callCount - 1); // 'A', 'B'
+                    return resp;
+                }
+                // After 2 data reads, stop polling
+                serial.stopPolling();
+                return makeResponse(0, 0);
+            });
+            await serial.startPolling((data) => received.push(data), 0);
+            (0, vitest_1.expect)(received).toEqual(["A", "B"]);
+        });
+    });
+});
+// ---------------------------------------------------------------------------
+// dapLinkFlash
+// ---------------------------------------------------------------------------
+(0, vitest_1.describe)("dapLinkFlash", () => {
+    let dap;
+    let adi;
+    (0, vitest_1.beforeEach)(() => {
+        dap = createMockDap();
+        adi = createMockAdi(dap);
+    });
+    (0, vitest_1.it)("streams hex data in 62-byte pages", async () => {
+        // 124 bytes = 2 full pages
+        const buffer = new Uint8Array(124);
+        buffer.fill(0x3a); // ':' characters (Intel HEX)
+        vitest_1.vi.mocked(dap.send)
+            // FLASH_OPEN → success
+            .mockResolvedValueOnce(makeResponse(daplink_js_1.DAPLINK_VENDOR_FLASH_OPEN, 0))
+            // FLASH_WRITE page 1 → success
+            .mockResolvedValueOnce(makeResponse(daplink_js_1.DAPLINK_VENDOR_FLASH_WRITE, 0))
+            // FLASH_WRITE page 2 → success
+            .mockResolvedValueOnce(makeResponse(daplink_js_1.DAPLINK_VENDOR_FLASH_WRITE, 0))
+            // FLASH_CLOSE → success
+            .mockResolvedValueOnce(makeResponse(daplink_js_1.DAPLINK_VENDOR_FLASH_CLOSE, 0))
+            // FLASH_RESET
+            .mockResolvedValueOnce(makeResponse(daplink_js_1.DAPLINK_VENDOR_FLASH_RESET, 0));
+        const progress = vitest_1.vi.fn();
+        await (0, daplink_js_1.dapLinkFlash)(adi, buffer, progress);
+        // OPEN + 2 WRITE + CLOSE + RESET = 5 sends
+        (0, vitest_1.expect)(dap.send).toHaveBeenCalledTimes(5);
+        // Progress called for each page + final 1.0
+        (0, vitest_1.expect)(progress).toHaveBeenCalledWith(1.0);
+        // resetState called in finally
+        (0, vitest_1.expect)(adi.resetState).toHaveBeenCalled();
+    });
+    (0, vitest_1.it)("stops early on ERROR_SUCCESS_DONE", async () => {
+        const buffer = new Uint8Array(124);
+        vitest_1.vi.mocked(dap.send)
+            .mockResolvedValueOnce(makeResponse(daplink_js_1.DAPLINK_VENDOR_FLASH_OPEN, 0))
+            // First page returns DONE (18)
+            .mockResolvedValueOnce(makeResponse(daplink_js_1.DAPLINK_VENDOR_FLASH_WRITE, 18))
+            .mockResolvedValueOnce(makeResponse(daplink_js_1.DAPLINK_VENDOR_FLASH_CLOSE, 0))
+            .mockResolvedValueOnce(makeResponse(daplink_js_1.DAPLINK_VENDOR_FLASH_RESET, 0));
+        await (0, daplink_js_1.dapLinkFlash)(adi, buffer);
+        // Only 1 write (stopped at DONE), then CLOSE + RESET
+        (0, vitest_1.expect)(dap.send).toHaveBeenCalledTimes(4);
+    });
+    (0, vitest_1.it)("throws on FLASH_OPEN error", async () => {
+        vitest_1.vi.mocked(dap.send).mockResolvedValueOnce(makeResponse(daplink_js_1.DAPLINK_VENDOR_FLASH_OPEN, 5));
+        await (0, vitest_1.expect)((0, daplink_js_1.dapLinkFlash)(adi, new Uint8Array(10))).rejects.toThrow("Flash open error");
+        // The throw happens before the try/finally block, so resetState is not called.
+        (0, vitest_1.expect)(adi.resetState).not.toHaveBeenCalled();
+    });
+    (0, vitest_1.it)("throws on FLASH_CLOSE error and attempts cleanup", async () => {
+        const buffer = new Uint8Array(10);
+        vitest_1.vi.mocked(dap.send)
+            .mockResolvedValueOnce(makeResponse(daplink_js_1.DAPLINK_VENDOR_FLASH_OPEN, 0))
+            .mockResolvedValueOnce(makeResponse(daplink_js_1.DAPLINK_VENDOR_FLASH_WRITE, 0))
+            // FLASH_CLOSE returns error
+            .mockResolvedValueOnce(makeResponse(daplink_js_1.DAPLINK_VENDOR_FLASH_CLOSE, 7))
+            // Cleanup FLASH_CLOSE in catch
+            .mockResolvedValueOnce(makeResponse(daplink_js_1.DAPLINK_VENDOR_FLASH_CLOSE, 0));
+        await (0, vitest_1.expect)((0, daplink_js_1.dapLinkFlash)(adi, buffer)).rejects.toThrow("Flash close error");
+        (0, vitest_1.expect)(adi.resetState).toHaveBeenCalled();
+    });
+});
+// ---------------------------------------------------------------------------
+// readDaplinkUniqueId
+// ---------------------------------------------------------------------------
+(0, vitest_1.describe)("readDaplinkUniqueId", () => {
+    let dap;
+    (0, vitest_1.beforeEach)(() => {
+        dap = createMockDap();
+    });
+    (0, vitest_1.it)("returns the unique ID string", async () => {
+        const id = "9900012345678901234567890123456789012345678901234";
+        const encoded = new TextEncoder().encode(id);
+        const response = new DataView(new ArrayBuffer(64));
+        response.setUint8(0, daplink_js_1.DAPLINK_VENDOR_READ_UNIQUE_ID);
+        response.setUint8(1, encoded.length);
+        encoded.forEach((b, i) => response.setUint8(2 + i, b));
+        vitest_1.vi.mocked(dap.send).mockResolvedValueOnce(response);
+        const result = await (0, daplink_js_1.readDaplinkUniqueId)(dap, logging);
+        (0, vitest_1.expect)(result).toBe(id);
+    });
+    (0, vitest_1.it)("returns undefined for zero-length response", async () => {
+        vitest_1.vi.mocked(dap.send).mockResolvedValueOnce(makeResponse(daplink_js_1.DAPLINK_VENDOR_READ_UNIQUE_ID, 0));
+        const result = await (0, daplink_js_1.readDaplinkUniqueId)(dap, logging);
+        (0, vitest_1.expect)(result).toBeUndefined();
+    });
+    (0, vitest_1.it)("returns undefined on error", async () => {
+        vitest_1.vi.mocked(dap.send).mockRejectedValueOnce(new Error("USB gone"));
+        const result = await (0, daplink_js_1.readDaplinkUniqueId)(dap, logging);
+        (0, vitest_1.expect)(result).toBeUndefined();
+    });
+});
+// ---------------------------------------------------------------------------
+// readMem32WithRetry
+// ---------------------------------------------------------------------------
+(0, vitest_1.describe)("readMem32WithRetry", () => {
+    let dap;
+    let adi;
+    (0, vitest_1.beforeEach)(() => {
+        dap = createMockDap();
+        adi = createMockAdi(dap);
+    });
+    (0, vitest_1.it)("returns value on first success", async () => {
+        vitest_1.vi.mocked(adi.readMem32).mockResolvedValueOnce(0xdeadbeef);
+        const value = await (0, daplink_js_1.readMem32WithRetry)(adi, 0x10000010, logging);
+        (0, vitest_1.expect)(value).toBe(0xdeadbeef);
+        (0, vitest_1.expect)(adi.readMem32).toHaveBeenCalledTimes(1);
+    });
+    (0, vitest_1.it)("retries on DapTransferError", async () => {
+        vitest_1.vi.mocked(adi.readMem32)
+            .mockRejectedValueOnce(new cmsis_dap_js_1.DapTransferError(0x04, 0, 1))
+            .mockRejectedValueOnce(new cmsis_dap_js_1.DapTransferError(0x04, 0, 1))
+            .mockResolvedValueOnce(0x42);
+        const value = await (0, daplink_js_1.readMem32WithRetry)(adi, 0x10000010, logging, 5, 0);
+        (0, vitest_1.expect)(value).toBe(0x42);
+        (0, vitest_1.expect)(adi.readMem32).toHaveBeenCalledTimes(3);
+    });
+    (0, vitest_1.it)("throws non-transfer errors immediately", async () => {
+        vitest_1.vi.mocked(adi.readMem32).mockRejectedValueOnce(new Error("USB gone"));
+        await (0, vitest_1.expect)((0, daplink_js_1.readMem32WithRetry)(adi, 0x10000010, logging, 5, 0)).rejects.toThrow("USB gone");
+        (0, vitest_1.expect)(adi.readMem32).toHaveBeenCalledTimes(1);
+    });
+    (0, vitest_1.it)("throws after exhausting retries", async () => {
+        vitest_1.vi.mocked(adi.readMem32).mockRejectedValue(new cmsis_dap_js_1.DapTransferError(0x04, 0, 1));
+        await (0, vitest_1.expect)((0, daplink_js_1.readMem32WithRetry)(adi, 0x10000010, logging, 3, 0)).rejects.toThrow(cmsis_dap_js_1.DapTransferError);
+        (0, vitest_1.expect)(adi.readMem32).toHaveBeenCalledTimes(3);
+    });
+});
+//# sourceMappingURL=daplink.test.js.map

package/build/cjs/usb/daplink.test.js.map

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

package/build/cjs/usb/device-wrapper.d.ts

@@ -0,0 +1,34 @@
+/**
+ * (c) 2021, Micro:bit Educational Foundation and contributors
+ *
+ * SPDX-License-Identifier: MIT
+ */
+import { BoardSerialInfo } from "./board-serial-info.js";
+import { Logging } from "../logging.js";
+import { ArmDebugSwd } from "./arm-debug.js";
+import { CortexM } from "./cortex-m.js";
+import { DapLinkSerial } from "./daplink.js";
+export interface BoardConnectionInfo {
+    boardSerialInfo: BoardSerialInfo;
+    deviceId: number;
+    pageSize: number;
+    numPages: number;
+}
+export declare class USBDeviceWrapper {
+    readonly usbDevice: USBDevice;
+    private logging;
+    adi: ArmDebugSwd;
+    cortexM: CortexM;
+    serial: DapLinkSerial;
+    private initialConnectionComplete;
+    constructor(usbDevice: USBDevice, logging: Logging);
+    reconnect(): Promise<BoardConnectionInfo>;
+    /**
+     * Read the board serial info, preferring the DAPLink vendor command.
+     * Chrome may anonymize USBDevice.serialNumber for anti-fingerprinting
+     * (https://github.com/microbit-foundation/microbit-connection/issues/57)
+     * so we read it via the DAP protocol instead.
+     */
+    private readBoardSerialInfo;
+    disconnect(): Promise<void>;
+}

package/build/cjs/usb/device-wrapper.js

@@ -0,0 +1,102 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.USBDeviceWrapper = void 0;
+/**
+ * (c) 2021, Micro:bit Educational Foundation and contributors
+ *
+ * SPDX-License-Identifier: MIT
+ */
+const board_serial_info_js_1 = require("./board-serial-info.js");
+const arm_debug_js_1 = require("./arm-debug.js");
+const cmsis_dap_js_1 = require("./cmsis-dap.js");
+const cortex_m_js_1 = require("./cortex-m.js");
+const daplink_js_1 = require("./daplink.js");
+const transport_js_1 = require("./transport.js");
+// FICR Registers (Nordic nRF SoC Factory Information Configuration)
+// https://docs.nordicsemi.com/bundle/ps_nrf52833/page/ficr.html
+const FICR_CODEPAGESIZE = 0x10000010;
+const FICR_CODESIZE = 0x10000014;
+const FICR_DEVICE_ID_1 = 0x10000064;
+class USBDeviceWrapper {
+    constructor(usbDevice, logging) {
+        Object.defineProperty(this, "usbDevice", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: usbDevice
+        });
+        Object.defineProperty(this, "logging", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: logging
+        });
+        Object.defineProperty(this, "adi", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "cortexM", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "serial", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "initialConnectionComplete", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: false
+        });
+        const cmsisDap = new cmsis_dap_js_1.CmsisDapUsb(new transport_js_1.UsbTransport(this.usbDevice), this.logging);
+        this.adi = new arm_debug_js_1.ArmDebugSwd(cmsisDap, this.logging);
+        this.cortexM = new cortex_m_js_1.CortexM(this.adi);
+        this.serial = new daplink_js_1.DapLinkSerial(cmsisDap, this.logging);
+    }
+    // Drawn from https://github.com/microsoft/pxt-microbit/blob/dec5b8ce72d5c2b4b0b20aafefce7474a6f0c7b2/editor/extension.tsx#L119
+    async reconnect() {
+        if (this.initialConnectionComplete) {
+            await this.disconnect();
+        }
+        else {
+            this.initialConnectionComplete = true;
+        }
+        await this.adi.connect();
+        const boardSerialInfo = await this.readBoardSerialInfo();
+        this.logging.log(`Detected board ID ${boardSerialInfo.id}`);
+        // https://support.microbit.org/support/solutions/articles/19000067679-how-to-find-the-name-of-your-micro-bit
+        // We retry on errors as immediately after flash the micro:bit won't be ready to respond
+        const deviceId = await (0, daplink_js_1.readMem32WithRetry)(this.adi, FICR_DEVICE_ID_1, this.logging);
+        const pageSize = await (0, daplink_js_1.readMem32WithRetry)(this.adi, FICR_CODEPAGESIZE, this.logging);
+        const numPages = await (0, daplink_js_1.readMem32WithRetry)(this.adi, FICR_CODESIZE, this.logging);
+        return { boardSerialInfo, deviceId, pageSize, numPages };
+    }
+    /**
+     * Read the board serial info, preferring the DAPLink vendor command.
+     * Chrome may anonymize USBDevice.serialNumber for anti-fingerprinting
+     * (https://github.com/microbit-foundation/microbit-connection/issues/57)
+     * so we read it via the DAP protocol instead.
+     */
+    async readBoardSerialInfo() {
+        const dapSerial = await (0, daplink_js_1.readDaplinkUniqueId)(this.adi.dap, this.logging);
+        if (dapSerial) {
+            return board_serial_info_js_1.BoardSerialInfo.fromSerial(dapSerial, this.logging.log.bind(this.logging));
+        }
+        this.logging.log("Failed to read unique ID via DAP vendor command, falling back to USB serial number (may be affected by anti-fingerprinting)");
+        return board_serial_info_js_1.BoardSerialInfo.parse(this.usbDevice, this.logging.log.bind(this.logging));
+    }
+    async disconnect() {
+        if (this.usbDevice.opened && this.adi.isOpen) {
+            return this.adi.disconnect();
+        }
+    }
+}
+exports.USBDeviceWrapper = USBDeviceWrapper;
+//# sourceMappingURL=device-wrapper.js.map

package/build/cjs/usb/device-wrapper.js.map

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

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

@@ -0,0 +1,5 @@
+/**
+ * @module @microbit/microbit-connection/usb
+ */
+export { createUSBConnection, DeviceSelectionMode, type MicrobitUSBConnection, type MicrobitUSBConnectionOptions, } from "./connection.js";
+export type { SerialConnectionEventMap, SerialData, SerialErrorData, } from "./serial-events.js";

package/build/cjs/usb/index.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DeviceSelectionMode = exports.createUSBConnection = void 0;
+/**
+ * @module @microbit/microbit-connection/usb
+ */
+var connection_js_1 = require("./connection.js");
+Object.defineProperty(exports, "createUSBConnection", { enumerable: true, get: function () { return connection_js_1.createUSBConnection; } });
+Object.defineProperty(exports, "DeviceSelectionMode", { enumerable: true, get: function () { return connection_js_1.DeviceSelectionMode; } });
+//# sourceMappingURL=index.js.map

package/build/cjs/usb/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/usb/index.ts"],"names":[],"mappings":";;;AAAA;;GAEG;AACH,iDAKyB;AAJvB,oHAAA,mBAAmB,OAAA;AACnB,oHAAA,mBAAmB,OAAA"}

package/build/{esm/usb-partial-flashing-utils.d.ts → cjs/usb/partial-flashing-utils.d.ts}

@@ -1,17 +1,14 @@
-export declare const CoreRegister: {
-    SP: number;
-    LR: number;
-    PC: number;
-};
+/**
+ * (c) 2021, Micro:bit Educational Foundation and contributors
+ *
+ * SPDX-License-Identifier: MIT
+ */
 export declare const read32FromUInt8Array: (data: Uint8Array, i: number) => number;
-export declare const bufferConcat: (bufs: Uint8Array[]) => Uint8Array;
 export declare const murmur3_core: (data: Uint8Array) => [number, number];
-export declare const apReg: (r: number, mode: number) => number;
-export declare const regRequest: (regId: number, isWrite?: boolean) => number;
 export declare class Page {
     readonly targetAddr: number;
     readonly data: Uint8Array;
     constructor(targetAddr: number, data: Uint8Array);
 }
 export declare const pageAlignBlocks: (buffer: Uint8Array, targetAddr: number, pageSize: number) => Page[];
-export declare const onlyChanged: (pages: Page[], checksums: Uint8Array, pageSize: number) => Page[];
+export declare const onlyChanged: (pages: Page[], checksums: Uint32Array, pageSize: number) => Page[];

package/build/cjs/{usb-partial-flashing-utils.js → usb/partial-flashing-utils.js}

@@ -1,19 +1,11 @@
 "use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.onlyChanged = exports.pageAlignBlocks = exports.Page = exports.regRequest = exports.apReg = exports.murmur3_core = exports.bufferConcat = exports.read32FromUInt8Array = exports.CoreRegister = void 0;
 /**
  * (c) 2021, Micro:bit Educational Foundation and contributors
  *
  * SPDX-License-Identifier: MIT
  */
-const constants_js_1 = require("./constants.js");
-// Represents the micro:bit's core registers
-// Drawn from https://armmbed.github.io/dapjs/docs/enums/coreregister.html
-exports.CoreRegister = {
-    SP: 13,
-    LR: 14,
-    PC: 15,
-};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.onlyChanged = exports.pageAlignBlocks = exports.Page = exports.murmur3_core = exports.read32FromUInt8Array = void 0;
 const read32FromUInt8Array = (data, i) => {
     return ((data[i] |
         (data[i + 1] << 8) |
@@ -22,20 +14,6 @@ const read32FromUInt8Array = (data, i) => {
         0);
 };
 exports.read32FromUInt8Array = read32FromUInt8Array;
-const bufferConcat = (bufs) => {
-    let len = 0;
-    for (const b of bufs) {
-        len += b.length;
-    }
-    const r = new Uint8Array(len);
-    len = 0;
-    for (const b of bufs) {
-        r.set(b, len);
-        len += b.length;
-    }
-    return r;
-};
-exports.bufferConcat = bufferConcat;
 // Returns the MurmurHash of the data passed to it, used for checksum calculation.
 // Drawn from https://github.com/microsoft/pxt-microbit/blob/dec5b8ce72d5c2b4b0b20aafefce7474a6f0c7b2/editor/extension.tsx#L14
 const murmur3_core = (data) => {
@@ -56,27 +34,6 @@ const murmur3_core = (data) => {
     return [h0, h1];
 };
 exports.murmur3_core = murmur3_core;
-// Returns a representation of an Access Port Register.
-// Drawn from https://github.com/mmoskal/dapjs/blob/a32f11f54e9e76a9c61896ddd425c1cb1a29c143/src/util.ts#L63
-const apReg = (r, mode) => {
-    const v = r | mode | constants_js_1.DapVal.AP_ACC;
-    return 4 + ((v & 0x0c) >> 2);
-};
-exports.apReg = apReg;
-// Returns a code representing a request to read/write a certain register.
-// Drawn from https://github.com/mmoskal/dapjs/blob/a32f11f54e9e76a9c61896ddd425c1cb1a29c143/src/util.ts#L92
-const regRequest = (regId, isWrite = false) => {
-    let request = !isWrite ? 1 << 1 /* READ */ : 0 << 1; /* WRITE */
-    if (regId < 4) {
-        request |= 0 << 0 /* DP_ACC */;
-    }
-    else {
-        request |= 1 << 0 /* AP_ACC */;
-    }
-    request |= (regId & 3) << 2;
-    return request;
-};
-exports.regRequest = regRequest;
 class Page {
     constructor(targetAddr, data) {
         Object.defineProperty(this, "targetAddr", {
@@ -119,10 +76,10 @@ exports.pageAlignBlocks = pageAlignBlocks;
 const onlyChanged = (pages, checksums, pageSize) => {
     return pages.filter((page) => {
         let idx = page.targetAddr / pageSize;
-        if (idx * 8 + 8 > checksums.length)
+        if (idx * 2 + 2 > checksums.length)
             return true; // out of range?
-        let c0 = (0, exports.read32FromUInt8Array)(checksums, idx * 8);
-        let c1 = (0, exports.read32FromUInt8Array)(checksums, idx * 8 + 4);
+        let c0 = checksums[idx * 2];
+        let c1 = checksums[idx * 2 + 1];
         let ch = (0, exports.murmur3_core)(page.data);
         if (c0 === ch[0] && c1 === ch[1])
             return false;
@@ -130,4 +87,4 @@ const onlyChanged = (pages, checksums, pageSize) => {
     });
 };
 exports.onlyChanged = onlyChanged;
-//# sourceMappingURL=usb-partial-flashing-utils.js.map
+//# sourceMappingURL=partial-flashing-utils.js.map

package/build/cjs/usb/partial-flashing-utils.js.map

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

package/build/{esm/usb-partial-flashing.d.ts → cjs/usb/partial-flashing.d.ts}

@@ -37,20 +37,28 @@
  * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
  * SOFTWARE.
  */
-import { Logging } from "./logging.js";
-import { DAPWrapper } from "./usb-device-wrapper.js";
-import { BoardVersion, ProgressCallback } from "./device.js";
+/**
+ * Implementation of partial flashing for the micro:bit.
+ *
+ * Latest Microsoft implementation is here:
+ * https://github.com/microsoft/pxt-microbit/blob/master/editor/flash.ts
+ */
+import { Logging } from "../logging.js";
+import { BoardVersion, ProgressCallback } from "../device.js";
 import MemoryMap from "nrf-intel-hex";
+import { USBDeviceWrapper } from "./device-wrapper.js";
 /**
- * Uses a DAPWrapper to flash the micro:bit.
+ * Uses a USBDeviceWrapper to flash the micro:bit.
  *
- * Intented to be used for a single flash with a pre-connected DAPWrapper.
+ * Intended to be used for a single flash with a pre-connected USBDeviceWrapper.
  */
 export declare class PartialFlashing {
-    private dapwrapper;
+    private device;
     private logging;
     private boardVersion;
-    constructor(dapwrapper: DAPWrapper, logging: Logging, boardVersion: BoardVersion);
+    private pageSize;
+    private numPages;
+    constructor(device: USBDeviceWrapper, logging: Logging, boardVersion: BoardVersion, pageSize: number, numPages: number);
     private log;
     private getFlashChecksumsAsync;
     private runFlash;