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

package/build/cjs/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ProgressStage = exports.assertConnected = exports.FlashDataError = exports.DeviceError = exports.ConnectionStatus = exports.ButtonState = void 0;
+exports.ProgressStage = exports.assertConnected = exports.GestureEvent = exports.FlashDataError = exports.DeviceError = exports.ConnectionStatus = exports.ButtonState = exports.ButtonAction = void 0;
 /**
  * @module @microbit/microbit-connection
  */
@@ -12,4 +12,7 @@ Object.defineProperty(exports, "ProgressStage", { enumerable: true, get: functio
 Object.defineProperty(exports, "assertConnected", { enumerable: true, get: function () { return device_js_1.assertConnected; } });
 const service_events_js_1 = require("./service-events.js");
 Object.defineProperty(exports, "ButtonState", { enumerable: true, get: function () { return service_events_js_1.ButtonState; } });
+const microbit_events_js_1 = require("./microbit-events.js");
+Object.defineProperty(exports, "ButtonAction", { enumerable: true, get: function () { return microbit_events_js_1.ButtonAction; } });
+Object.defineProperty(exports, "GestureEvent", { enumerable: true, get: function () { return microbit_events_js_1.GestureEvent; } });
 //# sourceMappingURL=index.js.map

package/build/cjs/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;AAAA;;GAEG;AACH,2CAgBqB;AAcnB,iGAzBA,4BAAgB,OAyBA;AAChB,4FAvBA,uBAAW,OAuBA;AACX,+FAtBA,0BAAc,OAsBA;AAEd,8FApBA,yBAAa,OAoBA;AADb,gGAlBA,2BAAe,OAkBA;AAfjB,2DAQ6B;AAG3B,4FAPA,+BAAW,OAOA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;AAAA;;GAEG;AACH,2CAgBqB;AAsBnB,iGAjCA,4BAAgB,OAiCA;AAChB,4FA/BA,uBAAW,OA+BA;AACX,+FA9BA,0BAAc,OA8BA;AAGd,8FA7BA,yBAAa,OA6BA;AADb,gGA3BA,2BAAe,OA2BA;AAxBjB,2DAc6B;AAK3B,4FAdA,+BAAW,OAcA;AAJb,6DAAkE;AAGhE,6FAHO,iCAAY,OAGP;AAKZ,6FARqB,iCAAY,OAQrB"}

package/build/cjs/microbit-events.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Well-known micro:bit message bus event source IDs and values.
+ *
+ * Source IDs differ between V1 (DAL) and V2 (CODAL). Event values are
+ * identical across versions (V2 adds TwoG to gesture values).
+ *
+ * @see https://lancaster-university.github.io/microbit-docs/
+ */
+/**
+ * Event source IDs for micro:bit V1 (DAL).
+ */
+export declare const V1Source: {
+    readonly ButtonA: 1;
+    readonly ButtonB: 2;
+    readonly ButtonAB: 26;
+    readonly Gesture: 27;
+};
+/**
+ * Event source IDs for micro:bit V2 (CODAL).
+ */
+export declare const V2Source: {
+    readonly ButtonA: 1;
+    readonly ButtonB: 2;
+    readonly ButtonAB: 3;
+    readonly Gesture: 13;
+    readonly Logo: 121;
+};
+export declare const EventSource: {
+    readonly v1: {
+        readonly ButtonA: 1;
+        readonly ButtonB: 2;
+        readonly ButtonAB: 26;
+        readonly Gesture: 27;
+    };
+    readonly v2: {
+        readonly ButtonA: 1;
+        readonly ButtonB: 2;
+        readonly ButtonAB: 3;
+        readonly Gesture: 13;
+        readonly Logo: 121;
+    };
+};
+export declare const GestureEvent: {
+    readonly TiltUp: 1;
+    readonly TiltDown: 2;
+    readonly TiltLeft: 3;
+    readonly TiltRight: 4;
+    readonly FaceUp: 5;
+    readonly FaceDown: 6;
+    readonly Freefall: 7;
+    readonly Acceleration3g: 8;
+    readonly Acceleration6g: 9;
+    readonly Acceleration8g: 10;
+    readonly Shake: 11;
+    /** V2 only. */
+    readonly Acceleration2g: 12;
+};
+export type GestureEvent = (typeof GestureEvent)[keyof typeof GestureEvent];
+export declare const ButtonAction: {
+    readonly Down: 1;
+    readonly Up: 2;
+    readonly Click: 3;
+    readonly LongClick: 4;
+    readonly Hold: 5;
+    readonly DoubleClick: 6;
+};
+export type ButtonAction = (typeof ButtonAction)[keyof typeof ButtonAction];

package/build/cjs/microbit-events.js

@@ -0,0 +1,55 @@
+"use strict";
+/**
+ * Well-known micro:bit message bus event source IDs and values.
+ *
+ * Source IDs differ between V1 (DAL) and V2 (CODAL). Event values are
+ * identical across versions (V2 adds TwoG to gesture values).
+ *
+ * @see https://lancaster-university.github.io/microbit-docs/
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ButtonAction = exports.GestureEvent = exports.EventSource = exports.V2Source = exports.V1Source = void 0;
+/**
+ * Event source IDs for micro:bit V1 (DAL).
+ */
+exports.V1Source = {
+    ButtonA: 1,
+    ButtonB: 2,
+    ButtonAB: 26,
+    Gesture: 27,
+};
+/**
+ * Event source IDs for micro:bit V2 (CODAL).
+ */
+exports.V2Source = {
+    ButtonA: 1,
+    ButtonB: 2,
+    ButtonAB: 3,
+    Gesture: 13,
+    Logo: 121,
+};
+exports.EventSource = { v1: exports.V1Source, v2: exports.V2Source };
+exports.GestureEvent = {
+    TiltUp: 1,
+    TiltDown: 2,
+    TiltLeft: 3,
+    TiltRight: 4,
+    FaceUp: 5,
+    FaceDown: 6,
+    Freefall: 7,
+    Acceleration3g: 8,
+    Acceleration6g: 9,
+    Acceleration8g: 10,
+    Shake: 11,
+    /** V2 only. */
+    Acceleration2g: 12,
+};
+exports.ButtonAction = {
+    Down: 1,
+    Up: 2,
+    Click: 3,
+    LongClick: 4,
+    Hold: 5,
+    DoubleClick: 6,
+};
+//# sourceMappingURL=microbit-events.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"microbit-events.js","sourceRoot":"","sources":["../../src/microbit-events.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;AAEH;;GAEG;AACU,QAAA,QAAQ,GAAG;IACtB,OAAO,EAAE,CAAC;IACV,OAAO,EAAE,CAAC;IACV,QAAQ,EAAE,EAAE;IACZ,OAAO,EAAE,EAAE;CACH,CAAC;AAEX;;GAEG;AACU,QAAA,QAAQ,GAAG;IACtB,OAAO,EAAE,CAAC;IACV,OAAO,EAAE,CAAC;IACV,QAAQ,EAAE,CAAC;IACX,OAAO,EAAE,EAAE;IACX,IAAI,EAAE,GAAG;CACD,CAAC;AAEE,QAAA,WAAW,GAAG,EAAE,EAAE,EAAE,gBAAQ,EAAE,EAAE,EAAE,gBAAQ,EAAW,CAAC;AAEtD,QAAA,YAAY,GAAG;IAC1B,MAAM,EAAE,CAAC;IACT,QAAQ,EAAE,CAAC;IACX,QAAQ,EAAE,CAAC;IACX,SAAS,EAAE,CAAC;IACZ,MAAM,EAAE,CAAC;IACT,QAAQ,EAAE,CAAC;IACX,QAAQ,EAAE,CAAC;IACX,cAAc,EAAE,CAAC;IACjB,cAAc,EAAE,CAAC;IACjB,cAAc,EAAE,EAAE;IAClB,KAAK,EAAE,EAAE;IACT,eAAe;IACf,cAAc,EAAE,EAAE;CACV,CAAC;AAGE,QAAA,YAAY,GAAG;IAC1B,IAAI,EAAE,CAAC;IACP,EAAE,EAAE,CAAC;IACL,KAAK,EAAE,CAAC;IACR,SAAS,EAAE,CAAC;IACZ,IAAI,EAAE,CAAC;IACP,WAAW,EAAE,CAAC;CACN,CAAC"}

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

@@ -1,4 +1,5 @@
 import { DeviceConnectionEventMap } from "./device.js";
+import type { GestureEvent, ButtonAction } from "./microbit-events.js";
 export interface AccelerometerData {
     x: number;
     y: number;
@@ -10,7 +11,7 @@ export declare const ButtonState: {
     readonly LongPress: 2;
 };
 export type ButtonState = (typeof ButtonState)[keyof typeof ButtonState];
-export type ButtonEventType = "buttonachanged" | "buttonbchanged";
+export type ButtonActionType = "buttonachanged" | "buttonbchanged";
 export interface ButtonData {
     button: "A" | "B";
     state: ButtonState;
@@ -26,6 +27,45 @@ export interface MagnetometerData {
     y: number;
     z: number;
 }
+export interface TemperatureData {
+    celsius: number;
+}
+export interface PinValue {
+    /** Pin number (0-18). */
+    pin: number;
+    /**
+     * Pin value. For digital pins: 0 or 1.
+     * For analog pins: 0-255 (the 10-bit analog reading scaled to 8 bits).
+     */
+    value: number;
+}
+/**
+ * Data from a `pinchanged` event.
+ *
+ * Contains only the input pins whose values changed since the last
+ * notification, up to a firmware limit of 10 pins per event
+ * (lowest-numbered first). Use {@link MicrobitBluetoothConnection.readPins}
+ * to read all input pins on demand.
+ */
+export interface PinData {
+    data: PinValue[];
+}
+export interface GestureData {
+    gesture: GestureEvent;
+}
+export interface ButtonActionData {
+    button: "A" | "B" | "AB" | "Logo";
+    action: ButtonAction;
+}
+/**
+ * A raw event from the micro:bit's message bus, received via the
+ * BLE Event Service. Use {@link MicrobitBluetoothConnection.subscribeToEvent}
+ * to register which events the micro:bit should forward.
+ */
+export interface MicrobitEventData {
+    source: number;
+    value: number;
+}
 export interface UartData {
     value: Uint8Array;
 }
@@ -38,6 +78,14 @@ export interface ServiceConnectionEventMap {
     buttonachanged: ButtonData;
     buttonbchanged: ButtonData;
     magnetometerdatachanged: MagnetometerData;
+    temperaturechanged: TemperatureData;
+    pinchanged: PinData;
+    gesturechanged: GestureData;
+    buttonaaction: ButtonActionData;
+    buttonbaction: ButtonActionData;
+    buttonabaction: ButtonActionData;
+    logoaction: ButtonActionData;
+    microbitevent: MicrobitEventData;
     uartdata: UartData;
 }
 type AllEventMap = ServiceConnectionEventMap & DeviceConnectionEventMap;

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

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

package/build/esm/bluetooth/connection.d.ts

@@ -1,11 +1,62 @@
 import { BackgroundErrorData, ConnectionStatusChange, DeviceConnection, FlashDataSource, FlashOptions } from "../device.js";
 import { Logging } from "../logging.js";
-import { AccelerometerData, ButtonData, LedMatrix, MagnetometerData, UartData } from "../service-events.js";
+import { AccelerometerData, ButtonActionData, ButtonData, GestureData, LedMatrix, MagnetometerData, MicrobitEventData, PinData, PinValue, TemperatureData, UartData } from "../service-events.js";
 import { DeviceBondState } from "./device-bond-state.js";
 export interface MicrobitBluetoothConnectionOptions {
     logging?: Logging;
     deviceBondState?: DeviceBondState;
 }
+/**
+ * A Bluetooth connection to a micro:bit device.
+ *
+ * Events and methods rely on specific BLE services being present in the
+ * micro:bit's firmware. Which services are available depends on the firmware
+ * build for C++ and for a MakeCode program depends on the service blocks added
+ * from the Bluetooth extension.
+ *
+ * The table below maps each event and method to the BLE service it requires.
+ * If a service is not present, the event will silently not fire (no error is
+ * raised) and methods that depend on it will throw.
+ *
+ * ### Accelerometer Service
+ * - `accelerometerdatachanged` event
+ * - {@link getAccelerometerData}, {@link getAccelerometerPeriod}, {@link setAccelerometerPeriod}
+ *
+ * ### Button Service
+ * - `buttonachanged`, `buttonbchanged` events
+ *
+ * ### Event Service
+ * - `gesturechanged` event — also requires the accelerometer hardware to be
+ *   active; this happens automatically if the Accelerometer Service is present
+ * - `buttonaaction`, `buttonbaction`, `buttonabaction` events
+ * - `logoaction` event (V2 only)
+ * - `microbitevent` event
+ * - {@link subscribeToEvent}, {@link sendEvent}
+ *
+ * ### IO Pin Service
+ * - `pinchanged` event
+ * - {@link getAnalogPins}, {@link setAnalogPins}
+ * - {@link getInputPins}, {@link setInputPins}
+ * - {@link readPins}, {@link writePins}, {@link writePinPwm}
+ *
+ * ### LED Service
+ * - {@link setLedText}, {@link getLedScrollingDelay}, {@link setLedScrollingDelay}
+ * - {@link getLedMatrix}, {@link setLedMatrix}
+ *
+ * ### Magnetometer Service
+ * - `magnetometerdatachanged` event
+ * - {@link getMagnetometerData}, {@link getMagnetometerBearing}
+ * - {@link getMagnetometerPeriod}, {@link setMagnetometerPeriod}
+ * - {@link triggerMagnetometerCalibration}
+ *
+ * ### Temperature Service
+ * - `temperaturechanged` event
+ * - {@link getTemperature}, {@link getTemperaturePeriod}, {@link setTemperaturePeriod}
+ *
+ * ### UART Service
+ * - `uartdata` event
+ * - {@link uartWrite}
+ */
 export interface MicrobitBluetoothConnection extends DeviceConnection {
     readonly type: "bluetooth";
     addEventListener(type: "status", listener: (data: ConnectionStatusChange) => void): void;
@@ -13,9 +64,30 @@ export interface MicrobitBluetoothConnection extends DeviceConnection {
     addEventListener(type: "beforerequestdevice", listener: () => void): void;
     addEventListener(type: "afterrequestdevice", listener: () => void): void;
     addEventListener(type: "flash", listener: () => void): void;
+    /** Requires: Accelerometer Service. */
     addEventListener(type: "accelerometerdatachanged", listener: (data: AccelerometerData) => void): void;
+    /** Requires: Button Service. */
     addEventListener(type: "buttonachanged" | "buttonbchanged", listener: (data: ButtonData) => void): void;
+    /** Requires: Magnetometer Service. */
     addEventListener(type: "magnetometerdatachanged", listener: (data: MagnetometerData) => void): void;
+    /** Requires: Temperature Service. */
+    addEventListener(type: "temperaturechanged", listener: (data: TemperatureData) => void): void;
+    /** Requires: IO Pin Service. */
+    addEventListener(type: "pinchanged", listener: (data: PinData) => void): void;
+    /** Requires: Event Service. The accelerometer hardware must also be active (automatic if the Accelerometer Service is present). */
+    addEventListener(type: "gesturechanged", listener: (data: GestureData) => void): void;
+    /** Requires: Event Service. */
+    addEventListener(type: "buttonaaction" | "buttonbaction" | "buttonabaction", listener: (data: ButtonActionData) => void): void;
+    /** Requires: Event Service. V2 only. */
+    addEventListener(type: "logoaction", listener: (data: ButtonActionData) => void): void;
+    /**
+     * Requires: Event Service. Receives raw micro:bit message bus events
+     * registered via {@link subscribeToEvent}. Higher-level events supported
+     * by the event service, like `gesturechanged` and button actions, are not
+     * included here unless you subscribe to them using {@link subscribeToEvent}.
+     */
+    addEventListener(type: "microbitevent", listener: (data: MicrobitEventData) => void): void;
+    /** Requires: UART Service. */
     addEventListener(type: "uartdata", listener: (data: UartData) => void): void;
     removeEventListener(type: "status", listener: (data: ConnectionStatusChange) => void): void;
     removeEventListener(type: "backgrounderror", listener: (data: BackgroundErrorData) => void): void;
@@ -25,6 +97,12 @@ export interface MicrobitBluetoothConnection extends DeviceConnection {
     removeEventListener(type: "accelerometerdatachanged", listener: (data: AccelerometerData) => void): void;
     removeEventListener(type: "buttonachanged" | "buttonbchanged", listener: (data: ButtonData) => void): void;
     removeEventListener(type: "magnetometerdatachanged", listener: (data: MagnetometerData) => void): void;
+    removeEventListener(type: "temperaturechanged", listener: (data: TemperatureData) => void): void;
+    removeEventListener(type: "pinchanged", listener: (data: PinData) => void): void;
+    removeEventListener(type: "gesturechanged", listener: (data: GestureData) => void): void;
+    removeEventListener(type: "buttonaaction" | "buttonbaction" | "buttonabaction", listener: (data: ButtonActionData) => void): void;
+    removeEventListener(type: "logoaction", listener: (data: ButtonActionData) => void): void;
+    removeEventListener(type: "microbitevent", listener: (data: MicrobitEventData) => void): void;
     removeEventListener(type: "uartdata", listener: (data: UartData) => void): void;
     /**
      * Sets micro:bit name filter for device requesting.
@@ -35,6 +113,8 @@ export interface MicrobitBluetoothConnection extends DeviceConnection {
     /**
      * Gets micro:bit accelerometer data.
      *
+     * Requires: Accelerometer Service.
+     *
      * @returns accelerometer data.
      * @throws {DeviceError} with code `not-connected` if there is no connection.
      */
@@ -42,6 +122,8 @@ export interface MicrobitBluetoothConnection extends DeviceConnection {
     /**
      * Gets micro:bit accelerometer period.
      *
+     * Requires: Accelerometer Service.
+     *
      * @returns accelerometer period.
      * @throws {DeviceError} with code `not-connected` if there is no connection.
      */
@@ -49,6 +131,8 @@ export interface MicrobitBluetoothConnection extends DeviceConnection {
     /**
      * Sets micro:bit accelerometer period.
      *
+     * Requires: Accelerometer Service.
+     *
      * @param value The accelerometer period.
      * @throws {DeviceError} with code `not-connected` if there is no connection.
      */
@@ -56,6 +140,8 @@ export interface MicrobitBluetoothConnection extends DeviceConnection {
     /**
      * Sets micro:bit LED text.
      *
+     * Requires: LED Service.
+     *
      * @param text The text displayed on micro:bit LED.
      * @throws {DeviceError} with code `not-connected` if there is no connection.
      */
@@ -63,6 +149,8 @@ export interface MicrobitBluetoothConnection extends DeviceConnection {
     /**
      * Gets micro:bit LED scrolling delay.
      *
+     * Requires: LED Service.
+     *
      * @returns LED scrolling delay in milliseconds.
      * @throws {DeviceError} with code `not-connected` if there is no connection.
      */
@@ -70,6 +158,8 @@ export interface MicrobitBluetoothConnection extends DeviceConnection {
     /**
      * Sets micro:bit LED scrolling delay.
      *
+     * Requires: LED Service.
+     *
      * @param delayInMillis LED scrolling delay in milliseconds.
      * @throws {DeviceError} with code `not-connected` if there is no connection.
      */
@@ -77,6 +167,8 @@ export interface MicrobitBluetoothConnection extends DeviceConnection {
     /**
      * Gets micro:bit LED matrix.
      *
+     * Requires: LED Service.
+     *
      * @returns a boolean matrix representing the micro:bit LED display.
      * @throws {DeviceError} with code `not-connected` if there is no connection.
      */
@@ -84,6 +176,8 @@ export interface MicrobitBluetoothConnection extends DeviceConnection {
     /**
      * Sets micro:bit LED matrix.
      *
+     * Requires: LED Service.
+     *
      * @param matrix an boolean matrix representing the micro:bit LED display.
      * @throws {DeviceError} with code `not-connected` if there is no connection.
      */
@@ -91,6 +185,8 @@ export interface MicrobitBluetoothConnection extends DeviceConnection {
     /**
      * Gets micro:bit magnetometer data.
      *
+     * Requires: Magnetometer Service.
+     *
      * @returns magnetometer data.
      * @throws {DeviceError} with code `not-connected` if there is no connection.
      */
@@ -98,6 +194,8 @@ export interface MicrobitBluetoothConnection extends DeviceConnection {
     /**
      * Gets micro:bit magnetometer bearing.
      *
+     * Requires: Magnetometer Service.
+     *
      * @returns magnetometer bearing.
      * @throws {DeviceError} with code `not-connected` if there is no connection.
      */
@@ -105,6 +203,8 @@ export interface MicrobitBluetoothConnection extends DeviceConnection {
     /**
      * Gets micro:bit magnetometer period.
      *
+     * Requires: Magnetometer Service.
+     *
      * @returns magnetometer period.
      * @throws {DeviceError} with code `not-connected` if there is no connection.
      */
@@ -112,6 +212,8 @@ export interface MicrobitBluetoothConnection extends DeviceConnection {
     /**
      * Sets micro:bit magnetometer period.
      *
+     * Requires: Magnetometer Service.
+     *
      * @param value magnetometer period.
      * @throws {DeviceError} with code `not-connected` if there is no connection.
      */
@@ -119,12 +221,151 @@ export interface MicrobitBluetoothConnection extends DeviceConnection {
     /**
      * Triggers micro:bit magnetometer calibration.
      *
+     * Requires: Magnetometer Service.
+     *
      * @throws {DeviceError} with code `not-connected` if there is no connection.
      */
     triggerMagnetometerCalibration(): Promise<void>;
+    /**
+     * Gets the micro:bit temperature in degrees Celsius.
+     *
+     * Requires: Temperature Service.
+     *
+     * @returns temperature in degrees Celsius.
+     * @throws {DeviceError} with code `not-connected` if there is no connection.
+     */
+    getTemperature(): Promise<number>;
+    /**
+     * Gets the micro:bit temperature sensor period.
+     *
+     * Requires: Temperature Service.
+     *
+     * @returns temperature period in milliseconds.
+     * @throws {DeviceError} with code `not-connected` if there is no connection.
+     */
+    getTemperaturePeriod(): Promise<number>;
+    /**
+     * Sets the micro:bit temperature sensor period.
+     *
+     * Requires: Temperature Service.
+     *
+     * @param value period in milliseconds.
+     * @throws {DeviceError} with code `not-connected` if there is no connection.
+     */
+    setTemperaturePeriod(value: number): Promise<void>;
+    /**
+     * Gets which pins are configured as analog.
+     * All other pins are digital (the default).
+     *
+     * Requires: IO Pin Service.
+     *
+     * @returns array of pin numbers (0-18) configured as analog.
+     * @throws {DeviceError} with code `not-connected` if there is no connection.
+     */
+    getAnalogPins(): Promise<number[]>;
+    /**
+     * Sets which pins are configured as analog.
+     * All other pins become digital (the default).
+     *
+     * Requires: IO Pin Service.
+     *
+     * @param pins array of pin numbers (0-18) to configure as analog.
+     * @throws {DeviceError} with code `not-connected` if there is no connection.
+     */
+    setAnalogPins(pins: number[]): Promise<void>;
+    /**
+     * Gets which pins are configured as inputs.
+     * Input pins are monitored and their values reported via notifications.
+     * All other pins are outputs (the default).
+     *
+     * Requires: IO Pin Service.
+     *
+     * @returns array of pin numbers (0-18) configured as inputs.
+     * @throws {DeviceError} with code `not-connected` if there is no connection.
+     */
+    getInputPins(): Promise<number[]>;
+    /**
+     * Sets which pins are configured as inputs.
+     * Input pins are monitored and their values reported via notifications.
+     * All other pins become outputs (the default).
+     *
+     * Note: configuring a pin as input overrides any existing pin mode
+     * (e.g. touch sensing used by MakeCode "on pin pressed" blocks).
+     * The two cannot be used on the same pin simultaneously.
+     *
+     * Requires: IO Pin Service.
+     *
+     * @param pins array of pin numbers (0-18) to configure as inputs.
+     * @throws {DeviceError} with code `not-connected` if there is no connection.
+     */
+    setInputPins(pins: number[]): Promise<void>;
+    /**
+     * Reads current values of input pins. Unlike the `pinchanged` event
+     * (which only includes pins whose values changed), this returns every
+     * pin configured as an input, up to a firmware limit of 10 pins
+     * (lowest-numbered first).
+     *
+     * Requires: IO Pin Service.
+     *
+     * @returns array of pin/value pairs.
+     * @throws {DeviceError} with code `not-connected` if there is no connection.
+     */
+    readPins(): Promise<PinValue[]>;
+    /**
+     * Writes pin data for output pins.
+     *
+     * Requires: IO Pin Service.
+     *
+     * @param data array of pin/value pairs.
+     * @throws {DeviceError} with code `not-connected` if there is no connection.
+     */
+    writePins(data: PinValue[]): Promise<void>;
+    /**
+     * Sets PWM output on a pin.
+     *
+     * Requires: IO Pin Service.
+     *
+     * @param pin Pin number (0-18).
+     * @param options PWM configuration.
+     * @param options.value Analog value (0-1024).
+     * @param options.period Period in microseconds.
+     * @throws {DeviceError} with code `not-connected` if there is no connection.
+     */
+    writePinPwm(pin: number, options: {
+        value: number;
+        period: number;
+    }): Promise<void>;
+    /**
+     * Register interest in a specific micro:bit message bus event.
+     * Tells the micro:bit to forward matching message bus traffic over BLE.
+     * Matching events are dispatched as `microbitevent`.
+     * Use 0 as the value to match all events from a source.
+     *
+     * For common message bus events, consider the higher-level alternatives:
+     * `gesturechanged`, `buttonaaction`, `buttonbaction`, `buttonabaction`.
+     *
+     * Requires: Event Service.
+     *
+     * @param source Event source ID.
+     * @param value Event value to match, or 0 for any.
+     * @throws {DeviceError} with code `not-connected` if there is no connection.
+     */
+    subscribeToEvent(source: number, value: number): Promise<void>;
+    /**
+     * Send an event to the micro:bit's message bus.
+     *
+     * Requires: Event Service.
+     *
+     * @param source Event source ID.
+     * @param value Event value.
+     * @throws {DeviceError} with code `not-connected` if there is no connection.
+     */
+    sendEvent(source: number, value: number): Promise<void>;
     /**
      * Write UART messages.
      *
+     * Requires: UART Service.
+     *
      * @param data UART message.
      * @throws {DeviceError} with code `not-connected` if there is no connection.
      */

package/build/esm/bluetooth/connection.js

@@ -6,18 +6,18 @@
 import { BleClient } from "@capacitor-community/bluetooth-le";
 import { Capacitor } from "@capacitor/core";
 import MemoryMap from "nrf-intel-hex";
-import { BluetoothDeviceWrapper, isAndroid, scanningTimeoutInMs, } from "./device-wrapper.js";
-import { profile } from "./profile.js";
-import { ConnectionStatus, DeviceError, FlashDataError, assertConnected, ProgressStage, } from "../device.js";
+import { ConnectionStatus, DeviceError, FlashDataError, ProgressStage, assertConnected, } from "../device.js";
 import { TypedEventTarget } from "../events.js";
 import { ConsoleLogging } from "../logging.js";
+import { BluetoothDeviceWrapper, isAndroid, scanningTimeoutInMs, } from "./device-wrapper.js";
 import { fullFlash } from "./flashing/flashing-full.js";
 import partialFlash, { PartialFlashResult, } from "./flashing/flashing-partial.js";
+import { profile } from "./profile.js";
+import { TimeoutError } from "../async-util.js";
 import { throwIfUnavailable } from "../availability.js";
 import { truncateHexAfterEof } from "../hex-util.js";
-import { DefaultDeviceBondState, } from "./device-bond-state.js";
-import { TimeoutError } from "../async-util.js";
 import { withBleErrorMapping } from "./ble-error.js";
+import { DefaultDeviceBondState, } from "./device-bond-state.js";
 let bleClientInitialized = false;
 /**
  * A Bluetooth connection factory.
@@ -328,6 +328,54 @@ class MicrobitBluetoothConnectionImpl extends TypedEventTarget {
         assertConnected(this.device);
         return withBleErrorMapping(() => this.device.magnetometer.triggerCalibration());
     }
+    async getTemperature() {
+        assertConnected(this.device);
+        return withBleErrorMapping(() => this.device.temperature.getData());
+    }
+    async getTemperaturePeriod() {
+        assertConnected(this.device);
+        return withBleErrorMapping(() => this.device.temperature.getPeriod());
+    }
+    async setTemperaturePeriod(value) {
+        assertConnected(this.device);
+        return withBleErrorMapping(() => this.device.temperature.setPeriod(value));
+    }
+    async getAnalogPins() {
+        assertConnected(this.device);
+        return withBleErrorMapping(() => this.device.ioPin.getAnalogPins());
+    }
+    async setAnalogPins(pins) {
+        assertConnected(this.device);
+        return withBleErrorMapping(() => this.device.ioPin.setAnalogPins(pins));
+    }
+    async getInputPins() {
+        assertConnected(this.device);
+        return withBleErrorMapping(() => this.device.ioPin.getInputPins());
+    }
+    async setInputPins(pins) {
+        assertConnected(this.device);
+        return withBleErrorMapping(() => this.device.ioPin.setInputPins(pins));
+    }
+    async readPins() {
+        assertConnected(this.device);
+        return withBleErrorMapping(() => this.device.ioPin.readPins());
+    }
+    async writePins(data) {
+        assertConnected(this.device);
+        return withBleErrorMapping(() => this.device.ioPin.writePins(data));
+    }
+    async writePinPwm(pin, options) {
+        assertConnected(this.device);
+        return withBleErrorMapping(() => this.device.ioPin.setPwm(pin, options.value, options.period));
+    }
+    async subscribeToEvent(source, value) {
+        assertConnected(this.device);
+        return withBleErrorMapping(() => this.device.events.subscribeToEvent(source, value));
+    }
+    async sendEvent(source, value) {
+        assertConnected(this.device);
+        return withBleErrorMapping(() => this.device.events.sendEvent(source, value));
+    }
     async uartWrite(data) {
         assertConnected(this.device);
         return withBleErrorMapping(() => this.device.uart.writeData(data));