Class BleConnection

Allows to connect to a Meshtastic device via bluetooth

Hierarchy (view full)

Constructors

constructor

Properties

configId connType device deviceStatus events fromNumCharacteristic fromRadioCharacteristic gattServer isConfigured log pendingSettingsChanges portId queue service timerUpdateFromRadio toRadioCharacteristic xModem

Methods

clearChannel commitEditSettings complete configure connect disconnect factoryReset getChannel getConfig getDevice getDevices getMetadata getModuleConfig getOwner handleFromRadio ping readFromRadio reboot rebootOta requestPosition resetNodes sendPacket sendRaw sendText sendWaypoint setChannel setConfig setModuleConfig setOwner setPosition shutdown supported traceRoute updateDeviceStatus writeToRadio

Constructors

constructor

Properties

configId

configId: number

Randomly generated number to ensure confiuration lockstep

connType

connType: ConnectionTypeName

Defines the connection type as ble

device

device: undefined | BluetoothDevice

Currently connected BLE device

Protected deviceStatus

deviceStatus: DeviceStatusEnum

Describes the current state of the device

events

events: EventSystem

Private fromNumCharacteristic

fromNumCharacteristic: undefined | BluetoothRemoteGATTCharacteristic

Short Description

Private fromRadioCharacteristic

fromRadioCharacteristic: undefined | BluetoothRemoteGATTCharacteristic

Short Description

Private gattServer

gattServer: undefined | BluetoothRemoteGATTServer

Protected isConfigured

isConfigured: boolean

Describes the current state of the device

Protected log

log: Logger<unknown>

Logs to the console and the logging event emitter

Protected pendingSettingsChanges

pendingSettingsChanges: boolean

Are there any settings that have yet to be applied?

portId

portId: string

queue

queue: Queue

Packert queue, to space out transmissions and routing handle errors and acks

Private service

service: undefined | BluetoothRemoteGATTService

Short Description

Private timerUpdateFromRadio

timerUpdateFromRadio: null | Timeout = null

Private toRadioCharacteristic

toRadioCharacteristic: undefined | BluetoothRemoteGATTCharacteristic

Short Description

xModem

xModem: Xmodem

Methods

clearChannel

  • clearChannel(index): Promise<number>

  • Clears specific channel with the designated index

    Parameters

    • index: number

    Returns Promise<number>

commitEditSettings

complete

  • complete(): void

  • Completes all Events

    Returns void

configure

  • configure(): Promise<number>

  • Triggers the device configure process

    Returns Promise<number>

connect

  • connect(__namedParameters): Promise<void>

  • Initiates the connect process to a Meshtastic device via Bluetooth

    Parameters

    Returns Promise<void>

disconnect

  • disconnect(): void

  • Disconnects from the Meshtastic device

    Returns void

factoryReset

  • factoryReset(): Promise<number>

  • Factory resets the current node

    Returns Promise<number>

getChannel

  • getChannel(index): Promise<number>

  • Gets specified channel information from the radio

    Parameters

    • index: number

    Returns Promise<number>

getConfig

getDevice

  • getDevice(filter?): Promise<BluetoothDevice>

  • Opens browser dialog to select a device

    Parameters

    • Optional filter: RequestDeviceOptions

    Returns Promise<BluetoothDevice>

getDevices

  • getDevices(): Promise<BluetoothDevice[]>

  • Gets list of bluetooth devices that can be passed to connect

    Returns Promise<BluetoothDevice[]>

    Array of avaliable BLE devices

getMetadata

  • getMetadata(nodeNum): Promise<number>

  • Gets devices metadata

    Parameters

    • nodeNum: number

    Returns Promise<number>

getModuleConfig

getOwner

  • getOwner(): Promise<number>

  • Gets devices Owner

    Returns Promise<number>

Protected handleFromRadio

  • handleFromRadio(fromRadio): void

  • Gets called whenever a fromRadio message is received from device, returns fromRadio data

    Parameters

    • fromRadio: Uint8Array

    Returns void

ping

  • ping(): Promise<boolean>

  • Pings device to check if it is avaliable

    Returns Promise<boolean>

    Todo

    Implement

Protected readFromRadio

  • readFromRadio(): Promise<void>

  • Short description

    Returns Promise<void>

reboot

  • reboot(time): Promise<number>

  • Reboots the current node after the specified amount of time has elapsed.

    Parameters

    • time: number

    Returns Promise<number>

rebootOta

  • rebootOta(time): Promise<number>

  • Reboots the current node into OTA mode after the specified amount of time has elapsed.

    Parameters

    • time: number

    Returns Promise<number>

requestPosition

  • requestPosition(destination): Promise<number>

  • Requests position from the designated node

    Parameters

    • destination: number

    Returns Promise<number>

resetNodes

  • resetNodes(): Promise<number>

  • Resets the internal NodeDB of the radio, usefull for removing old nodes that no longer exist.

    Returns Promise<number>

sendPacket

  • sendPacket(byteData, portNum, destination, channel?, wantAck?, wantResponse?, echoResponse?, replyId?, emoji?): Promise<number>

  • Sends packet over the radio

    Parameters

    • byteData: Uint8Array
    • portNum: PortNum
    • destination: Destination
    • channel: ChannelNumber = Types.ChannelNumber.Primary
    • wantAck: boolean = true
    • wantResponse: boolean = true
    • echoResponse: boolean = false
    • Optional replyId: number
    • Optional emoji: number

    Returns Promise<number>

sendRaw

  • sendRaw(toRadio, id?): Promise<number>

  • Sends raw packet over the radio

    Parameters

    • toRadio: Uint8Array
    • id: number = ...

    Returns Promise<number>

sendText

  • sendText(text, destination?, wantAck?, channel?): Promise<number>

  • Sends a text over the radio

    Parameters

    Returns Promise<number>

sendWaypoint

  • sendWaypoint(waypointMessage, destination, channel?): Promise<number>

  • Sends a text over the radio

    Parameters

    Returns Promise<number>

setChannel

  • setChannel(channel): Promise<number>

  • Sets devices ChannelSettings

    Parameters

    Returns Promise<number>

setConfig

  • setConfig(config): Promise<number>

  • Writes config to device

    Parameters

    Returns Promise<number>

setModuleConfig

  • setModuleConfig(moduleConfig): Promise<number>

  • Writes module config to device

    Parameters

    Returns Promise<number>

setOwner

  • setOwner(owner): Promise<number>

  • Sets devices owner data

    Parameters

    Returns Promise<number>

setPosition

  • setPosition(positionMessage): Promise<number>

  • Parameters

    Returns Promise<number>

shutdown

  • shutdown(time): Promise<number>

  • Shuts down the current node after the specified amount of time has elapsed.

    Parameters

    • time: number

    Returns Promise<number>

supported

  • supported(): Promise<boolean>

  • Gets web bluetooth support avaliability for the device

    Returns Promise<boolean>

traceRoute

  • traceRoute(destination): Promise<number>

  • Sends a trace route packet to the designated node

    Parameters

    • destination: number

    Returns Promise<number>

updateDeviceStatus

Protected writeToRadio

  • writeToRadio(data): Promise<void>

  • Sends supplied protobuf message to the radio

    Parameters

    • data: Uint8Array

    Returns Promise<void>

Settings

Member Visibility

Theme

On This Page

constructorconfigIdconnTypedevicedeviceStatuseventsfromNumCharacteristicfromRadioCharacteristicgattServerisConfiguredlogpendingSettingsChangesportIdqueueservicetimerUpdateFromRadiotoRadioCharacteristicxModemclearChannelcommitEditSettingscompleteconfigureconnectdisconnectfactoryResetgetChannelgetConfiggetDevicegetDevicesgetMetadatagetModuleConfiggetOwnerhandleFromRadiopingreadFromRadiorebootrebootOtarequestPositionresetNodessendPacketsendRawsendTextsendWaypointsetChannelsetConfigsetModuleConfigsetOwnersetPositionshutdownsupportedtraceRouteupdateDeviceStatuswriteToRadio

Generated using TypeDoc