feature-firmware/org.meshtastic.feature.firmware/FirmwareUpdateState

FirmwareUpdateState

sealed interface FirmwareUpdateState(source)

State machine for the firmware update flow, observed by FirmwareUpdateScreen.

Inheritors

VerificationFailed

AwaitingFileSave

Types

AwaitingFileSave

data class AwaitingFileSave(val uf2Artifact: FirmwareArtifact, val fileName: String) : FirmwareUpdateState

UF2 file is ready; waiting for the user to choose a save location (USB flow).

data object Checking : FirmwareUpdateState

Resolving device hardware and fetching available firmware releases.

data class Downloading(val progressState: ProgressState) : FirmwareUpdateState

Firmware file is being downloaded from the release server.

data class Error(val error: UiText) : FirmwareUpdateState

An error occurred at any stage of the update pipeline.

data object Idle : FirmwareUpdateState

No update activity — initial state before FirmwareUpdateViewModel.checkForUpdates runs.

data class Processing(val progressState: ProgressState) : FirmwareUpdateState

Intermediate processing (e.g. extracting, preparing DFU).

data class Ready(val release: FirmwareRelease?, val deviceHardware: DeviceHardware, val address: String, val showBootloaderWarning: Boolean, val updateMethod: FirmwareUpdateMethod, val currentFirmwareVersion: String? = null) : FirmwareUpdateState

Device and release info resolved; the user may initiate an update.

data object Success : FirmwareUpdateState

The firmware update completed and the device reconnected successfully.

data class Updating(val progressState: ProgressState) : FirmwareUpdateState

Firmware is actively being written to the device.

VerificationFailed

data object VerificationFailed : FirmwareUpdateState

The device did not reconnect within the expected timeout after flashing.

data object Verifying : FirmwareUpdateState

Waiting for the device to reboot and reconnect after a successful flash.