BLE-X/io.github.romantsisyk.blex.exception/BleCharacteristicException

BleCharacteristicException

class BleCharacteristicException(message: String, val gattStatus: Int? = null, val characteristicUuid: String? = null, val operation: BleCharacteristicException.CharacteristicOperation? = null) : BleException

Exception thrown when a characteristic operation (read, write, or notify) fails.

This exception provides detailed information about which operation failed and on which characteristic, making it easier to diagnose and handle specific failures.

Common Causes

Characteristic does not support the requested operation
Insufficient encryption or authentication
Invalid value length
Characteristic not found
Device disconnected during operation

Usage Example

when (error) {
    is BleCharacteristicException -> {
        val opName = error.operation?.name ?: "UNKNOWN"
        Log.e("BLE", "$opName failed on ${error.characteristicUuid}")

        when (error.operation) {
            CharacteristicOperation.READ -> handleReadFailure()
            CharacteristicOperation.WRITE -> handleWriteFailure()
            CharacteristicOperation.NOTIFY -> handleNotifyFailure()
            null -> handleUnknownFailure()
        }
    }
}