@microbit/microbit-connection 0.1.0 → 0.9.0-apps.alpha.1

package/build/esm/device-information-service.js

@@ -0,0 +1,30 @@
+import { BleClient } from "@capacitor-community/bluetooth-le";
+import { profile } from "./bluetooth-profile.js";
+export class DeviceInformationService {
+    constructor(deviceId) {
+        Object.defineProperty(this, "deviceId", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: deviceId
+        });
+    }
+    async getBoardVersion() {
+        const serviceMeta = profile.deviceInformation;
+        try {
+            const modelNumberBytes = await BleClient.read(this.deviceId, serviceMeta.id, serviceMeta.characteristics.modelNumber.id);
+            const modelNumber = new TextDecoder().decode(modelNumberBytes);
+            if (modelNumber.toLowerCase() === "BBC micro:bit".toLowerCase()) {
+                return "V1";
+            }
+            if (modelNumber.toLowerCase().includes("BBC micro:bit v2".toLowerCase())) {
+                return "V2";
+            }
+            throw new Error(`Unexpected model number ${modelNumber}`);
+        }
+        catch (e) {
+            throw new Error(`Could not read model number: ${e instanceof Error ? e.message : e}`);
+        }
+    }
+}
+//# sourceMappingURL=device-information-service.js.map

package/build/esm/device-information-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"device-information-service.js","sourceRoot":"","sources":["../../lib/device-information-service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,mCAAmC,CAAC;AAE9D,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAEjD,MAAM,OAAO,wBAAwB;IACnC,YAAoB,QAAgB;QAAxB;;;;mBAAQ,QAAQ;WAAQ;IAAG,CAAC;IAExC,KAAK,CAAC,eAAe;QACnB,MAAM,WAAW,GAAG,OAAO,CAAC,iBAAiB,CAAC;QAC9C,IAAI,CAAC;YACH,MAAM,gBAAgB,GAAG,MAAM,SAAS,CAAC,IAAI,CAC3C,IAAI,CAAC,QAAQ,EACb,WAAW,CAAC,EAAE,EACd,WAAW,CAAC,eAAe,CAAC,WAAW,CAAC,EAAE,CAC3C,CAAC;YACF,MAAM,WAAW,GAAG,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC;YAC/D,IAAI,WAAW,CAAC,WAAW,EAAE,KAAK,eAAe,CAAC,WAAW,EAAE,EAAE,CAAC;gBAChE,OAAO,IAAI,CAAC;YACd,CAAC;YACD,IACE,WAAW,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,kBAAkB,CAAC,WAAW,EAAE,CAAC,EACpE,CAAC;gBACD,OAAO,IAAI,CAAC;YACd,CAAC;YACD,MAAM,IAAI,KAAK,CAAC,2BAA2B,WAAW,EAAE,CAAC,CAAC;QAC5D,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,MAAM,IAAI,KAAK,CACb,gCAAgC,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CACrE,CAAC;QACJ,CAAC;IACH,CAAC;CACF"}

package/build/esm/device.d.ts

@@ -41,7 +41,56 @@ export type DeviceErrorCode =
 /**
  * Bluetooth service is missing on device.
  */
- | "service-missing";
+ | "service-missing"
+/**
+ * Failed to establish Bluetooth connection.
+ */
+ | "bluetooth-connection-failed"
+/**
+ * Bluetooth is disabled on the device.
+ */
+ | "bluetooth-disabled"
+/**
+ * Missing required Bluetooth permissions.
+ */
+ | "bluetooth-missing-permissions"
+/**
+ * Partial flash operation failed.
+ */
+ | "flash-partial-failed"
+/**
+ * Full flash operation failed.
+ */
+ | "flash-full-failed"
+/**
+ * Flash operation was cancelled.
+ */
+ | "flash-cancelled";
+export declare enum ProgressStage {
+    Initializing = "Initializing",
+    FindingDevice = "FindingDevice",
+    Connecting = "Connecting",
+    PartialFlashing = "PartialFlashing",
+    FullFlashing = "FullFlashing"
+}
+/**
+ * Progress callback for tracking operation stages (connection and flashing).
+ *
+ * @param stage - The current stage of the operation
+ * @param progress - Optional progress value (0-1) for PartialFlashing and FullFlashing stages.
+ *                   Initializing, FindingDevice, and Connecting stages are called once
+ *                   without progress values to indicate stage entry.
+ *
+ * @example
+ * const progressCallback = (stage, progress) => {
+ *   if (progress !== undefined) {
+ *     console.log(`${stage}: ${Math.round(progress * 100)}%`);
+ *   } else {
+ *     console.log(`Stage: ${stage}`);
+ *   }
+ * };
+ */
+export type ProgressCallback = (stage: ProgressStage, progress?: number) => void;
 /**
  * Error type used for all interactions with this module.
  *
@@ -96,19 +145,26 @@ export declare enum ConnectionStatus {
      */
     RECONNECTING = "RECONNECTING"
 }
+export interface ConnectOptions {
+    /**
+     * Optional progress callback for tracking connection stages.
+     */
+    progress?: ProgressCallback;
+}
 export interface FlashOptions {
     /**
      * True to use a partial flash where possible, false to force a full flash.
+     * Default: true.
      */
-    partial: boolean;
+    partial?: boolean;
     /**
-     * A progress callback. Called with undefined when the process is complete or has failed.
+     * Optional progress callback for tracking connection and flash stages.
      *
      * Requesting a partial flash doesn't guarantee one is performed. Partial flashes are avoided
      * if too many blocks have changed and failed partial flashes are retried as full flashes.
      * The partial parameter reports the flash type currently in progress.
      */
-    progress: (percentage: number | undefined, partial: boolean) => void;
+    progress?: ProgressCallback;
     /**
      * Smallest possible progress increment to limit callback rate.
      */
@@ -130,7 +186,8 @@ export declare class AfterRequestDevice extends Event {
 }
 export declare class BackgroundErrorEvent extends Event {
     readonly errorMessage: string;
-    constructor(errorMessage: string);
+    readonly error?: unknown | undefined;
+    constructor(errorMessage: string, error?: unknown | undefined);
 }
 export declare class DeviceConnectionEventMap {
     "status": ConnectionStatusEvent;
@@ -150,11 +207,11 @@ export interface DeviceConnection<M extends ValueIsEvent<M>> extends TypedEventT
     dispose(): void;
     /**
      * Connects to a currently paired device or requests pairing.
-     * Throws on error.
      *
-     * @returns the final connection status.
+     * @param options Optional connection options including progress callback.
+     * @throws {DeviceError} On connection failure. The error.code property indicates the failure type.
      */
-    connect(): Promise<ConnectionStatus>;
+    connect(options?: ConnectOptions): Promise<void>;
     /**
      * Get the board version.
      *

package/build/esm/device.js

@@ -1,3 +1,11 @@
+export var ProgressStage;
+(function (ProgressStage) {
+    ProgressStage["Initializing"] = "Initializing";
+    ProgressStage["FindingDevice"] = "FindingDevice";
+    ProgressStage["Connecting"] = "Connecting";
+    ProgressStage["PartialFlashing"] = "PartialFlashing";
+    ProgressStage["FullFlashing"] = "FullFlashing";
+})(ProgressStage || (ProgressStage = {}));
 /**
  * Error type used for all interactions with this module.
  *
@@ -82,7 +90,7 @@ export class AfterRequestDevice extends Event {
     }
 }
 export class BackgroundErrorEvent extends Event {
-    constructor(errorMessage) {
+    constructor(errorMessage, error) {
         super("backgrounderror");
         Object.defineProperty(this, "errorMessage", {
             enumerable: true,
@@ -90,6 +98,12 @@ export class BackgroundErrorEvent extends Event {
             writable: true,
             value: errorMessage
         });
+        Object.defineProperty(this, "error", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: error
+        });
     }
 }
 export class DeviceConnectionEventMap {

package/build/esm/device.js.map

@@ -1 +1 @@
-{"version":3,"file":"device.js","sourceRoot":"","sources":["../../lib/device.ts"],"names":[],"mappings":"AA8CA;;;;;;;;GAQG;AACH,MAAM,OAAO,WAAY,SAAQ,KAAK;IAEpC,YAAY,EAAE,IAAI,EAAE,OAAO,EAA+C;QACxE,KAAK,CAAC,OAAO,CAAC,CAAC;QAFjB;;;;;WAAsB;QAGpB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF;AAED;;GAEG;AACH,MAAM,CAAN,IAAY,gBAkCX;AAlCD,WAAY,gBAAgB;IAC1B;;;OAGG;IACH,2DAAuC,CAAA;IACvC;;OAEG;IACH,mDAA+B,CAAA;IAC/B;;;;;OAKG;IACH,iEAA6C,CAAA;IAC7C;;OAEG;IACH,iDAA6B,CAAA;IAC7B;;OAEG;IACH,2CAAuB,CAAA;IACvB;;OAEG;IACH,6CAAyB,CAAA;IACzB;;;OAGG;IACH,iDAA6B,CAAA;AAC/B,CAAC,EAlCW,gBAAgB,KAAhB,gBAAgB,QAkC3B;AAqBD,MAAM,OAAO,cAAe,SAAQ,KAAK;CAAG;AAQ5C,MAAM,OAAO,qBAAsB,SAAQ,KAAK;IAC9C,YAA4B,MAAwB;QAClD,KAAK,CAAC,QAAQ,CAAC,CAAC;QADN;;;;mBAAgB,MAAM;WAAkB;IAEpD,CAAC;CACF;AAED,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IAC5C;QACE,KAAK,CAAC,qBAAqB,CAAC,CAAC;IAC/B,CAAC;CACF;AAED,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAC3C;QACE,KAAK,CAAC,oBAAoB,CAAC,CAAC;IAC9B,CAAC;CACF;AAED,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IAC7C,YAA4B,YAAoB;QAC9C,KAAK,CAAC,iBAAiB,CAAC,CAAC;QADf;;;;mBAAgB,YAAY;WAAQ;IAEhD,CAAC;CACF;AAED,MAAM,OAAO,wBAAwB;IAArC;QACE,4BAAA,QAAQ;;;;;WAAwB;QAChC,4BAAA,iBAAiB;;;;;WAAuB;QACxC,4BAAA,qBAAqB;;;;;WAAQ;QAC7B,4BAAA,oBAAoB;;;;;WAAQ;IAC9B,CAAC;CAAA"}
+{"version":3,"file":"device.js","sourceRoot":"","sources":["../../lib/device.ts"],"names":[],"mappings":"AAsEA,MAAM,CAAN,IAAY,aAMX;AAND,WAAY,aAAa;IACvB,8CAA6B,CAAA;IAC7B,gDAA+B,CAAA;IAC/B,0CAAyB,CAAA;IACzB,oDAAmC,CAAA;IACnC,8CAA6B,CAAA;AAC/B,CAAC,EANW,aAAa,KAAb,aAAa,QAMxB;AAwBD;;;;;;;;GAQG;AACH,MAAM,OAAO,WAAY,SAAQ,KAAK;IAEpC,YAAY,EAAE,IAAI,EAAE,OAAO,EAA+C;QACxE,KAAK,CAAC,OAAO,CAAC,CAAC;QAFjB;;;;;WAAsB;QAGpB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF;AAED;;GAEG;AACH,MAAM,CAAN,IAAY,gBAkCX;AAlCD,WAAY,gBAAgB;IAC1B;;;OAGG;IACH,2DAAuC,CAAA;IACvC;;OAEG;IACH,mDAA+B,CAAA;IAC/B;;;;;OAKG;IACH,iEAA6C,CAAA;IAC7C;;OAEG;IACH,iDAA6B,CAAA;IAC7B;;OAEG;IACH,2CAAuB,CAAA;IACvB;;OAEG;IACH,6CAAyB,CAAA;IACzB;;;OAGG;IACH,iDAA6B,CAAA;AAC/B,CAAC,EAlCW,gBAAgB,KAAhB,gBAAgB,QAkC3B;AA6BD,MAAM,OAAO,cAAe,SAAQ,KAAK;CAAG;AAQ5C,MAAM,OAAO,qBAAsB,SAAQ,KAAK;IAC9C,YAA4B,MAAwB;QAClD,KAAK,CAAC,QAAQ,CAAC,CAAC;QADN;;;;mBAAgB,MAAM;WAAkB;IAEpD,CAAC;CACF;AAED,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IAC5C;QACE,KAAK,CAAC,qBAAqB,CAAC,CAAC;IAC/B,CAAC;CACF;AAED,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAC3C;QACE,KAAK,CAAC,oBAAoB,CAAC,CAAC;IAC9B,CAAC;CACF;AAED,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IAC7C,YACkB,YAAoB,EACpB,KAAe;QAE/B,KAAK,CAAC,iBAAiB,CAAC,CAAC;QAHzB;;;;mBAAgB,YAAY;WAAQ;QACpC;;;;mBAAgB,KAAK;WAAU;IAGjC,CAAC;CACF;AAED,MAAM,OAAO,wBAAwB;IAArC;QACE,4BAAA,QAAQ;;;;;WAAwB;QAChC,4BAAA,iBAAiB;;;;;WAAuB;QACxC,4BAAA,qBAAqB;;;;;WAAQ;QAC7B,4BAAA,oBAAoB;;;;;WAAQ;IAC9B,CAAC;CAAA"}

package/build/esm/dfu-service.d.ts

@@ -0,0 +1,9 @@
+export declare const NORDIC_DFU_SERVICE = "00001530-1212-EFDE-1523-785FEABCD123";
+export declare class DfuService {
+    private deviceId;
+    constructor(deviceId: string);
+    /**
+     * We do this for V1 only.
+     */
+    requestRebootToBootloader(): Promise<void>;
+}

package/build/esm/dfu-service.js

@@ -0,0 +1,22 @@
+import { BleClient, numbersToDataView, } from "@capacitor-community/bluetooth-le";
+import { profile } from "./bluetooth-profile.js";
+// This is the service that should be available on V1 after the reboot.
+// We don't use it directly (the Nordic DFU library does) but we check it's there.
+export const NORDIC_DFU_SERVICE = "00001530-1212-EFDE-1523-785FEABCD123";
+export class DfuService {
+    constructor(deviceId) {
+        Object.defineProperty(this, "deviceId", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: deviceId
+        });
+    }
+    /**
+     * We do this for V1 only.
+     */
+    async requestRebootToBootloader() {
+        await BleClient.write(this.deviceId, profile.dfuControl.id, profile.dfuControl.characteristics.control.id, numbersToDataView([0x01]));
+    }
+}
+//# sourceMappingURL=dfu-service.js.map

package/build/esm/dfu-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dfu-service.js","sourceRoot":"","sources":["../../lib/dfu-service.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EACT,iBAAiB,GAClB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAEjD,uEAAuE;AACvE,kFAAkF;AAClF,MAAM,CAAC,MAAM,kBAAkB,GAAG,sCAAsC,CAAC;AAEzE,MAAM,OAAO,UAAU;IACrB,YAAoB,QAAgB;QAAxB;;;;mBAAQ,QAAQ;WAAQ;IAAG,CAAC;IAExC;;OAEG;IACH,KAAK,CAAC,yBAAyB;QAC7B,MAAM,SAAS,CAAC,KAAK,CACnB,IAAI,CAAC,QAAQ,EACb,OAAO,CAAC,UAAU,CAAC,EAAE,EACrB,OAAO,CAAC,UAAU,CAAC,eAAe,CAAC,OAAO,CAAC,EAAE,EAC7C,iBAAiB,CAAC,CAAC,IAAI,CAAC,CAAC,CAC1B,CAAC;IACJ,CAAC;CACF"}

package/build/esm/flashing/flashing-full.d.ts

@@ -0,0 +1,14 @@
+import MemoryMap from "nrf-intel-hex";
+import { BoardVersion, ProgressCallback } from "../device.js";
+import { BluetoothDeviceWrapper } from "../bluetooth-device-wrapper.js";
+/**
+ * Perform a full flash via Nordic's DFU service.
+ *
+ * The connection is closed before handing off to Nordic's service which will
+ * connect again.
+ *
+ * The device is assumed to be bonded.
+ *
+ * @throws {DeviceError} On flash failure.
+ */
+export declare function fullFlash(connection: BluetoothDeviceWrapper, boardVersion: BoardVersion, memoryMap: MemoryMap, progress: ProgressCallback): Promise<void>;

package/build/esm/flashing/flashing-full.js

@@ -0,0 +1,84 @@
+import { DeviceError, FlashDataError, ProgressStage, } from "../device.js";
+import { DfuService, NORDIC_DFU_SERVICE } from "../dfu-service.js";
+import { refreshServicesForV1IfDesiredServiceMissing } from "./flashing-v1.js";
+import { flashDfu } from "./nordic-dfu.js";
+import { delay } from "../async-util.js";
+/**
+ * Perform a full flash via Nordic's DFU service.
+ *
+ * The connection is closed before handing off to Nordic's service which will
+ * connect again.
+ *
+ * The device is assumed to be bonded.
+ *
+ * @throws {DeviceError} On flash failure.
+ */
+export async function fullFlash(connection, boardVersion, memoryMap, progress) {
+    connection.log("Full flash");
+    progress(ProgressStage.FullFlashing);
+    const { deviceId } = connection.device;
+    try {
+        if (boardVersion === "V1") {
+            connection.log("Rebooting V1 to bootloader");
+            const dfuService = new DfuService(deviceId);
+            try {
+                await dfuService.requestRebootToBootloader();
+            }
+            catch (e) {
+                connection.error("Failed to request reboot to bootloader", e);
+                throw new DeviceError({
+                    code: "flash-full-failed",
+                    message: e instanceof Error ? e.message : "Failed to reboot to bootloader",
+                });
+            }
+            // Wait for device to automatically disconnect as it reboots into bootloader
+            connection.log("Waiting for device to reboot and disconnect");
+            try {
+                await connection.waitForDisconnect(3000);
+            }
+            catch {
+                connection.log("Device did not disconnect automatically, disconnecting manually");
+                await connection.disconnect();
+            }
+            // Give device time to disconnect and reboot into bootloader mode
+            await delay(2500);
+            // Reconnect to device now in bootloader mode
+            progress(ProgressStage.Connecting);
+            await connection.connect();
+            await refreshServicesForV1IfDesiredServiceMissing(deviceId, NORDIC_DFU_SERVICE);
+        }
+    }
+    finally {
+        // The Nordic code opens its own connection.
+        await connection.disconnect();
+        // If we've previously been connected, maybe this helps???
+        await delay(3000);
+    }
+    const appBin = createAppBin(memoryMap, boardVersion);
+    if (appBin === null) {
+        connection.log("Invalid hex (app bin case)");
+        throw new FlashDataError("Invalid hex data: could not extract app binary");
+    }
+    connection.log(`Extracted app bin: ${appBin.length} bytes`);
+    await flashDfu(connection, boardVersion, appBin, progress);
+}
+const createAppBin = (memoryMap, boardVersion) => {
+    const appRegionBoundaries = {
+        V1: { start: 0x18000, end: 0x3c000 },
+        V2: { start: 0x1c000, end: 0x77000 },
+    }[boardVersion];
+    // Calculate data size within the app region
+    let maxAddress = appRegionBoundaries.start;
+    for (const [blockAddr, block] of memoryMap) {
+        const blockEnd = blockAddr + block.length;
+        if (blockEnd > appRegionBoundaries.start &&
+            blockAddr < appRegionBoundaries.end) {
+            maxAddress = Math.max(maxAddress, Math.min(blockEnd, appRegionBoundaries.end));
+        }
+    }
+    let size = maxAddress - appRegionBoundaries.start;
+    // 4-byte alignment required by DFU
+    size = Math.ceil(size / 4) * 4;
+    return memoryMap.slicePad(appRegionBoundaries.start, size);
+};
+//# sourceMappingURL=flashing-full.js.map

package/build/esm/flashing/flashing-full.js.map

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

package/build/esm/flashing/flashing-makecode.d.ts

@@ -0,0 +1,6 @@
+import MemoryMap from "nrf-intel-hex";
+import { RegionInfo } from "../partial-flashing-service";
+/**
+ * Find the MakeCode code region in a MemoryMap (typically from a hex file).
+ */
+export declare const findMakeCodeRegionInMemoryMap: (memoryMap: MemoryMap, deviceCodeRegion: RegionInfo) => RegionInfo | null;

package/build/esm/flashing/flashing-makecode.js

@@ -0,0 +1,44 @@
+const PXT_MAGIC_HEX = "708E3B92C615A841C49866C975EE5197";
+/**
+ * Find the MakeCode code region in a MemoryMap (typically from a hex file).
+ */
+export const findMakeCodeRegionInMemoryMap = (memoryMap, deviceCodeRegion) => {
+    for (const [blockAddr, block] of memoryMap) {
+        const offset = findByteSequence(block, PXT_MAGIC_HEX);
+        if (offset >= 0) {
+            const start = blockAddr + offset;
+            const hashOffset = start + PXT_MAGIC_HEX.length / 2;
+            const hashBytes = memoryMap.slicePad(hashOffset, 8);
+            const hash = bytesToHex(hashBytes);
+            // Find the highest address with data in the memory map within the code region
+            let end = start;
+            for (const [blockAddr, block] of memoryMap) {
+                const blockEnd = blockAddr + block.length;
+                if (blockEnd > start && blockAddr < deviceCodeRegion.end) {
+                    end = Math.max(end, Math.min(blockEnd, deviceCodeRegion.end));
+                }
+            }
+            // Round up to next 64-byte boundary
+            end = Math.ceil(end / 64) * 64;
+            return { start, end, hash };
+        }
+    }
+    return null;
+};
+const bytesToHex = (bytes) => {
+    return Array.from(bytes)
+        .map((byte) => byte.toString(16).padStart(2, "0").toUpperCase())
+        .join("");
+};
+function findByteSequence(data, hexTarget) {
+    const target = new Uint8Array(hexTarget.match(/.{1,2}/g).map((byte) => parseInt(byte, 16)));
+    outer: for (let i = 0; i <= data.length - target.length; i++) {
+        for (let j = 0; j < target.length; j++) {
+            if (data[i + j] !== target[j])
+                continue outer;
+        }
+        return i;
+    }
+    return -1;
+}
+//# sourceMappingURL=flashing-makecode.js.map

package/build/esm/flashing/flashing-makecode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flashing-makecode.js","sourceRoot":"","sources":["../../../lib/flashing/flashing-makecode.ts"],"names":[],"mappings":"AAGA,MAAM,aAAa,GAAG,kCAAkC,CAAC;AAEzD;;GAEG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAC3C,SAAoB,EACpB,gBAA4B,EACT,EAAE;IACrB,KAAK,MAAM,CAAC,SAAS,EAAE,KAAK,CAAC,IAAI,SAAS,EAAE,CAAC;QAC3C,MAAM,MAAM,GAAG,gBAAgB,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC;QACtD,IAAI,MAAM,IAAI,CAAC,EAAE,CAAC;YAChB,MAAM,KAAK,GAAG,SAAS,GAAG,MAAM,CAAC;YACjC,MAAM,UAAU,GAAG,KAAK,GAAG,aAAa,CAAC,MAAM,GAAG,CAAC,CAAC;YACpD,MAAM,SAAS,GAAG,SAAS,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC;YACpD,MAAM,IAAI,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC;YAEnC,8EAA8E;YAC9E,IAAI,GAAG,GAAG,KAAK,CAAC;YAChB,KAAK,MAAM,CAAC,SAAS,EAAE,KAAK,CAAC,IAAI,SAAS,EAAE,CAAC;gBAC3C,MAAM,QAAQ,GAAG,SAAS,GAAG,KAAK,CAAC,MAAM,CAAC;gBAC1C,IAAI,QAAQ,GAAG,KAAK,IAAI,SAAS,GAAG,gBAAgB,CAAC,GAAG,EAAE,CAAC;oBACzD,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC;gBAChE,CAAC;YACH,CAAC;YACD,oCAAoC;YACpC,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,GAAG,EAAE,CAAC,GAAG,EAAE,CAAC;YAE/B,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC;QAC9B,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC,CAAC;AAEF,MAAM,UAAU,GAAG,CAAC,KAAiB,EAAU,EAAE;IAC/C,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC;SACrB,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC;SAC/D,IAAI,CAAC,EAAE,CAAC,CAAC;AACd,CAAC,CAAC;AAEF,SAAS,gBAAgB,CAAC,IAAgB,EAAE,SAAiB;IAC3D,MAAM,MAAM,GAAG,IAAI,UAAU,CAC3B,SAAS,CAAC,KAAK,CAAC,SAAS,CAAE,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAC9D,CAAC;IAEF,KAAK,EAAE,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC7D,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACvC,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,MAAM,CAAC,CAAC,CAAC;gBAAE,SAAS,KAAK,CAAC;QAChD,CAAC;QACD,OAAO,CAAC,CAAC;IACX,CAAC;IAED,OAAO,CAAC,CAAC,CAAC;AACZ,CAAC"}

package/build/esm/flashing/flashing-partial.d.ts

@@ -0,0 +1,9 @@
+import MemoryMap from "nrf-intel-hex";
+import { BluetoothDeviceWrapper } from "../bluetooth-device-wrapper.js";
+import { ProgressCallback } from "../device.js";
+export declare enum PartialFlashResult {
+    Success = "Success",
+    AttemptFullFlash = "AttemptFullFlash"
+}
+declare const partialFlash: (connection: BluetoothDeviceWrapper, memoryMap: MemoryMap, progress: ProgressCallback) => Promise<PartialFlashResult>;
+export default partialFlash;

package/build/esm/flashing/flashing-partial.js

@@ -0,0 +1,95 @@
+import { PacketState, PartialFlashingService, RegionId, } from "../partial-flashing-service.js";
+import { findMakeCodeRegionInMemoryMap } from "./flashing-makecode.js";
+import { delay, DisconnectError } from "../async-util.js";
+import { DeviceError, ProgressStage } from "../device.js";
+export var PartialFlashResult;
+(function (PartialFlashResult) {
+    PartialFlashResult["Success"] = "Success";
+    PartialFlashResult["AttemptFullFlash"] = "AttemptFullFlash";
+})(PartialFlashResult || (PartialFlashResult = {}));
+const partialFlash = async (connection, memoryMap, progress) => {
+    const pf = new PartialFlashingService(connection);
+    await pf.startNotifications();
+    const result = await connection.raceDisconnectAndTimeout(partialFlashInternal(connection, pf, memoryMap, progress), { timeout: 30_000, actionName: "partial flash" });
+    try {
+        await pf.stopNotifications();
+    }
+    catch (e) {
+        // V1 disconnects quickly after a partial flash.
+        if (!(e instanceof DisconnectError)) {
+            connection.error("Error stopping notifications", e);
+        }
+    }
+    return result;
+};
+const partialFlashInternal = async (connection, pf, memoryMap, progress) => {
+    connection.log("Partial flash");
+    progress(ProgressStage.PartialFlashing);
+    try {
+        const deviceCodeRegion = await pf.getRegionInfo(RegionId.MakeCode);
+        if (deviceCodeRegion === null) {
+            connection.log("Could not read code region");
+            return PartialFlashResult.AttemptFullFlash;
+        }
+        const deviceDalRegion = await pf.getRegionInfo(RegionId.Dal);
+        if (deviceDalRegion === null) {
+            connection.log("Could not read DAL region");
+            return PartialFlashResult.AttemptFullFlash;
+        }
+        progress(ProgressStage.PartialFlashing);
+        const fileCodeRegion = findMakeCodeRegionInMemoryMap(memoryMap, deviceCodeRegion);
+        if (fileCodeRegion === null) {
+            connection.log("No partial flash data");
+            return PartialFlashResult.AttemptFullFlash;
+        }
+        if (fileCodeRegion.hash !== deviceDalRegion.hash) {
+            connection.log(`DAL hash comparison failed. Hex: ${fileCodeRegion.hash} vs device: ${deviceDalRegion.hash}`);
+            return PartialFlashResult.AttemptFullFlash;
+        }
+        if (deviceCodeRegion.start !== fileCodeRegion.start) {
+            connection.log("Code start address doesn't match");
+            return PartialFlashResult.AttemptFullFlash;
+        }
+        let nextPacketNumber = 0;
+        outer: for (let offset = fileCodeRegion.start; offset < fileCodeRegion.end;) {
+            const batchStartAddress = offset;
+            for (let packetInBatch = 0; packetInBatch < 4; ++packetInBatch) {
+                const packetNumber = nextPacketNumber++;
+                const packetDataOffset = offset + packetInBatch * 16;
+                if (packetInBatch < 3) {
+                    await pf.writeFlash(memoryMap, batchStartAddress, packetDataOffset, packetNumber, packetInBatch);
+                }
+                else {
+                    const result = await pf.writeFlashForNotification(memoryMap, batchStartAddress, packetDataOffset, packetNumber, packetInBatch);
+                    if (result === PacketState.Retransmit) {
+                        // Retry the whole 64 bytes.
+                        connection.log(`Retransmit requested at offset ${offset}`);
+                        continue outer;
+                    }
+                    else {
+                        progress(ProgressStage.PartialFlashing, (offset - fileCodeRegion.start) /
+                            (fileCodeRegion.end - fileCodeRegion.start));
+                    }
+                }
+            }
+            offset += 64;
+        }
+        await delay(100); // allow time for write to complete
+        await pf.writeEndOfFlashPacket();
+        await delay(100); // allow time for write to complete
+        progress(ProgressStage.PartialFlashing, 1);
+        return PartialFlashResult.Success;
+    }
+    catch (e) {
+        connection.error("Partial flash failed", e);
+        if (e instanceof DeviceError) {
+            throw e;
+        }
+        throw new DeviceError({
+            code: "flash-partial-failed",
+            message: e instanceof Error ? e.message : String(e),
+        });
+    }
+};
+export default partialFlash;
+//# sourceMappingURL=flashing-partial.js.map

package/build/esm/flashing/flashing-partial.js.map

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

package/build/esm/flashing/flashing-v1.d.ts

@@ -0,0 +1,11 @@
+/**
+ * V1 changes the service it offers in application/bootloader mode.
+ *
+ * We don't trust Android to have an up-to-date copy of services so will fall back
+ * to calling internal API via reflection if the desired/expected service is not
+ * listed.
+ *
+ * It might be that this is only needed for older versions of Android where we
+ * can't get service changed indications.
+ */
+export declare const refreshServicesForV1IfDesiredServiceMissing: (deviceId: string, desiredServiceUuid: string) => Promise<void>;

package/build/esm/flashing/flashing-v1.js

@@ -0,0 +1,20 @@
+import { BleClient } from "@capacitor-community/bluetooth-le";
+/**
+ * V1 changes the service it offers in application/bootloader mode.
+ *
+ * We don't trust Android to have an up-to-date copy of services so will fall back
+ * to calling internal API via reflection if the desired/expected service is not
+ * listed.
+ *
+ * It might be that this is only needed for older versions of Android where we
+ * can't get service changed indications.
+ */
+export const refreshServicesForV1IfDesiredServiceMissing = async (deviceId, desiredServiceUuid) => {
+    const services = await BleClient.getServices(deviceId);
+    const deviceHasService = services.some((s) => s.uuid === desiredServiceUuid);
+    if (!deviceHasService) {
+        // On Android this does use the refresh reflection hack.
+        await BleClient.discoverServices(deviceId);
+    }
+};
+//# sourceMappingURL=flashing-v1.js.map

package/build/esm/flashing/flashing-v1.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flashing-v1.js","sourceRoot":"","sources":["../../../lib/flashing/flashing-v1.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,mCAAmC,CAAC;AAE9D;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,2CAA2C,GAAG,KAAK,EAC9D,QAAgB,EAChB,kBAA0B,EAC1B,EAAE;IACF,MAAM,QAAQ,GAAG,MAAM,SAAS,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;IACvD,MAAM,gBAAgB,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,kBAAkB,CAAC,CAAC;IAC7E,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACtB,wDAAwD;QACxD,MAAM,SAAS,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IAC7C,CAAC;AACH,CAAC,CAAC"}

package/build/esm/flashing/nordic-dfu.d.ts

@@ -0,0 +1,3 @@
+import { BluetoothDeviceWrapper } from "../bluetooth-device-wrapper.js";
+import { BoardVersion, ProgressCallback } from "../device";
+export declare function flashDfu(connection: BluetoothDeviceWrapper, boardVersion: BoardVersion, appBin: Uint8Array, progress: ProgressCallback): Promise<void>;