client-core/no.nordicsemi.kotlin.ble.client/ReliableWriteScope

ReliableWriteScope

A scope of reliable write operation.

Reliable Write procedure, also known as Queued Write, allows to write one or multiple characteristics and descriptors in a single transaction. Every write request is confirmed by the remote device by sending the received value back to the initiator. If the received value doesn't match the sent value, the transaction is aborted automatically and ValueDoesNotMatchException will be thrown.

See Bluetooth Core Specification 5.4, Vol 3, Part F, 3.4.6: Queued Writes.

Properties

maximumWriteValueLength

abstract val maximumWriteValueLength: Int

The maximum amount of data, in bytes, you can send to a characteristic in a single reliable write request.

Functions

writeReliably

abstract fun RemoteCharacteristic.writeReliably(data: ByteArray)

Writes the value of the characteristic reliably using WriteType.WITH_RESPONSE.

abstract fun RemoteDescriptor.writeReliably(data: ByteArray)

Writes the value of the descriptor reliably.