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

package/build/esm/usb/arm-debug.d.ts

@@ -0,0 +1,137 @@
+/**
+ * (c) 2026, Micro:bit Educational Foundation and contributors
+ *
+ * Derived from dapjs (https://github.com/ARMmbed/dapjs) which is
+ * Copyright (c) Arm Limited 2018
+ * Copyright (c) Microsoft Corporation
+ *
+ * SPDX-License-Identifier: MIT
+ *
+ * ARM Debug Interface (ADI) layer for SWD access to a Cortex-M target,
+ * derived from dapjs (https://github.com/ARMmbed/dapjs). This file and
+ * its siblings (transport.ts, cmsis-dap.ts, cortex-m.ts, daplink.ts)
+ * are a minimal reimplementation covering only the features needed for
+ * micro:bit.
+ *
+ * ArmDebugSwd manages the SWD connection lifecycle and provides
+ * register-level access to the Debug Port (DP) and Access Port (AP).
+ * It sits between CmsisDapUsb (command framing) and higher-level consumers
+ * like CortexM (processor control) and DAPLink (flash/serial).
+ *
+ * Key responsibilities:
+ * - SWD initialisation sequence (JTAG-to-SWD switch, power-up, ID read)
+ * - Automatic drain-and-retry on stale USB responses after page reload
+ * - DP_SELECT and AP_CSW register caching to reduce redundant writes
+ * - Memory read/write via AP_TAR + AP_DRW, handling page boundaries
+ *   and block-transfer size limits
+ *
+ * Protocol references:
+ * - ARM ADI: https://developer.arm.com/documentation/ihi0031/a/
+ * - DAPLink: https://github.com/ARMmbed/DAPLink
+ *
+ * The dapjs license is included below:
+ *
+ * DAPjs
+ * Copyright (c) Arm Limited 2018
+ * Copyright (c) Microsoft Corporation
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+ * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
+ * IN THE SOFTWARE.
+ */
+import { Logging } from "../logging.js";
+import { type CmsisDap, DapOperation } from "./cmsis-dap.js";
+export declare function waitFor(fn: () => Promise<boolean>, timeout?: number, delay?: number): Promise<void>;
+export interface ArmDebug {
+    readonly dap: CmsisDap;
+    readonly isOpen: boolean;
+    /** Read a 32-bit word from a memory-mapped address. */
+    readMem32(address: number): Promise<number>;
+    /** Write a 32-bit word to a memory-mapped address. */
+    writeMem32(address: number, value: number): Promise<void>;
+    /** Build DAP operations for reading a 32-bit word (for use with transferSequence). */
+    readMem32Ops(address: number): DapOperation[];
+    /** Build DAP operations for writing a 32-bit word (for use with transferSequence). */
+    writeMem32Ops(address: number, value: number): DapOperation[];
+    /**
+     * Read a block of 32-bit words from memory.
+     * Handles TAR auto-increment page boundaries and block size limits.
+     */
+    readBlock(address: number, count: number): Promise<Uint32Array>;
+    /**
+     * Write a block of 32-bit words to memory.
+     * Handles TAR auto-increment page boundaries and block size limits.
+     */
+    writeBlock(address: number, values: Uint32Array): Promise<void>;
+    /**
+     * Execute a sequence of operation groups as individual transfers.
+     * Each group is sent as a separate DAP_TRANSFER to guarantee that
+     * all operations within a group execute atomically on the wire.
+     */
+    transferSequence(groups: DapOperation[][]): Promise<Uint32Array>;
+    /**
+     * Reset cached protocol state without closing the transport.
+     * Call after operations that reset the target (e.g. DAPLink flash reset).
+     */
+    resetState(): void;
+    /**
+     * Connect to the target with automatic drain-and-retry on stale responses.
+     */
+    connect(maxRetries?: number): Promise<void>;
+    disconnect(): Promise<void>;
+    /**
+     * Reset cached state and reconnect without closing the transport.
+     * Use after operations like DAPLink flash that leave the protocol state
+     * stale but don't require full re-enumeration.
+     */
+    reinit(): Promise<void>;
+}
+export declare class ArmDebugSwd implements ArmDebug {
+    readonly dap: CmsisDap;
+    private logging;
+    private swdConnected;
+    private selectedAddress?;
+    private cswValue?;
+    constructor(dap: CmsisDap, logging: Logging);
+    get isOpen(): boolean;
+    /**
+     * Initialize SWD: connect to the target, set up the debug port,
+     * and power up the debug and system domains.
+     */
+    private connectOnce;
+    connect(maxRetries?: number): Promise<void>;
+    resetState(): void;
+    disconnect(): Promise<void>;
+    reinit(): Promise<void>;
+    private readDPOps;
+    private writeDPOps;
+    private readAPOps;
+    private writeAPOps;
+    readMem32Ops(address: number): DapOperation[];
+    writeMem32Ops(address: number, value: number): DapOperation[];
+    /**
+     * Execute a batch of DAP transfer operations, deduplicating writes
+     * to DP_SELECT and AP_CSW that match cached state.
+     */
+    private transfer;
+    transferSequence(groups: DapOperation[][]): Promise<Uint32Array>;
+    private readDP;
+    readMem32(address: number): Promise<number>;
+    writeMem32(address: number, value: number): Promise<void>;
+    readBlock(address: number, count: number): Promise<Uint32Array>;
+    writeBlock(address: number, values: Uint32Array): Promise<void>;
+}

package/build/esm/usb/arm-debug.js

@@ -0,0 +1,409 @@
+/**
+ * (c) 2026, Micro:bit Educational Foundation and contributors
+ *
+ * Derived from dapjs (https://github.com/ARMmbed/dapjs) which is
+ * Copyright (c) Arm Limited 2018
+ * Copyright (c) Microsoft Corporation
+ *
+ * SPDX-License-Identifier: MIT
+ *
+ * ARM Debug Interface (ADI) layer for SWD access to a Cortex-M target,
+ * derived from dapjs (https://github.com/ARMmbed/dapjs). This file and
+ * its siblings (transport.ts, cmsis-dap.ts, cortex-m.ts, daplink.ts)
+ * are a minimal reimplementation covering only the features needed for
+ * micro:bit.
+ *
+ * ArmDebugSwd manages the SWD connection lifecycle and provides
+ * register-level access to the Debug Port (DP) and Access Port (AP).
+ * It sits between CmsisDapUsb (command framing) and higher-level consumers
+ * like CortexM (processor control) and DAPLink (flash/serial).
+ *
+ * Key responsibilities:
+ * - SWD initialisation sequence (JTAG-to-SWD switch, power-up, ID read)
+ * - Automatic drain-and-retry on stale USB responses after page reload
+ * - DP_SELECT and AP_CSW register caching to reduce redundant writes
+ * - Memory read/write via AP_TAR + AP_DRW, handling page boundaries
+ *   and block-transfer size limits
+ *
+ * Protocol references:
+ * - ARM ADI: https://developer.arm.com/documentation/ihi0031/a/
+ * - DAPLink: https://github.com/ARMmbed/DAPLink
+ *
+ * The dapjs license is included below:
+ *
+ * DAPjs
+ * Copyright (c) Arm Limited 2018
+ * Copyright (c) Microsoft Corporation
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+ * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
+ * IN THE SOFTWARE.
+ */
+import { DeviceError } from "../device.js";
+import { ABORT_ALL, AP, DapResponseMismatchError, DP, READ, WRITE, } from "./cmsis-dap.js";
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+// DP registers
+const DP_ABORT = 0x0;
+const DP_DPIDR = 0x0;
+const DP_CTRL_STAT = 0x4;
+const DP_SELECT = 0x8;
+// AP registers (values are byte addresses, pre-shifted to match the DAP
+// transfer operation encoding where bits [3:2] carry A[3:2])
+const AP_CSW = 0x00;
+const AP_TAR = 0x04;
+const AP_DRW = 0x0c;
+// CSW mask values
+const CSW_SIZE32 = 1 << 1;
+const CSW_ADDRINC_SINGLE = 1 << 4;
+const CSW_DBGSTATUS = 1 << 6;
+const CSW_RESERVED = 1 << 24;
+const CSW_HPROT1 = 1 << 25;
+const CSW_MASTERTYPE = 1 << 29;
+const CSW_VALUE = CSW_ADDRINC_SINGLE |
+    CSW_DBGSTATUS |
+    CSW_RESERVED |
+    CSW_HPROT1 |
+    CSW_MASTERTYPE;
+// Bank select masks
+const APSEL = 0xff000000;
+const APBANKSEL = 0x000000f0;
+// CTRL/STAT register bits
+const CSYSPWRUPREQ = 1 << 30;
+const CDBGPWRUPREQ = 1 << 28;
+const CSYSPWRUPACK = 1 << 31;
+const CDBGPWRUPACK = 1 << 29;
+// TAR auto-increment page size (1KB, implementation-defined minimum)
+const AUTOINC_PAGESIZE = 1 << 10;
+// Clock frequency (10 MHz)
+const CLOCK_FREQUENCY = 10_000_000;
+// Wait delay for polling loops
+const WAIT_DELAY = 100;
+// ---------------------------------------------------------------------------
+// Utilities
+// ---------------------------------------------------------------------------
+export async function waitFor(fn, timeout = 10_000, delay = WAIT_DELAY) {
+    const deadline = timeout > 0 ? Date.now() + timeout : 0;
+    while (true) {
+        if (await fn())
+            return;
+        if (deadline && Date.now() > deadline) {
+            throw new DeviceError({
+                code: "timeout",
+                message: "Wait timed out",
+            });
+        }
+        await new Promise((resolve) => setTimeout(resolve, delay));
+    }
+}
+function concatUint32Arrays(arrays) {
+    if (arrays.length === 1)
+        return arrays[0];
+    let length = 0;
+    for (const a of arrays)
+        length += a.length;
+    const result = new Uint32Array(length);
+    let offset = 0;
+    for (const a of arrays) {
+        result.set(a, offset);
+        offset += a.length;
+    }
+    return result;
+}
+export class ArmDebugSwd {
+    constructor(dap, logging) {
+        Object.defineProperty(this, "dap", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: dap
+        });
+        Object.defineProperty(this, "logging", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: logging
+        });
+        Object.defineProperty(this, "swdConnected", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: false
+        });
+        // ADI state (register caching)
+        Object.defineProperty(this, "selectedAddress", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "cswValue", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+    }
+    get isOpen() {
+        return this.dap.isOpen;
+    }
+    // ---- SWD lifecycle ----
+    /**
+     * Initialize SWD: connect to the target, set up the debug port,
+     * and power up the debug and system domains.
+     */
+    async connectOnce() {
+        if (this.swdConnected)
+            return;
+        await this.dap.open();
+        // SWD protocol setup. On failure the transport is left open so the
+        // caller can drain stale responses and retry without re-opening.
+        try {
+            await this.dap.swjClock(CLOCK_FREQUENCY);
+            await this.dap.connect();
+        }
+        catch (error) {
+            try {
+                await this.dap.clearAbort();
+            }
+            catch {
+                /* ignore */
+            }
+            throw error;
+        }
+        await this.dap.configureTransfer(0, 100, 0);
+        // Select SWD protocol
+        await this.dap.swjSequence(new Uint8Array([0xff, 0xff, 0xff, 0xff, 0xff, 0xff, 0xff]));
+        await this.dap.swjSequence(new Uint8Array([0x9e, 0xe7]));
+        await this.dap.swjSequence(new Uint8Array([0xff, 0xff, 0xff, 0xff, 0xff, 0xff, 0xff]));
+        await this.dap.swjSequence(new Uint8Array([0x00]));
+        this.swdConnected = true;
+        // Initialize debug port and power up
+        try {
+            await this.readDP(DP_DPIDR);
+            await this.transferSequence([
+                this.writeDPOps(DP_ABORT, ABORT_ALL),
+                this.writeDPOps(DP_SELECT, AP_CSW),
+                this.writeDPOps(DP_CTRL_STAT, CSYSPWRUPREQ | CDBGPWRUPREQ),
+            ]);
+            const mask = CDBGPWRUPACK | CSYSPWRUPACK;
+            await waitFor(async () => {
+                const status = await this.readDP(DP_CTRL_STAT);
+                return (status & mask) === mask;
+            }, 5000);
+        }
+        catch (error) {
+            await this.disconnect();
+            throw error;
+        }
+        this.logging.log("SWD connected");
+    }
+    async connect(maxRetries = 3) {
+        let lastError;
+        for (let attempt = 0; attempt < maxRetries; attempt++) {
+            try {
+                if (attempt > 0) {
+                    this.logging.log(`Connection retry attempt ${attempt + 1}/${maxRetries}`);
+                    await this.dap.drainStaleResponses();
+                }
+                await this.connectOnce();
+                return;
+            }
+            catch (e) {
+                if (e instanceof DapResponseMismatchError) {
+                    lastError = e;
+                    this.logging.log(`Stale response during connect: ${e.message}`);
+                    continue;
+                }
+                throw e;
+            }
+        }
+        throw lastError || new Error("Connection failed after retries");
+    }
+    resetState() {
+        this.swdConnected = false;
+        this.selectedAddress = undefined;
+        this.cswValue = undefined;
+    }
+    async disconnect() {
+        if (!this.swdConnected)
+            return;
+        try {
+            await this.dap.disconnect();
+        }
+        catch {
+            this.logging.log("Disconnect failed, clearing abort");
+            try {
+                await this.dap.clearAbort();
+            }
+            catch {
+                /* ignore */
+            }
+        }
+        await this.dap.close();
+        this.resetState();
+        this.logging.log("SWD disconnected");
+    }
+    async reinit() {
+        this.logging.log("Reinitialising SWD");
+        this.resetState();
+        await this.connectOnce();
+    }
+    // ---- DP/AP register helpers ----
+    readDPOps(register) {
+        return [{ mode: READ, port: DP, register }];
+    }
+    writeDPOps(register, value) {
+        return [{ mode: WRITE, port: DP, register, value }];
+    }
+    readAPOps(register) {
+        const address = (register & APSEL) | (register & APBANKSEL);
+        return [
+            ...this.writeDPOps(DP_SELECT, address),
+            { mode: READ, port: AP, register },
+        ];
+    }
+    writeAPOps(register, value) {
+        const address = (register & APSEL) | (register & APBANKSEL);
+        return [
+            ...this.writeDPOps(DP_SELECT, address),
+            { mode: WRITE, port: AP, register, value },
+        ];
+    }
+    readMem32Ops(address) {
+        return [
+            ...this.writeAPOps(AP_CSW, CSW_VALUE | CSW_SIZE32),
+            ...this.writeAPOps(AP_TAR, address),
+            ...this.readAPOps(AP_DRW),
+        ];
+    }
+    writeMem32Ops(address, value) {
+        return [
+            ...this.writeAPOps(AP_CSW, CSW_VALUE | CSW_SIZE32),
+            ...this.writeAPOps(AP_TAR, address),
+            ...this.writeAPOps(AP_DRW, value),
+        ];
+    }
+    // ---- Transfer with register caching ----
+    /**
+     * Execute a batch of DAP transfer operations, deduplicating writes
+     * to DP_SELECT and AP_CSW that match cached state.
+     */
+    async transfer(operations) {
+        const filtered = operations.filter((op) => {
+            if (op.mode !== WRITE)
+                return true;
+            if (op.port === DP && op.register === DP_SELECT) {
+                return op.value !== this.selectedAddress;
+            }
+            if (op.port === AP && op.register === AP_CSW) {
+                return op.value !== this.cswValue;
+            }
+            return true;
+        });
+        if (filtered.length === 0) {
+            return new Uint32Array(0);
+        }
+        try {
+            const result = await this.dap.transfer(filtered);
+            // Update cache on success
+            for (const op of filtered) {
+                if (op.mode !== WRITE)
+                    continue;
+                if (op.port === DP && op.register === DP_SELECT) {
+                    this.selectedAddress = op.value;
+                }
+                else if (op.port === AP && op.register === AP_CSW) {
+                    this.cswValue = op.value;
+                }
+            }
+            return result;
+        }
+        catch (error) {
+            // Transfer failed — invalidate the cache
+            this.selectedAddress = undefined;
+            this.cswValue = undefined;
+            throw error;
+        }
+    }
+    async transferSequence(groups) {
+        const results = [];
+        for (const group of groups) {
+            const result = await this.transfer(group);
+            results.push(result);
+        }
+        return concatUint32Arrays(results);
+    }
+    // ---- Memory operations ----
+    async readDP(register) {
+        const result = await this.transfer(this.readDPOps(register));
+        return result[0];
+    }
+    async readMem32(address) {
+        const result = await this.transfer(this.readMem32Ops(address));
+        return result[0];
+    }
+    async writeMem32(address, value) {
+        await this.transfer(this.writeMem32Ops(address, value));
+    }
+    async readBlock(address, count) {
+        const results = [];
+        let remaining = count;
+        let addr = address;
+        while (remaining > 0) {
+            const nextPageOffset = AUTOINC_PAGESIZE - (addr % AUTOINC_PAGESIZE);
+            const chunkWords = Math.min(remaining, nextPageOffset / 4);
+            await this.transferSequence([
+                this.writeAPOps(AP_CSW, CSW_VALUE | CSW_SIZE32),
+                this.writeAPOps(AP_TAR, addr),
+            ]);
+            let subRemaining = chunkWords;
+            while (subRemaining > 0) {
+                const subChunk = Math.min(subRemaining, Math.floor(this.dap.blockSize / 4));
+                const result = await this.dap.transferBlockRead(AP, AP_DRW, subChunk);
+                results.push(result);
+                subRemaining -= subChunk;
+            }
+            addr += chunkWords * 4;
+            remaining -= chunkWords;
+        }
+        return concatUint32Arrays(results);
+    }
+    async writeBlock(address, values) {
+        let index = 0;
+        let addr = address;
+        while (index < values.length) {
+            const nextPageOffset = AUTOINC_PAGESIZE - (addr % AUTOINC_PAGESIZE);
+            const chunkWords = Math.min(values.length - index, nextPageOffset / 4);
+            const chunk = values.slice(index, index + chunkWords);
+            await this.transferSequence([
+                this.writeAPOps(AP_CSW, CSW_VALUE | CSW_SIZE32),
+                this.writeAPOps(AP_TAR, addr),
+            ]);
+            let subIndex = 0;
+            while (subIndex < chunk.length) {
+                const subChunk = chunk.slice(subIndex, subIndex + Math.floor(this.dap.blockSize / 4));
+                await this.dap.transferBlockWrite(AP, AP_DRW, subChunk);
+                subIndex += Math.floor(this.dap.blockSize / 4);
+            }
+            addr += chunkWords * 4;
+            index += chunkWords;
+        }
+    }
+}
+//# sourceMappingURL=arm-debug.js.map

package/build/esm/usb/arm-debug.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"arm-debug.js","sourceRoot":"","sources":["../../../src/usb/arm-debug.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsDG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C,OAAO,EACL,SAAS,EACT,EAAE,EAGF,wBAAwB,EACxB,EAAE,EACF,IAAI,EACJ,KAAK,GACN,MAAM,gBAAgB,CAAC;AAExB,8EAA8E;AAC9E,YAAY;AACZ,8EAA8E;AAE9E,eAAe;AACf,MAAM,QAAQ,GAAG,GAAG,CAAC;AACrB,MAAM,QAAQ,GAAG,GAAG,CAAC;AACrB,MAAM,YAAY,GAAG,GAAG,CAAC;AACzB,MAAM,SAAS,GAAG,GAAG,CAAC;AAEtB,wEAAwE;AACxE,6DAA6D;AAC7D,MAAM,MAAM,GAAG,IAAI,CAAC;AACpB,MAAM,MAAM,GAAG,IAAI,CAAC;AACpB,MAAM,MAAM,GAAG,IAAI,CAAC;AAEpB,kBAAkB;AAClB,MAAM,UAAU,GAAG,CAAC,IAAI,CAAC,CAAC;AAC1B,MAAM,kBAAkB,GAAG,CAAC,IAAI,CAAC,CAAC;AAClC,MAAM,aAAa,GAAG,CAAC,IAAI,CAAC,CAAC;AAC7B,MAAM,YAAY,GAAG,CAAC,IAAI,EAAE,CAAC;AAC7B,MAAM,UAAU,GAAG,CAAC,IAAI,EAAE,CAAC;AAC3B,MAAM,cAAc,GAAG,CAAC,IAAI,EAAE,CAAC;AAC/B,MAAM,SAAS,GACb,kBAAkB;IAClB,aAAa;IACb,YAAY;IACZ,UAAU;IACV,cAAc,CAAC;AAEjB,oBAAoB;AACpB,MAAM,KAAK,GAAG,UAAU,CAAC;AACzB,MAAM,SAAS,GAAG,UAAU,CAAC;AAE7B,0BAA0B;AAC1B,MAAM,YAAY,GAAG,CAAC,IAAI,EAAE,CAAC;AAC7B,MAAM,YAAY,GAAG,CAAC,IAAI,EAAE,CAAC;AAC7B,MAAM,YAAY,GAAG,CAAC,IAAI,EAAE,CAAC;AAC7B,MAAM,YAAY,GAAG,CAAC,IAAI,EAAE,CAAC;AAE7B,qEAAqE;AACrE,MAAM,gBAAgB,GAAG,CAAC,IAAI,EAAE,CAAC;AAEjC,2BAA2B;AAC3B,MAAM,eAAe,GAAG,UAAU,CAAC;AAEnC,+BAA+B;AAC/B,MAAM,UAAU,GAAG,GAAG,CAAC;AAEvB,8EAA8E;AAC9E,YAAY;AACZ,8EAA8E;AAE9E,MAAM,CAAC,KAAK,UAAU,OAAO,CAC3B,EAA0B,EAC1B,OAAO,GAAG,MAAM,EAChB,KAAK,GAAG,UAAU;IAElB,MAAM,QAAQ,GAAG,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;IACxD,OAAO,IAAI,EAAE,CAAC;QACZ,IAAI,MAAM,EAAE,EAAE;YAAE,OAAO;QACvB,IAAI,QAAQ,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,EAAE,CAAC;YACtC,MAAM,IAAI,WAAW,CAAC;gBACpB,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,gBAAgB;aAC1B,CAAC,CAAC;QACL,CAAC;QACD,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;IAC7D,CAAC;AACH,CAAC;AAED,SAAS,kBAAkB,CAAC,MAAqB;IAC/C,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC;IAC1C,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,KAAK,MAAM,CAAC,IAAI,MAAM;QAAE,MAAM,IAAI,CAAC,CAAC,MAAM,CAAC;IAC3C,MAAM,MAAM,GAAG,IAAI,WAAW,CAAC,MAAM,CAAC,CAAC;IACvC,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QACvB,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;QACtB,MAAM,IAAI,CAAC,CAAC,MAAM,CAAC;IACrB,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AA8DD,MAAM,OAAO,WAAW;IAOtB,YACW,GAAa,EACd,OAAgB;QADxB;;;;mBAAS,GAAG;WAAU;QACtB;;;;mBAAQ,OAAO;WAAS;QARlB;;;;mBAAe,KAAK;WAAC;QAE7B,+BAA+B;QACvB;;;;;WAAyB;QACzB;;;;;WAAkB;IAKvB,CAAC;IAEJ,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC;IACzB,CAAC;IAED,0BAA0B;IAE1B;;;OAGG;IACK,KAAK,CAAC,WAAW;QACvB,IAAI,IAAI,CAAC,YAAY;YAAE,OAAO;QAE9B,MAAM,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;QAEtB,mEAAmE;QACnE,iEAAiE;QACjE,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC;YACzC,MAAM,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;QAC3B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC;gBACH,MAAM,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,CAAC;YAC9B,CAAC;YAAC,MAAM,CAAC;gBACP,YAAY;YACd,CAAC;YACD,MAAM,KAAK,CAAC;QACd,CAAC;QAED,MAAM,IAAI,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;QAE5C,sBAAsB;QACtB,MAAM,IAAI,CAAC,GAAG,CAAC,WAAW,CACxB,IAAI,UAAU,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAC3D,CAAC;QACF,MAAM,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,UAAU,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;QACzD,MAAM,IAAI,CAAC,GAAG,CAAC,WAAW,CACxB,IAAI,UAAU,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAC3D,CAAC;QACF,MAAM,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,UAAU,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAEnD,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;QAEzB,qCAAqC;QACrC,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YAE5B,MAAM,IAAI,CAAC,gBAAgB,CAAC;gBAC1B,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE,SAAS,CAAC;gBACpC,IAAI,CAAC,UAAU,CAAC,SAAS,EAAE,MAAM,CAAC;gBAClC,IAAI,CAAC,UAAU,CAAC,YAAY,EAAE,YAAY,GAAG,YAAY,CAAC;aAC3D,CAAC,CAAC;YAEH,MAAM,IAAI,GAAG,YAAY,GAAG,YAAY,CAAC;YACzC,MAAM,OAAO,CAAC,KAAK,IAAI,EAAE;gBACvB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;gBAC/C,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,KAAK,IAAI,CAAC;YAClC,CAAC,EAAE,IAAI,CAAC,CAAC;QACX,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,CAAC,UAAU,EAAE,CAAC;YACxB,MAAM,KAAK,CAAC;QACd,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;IACpC,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,UAAU,GAAG,CAAC;QAC1B,IAAI,SAA4B,CAAC;QACjC,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,GAAG,UAAU,EAAE,OAAO,EAAE,EAAE,CAAC;YACtD,IAAI,CAAC;gBACH,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;oBAChB,IAAI,CAAC,OAAO,CAAC,GAAG,CACd,4BAA4B,OAAO,GAAG,CAAC,IAAI,UAAU,EAAE,CACxD,CAAC;oBACF,MAAM,IAAI,CAAC,GAAG,CAAC,mBAAmB,EAAE,CAAC;gBACvC,CAAC;gBACD,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;gBACzB,OAAO;YACT,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,IAAI,CAAC,YAAY,wBAAwB,EAAE,CAAC;oBAC1C,SAAS,GAAG,CAAC,CAAC;oBACd,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,kCAAkC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;oBAChE,SAAS;gBACX,CAAC;gBACD,MAAM,CAAC,CAAC;YACV,CAAC;QACH,CAAC;QACD,MAAM,SAAS,IAAI,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;IAClE,CAAC;IAED,UAAU;QACR,IAAI,CAAC,YAAY,GAAG,KAAK,CAAC;QAC1B,IAAI,CAAC,eAAe,GAAG,SAAS,CAAC;QACjC,IAAI,CAAC,QAAQ,GAAG,SAAS,CAAC;IAC5B,CAAC;IAED,KAAK,CAAC,UAAU;QACd,IAAI,CAAC,IAAI,CAAC,YAAY;YAAE,OAAO;QAC/B,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,CAAC;QAC9B,CAAC;QAAC,MAAM,CAAC;YACP,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,mCAAmC,CAAC,CAAC;YACtD,IAAI,CAAC;gBACH,MAAM,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,CAAC;YAC9B,CAAC;YAAC,MAAM,CAAC;gBACP,YAAY;YACd,CAAC;QACH,CAAC;QACD,MAAM,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC;QACvB,IAAI,CAAC,UAAU,EAAE,CAAC;QAClB,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;IACvC,CAAC;IAED,KAAK,CAAC,MAAM;QACV,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;QACvC,IAAI,CAAC,UAAU,EAAE,CAAC;QAClB,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;IAC3B,CAAC;IAED,mCAAmC;IAE3B,SAAS,CAAC,QAAgB;QAChC,OAAO,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;IAC9C,CAAC;IAEO,UAAU,CAAC,QAAgB,EAAE,KAAa;QAChD,OAAO,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC;IACtD,CAAC;IAEO,SAAS,CAAC,QAAgB;QAChC,MAAM,OAAO,GAAG,CAAC,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,QAAQ,GAAG,SAAS,CAAC,CAAC;QAC5D,OAAO;YACL,GAAG,IAAI,CAAC,UAAU,CAAC,SAAS,EAAE,OAAO,CAAC;YACtC,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,QAAQ,EAAE;SACnC,CAAC;IACJ,CAAC;IAEO,UAAU,CAAC,QAAgB,EAAE,KAAa;QAChD,MAAM,OAAO,GAAG,CAAC,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,QAAQ,GAAG,SAAS,CAAC,CAAC;QAC5D,OAAO;YACL,GAAG,IAAI,CAAC,UAAU,CAAC,SAAS,EAAE,OAAO,CAAC;YACtC,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE;SAC3C,CAAC;IACJ,CAAC;IAED,YAAY,CAAC,OAAe;QAC1B,OAAO;YACL,GAAG,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,SAAS,GAAG,UAAU,CAAC;YAClD,GAAG,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,OAAO,CAAC;YACnC,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC;SAC1B,CAAC;IACJ,CAAC;IAED,aAAa,CAAC,OAAe,EAAE,KAAa;QAC1C,OAAO;YACL,GAAG,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,SAAS,GAAG,UAAU,CAAC;YAClD,GAAG,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,OAAO,CAAC;YACnC,GAAG,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,KAAK,CAAC;SAClC,CAAC;IACJ,CAAC;IAED,2CAA2C;IAE3C;;;OAGG;IACK,KAAK,CAAC,QAAQ,CAAC,UAA0B;QAC/C,MAAM,QAAQ,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE;YACxC,IAAI,EAAE,CAAC,IAAI,KAAK,KAAK;gBAAE,OAAO,IAAI,CAAC;YACnC,IAAI,EAAE,CAAC,IAAI,KAAK,EAAE,IAAI,EAAE,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;gBAChD,OAAO,EAAE,CAAC,KAAK,KAAK,IAAI,CAAC,eAAe,CAAC;YAC3C,CAAC;YACD,IAAI,EAAE,CAAC,IAAI,KAAK,EAAE,IAAI,EAAE,CAAC,QAAQ,KAAK,MAAM,EAAE,CAAC;gBAC7C,OAAO,EAAE,CAAC,KAAK,KAAK,IAAI,CAAC,QAAQ,CAAC;YACpC,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC,CAAC,CAAC;QAEH,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC1B,OAAO,IAAI,WAAW,CAAC,CAAC,CAAC,CAAC;QAC5B,CAAC;QAED,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;YAEjD,0BAA0B;YAC1B,KAAK,MAAM,EAAE,IAAI,QAAQ,EAAE,CAAC;gBAC1B,IAAI,EAAE,CAAC,IAAI,KAAK,KAAK;oBAAE,SAAS;gBAChC,IAAI,EAAE,CAAC,IAAI,KAAK,EAAE,IAAI,EAAE,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;oBAChD,IAAI,CAAC,eAAe,GAAG,EAAE,CAAC,KAAK,CAAC;gBAClC,CAAC;qBAAM,IAAI,EAAE,CAAC,IAAI,KAAK,EAAE,IAAI,EAAE,CAAC,QAAQ,KAAK,MAAM,EAAE,CAAC;oBACpD,IAAI,CAAC,QAAQ,GAAG,EAAE,CAAC,KAAK,CAAC;gBAC3B,CAAC;YACH,CAAC;YAED,OAAO,MAAM,CAAC;QAChB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,yCAAyC;YACzC,IAAI,CAAC,eAAe,GAAG,SAAS,CAAC;YACjC,IAAI,CAAC,QAAQ,GAAG,SAAS,CAAC;YAC1B,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED,KAAK,CAAC,gBAAgB,CAAC,MAAwB;QAC7C,MAAM,OAAO,GAAkB,EAAE,CAAC;QAClC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;YAC1C,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACvB,CAAC;QACD,OAAO,kBAAkB,CAAC,OAAO,CAAC,CAAC;IACrC,CAAC;IAED,8BAA8B;IAEtB,KAAK,CAAC,MAAM,CAAC,QAAgB;QACnC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC;QAC7D,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC;IACnB,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,OAAe;QAC7B,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC;QAC/D,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC;IACnB,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,OAAe,EAAE,KAAa;QAC7C,MAAM,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,aAAa,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;IAC1D,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,OAAe,EAAE,KAAa;QAC5C,MAAM,OAAO,GAAkB,EAAE,CAAC;QAClC,IAAI,SAAS,GAAG,KAAK,CAAC;QACtB,IAAI,IAAI,GAAG,OAAO,CAAC;QAEnB,OAAO,SAAS,GAAG,CAAC,EAAE,CAAC;YACrB,MAAM,cAAc,GAAG,gBAAgB,GAAG,CAAC,IAAI,GAAG,gBAAgB,CAAC,CAAC;YACpE,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,cAAc,GAAG,CAAC,CAAC,CAAC;YAE3D,MAAM,IAAI,CAAC,gBAAgB,CAAC;gBAC1B,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,SAAS,GAAG,UAAU,CAAC;gBAC/C,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,IAAI,CAAC;aAC9B,CAAC,CAAC;YAEH,IAAI,YAAY,GAAG,UAAU,CAAC;YAC9B,OAAO,YAAY,GAAG,CAAC,EAAE,CAAC;gBACxB,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CACvB,YAAY,EACZ,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,GAAG,CAAC,CAAC,CACnC,CAAC;gBACF,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,iBAAiB,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;gBACtE,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;gBACrB,YAAY,IAAI,QAAQ,CAAC;YAC3B,CAAC;YAED,IAAI,IAAI,UAAU,GAAG,CAAC,CAAC;YACvB,SAAS,IAAI,UAAU,CAAC;QAC1B,CAAC;QAED,OAAO,kBAAkB,CAAC,OAAO,CAAC,CAAC;IACrC,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,OAAe,EAAE,MAAmB;QACnD,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,IAAI,IAAI,GAAG,OAAO,CAAC;QAEnB,OAAO,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC;YAC7B,MAAM,cAAc,GAAG,gBAAgB,GAAG,CAAC,IAAI,GAAG,gBAAgB,CAAC,CAAC;YACpE,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,GAAG,KAAK,EAAE,cAAc,GAAG,CAAC,CAAC,CAAC;YACvE,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,GAAG,UAAU,CAAC,CAAC;YAEtD,MAAM,IAAI,CAAC,gBAAgB,CAAC;gBAC1B,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,SAAS,GAAG,UAAU,CAAC;gBAC/C,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,IAAI,CAAC;aAC9B,CAAC,CAAC;YAEH,IAAI,QAAQ,GAAG,CAAC,CAAC;YACjB,OAAO,QAAQ,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;gBAC/B,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,CAC1B,QAAQ,EACR,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,GAAG,CAAC,CAAC,CAC9C,CAAC;gBACF,MAAM,IAAI,CAAC,GAAG,CAAC,kBAAkB,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;gBACxD,QAAQ,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC;YACjD,CAAC;YAED,IAAI,IAAI,UAAU,GAAG,CAAC,CAAC;YACvB,KAAK,IAAI,UAAU,CAAC;QACtB,CAAC;IACH,CAAC;CACF"}

package/build/{cjs → esm/usb}/board-serial-info.d.ts

@@ -3,12 +3,13 @@
  *
  * SPDX-License-Identifier: MIT
  */
-import { BoardId } from "./board-id.js";
+import { BoardId } from "../board-id.js";
 export declare class BoardSerialInfo {
     id: BoardId;
     familyId: string;
     hic: string;
     constructor(id: BoardId, familyId: string, hic: string);
+    static fromSerial(serial: string, log: (msg: string) => void): BoardSerialInfo;
     static parse(device: USBDevice, log: (msg: string) => void): BoardSerialInfo;
     eq(other: BoardSerialInfo): boolean;
 }

package/build/esm/{board-serial-info.js → usb/board-serial-info.js}

@@ -3,7 +3,7 @@
  *
  * SPDX-License-Identifier: MIT
  */
-import { BoardId } from "./board-id.js";
+import { BoardId } from "../board-id.js";
 export class BoardSerialInfo {
     constructor(id, familyId, hic) {
         Object.defineProperty(this, "id", {
@@ -25,19 +25,22 @@ export class BoardSerialInfo {
             value: hic
         });
     }
-    static parse(device, log) {
-        const serial = device.serialNumber;
-        if (!serial) {
-            throw new Error("Could not detected ID from connected board.");
-        }
+    static fromSerial(serial, log) {
         if (serial.length !== 48) {
-            log(`USB serial number unexpected length: ${serial.length}`);
+            log(`Serial number unexpected length: ${serial.length}`);
         }
         const id = serial.substring(0, 4);
         const familyId = serial.substring(4, 8);
         const hic = serial.slice(-8);
         return new BoardSerialInfo(BoardId.parse(id), familyId, hic);
     }
+    static parse(device, log) {
+        const serial = device.serialNumber;
+        if (!serial) {
+            throw new Error("Could not detected ID from connected board.");
+        }
+        return BoardSerialInfo.fromSerial(serial, log);
+    }
     eq(other) {
         return (other.id === this.id &&
             other.familyId === this.familyId &&

package/build/esm/usb/board-serial-info.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"board-serial-info.js","sourceRoot":"","sources":["../../../src/usb/board-serial-info.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAEzC,MAAM,OAAO,eAAe;IAC1B,YACS,EAAW,EACX,QAAgB,EAChB,GAAW;QAFlB;;;;mBAAO,EAAE;WAAS;QAClB;;;;mBAAO,QAAQ;WAAQ;QACvB;;;;mBAAO,GAAG;WAAQ;IACjB,CAAC;IAEJ,MAAM,CAAC,UAAU,CAAC,MAAc,EAAE,GAA0B;QAC1D,IAAI,MAAM,CAAC,MAAM,KAAK,EAAE,EAAE,CAAC;YACzB,GAAG,CAAC,oCAAoC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;QAC3D,CAAC;QACD,MAAM,EAAE,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAClC,MAAM,QAAQ,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QACxC,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QAC7B,OAAO,IAAI,eAAe,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,QAAQ,EAAE,GAAG,CAAC,CAAC;IAC/D,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,MAAiB,EAAE,GAA0B;QACxD,MAAM,MAAM,GAAG,MAAM,CAAC,YAAY,CAAC;QACnC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;QACjE,CAAC;QACD,OAAO,eAAe,CAAC,UAAU,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACjD,CAAC;IAED,EAAE,CAAC,KAAsB;QACvB,OAAO,CACL,KAAK,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE;YACpB,KAAK,CAAC,QAAQ,KAAK,IAAI,CAAC,QAAQ;YAChC,KAAK,CAAC,GAAG,KAAK,IAAI,CAAC,GAAG,CACvB,CAAC;IACJ,CAAC;CACF"}

package/build/esm/usb/cdc-saturation.d.ts

@@ -0,0 +1,36 @@
+/**
+ * (c) 2026, Micro:bit Educational Foundation and contributors
+ *
+ * SPDX-License-Identifier: MIT
+ */
+/**
+ * CDC pipeline saturation
+ *
+ * DAPLink's CDC serial path and WebUSB vendor serial reads share the same
+ * UART ring buffer. After a physical USB connection, CDC consumes early
+ * serial bytes before our vendor reads can get them, causing truncated
+ * output. See: https://github.com/ARMmbed/DAPLink/issues/903
+ *
+ * Workaround: before flashing, push dummy data through the target's UART
+ * to fill DAPLink's internal buffers. When nobody is reading from the CDC
+ * serial port, the CDC TX buffer fills first, then cdc_process_event()
+ * stops pulling from the UART RX ring buffer, and that fills too. Once
+ * both are full, all subsequent UART data overflows harmlessly and
+ * post-flash serial output is left for our vendor reads.
+ *
+ * V1 (nRF51) uses a Thumb blob for the legacy byte-at-a-time UART.
+ * V2 (nRF52833) uses SWD register writes to trigger a UARTE DMA transfer.
+ *
+ * V1 DAPLink defaults to 9600 baud on fresh USB connection, so we call
+ * setBaudrate(115200) before saturation to ensure DAPLink can decode the
+ * bytes we send.
+ */
+import { BoardVersion } from "../device.js";
+import { Logging } from "../logging.js";
+import { type USBDeviceWrapper } from "./device-wrapper.js";
+/**
+ * Push dummy data through the target's UART to fill DAPLink's internal
+ * CDC buffers, preventing CDC from consuming post-flash serial output.
+ * Must be called while the target is halted.
+ */
+export declare function saturateCdcPipeline(device: USBDeviceWrapper, boardVersion: BoardVersion, logging: Logging): Promise<void>;