Class HttpConnection

Allows to connect to a Meshtastic device over HTTP(S)

Hierarchy (view full)

Constructors

constructor

Properties

abortController configId connType deviceStatus events isConfigured log pendingRequest pendingSettingsChanges portId queue readLoop receiveBatchRequests xModem

Methods

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

Constructors

constructor

Properties

Private abortController

abortController: AbortController

configId

configId: number

Randomly generated number to ensure confiuration lockstep

connType

connType: ConnectionTypeName

Defines the connection type as http

Protected deviceStatus

deviceStatus: DeviceStatusEnum

Describes the current state of the device

events

events: EventSystem

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

Private pendingRequest

pendingRequest: boolean

Protected pendingSettingsChanges

pendingSettingsChanges: boolean

Are there any settings that have yet to be applied?

Protected portId

portId: string

URL of the device that is to be connected to.

queue

queue: Queue

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

Private readLoop

readLoop: null | Timeout

Private receiveBatchRequests

receiveBatchRequests: boolean

Enables receiving messages all at once, versus one per request

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 HTTP(S)

    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

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>

Protected readFromRadio

  • readFromRadio(): Promise<void>

  • Reads any avaliable protobuf messages from the radio

    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>

removeNodeByNum

  • removeNodeByNum(nodeNum): Promise<number>

  • Removes a node from the internal NodeDB of the radio by node number

    Parameters

    • nodeNum: 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>

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

constructorabortControllerconfigIdconnTypedeviceStatuseventsisConfiguredlogpendingRequestpendingSettingsChangesportIdqueuereadLoopreceiveBatchRequestsxModemclearChannelcommitEditSettingscompleteconfigureconnectdisconnectfactoryResetgetChannelgetConfiggetMetadatagetModuleConfiggetOwnerhandleFromRadiopingreadFromRadiorebootrebootOtaremoveNodeByNumrequestPositionresetNodessendPacketsendRawsendTextsendWaypointsetChannelsetConfigsetModuleConfigsetOwnersetPositionshutdowntraceRouteupdateDeviceStatuswriteToRadio

Generated using TypeDoc