@microbit/microbit-connection 0.9.0-apps.alpha.15 → 0.9.0-apps.alpha.17

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

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createRadioBridgeConnection = void 0;
+/**
+ * @module @microbit/microbit-connection/radio-bridge
+ */
+var connection_js_1 = require("./connection.js");
+Object.defineProperty(exports, "createRadioBridgeConnection", { enumerable: true, get: function () { return connection_js_1.createRadioBridgeConnection; } });
+//# sourceMappingURL=index.js.map

package/build/cjs/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,iDAIyB;AAHvB,4HAAA,2BAA2B,OAAA"}

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

@@ -180,4 +180,4 @@ const generateRandomRadioFrequency = () => {
     return Math.floor(Math.random() * 84);
 };
 exports.generateRandomRadioFrequency = generateRandomRadioFrequency;
-//# sourceMappingURL=usb-serial-protocol.js.map
+//# sourceMappingURL=serial-protocol.js.map

package/build/cjs/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/cjs/service-events.d.ts

@@ -1,17 +1,45 @@
-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;
+}
+type FixedArray<T, L extends number> = T[] & {
+    length: L;
+};
+type LedRow = FixedArray<boolean, 5>;
+export type LedMatrix = FixedArray<LedRow, 5>;
+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/cjs/service-events.js

@@ -1,39 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ServiceConnectionEventMap = void 0;
-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
-        });
-    }
-}
-exports.ServiceConnectionEventMap = ServiceConnectionEventMap;
+exports.ButtonState = void 0;
+exports.ButtonState = {
+    NotPressed: 0,
+    ShortPress: 1,
+    LongPress: 2,
+};
 //# sourceMappingURL=service-events.js.map

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

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

package/build/cjs/setupTests.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * (c) 2024, Micro:bit Educational Foundation and contributors
+ *
+ * SPDX-License-Identifier: MIT
+ */
+//# sourceMappingURL=setupTests.js.map

package/build/cjs/setupTests.js.map

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

package/build/{esm/hex-flash-data-source.d.ts → cjs/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/cjs/{hex-flash-data-source.js → universal-hex/flash-data-source.js}

@@ -1,20 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.createUniversalHexFlashDataSource = exports.truncateHexAfterEof = void 0;
-const board_id_js_1 = require("./board-id.js");
-const device_js_1 = require("./device.js");
+exports.createUniversalHexFlashDataSource = void 0;
+// This module is deliberately kept separate so that
+// @microbit/microbit-universal-hex can be tree-shaken by bundlers
+// when consumers don't use createUniversalHexFlashDataSource.
+const board_id_js_1 = require("../board-id.js");
+const device_js_1 = require("../device.js");
 const microbit_universal_hex_1 = require("@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.
-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";
-};
-exports.truncateHexAfterEof = truncateHexAfterEof;
 /**
  * A flash data source that converts universal hex files as needed.
  *
@@ -34,4 +26,4 @@ const createUniversalHexFlashDataSource = (universalHex) => {
     };
 };
 exports.createUniversalHexFlashDataSource = createUniversalHexFlashDataSource;
-//# sourceMappingURL=hex-flash-data-source.js.map
+//# sourceMappingURL=flash-data-source.js.map

package/build/cjs/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,gDAAyC;AACzC,4CAIsB;AACtB,6EAG0C;AAE1C;;;;GAIG;AACI,MAAM,iCAAiC,GAAG,CAC/C,YAAoB,EACH,EAAE;IACnB,OAAO,CAAC,YAA0B,EAAE,EAAE;QACpC,IAAI,IAAA,uCAAc,EAAC,YAAY,CAAC,EAAE,CAAC;YACjC,MAAM,KAAK,GAAG,IAAA,6CAAoB,EAAC,YAAY,CAAC,CAAC;YACjD,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,CACzB,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,IAAI,qBAAO,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC,EAAE,CACxD,CAAC;YACF,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,MAAM,IAAI,0BAAc,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;AAhBW,QAAA,iCAAiC,qCAgB5C"}

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

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

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

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createUniversalHexFlashDataSource = void 0;
+/**
+ * @module @microbit/microbit-connection/universal-hex
+ */
+var flash_data_source_js_1 = require("./flash-data-source.js");
+Object.defineProperty(exports, "createUniversalHexFlashDataSource", { enumerable: true, get: function () { return flash_data_source_js_1.createUniversalHexFlashDataSource; } });
+//# sourceMappingURL=index.js.map

package/build/cjs/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,+DAA2E;AAAlE,yIAAA,iCAAiC,OAAA"}

package/build/cjs/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): 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>;
+}