kmp-ble-dfu/com.atruedev.kmpble.dfu/DfuError

DfuError

sealed interface DfuError

Failure conditions during a firmware update.

Every subtype is both a DfuError and an Exception, so errors can be caught with standard try/catch and also pattern-matched via when. Errors are surfaced through DfuProgress.Failed when using DfuController.

Inheritors

NotConnected

ServiceNotFound

CharacteristicNotFound

Types

Aborted

data class Aborted(val message: String = "DFU was aborted") : Exception, DfuError

The DFU was cancelled by calling DfuController.abort.

CharacteristicNotFound

data class CharacteristicNotFound(val name: String, val message: String = "DFU characteristic not found: ") : Exception, DfuError

A required DFU GATT characteristic is missing from the service.

ChecksumMismatch

data class ChecksumMismatch(val expected: UInt, val actual: UInt) : Exception, DfuError

CRC32 verification failed after transferring an object.

FirmwareParseError

data class FirmwareParseError(val message: String, val cause: Throwable? = null) : Exception, DfuError

The firmware .zip archive could not be parsed.

HashMismatch

data class HashMismatch(val algorithm: String, val expected: String, val actual: String) : Exception, DfuError

Hash verification failed after transferring firmware.

ImageSlotError

data class ImageSlotError(val message: String) : Exception, DfuError

MCUboot image slot management error.

NotConnected

data class NotConnected(val message: String = "Peripheral is not connected") : Exception, DfuError

Peripheral was not in Connected state when the DFU started.

ProtocolError

data class ProtocolError(val opcode: Int, val resultCode: Int, val message: String) : Exception, DfuError

The peripheral returned an error response to a DFU command.

ServiceNotFound

data class ServiceNotFound(val message: String = "DFU service not found on peripheral") : Exception, DfuError

The peripheral does not expose the required DFU GATT service.

Timeout

data class Timeout(val message: String = "DFU operation timed out") : Exception, DfuError

A DFU command did not receive a response within the configured DfuOptions.commandTimeout.

TransferFailed

data class TransferFailed(val message: String, val cause: Throwable? = null) : Exception, DfuError

Catch-all for transport-level failures (disconnects, write errors).