core/org.meshtastic.sdk/MeshNode

MeshNode

data class MeshNode(val raw: NodeInfo, val isOnline: Boolean, val connectionQuality: ConnectionQuality, val signalQuality: SignalQuality)(source)

High-level, consumer-friendly representation of a mesh node.

Combines the raw NodeInfo proto with computed status helpers (isOnline, connectionQuality, signalQuality) and provides convenient accessor properties that flatten the proto's nested structure for direct UI binding.

Instances are created via NodeInfo.toMeshNode at a specific point in time (nowEpochSeconds) so that online status is pre-computed and stable for the lifetime of the snapshot.

Since

0.1.0

Constructors

constructor(raw: NodeInfo, isOnline: Boolean, connectionQuality: ConnectionQuality, signalQuality: SignalQuality)

Properties

val airUtilTx: Float?

Airtime utilization (TX) percentage. Null if not reported.

val altitude: Int?

Altitude in meters (null if not reported).

val batteryLevel: Int?

Battery level percentage (0–100). Null if not reported.

channelUtilization

val channelUtilization: Float?

Channel utilization percentage. Null if not reported.

connectionQuality

val connectionQuality: ConnectionQuality

val deviceMetrics: DeviceMetrics?

Device metrics snapshot (battery, air utilization, etc.).

val hopsAway: Int?

Number of relay hops to reach this node. 0 = direct.

val hwModel: HardwareModel?

Hardware model reported by the node.

val isFavorite: Boolean

Whether this node is marked as a favorite.

val isIgnored: Boolean

Whether this node is ignored (hidden from UI).

val isMuted: Boolean

Whether this node is muted (no notifications).

val isOnline: Boolean

val lastHeard: Int

Last heard time (Unix epoch seconds). 0 if never heard.

val latitude: Double?

Latitude in degrees (null if no position or position is origin).

val longitude: Double?

Longitude in degrees (null if no position or position is origin).

val longName: String?

User-facing long name (e.g., "Alice's T-Beam").

val meshId: String?

Meshtastic ID string (e.g., "!aabbccdd").

val nodeId: NodeId

Stable node ID as NodeId.

val nodeNum: Int

Node number (unique on the mesh).

val position: Position?

Position data (latitude, longitude, altitude, etc.). Null if not reported.

val raw: NodeInfo

the underlying NodeInfo proto — available for advanced consumers that need full access to all proto fields

val shortName: String?

User-facing short name (4 chars, e.g., "ALCE").

val signalQuality: SignalQuality

SNR of last received packet from this node.

val user: User?

Full user proto (for advanced consumers).

val viaMqtt: Boolean

Whether the node was reached via MQTT gateway.

val voltage: Float?

Battery voltage. Null if not reported.