Meshtastic App/com.geeksville.mesh.service/SafeBluetooth

SafeBluetooth

class SafeBluetooth(context: Context, device: BluetoothDevice, analytics: PlatformAnalytics) : Closeable(source)

Uses coroutines to safely access a bluetooth GATT device with a synchronous API

The BTLE API on android is dumb. You can only have one outstanding operation in flight to the device. If you try to do something when something is pending, the operation just returns false. You are expected to chain your operations from the results callbacks.

This class fixes the API by using coroutines to let you safely do a series of BTLE operations.

Constructors

SafeBluetooth

constructor(context: Context, device: BluetoothDevice, analytics: PlatformAnalytics)

Types

BLEStatusException

class BLEStatusException(val status: Int, msg: String) : BLEException

A BLE status code based error

Companion

object Companion

Properties

gatt

@Volatile

var gatt: BluetoothGatt?

state

@Volatile

var state: Int

Functions

asyncConnect

fun asyncConnect(autoConnect: Boolean = false, cb: (Result<Unit>) -> Unit, lostConnectCb: () -> Unit)

start a connection attempt.

asyncDiscoverServices

fun asyncDiscoverServices(cb: (Result<Unit>) -> Unit)

asyncReadCharacteristic

fun asyncReadCharacteristic(c: BluetoothGattCharacteristic, cb: (Result<BluetoothGattCharacteristic>) -> Unit)

asyncReadRemoteRssi

fun asyncReadRemoteRssi(cb: (Result<Int>) -> Unit)

asyncRequestMtu

fun asyncRequestMtu(len: Int, cb: (Result<Unit>) -> Unit)

asyncWriteCharacteristic

fun asyncWriteCharacteristic(c: BluetoothGattCharacteristic, v: ByteArray, cb: (Result<BluetoothGattCharacteristic>) -> Unit)

asyncWriteDescriptor

fun asyncWriteDescriptor(c: BluetoothGattDescriptor, value: ByteArray, cb: (Result<BluetoothGattDescriptor>) -> Unit)

open override fun close()

Close and destroy this SafeBluetooth instance. You'll need to make a new instance before using it again

closeConnection

fun closeConnection()

Close down any existing connection, any existing calls (including async connects will be cancelled and you'll need to recall connect to use this againt

closeGatt

fun closeGatt()

Close just the GATT device but keep our pending callbacks active

connect

fun connect(autoConnect: Boolean = false)

setNotify

fun setNotify(c: BluetoothGattCharacteristic, enable: Boolean, onChanged: (BluetoothGattCharacteristic) -> Unit)