RadioController
Central interface for controlling the radio and mesh network.
This is a composite interface that extends the focused sub-interfaces below. Feature modules that need the full surface inject RadioController; modules that need only a subset can inject the narrower interface for better testability and clearer dependency intent.
Sub-interfaces (mirrors SDK's layered API design):
AdminController — config, channels, owner, device lifecycle (→ SDK
AdminApi)MessagingController — send packets, reactions, contacts (→ SDK
RadioClient.send*)NodeController — favorite, ignore, mute, remove nodes (→ SDK
AdminApinode ops)QueryController — telemetry, traceroute, position queries (→ SDK
TelemetryApi/RoutingApi)
When migrating to the SDK, each sub-interface becomes a thin adapter over the corresponding SDK API. The composite RadioController can then be deprecated and consumers migrated to the narrower interfaces one at a time.
Properties
Flow of notifications from the radio client.
Convenience view of monotonic departures and completed handshakes. Use connectionLifecycle when the counters must be correlated with a specific state, because independent StateFlow collections can observe different versions.
Atomically correlated canonical state and lifecycle evidence.
Canonical app-level connection state.
Monotonic transport-session generation used to reject work captured by a replaced connection.
Functions
Clears the current clientNotification.
Runs block as an editSettings transaction against the local node.
Performs a factory reset on a node.
Generates a unique packet ID for a new request.
Requests the current canned messages from a remote node.
Requests a specific channel configuration from a remote node.
Requests the hardware connection status from a remote node.
Requests a module configuration section from a remote node.
Requests the current ringtone from a remote node.
Imports a shared contact into the firmware's NodeDB.
Resets the NodeDB on a node.
Plays the node's saved ringtone once via AdminMessage.play_ringtone_request. Fire-and-forget: the firmware sends no response, and builds without RTTTL support ignore it.
Commands a node to reboot into DFU mode.
Requests device metadata from a remote node. A requestId of 0 lets the sender assign one.
Removes a node from the mesh by its node number.
Requests a single framebuffer frame from the locally connected node, delivered like mirrored frames.
Requests that the next BLE connection invalidates Android's GATT service cache. Call before setDeviceAddress when reconnecting after a firmware update.
Requests neighbor information (detected nodes) from a remote node.
Requests the current GPS position from a remote node. A requestId of 0 lets the sender assign one.
Initiates an OTA reboot request.
Requests telemetry data from a remote node.
Initiates a traceroute request to a remote node.
Requests detailed user info from a remote node. A requestId of 0 lets the sender assign one.
Restores local radio settings only while expectedDeviceAddress is still selected.
Injects a physical input event (button/key/touch) into the locally connected node's UI via the firmware InputBroker. Event codes are the firmware's input_broker_event values. Non-suspend immediate send: input must not queue behind bulk admin traffic.
Sends a data packet to the mesh.
Sends an emoji reaction to a message. Awaits local DB persistence.
Sends our shared contact information (identity and public key) to the firmware's NodeDB.
Updates the canned messages configuration on a remote node.
Changes the device address (e.g., BLE MAC, IP address) we are communicating with.
Enables or disables live display mirroring on the locally connected node. While enabled, the device streams its framebuffer as FromRadio.display_frame chunks — collect them via DisplayMirrorManager. Non-suspend (immediate send, bypassing the outbound FIFO) so lifecycle teardown can reliably disable the stream.
Sets the favorite status of a node on the radio.
Sets a fixed position on a remote node.
Enables amateur-radio (ham) mode on a node via AdminMessage.set_ham_mode.
Sets the ignore status of a node on the radio.
Updates a local radio channel. Same fire-and-forget contract as setLocalConfig.
Updates the local radio configuration.
Updates a module configuration on a remote node.
Updates a channel configuration on a remote node.
Updates the notification ringtone on a remote node.
Starts providing the phone's location to the mesh.
Stops providing the phone's location to the mesh.
Toggles the mute status of a node on the radio. Mirrors the SDK's toggleMuted(NodeId).