GattKt

Android library that convert BluetoothGattCallback to ergonomic Kotlin coroutines API.

See also sorz/blescanner for library that scan BLE device with Kotlin coroutines.

Current support:

• Connect to GATT server and discovery GATT services
• Write an characteristic
• Enable/disable notification/indication (with necessary descriptor set)
• Read notification/indication value

PR is welcome if you need more functions.

Install

• Add JitPack to your build file.
• Add implementation 'com.github.sorz:gattkt:{VERSION}

Example

suspend fun handleAwesomeDevice(context: Context, device: BluetoothDevice) {
    val gattIo = device.connectGattIo(context)
    val char = gattIo.requireCharacteristic(UUID_SOME_SERVICE, UUID_SOME_CHAR)

    gattIo.enableNotification(char)
    gattIo.writeCharacteristic(char, byteArrayOf(...))
    val resp = gattIo.readCharacteristicChange(char)
    println("response: ${resp.contentToString()}")
    gattIo.disableNotificationOrIndication(char)

    gattIo.gatt.close()
}

Real-world example: MiBand.kt

Debugging

Logs don't get printed by default. To enable logging, execute:

adb shell setprop log.tag.GattIo debug