@microbit/microbit-connection 0.0.0-alpha.9 → 0.1.0

package/build/esm/magnetometer-service.js

@@ -0,0 +1,125 @@
+import { MagnetometerDataEvent } from "./magnetometer.js";
+import { profile } from "./bluetooth-profile.js";
+import { BackgroundErrorEvent, DeviceError } from "./device.js";
+export class MagnetometerService {
+    constructor(magnetometerDataCharacteristic, magnetometerPeriodCharacteristic, magnetometerBearingCharacteristic, magnetometerCalibrationCharacteristic, dispatchTypedEvent, queueGattOperation) {
+        Object.defineProperty(this, "magnetometerDataCharacteristic", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: magnetometerDataCharacteristic
+        });
+        Object.defineProperty(this, "magnetometerPeriodCharacteristic", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: magnetometerPeriodCharacteristic
+        });
+        Object.defineProperty(this, "magnetometerBearingCharacteristic", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: magnetometerBearingCharacteristic
+        });
+        Object.defineProperty(this, "magnetometerCalibrationCharacteristic", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: magnetometerCalibrationCharacteristic
+        });
+        Object.defineProperty(this, "dispatchTypedEvent", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: dispatchTypedEvent
+        });
+        Object.defineProperty(this, "queueGattOperation", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: queueGattOperation
+        });
+        this.magnetometerDataCharacteristic.addEventListener("characteristicvaluechanged", (event) => {
+            const target = event.target;
+            const data = this.dataViewToData(target.value);
+            this.dispatchTypedEvent("magnetometerdatachanged", new MagnetometerDataEvent(data));
+        });
+    }
+    static async createService(gattServer, dispatcher, queueGattOperation, listenerInit) {
+        let magnetometerService;
+        try {
+            magnetometerService = await gattServer.getPrimaryService(profile.magnetometer.id);
+        }
+        catch (err) {
+            if (listenerInit) {
+                dispatcher("backgrounderror", new BackgroundErrorEvent(err));
+                return;
+            }
+            else {
+                throw new DeviceError({
+                    code: "service-missing",
+                    message: err,
+                });
+            }
+        }
+        const magnetometerDataCharacteristic = await magnetometerService.getCharacteristic(profile.magnetometer.characteristics.data.id);
+        const magnetometerPeriodCharacteristic = await magnetometerService.getCharacteristic(profile.magnetometer.characteristics.period.id);
+        const magnetometerBearingCharacteristic = await magnetometerService.getCharacteristic(profile.magnetometer.characteristics.bearing.id);
+        const magnetometerCalibrationCharacteristic = await magnetometerService.getCharacteristic(profile.magnetometer.characteristics.calibration.id);
+        return new MagnetometerService(magnetometerDataCharacteristic, magnetometerPeriodCharacteristic, magnetometerBearingCharacteristic, magnetometerCalibrationCharacteristic, dispatcher, queueGattOperation);
+    }
+    dataViewToData(dataView) {
+        return {
+            x: dataView.getInt16(0, true),
+            y: dataView.getInt16(2, true),
+            z: dataView.getInt16(4, true),
+        };
+    }
+    async getData() {
+        const dataView = await this.queueGattOperation(() => this.magnetometerDataCharacteristic.readValue());
+        return this.dataViewToData(dataView);
+    }
+    async getPeriod() {
+        const dataView = await this.queueGattOperation(() => this.magnetometerPeriodCharacteristic.readValue());
+        return dataView.getUint16(0, true);
+    }
+    async setPeriod(value) {
+        if (value === 0) {
+            // Writing 0 causes the device to crash.
+            return;
+        }
+        // Allowed values: 10, 20, 50, 100
+        // Values passed are rounded up to the allowed values on device.
+        // Documentation for allowed values looks wrong.
+        // https://lancaster-university.github.io/microbit-docs/ble/profile/#about-the-magnetometer-service
+        const dataView = new DataView(new ArrayBuffer(2));
+        dataView.setUint16(0, value, true);
+        return this.queueGattOperation(() => this.magnetometerPeriodCharacteristic.writeValue(dataView));
+    }
+    async getBearing() {
+        const dataView = await this.queueGattOperation(() => this.magnetometerBearingCharacteristic.readValue());
+        return dataView.getUint16(0, true);
+    }
+    async triggerCalibration() {
+        const dataView = new DataView(new ArrayBuffer(1));
+        dataView.setUint8(0, 1);
+        return this.queueGattOperation(() => this.magnetometerCalibrationCharacteristic.writeValue(dataView));
+    }
+    async startNotifications(type) {
+        await this.characteristicForEvent(type)?.startNotifications();
+    }
+    async stopNotifications(type) {
+        await this.characteristicForEvent(type)?.stopNotifications();
+    }
+    characteristicForEvent(type) {
+        switch (type) {
+            case "magnetometerdatachanged": {
+                return this.magnetometerDataCharacteristic;
+            }
+            default: {
+                return undefined;
+            }
+        }
+    }
+}
+//# sourceMappingURL=magnetometer-service.js.map

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

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

package/build/esm/magnetometer.d.ts

@@ -0,0 +1,9 @@
+export interface MagnetometerData {
+    x: number;
+    y: number;
+    z: number;
+}
+export declare class MagnetometerDataEvent extends Event {
+    readonly data: MagnetometerData;
+    constructor(data: MagnetometerData);
+}

package/build/esm/magnetometer.js

@@ -0,0 +1,12 @@
+export class MagnetometerDataEvent extends Event {
+    constructor(data) {
+        super("magnetometerdatachanged");
+        Object.defineProperty(this, "data", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: data
+        });
+    }
+}
+//# sourceMappingURL=magnetometer.js.map

package/build/esm/magnetometer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"magnetometer.js","sourceRoot":"","sources":["../../lib/magnetometer.ts"],"names":[],"mappings":"AAMA,MAAM,OAAO,qBAAsB,SAAQ,KAAK;IAC9C,YAA4B,IAAsB;QAChD,KAAK,CAAC,yBAAyB,CAAC,CAAC;QADvB;;;;mBAAgB,IAAI;WAAkB;IAElD,CAAC;CACF"}

package/build/esm/package.json

@@ -0,0 +1 @@
+{"type": "module"}

package/build/esm/promise-queue.d.ts

@@ -0,0 +1,27 @@
+interface Options {
+    /**
+     * If we should clear the queue return a function to create errors to reject all promises.
+     * Otherwise return undefined. Called before processing each entry.
+     */
+    abortCheck?: () => (() => Error) | undefined;
+}
+export declare class PromiseQueue {
+    private busy;
+    private entries;
+    private abortCheck;
+    constructor(options?: Options);
+    /**
+     * Queue an action.
+     *
+     * @param action Async action to perform.
+     * @returns A promise that resolves when all prior added actions and this action have been performed.
+     */
+    add<T>(action: () => Promise<T>): Promise<T>;
+    private processQueue;
+    /**
+     * Skips any queued actions that aren't in progress and rejects their
+     * promises with errors created with the supplied function.
+     */
+    clear(rejection: () => Error): void;
+}
+export {};

package/build/esm/promise-queue.js

@@ -0,0 +1,74 @@
+export class PromiseQueue {
+    constructor(options = {}) {
+        Object.defineProperty(this, "busy", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: false
+        });
+        Object.defineProperty(this, "entries", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: []
+        });
+        Object.defineProperty(this, "abortCheck", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        this.abortCheck = options.abortCheck ?? (() => undefined);
+    }
+    /**
+     * Queue an action.
+     *
+     * @param action Async action to perform.
+     * @returns A promise that resolves when all prior added actions and this action have been performed.
+     */
+    add(action) {
+        return new Promise((resolve, reject) => {
+            const entry = {
+                resolve,
+                reject,
+                action,
+            };
+            this.entries.push(entry);
+            if (!this.busy) {
+                void this.processQueue();
+            }
+        });
+    }
+    async processQueue() {
+        const rejection = this.abortCheck();
+        if (rejection) {
+            this.clear(rejection);
+            return;
+        }
+        const entry = this.entries.shift();
+        if (!entry) {
+            return;
+        }
+        this.busy = true;
+        try {
+            entry.resolve(await entry.action());
+        }
+        catch (e) {
+            entry.reject(e);
+        }
+        this.busy = false;
+        return this.processQueue();
+    }
+    /**
+     * Skips any queued actions that aren't in progress and rejects their
+     * promises with errors created with the supplied function.
+     */
+    clear(rejection) {
+        const entries = this.entries;
+        this.entries = [];
+        entries.forEach((e) => {
+            e.reject(rejection());
+        });
+    }
+}
+//# sourceMappingURL=promise-queue.js.map

package/build/esm/promise-queue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"promise-queue.js","sourceRoot":"","sources":["../../lib/promise-queue.ts"],"names":[],"mappings":"AAcA,MAAM,OAAO,YAAY;IAKvB,YAAY,UAAmB,EAAE;QAJzB;;;;mBAAgB,KAAK;WAAC;QACtB;;;;mBAA6B,EAAE;WAAC;QAChC;;;;;WAA4C;QAGlD,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;IAC5D,CAAC;IAED;;;;;OAKG;IACI,GAAG,CAAI,MAAwB;QACpC,OAAO,IAAI,OAAO,CAAI,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACxC,MAAM,KAAK,GAAkB;gBAC3B,OAAO;gBACP,MAAM;gBACN,MAAM;aACP,CAAC;YACF,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACzB,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;gBACf,KAAK,IAAI,CAAC,YAAY,EAAE,CAAC;YAC3B,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,KAAK,CAAC,YAAY;QACxB,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;QACpC,IAAI,SAAS,EAAE,CAAC;YACd,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;YACtB,OAAO;QACT,CAAC;QACD,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QACnC,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO;QACT,CAAC;QACD,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC;YACH,KAAK,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;QACtC,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QACD,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC;QAClB,OAAO,IAAI,CAAC,YAAY,EAAE,CAAC;IAC7B,CAAC;IAED;;;OAGG;IACI,KAAK,CAAC,SAAsB;QACjC,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;QAC7B,IAAI,CAAC,OAAO,GAAG,EAAE,CAAC;QAClB,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE;YACpB,CAAC,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC;QACxB,CAAC,CAAC,CAAC;IACL,CAAC;CACF"}

package/build/esm/serial-events.d.ts

@@ -0,0 +1,20 @@
+export declare class SerialDataEvent extends Event {
+    readonly data: string;
+    constructor(data: string);
+}
+export declare class SerialResetEvent extends Event {
+    constructor();
+}
+export declare class SerialErrorEvent extends Event {
+    readonly error: unknown;
+    constructor(error: unknown);
+}
+export declare class FlashEvent extends Event {
+    constructor();
+}
+export declare class SerialConnectionEventMap {
+    "serialdata": SerialDataEvent;
+    "serialreset": SerialResetEvent;
+    "serialerror": SerialErrorEvent;
+    "flash": FlashEvent;
+}

package/build/esm/serial-events.js

@@ -0,0 +1,61 @@
+export class SerialDataEvent extends Event {
+    constructor(data) {
+        super("serialdata");
+        Object.defineProperty(this, "data", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: data
+        });
+    }
+}
+export class SerialResetEvent extends Event {
+    constructor() {
+        super("serialreset");
+    }
+}
+export class SerialErrorEvent extends Event {
+    constructor(error) {
+        super("serialerror");
+        Object.defineProperty(this, "error", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: error
+        });
+    }
+}
+export class FlashEvent extends Event {
+    constructor() {
+        super("flash");
+    }
+}
+export class SerialConnectionEventMap {
+    constructor() {
+        Object.defineProperty(this, "serialdata", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "serialreset", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "serialerror", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "flash", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+    }
+}
+//# sourceMappingURL=serial-events.js.map

package/build/esm/serial-events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serial-events.js","sourceRoot":"","sources":["../../lib/serial-events.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,eAAgB,SAAQ,KAAK;IACxC,YAA4B,IAAY;QACtC,KAAK,CAAC,YAAY,CAAC,CAAC;QADV;;;;mBAAgB,IAAI;WAAQ;IAExC,CAAC;CACF;AAED,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IACzC;QACE,KAAK,CAAC,aAAa,CAAC,CAAC;IACvB,CAAC;CACF;AAED,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IACzC,YAA4B,KAAc;QACxC,KAAK,CAAC,aAAa,CAAC,CAAC;QADX;;;;mBAAgB,KAAK;WAAS;IAE1C,CAAC;CACF;AAED,MAAM,OAAO,UAAW,SAAQ,KAAK;IACnC;QACE,KAAK,CAAC,OAAO,CAAC,CAAC;IACjB,CAAC;CACF;AAED,MAAM,OAAO,wBAAwB;IAArC;QACE,4BAAA,YAAY;;;;;WAAkB;QAC9B,4BAAA,aAAa;;;;;WAAmB;QAChC,4BAAA,aAAa;;;;;WAAmB;QAChC,4BAAA,OAAO;;;;;WAAa;IACtB,CAAC;CAAA"}

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

@@ -0,0 +1,17 @@
+import { AccelerometerDataEvent } from "./accelerometer.js";
+import { ButtonEvent } from "./buttons.js";
+import { DeviceConnectionEventMap } from "./device.js";
+import { MagnetometerDataEvent } from "./magnetometer.js";
+import { UARTDataEvent } from "./uart.js";
+export declare class ServiceConnectionEventMap {
+    "accelerometerdatachanged": AccelerometerDataEvent;
+    "buttonachanged": ButtonEvent;
+    "buttonbchanged": ButtonEvent;
+    "magnetometerdatachanged": MagnetometerDataEvent;
+    "uartdata": UARTDataEvent;
+}
+export type CharacteristicDataTarget = EventTarget & {
+    value: DataView;
+};
+export type TypedServiceEvent = keyof (ServiceConnectionEventMap & DeviceConnectionEventMap);
+export type TypedServiceEventDispatcher = (_type: TypedServiceEvent, event: (ServiceConnectionEventMap & DeviceConnectionEventMap)[TypedServiceEvent]) => boolean;

package/build/{service-events.js → esm/service-events.js}

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"service-events.js","sourceRoot":"","sources":["../../lib/service-events.ts"],"names":[],"mappings":"AAMA,MAAM,OAAO,yBAAyB;IAAtC;QACE,4BAAA,0BAA0B;;;;;WAAyB;QACnD,4BAAA,gBAAgB;;;;;WAAc;QAC9B,4BAAA,gBAAgB;;;;;WAAc;QAC9B,4BAAA,yBAAyB;;;;;WAAwB;QACjD,4BAAA,UAAU;;;;;WAAgB;IAC5B,CAAC;CAAA"}

package/build/esm/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 → esm/setupTests.js.map}

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

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

@@ -0,0 +1,13 @@
+import { Service } from "./bluetooth-device-wrapper.js";
+import { TypedServiceEvent, TypedServiceEventDispatcher } from "./service-events.js";
+export declare class UARTService implements Service {
+    private txCharacteristic;
+    private rxCharacteristic;
+    private dispatchTypedEvent;
+    private queueGattOperation;
+    constructor(txCharacteristic: BluetoothRemoteGATTCharacteristic, rxCharacteristic: BluetoothRemoteGATTCharacteristic, dispatchTypedEvent: TypedServiceEventDispatcher, queueGattOperation: <R>(action: () => Promise<R>) => Promise<R>);
+    static createService(gattServer: BluetoothRemoteGATTServer, dispatcher: TypedServiceEventDispatcher, queueGattOperation: <R>(action: () => Promise<R>) => Promise<R>, listenerInit: boolean): Promise<UARTService | undefined>;
+    startNotifications(type: TypedServiceEvent): Promise<void>;
+    stopNotifications(type: TypedServiceEvent): Promise<void>;
+    writeData(value: Uint8Array): Promise<void>;
+}

package/build/esm/uart-service.js

@@ -0,0 +1,72 @@
+import { profile } from "./bluetooth-profile.js";
+import { BackgroundErrorEvent, DeviceError } from "./device.js";
+import { UARTDataEvent } from "./uart.js";
+export class UARTService {
+    constructor(txCharacteristic, rxCharacteristic, dispatchTypedEvent, queueGattOperation) {
+        Object.defineProperty(this, "txCharacteristic", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: txCharacteristic
+        });
+        Object.defineProperty(this, "rxCharacteristic", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: rxCharacteristic
+        });
+        Object.defineProperty(this, "dispatchTypedEvent", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: dispatchTypedEvent
+        });
+        Object.defineProperty(this, "queueGattOperation", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: queueGattOperation
+        });
+        this.txCharacteristic.addEventListener("characteristicvaluechanged", (event) => {
+            const target = event.target;
+            const value = new Uint8Array(target.value.buffer);
+            this.dispatchTypedEvent("uartdata", new UARTDataEvent(value));
+        });
+    }
+    static async createService(gattServer, dispatcher, queueGattOperation, listenerInit) {
+        let uartService;
+        try {
+            uartService = await gattServer.getPrimaryService(profile.uart.id);
+        }
+        catch (err) {
+            if (listenerInit) {
+                dispatcher("backgrounderror", new BackgroundErrorEvent(err));
+                return;
+            }
+            else {
+                throw new DeviceError({
+                    code: "service-missing",
+                    message: err,
+                });
+            }
+        }
+        const rxCharacteristic = await uartService.getCharacteristic(profile.uart.characteristics.rx.id);
+        const txCharacteristic = await uartService.getCharacteristic(profile.uart.characteristics.tx.id);
+        return new UARTService(txCharacteristic, rxCharacteristic, dispatcher, queueGattOperation);
+    }
+    async startNotifications(type) {
+        if (type === "uartdata") {
+            await this.txCharacteristic.startNotifications();
+        }
+    }
+    async stopNotifications(type) {
+        if (type === "uartdata") {
+            await this.txCharacteristic.stopNotifications();
+        }
+    }
+    async writeData(value) {
+        const dataView = new DataView(value.buffer);
+        return this.queueGattOperation(() => this.rxCharacteristic.writeValueWithoutResponse(dataView));
+    }
+}
+//# sourceMappingURL=uart-service.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"uart-service.js","sourceRoot":"","sources":["../../lib/uart-service.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,oBAAoB,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAMhE,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE1C,MAAM,OAAO,WAAW;IACtB,YACU,gBAAmD,EACnD,gBAAmD,EACnD,kBAA+C,EAC/C,kBAA+D;QAHvE;;;;mBAAQ,gBAAgB;WAAmC;QAC3D;;;;mBAAQ,gBAAgB;WAAmC;QAC3D;;;;mBAAQ,kBAAkB;WAA6B;QACvD;;;;mBAAQ,kBAAkB;WAA6C;QAEvE,IAAI,CAAC,gBAAgB,CAAC,gBAAgB,CACpC,4BAA4B,EAC5B,CAAC,KAAY,EAAE,EAAE;YACf,MAAM,MAAM,GAAG,KAAK,CAAC,MAAkC,CAAC;YACxD,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;YAClD,IAAI,CAAC,kBAAkB,CAAC,UAAU,EAAE,IAAI,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC;QAChE,CAAC,CACF,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,aAAa,CACxB,UAAqC,EACrC,UAAuC,EACvC,kBAA+D,EAC/D,YAAqB;QAErB,IAAI,WAAuC,CAAC;QAC5C,IAAI,CAAC;YACH,WAAW,GAAG,MAAM,UAAU,CAAC,iBAAiB,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACpE,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,YAAY,EAAE,CAAC;gBACjB,UAAU,CAAC,iBAAiB,EAAE,IAAI,oBAAoB,CAAC,GAAa,CAAC,CAAC,CAAC;gBACvE,OAAO;YACT,CAAC;iBAAM,CAAC;gBACN,MAAM,IAAI,WAAW,CAAC;oBACpB,IAAI,EAAE,iBAAiB;oBACvB,OAAO,EAAE,GAAa;iBACvB,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QACD,MAAM,gBAAgB,GAAG,MAAM,WAAW,CAAC,iBAAiB,CAC1D,OAAO,CAAC,IAAI,CAAC,eAAe,CAAC,EAAE,CAAC,EAAE,CACnC,CAAC;QACF,MAAM,gBAAgB,GAAG,MAAM,WAAW,CAAC,iBAAiB,CAC1D,OAAO,CAAC,IAAI,CAAC,eAAe,CAAC,EAAE,CAAC,EAAE,CACnC,CAAC;QACF,OAAO,IAAI,WAAW,CACpB,gBAAgB,EAChB,gBAAgB,EAChB,UAAU,EACV,kBAAkB,CACnB,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,kBAAkB,CAAC,IAAuB;QAC9C,IAAI,IAAI,KAAK,UAAU,EAAE,CAAC;YACxB,MAAM,IAAI,CAAC,gBAAgB,CAAC,kBAAkB,EAAE,CAAC;QACnD,CAAC;IACH,CAAC;IAED,KAAK,CAAC,iBAAiB,CAAC,IAAuB;QAC7C,IAAI,IAAI,KAAK,UAAU,EAAE,CAAC;YACxB,MAAM,IAAI,CAAC,gBAAgB,CAAC,iBAAiB,EAAE,CAAC;QAClD,CAAC;IACH,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,KAAiB;QAC/B,MAAM,QAAQ,GAAG,IAAI,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAC5C,OAAO,IAAI,CAAC,kBAAkB,CAAC,GAAG,EAAE,CAClC,IAAI,CAAC,gBAAgB,CAAC,yBAAyB,CAAC,QAAQ,CAAC,CAC1D,CAAC;IACJ,CAAC;CACF"}

package/build/esm/uart.d.ts

@@ -0,0 +1,4 @@
+export declare class UARTDataEvent extends Event {
+    readonly value: Uint8Array;
+    constructor(value: Uint8Array);
+}

package/build/esm/uart.js

@@ -0,0 +1,12 @@
+export class UARTDataEvent extends Event {
+    constructor(value) {
+        super("uartdata");
+        Object.defineProperty(this, "value", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: value
+        });
+    }
+}
+//# sourceMappingURL=uart.js.map

package/build/esm/uart.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"uart.js","sourceRoot":"","sources":["../../lib/uart.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,aAAc,SAAQ,KAAK;IACtC,YAA4B,KAAiB;QAC3C,KAAK,CAAC,UAAU,CAAC,CAAC;QADR;;;;mBAAgB,KAAK;WAAY;IAE7C,CAAC;CACF"}

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

@@ -0,0 +1,47 @@
+import type { CortexM, DAPLink, WebUSB } from "dapjs";
+import { Logging } from "./logging.js";
+import { BoardSerialInfo } from "./board-serial-info.js";
+export declare class DAPWrapper {
+    device: USBDevice;
+    private logging;
+    transport: WebUSB;
+    daplink: DAPLink;
+    cortexM: CortexM;
+    _pageSize: number | undefined;
+    _numPages: number | undefined;
+    _deviceId: 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;
+    /**
+     * The number of pages. Undefined if we've not connected.
+     */
+    get deviceId(): number | undefined;
+    get boardSerialInfo(): BoardSerialInfo;
+    reconnectAsync(): Promise<void>;
+    readMem32WaitOnError(register: number): Promise<number>;
+    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>;
+    softwareReset(): Promise<void>;
+    reset(halt?: boolean): Promise<void>;
+}