core-repository/org.meshtastic.core.repository/NodeManager

NodeManager

interface NodeManager : NodeIdLookup(source)

Interface for managing the in-memory node database and processing received node information.

Properties

allowNodeDbWrites

abstract val allowNodeDbWrites: StateFlow<Boolean>

Whether node database writes are allowed.

firmwareEdition

abstract val firmwareEdition: StateFlow<FirmwareEdition?>

The firmware edition reported by the connected device.

isNodeDbReady

abstract val isNodeDbReady: StateFlow<Boolean>

Whether the node database is ready.

myNodeNum

abstract val myNodeNum: StateFlow<Int?>

The local node number as a thread-safe StateFlow.

nodeDBbyNodeNum

abstract val nodeDBbyNodeNum: Map<Int, Node>

Reactive map of all nodes by their number.

Functions

clear

abstract fun clear()

Clears the in-memory node database.

getMyId

abstract fun getMyId(): String

Returns the local node ID.

getMyNodeInfo

abstract fun getMyNodeInfo(): MyNodeInfo?

Returns information about the local node.

getNodeById

abstract fun getNodeById(id: String): Node?

Look up a node by its user ID string (e.g. "!a1b2c3d4").

handleReceivedNodeStatus

abstract fun handleReceivedNodeStatus(fromNum: Int, s: StatusMessage)

Processes a received node status message.

handleReceivedPaxcounter

abstract fun handleReceivedPaxcounter(fromNum: Int, p: Paxcount)

Processes a received paxcounter packet.

handleReceivedPosition

abstract fun handleReceivedPosition(fromNum: Int, myNodeNum: Int, p: Position, defaultTime: Long)

Processes a received position packet.

handleReceivedTelemetry

abstract fun handleReceivedTelemetry(fromNum: Int, telemetry: Telemetry)

Processes a received telemetry packet.

handleReceivedUser

abstract fun handleReceivedUser(fromNum: Int, p: User, channel: Int = 0, manuallyVerified: Boolean = false)

Processes a received user packet.

insertMetadata

abstract fun insertMetadata(nodeNum: Int, metadata: DeviceMetadata)

Inserts hardware metadata for a node.

installNodeInfo

abstract fun installNodeInfo(info: NodeInfo)

Installs node information from a ProtoNodeInfo object.

loadCachedNodeDB

abstract fun loadCachedNodeDB()

Loads the cached node database from the repository.

removeByNodenum

abstract fun removeByNodenum(nodeNum: Int)

Removes a node from the in-memory database by its number.

setAllowNodeDbWrites

abstract fun setAllowNodeDbWrites(allowed: Boolean)

Sets whether node database writes are allowed.

setFirmwareEdition

abstract fun setFirmwareEdition(edition: FirmwareEdition?)

Sets the firmware edition of the connected device.

setMyNodeNum

abstract fun setMyNodeNum(num: Int?)

Sets the local node number.

setNodeDbReady

abstract fun setNodeDbReady(ready: Boolean)

Sets whether the node database is ready.

toNodeID

abstract fun toNodeID(nodeNum: Int): String

updateNode

abstract fun updateNode(nodeNum: Int, channel: Int = 0, transform: (Node) -> Node)

Updates a node using a transformation function.

updateNodeStatus

abstract fun updateNodeStatus(nodeNum: Int, status: String?)

Updates the status string for a node.