@hangtime/grip-connect 0.10.9 → 0.13.0

package/dist/models/nordic.model.js

@@ -0,0 +1,393 @@
+import { Device } from "./device.model.js";
+const NORDIC_DFU_SERVICE_UUID = "0000fe59-0000-1000-8000-00805f9b34fb";
+const DFU_PACKET_SIZE = 20;
+// Keep CRC values in signed int32 form so they compare directly with DataView.getInt32() responses from the bootloader.
+const CRC32_TABLE = (() => {
+    const table = new Int32Array(256);
+    for (let index = 0; index < 256; index++) {
+        let crc = index;
+        for (let bit = 0; bit < 8; bit++) {
+            crc = (crc & 1) !== 0 ? 0xedb88320 ^ (crc >>> 1) : crc >>> 1;
+        }
+        table[index] = crc | 0;
+    }
+    return table;
+})();
+/**
+ * Creates a fresh Nordic Secure DFU service definition.
+ * Characteristics are mutable at runtime, so each device instance needs its own copy.
+ * @returns {Service} A new DFU service descriptor with control, packet, and buttonless characteristics.
+ */
+export function createNordicDfuService() {
+    return {
+        name: "Nordic Device Firmware Update (DFU) Service",
+        id: "dfu",
+        uuid: NORDIC_DFU_SERVICE_UUID,
+        characteristics: [
+            {
+                name: "DFU Control Point",
+                id: "control",
+                uuid: "8ec90001-f315-4f60-9fb8-838830daea50",
+            },
+            {
+                name: "DFU Packet",
+                id: "packet",
+                uuid: "8ec90002-f315-4f60-9fb8-838830daea50",
+            },
+            {
+                name: "Buttonless DFU",
+                id: "buttonless",
+                uuid: "8ec90003-f315-4f60-9fb8-838830daea50",
+            },
+        ],
+    };
+}
+/**
+ * Shared Nordic Secure DFU implementation for devices exposing the FE59 service.
+ */
+export class NordicDfuDevice extends Device {
+    /**
+     * Returns a cached DFU characteristic discovered during the current GATT session.
+     * @param {"control" | "packet" | "buttonless"} characteristicId - The DFU characteristic identifier.
+     * @returns {BluetoothRemoteGATTCharacteristic | undefined} The discovered characteristic, if available.
+     */
+    getDfuCharacteristic(characteristicId) {
+        return this.services
+            .find((service) => service.id === "dfu")
+            ?.characteristics.find((characteristic) => characteristic.id === characteristicId)?.characteristic;
+    }
+    /**
+     * Checks whether the connected device is already exposing the DFU bootloader characteristics.
+     * @returns {boolean} `true` when both control and packet characteristics are available.
+     */
+    hasDfuBootloaderCharacteristics() {
+        return this.getDfuCharacteristic("control") != null && this.getDfuCharacteristic("packet") != null;
+    }
+    /**
+     * Wraps the shared connect flow so DFU callers get a rejected promise when connection setup fails.
+     * @returns {Promise<void>} Resolves when discovery is complete.
+     */
+    async connectForDfu() {
+        await new Promise((resolve, reject) => {
+            void this.connect(() => resolve(), (error) => reject(error));
+        });
+    }
+    /**
+     * Prompts for a Bluetooth device matching the provided filters, then runs the normal service discovery flow.
+     * @param {BluetoothLEScanFilter[]} filters - Alternative device filters to pass to `requestDevice`.
+     * @returns {Promise<void>} Resolves after the selected device is connected and characteristics are cached.
+     */
+    async requestAndConnectDfuDevice(filters) {
+        const bluetooth = await this.getBluetooth();
+        // Clear any stale GATT state before replacing the selected device with the bootloader identity.
+        this.disconnect();
+        delete this.bluetooth;
+        this.bluetooth = await bluetooth.requestDevice({
+            filters,
+            optionalServices: this.getAllServiceUUIDs(),
+        });
+        await this.connectForDfu();
+    }
+    /**
+     * Ensures there is an active connection to either the application or DFU bootloader variant of the device.
+     * @returns {Promise<void>} Resolves after a DFU-capable device has been connected and discovered.
+     */
+    async ensureDfuCapableConnection() {
+        if (this.bluetooth?.gatt) {
+            try {
+                await this.connectForDfu();
+                return;
+            }
+            catch {
+                // If the previously granted device no longer reconnects, fall back to a fresh picker.
+                this.disconnect();
+                delete this.bluetooth;
+            }
+        }
+        await this.requestAndConnectDfuDevice([...this.filters, { services: [NORDIC_DFU_SERVICE_UUID] }]);
+    }
+    /**
+     * Prompts for the rebooted Nordic DFU bootloader after the application switches into buttonless DFU mode.
+     * @returns {Promise<void>} Resolves after the bootloader device is selected and connected.
+     */
+    async connectDfuBootloader() {
+        try {
+            await this.requestAndConnectDfuDevice([{ services: [NORDIC_DFU_SERVICE_UUID] }]);
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : "Unknown error";
+            const wrappedError = new Error(`Device entered DFU mode. Select the Nordic DFU bootloader to continue. ${message}`);
+            wrappedError.cause = error;
+            throw wrappedError;
+        }
+        if (!this.hasDfuBootloaderCharacteristics()) {
+            throw new Error("Selected device did not expose the Nordic DFU control and packet characteristics.");
+        }
+    }
+    /**
+     * Normalizes DFU payload inputs to `Uint8Array` so packet slicing and CRC calculation use one byte representation.
+     * @param {Uint8Array | ArrayBuffer} data - Raw DFU payload bytes.
+     * @returns {Uint8Array} The payload as a `Uint8Array`.
+     */
+    toDfuBytes(data) {
+        return data instanceof Uint8Array ? data : new Uint8Array(data);
+    }
+    /**
+     * Calculates the Nordic Secure DFU CRC32 for the given payload prefix.
+     * @param {Uint8Array} data - The bytes to checksum.
+     * @returns {number} The signed 32-bit CRC value returned by Nordic DFU checksum responses.
+     */
+    dfuCrc32(data) {
+        let crc = 0xffffffff;
+        for (const byte of data) {
+            const tableEntry = CRC32_TABLE[(crc ^ byte) & 0xff];
+            if (tableEntry === undefined) {
+                throw new Error("CRC32 lookup index out of range");
+            }
+            crc = tableEntry ^ (crc >>> 8);
+        }
+        return (crc ^ 0xffffffff) | 0;
+    }
+    /**
+     * Formats a signed CRC value as an unsigned hexadecimal string for error messages.
+     * @param {number} crc - The CRC value to format.
+     * @returns {string} The CRC formatted as `0x????????`.
+     */
+    formatDfuCrc(crc) {
+        return `0x${(crc >>> 0).toString(16).padStart(8, "0")}`;
+    }
+    /**
+     * Transfers one Nordic Secure DFU object type, handling resume, chunking, checksum validation, and execute steps.
+     * @param {"command" | "data"} objectType - The DFU object type to transfer.
+     * @param {Uint8Array | ArrayBuffer} data - The full payload for that object type.
+     * @returns {Promise<void>} Resolves when the payload has been fully transferred and validated.
+     */
+    async dfuTransferObject(objectType, data) {
+        const bytes = this.toDfuBytes(data);
+        if (bytes.byteLength === 0) {
+            throw new Error(`DFU ${objectType.toUpperCase()} payload is required`);
+        }
+        const { maxSize, offset, crc } = await this.dfuSelect(objectType);
+        if (maxSize <= 0) {
+            throw new Error(`DFU ${objectType.toUpperCase()} maxSize ${maxSize} is invalid`);
+        }
+        if (offset > bytes.byteLength) {
+            throw new Error(`DFU ${objectType.toUpperCase()} offset ${offset} exceeds payload size ${bytes.byteLength}`);
+        }
+        // Validate the bootloader's resume point before sending more bytes; otherwise a resumed transfer could continue from a corrupt state.
+        if (offset > 0) {
+            const expectedCrc = this.dfuCrc32(bytes.slice(0, offset));
+            if (expectedCrc !== crc) {
+                throw new Error(`DFU ${objectType.toUpperCase()} resume CRC mismatch at offset ${offset}: expected ${this.formatDfuCrc(expectedCrc)}, got ${this.formatDfuCrc(crc)}`);
+            }
+        }
+        if (offset === bytes.byteLength) {
+            return;
+        }
+        // The bootloader may report an offset in the middle of an object; restart from that object's boundary.
+        for (let objectStart = offset - (offset % maxSize); objectStart < bytes.byteLength;) {
+            const objectEnd = Math.min(objectStart + maxSize, bytes.byteLength);
+            await this.dfuCreate(objectType, objectEnd - objectStart);
+            // Packet writes stay at 20 bytes for Web Bluetooth compatibility with the default ATT payload size.
+            for (let packetStart = objectStart; packetStart < objectEnd; packetStart += DFU_PACKET_SIZE) {
+                await this.dfuWritePacket(bytes.slice(packetStart, Math.min(packetStart + DFU_PACKET_SIZE, objectEnd)));
+            }
+            // Nordic reports checksum state for the whole transferred prefix, not just the current object chunk.
+            const state = await this.dfuChecksum();
+            if (state.offset !== objectEnd) {
+                throw new Error(`DFU ${objectType.toUpperCase()} checksum offset ${state.offset} did not match ${objectEnd}`);
+            }
+            const expectedCrc = this.dfuCrc32(bytes.slice(0, state.offset));
+            if (state.crc !== expectedCrc) {
+                throw new Error(`DFU ${objectType.toUpperCase()} checksum CRC mismatch at offset ${state.offset}: expected ${this.formatDfuCrc(expectedCrc)}, got ${this.formatDfuCrc(state.crc)}`);
+            }
+            await this.dfuExecute();
+            objectStart = state.offset;
+        }
+    }
+    /**
+     * Switches the device from application mode into the Nordic DFU bootloader.
+     * @returns {Promise<void>} Resolves after the device reboots into DFU mode and reconnects to the bootloader.
+     */
+    dfuSwitch = async () => {
+        // Reuse the existing connect/onConnected path, but subscribe to the buttonless DFU notifier.
+        this.notifyCharacteristicId = "buttonless";
+        try {
+            await this.ensureDfuCapableConnection();
+            if (this.hasDfuBootloaderCharacteristics()) {
+                return;
+            }
+            if (!this.getDfuCharacteristic("buttonless")) {
+                throw new Error('Characteristic "buttonless" not found in service "dfu".');
+            }
+            const device = this.bluetooth;
+            if (!device?.gatt?.connected) {
+                throw new Error("Device must be connected before entering DFU mode");
+            }
+            await new Promise((resolve, reject) => {
+                const cleanup = () => {
+                    device.removeEventListener("gattserverdisconnected", onDisconnected);
+                };
+                const onDisconnected = () => {
+                    // Entering buttonless DFU reboots the device, so disconnect is the success signal here.
+                    cleanup();
+                    resolve();
+                };
+                device.addEventListener("gattserverdisconnected", onDisconnected, { once: true });
+                // Opcode 0x01 requests a switch from application mode into the Nordic DFU bootloader.
+                this.write("dfu", "buttonless", new Uint8Array([0x01])).catch((error) => {
+                    cleanup();
+                    reject(error);
+                });
+            });
+            // After the reboot, prompt for the bootloader explicitly instead of assuming the browser will reconnect to the same BLE identity.
+            await this.connectDfuBootloader();
+        }
+        finally {
+            // Restore the normal application notify characteristic after the DFU transition attempt.
+            this.notifyCharacteristicId = "rx";
+        }
+    };
+    /**
+     * Sends a raw Nordic Secure DFU control operation and resolves with the response payload bytes.
+     * Call after dfuSwitch() has reconnected to the DFU bootloader.
+     * @param {Uint8Array} operation - The DFU control opcode bytes to send.
+     * @param {ArrayBuffer} [payload] - Optional payload appended to the opcode.
+     * @returns {Promise<Uint8Array>} Resolves with the response payload bytes after the 3-byte Nordic response header.
+     */
+    dfuControl = async (operation, payload) => {
+        if (operation.length === 0) {
+            throw new Error("DFU control operation is required");
+        }
+        const control = this.getDfuCharacteristic("control");
+        if (!control) {
+            throw new Error('Characteristic "control" not found in service "dfu". Call dfuSwitch() first.');
+        }
+        const value = new Uint8Array(operation.length + (payload?.byteLength ?? 0));
+        value.set(operation);
+        if (payload) {
+            value.set(new Uint8Array(payload), operation.length);
+        }
+        await control.startNotifications();
+        return await new Promise((resolve, reject) => {
+            const cleanup = () => {
+                control.removeEventListener("characteristicvaluechanged", onNotification);
+            };
+            const onNotification = (event) => {
+                const target = event.target;
+                const view = target.value;
+                // Control responses are framed as 0x60 <opcode> <status> [...payload].
+                if (!view || view.getUint8(0) !== 0x60 || view.getUint8(1) !== operation[0]) {
+                    return;
+                }
+                cleanup();
+                const status = view.getUint8(2);
+                if (status === 0x01) {
+                    const response = new Uint8Array(view.buffer, view.byteOffset + 3, view.byteLength - 3);
+                    resolve(Uint8Array.from(response));
+                    return;
+                }
+                if (status === 0x0b && view.byteLength > 3) {
+                    reject(new Error(`DFU control failed with extended error 0x${view.getUint8(3).toString(16).padStart(2, "0")}`));
+                    return;
+                }
+                reject(new Error(`DFU control failed with status 0x${status.toString(16).padStart(2, "0")}`));
+            };
+            control.addEventListener("characteristicvaluechanged", onNotification);
+            control.writeValue(value).catch((error) => {
+                cleanup();
+                reject(error);
+            });
+        });
+    };
+    /**
+     * Sends Nordic Secure DFU SELECT for command or data objects and returns the bootloader state.
+     * @param {"command" | "data"} objectType - The object type to query.
+     * @returns {Promise<{ maxSize: number; offset: number; crc: number }>} The bootloader's object size, offset, and CRC state.
+     */
+    dfuSelect = async (objectType) => {
+        const response = await this.dfuControl(new Uint8Array([0x06, objectType === "command" ? 0x01 : 0x02]));
+        if (response.byteLength < 12) {
+            throw new Error("DFU SELECT response was shorter than expected");
+        }
+        const view = new DataView(response.buffer, response.byteOffset, response.byteLength);
+        return {
+            maxSize: view.getUint32(0, true),
+            offset: view.getUint32(4, true),
+            crc: view.getInt32(8, true),
+        };
+    };
+    /**
+     * Sends Nordic Secure DFU CREATE for command or data objects.
+     * @param {"command" | "data"} objectType - The object type to create.
+     * @param {number} size - The size of the object chunk to allocate in bytes.
+     * @returns {Promise<void>} Resolves when the bootloader accepts the object allocation request.
+     */
+    dfuCreate = async (objectType, size) => {
+        if (!Number.isFinite(size) || size < 0) {
+            throw new Error("DFU CREATE size must be a non-negative number");
+        }
+        const payload = new ArrayBuffer(4);
+        new DataView(payload).setUint32(0, size, true);
+        await this.dfuControl(new Uint8Array([0x01, objectType === "command" ? 0x01 : 0x02]), payload);
+    };
+    /**
+     * Writes raw bytes to the Nordic Secure DFU packet characteristic.
+     * @param {Uint8Array | ArrayBuffer} data - The packet payload bytes to send.
+     * @returns {Promise<void>} Resolves after the packet has been written.
+     */
+    dfuWritePacket = async (data) => {
+        await this.write("dfu", "packet", data instanceof Uint8Array ? data : new Uint8Array(data), 0);
+    };
+    /**
+     * Sends Nordic Secure DFU CALCULATE_CHECKSUM and returns the bootloader state.
+     * @returns {Promise<{ offset: number; crc: number }>} The bootloader's transferred offset and CRC for the current object stream.
+     */
+    dfuChecksum = async () => {
+        const response = await this.dfuControl(new Uint8Array([0x03]));
+        if (response.byteLength < 8) {
+            throw new Error("DFU CHECKSUM response was shorter than expected");
+        }
+        const view = new DataView(response.buffer, response.byteOffset, response.byteLength);
+        return {
+            offset: view.getUint32(0, true),
+            crc: view.getInt32(4, true),
+        };
+    };
+    /**
+     * Sends Nordic Secure DFU EXECUTE for the currently created object.
+     * @returns {Promise<void>} Resolves when the bootloader executes the current DFU object.
+     */
+    dfuExecute = async () => {
+        await this.dfuControl(new Uint8Array([0x04]));
+    };
+    /**
+     * Runs a complete Nordic Secure DFU upload: switch to bootloader, send init packet, then send firmware.
+     * @param {Uint8Array | ArrayBuffer} initPacket - The Nordic Secure DFU init packet bytes.
+     * @param {Uint8Array | ArrayBuffer} firmware - The firmware image bytes to upload.
+     * @returns {Promise<void>} Resolves after the firmware upload completes and the bootloader disconnects to reboot.
+     */
+    dfuUpload = async (initPacket, firmware) => {
+        await this.dfuSwitch();
+        await this.dfuTransferObject("command", initPacket);
+        const device = this.bluetooth;
+        if (!device?.gatt?.connected) {
+            throw new Error("Device disconnected before firmware transfer started");
+        }
+        // Attach the listener before the final data phase so a fast reboot cannot disconnect before we start waiting.
+        const waitForDisconnect = new Promise((resolve) => {
+            const onDisconnected = () => {
+                device.removeEventListener("gattserverdisconnected", onDisconnected);
+                resolve();
+            };
+            device.addEventListener("gattserverdisconnected", onDisconnected, { once: true });
+        });
+        await this.dfuTransferObject("data", firmware);
+        // Some browsers observe the disconnect before the awaited transfer returns, so avoid waiting twice.
+        if (!device.gatt?.connected) {
+            return;
+        }
+        await waitForDisconnect;
+    };
+}
+//# sourceMappingURL=nordic.model.js.map

package/dist/models/nordic.model.js.map

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