core-model/org.meshtastic.core.model

Package-level declarations

Types

@Serializable

data class BootloaderOtaQuirk(val hwModel: Int, val hwModelSlug: String? = null, val requiresBootloaderUpgradeForOta: Boolean = false, val infoUrl: String? = null)

BootloaderOtaQuirksResponse

@Serializable

data class BootloaderOtaQuirksResponse(val devices: List<BootloaderOtaQuirk> = emptyList(), val softDeviceVariants: List<SoftDeviceVariantEntry> = emptyList())

Envelope of the bundled device_bootloader_ota_quirks.json asset.

Capabilities

data class Capabilities(val firmwareVersion: String?, forceEnableAll: Boolean = isDebug)

Defines the capabilities and feature support based on the device firmware version.

Channel

data class Channel(val settings: ChannelSettings = default.settings, val loraConfig: Config.LoRaConfig = default.loraConfig)

ChannelOption

enum ChannelOption : Enum<ChannelOption>

ConnectionEpochs

data class ConnectionEpochs(val departures: Long = 0, val completedHandshakes: Long = 0, val handshakesAtLastDeparture: Long = 0, val lastDepartureState: ConnectionState? = null)

Monotonic counters for connection lifecycle events that cannot be inferred reliably from transient ConnectionState values. A fast disconnect/reconnect may be observed only as the final state, while these counters retain both lifecycle boundaries.

ConnectionLifecycle

data class ConnectionLifecycle(val version: Long = 0, val state: ConnectionState = ConnectionState.Disconnected, val epochs: ConnectionEpochs = ConnectionEpochs())

One atomically published view of canonical connection state and its lifecycle evidence.

ConnectionState

sealed interface ConnectionState

Contact

data class Contact(val contactKey: String, val shortName: String, val longName: String, val lastMessageTime: Long?, val lastMessageText: String?, val unreadCount: Int, val messageCount: Int, val isMuted: Boolean, val isUnmessageable: Boolean, val nodeColors: Pair<Int, Int>? = null, val draft: String = "", val isPinned: Boolean = false, val isRetired: Boolean = false)

ContactKey

@JvmInline

value class ContactKey(val value: String)

Type-safe wrapper for contact key strings (channel index + node address).

ContactSettings

data class ContactSettings(val contactKey: String, val muteUntil: Long = 0, val lastReadMessageUuid: Long? = null, val lastReadMessageTimestamp: Long? = null, val filteringDisabled: Boolean = false, val isMuted: Boolean = false, val draft: String = "", val pinned: Boolean = false, val displayName: String = "")

DataPacket

@Serializable

data class DataPacket(var to: String? = NodeAddress.ID_BROADCAST, var bytes: ByteString?, var dataType: Int, var from: String? = NodeAddress.ID_LOCAL, var time: Long = nowMillis, var id: Int = 0, var status: MessageStatus? = MessageStatus.UNKNOWN, var hopLimit: Int = 0, var channel: Int = 0, var wantAck: Boolean = true, var hopStart: Int = 0, var snr: Float? = null, var rssi: Int? = null, var replyId: Int? = null, var relayNode: Int? = null, var relays: Int = 0, var viaMqtt: Boolean = false, var emoji: Int = 0, var sfppHash: ByteString? = null, var transportMechanism: Int = 0, var xeddsaSigned: Boolean = false, var ackProofStatus: Int = 0)

A data class version of the protobuf MeshPacket + Data subpacket.

DeviceAddress

class DeviceAddress

A selected-radio address, parsed from its stored form: one InterfaceId character followed by the transport's own identity for the device.

DeviceHardware

@Serializable

data class DeviceHardware(val activelySupported: Boolean = false, val architecture: String = "", val displayName: String = "", val hasInkHud: Boolean? = null, val hasMui: Boolean? = null, val hwModel: Int = 0, val hwModelSlug: String = "", val images: List<String>? = null, val isMaker: Boolean = false, val partitionScheme: String? = null, val platformioTarget: String = "", val requiresDfu: Boolean? = null, val requiresBootloaderUpgradeForOta: Boolean? = null, val bootloaderInfoUrl: String? = null, val softDeviceVariant: SoftDeviceVariant? = null, val supportLevel: Int? = null, val tags: List<String>? = null)

DeviceLink

@Serializable

data class DeviceLink(val shortCode: String, val description: String? = null, val isVendor: Boolean = false, val regions: List<String>? = null, val targets: List<String>? = null)

A msh.to device link resolved by the Meshtastic API (/resource/deviceLinks) and cached locally. Every link routes through the msh.to redirect service.

DeviceMetrics

data class DeviceMetrics(val time: Int = currentTime(), val batteryLevel: Int = 0, val voltage: Float, val channelUtilization: Float, val airUtilTx: Float, val uptimeSeconds: Int)

DeviceType

enum DeviceType : Enum<DeviceType>

The physical transports a radio can be reached over. Demo Mode reaches no radio and has no DeviceType.

DeviceVersion

@JvmInline

value class DeviceVersion(val asString: String) : Comparable<DeviceVersion>

Zero-overhead wrapper providing structured access to parse and compare device version strings.

EnvironmentMetrics

data class EnvironmentMetrics(val time: Int = currentTime(), val temperature: Float?, val relativeHumidity: Float?, val soilTemperature: Float?, val soilMoisture: Int?, val barometricPressure: Float?, val gasResistance: Float?, val voltage: Float?, val current: Float?, val iaq: Int?, val lux: Float? = null, val uvLux: Float? = null)

EraseImageEntry

@Serializable

data class EraseImageEntry(val fileName: String, val sha256: String, val expectedFirstTargetAddress: Long? = null, val expectedFamilyId: Long? = null)

EventFirmwareBuild

@Serializable

data class EventFirmwareBuild(val slug: String? = null, val version: String? = null, val id: String? = null, val title: String? = null, val zipUrl: String? = null, val releaseNotes: String? = null)

The event's own firmware release, so a client can surface its version or offer the download (zipUrl).

EventFirmwareEdition

@Serializable

data class EventFirmwareEdition(val edition: String = "", val displayName: String = "", val welcomeMessage: String = "", val eventStart: String? = null, val eventEnd: String? = null, val timeZone: String? = null, val location: String? = null, val iconUrl: String? = null, val accentColor: String? = null, val tag: String? = null, val domain: String? = null, val theme: EventFirmwareTheme? = null, val firmware: EventFirmwareBuild? = null, val links: List<EventFirmwareLink> = emptyList())

Display metadata for one event-specific firmware edition (Hamvention, DEFCON, …).

EventFirmwareFonts

@Serializable

data class EventFirmwareFonts(val heading: String? = null, val body: String? = null)

Font-family names for event branding — Google Font family names (e.g. Lato / Atkinson Hyperlegible), not URLs. Captured so the data is available; actually rendering with these fonts is a separate, platform-specific concern (a downloadable-font provider is Google-flavor only), so consumers may ignore them and fall back to the app typeface.

EventFirmwareLink

@Serializable

data class EventFirmwareLink(val label: String = "", val url: String = "")

A labeled link for an event (website, schedule, map, …).

EventFirmwareResponse

@Serializable

data class EventFirmwareResponse(val version: Int = 1, val generatedAt: String? = null, val source: String? = null, val editions: List<EventFirmwareEdition> = emptyList())

Response envelope for event-firmware display metadata. Matches the bundled event_firmware.json and the live GET https://api.meshtastic.org/resource/eventFirmware API (the source of truth), sharing the {version, generatedAt, source, <payload>[]} shape used by NetworkDeviceLinksResponse.

EventFirmwareTheme

@Serializable

data class EventFirmwareTheme(val name: String? = null, val tagline: String? = null, val colors: EventFirmwareThemeColors? = null, val palette: List<String> = emptyList(), val fonts: EventFirmwareFonts? = null)

Richer event branding beyond a single accent color. Not all editions carry a full theme.

EventFirmwareThemeColors

@Serializable

data class EventFirmwareThemeColors(val primary: String? = null, val secondary: String? = null, val accent: String? = null)

Named brand colors (#RRGGBB) for an event theme; any may be absent.

FirmwareCheckStatus

enum FirmwareCheckStatus : Enum<FirmwareCheckStatus>

Outcome of checking a device's firmware version against the app's minimum requirements.

FirmwareReleaseManifest

@Serializable

data class FirmwareReleaseManifest(val version: String = "", val targets: List<FirmwareTarget> = emptyList())

Authoritative target catalogue referenced by a firmware release's zip_url.

FirmwareTarget

@Serializable

data class FirmwareTarget(val board: String = "", val platform: String = "")

One firmware target declared by a FirmwareReleaseManifest.

FirmwareUpdateDestination

enum FirmwareUpdateDestination : Enum<FirmwareUpdateDestination>

Where a firmware-update nudge takes the user.

FirmwareUpdateNotice

data class FirmwareUpdateNotice(val notificationKey: String, val currentVersion: String, val stableVersion: String, val destination: FirmwareUpdateDestination, val presentation: FirmwareUpdateNoticePresentation = FirmwareUpdateNoticePresentation.Update)

Fully validated connected-device firmware update information for platform UI and notifications.

FirmwareUpdateNoticePolicy

object FirmwareUpdateNoticePolicy

Determines whether a connected local device is behind the latest stable firmware and where it can be updated.

FirmwareUpdateNoticePresentation

enum FirmwareUpdateNoticePresentation : Enum<FirmwareUpdateNoticePresentation>

The only permitted visual treatment for a firmware update: an informational update nudge.

FirmwareUpdateTransport

enum FirmwareUpdateTransport : Enum<FirmwareUpdateTransport>

Connection transports that can determine the Android firmware-update destination.

HamName

object HamName

The owner name of a licensed (ham) node, which firmware builds from two HamParameters fields.

HardwareSupportTier

enum HardwareSupportTier : Enum<HardwareSupportTier>

The rung a board reads at wherever the app names its support status. Top to bottom: hardware the project actively supports, independent maker hardware, then community hardware (including anything not actively supported).

InterfaceId

enum InterfaceId : Enum<InterfaceId>

Address identifiers for all supported radio backend implementations.

MaintenanceUf2EraseSet

@Serializable

data class MaintenanceUf2EraseSet(val nrf52: Map<String, EraseImageEntry> = emptyMap(), val nrf52Bootloader: EraseImageEntry? = null, val rp2040: EraseImageEntry)

Nested by architecture, then (for nRF52) by SoftDevice wire value — RP2040 has no SoftDevice concept at all, so it correctly has no sub-key, unlike the old flat {s140_6_1_1, s140_7_3_0, rp2040} shape that mixed a SoftDevice-variant axis with an architecture axis in one object.

MaintenanceUf2Manifest

@Serializable

data class MaintenanceUf2Manifest(val manifestVersion: Int = 1, val otafixReleaseTag: String = "", val otafixBase: String = "", val erase: MaintenanceUf2EraseSet? = null, val otafixByBoardId: Map<String, OtafixAssetEntry> = emptyMap(), val otafixSupportedTargets: List<String> = emptyList())

Pinned nRF52/RP2040 maintenance UF2 manifest — factory-erase and OTAFIX bootloader self-update images, keyed by hardware. Envelope of resource/maintenanceUf2 and the bundled maintenance_uf2.json seed asset. Each image's own sha256 is checked against its downloaded bytes before any write — see MaintenanceUf2.kt — independently of how this manifest itself is fetched.

MeshActivity

sealed class MeshActivity

Represents activity on the mesh network.

MeshBeaconOffer

data class MeshBeaconOffer(val fromNodeNum: Int, val beacon: MeshBeacon, val snr: Float? = null, val rssi: Int? = null)

A received Mesh Beacon invitation — an advisory, zero-hop advertisement from another mesh offering a channel to join. Beacons are unsigned and originate from nodes outside the local NodeDB, so this is deliberately not a message/contact; it lives in the Discovery surface instead.

MeshLog

data class MeshLog(val uuid: String, val message_type: String, val received_date: Long, val raw_message: String, val fromNum: Int = 0, val portNum: Int = 0, val fromRadio: FromRadio = FromRadio.Builder().build())

Represents a log entry in shared repository/domain code.

MeshUser

data class MeshUser(val id: String, val longName: String, val shortName: String, val hwModel: HardwareModel, val isLicensed: Boolean = false, val role: Int = 0)

Message

data class Message(val uuid: Long, val receivedTime: Long, val node: Node, val text: String, val fromLocal: Boolean, val time: String, val meshTime: Long = 0, val read: Boolean, val status: MessageStatus?, val routingError: Int, val packetId: Int, val emojis: List<Reaction>, val snr: Float?, val rssi: Int?, val hopsAway: Int, val replyId: Int?, val originalMessage: Message? = null, val viaMqtt: Boolean = false, val relayNode: Int? = null, val relays: Int = 0, val filtered: Boolean = false, val transportMechanism: Int = 0, val xeddsaSigned: Boolean = false, val ackProofStatus: Int = 0, val translatedText: String? = null, val showTranslated: Boolean = false)

MessageStatus

enum MessageStatus : Enum<MessageStatus>

MqttConnectionState

sealed class MqttConnectionState

App-level MQTT proxy connection state, decoupled from the MQTT library's internal type.

MqttJsonPayload

@Serializable

data class MqttJsonPayload(val type: String, val from: Long, val to: Long? = null, val channel: Int? = null, val payload: String? = null, val hopLimit: Int? = null, val id: Long? = null, val time: Long? = null, val sender: String? = null)

MqttProbeStatus

sealed class MqttProbeStatus

UI-friendly outcome of a one-shot MQTT broker reachability probe.

MyNodeInfo

data class MyNodeInfo(val myNodeNum: Int, val hasGPS: Boolean, val model: String?, val firmwareVersion: String?, val couldUpdate: Boolean, val shouldUpdate: Boolean, val currentPacketId: Long, val messageTimeoutMsec: Int, val minAppVersion: Int, val maxChannels: Int, val hasWifi: Boolean, val channelUtilization: Float, val airUtilTx: Float, val deviceId: String?, val pioEnv: String? = null)

NetworkDeviceHardware

@Serializable

data class NetworkDeviceHardware(val activelySupported: Boolean = false, val architecture: String = "", val displayName: String = "", val hasInkHud: Boolean? = null, val hasMui: Boolean? = null, val hwModel: Int = 0, val hwModelSlug: String = "", val images: List<String>? = null, val isMaker: Boolean = false, val key: String? = null, val partitionScheme: String? = null, val platformioTarget: String = "", val requiresDfu: Boolean? = null, val supportLevel: Int? = null, val tags: List<String>? = null, val variant: String? = null)

NetworkDeviceLink

@Serializable

data class NetworkDeviceLink(val shortCode: String = "", val url: String = "", val description: String? = null, val type: String = TYPE_INTERNAL, val targets: List<String>? = null, val hwModels: List<Int>? = null, val marketplace: String? = null, val regions: List<String>? = null)

A single resolved device link from the Meshtastic API.

NetworkDeviceLinksResponse

@Serializable

data class NetworkDeviceLinksResponse(val version: Int = 1, val generatedAt: String? = null, val source: String? = null, val links: List<NetworkDeviceLink> = emptyList())

Response envelope of GET /resource/deviceLinks on the Meshtastic API. The server resolves meshtastic/msh.to's catalog into fully-classified links (type + targets + regions), so the client only stores and filters them — no client-side matching heuristic.

NetworkFirmwareNightly

@Serializable

data class NetworkFirmwareNightly(val version: String = "", val id: String? = null, val title: String? = null, val commit: String? = null)

The nightly-preview pointer published to index.json at the root of the nightly host. Unlike the release channels above it is not served by api.meshtastic.org, and only version is guaranteed present — id and title are derived when absent, matching the web flasher's parsing.

NetworkFirmwareRelease

@Serializable

data class NetworkFirmwareRelease(val id: String = "", val pageUrl: String = "", val releaseNotes: String = "", val title: String = "", val zipUrl: String = "")

NetworkFirmwareReleases

@Serializable

data class NetworkFirmwareReleases(val releases: Releases = Releases())

The API also returns a pullRequests array of open firmware PRs. It is deliberately not modelled: nothing in the app offers PR builds, and the list turns over several times a day, so carrying it only churned the bundled asset. The shared kotlinx.serialization.json.Json is configured with ignoreUnknownKeys, so responses still decode.

Node

data class Node(val num: Int, val metadata: DeviceMetadata? = null, val user: User = User.Builder().build(), val position: Position = Position.Builder().build(), val snr: Float = Float.MAX_VALUE, val rssi: Int = Int.MAX_VALUE, val lastHeard: Int = 0, val deviceMetrics: DeviceMetrics = DeviceMetrics.Builder().build(), val channel: Int = 0, val viaMqtt: Boolean = false, val hopsAway: Int = -1, val isFavorite: Boolean = false, val isIgnored: Boolean = false, val isMuted: Boolean = false, val environmentMetrics: EnvironmentMetrics = EnvironmentMetrics.Builder().build(), val powerMetrics: PowerMetrics = PowerMetrics.Builder().build(), val airQualityMetrics: AirQualityMetrics = AirQualityMetrics.Builder().build(), val soilWaterMetrics: SoilWaterMetrics = SoilWaterMetrics.Builder().build(), val paxcounter: Paxcount = Paxcount.Builder().build(), val publicKey: ByteString? = null, val notes: String = "", val powerChannelLabels: List<String> = emptyList(), val manuallyVerified: Boolean = false, val signsPackets: Boolean = false, val heardOnCurrentLora: Boolean = true, val nodeStatus: String? = null, val lastTransport: Int = 0, val keyMatch: Boolean = true, val newPublicKey: ByteString? = null)

Domain model representing a node in the mesh network.

NodeAddress

sealed class NodeAddress

Type-safe representation of a mesh node address.

NodeListDensity

enum NodeListDensity : Enum<NodeListDensity>

Controls the visual density of the node list.

NodeSecurityIndicator

enum NodeSecurityIndicator : Enum<NodeSecurityIndicator>

Which security indicator a surface shows beside a node's name (design#149).

NodeSortOption

enum NodeSortOption : Enum<NodeSortOption>

OtafixAssetEntry

@Serializable

data class OtafixAssetEntry(val otafixBoardSlug: String, val sha256: String)

Position

data class Position(val latitude: Double, val longitude: Double, val altitude: Int, val time: Int = currentTime(), val satellitesInView: Int = 0, val groundSpeed: Int = 0, val groundTrack: Int = 0, val precisionBits: Int = 0)

RadioNotConnectedException

open class RadioNotConnectedException(message: String = "Not connected to radio", cause: Throwable? = null) : Exception

Exception thrown when an operation is attempted while not connected to a mesh radio.

Reaction

data class Reaction(val replyId: Int, val user: User, val emoji: String, val timestamp: Long, val snr: Float?, val rssi: Int?, val hopsAway: Int, val packetId: Int = 0, val status: MessageStatus = MessageStatus.UNKNOWN, val routingError: Int = 0, val relays: Int = 0, val relayNode: Int? = null, val to: String? = null, val channel: Int = 0, val sfppHash: ByteString? = null, val xeddsaSigned: Boolean = false, val ackProofStatus: Int = 0)

RegionInfo

enum RegionInfo : Enum<RegionInfo>

Regulatory regions for radio usage

RegionPresetConstraint

data class RegionPresetConstraint(val presets: List<Config.LoRaConfig.ModemPreset>, val defaultPreset: Config.LoRaConfig.ModemPreset, val licensedOnly: Boolean)

The modem presets the firmware advertised as legal for one LoRa region, decoded from a LoRaRegionPresetMap.

Releases

@Serializable

data class Releases(val alpha: List<NetworkFirmwareRelease> = listOf(), val stable: List<NetworkFirmwareRelease> = listOf())

SessionStatus

sealed interface SessionStatus

Durable per-node remote-administration session status, derived from the time of the last admin response that carried a session_passkey from the target node.

SoftDeviceVariant

enum SoftDeviceVariant : Enum<SoftDeviceVariant>

The Nordic SoftDevice an nRF52840 board's firmware is linked against. Static hardware fact, derived from the board's build.arduino.ldscript in meshtastic/firmware (nrf52840_s140_v6.ld / _v7.ld).

SoftDeviceVariantEntry

@Serializable

data class SoftDeviceVariantEntry(val hwModel: Int, val hwModelSlug: String? = null, val platformioTargets: List<String> = emptyList(), val softDevice: String? = null)

One hardware model's SoftDevice mapping.

TelemetryType

enum TelemetryType : Enum<TelemetryType>

TracerouteMapAvailability

enum TracerouteMapAvailability : Enum<TracerouteMapAvailability>

TracerouteOverlay

data class TracerouteOverlay(val requestId: Int, val forwardRoute: List<Int> = emptyList(), val returnRoute: List<Int> = emptyList())

Represents a traceroute result with forward and return routes as ordered lists of node nums.

Properties

destination

val DataPacket.destination: NodeAddress

Type-safe interpretation of DataPacket.to.

fullRouteDiscovery

val MeshPacket.fullRouteDiscovery: RouteDiscovery?

isBroadcast

val DataPacket.isBroadcast: Boolean

Checks whether this packet is addressed to the broadcast channel.

isLocked

val Waypoint.isLocked: Boolean

Whether this waypoint is locked to a single node. A locked waypoint (locked_to != 0) may only be edited or removed mesh-wide by the node it is locked to; an unlocked waypoint (locked_to == 0) is editable by anyone.

MENTION_TOKEN_REGEX

val MENTION_TOKEN_REGEX: Regex

The @mention wire token: @ followed by a node's hex user id (@!ffccee11). This is the single source of truth for the cross-platform wire format (see meshtastic/design#21) so the compose input, message rendering, and notification paths all detect it identically. The 8-hex run plus the negative lookahead reject a partial match against a longer id.

neighborInfo

val MeshPacket.neighborInfo: NeighborInfo?

noiseFloorOrNull

val LocalStats.noiseFloorOrNull: Int?

Last measured noise floor in dBm, or null when this reading has never been reported (LocalStats.noise_floor still holds firmware's 0 "no reading yet" sentinel). Every read of noise_floor should go through this so every consumer treats absence the same way, rather than each site repeating its own != 0 / ?: 0 guard.

numChannels

val Config.LoRaConfig.numChannels: Int

schemaEnumValuePrefixes

val schemaEnumValuePrefixes: Set<String>

The resource prefix every value of a labelled enum shares, one per enum. A consumer that has to tell an enum value's resource from a field's - settings search, which indexes fields and not the values they offer - reads this rather than keeping its own copy of the list.

snrLimit

val Config.LoRaConfig.ModemPreset?.snrLimit: Float

The SNR (in dB) at or above which a packet sent with this modem preset can still be demodulated — i.e. the spreading-factor-determined demodulation floor. Signal quality should be judged relative to this limit, since the same SNR means very different things per preset: -15 dB is excellent on LongSlow (SF12) yet unusable on ShortFast (SF7).

source

val DataPacket.source: NodeAddress

Type-safe interpretation of DataPacket.from.

supportTier

val DeviceHardware.supportTier: HardwareSupportTier

Resolves the rung in one place so every surface agrees. DeviceHardware.isMaker is a relationship and wins first, so a maker board never reads as plain supported once the registry promotes it; DeviceHardware.activelySupported is the project's lifecycle flag and decides the other two rungs. A legacy or untiered maker board falls through to that lifecycle check.

Functions

asFirmwareRelease

fun NetworkFirmwareNightly.asFirmwareRelease(): NetworkFirmwareRelease?

Normalizes the nightly pointer into the common release shape, or null when the pointer carries no usable version. Nightly artifacts are served per-file from the nightly host's root, so there is no release zip.

constraintFor

fun LoRaRegionPresetMap?.constraintFor(region: Config.LoRaConfig.RegionCode): RegionPresetConstraint?

Resolves the RegionPresetConstraint the firmware advertised for region, or null when there is no constraint information and the client must therefore NOT restrict the preset list. A null result happens when:

defaultPresetFor

fun defaultPresetFor(region: Config.LoRaConfig.RegionCode): Config.LoRaConfig.ModemPreset?

The app's preferred default preset for region, or null when it has no region-specific default and the caller should fall back to ChannelOption.DEFAULT / the current preset.

evaluateTracerouteMapAvailability

fun evaluateTracerouteMapAvailability(forwardRoute: List<Int>, returnRoute: List<Int>, positionedNodeNums: Set<Int>): TracerouteMapAvailability

excludes

fun DeviceMetadata?.excludes(module: ExcludedModules): Boolean

Whether the node reports module compiled out of its firmware. Metadata not read yet excludes nothing.

firstSetupDefaultFor

fun LoRaRegionPresetMap?.firstSetupDefaultFor(region: Config.LoRaConfig.RegionCode): Config.LoRaConfig.ModemPreset?

The preset a first-ever setup in region should install, or null to leave the choice alone.

getAckProofStatusRes

fun getAckProofStatusRes(ackProofStatus: Int): Pair<StringResource, StringResource>?

The ack proof rows the message detail sheet shows, or null when no proof was carried - the ordinary case, and every ack from firmware that predates MeshPacket.AckProofStatus.

getColorFrom

fun getColorFrom(team: Team): Long

getMessageRoutingErrorDetailResFrom

fun getMessageRoutingErrorDetailResFrom(routingError: Int): StringResource?

getMessageRoutingErrorStringResFrom

fun getMessageRoutingErrorStringResFrom(routingError: Int): StringResource

getMessageStatusDetailRes

fun getMessageStatusDetailRes(status: MessageStatus?, routingError: Int): StringResource?

getMessageStatusStringRes

fun getMessageStatusStringRes(status: MessageStatus?, routingError: Int, isDirectMessage: Boolean = false, ackProofStatus: Int = 0): Pair<StringResource, StringResource>

getNeighborInfoResponse

fun MeshPacket.getNeighborInfoResponse(getUser: (nodeNum: Int) -> String, header: String = "Neighbors:"): String?

fun NeighborInfo.getNeighborInfoResponse(getUser: (nodeNum: Int) -> String, header: String = "Neighbors:"): String

getStringResFrom

fun getStringResFrom(routingError: Int): StringResource

getTracerouteResponse

fun MeshPacket.getTracerouteResponse(getUser: (nodeNum: Int) -> String, headerTowards: String = "Route traced toward destination:", headerBack: String = "Route traced back to us:"): String?

fun RouteDiscovery.getTracerouteResponse(getUser: (nodeNum: Int) -> String, headerTowards: String = "Route traced toward destination:", headerBack: String = "Route traced back to us:"): String

isAckProofForged

fun isAckProofForged(ackProofStatus: Int): Boolean

True when an ack carried a proof and it did not verify, which is an attempted forgery rather than a quiet absence.

isFromLocal

fun DataPacket.isFromLocal(myNodeNum: Int? = null): Boolean

Checks whether this packet originated from the local device.

isMessageStatusRetryable

fun isMessageStatusRetryable(status: MessageStatus?, routingError: Int, isDirectMessage: Boolean = false): Boolean

isModifiableBy

fun Waypoint.isModifiableBy(nodeNum: Int?): Boolean

Whether nodeNum is permitted to edit this waypoint or broadcast a change/removal of it: true when the waypoint is unlocked, or locked to exactly nodeNum. A null nodeNum (our own identity not yet known) can only modify unlocked waypoints.

isUnmessageableRole

fun Config.DeviceConfig.Role?.isUnmessageableRole(): Boolean

matchesSearch

fun Node.matchesSearch(filter: String): Boolean

Matches node search text (long/short name, hex id, decimal id, status message) with Unicode-aware case folding.

mergePowerChannelLabel

fun mergePowerChannelLabel(existing: List<String>, channelIndex: Int, label: String): List<String>

Merges a user-editable power-channel label into existing at the 0-based channelIndex.

nodeColorsFromNum

fun nodeColorsFromNum(nodeNum: Int): Pair<Int, Int>

Derives a unique color pair from a node number. Returns (foreground, background) as @ColorInt.

normalizeCodingRateOverride

fun Config.LoRaConfig.normalizeCodingRateOverride(): Config.LoRaConfig

With use_preset on, keeps coding_rate only while it raises the preset's own coding rate, and stores 0 ("use the preset's") otherwise, so a value firmware ignores never sits in the config looking like it applies. A manual config, or a preset with no ChannelOption, comes back unchanged.

presetForRegionChange

fun LoRaRegionPresetMap?.presetForRegionChange(previousRegion: Config.LoRaConfig.RegionCode, newRegion: Config.LoRaConfig.RegionCode, current: Config.LoRaConfig.ModemPreset): Config.LoRaConfig.ModemPreset

Returns the modem preset the LoRa form should hold when the region changes from previousRegion to newRegion with current selected.

repairPresetFor

fun LoRaRegionPresetMap?.repairPresetFor(region: Config.LoRaConfig.RegionCode, current: Config.LoRaConfig.ModemPreset): Config.LoRaConfig.ModemPreset

Returns the modem preset the LoRa form should hold for region given the currently-selected current preset.

schemaDescriptionRes

fun Enum<*>.schemaDescriptionRes(): StringResource?

The schema's one-sentence explanation of this enum value, or null where it has none.

schemaLabelRes

fun Enum<*>.schemaLabelRes(): StringResource?

The schema's label for this enum value, or null where the schema does not name it. A picker shows this in place of the constant's Kotlin name, and falls back to that name when it is null, so a value the schema has not reached still renders.

textMentionsNode

fun textMentionsNode(text: String?, userId: String): Boolean

True if text @mentions the node whose hex user id is userId (e.g. !ffccee11), honoring the token boundary — a trailing hex digit (@!ffccee11a) is a different, longer id and is not a match.

toDeviceLink

fun NetworkDeviceLink.toDeviceLink(): DeviceLink

Pure mapping to the cached domain model. Callers are expected to drop TYPE_INTERNAL links (GitHub, YouTube, …), which never belong to a device's purchase section.

utf8Size

fun String.utf8Size(): Int

UTF-8 length in bytes, the unit every max_size in the protobuf options is counted in.