From 1f7a7c9dcadbec6c23d2bd9e946cd706e606e837 Mon Sep 17 00:00:00 2001 From: Luiz Augusto von Dentz Date: Tue, 28 Jan 2025 11:48:08 -0500 Subject: [PATCH] org.bluez.GattCharacteristic: Add confirmation support to AcquireNotify This adds confirmation support for AcquireNotify when indication procedure is used, also document the behavior of clients vs servers. --- doc/org.bluez.GattCharacteristic.rst | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/doc/org.bluez.GattCharacteristic.rst b/doc/org.bluez.GattCharacteristic.rst index 784445234..7b1b3fbb5 100644 --- a/doc/org.bluez.GattCharacteristic.rst +++ b/doc/org.bluez.GattCharacteristic.rst @@ -212,6 +212,11 @@ fd, uint16 AcquireNotify(dict options) [optional] To release the lock the client shall close the file descriptor, a HUP is generated in case the device is disconnected. + As a client if indication procedure is used the confirmation is + generated automatically once received, for a server if the file + descriptor is writable (POLLOUT) then upon receiving a confirmation from + the client one byte (0x01) is written to the file descriptor. + Note: the MTU can only be negotiated once and is symmetric therefore this method may be delayed in order to have the exchange MTU completed, because of that the file descriptor is closed during reconnections as -- 2.47.3