Class PixelSessionAbstract

Represents a session with a Pixel die. This class is used to abstract the underlying platform used to connect to Pixels.

Constructors

constructor

Properties

_connStatusCb? _systemId

Accessors

lastConnectionStatus pixelName systemId

Methods

_notifyConnectionEvent _setName connect disconnect dispose setConnectionEventListener subscribe writeValue

Constructors

constructor

  • new PixelSession(systemId, name?): PixelSession

  • Instantiates a session with a Pixel. No attempt is made to connect to the die at this point.

    Parameters

    • systemId: string

      The peripheral system id (as assigned by the OS).

    • Optionalname: string

    Returns PixelSession

Properties

Protected Optional_connStatusCb

_connStatusCb?: ((ev: PixelSessionConnectionEvent) => void)

Protected Readonly_systemId

_systemId: string

Accessors

lastConnectionStatus

  • get lastConnectionStatus():
        | "connected"
        | "connecting"
        | "disconnected"
        | "failedToConnect"
        | "ready"
        | "disconnecting"

  • Gets the last known connection status.

    Returns
        | "connected"
        | "connecting"
        | "disconnected"
        | "failedToConnect"
        | "ready"
        | "disconnecting"

pixelName

  • get pixelName(): undefined | string

  • Gets the Pixel name.

    Returns undefined | string

    Remarks

    It may be undefined until connected.

systemId

  • get systemId(): string

  • Gets the peripheral system id (as assigned by the OS).

    Returns string

Methods

Protected_notifyConnectionEvent

  • _notifyConnectionEvent(status, reason?): void

  • Parameters

    • status:
          | "connected"
          | "connecting"
          | "disconnected"
          | "failedToConnect"
          | "ready"
          | "disconnecting"
    • Optionalreason:
          | "canceled"
          | "success"
          | "unknown"
          | "host"
          | "timeout"
          | "notSupported"
          | "linkLoss"
          | "bluetoothOff"
          | "peripheral"

    Returns void

Protected_setName

  • _setName(name): void

  • Parameters

    • name: string

    Returns void

Abstractconnect

  • connect(timeoutMs): Promise<void>

  • Connects to the Pixel.

    Parameters

    • timeoutMs: number

    Returns Promise<void>

Abstractdisconnect

  • disconnect(): Promise<void>

  • Disconnects from the Pixel.

    Returns Promise<void>

Abstractdispose

  • dispose(): void

  • Release resources used by the session object.

    Returns void

setConnectionEventListener

  • setConnectionEventListener(connectionStatusListener?): void

  • Sets the function to be called when the Pixel connection status changes.

    Parameters

    Returns void

Abstractsubscribe

  • subscribe(listener): Promise<(() => void)>

  • Subscribes to the "notify" characteristic and returns unsubscribe function.

    Parameters

    • listener: ((dataView: DataView) => void)

      The function to be called when the Pixel connection status changes.

        • (dataView): void

        • Parameters

          • dataView: DataView

          Returns void

    Returns Promise<(() => void)>

AbstractwriteValue

  • writeValue(data, withoutResponse?, timeoutMs?): Promise<void>

  • Sends data to Pixel using the "write" characteristic

    Parameters

    • data: ArrayBuffer

      The raw data to send to the Pixel.

    • OptionalwithoutResponse: boolean

      Whether or not to request the device to acknowledge having received the data.

    • OptionaltimeoutMs: number

      The timeout in milliseconds before throwing an error when waiting for the device to acknowledgement.

    Returns Promise<void>

Settings

Member Visibility

On This Page

Constructors
Properties
Accessors
Methods