@microbit/microbit-connection 0.9.0-apps.alpha.9 → 1.0.0-beta.1

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

@@ -0,0 +1,98 @@
+/**
+ * (c) 2021, Micro:bit Educational Foundation and contributors
+ *
+ * SPDX-License-Identifier: MIT
+ */
+import { BoardSerialInfo } from "./board-serial-info.js";
+import { ArmDebugSwd } from "./arm-debug.js";
+import { CmsisDapUsb } from "./cmsis-dap.js";
+import { CortexM } from "./cortex-m.js";
+import { DapLinkSerial, readDaplinkUniqueId, readMem32WithRetry, } from "./daplink.js";
+import { UsbTransport } from "./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;
+export 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 CmsisDapUsb(new UsbTransport(this.usbDevice), this.logging);
+        this.adi = new ArmDebugSwd(cmsisDap, this.logging);
+        this.cortexM = new CortexM(this.adi);
+        this.serial = new 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 readMem32WithRetry(this.adi, FICR_DEVICE_ID_1, this.logging);
+        const pageSize = await readMem32WithRetry(this.adi, FICR_CODEPAGESIZE, this.logging);
+        const numPages = await 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 readDaplinkUniqueId(this.adi.dap, this.logging);
+        if (dapSerial) {
+            return 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 BoardSerialInfo.parse(this.usbDevice, this.logging.log.bind(this.logging));
+    }
+    async disconnect() {
+        if (this.usbDevice.opened && this.adi.isOpen) {
+            return this.adi.disconnect();
+        }
+    }
+}
+//# sourceMappingURL=device-wrapper.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"device-wrapper.js","sourceRoot":"","sources":["../../../src/usb/device-wrapper.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEzD,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EACL,aAAa,EACb,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C,oEAAoE;AACpE,gEAAgE;AAChE,MAAM,iBAAiB,GAAG,UAAU,CAAC;AACrC,MAAM,aAAa,GAAG,UAAU,CAAC;AACjC,MAAM,gBAAgB,GAAG,UAAU,CAAC;AASpC,MAAM,OAAO,gBAAgB;IAO3B,YACkB,SAAoB,EAC5B,OAAgB;QADxB;;;;mBAAgB,SAAS;WAAW;QACpC;;;;mBAAQ,OAAO;WAAS;QAR1B;;;;;WAAiB;QACjB;;;;;WAAiB;QACjB;;;;;WAAsB;QAEd;;;;mBAA4B,KAAK;WAAC;QAMxC,MAAM,QAAQ,GAAG,IAAI,WAAW,CAC9B,IAAI,YAAY,CAAC,IAAI,CAAC,SAAS,CAAC,EAChC,IAAI,CAAC,OAAO,CACb,CAAC;QACF,IAAI,CAAC,GAAG,GAAG,IAAI,WAAW,CAAC,QAAQ,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;QACnD,IAAI,CAAC,OAAO,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACrC,IAAI,CAAC,MAAM,GAAG,IAAI,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IAC1D,CAAC;IAED,+HAA+H;IAC/H,KAAK,CAAC,SAAS;QACb,IAAI,IAAI,CAAC,yBAAyB,EAAE,CAAC;YACnC,MAAM,IAAI,CAAC,UAAU,EAAE,CAAC;QAC1B,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,yBAAyB,GAAG,IAAI,CAAC;QACxC,CAAC;QAED,MAAM,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;QAEzB,MAAM,eAAe,GAAG,MAAM,IAAI,CAAC,mBAAmB,EAAE,CAAC;QACzD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,qBAAqB,eAAe,CAAC,EAAE,EAAE,CAAC,CAAC;QAE5D,6GAA6G;QAC7G,wFAAwF;QACxF,MAAM,QAAQ,GAAG,MAAM,kBAAkB,CACvC,IAAI,CAAC,GAAG,EACR,gBAAgB,EAChB,IAAI,CAAC,OAAO,CACb,CAAC;QACF,MAAM,QAAQ,GAAG,MAAM,kBAAkB,CACvC,IAAI,CAAC,GAAG,EACR,iBAAiB,EACjB,IAAI,CAAC,OAAO,CACb,CAAC;QACF,MAAM,QAAQ,GAAG,MAAM,kBAAkB,CACvC,IAAI,CAAC,GAAG,EACR,aAAa,EACb,IAAI,CAAC,OAAO,CACb,CAAC;QAEF,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC;IAC3D,CAAC;IAED;;;;;OAKG;IACK,KAAK,CAAC,mBAAmB;QAC/B,MAAM,SAAS,GAAG,MAAM,mBAAmB,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;QACxE,IAAI,SAAS,EAAE,CAAC;YACd,OAAO,eAAe,CAAC,UAAU,CAC/B,SAAS,EACT,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CACpC,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,GAAG,CACd,6HAA6H,CAC9H,CAAC;QACF,OAAO,eAAe,CAAC,KAAK,CAC1B,IAAI,CAAC,SAAS,EACd,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CACpC,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,UAAU;QACd,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,IAAI,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC;YAC7C,OAAO,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,CAAC;QAC/B,CAAC;IACH,CAAC;CACF"}

package/build/esm/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 { SerialData } from "./serial-events.js";

package/build/esm/usb/index.js

@@ -0,0 +1,5 @@
+/**
+ * @module @microbit/microbit-connection/usb
+ */
+export { createUSBConnection, DeviceSelectionMode, } from "./connection.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/usb/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EACL,mBAAmB,EACnB,mBAAmB,GAGpB,MAAM,iBAAiB,CAAC"}

package/build/{cjs/usb-partial-flashing-utils.d.ts → esm/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/esm/{usb-partial-flashing-utils.js → usb/partial-flashing-utils.js}

@@ -3,14 +3,6 @@
  *
  * SPDX-License-Identifier: MIT
  */
-import { DapVal } from "./constants.js";
-// Represents the micro:bit's core registers
-// Drawn from https://armmbed.github.io/dapjs/docs/enums/coreregister.html
-export const CoreRegister = {
-    SP: 13,
-    LR: 14,
-    PC: 15,
-};
 export const read32FromUInt8Array = (data, i) => {
     return ((data[i] |
         (data[i + 1] << 8) |
@@ -18,19 +10,6 @@ export const read32FromUInt8Array = (data, i) => {
         (data[i + 3] << 24)) >>>
         0);
 };
-export 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;
-};
 // 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
 export const murmur3_core = (data) => {
@@ -50,25 +29,6 @@ export const murmur3_core = (data) => {
     }
     return [h0, h1];
 };
-// Returns a representation of an Access Port Register.
-// Drawn from https://github.com/mmoskal/dapjs/blob/a32f11f54e9e76a9c61896ddd425c1cb1a29c143/src/util.ts#L63
-export const apReg = (r, mode) => {
-    const v = r | mode | DapVal.AP_ACC;
-    return 4 + ((v & 0x0c) >> 2);
-};
-// 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
-export 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;
-};
 export class Page {
     constructor(targetAddr, data) {
         Object.defineProperty(this, "targetAddr", {
@@ -109,14 +69,14 @@ export const pageAlignBlocks = (buffer, targetAddr, pageSize) => {
 export 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 = read32FromUInt8Array(checksums, idx * 8);
-        let c1 = read32FromUInt8Array(checksums, idx * 8 + 4);
+        let c0 = checksums[idx * 2];
+        let c1 = checksums[idx * 2 + 1];
         let ch = murmur3_core(page.data);
         if (c0 === ch[0] && c1 === ch[1])
             return false;
         return true;
     });
 };
-//# sourceMappingURL=usb-partial-flashing-utils.js.map
+//# sourceMappingURL=partial-flashing-utils.js.map

package/build/esm/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/{cjs/usb-partial-flashing.d.ts → esm/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;
@@ -60,8 +68,26 @@ export declare class PartialFlashing {
     fullFlashAsync(data: string | Uint8Array | MemoryMap, updateProgress: ProgressCallback): Promise<void>;
     flashAsync(data: string | Uint8Array | MemoryMap, updateProgress: ProgressCallback): Promise<boolean>;
     private convertDataToHexString;
-    private convertDataToPaddedBytes;
-    private hexStringToPaddedBytes;
-    private paddedBytesToHexString;
-    private memoryMapToPaddedBytes;
+    /**
+     * Parse the flash data into a MemoryMap (if not already one).
+     */
+    private toMemoryMap;
+    /**
+     * Extract padded flash bytes (main flash only) and UICR entries from a
+     * MemoryMap. Parses the data once for both.
+     */
+    private extractFlashAndUicr;
+    /**
+     * Check UICR and repair if needed after a partial flash.
+     *
+     * UICR bits can only be cleared (1→0) without erasing. If all mismatched
+     * bits only need 1→0, we can write directly on both V1 and V2.
+     * If any bit needs 0→1, an erase is required first:
+     *  - V2: erase via NVMC.ERASEUICR, then write
+     *  - V1: no independent UICR erase, fall back to full flash
+     *
+     * Returns true if we stayed on the partial flash path, false if we had
+     * to fall back to full flash.
+     */
+    private ensureUicr;
 }