@microbit/microbit-connection 0.0.0-tab.change.177 → 0.1.0

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

@@ -0,0 +1,412 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DAPWrapper = void 0;
+/**
+ * (c) 2021, Micro:bit Educational Foundation and contributors
+ *
+ * SPDX-License-Identifier: MIT
+ */
+const dapjs = __importStar(require("dapjs"));
+const { CortexM: CortexMValue, DAPLink: DAPLinkValue, WebUSB: WebUSBValue, } = dapjs;
+const constants_js_1 = require("./constants.js");
+const usb_partial_flashing_utils_js_1 = require("./usb-partial-flashing-utils.js");
+const board_serial_info_js_1 = require("./board-serial-info.js");
+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, "_deviceId", {
+            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 WebUSBValue(this.device);
+        this.daplink = new DAPLinkValue(this.transport);
+        this.cortexM = new CortexMValue(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;
+    }
+    /**
+     * The number of pages. Undefined if we've not connected.
+     */
+    get deviceId() {
+        return this._deviceId;
+    }
+    get boardSerialInfo() {
+        return board_serial_info_js_1.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 WebUSBValue(this.device);
+            this.daplink = new DAPLinkValue(this.transport);
+            this.cortexM = new CortexMValue(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,
+            });
+        }
+        // https://support.microbit.org/support/solutions/articles/19000067679-how-to-find-the-name-of-your-micro-bit
+        // We wait on errors as immediately after flash the micro:bit won't be ready to respond
+        this._deviceId = await this.readMem32WaitOnError(constants_js_1.FICR.DEVICE_ID_1);
+        this._pageSize = await this.readMem32WaitOnError(constants_js_1.FICR.CODEPAGESIZE);
+        this._numPages = await this.readMem32WaitOnError(constants_js_1.FICR.CODESIZE);
+    }
+    async readMem32WaitOnError(register) {
+        let retries = 0;
+        let lastError;
+        while (retries < 20) {
+            try {
+                return await this.cortexM.readMem32(register);
+            }
+            catch (e) {
+                if (e instanceof Error) {
+                    lastError = e;
+                    if (/^Transfer/.test(e.message)) {
+                        retries++;
+                        await new Promise((resolve) => setTimeout(resolve, 20));
+                    }
+                    else {
+                        throw e;
+                    }
+                }
+            }
+        }
+        throw lastError;
+    }
+    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.addListener(DAPLinkValue.EVENT_SERIAL_DATA, listener);
+        await this.daplink.startSerialRead(1);
+    }
+    stopSerial(listener) {
+        this.daplink.stopSerialRead();
+        this.daplink.removeListener(DAPLinkValue.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 constants_js_1.DapCmd.DAP_CONNECT:
+            case constants_js_1.DapCmd.DAP_INFO:
+            case constants_js_1.DapCmd.DAP_TRANSFER:
+            case constants_js_1.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 = (0, usb_partial_flashing_utils_js_1.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(constants_js_1.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 = (0, usb_partial_flashing_utils_js_1.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(constants_js_1.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(constants_js_1.ApReg.CSW, constants_js_1.Csw.CSW_VALUE | constants_js_1.Csw.CSW_SIZE32);
+        await this.cortexM.writeAP(constants_js_1.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((0, usb_partial_flashing_utils_js_1.apReg)(constants_js_1.ApReg.DRW, constants_js_1.DapVal.READ), i === blocks.length - 1 ? lastSize : 15);
+            blocks.push(b);
+        }
+        return (0, usb_partial_flashing_utils_js_1.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(constants_js_1.ApReg.CSW, constants_js_1.Csw.CSW_VALUE | constants_js_1.Csw.CSW_SIZE32);
+            await this.cortexM.writeAP(constants_js_1.ApReg.TAR, addr);
+            await this.writeRegRepeat((0, usb_partial_flashing_utils_js_1.apReg)(constants_js_1.ApReg.DRW, constants_js_1.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 = (0, usb_partial_flashing_utils_js_1.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(usb_partial_flashing_utils_js_1.CoreRegister.PC, pc);
+        await this.cortexM.writeCoreRegister(usb_partial_flashing_utils_js_1.CoreRegister.LR, lr);
+        await this.cortexM.writeCoreRegister(usb_partial_flashing_utils_js_1.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(constants_js_1.CortexSpecialReg.NVIC_AIRCR, constants_js_1.CortexSpecialReg.NVIC_AIRCR_VECTKEY |
+            constants_js_1.CortexSpecialReg.NVIC_AIRCR_SYSRESETREQ);
+        // wait for the system to come out of reset
+        let dhcsr = await this.cortexM.readMem32(constants_js_1.CortexSpecialReg.DHCSR);
+        while ((dhcsr & constants_js_1.CortexSpecialReg.S_RESET_ST) !== 0) {
+            dhcsr = await this.cortexM.readMem32(constants_js_1.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(constants_js_1.CortexSpecialReg.DEMCR);
+            await this.cortexM.writeMem32(constants_js_1.CortexSpecialReg.DEMCR, constants_js_1.CortexSpecialReg.DEMCR | constants_js_1.CortexSpecialReg.DEMCR_VC_CORERESET);
+            await this.softwareReset();
+            await this.waitForHalt();
+            // Unset the VC_CORERESET bit
+            await this.cortexM.writeMem32(constants_js_1.CortexSpecialReg.DEMCR, demcr);
+        }
+        else {
+            await this.softwareReset();
+        }
+    }
+}
+exports.DAPWrapper = DAPWrapper;
+//# sourceMappingURL=usb-device-wrapper.js.map

package/build/cjs/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/cjs/usb-partial-flashing-utils.js

@@ -0,0 +1,133 @@
+"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,
+};
+const read32FromUInt8Array = (data, i) => {
+    return ((data[i] |
+        (data[i + 1] << 8) |
+        (data[i + 2] << 16) |
+        (data[i + 3] << 24)) >>>
+        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) => {
+    let h0 = 0x2f9be6cc;
+    let h1 = 0x1ec3a6c8;
+    for (let i = 0; i < data.byteLength; i += 4) {
+        let k = (0, exports.read32FromUInt8Array)(data, i) >>> 0;
+        k = Math.imul(k, 0xcc9e2d51);
+        k = (k << 15) | (k >>> 17);
+        k = Math.imul(k, 0x1b873593);
+        h0 ^= k;
+        h1 ^= k;
+        h0 = (h0 << 13) | (h0 >>> 19);
+        h1 = (h1 << 13) | (h1 >>> 19);
+        h0 = (Math.imul(h0, 5) + 0xe6546b64) >>> 0;
+        h1 = (Math.imul(h1, 5) + 0xe6546b64) >>> 0;
+    }
+    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", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: targetAddr
+        });
+        Object.defineProperty(this, "data", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: data
+        });
+    }
+}
+exports.Page = Page;
+// Split buffer into pages, each of pageSize size.
+// Drawn from https://github.com/microsoft/pxt-microbit/blob/dec5b8ce72d5c2b4b0b20aafefce7474a6f0c7b2/editor/extension.tsx#L209
+const pageAlignBlocks = (buffer, targetAddr, pageSize) => {
+    let unaligned = new Uint8Array(buffer);
+    let pages = [];
+    for (let i = 0; i < unaligned.byteLength;) {
+        let newbuf = new Uint8Array(pageSize).fill(0xff);
+        let startPad = (targetAddr + i) & (pageSize - 1);
+        let newAddr = targetAddr + i - startPad;
+        for (; i < unaligned.byteLength; ++i) {
+            if (targetAddr + i >= newAddr + pageSize)
+                break;
+            newbuf[targetAddr + i - newAddr] = unaligned[i];
+        }
+        let page = new Page(newAddr, newbuf);
+        pages.push(page);
+    }
+    return pages;
+};
+exports.pageAlignBlocks = pageAlignBlocks;
+// Filter out all pages whose calculated checksum matches the corresponding checksum passed as an argument.
+// Drawn from https://github.com/microsoft/pxt-microbit/blob/dec5b8ce72d5c2b4b0b20aafefce7474a6f0c7b2/editor/extension.tsx#L523
+const onlyChanged = (pages, checksums, pageSize) => {
+    return pages.filter((page) => {
+        let idx = page.targetAddr / pageSize;
+        if (idx * 8 + 8 > 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 ch = (0, exports.murmur3_core)(page.data);
+        if (c0 === ch[0] && c1 === ch[1])
+            return false;
+        return true;
+    });
+};
+exports.onlyChanged = onlyChanged;
+//# sourceMappingURL=usb-partial-flashing-utils.js.map

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

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

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

@@ -39,8 +39,8 @@
  */
 import { Logging } from "./logging.js";
 import { DAPWrapper } from "./usb-device-wrapper.js";
-import MemoryMap from "nrf-intel-hex";
 import { BoardVersion } from "./device.js";
+import MemoryMap from "nrf-intel-hex";
 type ProgressCallback = (n: number, partial: boolean) => void;
 /**
  * Uses a DAPWrapper to flash the micro:bit.
@@ -58,8 +58,8 @@ export declare class PartialFlashing {
     private partialFlashPageAsync;
     private partialFlashCoreAsync;
     private partialFlashAsync;
-    fullFlashAsync(data: string | Uint8Array | MemoryMap.default, updateProgress: ProgressCallback): Promise<void>;
-    flashAsync(data: string | Uint8Array | MemoryMap.default, updateProgress: ProgressCallback): Promise<boolean>;
+    fullFlashAsync(data: string | Uint8Array | MemoryMap, updateProgress: ProgressCallback): Promise<void>;
+    flashAsync(data: string | Uint8Array | MemoryMap, updateProgress: ProgressCallback): Promise<boolean>;
     private convertDataToHexString;
     private convertDataToPaddedBytes;
     private hexStringToPaddedBytes;