Sets the initial loading state for remote config sub-screens. Must be called before the first collectAsStateWithLifecycle read so the LoadingOverlay is visible from the very first composition frame.

exportProfile

fun exportProfile(uri: CommonUri, profile: DeviceProfile)

getCloseable

expect fun <T : AutoCloseable> getCloseable(key: String): T?

getCurrentLocation

open suspend fun getCurrentLocation(): Location?

importProfile

fun importProfile(uri: CommonUri, onResult: (DeviceProfile) -> Unit)

installProfile

fun installProfile(protobuf: DeviceProfile)

probeMqttConnection

fun probeMqttConnection(address: String, tlsEnabled: Boolean, username: String?, password: String?)

Run a one-shot reachability/credentials probe against an MQTT broker. Cancels any in-flight probe before starting a new one. Result is exposed via mqttProbeStatus.

removeFixedPosition

fun removeFixedPosition()

restoreSecurityKeys

fun restoreSecurityKeys()

Restores the previously backed-up keys for this node and pushes them to the device via admin config.

saveUserConfig

fun saveUserConfig(user: User)

Routes the User config save: ham onboarding (set_ham_mode) when the licensed toggle transitions OFF→ON on the locally connected node, setOwner otherwise. Routing on the transition — not the toggle state — keeps subsequent saves of an already-licensed node on the set_owner path, so edits to other owner fields still reach the device and the node doesn't reboot on every save (firmware reboots on set_ham_mode). The local-node guard is the backstop for the UI gate — set_ham_mode must never be sent to a remote node.

securityKeyBackupExists

fun securityKeyBackupExists(): Boolean

Whether an encrypted key backup exists for the node currently being configured.

sendLockNow

fun sendLockNow()

setCannedMessages

fun setCannedMessages(messages: String)

setConfig

fun setConfig(config: Config)

setFixedPosition

fun setFixedPosition(position: Position)

setModuleConfig

fun setModuleConfig(config: ModuleConfig)

setMqttProxyActive

fun setMqttProxyActive(active: Boolean)

Phone-local control over the MQTT proxy that does not touch the device's persisted MQTT config. Turning it off calls MqttManager.stop immediately, cutting the proxy firehose that can saturate the BLE link and MCU on nRF devices — no slow device read-modify-write-readback round-trip. Turning it back on resumes proxying using the device's current MQTT config (a no-op unless the device has MQTT and proxy-to-client enabled).

setOwner

fun setOwner(user: User)

Sends a plain set_owner with user. Prefer saveUserConfig for User config screen saves — it routes ham onboarding to set_ham_mode when the licensed toggle is first enabled; calling this directly bypasses that.

setPreserveFavorites

fun setPreserveFavorites(preserveFavorites: Boolean)

setResponseStateLoading

fun setResponseStateLoading(route: Enum<*>)

setRingtone

fun setRingtone(ringtone: String)

setShouldReportLocation

fun setShouldReportLocation(nodeNum: Int?, shouldReportLocation: Boolean)

shouldReportLocation

fun shouldReportLocation(nodeNum: Int?): StateFlow<Boolean>

submitLockdownPassphrase

fun submitLockdownPassphrase(passphrase: String, boots: Int = LockdownPassphraseStore.DEFAULT_BOOTS, hours: Int = 0, maxSessionSeconds: Int = 0, disable: Boolean = false)

Submits a lockdown passphrase: enables lockdown (from DISABLED), authenticates (disable=false from LOCKED), or turns lockdown off (disable=true from UNLOCKED).

toggleAnalyticsAllowed

fun toggleAnalyticsAllowed()

toggleHomoglyphCharactersEncodingEnabled

fun toggleHomoglyphCharactersEncodingEnabled()

updateChannels

fun updateChannels(new: List<ChannelSettings>, old: List<ChannelSettings>)