.\" Man page generated from reStructuredText .\" by the Docutils 0.23 manpage writer. . . .nr rst2man-indent-level 0 . .de1 rstReportMargin \\$1 \\n[an-margin] level \\n[rst2man-indent-level] level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] - \\n[rst2man-indent0] \\n[rst2man-indent1] \\n[rst2man-indent2] .. .de1 INDENT .\" .rstReportMargin pre: . RS \\$1 . nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin] . nr rst2man-indent-level +1 .\" .rstReportMargin post: .. .de UNINDENT . RE .\" indent \\n[an-margin] .\" old: \\n[rst2man-indent\\n[rst2man-indent-level]] .nr rst2man-indent-level -1 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. .TH "bluetoothctl-gatt" "1" "November 2022" "BlueZ" "Linux System Administration" .SH "نام (NAME)" bluetoothctl-gatt \- زیرمنوی ویژگی‌های عمومی (Generic Attribute Submenu) .SH "خلاصه دستور (SYNOPSIS)" .sp \fBbluetoothctl\fP [\-\-options] [gatt.commands] .sp این زیرمنو با خدمات (services)، مشخصه‌ها (characteristics) و توصیف‌گرهای (descriptors) مربوط به GATT با استفاده از رابط‌های \fBorg.bluez.GattService(5)\fP، \fBorg.bluez.GattCharacteristic(5)\fP، \fBorg.bluez.GattDescriptor(5)\fP و \fBorg.bluez.GattManager(5)\fP تعامل برقرار می‌کند. .SH "دستورهای ویژگی عمومی (Generic Attribute Commands)" .SS list\-attributes .sp ویژگی‌های دستگاه محلی یا دستگاه دوردست را فهرست می‌کند که شامل خدمات، مشخصه‌ها و دستگیره‌ها (handles) می‌شود. این دستور نمای کلی جامعی از ویژگی‌های بلوتوث موجود را فراهم می‌آورد که می‌توان بعداً با سایر دستورها با آن‌ها تعامل داشت. .INDENT 0.0 .TP .B کاربرد (Usage) \fB> list\-attributes [dev/local]\fP .TP .B [dev/local] نشانی MAC دستگاه، مسیر شیء، یا \(dqlocal\(dq برای فهرست کردن ویژگی‌های ثبت‌شده محلی (اختیاری؛ در صورت حذف، همه موارد فهرست می‌شوند) .TP .B مثال فهرست کردن ویژگی‌ها برای یک خدمت مشخص .nf \fB> list\-attributes /org/bluez/hci0/dev_00_11_22_33_44_55/service001a\fP .fi .sp .TP .B مثال فهرست کردن ویژگی‌ها برای یک مشخصه خاص .nf \fB> list\-attributes /org/bluez/hci0/dev_00_11_22_33_44_55/service001a/char001c\fP .fi .sp .TP .B مثال فهرست کردن ویژگی‌ها برای یک خدمت در دستگاهی دیگر .nf \fB> list\-attributes /org/bluez/hci0/dev_AA_BB_CC_DD_EE_FF/service0020\fP .fi .sp .TP .B مثال فهرست کردن تمام ویژگی‌های خدمت Generic Access .nf \fB> list\-attributes 0x1800\fP .fi .sp .TP .B مثال فهرست کردن تمام ویژگی‌های خدمت باتری (Battery Service) .nf \fB> list\-attributes 0x180F\fP .fi .sp .TP .B مثال فهرست کردن تمام ویژگی‌های مشخصه نام دستگاه (Device Name) .nf \fB> list\-attributes 0x2A00\fP .fi .sp .TP .B مثال فهرست کردن ویژگی‌ها با استفاده از شناسه یکتای کامل (UUID) .nf \fB> list\-attributes 00001801\-0000\-1000\-8000\-00805f9b34fb\fP .fi .sp .TP .B مثال فهرست کردن ویژگی‌ها برای UUID سفارشی یک خدمت .nf \fB> list\-attributes 12345678\-1234\-5678\-9abc\-123456789abc\fP .fi .sp .UNINDENT .SS select\-attribute .sp یک ویژگی خاص را روی دستگاه محلی یا دوردست برای عملیات بعدی انتخاب می‌کند. پیش از خواندن یا نوشتن روی یک ویژگی، باید آن را با این دستور انتخاب کنید. این کار زمینه کاری (context) را برای بسیاری از دستورهای دیگر (مانند read، write، notify و غیره) تعیین می‌کند و مشخص می‌سازد کدام ویژگی باید تحت تأثیر قرار گیرد. .INDENT 0.0 .TP .B کاربرد (Usage) \fB> select\-attribute [attribute/UUID]\fP .TP .B مسیر ویژگی GATT، شناسه یکتا (UUID)، یا \(dqlocal\(dq برای انتخاب از ویژگی‌های محلی .TP .B [attribute/UUID] مسیر ویژگی یا UUID اضافی هنگام استفاده از \(dqlocal\(dq (اختیاری) .TP .B مثال انتخاب یک مشخصه خاص .nf \fB> select\-attribute /org/bluez/hci0/dev_00_11_22_33_44_55/service001a/char001c\fP .fi .sp .TP .B مثال انتخاب یک توصیف‌گر خاص .nf \fB> select\-attribute /org/bluez/hci0/dev_00_11_22_33_44_55/service0020/char0022/desc0024\fP .fi .sp .TP .B مثال انتخاب خدمت در دستگاهی دیگر .nf \fB> select\-attribute /org/bluez/hci0/dev_AA_BB_CC_DD_EE_FF/service001a\fP .fi .sp .TP .B مثال انتخاب مشخصه نام دستگاه (Device Name) .nf \fB> select\-attribute 0x2A00\fP .fi .sp .TP .B مثال انتخاب مشخصه سطح باتری (Battery Level) .nf \fB> select\-attribute 0x2A19\fP .fi .sp .TP .B مثال انتخاب توصیف‌گر پیکربندی مشخصه کارخواه (CCCD) .nf \fB> select\-attribute 0x2902\fP .fi .sp .TP .B مثال انتخاب مشخصه دما با استفاده از UUID کامل .nf \fB> select\-attribute 00002a6e\-0000\-1000\-8000\-00805f9b34fb\fP .fi .sp .TP .B مثال انتخاب مشخصه سفارشی .nf \fB> select\-attribute 12345678\-1234\-5678\-9abc\-123456789abc\fP .fi .sp .UNINDENT .SS attribute\-info .sp اطلاعات تفصیلی درباره یک ویژگی را نمایش می‌دهد. اگر ویژگی یا UUID مشخص نشده باشد، اطلاعات ویژگی انتخاب‌شده فعلی را نمایش می‌دهد. این دستور برای درک ویژگی‌ها و قابلیت‌های یک خصیصه مفید است. .INDENT 0.0 .TP .B کاربرد (Usage) \fB> attribute\-info [attribute/UUID]\fP .TP .B [attribute/UUID] مسیر ویژگی GATT یا UUID برای دریافت اطلاعات آن (اختیاری؛ در صورت حذف، مورد فعلی استفاده می‌شود) .TP .B مثال نمایش اطلاعات ویژگی انتخاب‌شده فعلی .nf \fB> attribute\-info\fP .fi .sp .TP .B مثال نمایش اطلاعات مشخصه خاص .nf \fB> attribute\-info /org/bluez/hci0/dev_00_11_22_33_44_55/service001a/char001c\fP .fi .sp .TP .B مثال نمایش اطلاعات مشخصه سطح باتری .nf \fB> attribute\-info 0x2A19\fP .fi .sp .TP .B مثال نمایش اطلاعات مشخصه نام دستگاه .nf \fB> attribute\-info 0x2A00\fP .fi .sp .TP .B مثال نمایش اطلاعات مشخصه دما .nf \fB> attribute\-info 00002a6e\-0000\-1000\-8000\-00805f9b34fb\fP .fi .sp .UNINDENT .SS read .sp مقدار یک ویژگی را می‌خواند. نیازمند آن است که پیش‌تر یک ویژگی با select\-attribute انتخاب شده باشد. پارامتر اختیاری offset می‌تواند برای ویژگی‌هایی که اجازه خواندن جزئی را می‌دهند استفاده شود. .INDENT 0.0 .TP .B کاربرد (Usage) \fB> read [offset]\fP .TP .B استفاده‌ها (Uses) متد \fBReadValue\fP از رابط \fBorg.bluez.GattCharacteristic(5)\fP .TP .B [offset] انحراف بایتی برای شروع خواندن (اختیاری؛ پیش‌فرض 0 است) .TP .B مثال خواندن مقدار ویژگی از انحراف ۰ .nf \fB> read\fP .fi .sp .TP .B مثال خواندن مقدار ویژگی از انحراف ۰ (صریح) .nf \fB> read 0\fP .fi .sp .TP .B مثال خواندن مقدار ویژگی با شروع از انحراف ۴ .nf \fB> read 4\fP .fi .sp .TP .B مثال خواندن مقدار ویژگی با شروع از انحراف ۱۰ .nf \fB> read 10\fP .fi .sp .TP .B مثال خواندن مقدار ویژگی با شروع از انحراف ۱۶ .nf \fB> read 16\fP .fi .sp .UNINDENT .SS write .sp مقداری را در یک ویژگی می‌نویسد. این دستور ایجاب می‌کند که یک ویژگی از قبل با استفاده از select\-attribute انتخاب شده باشد. داده‌ها باید در قالب هگزادسیمال (شانزده‌شانزدهی) ارائه شوند. پارامترهای اختیاری offset و type می‌توانند نیازهای خاص نوشتن را برآورده کنند. .INDENT 0.0 .TP .B کاربرد (Usage) \fB> write [offset] [type]\fP .TP .B استفاده‌ها (Uses) متد \fBWriteValue\fP از رابط \fBorg.bluez.GattCharacteristic(5)\fP .TP .B بایت‌های داده در قالب هگزادسیمال برای نوشتن در ویژگی .TP .B [offset] انحراف بایتی برای شروع نوشتن (اختیاری؛ پیش‌فرض 0 است) .TP .B [type] نوع نوشتن \- request، command یا reliable (اختیاری؛ پیش‌فرض request است) .TP .B مثال نوشتن \(dqHello\(dq در ویژگی (بایت‌های اسکی) .nf \fB> write \(dq48 65 6C 6C 6F\(dq\fP .fi .sp .TP .B مثال نوشتن داده‌های باینری در ویژگی .nf \fB> write \(dq01 02 03 04\(dq\fP .fi .sp .TP .B مثال نوشتن مقدار تک‌بایتی .nf \fB> write \(dqFF\(dq\fP .fi .sp .TP .B مثال نوشتن ۲ بایت با شروع از انحراف ۴ .nf \fB> write \(dq01 02\(dq 4\fP .fi .sp .TP .B مثال نوشتن با درخواست نوشتن (پیش‌فرض) .nf \fB> write \(dq48 65 6C 6C 6F\(dq 0 request\fP .fi .sp .TP .B مثال نوشتن با دستور نوشتن (بدون پاسخ) .nf \fB> write \(dq01 02 03\(dq 0 command\fP .fi .sp .TP .B مثال نوشتن با نوشتن قابل‌اطمینان (reliable) .nf \fB> write \(dqFF EE DD\(dq 0 reliable\fP .fi .sp .UNINDENT .SS acquire\-write .sp یک توصیف‌گر پرونده نوشتن (Write file descriptor) برای ویژگی از پیش انتخاب‌شده دریافت می‌کند. این کار برای برنامه‌هایی مفید است که برای انجام عملیات نوشتن به یک توصیف‌گر پرونده نیاز دارند. .INDENT 0.0 .TP .B کاربرد (Usage) \fB> acquire\-write\fP .TP .B استفاده‌ها (Uses) متد \fBAcquireWrite\fP از رابط \fBorg.bluez.GattCharacteristic(5)\fP .TP .B مثال دریافت توصیف‌گر پرونده نوشتن برای ویژگی فعلی .nf \fB> acquire\-write\fP .fi .sp .UNINDENT .SS release\-write .sp توصیف‌گر پرونده نوشتن را که با acquire\-write به دست آمده بود، آزاد می‌کند. این دستور برای پاک‌سازی منابع پس از پایان عملیات نوشتن ضروری است. .INDENT 0.0 .TP .B کاربرد (Usage) \fB> release\-write\fP .TP .B مثال آزادسازی توصیف‌گر پرونده نوشتن برای ویژگی فعلی .nf \fB> release\-write\fP .fi .sp .UNINDENT .SS acquire\-notify .sp یک توصیف‌گر پرونده اعلان (Notify file descriptor) برای ویژگی از پیش انتخاب‌شده به دست می‌آورد. این امکان را به برنامه‌ها می‌دهد تا برای آگاهی از تغییرات مقدار ویژگی گوش به زنگ باشند. .INDENT 0.0 .TP .B کاربرد (Usage) \fB> acquire\-notify\fP .TP .B استفاده‌ها (Uses) متد \fBAcquireNotify\fP از رابط \fBorg.bluez.GattCharacteristic(5)\fP .TP .B مثال دریافت توصیف‌گر پرونده اعلان برای ویژگی فعلی .nf \fB> acquire\-notify\fP .fi .sp .UNINDENT .SS release\-notify .sp توصیف‌گر پرونده اعلانی را که با acquire\-notify به دست آمده بود، آزاد می‌کند. این تضمین می‌کند که به محض عدم نیاز به گوش دادن به اعلان‌ها، منابع آزاد شوند. .INDENT 0.0 .TP .B کاربرد (Usage) \fB> release\-notify\fP .TP .B مثال آزادسازی توصیف‌گر پرونده اعلان برای ویژگی فعلی .nf \fB> release\-notify\fP .fi .sp .UNINDENT .SS notify .sp اعلان‌ها را برای تغییرات مقدار ویژگی فعال یا غیرفعال می‌کند. پیش از استفاده از این دستور، ویژگی مربوطه باید انتخاب شده باشد. این دستور به برنامه‌ها اجازه می‌دهد بدون نیاز به نظرسنجی مداوم (polling)، از تغییرات ویژگی مطلع شوند. .INDENT 0.0 .TP .B کاربرد (Usage) \fB> notify \fP .TP .B استفاده‌ها (Uses) متدهای \fBStartNotify\fP و \fBStopNotify\fP از رابط \fBorg.bluez.GattCharacteristic(5)\fP .TP .B فعال‌سازی یا غیرفعال‌سازی اعلان‌ها برای ویژگی فعلی .TP .B مثال فعال‌سازی اعلان‌ها برای ویژگی فعلی .nf \fB> notify on\fP .fi .sp .TP .B مثال غیرفعال‌سازی اعلان‌ها برای ویژگی فعلی .nf \fB> notify off\fP .fi .sp .UNINDENT .SS clone .sp یک همتاسازی (کلون) از یک دستگاه یا ویژگی ایجاد می‌کند. این کار می‌تواند برای ایجاد نسخه پشتیبان یا کار با یک کپی به منظور آزمایش مفید باشد. .INDENT 0.0 .TP .B کاربرد (Usage) \fB> clone [dev/attribute/UUID]\fP .TP .B [dev/attribute/UUID] نشانی MAC دستگاه، مسیر ویژگی، یا UUID برای کلون کردن (اختیاری؛ در صورت حذف، مورد فعلی کلون می‌شود) .TP .B مثال همتاسازی کل پایگاه داده GATT دستگاه .nf \fB> clone 00:11:22:33:44:55\fP .fi .sp .TP .B مثال همتاسازی دستگاهی دیگر .nf \fB> clone AA:BB:CC:DD:EE:FF\fP .fi .sp .TP .B مثال همتاسازی یک خدمت مشخص .nf \fB> clone /org/bluez/hci0/dev_00_11_22_33_44_55/service001a\fP .fi .sp .TP .B مثال همتاسازی یک مشخصه خاص .nf \fB> clone /org/bluez/hci0/dev_00_11_22_33_44_55/service001a/char001c\fP .fi .sp .TP .B مثال همتاسازی خدمت Generic Access .nf \fB> clone 0x1800\fP .fi .sp .TP .B مثال همتاسازی خدمت باتری .nf \fB> clone 0x180F\fP .fi .sp .TP .B مثال همتاسازی مشخصه سطح باتری .nf \fB> clone 0x2A19\fP .fi .sp .UNINDENT .SS register\-application .sp یک برنامه جدید را در سیستم بلوتوث ثبت می‌کند که امکان مدیریت خدمات، مشخصه‌ها و توصیف‌گرها را ذیل این برنامه فراهم می‌آورد. .INDENT 0.0 .TP .B کاربرد (Usage) \fB> register\-application [UUID ...]\fP .TP .B استفاده‌ها (Uses) متد \fBRegisterApplication\fP از رابط \fBorg.bluez.GattManager(5)\fP .TP .B [UUID ...] فهرست اختیاری از UUIDهای خدمت برای ثبت به همراه برنامه .TP .B مثال ثبت برنامه GATT بدون UUIDهای مشخص .nf \fB> register\-application\fP .fi .sp .TP .B مثال ثبت برنامه با خدمت باتری .nf \fB> register\-application 0x180F\fP .fi .sp .TP .B مثال ثبت به همراه خدمت‌های Generic Access و باتری .nf \fB> register\-application 0x1800 0x180F\fP .fi .sp .TP .B مثال ثبت برنامه با UUID سفارشی خدمت .nf \fB> register\-application 12345678\-1234\-5678\-9abc\-123456789abc\fP .fi .sp .TP .B مثال ثبت با چند خدمت استاندارد .nf \fB> register\-application 0x1800 0x180F 0x180A\fP .fi .sp .UNINDENT .SS unregister\-application .sp برنامه‌ای را که پیش‌تر ثبت شده است از سامانه بلوتوث حذف می‌کند. .INDENT 0.0 .TP .B کاربرد (Usage) \fB> unregister\-application\fP .TP .B استفاده‌ها (Uses) متد \fBUnregisterApplication\fP از رابط \fBorg.bluez.GattManager(5)\fP .TP .B مثال لغو ثبت برنامه GATT فعلی .nf \fB> unregister\-application\fP .fi .sp .UNINDENT .SS register\-service .sp یک خدمت جدید را ذیل یک برنامه ثبت‌شده اضافه می‌کند. این دستور برای تعریف خدمات جدیدی که دستگاه‌ها می‌توانند ارائه دهند بسیار حیاتی است. .INDENT 0.0 .TP .B کاربرد (Usage) \fB> register\-service [handle]\fP .TP .B شناسه یکتای (UUID) خدمت برای ثبت (در قالب‌های ۱۶ بیتی، ۳۲ بیتی یا ۱۲۸ بیتی) .TP .B [handle] دستگیره خصیصه مشخص برای انتساب (اختیاری؛ در صورت حذف به طور خودکار منتسب می‌شود) .TP .B مثال ثبت خدمت Generic Access (دستگیره خودکار) .nf \fB> register\-service 0x1800\fP .fi .sp .TP .B مثال ثبت خدمت باتری (دستگیره خودکار) .nf \fB> register\-service 0x180F\fP .fi .sp .TP .B مثال ثبت خدمت اطلاعات دستگاه (دستگیره خودکار) .nf \fB> register\-service 0x180A\fP .fi .sp .TP .B مثال ثبت خدمت Generic Access روی دستگیره ۱ .nf \fB> register\-service 0x1800 0x0001\fP .fi .sp .TP .B مثال ثبت خدمت باتری روی دستگیره ۱۶ .nf \fB> register\-service 0x180F 0x0010\fP .fi .sp .TP .B مثال ثبت خدمت اطلاعات دستگاه روی دستگیره ۳۲ .nf \fB> register\-service 0x180A 0x0020\fP .fi .sp .TP .B مثال ثبت خدمت سفارشی (دستگیره خودکار) .nf \fB> register\-service 12345678\-1234\-5678\-9abc\-123456789abc\fP .fi .sp .TP .B مثال ثبت خدمت سفارشی روی دستگیره مشخص .nf \fB> register\-service 12345678\-1234\-5678\-9abc\-123456789abc 0x0050\fP .fi .sp .UNINDENT .SS unregister\-service .sp یک خدمت را از برنامه ثبت‌شده حذف می‌کند و در نتیجه دسترسی به آن متوقف می‌شود. .INDENT 0.0 .TP .B کاربرد (Usage) \fB> unregister\-service \fP .TP .B شناسه یکتای خدمت یا مسیر شیء مربوط به خدمتی که باید لغو ثبت شود .TP .B مثال لغو ثبت خدمت Generic Access .nf \fB> unregister\-service 0x1800\fP .fi .sp .TP .B مثال لغو ثبت خدمت باتری .nf \fB> unregister\-service 0x180F\fP .fi .sp .TP .B مثال لغو ثبت خدمت سفارشی .nf \fB> unregister\-service 12345678\-1234\-5678\-9abc\-123456789abc\fP .fi .sp .TP .B مثال لغو ثبت خدمت از طریق مسیر شیء .nf \fB> unregister\-service /org/bluez/example/service0\fP .fi .sp .TP .B مثال لغو ثبت خدمتی دیگر .nf \fB> unregister\-service /org/bluez/example/service1\fP .fi .sp .UNINDENT .SS register\-includes .sp یک خدمت را به عنوان گنجانده‌شده (included) درون خدمتی دیگر علامت‌گذاری می‌کند که این امر ساختارهای سلسله‌مراتبی و پیچیده خدمات را امکان‌پذیر می‌سازد. .INDENT 0.0 .TP .B کاربرد (Usage) \fB> register\-includes [handle]\fP .TP .B شناسه یکتای خدمت برای ثبت به عنوان خدمت گنجانده‌شده .TP .B [handle] دستگیره خصیصه مشخص برای انتساب (اختیاری؛ در صورت حذف به طور خودکار منتسب می‌شود) .TP .B مثال ثبت Generic Access به عنوان خدمت گنجانده‌شده .nf \fB> register\-includes 0x1800\fP .fi .sp .TP .B مثال ثبت خدمت باتری به عنوان گنجانده‌شده روی دستگیره ۲۱ .nf \fB> register\-includes 0x180F 0x0015\fP .fi .sp .TP .B مثال ثبت خدمت سفارشی به عنوان گنجانده‌شده .nf \fB> register\-includes 12345678\-1234\-5678\-9abc\-123456789abc\fP .fi .sp .UNINDENT .SS unregister\-includes .sp رابطه خدمت گنجانده‌شده را حذف می‌کند و ساختار خدمت را ساده می‌سازد. .INDENT 0.0 .TP .B کاربرد (Usage) \fB> unregister\-includes \fP .TP .B شناسه یکتای خدمت والد که شامل خدمت گنجانده‌شده است .TP .B شناسه یکتای خدمت گنجانده‌شده برای حذف از خدمت والد .TP .B مثال لغو گنجاندن خدمت باتری از Generic Access .nf \fB> unregister\-includes 0x1800 0x180F\fP .fi .sp .TP .B مثال لغو گنجاندن اطلاعات دستگاه از خدمت سفارشی .nf \fB> unregister\-includes 12345678\-1234\-5678\-9abc\-123456789abc 0x180A\fP .fi .sp .UNINDENT .SS register\-characteristic .sp یک مشخصه جدید را ذیل یک خدمت معرفی می‌کند و خصیصه‌ها و مجوزهای دسترسی آن را با پرچم‌ها مشخص می‌سازد. .INDENT 0.0 .TP .B کاربرد (Usage) \fB> register\-characteristic [handle]\fP .TP .B شناسه یکتای مشخصه برای ثبت (در قالب‌های ۱۶ بیتی، ۳۲ بیتی یا ۱۲۸ بیتی) .TP .B فهرست جداشده با ویرگول از خصیصه‌ها و مجوزهای مشخصه .TP .B [handle] دستگیره خصیصه مشخص برای انتساب (اختیاری؛ در صورت حذف به طور خودکار منتسب می‌شود) .TP .B مثال ثبت نام دستگاه (فقط‌خواندنی) .nf \fB> register\-characteristic 0x2A00 read\fP .fi .sp .TP .B مثال ثبت سطح باتری (خواندن + اعلان‌ها) .nf \fB> register\-characteristic 0x2A19 read,notify\fP .fi .sp .TP .B مثال ثبت سنجش ضربان قلب (فقط اعلان) .nf \fB> register\-characteristic 0x2A37 notify\fP .fi .sp .TP .B مثال ثبت نام دستگاه (خواندن + نوشتن) .nf \fB> register\-characteristic 0x2A00 read,write\fP .fi .sp .TP .B مثال ثبت سطح باتری (خواندن + نوشتن + اعلان) .nf \fB> register\-characteristic 0x2A19 read,write,notify\fP .fi .sp .TP .B مثال ثبت دما (خواندن + نشانه‌ها/indications) .nf \fB> register\-characteristic 0x2A6E read,indicate\fP .fi .sp .TP .B مثال ثبت نام دستگاه روی دستگیره ۳ .nf \fB> register\-characteristic 0x2A00 read 0x0003\fP .fi .sp .TP .B مثال ثبت سطح باتری روی دستگیره ۱۹ .nf \fB> register\-characteristic 0x2A19 read,notify 0x0013\fP .fi .sp .TP .B مثال ثبت مشخصه سفارشی با قابلیت‌های کامل .nf \fB> register\-characteristic 12345678\-1234\-5678\-9abc\-123456789abc read,write,notify\fP .fi .sp .TP .B مثال ثبت مشخصه سفارشی فقط‌نوشتنی .nf \fB> register\-characteristic ABCD1234\-ABCD\-1234\-ABCD\-123456789ABC write\-without\-response\fP .fi .sp .TP .B مثال ثبت با تمام پرچم‌ها .nf \fB> register\-characteristic 0x2A00 read,write,write\-without\-response,notify,indicate\fP .fi .sp .UNINDENT .SS unregister\-characteristic .sp یک مشخصه را از یک خدمت حذف می‌کند و کارکرد آن را برمی‌دارد. .INDENT 0.0 .TP .B کاربرد (Usage) \fB> unregister\-characteristic \fP .TP .B شناسه یکتای مشخصه یا مسیر شیء مربوط به مشخصه‌ای که باید لغو ثبت شود .TP .B مثال لغو ثبت مشخصه نام دستگاه .nf \fB> unregister\-characteristic 0x2A00\fP .fi .sp .TP .B مثال لغو ثبت مشخصه سطح باتری .nf \fB> unregister\-characteristic 0x2A19\fP .fi .sp .TP .B مثال لغو ثبت مشخصه سفارشی .nf \fB> unregister\-characteristic 12345678\-1234\-5678\-9abc\-123456789abc\fP .fi .sp .TP .B مثال لغو ثبت مشخصه از طریق مسیر شیء .nf \fB> unregister\-characteristic /org/bluez/example/service0/char0\fP .fi .sp .TP .B مثال لغو ثبت مشخصه‌ای دیگر .nf \fB> unregister\-characteristic /org/bluez/example/service1/char1\fP .fi .sp .UNINDENT .SS register\-descriptor .sp یک توصیف‌گر به مشخصه اضافه می‌کند که رفتار و کنترل‌های دسترسی آن را دقیق‌تر تعریف می‌نماید. .INDENT 0.0 .TP .B کاربرد (Usage) \fB> register\-descriptor [handle]\fP .TP .B شناسه یکتای توصیف‌گر برای ثبت (در قالب‌های ۱۶ بیتی، ۳۲ بیتی یا ۱۲۸ بیتی) .TP .B فهرست جداشده با ویرگول از خصیصه‌ها و مجوزهای توصیف‌گر .TP .B [handle] دستگیره خصیصه مشخص برای انتساب (اختیاری؛ در صورت حذف به طور خودکار منتسب می‌شود) .TP .B مثال ثبت پیکربندی مشخصه کارخواه (CCCD) .nf \fB> register\-descriptor 0x2902 read,write\fP .fi .sp .TP .B مثال ثبت توضیحات کاربر مشخصه .nf \fB> register\-descriptor 0x2901 read\fP .fi .sp .TP .B مثال ثبت قالب ارائه مشخصه .nf \fB> register\-descriptor 0x2904 read\fP .fi .sp .TP .B مثال ثبت CCCD روی دستگیره ۵ .nf \fB> register\-descriptor 0x2902 read,write 0x0005\fP .fi .sp .TP .B مثال ثبت توضیحات کاربر روی دستگیره ۲۱ .nf \fB> register\-descriptor 0x2901 read 0x0015\fP .fi .sp .TP .B مثال ثبت توصیف‌گر سفارشی .nf \fB> register\-descriptor 12345678\-1234\-5678\-9abc\-123456789abc read,write\fP .fi .sp .TP .B مثال ثبت توصیف‌گر سفارشی فقط‌خواندنی .nf \fB> register\-descriptor ABCD1234\-ABCD\-1234\-ABCD\-123456789ABC read\fP .fi .sp .TP .B مثال ثبت توصیف‌گر محدوده معتبر .nf \fB> register\-descriptor 0x2906 read\fP .fi .sp .TP .B مثال ثبت ارجاع گزارش خارجی .nf \fB> register\-descriptor 0x2907 read\fP .fi .sp .TP .B مثال ثبت ارجاع گزارش .nf \fB> register\-descriptor 0x2908 read\fP .fi .sp .UNINDENT .SS unregister\-descriptor .sp یک توصیف‌گر را از یک مشخصه حذف می‌کند و رفتار آن را ساده می‌سازد. .INDENT 0.0 .TP .B کاربرد (Usage) \fB> unregister\-descriptor \fP .TP .B شناسه یکتای توصیف‌گر یا مسیر شیء مربوط به توصیف‌گری که باید لغو ثبت شود .TP .B مثال لغو ثبت پیکربندی مشخصه کارخواه (CCCD) .nf \fB> unregister\-descriptor 0x2902\fP .fi .sp .TP .B مثال لغو ثبت توضیحات کاربر مشخصه .nf \fB> unregister\-descriptor 0x2901\fP .fi .sp .TP .B مثال لغو ثبت توصیف‌گر سفارشی .nf \fB> unregister\-descriptor 12345678\-1234\-5678\-9abc\-123456789abc\fP .fi .sp .TP .B مثال لغو ثبت توصیف‌گر از طریق مسیر شیء .nf \fB> unregister\-descriptor /org/bluez/example/service0/char0/desc0\fP .fi .sp .TP .B مثال لغو ثبت توصیف‌گری دیگر .nf \fB> unregister\-descriptor /org/bluez/example/service1/char1/desc1\fP .fi .sp .UNINDENT .SH "منابع (RESOURCES)" .sp \% .SH "گزارش باگ‌ها (REPORTING BUGS)" .sp \% .SH "حق نشر (COPYRIGHT)" استفاده رایگان از این نرم‌افزار تحت شرایط پروانه عمومی همگانی کاهش‌یافته گنو (LGPL) اعطا می‌شود. .\" End of generated man page.