feature-firmware/org.meshtastic.feature.firmware.ota.dfu/LegacyDfuException

LegacyDfuException

sealed class LegacyDfuException : DfuException(source)

Errors specific to the Nordic Legacy DFU protocol. These are a subtype of DfuException so the existing handler error-path code (which catches DfuException) covers both protocols.

Inheritors

ProtocolError

UnsupportedBootloader

InitPacketNotLegacy

PacketReceiptMismatch

StaleSessionReset

Types

InitPacketNotLegacy

class InitPacketNotLegacy(size: Int) : LegacyDfuException

Init packet (dat) appears to be Secure-DFU shaped (signed/CBOR), not the small legacy 14-32 B form.

PacketReceiptMismatch

class PacketReceiptMismatch(expected: Long, actual: Long) : LegacyDfuException

Bytes received reported by device differs from bytes sent past last PRN window.

ProtocolError

class ProtocolError(val requestOpcode: Byte, val status: Byte) : LegacyDfuException

Device returned a non-success status for a given opcode.

StaleSessionReset

class StaleSessionReset : LegacyDfuException

START_DFU was rejected with INVALID_STATE because the bootloader still holds a previous, interrupted DFU session. The transport has issued a RESET; retrying the whole session (fresh reconnect) will start over on the now-clean bootloader. Retryable — distinct from a hard ProtocolError.

UnsupportedBootloader

class UnsupportedBootloader(version: Int) : LegacyDfuException

Bootloader exposes DFU Version characteristic with a value below 5 (Nordic SDK ≤ 6). Unsupported.

Properties

cause

expect open val cause: Throwable?

message

expect open val message: String?