core-ble/org.meshtastic.core.ble/BleScanStartException

BleScanStartException

class BleScanStartException(val reason: BleScanStartFailureReason, cause: Throwable, val retryAfter: Duration? = null) : IllegalStateException, ExpectedCondition(source)

A discovery scan-start failure. No advertisements can be delivered until a future scan starts successfully.

This is an ExpectedCondition: every BleScanStartFailureReason describes the environment refusing the scan, not a defect in the app, so callers should surface it to the user and log it at warn level rather than reporting it.

Constructors

constructor(reason: BleScanStartFailureReason, cause: Throwable, retryAfter: Duration? = null)

Properties

cause

expect open val cause: Throwable?

expectedConditionLabel

open override val expectedConditionLabel: String

message

expect open val message: String?

reason

val reason: BleScanStartFailureReason

retryAfter

val retryAfter: Duration?

Functions

classifyBleException

fun Throwable.classifyBleException(): BleExceptionInfo?

Inspects this Throwable and returns a BleExceptionInfo if it is a known Kable exception, or null if it is unrelated to the BLE layer.

isSessionFatalBleException

fun Throwable.isSessionFatalBleException(): Boolean

Returns true if this throwable indicates the BLE session is irrecoverably broken and should be torn down (triggering reconnection), as opposed to a transient condition that can be retried.