Helper for a re-occurring pattern where we need to suspend to wait for a result of an asynchronous call and during this wait no other call is allowed to be made.

Packet

class Packet( val payload: ByteArray, var sequenceNumber: UShort, var acknowledgeSequenceNumber: UShort? = null, var expirationTime: Instant = Instant.now())

Represents a data packet that carries the specified payload. It has the specified sequenceNumber and optionally acknowledges the specified acknowledgeSequenceNumber to the remote peer. The specified expirationTime indicates when the packet is due for (re)transmission.

ReliableDataTransferProtocolHandler

class ReliableDataTransferProtocolHandler( var maximumTransferUnitSizeInBytes: Int = BleConnectivityProtocolDefinitions.defaultMaximumTransferUnitSizeInBytes, windowSizeInNumberOfPackets: Int = 8, coroutineScope: CoroutineScope = MainScope())

Implements a reliable data transfer protocol based on automatic repeat requests (ARQ).

ReliableWindowBuffer

class ReliableWindowBuffer( coroutineScope: CoroutineScope, windowSize: Int = 16, resendTimeout: Duration = 10.toDuration(DurationUnit.SECONDS), initialSequenceNumber: UShort = 0.toUShort())

This implements an asynchronous transfer window buffer with automatic repeat request (ARQ) semantics.

SessionId

data class SessionId(val data: ByteArray)

Represents a session ID.

Functions

toCharacteristicId

fun UUID.toCharacteristicId(): CharacteristicId

Create a characteristic ID from a UUID.

toDescriptorId

fun UUID.toDescriptorId(): DescriptorId

Creates a descriptor ID from a UUID.

toDeviceId

fun String.toDeviceId(): DeviceId

Creates a device ID from a String.

toSessionId

fun ByteArray.toSessionId(): SessionId