diff options
author | Luiz Augusto von Dentz <luiz.von.dentz@intel.com> | 2017-06-30 13:19:17 +0300 |
---|---|---|
committer | Luiz Augusto von Dentz <luiz.von.dentz@intel.com> | 2017-07-04 12:29:57 +0300 |
commit | f59f3dedb2c79a75e51a3a0d27e2ae06fefc603e (patch) | |
tree | acf29885a5adfe7bc0bc3bfb61d88ff185070241 /doc/gatt-api.txt | |
parent | 44bf4d2dba7dc59c4ce34c46a3ee450ebda1653b (diff) | |
download | bluez-f59f3dedb2c79a75e51a3a0d27e2ae06fefc603e.tar.gz |
doc/gatt-api: Add AcquireWrite and AcquireNotify
This enables write and notify exclusive access via file descriptors in
case the characteristic is actually trying to emulate a byte stream
transfer or have a protocol on top of GATT.
Diffstat (limited to 'doc/gatt-api.txt')
-rw-r--r-- | doc/gatt-api.txt | 62 |
1 files changed, 62 insertions, 0 deletions
diff --git a/doc/gatt-api.txt b/doc/gatt-api.txt index 6c98b8713..3f4a3ca3f 100644 --- a/doc/gatt-api.txt +++ b/doc/gatt-api.txt @@ -91,6 +91,56 @@ Methods array{byte} ReadValue(dict options) org.bluez.Error.NotAuthorized org.bluez.Error.NotSupported + fd, uint16 AcquireWrite() [experimental] (Client only) + + Acquire write file descriptor and MTU and lock + write access to the characteristic. + + Only works with characteristic that has + WriteAcquired property which relies on + write-without-response Flag. + + To release the lock the client shall close the file + descriptor, a HUP is generated in case the device + is disconnected. + + 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 the MTU has to be renegotiated. + + Possible Errors: org.bluez.Error.Failed + org.bluez.Error.NotSupported + + fd, uint16 AcquireNotify() [experimental] (Client only) + + Acquire notify file descriptor and MTU and lock + notifications to the characteristic. + + Only works with characteristic that has NotifyAcquired + which relies on notify Flag and no other client have + called StartNotify. + + Notification are enabled during this procedure so + StartNotify shall not be called, any notification + will be dispatched via file descriptor therefore the + Value property is no affected during the time where + notify has been acquired. + + To release the lock the client shall close the file + descriptor, a HUP is generated in case the device + is disconnected. + + 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 the MTU has to be renegotiated. + + Possible Errors: org.bluez.Error.Failed + org.bluez.Error.NotSupported + void StartNotify() Starts a notification session from this characteristic @@ -125,6 +175,18 @@ Properties string UUID [read-only] when a notification or indication is received, upon which a PropertiesChanged signal will be emitted. + boolean WriteAcquired [read-only, optional] + + True, if this characteristic has been acquire by any + client using AcquireWrite. This properties is ommited + in case write-without-response flag is not set. + + boolean NotifyAcquired [read-only, optional] + + True, if this characteristic has been acquire by any + client using AcquireNotify. This properties is ommited + in case notify flag is not set. + boolean Notifying [read-only, optional] True, if notifications or indications on this |