| org.bluez.GattDescriptor(5) | مدیریت سیستم لینوکس | org.bluez.GattDescriptor(5) |
نام (NAME)
org.bluez.GattDescriptor - رابط کاربری D-Bus برای توصیفگر GATT در BlueZ
توضیحات (DESCRIPTION)
نمایش مشخصههای توصیفگر (descriptor attribute) محلی/سرور و دوردست/کلاینت در GATT از یک رابط سطحبالای یکسان در D-Bus استفاده میکنند.
اصطلاح محلی/سرور (Local/Server) به توصیفگرهای مبتنی بر GATT اشاره دارد که توسط یک افزونه (plugin) یا یک برنامه خارجی ارائه شدهاند.
اصطلاح دوردست/کلاینت (Remote/Client) به توصیفگرهای GATT اشاره دارد که توسط دستگاه مقابل (peer) ارائه شدهاند.
رابط (INTERFACE)
کلاینت (Client)
- سرویس (Service)
- org.bluez
- رابط (Interface)
- org.bluez.GattDescriptor1
- مسیر شیء (Object path)
- [variable prefix]/{hci0,hci1,...}/dev_{BDADDR}/service#/char#/descriptor#
- مورد استفاده توسط (Used by)
- bluetoothctl-gatt(1)
سرور (Server)
- سرویس (Service)
- نام یکتا (unique name)
- رابط (Interface)
- org.bluez.GattDescriptor1
- مسیر شیء (Object path)
- قابل تعریف به صورت آزاد (freely definable)
متدها (Methods)
array{byte} ReadValue(dict flags)
درخواستی برای خواندن مقدار توصیفگر ارسال میکند و در صورت موفقیتآمیز بودن عملیات، مقدار را برمیگرداند.
گزینههای ممکن:
- uint16 offset
- آفست شروع خواندن برحسب بایت.
- object device (server only)
- شیء دستگاه.
- string link
- نوع پیوند
(فقط سرور).
مقادیر ممکن:
- "BR/EDR"
- "LE"
خطاهای ممکن:
مثالها:
- bluetoothctl
- [gatt] > read [offset]
void WriteValue(array{byte} value, dict flags)
درخواستی برای نوشتن مقدار توصیفگر ارسال میکند.
فلگهای ممکن:
- uint16 offset
- آفست شروع نوشتن برحسب بایت.
- uint16 mtu
- مقدار MTU مبادلهشده (فقط سرور).
- object device
- مسیر دستگاه (فقط سرور).
- string link
- نوع پیوند
(فقط سرور).
مقادیر ممکن:
- "BR/EDR"
- "LE"
- boolean prepare-authorize
- در صورت آمادهسازی درخواست مجوز (prepare authorization request)، مقدار True است.
خطاهای ممکن:
مثالها:
- bluetoothctl
- [gatt] > write <data=xx ...> [offset] [type]
ویژگیها (Properties)
string UUID [read-only]
شناسه یکتای ۱۲۸ بیتی توصیفگر (UUID).
object Characteristic [read-only]
مسیر شیء مربوط به مشخصه GATT که توصیفگر به آن تعلق دارد.
array{byte} Value [read-only, optional]
مقدار کششده توصیفگر. این ویژگی فقط پس از یک درخواست موفق خواندن بهروزرسانی میشود که پس از آن سیگنال PropertiesChanged منتشر خواهد شد.
array{string} Flags [read-only]
نحوه استفاده از مقدار توصیفگر را تعیین میکند.
مقادیر ممکن:
- "read"
- "write"
- "encrypt-read"
- "encrypt-write"
- "encrypt-authenticated-read"
- "encrypt-authenticated-write"
- "secure-read" (Server Only)
- "secure-write" (Server Only)
- "authorize"
uint16 Handle [read-only] (Client Only)
هندل توصیفگر (Descriptor handle).
uint16 Handle [read-write, optional] (Server Only)
هندل توصیفگر. در صورت وجود در سرور، تلاش میشود تا از آن برای تخصیص در پایگاهداده استفاده شود که ممکن است ناموفق باشد؛ برای تخصیص خودکار باید از مقدار 0x0000 استفاده شود که باعث میشود پس از ثبت، هندلِ تخصیصیافته تنظیم گردد.
| اکتبر 2023 | BlueZ |