@microbit/microbit-connection 0.9.0-apps.alpha.16 → 0.9.0-apps.alpha.18

package/build/esm/{usb-radio-bridge.js → radio-bridge/connection.js}

@@ -3,19 +3,16 @@
  *
  * SPDX-License-Identifier: MIT
  */
-import { AccelerometerDataEvent } from "./accelerometer.js";
-import { ButtonEvent, ButtonState } from "./buttons.js";
-import { ConnectionStatus, ConnectionStatusEvent, } from "./device.js";
-import { TypedEventTarget } from "./events.js";
-import { ConsoleLogging } from "./logging.js";
-import * as protocol from "./usb-serial-protocol.js";
+import { ConnectionStatus, DeviceError, } from "../device.js";
+import { TypedEventTarget } from "../events.js";
+import { ConsoleLogging } from "../logging.js";
+import { ButtonState, } from "../service-events.js";
+import * as protocol from "./serial-protocol.js";
 const connectTimeoutDuration = 10_000;
-class BridgeError extends Error {
-}
-class RemoteError extends Error {
-}
 /**
  * A radio bridge connection factory.
+ *
+ * @experimental See {@link MicrobitRadioBridgeConnection} for limitations.
  */
 export const createRadioBridgeConnection = (delegate, options) => new MicrobitRadioBridgeConnectionImpl(delegate, options);
 /**
@@ -32,6 +29,12 @@ class MicrobitRadioBridgeConnectionImpl extends TypedEventTarget {
             writable: true,
             value: delegate
         });
+        Object.defineProperty(this, "type", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: "radio-bridge"
+        });
         Object.defineProperty(this, "status", {
             enumerable: true,
             configurable: true,
@@ -74,12 +77,12 @@ class MicrobitRadioBridgeConnectionImpl extends TypedEventTarget {
             writable: true,
             value: (e) => {
                 const currentStatus = this.status;
-                if (e.status !== ConnectionStatus.CONNECTED) {
+                if (e.status !== ConnectionStatus.Connected) {
                     this.setStatus(e.status);
                     // Don't dispose the serial session when PAUSED - USB is temporarily
                     // unavailable due to tab visibility, but we'll reconnect when visible.
                     // Attempting dispose would fail anyway since USB is disconnected.
-                    if (e.status === ConnectionStatus.PAUSED) {
+                    if (e.status === ConnectionStatus.Paused) {
                         // Clear timestamp so stale values don't trigger reconnection when resuming.
                         this.serialSession?.clearLastReceivedTimestamp();
                     }
@@ -89,11 +92,11 @@ class MicrobitRadioBridgeConnectionImpl extends TypedEventTarget {
                     }
                 }
                 else {
-                    this.status = ConnectionStatus.DISCONNECTED;
+                    this.status = ConnectionStatus.Disconnected;
                     // Reconnect the serial session if we were previously paused.
                     // PAUSED means the USB connection was temporarily suspended due to tab
                     // visibility, and now the tab is visible again so we should reconnect.
-                    const shouldReconnect = currentStatus === ConnectionStatus.PAUSED;
+                    const shouldReconnect = currentStatus === ConnectionStatus.Paused;
                     if (shouldReconnect && this.serialSessionOpen) {
                         this.serialSession?.connect();
                     }
@@ -134,7 +137,10 @@ class MicrobitRadioBridgeConnectionImpl extends TypedEventTarget {
         // TODO: previously this skipped overlapping connect attempts but that seems awkward
         // can we... just not do that? or wait?
         if (this.remoteDeviceId === undefined) {
-            throw new BridgeError(`Missing remote micro:bit ID`);
+            throw new DeviceError({
+                code: "connection-error",
+                message: "Missing remote micro:bit ID",
+            });
         }
         this.logging.event({
             type: "Connect",
@@ -142,22 +148,22 @@ class MicrobitRadioBridgeConnectionImpl extends TypedEventTarget {
         });
         await this.delegate.connect();
         try {
-            this.serialSession = new RadioBridgeSerialSession(this.logging, this.remoteDeviceId, this.delegate, this.dispatchTypedEvent.bind(this), {
+            this.serialSession = new RadioBridgeSerialSession(this.logging, this.remoteDeviceId, this.delegate, this.dispatchEvent.bind(this), {
                 onConnecting: () => {
-                    this.setStatus(ConnectionStatus.CONNECTING);
+                    this.setStatus(ConnectionStatus.Connecting);
                     this.serialSessionOpen = true;
                 },
                 onFailPreDispose: () => {
                     this.serialSessionOpen = false;
                 },
                 onFailPostDispose: () => {
-                    if (this.status !== ConnectionStatus.DISCONNECTED) {
-                        this.setStatus(ConnectionStatus.DISCONNECTED);
+                    if (this.status !== ConnectionStatus.Disconnected) {
+                        this.setStatus(ConnectionStatus.Disconnected);
                     }
                 },
                 onSuccess: () => {
-                    if (this.status !== ConnectionStatus.CONNECTED) {
-                        this.setStatus(ConnectionStatus.CONNECTED);
+                    if (this.status !== ConnectionStatus.Connected) {
+                        this.setStatus(ConnectionStatus.Connected);
                     }
                     this.serialSessionOpen = true;
                 },
@@ -195,11 +201,14 @@ class MicrobitRadioBridgeConnectionImpl extends TypedEventTarget {
         const previousStatus = this.status;
         this.status = newStatus;
         this.log("Radio connection status " + newStatus);
-        this.dispatchTypedEvent("status", new ConnectionStatusEvent(newStatus, previousStatus));
+        this.dispatchEvent("status", {
+            status: newStatus,
+            previousStatus,
+        });
     }
     statusFromDelegate() {
-        return this.delegate.status == ConnectionStatus.CONNECTED
-            ? ConnectionStatus.DISCONNECTED
+        return this.delegate.status == ConnectionStatus.Connected
+            ? ConnectionStatus.Disconnected
             : this.delegate.status;
     }
 }
@@ -210,7 +219,12 @@ class RadioBridgeSerialSession {
     processButton(button, type, sensorData) {
         if (sensorData[button] !== this.previousButtonState[button]) {
             this.previousButtonState[button] = sensorData[button];
-            this.dispatchTypedEvent(type, new ButtonEvent(type, sensorData[button] ? ButtonState.ShortPress : ButtonState.NotPressed));
+            this.dispatchTypedEvent(type, {
+                button: type === "buttonachanged" ? "A" : "B",
+                state: sensorData[button]
+                    ? ButtonState.ShortPress
+                    : ButtonState.NotPressed,
+            });
         }
     }
     constructor(logging, remoteDeviceId, delegate, dispatchTypedEvent, callbacks) {
@@ -274,7 +288,7 @@ class RadioBridgeSerialSession {
             writable: true,
             value: void 0
         });
-        Object.defineProperty(this, "serialErrorListener", {
+        Object.defineProperty(this, "backgroundErrorListener", {
             enumerable: true,
             configurable: true,
             writable: true,
@@ -297,11 +311,11 @@ class RadioBridgeSerialSession {
                     const sensorData = protocol.processPeriodicMessage(msg);
                     if (sensorData) {
                         this.onPeriodicMessageReceived?.();
-                        this.dispatchTypedEvent("accelerometerdatachanged", new AccelerometerDataEvent({
+                        this.dispatchTypedEvent("accelerometerdatachanged", {
                             x: sensorData.accelerometerX,
                             y: sensorData.accelerometerY,
                             z: sensorData.accelerometerZ,
-                        }));
+                        });
                         this.processButton("buttonA", "buttonachanged", sensorData);
                         this.processButton("buttonB", "buttonbchanged", sensorData);
                     }
@@ -328,7 +342,7 @@ class RadioBridgeSerialSession {
     }
     async connect() {
         this.delegate.addEventListener("serialdata", this.serialDataListener);
-        this.delegate.addEventListener("serialerror", this.serialErrorListener);
+        this.delegate.addEventListener("backgrounderror", this.backgroundErrorListener);
         try {
             this.callbacks.onConnecting();
             await this.handshake();
@@ -337,7 +351,10 @@ class RadioBridgeSerialSession {
             const remoteMbIdResponse = await this.sendCmdWaitResponse(remoteMbIdCommand);
             if (remoteMbIdResponse.type === protocol.ResponseTypes.Error ||
                 remoteMbIdResponse.value !== this.remoteDeviceId) {
-                throw new BridgeError(`Failed to set remote micro:bit ID. Expected ${this.remoteDeviceId}, got ${remoteMbIdResponse.value}`);
+                throw new DeviceError({
+                    code: "connection-error",
+                    message: `Failed to set remote micro:bit ID. Expected ${this.remoteDeviceId}, got ${remoteMbIdResponse.value}`,
+                });
             }
             // Request the micro:bit to start sending the periodic messages
             const startCmd = protocol.generateCmdStart({
@@ -353,7 +370,10 @@ class RadioBridgeSerialSession {
             });
             const startCmdResponse = await this.sendCmdWaitResponse(startCmd);
             if (startCmdResponse.type === protocol.ResponseTypes.Error) {
-                throw new RemoteError(`Failed to start streaming sensors data. Error response received: ${startCmdResponse.message}`);
+                throw new DeviceError({
+                    code: "connection-error",
+                    message: `Failed to start streaming sensors data. Error response received: ${startCmdResponse.message}`,
+                });
             }
             // TODO: in the first-time connection case we used to move the error/disconnect to the background here, why? timing?
             await periodicMessagePromise;
@@ -364,6 +384,7 @@ class RadioBridgeSerialSession {
             this.callbacks.onFailPreDispose();
             await this.dispose();
             this.callbacks.onFailPostDispose();
+            throw e;
         }
     }
     async dispose(disconnect = false) {
@@ -376,11 +397,16 @@ class RadioBridgeSerialSession {
         }
         this.responseMap.clear();
         this.delegate.removeEventListener("serialdata", this.serialDataListener);
-        this.delegate.removeEventListener("serialerror", this.serialErrorListener);
+        this.delegate.removeEventListener("backgrounderror", this.backgroundErrorListener);
         if (disconnect) {
             await this.delegate.disconnect();
         }
-        await this.delegate.softwareReset();
+        try {
+            await this.delegate.softwareReset();
+        }
+        catch {
+            // May already be disconnected.
+        }
     }
     async sendCmdWaitResponse(cmd) {
         const responsePromise = new Promise((resolve, reject) => {
@@ -399,7 +425,7 @@ class RadioBridgeSerialSession {
             this.connectionCheckIntervalId = setInterval(async () => {
                 // Don't check connection while USB is paused/disconnected.
                 // The check will resume when USB reconnects.
-                if (this.delegate.status !== ConnectionStatus.CONNECTED) {
+                if (this.delegate.status !== ConnectionStatus.Connected) {
                     return;
                 }
                 if (this.lastReceivedMessageTimestamp &&
@@ -452,7 +478,10 @@ class RadioBridgeSerialSession {
                     // We expect some to time out, likely well after the handshake is completed.
                     if (!resolved) {
                         if (++failureCounter === attempts) {
-                            reject(new BridgeError("Handshake not completed"));
+                            reject(new DeviceError({
+                                code: "timeout",
+                                message: "Handshake not completed",
+                            }));
                         }
                     }
                 });
@@ -460,8 +489,11 @@ class RadioBridgeSerialSession {
             }
         });
         if (handshakeResult.value !== protocol.version) {
-            throw new BridgeError(`Handshake failed. Unexpected protocol version ${protocol.version}`);
+            throw new DeviceError({
+                code: "connection-error",
+                message: `Handshake failed. Unexpected protocol version ${protocol.version}`,
+            });
         }
     }
 }
-//# sourceMappingURL=usb-radio-bridge.js.map
+//# sourceMappingURL=connection.js.map

package/build/esm/radio-bridge/connection.js.map

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

package/build/esm/radio-bridge/index.d.ts

@@ -0,0 +1,4 @@
+/**
+ * @module @microbit/microbit-connection/radio-bridge
+ */
+export { createRadioBridgeConnection, type MicrobitRadioBridgeConnection, type MicrobitRadioBridgeConnectionOptions, } from "./connection.js";

package/build/esm/radio-bridge/index.js

@@ -0,0 +1,5 @@
+/**
+ * @module @microbit/microbit-connection/radio-bridge
+ */
+export { createRadioBridgeConnection, } from "./connection.js";
+//# sourceMappingURL=index.js.map

package/build/esm/radio-bridge/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/radio-bridge/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EACL,2BAA2B,GAG5B,MAAM,iBAAiB,CAAC"}

package/build/esm/{usb-serial-protocol.js → radio-bridge/serial-protocol.js}

@@ -168,4 +168,4 @@ export const generateRandomRadioFrequency = () => {
     // The value range for radio frequencies is 0 to 83
     return Math.floor(Math.random() * 84);
 };
-//# sourceMappingURL=usb-serial-protocol.js.map
+//# sourceMappingURL=serial-protocol.js.map

package/build/esm/radio-bridge/serial-protocol.js.map

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

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

@@ -1,17 +1,46 @@
-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 interface AccelerometerData {
+    x: number;
+    y: number;
+    z: number;
 }
-export type CharacteristicDataTarget = EventTarget & {
-    value: DataView;
+export declare const ButtonState: {
+    readonly NotPressed: 0;
+    readonly ShortPress: 1;
+    readonly LongPress: 2;
 };
-export type TypedServiceEvent = keyof (ServiceConnectionEventMap & DeviceConnectionEventMap);
-export type TypedServiceEventDispatcher = (_type: TypedServiceEvent, event: (ServiceConnectionEventMap & DeviceConnectionEventMap)[TypedServiceEvent]) => boolean;
+export type ButtonState = (typeof ButtonState)[keyof typeof ButtonState];
+export type ButtonEventType = "buttonachanged" | "buttonbchanged";
+export interface ButtonData {
+    button: "A" | "B";
+    state: ButtonState;
+}
+/**
+ * A 5x5 boolean matrix representing the micro:bit LED display.
+ * Each inner array is a row of 5 booleans (left to right),
+ * and there are 5 rows (top to bottom).
+ */
+export type LedMatrix = boolean[][];
+export interface MagnetometerData {
+    x: number;
+    y: number;
+    z: number;
+}
+export interface UartData {
+    value: Uint8Array;
+}
+/**
+ * Events from BLE GATT service notifications (accelerometer, buttons,
+ * magnetometer, UART). Used by Bluetooth and radio bridge connections.
+ */
+export interface ServiceConnectionEventMap {
+    accelerometerdatachanged: AccelerometerData;
+    buttonachanged: ButtonData;
+    buttonbchanged: ButtonData;
+    magnetometerdatachanged: MagnetometerData;
+    uartdata: UartData;
+}
+type AllEventMap = ServiceConnectionEventMap & DeviceConnectionEventMap;
+export type TypedServiceEvent = keyof AllEventMap;
+export type TypedServiceEventDispatcher = <K extends TypedServiceEvent>(type: K, ...[data]: AllEventMap[K] extends void ? [] : [data: AllEventMap[K]]) => void;
+export {};

package/build/esm/service-events.js

@@ -1,35 +1,6 @@
-export class ServiceConnectionEventMap {
-    constructor() {
-        Object.defineProperty(this, "accelerometerdatachanged", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "buttonachanged", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "buttonbchanged", {
-            enumerable: true,
-            configurable: true,
-            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
-        });
-    }
-}
+export const ButtonState = {
+    NotPressed: 0,
+    ShortPress: 1,
+    LongPress: 2,
+};
 //# sourceMappingURL=service-events.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"service-events.js","sourceRoot":"","sources":["../../src/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"}
+{"version":3,"file":"service-events.js","sourceRoot":"","sources":["../../src/service-events.ts"],"names":[],"mappings":"AAQA,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,UAAU,EAAE,CAAC;IACb,UAAU,EAAE,CAAC;IACb,SAAS,EAAE,CAAC;CACJ,CAAC"}

package/build/{cjs/hex-flash-data-source.d.ts → esm/universal-hex/flash-data-source.d.ts}

@@ -1,5 +1,4 @@
-import { FlashDataSource } from "./device.js";
-export declare const truncateHexAfterEof: (hex: string) => string;
+import { FlashDataSource } from "../device.js";
 /**
  * A flash data source that converts universal hex files as needed.
  *

package/build/esm/{hex-flash-data-source.js → universal-hex/flash-data-source.js}

@@ -1,16 +1,9 @@
-import { BoardId } from "./board-id.js";
-import { FlashDataError as FlashDataError, } from "./device.js";
+// This module is deliberately kept separate so that
+// @microbit/microbit-universal-hex can be tree-shaken by bundlers
+// when consumers don't use createUniversalHexFlashDataSource.
+import { BoardId } from "../board-id.js";
+import { FlashDataError as FlashDataError, } from "../device.js";
 import { isUniversalHex, separateUniversalHex, } from "@microbit/microbit-universal-hex";
-// MakeCode hex files may contain embedded source in custom record types
-// (type 0x0E) after the EOF record, and older files may have trailing blank
-// lines. The nrf-intel-hex parser rejects any data after EOF, so we truncate.
-export const truncateHexAfterEof = (hex) => {
-    // The EOF record is :00000001FF (case-insensitive per the Intel HEX spec).
-    const eofIdx = hex.search(/:00000001FF/i);
-    if (eofIdx < 0)
-        return hex;
-    return hex.slice(0, eofIdx + ":00000001FF".length) + "\n";
-};
 /**
  * A flash data source that converts universal hex files as needed.
  *
@@ -29,4 +22,4 @@ export const createUniversalHexFlashDataSource = (universalHex) => {
         return Promise.resolve(universalHex);
     };
 };
-//# sourceMappingURL=hex-flash-data-source.js.map
+//# sourceMappingURL=flash-data-source.js.map

package/build/esm/universal-hex/flash-data-source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flash-data-source.js","sourceRoot":"","sources":["../../../src/universal-hex/flash-data-source.ts"],"names":[],"mappings":"AAAA,oDAAoD;AACpD,kEAAkE;AAClE,8DAA8D;AAC9D,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AACzC,OAAO,EACL,cAAc,IAAI,cAAc,GAGjC,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,cAAc,EACd,oBAAoB,GACrB,MAAM,kCAAkC,CAAC;AAE1C;;;;GAIG;AACH,MAAM,CAAC,MAAM,iCAAiC,GAAG,CAC/C,YAAoB,EACH,EAAE;IACnB,OAAO,CAAC,YAA0B,EAAE,EAAE;QACpC,IAAI,cAAc,CAAC,YAAY,CAAC,EAAE,CAAC;YACjC,MAAM,KAAK,GAAG,oBAAoB,CAAC,YAAY,CAAC,CAAC;YACjD,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,CACzB,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,IAAI,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC,EAAE,CACxD,CAAC;YACF,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,MAAM,IAAI,cAAc,CAAC,kBAAkB,CAAC,CAAC;YAC/C,CAAC;YACD,OAAO,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;QACvC,CAAC;QACD,OAAO,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;IACvC,CAAC,CAAC;AACJ,CAAC,CAAC"}

package/build/esm/universal-hex/index.d.ts

@@ -0,0 +1,4 @@
+/**
+ * @module @microbit/microbit-connection/universal-hex
+ */
+export { createUniversalHexFlashDataSource } from "./flash-data-source.js";

package/build/esm/universal-hex/index.js

@@ -0,0 +1,5 @@
+/**
+ * @module @microbit/microbit-connection/universal-hex
+ */
+export { createUniversalHexFlashDataSource } from "./flash-data-source.js";
+//# sourceMappingURL=index.js.map

package/build/esm/universal-hex/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/universal-hex/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,iCAAiC,EAAE,MAAM,wBAAwB,CAAC"}

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>;
+}