Verbosity for Kable's internal BLE logging. Wraps Logging.Level so callers and the Koin DI graph don't leak Kable types into modules that don't directly depend on Kable.

BleScanner

interface BleScanner

A scanner for BLE devices.

BleScanStartException

class BleScanStartException(val reason: BleScanStartFailureReason, cause: Throwable) : IllegalStateException

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

BleScanStartFailureReason

enum BleScanStartFailureReason : Enum<BleScanStartFailureReason>

Known reasons a BLE discovery scan failed before Android registered the scanner.

BleService

interface BleService

Represents a BLE service for commonMain.

BleWriteType

enum BleWriteType : Enum<BleWriteType>

Represents the type of write operation.

BluetoothRepository

interface BluetoothRepository

Repository responsible for Bluetooth availability and bonding.

BluetoothState

data class BluetoothState(val hasPermissions: Boolean = false, val enabled: Boolean = false, val bondedDevices: List<BleDevice> = emptyList())

Represents the state of Bluetooth on the device.

DisconnectReason

sealed interface DisconnectReason

Platform-agnostic reason for a BLE disconnect.

KableBleConnection

class KableBleConnection(scope: CoroutineScope, loggingConfig: BleLoggingConfig) : BleConnection

BleConnection implementation using Kable for cross-platform BLE communication.

KableBleConnectionFactory

class KableBleConnectionFactory(loggingConfig: BleLoggingConfig) : BleConnectionFactory

KableBleScanner

open class KableBleScanner(loggingConfig: BleLoggingConfig) : BleScanner

KableBleService

class KableBleService(peripheral: Peripheral, serviceUuid: Uuid) : BleService

BleService implementation backed by a Kable Peripheral for a specific GATT service.

KableBluetoothRepository

class KableBluetoothRepository : BluetoothRepository

KableMeshtasticRadioProfile

class KableMeshtasticRadioProfile(service: BleService) : MeshtasticRadioProfile

MeshtasticRadioProfile implementation using Kable BLE characteristics.

MeshtasticBleConstants

object MeshtasticBleConstants

Constants for Meshtastic Bluetooth LE interaction.

MeshtasticBleDevice

class MeshtasticBleDevice(val address: String, val name: String? = null, val advertisement: Advertisement? = null) : BleDevice

Unified BleDevice implementation for all BLE devices — scanned, bonded, or both.

MeshtasticRadioProfile

interface MeshtasticRadioProfile

A definition of the Meshtastic BLE Service profile.

Properties

DEFAULT_BLE_WRITE_VALUE_LENGTH

const val DEFAULT_BLE_WRITE_VALUE_LENGTH: Int = 20

Safe ATT payload length when MTU negotiation is unavailable (23-byte ATT MTU minus 3-byte header).

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.

retryBleOperation

suspend fun <T> retryBleOperation(count: Int = 3, delayMs: Long = 250, tag: String = "BLE", block: suspend () -> T): T

Retries a BLE operation with bounded exponential backoff and jitter.

toBleConnectionState

fun State.toBleConnectionState(hasStartedConnecting: Boolean): BleConnectionState?

Maps Kable's State to Meshtastic's BleConnectionState.

toDisconnectReason

fun State.Disconnected.Status?.toDisconnectReason(): DisconnectReason

Maps Kable's State.Disconnected.Status to DisconnectReason.

toMeshtasticRadioProfile

fun BleService.toMeshtasticRadioProfile(): MeshtasticRadioProfile

Extension to convert a BleService to a MeshtasticRadioProfile.