@microbit/microbit-connection 0.0.0-tab.change.177 → 0.9.0-apps.alpha.0

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

@@ -0,0 +1,481 @@
+/**
+ * (c) 2023, Center for Computational Thinking and Design at Aarhus University and contributors
+ *
+ * SPDX-License-Identifier: MIT
+ */
+import { BleClient, } from "@capacitor-community/bluetooth-le";
+import { Capacitor } from "@capacitor/core";
+import { AccelerometerService } from "./accelerometer-service.js";
+import { delay, DisconnectError, disconnectErrorCallback, TimeoutError, timeoutErrorAfter, } from "./async-util.js";
+import { ButtonService } from "./button-service.js";
+import { DeviceInformationService } from "./device-information-service.js";
+import { DeviceError } from "./device.js";
+import { LedService } from "./led-service.js";
+import { ConsoleLogging } from "./logging.js";
+import { MagnetometerService } from "./magnetometer-service.js";
+import { MicroBitMode, PartialFlashingService, } from "./partial-flashing-service.js";
+import { UARTService } from "./uart-service.js";
+export const bondingTimeoutInMs = 40_000;
+export const connectTimeoutInMs = 10_000;
+export const scanningTimeoutInMs = 10_000;
+export const isAndroid = () => Capacitor.getPlatform() === "android";
+// TODO: We've removed the support for these behaviours as we need to
+// re-evaluate how best to support then via capacitor-ble (or reinstate
+// the direct Web Bluetooth connection code.
+//
+// On ChromeOS and Mac there's no timeout and no clear way to abort
+// device.gatt.connect(), so we accept that sometimes we'll still
+// be trying to connect when we'd rather not be. If it succeeds when
+// we no longer intend to be connected then we disconnect at that
+// point. If we try to connect when a previous connection attempt is
+// still around then we wait for it for our timeout period.
+//
+// On Windows it times out after 7s.
+// https://bugs.chromium.org/p/chromium/issues/detail?id=684073
+//
+// Additionally we've remove the delay before trying to connect again
+// on Windows.
+//
+// We also used to have a timeout around requestDevice that reloaded the page.
+//
+// > In some situations the Chrome device prompt simply doesn't appear so we time
+// > this out after 30 seconds and reload the page
+export class BluetoothDeviceWrapper {
+    constructor(device, logging = new ConsoleLogging(), dispatchTypedEvent, currentEvents, callbacks) {
+        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, "currentEvents", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: currentEvents
+        });
+        Object.defineProperty(this, "callbacks", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: callbacks
+        });
+        // Used to avoid automatic reconnection during user triggered connect/disconnect
+        // or reconnection itself.
+        Object.defineProperty(this, "duringExplicitConnectDisconnect", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: 0
+        });
+        Object.defineProperty(this, "connected", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: false
+        });
+        Object.defineProperty(this, "isReconnect", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: false
+        });
+        // Only updated after the full connection flow completes not during bond handling.
+        Object.defineProperty(this, "serviceIds", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: new Set()
+        });
+        Object.defineProperty(this, "accelerometer", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "buttons", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "deviceInformation", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "led", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "magnetometer", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "uart", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        /**
+         * Only defined after connection.
+         */
+        Object.defineProperty(this, "boardVersion", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "services", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "waitingForDisconnectEventCallbacks", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: []
+        });
+        Object.defineProperty(this, "internalNotificationListeners", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: new Map()
+        });
+        Object.defineProperty(this, "handleDisconnectEvent", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: async () => {
+                this.waitingForDisconnectEventCallbacks.forEach((cb) => cb());
+                this.waitingForDisconnectEventCallbacks.length = 0;
+                this.connected = false;
+                try {
+                    if (!this.duringExplicitConnectDisconnect) {
+                        this.logging.log("Bluetooth disconnected... automatically trying reconnect");
+                        await this.reconnect();
+                    }
+                    else {
+                        this.logging.log("Bluetooth disconnect ignored during explicit disconnect");
+                    }
+                }
+                catch (e) {
+                    this.logging.error("Bluetooth connect triggered by disconnect listener failed", e);
+                }
+            }
+        });
+        this.accelerometer = new AccelerometerService(device.deviceId, dispatchTypedEvent);
+        this.buttons = new ButtonService(device.deviceId, dispatchTypedEvent);
+        this.deviceInformation = new DeviceInformationService(device.deviceId);
+        this.led = new LedService(device.deviceId);
+        this.magnetometer = new MagnetometerService(device.deviceId, dispatchTypedEvent);
+        this.uart = new UARTService(device.deviceId, dispatchTypedEvent);
+        this.services = [
+            this.accelerometer,
+            this.buttons,
+            this.led,
+            this.magnetometer,
+            this.uart,
+        ];
+    }
+    async connect() {
+        this.logging.event({
+            type: this.isReconnect ? "Reconnect" : "Connect",
+            message: "Bluetooth connect start",
+        });
+        if (this.isReconnect) {
+            this.callbacks.onReconnecting();
+        }
+        else {
+            this.callbacks.onConnecting();
+        }
+        this.duringExplicitConnectDisconnect++;
+        try {
+            if (Capacitor.isNativePlatform()) {
+                await this.connectHandlingBond();
+            }
+            else {
+                await this.connectInternal();
+            }
+            await this.getBoardVersion();
+            const events = this.currentEvents();
+            const services = await BleClient.getServices(this.device.deviceId);
+            this.serviceIds = new Set(services.map((s) => s.uuid));
+            this.logging.log(`Starting notifications for current events ${events}`);
+            events.forEach((e) => this.startNotifications(e));
+            this.logging.event({
+                type: this.isReconnect ? "Reconnect" : "Connect",
+                message: "Bluetooth connect success",
+            });
+            this.callbacks.onSuccess();
+        }
+        catch (e) {
+            this.logging.error("Bluetooth connect error", e);
+            this.logging.event({
+                type: this.isReconnect ? "Reconnect" : "Connect",
+                message: "Bluetooth connect failed",
+            });
+            await this.disconnectInternal(false);
+            this.callbacks.onFail();
+            if (e instanceof DeviceError) {
+                throw e;
+            }
+            if (e instanceof TimeoutError) {
+                throw new DeviceError({
+                    code: "timeout-error",
+                    message: e instanceof Error ? e.message : String(e),
+                });
+            }
+            throw new DeviceError({
+                code: "bluetooth-connection-failed",
+                message: e instanceof Error ? e.message : String(e),
+            });
+        }
+        finally {
+            this.duringExplicitConnectDisconnect--;
+            // Reset isReconnect for next time
+            this.isReconnect = false;
+        }
+    }
+    async connectInternal() {
+        this.waitingForDisconnectEventCallbacks.length = 0;
+        await BleClient.connect(this.device.deviceId, this.handleDisconnectEvent, {
+            timeout: connectTimeoutInMs,
+        });
+        this.connected = true;
+    }
+    async disconnect() {
+        return this.disconnectInternal(true);
+    }
+    async disconnectInternal(userTriggered) {
+        this.logging.log(`Bluetooth disconnect ${userTriggered ? "(user triggered)" : "(programmatic)"}`);
+        this.duringExplicitConnectDisconnect++;
+        try {
+            if (this.connected) {
+                await BleClient.disconnect(this.device.deviceId);
+            }
+        }
+        catch (e) {
+            this.logging.error("Bluetooth GATT disconnect error (ignored)", e);
+            // We might have already lost the connection.
+        }
+        finally {
+            this.duringExplicitConnectDisconnect--;
+        }
+    }
+    async reconnect() {
+        this.logging.log("Bluetooth reconnect");
+        this.isReconnect = true;
+        await this.connect();
+    }
+    async getBoardVersion() {
+        // We read this when we connect and it won't change.
+        if (this.boardVersion) {
+            return this.boardVersion;
+        }
+        this.boardVersion = await this.deviceInformation.getBoardVersion();
+        return this.boardVersion;
+    }
+    async startNotifications(type) {
+        await this.getServicesForEvent(type)?.startNotifications(type);
+    }
+    async stopNotifications(type) {
+        await this.getServicesForEvent(type)?.stopNotifications(type);
+    }
+    getServicesForEvent(type) {
+        return this.services.find((s) => this.serviceIds.has(s.uuid) && s.getRelevantEvents().includes(type));
+    }
+    async startInternalNotifications(serviceId, characteristicId, options) {
+        const key = this.getNotificationKey(serviceId, characteristicId);
+        await this.raceDisconnectAndTimeout(BleClient.startNotifications(this.device.deviceId, serviceId, characteristicId, (value) => {
+            const bytes = new Uint8Array(value.buffer);
+            // Notify all registered callbacks.
+            this.internalNotificationListeners
+                .get(key)
+                ?.forEach((cb) => cb(bytes));
+        }, options), { actionName: "start notifications" });
+    }
+    subscribe(serviceId, characteristicId, callback) {
+        const key = this.getNotificationKey(serviceId, characteristicId);
+        if (!this.internalNotificationListeners.has(key)) {
+            this.internalNotificationListeners.set(key, new Set());
+        }
+        this.internalNotificationListeners.get(key).add(callback);
+    }
+    unsubscribe(serviceId, characteristicId, callback) {
+        const key = this.getNotificationKey(serviceId, characteristicId);
+        this.internalNotificationListeners.get(key)?.delete(callback);
+    }
+    async stopInternalNotifications(serviceId, characteristicId) {
+        await BleClient.stopNotifications(this.device.deviceId, serviceId, characteristicId);
+        const key = this.getNotificationKey(serviceId, characteristicId);
+        this.internalNotificationListeners.delete(key);
+    }
+    /**
+     * Write to characteristic and wait for a notification response.
+     *
+     * It is the responsibility of the caller to have started notifications
+     * for the characteristic.
+     */
+    async writeForNotification(serviceId, characteristicId, value, notificationId, isFinalNotification = () => true) {
+        let notificationListener;
+        const notificationPromise = new Promise((resolve) => {
+            notificationListener = (bytes) => {
+                if (bytes[0] === notificationId && isFinalNotification(bytes)) {
+                    resolve(bytes);
+                }
+            };
+            this.subscribe(serviceId, characteristicId, notificationListener);
+        });
+        try {
+            await BleClient.writeWithoutResponse(this.device.deviceId, serviceId, characteristicId, value);
+            return await this.raceDisconnectAndTimeout(notificationPromise, {
+                timeout: 3_000,
+                actionName: "flash notification wait",
+            });
+        }
+        finally {
+            if (notificationListener) {
+                this.unsubscribe(serviceId, characteristicId, notificationListener);
+            }
+        }
+    }
+    async waitForDisconnect(timeout) {
+        if (!this.connected) {
+            this.log("Waiting for disconnect but not connected");
+            return;
+        }
+        this.log(`Waiting for disconnect (timeout ${timeout})`);
+        try {
+            await Promise.race([
+                this.disconnectErrorPromise("wait"),
+                timeoutErrorAfter(timeout),
+            ]);
+        }
+        catch (e) {
+            if (e instanceof TimeoutError) {
+                this.error("Timeout waiting for disconnect");
+            }
+            if (!(e instanceof DisconnectError)) {
+                throw e;
+            }
+        }
+    }
+    /**
+     * Suitable for running a series of BLE interactions with an overall timeout
+     * and general disconnection
+     */
+    async raceDisconnectAndTimeout(promise, options = {}) {
+        if (!this.connected) {
+            throw new DisconnectError();
+        }
+        const actionName = options.actionName ?? "action";
+        const errorOnDisconnectPromise = this.disconnectErrorPromise(actionName);
+        return await Promise.race([
+            promise,
+            errorOnDisconnectPromise,
+            ...(options.timeout ? [timeoutErrorAfter(options.timeout)] : []),
+        ]);
+    }
+    disconnectErrorPromise(actionName) {
+        const { promise, callback } = disconnectErrorCallback(`Disconnected during ${actionName}`);
+        this.waitingForDisconnectEventCallbacks.push(callback);
+        return promise;
+    }
+    event(event) {
+        this.logging.event(event);
+    }
+    log(message) {
+        this.logging.log(message);
+    }
+    error(message, e) {
+        this.logging.error(message, e);
+    }
+    getNotificationKey(serviceId, characteristicId) {
+        return `${serviceId}:${characteristicId}`;
+    }
+    /**
+     * Bonds with device and handles the post-bond device state only returning
+     * when we can reattempt a connection with the device.
+     */
+    async connectHandlingBond() {
+        const startTime = Date.now();
+        const maybeJustBonded = await this.bondConnectDeviceInternal();
+        if (maybeJustBonded) {
+            // If we did just bond then the device disconnects after 2_000 and then
+            // resets after a further 13_000 In future we'd like a firmware change
+            // that means it doesn't reset when partial flashing is in progress.
+            this.log(isAndroid() ? "New bond" : "Potential new bond");
+            // On Android with micro:bit V1 we don't see this disconnect (just the 15s
+            // reboot) so we hit the timeout and then continue to reset into pairing
+            // mode.
+            // TODO: document what happens with iOS micro:bit V1 in the new bond case.
+            try {
+                await this.waitForDisconnect(3000);
+            }
+            catch (e) {
+                if (e instanceof TimeoutError) {
+                    this.log("No disconnect after bond, assuming connection is stable");
+                    if (!isAndroid()) {
+                        // We never knew for sure whether this was a new bond. Assume we
+                        // were already bonded on the basis we didn't get disconnected.
+                        return;
+                    }
+                }
+                else {
+                    throw e;
+                }
+            }
+            await this.connectInternal();
+            // TODO: check this is needed, potentially inline into connect if always needed
+            await delay(500);
+            this.log("Resetting to pairing mode");
+            const pf = new PartialFlashingService(this);
+            await pf.resetToMode(MicroBitMode.Pairing);
+            await this.waitForDisconnect(10_000);
+            await this.connectInternal();
+            this.log(`Connection ready; took ${Date.now() - startTime}`);
+        }
+    }
+    async bondConnectDeviceInternal() {
+        const { deviceId } = this.device;
+        if (isAndroid()) {
+            let justBonded = false;
+            // This gets us a nicer pairing dialog than just going straight for the characteristic.
+            if (!(await BleClient.isBonded(deviceId))) {
+                await BleClient.createBond(deviceId, { timeout: bondingTimeoutInMs });
+                justBonded = true;
+            }
+            await this.connectInternal();
+            return justBonded;
+        }
+        else {
+            // Long timeout as this is the point that the pairing dialog will show.
+            // If this responds very quickly maybe we could assume there was a bond?
+            // At the moment we always do the disconnect dance so subsequent code will
+            // need to call startNotifications again. We need to be connected to
+            // startNotifications.
+            await this.connectInternal();
+            const pf = new PartialFlashingService(this);
+            await pf.startNotifications({ timeout: bondingTimeoutInMs });
+            // We just did it now to trigger pairing at a well defined point.
+            await pf.stopNotifications();
+            return true;
+        }
+    }
+}
+//# sourceMappingURL=bluetooth-device-wrapper.js.map

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

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

package/build/esm/bluetooth-profile.d.ts

@@ -0,0 +1,147 @@
+export declare const profile: {
+    accelerometer: {
+        id: string;
+        characteristics: {
+            data: {
+                id: string;
+            };
+            period: {
+                id: string;
+            };
+        };
+    };
+    button: {
+        id: string;
+        characteristics: {
+            a: {
+                id: string;
+            };
+            b: {
+                id: string;
+            };
+        };
+    };
+    deviceInformation: {
+        id: string;
+        characteristics: {
+            firmwareRevision: {
+                id: string;
+            };
+            hardwareRevision: {
+                id: string;
+            };
+            manufacturer: {
+                id: string;
+            };
+            modelNumber: {
+                id: string;
+            };
+            serialNumber: {
+                id: string;
+            };
+        };
+    };
+    dfuControl: {
+        id: string;
+        characteristics: {
+            control: {
+                id: string;
+            };
+        };
+    };
+    event: {
+        id: string;
+        characteristics: {
+            clientEvent: {
+                id: string;
+            };
+            clientRequirements: {
+                id: string;
+            };
+            microBitEvent: {
+                id: string;
+            };
+            microBitRequirements: {
+                id: string;
+            };
+        };
+    };
+    ioPin: {
+        id: string;
+        characteristics: {
+            pinAdConfiguration: {
+                id: string;
+            };
+            pinData: {
+                id: string;
+            };
+            pinIoConfiguration: {
+                id: string;
+            };
+            pwmControl: {
+                id: string;
+            };
+        };
+    };
+    led: {
+        id: string;
+        characteristics: {
+            matrixState: {
+                id: string;
+            };
+            scrollingDelay: {
+                id: string;
+            };
+            text: {
+                id: string;
+            };
+        };
+    };
+    magnetometer: {
+        id: string;
+        characteristics: {
+            data: {
+                id: string;
+            };
+            period: {
+                id: string;
+            };
+            bearing: {
+                id: string;
+            };
+            calibration: {
+                id: string;
+            };
+        };
+    };
+    partialFlashing: {
+        id: string;
+        characteristics: {
+            partialFlash: {
+                id: string;
+            };
+        };
+    };
+    temperature: {
+        id: string;
+        characteristics: {
+            data: {
+                id: string;
+            };
+            period: {
+                id: string;
+            };
+        };
+    };
+    uart: {
+        id: string;
+        characteristics: {
+            rx: {
+                id: string;
+            };
+            tx: {
+                id: string;
+            };
+        };
+    };
+};