feature-firmware/org.meshtastic.feature.firmware/FirmwareUpdateViewModel

FirmwareUpdateViewModel

class FirmwareUpdateViewModel(firmwareReleaseRepository: FirmwareReleaseRepository, deviceHardwareRepository: DeviceHardwareRepository, maintenanceUf2Repository: MaintenanceUf2Repository, nodeRepository: NodeRepository, radioController: RadioController, radioPrefs: RadioPrefs, bootloaderWarningDataSource: BootloaderWarningDataSource, firmwareRecoveryDataSource: FirmwareRecoveryDataSource, firmwareUpdateManager: FirmwareUpdateManager, usbManager: FirmwareUsbManager, fileHandler: FirmwareFileHandler, firmwareRetriever: FirmwareRetriever, radioOperationLock: RadioOperationLock, applicationScope: ApplicationCoroutineScope, hiddenFeaturesUnlock: HiddenFeaturesUnlock, analytics: PlatformAnalytics, nodeRestartTracker: NodeRestartTracker, bluetoothRepository: BluetoothRepository, firmwareUpdateStatusRepository: FirmwareUpdateStatusRepository) : ViewModel(source)

ViewModel driving the firmware update screen. Coordinates release checking, file retrieval, transport-specific update execution, and post-update device verification.

Constructors

constructor(firmwareReleaseRepository: FirmwareReleaseRepository, deviceHardwareRepository: DeviceHardwareRepository, maintenanceUf2Repository: MaintenanceUf2Repository, nodeRepository: NodeRepository, radioController: RadioController, radioPrefs: RadioPrefs, bootloaderWarningDataSource: BootloaderWarningDataSource, firmwareRecoveryDataSource: FirmwareRecoveryDataSource, firmwareUpdateManager: FirmwareUpdateManager, usbManager: FirmwareUsbManager, fileHandler: FirmwareFileHandler, firmwareRetriever: FirmwareRetriever, radioOperationLock: RadioOperationLock, applicationScope: ApplicationCoroutineScope, hiddenFeaturesUnlock: HiddenFeaturesUnlock, analytics: PlatformAnalytics, nodeRestartTracker: NodeRestartTracker, bluetoothRepository: BluetoothRepository, firmwareUpdateStatusRepository: FirmwareUpdateStatusRepository)

Properties

connectionState

val connectionState: StateFlow<ConnectionState>

currentFirmwareVersion

val currentFirmwareVersion: StateFlow<String?>

deviceHardware

val deviceHardware: StateFlow<DeviceHardware?>

nightlyUnlocked

val nightlyUnlocked: StateFlow<Boolean>

The version-row easter egg also unlocks the nightly preview channel, like the web flasher's konami code.

pendingLocalFirmwareFile

val pendingLocalFirmwareFile: StateFlow<PendingLocalFirmwareFile?>

selectedRelease

val selectedRelease: StateFlow<FirmwareRelease?>

selectedReleaseType

val selectedReleaseType: StateFlow<FirmwareReleaseType>

state

val state: StateFlow<FirmwareUpdateState>

Functions

addCloseable

expect open fun addCloseable(closeable: AutoCloseable)

expect fun addCloseable(key: String, closeable: AutoCloseable)

cancelUpdate

fun cancelUpdate()

checkForUpdates

fun checkForUpdates()

confirmBootloaderUpgrade

fun confirmBootloaderUpgrade()

Writes the reviewed bootloader upgrade to the drive the review read.

confirmLocalFirmwareFile

fun confirmLocalFirmwareFile()

dismissBootloaderWarningForCurrentDevice

fun dismissBootloaderWarningForCurrentDevice()

dismissLocalFirmwareFile

fun dismissLocalFirmwareFile()

getCloseable

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

prepareLocalFirmwareFile

fun prepareLocalFirmwareFile(uri: CommonUri)

saveDfuFile

fun saveDfuFile(uri: CommonUri)

setReleaseType

fun setReleaseType(type: FirmwareReleaseType)

skipBootloaderUpgrade

fun skipBootloaderUpgrade()

Moves on to reinstalling the firmware without writing the bootloader, so nothing destructive has happened.

startBootloaderUpgrade

fun startBootloaderUpgrade()

startUpdate

fun startUpdate(wipeDevice: Boolean = false)

writeMaintenancePass

fun writeMaintenancePass(treeUri: CommonUri)

Resumes a maintenance sequence once the user has pointed at the device's UF2 volume.