@microbit/microbit-connection 0.0.0-alpha.1

package/build/hex-flash-data-source.js

@@ -0,0 +1,50 @@
+import { FlashDataError as FlashDataError } from "./device";
+import { isUniversalHex, separateUniversalHex, } from "@microbit/microbit-universal-hex";
+// I think we'd end up with two independently bundled copies of this for clients who also depend on microbit-fs.
+import MemoryMap from "nrf-intel-hex";
+export class HexFlashDataSource {
+    constructor(hex) {
+        Object.defineProperty(this, "hex", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: hex
+        });
+    }
+    partialFlashData(boardId) {
+        // Perhaps this would make more sense if we returned a MemoryMap?
+        // Then the partial flashing code could be given everything including UICR without
+        // passing a very large Uint8Array.
+        // Or use MM inside PF and return a (partial) hex string in the microbit-fs case?
+        const part = this.matchingPart(boardId);
+        const hex = MemoryMap.fromHex(part);
+        const keys = Array.from(hex.keys()).filter((k) => k < 0x10000000);
+        const lastKey = keys[keys.length - 1];
+        if (lastKey === undefined) {
+            throw new FlashDataError("Empty hex");
+        }
+        const lastPart = hex.get(lastKey);
+        if (!lastPart) {
+            throw new FlashDataError("Empty hex");
+        }
+        const length = lastKey + lastPart.length;
+        const data = hex.slicePad(0, length, 0);
+        return Promise.resolve(data);
+    }
+    fullFlashData(boardId) {
+        const part = this.matchingPart(boardId);
+        return Promise.resolve(part);
+    }
+    matchingPart(boardId) {
+        if (isUniversalHex(this.hex)) {
+            const parts = separateUniversalHex(this.hex);
+            const matching = parts.find((p) => p.boardId == boardId.normalize().id);
+            if (!matching) {
+                throw new FlashDataError("No matching part");
+            }
+            return matching.hex;
+        }
+        return this.hex;
+    }
+}
+//# sourceMappingURL=hex-flash-data-source.js.map

package/build/hex-flash-data-source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hex-flash-data-source.js","sourceRoot":"","sources":["../lib/hex-flash-data-source.ts"],"names":[],"mappings":"AACA,OAAO,EAAmB,cAAc,IAAI,cAAc,EAAE,MAAM,UAAU,CAAC;AAC7E,OAAO,EACL,cAAc,EACd,oBAAoB,GACrB,MAAM,kCAAkC,CAAC;AAE1C,gHAAgH;AAChH,OAAO,SAAS,MAAM,eAAe,CAAC;AAEtC,MAAM,OAAO,kBAAkB;IAC7B,YAAoB,GAAW;QAAnB;;;;mBAAQ,GAAG;WAAQ;IAAG,CAAC;IAEnC,gBAAgB,CAAC,OAAgB;QAC/B,iEAAiE;QACjE,kFAAkF;QAClF,mCAAmC;QAEnC,iFAAiF;QAEjF,MAAM,IAAI,GAAG,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;QACxC,MAAM,GAAG,GAAG,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACpC,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC;QAClE,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QACtC,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC1B,MAAM,IAAI,cAAc,CAAC,WAAW,CAAC,CAAC;QACxC,CAAC;QACD,MAAM,QAAQ,GAAG,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAClC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,IAAI,cAAc,CAAC,WAAW,CAAC,CAAC;QACxC,CAAC;QACD,MAAM,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC,MAAM,CAAC;QACzC,MAAM,IAAI,GAAG,GAAG,CAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;QACxC,OAAO,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/B,CAAC;IAED,aAAa,CAAC,OAAgB;QAC5B,MAAM,IAAI,GAAG,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;QACxC,OAAO,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/B,CAAC;IAEO,YAAY,CAAC,OAAgB;QACnC,IAAI,cAAc,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;YAC7B,MAAM,KAAK,GAAG,oBAAoB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAC7C,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC,EAAE,CAAC,CAAC;YACxE,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,MAAM,IAAI,cAAc,CAAC,kBAAkB,CAAC,CAAC;YAC/C,CAAC;YACD,OAAO,QAAQ,CAAC,GAAG,CAAC;QACtB,CAAC;QACD,OAAO,IAAI,CAAC,GAAG,CAAC;IAClB,CAAC;CACF"}

package/build/index.d.ts

@@ -0,0 +1,7 @@
+import { MicrobitWebUSBConnection } from "./usb";
+import { MicrobitWebBluetoothConnection } from "./bluetooth";
+import { BoardId } from "./board-id";
+import { DeviceConnection, AfterRequestDevice, BeforeRequestDevice, BoardVersion, ConnectOptions, ConnectionStatus, ConnectionStatusEvent, DeviceError, DeviceErrorCode, DeviceConnectionEventMap, FlashDataError, FlashDataSource, FlashEvent, SerialDataEvent, SerialErrorEvent, SerialResetEvent } from "./device";
+import { HexFlashDataSource } from "./hex-flash-data-source";
+export { MicrobitWebUSBConnection, MicrobitWebBluetoothConnection, BoardId, HexFlashDataSource, AfterRequestDevice, BeforeRequestDevice, ConnectionStatus, ConnectionStatusEvent, DeviceConnectionEventMap, DeviceError, FlashDataError, FlashEvent, SerialDataEvent, SerialErrorEvent, SerialResetEvent, };
+export type { DeviceConnection, BoardVersion, ConnectOptions, DeviceErrorCode, FlashDataSource, };

package/build/index.js

@@ -0,0 +1,7 @@
+import { MicrobitWebUSBConnection } from "./usb";
+import { MicrobitWebBluetoothConnection } from "./bluetooth";
+import { BoardId } from "./board-id";
+import { AfterRequestDevice, BeforeRequestDevice, ConnectionStatus, ConnectionStatusEvent, DeviceError, DeviceConnectionEventMap, FlashDataError, FlashEvent, SerialDataEvent, SerialErrorEvent, SerialResetEvent, } from "./device";
+import { HexFlashDataSource } from "./hex-flash-data-source";
+export { MicrobitWebUSBConnection, MicrobitWebBluetoothConnection, BoardId, HexFlashDataSource, AfterRequestDevice, BeforeRequestDevice, ConnectionStatus, ConnectionStatusEvent, DeviceConnectionEventMap, DeviceError, FlashDataError, FlashEvent, SerialDataEvent, SerialErrorEvent, SerialResetEvent, };
+//# sourceMappingURL=index.js.map

package/build/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../lib/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,OAAO,CAAC;AACjD,OAAO,EAAE,8BAA8B,EAAE,MAAM,aAAa,CAAC;AAC7D,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACrC,OAAO,EAEL,kBAAkB,EAClB,mBAAmB,EAGnB,gBAAgB,EAChB,qBAAqB,EACrB,WAAW,EAEX,wBAAwB,EACxB,cAAc,EAEd,UAAU,EACV,eAAe,EACf,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAE7D,OAAO,EACL,wBAAwB,EACxB,8BAA8B,EAC9B,OAAO,EACP,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,gBAAgB,EAChB,qBAAqB,EACrB,wBAAwB,EACxB,WAAW,EACX,cAAc,EACd,UAAU,EACV,eAAe,EACf,gBAAgB,EAChB,gBAAgB,GACjB,CAAC"}

package/build/logging.d.ts

@@ -0,0 +1,21 @@
+/**
+ * (c) 2024, Micro:bit Educational Foundation and contributors
+ *
+ * SPDX-License-Identifier: MIT
+ */
+export interface Event {
+    type: string;
+    message?: string;
+    value?: number;
+    detail?: any;
+}
+export interface Logging {
+    event(event: Event): void;
+    error(message: string, e: unknown): void;
+    log(e: any): void;
+}
+export declare class NullLogging implements Logging {
+    event(_event: Event): void;
+    error(_m: string, _e: unknown): void;
+    log(_e: any): void;
+}

package/build/logging.js

@@ -0,0 +1,10 @@
+export class NullLogging {
+    event(_event) { }
+    error(_m, _e) {
+        console.error(_m, _e);
+    }
+    log(_e) {
+        console.log(_e);
+    }
+}
+//# sourceMappingURL=logging.js.map

package/build/logging.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logging.js","sourceRoot":"","sources":["../lib/logging.ts"],"names":[],"mappings":"AAkBA,MAAM,OAAO,WAAW;IACtB,KAAK,CAAC,MAAa,IAAS,CAAC;IAC7B,KAAK,CAAC,EAAU,EAAE,EAAW;QAC3B,OAAO,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;IACxB,CAAC;IACD,GAAG,CAAC,EAAO;QACT,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAClB,CAAC;CACF"}

package/build/service-events.d.ts

@@ -0,0 +1,9 @@
+import { AccelerometerDataEvent } from "./accelerometer";
+export declare class ServiceConnectionEventMap {
+    "accelerometerdatachanged": AccelerometerDataEvent;
+}
+export type CharacteristicDataTarget = EventTarget & {
+    value: DataView;
+};
+export type TypedServiceEvent = keyof ServiceConnectionEventMap;
+export type TypedServiceEventDispatcher = (_type: TypedServiceEvent, event: ServiceConnectionEventMap[TypedServiceEvent]) => boolean;

package/build/service-events.js

@@ -0,0 +1,11 @@
+export class ServiceConnectionEventMap {
+    constructor() {
+        Object.defineProperty(this, "accelerometerdatachanged", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+    }
+}
+//# sourceMappingURL=service-events.js.map

package/build/service-events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-events.js","sourceRoot":"","sources":["../lib/service-events.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,yBAAyB;IAAtC;QACE,4BAAA,0BAA0B;;;;;WAAyB;IACrD,CAAC;CAAA"}

package/build/setupTests.d.ts

@@ -0,0 +1,6 @@
+export {};
+/**
+ * (c) 2024, Micro:bit Educational Foundation and contributors
+ *
+ * SPDX-License-Identifier: MIT
+ */

package/build/setupTests.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setupTests.js","sourceRoot":"","sources":["../lib/setupTests.ts"],"names":[],"mappings":";AAAA;;;;GAIG"}

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

@@ -0,0 +1,46 @@
+/**
+ * (c) 2021, Micro:bit Educational Foundation and contributors
+ *
+ * SPDX-License-Identifier: MIT
+ */
+import { CortexM, DAPLink, WebUSB } from "dapjs";
+import { Logging } from "./logging";
+import { BoardSerialInfo } from "./board-serial-info";
+export declare class DAPWrapper {
+    device: USBDevice;
+    private logging;
+    transport: WebUSB;
+    daplink: DAPLink;
+    cortexM: CortexM;
+    _pageSize: number | undefined;
+    _numPages: number | undefined;
+    private loggedBoardSerialInfo;
+    private initialConnectionComplete;
+    constructor(device: USBDevice, logging: Logging);
+    /**
+     * The page size. Throws if we've not connected.
+     */
+    get pageSize(): number;
+    /**
+     * The number of pages. Throws if we've not connected.
+     */
+    get numPages(): number;
+    get boardSerialInfo(): BoardSerialInfo;
+    reconnectAsync(): Promise<void>;
+    startSerial(listener: (data: string) => void): Promise<void>;
+    stopSerial(listener: (data: string) => void): void;
+    disconnectAsync(): Promise<void>;
+    private send;
+    private cmdNums;
+    private readRegRepeat;
+    private writeRegRepeat;
+    private readBlockCore;
+    private writeBlockCore;
+    readBlockAsync(addr: number, words: number): Promise<Uint8Array>;
+    writeBlockAsync(address: number, data: Uint32Array): Promise<void>;
+    executeAsync(address: number, code: Uint32Array, sp: number, pc: number, lr: number, ...registers: number[]): Promise<void>;
+    private waitForHaltCore;
+    waitForHalt(timeToWait?: number): Promise<void>;
+    private softwareReset;
+    reset(halt?: boolean): Promise<void>;
+}

package/build/usb-device-wrapper.js

@@ -0,0 +1,347 @@
+/**
+ * (c) 2021, Micro:bit Educational Foundation and contributors
+ *
+ * SPDX-License-Identifier: MIT
+ */
+import { CortexM, DAPLink, WebUSB } from "dapjs";
+import { ApReg, CortexSpecialReg, Csw, DapCmd, DapVal, FICR, } from "./constants";
+import { apReg, bufferConcat, CoreRegister, regRequest, } from "./usb-partial-flashing-utils";
+import { BoardSerialInfo } from "./board-serial-info";
+export class DAPWrapper {
+    constructor(device, logging) {
+        Object.defineProperty(this, "device", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: device
+        });
+        Object.defineProperty(this, "logging", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: logging
+        });
+        Object.defineProperty(this, "transport", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "daplink", {
+            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, "_pageSize", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "_numPages", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "loggedBoardSerialInfo", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "initialConnectionComplete", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: false
+        });
+        this.transport = new WebUSB(this.device);
+        this.daplink = new DAPLink(this.transport);
+        this.cortexM = new CortexM(this.transport);
+    }
+    /**
+     * The page size. Throws if we've not connected.
+     */
+    get pageSize() {
+        if (this._pageSize === undefined) {
+            throw new Error("pageSize not defined until connected");
+        }
+        return this._pageSize;
+    }
+    /**
+     * The number of pages. Throws if we've not connected.
+     */
+    get numPages() {
+        if (this._numPages === undefined) {
+            throw new Error("numPages not defined until connected");
+        }
+        return this._numPages;
+    }
+    get boardSerialInfo() {
+        return BoardSerialInfo.parse(this.device, this.logging.log.bind(this.logging));
+    }
+    // Drawn from https://github.com/microsoft/pxt-microbit/blob/dec5b8ce72d5c2b4b0b20aafefce7474a6f0c7b2/editor/extension.tsx#L119
+    async reconnectAsync() {
+        if (this.initialConnectionComplete) {
+            await this.disconnectAsync();
+            this.transport = new WebUSB(this.device);
+            this.daplink = new DAPLink(this.transport);
+            this.cortexM = new CortexM(this.transport);
+        }
+        else {
+            this.initialConnectionComplete = true;
+        }
+        await this.daplink.connect();
+        await this.cortexM.connect();
+        this.logging.event({
+            type: "WebUSB-info",
+            message: "connected",
+        });
+        const serialInfo = this.boardSerialInfo;
+        this.logging.log(`Detected board ID ${serialInfo.id}`);
+        if (!this.loggedBoardSerialInfo ||
+            !this.loggedBoardSerialInfo.eq(this.boardSerialInfo)) {
+            this.loggedBoardSerialInfo = this.boardSerialInfo;
+            this.logging.event({
+                type: "WebUSB-info",
+                message: "board-id/" + this.boardSerialInfo.id,
+            });
+            this.logging.event({
+                type: "WebUSB-info",
+                message: "board-family-hic/" +
+                    this.boardSerialInfo.familyId +
+                    this.boardSerialInfo.hic,
+            });
+        }
+        this._pageSize = await this.cortexM.readMem32(FICR.CODEPAGESIZE);
+        this._numPages = await this.cortexM.readMem32(FICR.CODESIZE);
+    }
+    async startSerial(listener) {
+        const currentBaud = await this.daplink.getSerialBaudrate();
+        if (currentBaud !== 115200) {
+            // Changing the baud rate causes a micro:bit reset, so only do it if necessary
+            await this.daplink.setSerialBaudrate(115200);
+        }
+        this.daplink.on(DAPLink.EVENT_SERIAL_DATA, listener);
+        await this.daplink.startSerialRead(1);
+    }
+    stopSerial(listener) {
+        this.daplink.stopSerialRead();
+        this.daplink.removeListener(DAPLink.EVENT_SERIAL_DATA, listener);
+    }
+    async disconnectAsync() {
+        if (this.device.opened &&
+            this.transport.interfaceNumber !== undefined) {
+            return this.daplink.disconnect();
+        }
+    }
+    // Send a packet to the micro:bit directly via WebUSB and return the response.
+    // Drawn from https://github.com/mmoskal/dapjs/blob/a32f11f54e9e76a9c61896ddd425c1cb1a29c143/src/transport/cmsis_dap.ts#L161
+    async send(packet) {
+        const array = Uint8Array.from(packet);
+        await this.transport.write(array.buffer);
+        const response = await this.transport.read();
+        return new Uint8Array(response.buffer);
+    }
+    // Send a command along with relevant data to the micro:bit directly via WebUSB and handle the response.
+    // Drawn from https://github.com/mmoskal/dapjs/blob/a32f11f54e9e76a9c61896ddd425c1cb1a29c143/src/transport/cmsis_dap.ts#L74
+    async cmdNums(op /* DapCmd */, data) {
+        data.unshift(op);
+        const buf = await this.send(data);
+        if (buf[0] !== op) {
+            throw new Error(`Bad response for ${op} -> ${buf[0]}`);
+        }
+        switch (op) {
+            case DapCmd.DAP_CONNECT:
+            case DapCmd.DAP_INFO:
+            case DapCmd.DAP_TRANSFER:
+            case DapCmd.DAP_TRANSFER_BLOCK:
+                break;
+            default:
+                if (buf[1] !== 0) {
+                    throw new Error(`Bad status for ${op} -> ${buf[1]}`);
+                }
+        }
+        return buf;
+    }
+    // Read a certain register a specified amount of times.
+    // Drawn from https://github.com/mmoskal/dapjs/blob/a32f11f54e9e76a9c61896ddd425c1cb1a29c143/src/dap/dap.ts#L117
+    async readRegRepeat(regId /* Reg */, cnt) {
+        const request = regRequest(regId);
+        const sendargs = [0, cnt];
+        for (let i = 0; i < cnt; ++i) {
+            sendargs.push(request);
+        }
+        // Transfer the read requests to the micro:bit and retrieve the data read.
+        const buf = await this.cmdNums(DapCmd.DAP_TRANSFER, sendargs);
+        if (buf[1] !== cnt) {
+            throw new Error("(many) Bad #trans " + buf[1]);
+        }
+        else if (buf[2] !== 1) {
+            throw new Error("(many) Bad transfer status " + buf[2]);
+        }
+        return buf.subarray(3, 3 + cnt * 4);
+    }
+    // Write to a certain register a specified amount of data.
+    // Drawn from https://github.com/mmoskal/dapjs/blob/a32f11f54e9e76a9c61896ddd425c1cb1a29c143/src/dap/dap.ts#L138
+    async writeRegRepeat(regId /* Reg */, data) {
+        const request = regRequest(regId, true);
+        const sendargs = [0, data.length, 0, request];
+        data.forEach((d) => {
+            // separate d into bytes
+            sendargs.push(d & 0xff, (d >> 8) & 0xff, (d >> 16) & 0xff, (d >> 24) & 0xff);
+        });
+        // Transfer the write requests to the micro:bit and retrieve the response status.
+        const buf = await this.cmdNums(DapCmd.DAP_TRANSFER_BLOCK, sendargs);
+        if (buf[3] !== 1) {
+            throw new Error("(many-wr) Bad transfer status " + buf[2]);
+        }
+    }
+    // Core functionality reading a block of data from micro:bit RAM at a specified address.
+    // Drawn from https://github.com/mmoskal/dapjs/blob/a32f11f54e9e76a9c61896ddd425c1cb1a29c143/src/memory/memory.ts#L181
+    async readBlockCore(addr, words) {
+        // Set up CMSIS-DAP to read/write from/to the RAM address addr using the register
+        // ApReg.DRW to write to or read from.
+        await this.cortexM.writeAP(ApReg.CSW, Csw.CSW_VALUE | Csw.CSW_SIZE32);
+        await this.cortexM.writeAP(ApReg.TAR, addr);
+        let lastSize = words % 15;
+        if (lastSize === 0) {
+            lastSize = 15;
+        }
+        const blocks = [];
+        for (let i = 0; i < Math.ceil(words / 15); i++) {
+            const b = await this.readRegRepeat(apReg(ApReg.DRW, DapVal.READ), i === blocks.length - 1 ? lastSize : 15);
+            blocks.push(b);
+        }
+        return bufferConcat(blocks).subarray(0, words * 4);
+    }
+    // Core functionality writing a block of data to micro:bit RAM at a specified address.
+    // Drawn from https://github.com/mmoskal/dapjs/blob/a32f11f54e9e76a9c61896ddd425c1cb1a29c143/src/memory/memory.ts#L205
+    async writeBlockCore(addr, words) {
+        try {
+            // Set up CMSIS-DAP to read/write from/to the RAM address addr using the register ApReg.DRW to write to or read from.
+            await this.cortexM.writeAP(ApReg.CSW, Csw.CSW_VALUE | Csw.CSW_SIZE32);
+            await this.cortexM.writeAP(ApReg.TAR, addr);
+            await this.writeRegRepeat(apReg(ApReg.DRW, DapVal.WRITE), words);
+        }
+        catch (e) {
+            if (e.dapWait) {
+                // Retry after a delay if required.
+                this.logging.log(`Transfer wait, write block`);
+                await new Promise((resolve) => setTimeout(resolve, 100));
+                return await this.writeBlockCore(addr, words);
+            }
+            else {
+                throw e;
+            }
+        }
+    }
+    // Reads a block of data from micro:bit RAM at a specified address.
+    // Drawn from https://github.com/mmoskal/dapjs/blob/a32f11f54e9e76a9c61896ddd425c1cb1a29c143/src/memory/memory.ts#L143
+    async readBlockAsync(addr, words) {
+        const bufs = [];
+        const end = addr + words * 4;
+        let ptr = addr;
+        // Read a single page at a time.
+        while (ptr < end) {
+            let nextptr = ptr + this.pageSize;
+            if (ptr === addr) {
+                nextptr &= ~(this.pageSize - 1);
+            }
+            const len = Math.min(nextptr - ptr, end - ptr);
+            bufs.push(await this.readBlockCore(ptr, len >> 2));
+            ptr = nextptr;
+        }
+        const result = bufferConcat(bufs);
+        return result.subarray(0, words * 4);
+    }
+    // Writes a block of data to micro:bit RAM at a specified address.
+    async writeBlockAsync(address, data) {
+        let payloadSize = this.transport.packetSize - 8;
+        if (data.buffer.byteLength > payloadSize) {
+            let start = 0;
+            let end = payloadSize;
+            // Split write up into smaller writes whose data can each be held in a single packet.
+            while (start !== end) {
+                let temp = new Uint32Array(data.buffer.slice(start, end));
+                await this.writeBlockCore(address + start, temp);
+                start = end;
+                end = Math.min(data.buffer.byteLength, end + payloadSize);
+            }
+        }
+        else {
+            await this.writeBlockCore(address, data);
+        }
+    }
+    // Execute code at a certain address with specified values in the registers.
+    // Waits for execution to halt.
+    async executeAsync(address, code, sp, pc, lr, ...registers) {
+        if (registers.length > 12) {
+            throw new Error(`Only 12 general purpose registers but got ${registers.length} values`);
+        }
+        await this.cortexM.halt(true);
+        await this.writeBlockAsync(address, code);
+        await this.cortexM.writeCoreRegister(CoreRegister.PC, pc);
+        await this.cortexM.writeCoreRegister(CoreRegister.LR, lr);
+        await this.cortexM.writeCoreRegister(CoreRegister.SP, sp);
+        for (let i = 0; i < registers.length; ++i) {
+            await this.cortexM.writeCoreRegister(i, registers[i]);
+        }
+        await this.cortexM.resume(true);
+        return this.waitForHalt();
+    }
+    // Checks whether the micro:bit has halted or timeout has been reached.
+    // Recurses otherwise.
+    async waitForHaltCore(halted, deadline) {
+        if (new Date().getTime() > deadline) {
+            throw new Error("timeout");
+        }
+        if (!halted) {
+            const isHalted = await this.cortexM.isHalted();
+            // NB this is a Promise so no stack risk.
+            return this.waitForHaltCore(isHalted, deadline);
+        }
+    }
+    // Initial function to call to wait for the micro:bit halt.
+    async waitForHalt(timeToWait = 10000) {
+        const deadline = new Date().getTime() + timeToWait;
+        return this.waitForHaltCore(false, deadline);
+    }
+    // Resets the micro:bit in software by writing to NVIC_AIRCR.
+    // Drawn from https://github.com/mmoskal/dapjs/blob/a32f11f54e9e76a9c61896ddd425c1cb1a29c143/src/cortex/cortex.ts#L347
+    async softwareReset() {
+        await this.cortexM.writeMem32(CortexSpecialReg.NVIC_AIRCR, CortexSpecialReg.NVIC_AIRCR_VECTKEY |
+            CortexSpecialReg.NVIC_AIRCR_SYSRESETREQ);
+        // wait for the system to come out of reset
+        let dhcsr = await this.cortexM.readMem32(CortexSpecialReg.DHCSR);
+        while ((dhcsr & CortexSpecialReg.S_RESET_ST) !== 0) {
+            dhcsr = await this.cortexM.readMem32(CortexSpecialReg.DHCSR);
+        }
+    }
+    // Reset the micro:bit, possibly halting the core on reset.
+    // Drawn from https://github.com/mmoskal/dapjs/blob/a32f11f54e9e76a9c61896ddd425c1cb1a29c143/src/cortex/cortex.ts#L248
+    async reset(halt = false) {
+        if (halt) {
+            await this.cortexM.halt(true);
+            // VC_CORERESET causes the core to halt on reset.
+            const demcr = await this.cortexM.readMem32(CortexSpecialReg.DEMCR);
+            await this.cortexM.writeMem32(CortexSpecialReg.DEMCR, CortexSpecialReg.DEMCR | CortexSpecialReg.DEMCR_VC_CORERESET);
+            await this.softwareReset();
+            await this.waitForHalt();
+            // Unset the VC_CORERESET bit
+            await this.cortexM.writeMem32(CortexSpecialReg.DEMCR, demcr);
+        }
+        else {
+            await this.softwareReset();
+        }
+    }
+}
+//# sourceMappingURL=usb-device-wrapper.js.map

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

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

package/build/usb-partial-flashing-utils.d.ts

@@ -0,0 +1,17 @@
+export declare const CoreRegister: {
+    SP: number;
+    LR: number;
+    PC: number;
+};
+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[];