core-repository/org.meshtastic.core.repository/LockdownCoordinator

LockdownCoordinator

Coordinates lockdown passphrase authentication for firmware-locked devices.

Implementations handle the full authentication lifecycle: auto-unlock with a stored passphrase, manual passphrase submission, lock-now, and session lifecycle hooks.

Functions

handleLockdownStatus

abstract fun handleLockdownStatus(status: LockdownStatus)

Routes an incoming typed LockdownStatus from FromRadio.

lockNow

abstract fun lockNow(): Boolean

onConfigComplete

abstract fun onConfigComplete()

Lifecycle hook called on every config_complete_id from the device.

onConnect

abstract fun onConnect()

Called when a BLE connection is established, before the first config request.

onDisconnect

abstract fun onDisconnect()

Called when a BLE connection is lost.

submitPassphrase

abstract fun submitPassphrase(passphrase: String, boots: Int, hours: Int, maxSessionSeconds: Int = 0, disable: Boolean = false): Boolean

Submits a passphrase to authenticate with the locked device.