core-ble/org.meshtastic.core.ble/KableBleService

KableBleService

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

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

Constructors

KableBleService

constructor(peripheral: Peripheral, serviceUuid: Uuid)

Functions

characteristic

open fun characteristic(uuid: Uuid): BleCharacteristic

Creates a handle for a characteristic belonging to this service.

discoveredCharacteristicUuids

open override fun discoveredCharacteristicUuids(): List<Uuid>

Returns the UUIDs of all characteristics discovered for this service. Empty for non-Kable platforms.

hasCharacteristic

open override fun hasCharacteristic(characteristic: BleCharacteristic): Boolean

Returns true when the characteristic is present on the connected device.

observe

open override fun observe(characteristic: BleCharacteristic): Flow<ByteArray>

Observes notifications/indications from the characteristic.

open override fun observe(characteristic: BleCharacteristic, onSubscription: suspend () -> Unit): Flow<ByteArray>

Observes notifications/indications from the characteristic with an onSubscription action that fires after notifications are enabled (CCCD written).

preferredWriteType

open override fun preferredWriteType(characteristic: BleCharacteristic): BleWriteType

Returns the preferred write type for the characteristic on this platform/device.

read

open suspend override fun read(characteristic: BleCharacteristic): ByteArray

Reads the characteristic value once.

toMeshtasticRadioProfile

fun BleService.toMeshtasticRadioProfile(): MeshtasticRadioProfile

Extension to convert a BleService to a MeshtasticRadioProfile.

write

open suspend override fun write(characteristic: BleCharacteristic, data: ByteArray, writeType: BleWriteType)

Writes a value to the characteristic using the requested BLE write type.