.\" 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 "org.bluez.Adapter" "5" "October 2023" "BlueZ" "Linux System Administration" .SH "نام (NAME)" org.bluez.Adapter \- مستندات واسط D-Bus آداپتور BlueZ .SH "واسط (INTERFACE)" .INDENT 0.0 .TP .B سرویس (Service) org.bluez .TP .B واسط (Interface) org.bluez.Adapter1 .TP .B مسیر شیء (Object path) [variable prefix]/{hci0,hci1,...} .TP .B مورد استفاده توسط (Used by) \fBbluetoothctl(1)\fP, \fBbluetoothctl\-scan(1)\fP .UNINDENT .SS "متدها (Methods)" .SS void StartDiscovery() .sp نشست شناسایی دستگاه (device discovery session) را آغاز می‌کند که ممکن است شامل آغاز فرایندهای پرس‌وجو (inquiry) و/یا اسکن و حل نام دستگاه راه دور باشد. .sp برای آزادسازی نشست‌های دریافت‌شده از \fBStopDiscovery\fP استفاده کنید. .sp این فرایند هم‌زمان با شناسایی دستگاه‌های جدید، شروع به ایجاد اشیاء Device خواهد کرد. .sp در طول شناسایی، آستانه تغییرات RSSI (delta\-threshold) اعمال می‌شود. .sp هر کلاینت می‌تواند به ازای هر آداپتور تنها یک نشست شناسایی دستگاه درخواست کند. .sp خطاهای ممکن: .INDENT 0.0 .TP .B org.bluez.Error.NotReady .TP .B org.bluez.Error.Failed .TP .B org.bluez.Error.InProgress .UNINDENT .sp مثال‌ها: .INDENT 0.0 .TP .B bluetoothctl > scan .UNINDENT .SS void StopDiscovery() .sp نشست شناسایی دستگاه را که توسط \fBStartDiscovery\fP آغاز شده متوقف می‌کند. .sp توجه داشته باشید که فرایند شناسایی میان تمام نشست‌های شناسایی به اشتراک گذاشته می‌شود؛ بنابراین فراخوانی StopDiscovery تنها یک نشست را آزاد می‌کند و شناسایی زمانی متوقف می‌شود که تمام نشست‌های مربوط به همه کلاینت‌ها پایان یافته باشند. .sp خطاهای ممکن: .INDENT 0.0 .TP .B org.bluez.Error.NotReady .TP .B org.bluez.Error.Failed .TP .B org.bluez.Error.NotAuthorized .UNINDENT .SS void RemoveDevice(object device) .sp شیء دستگاه راه دور را در مسیر داده‌شده به همراه اطلاعات کش‌شده (مانند اطلاعات پیوند/bonding) حذف می‌کند. .sp خطاهای ممکن: .INDENT 0.0 .TP .B org.bluez.Error.InvalidArguments .TP .B org.bluez.Error.Failed .UNINDENT .sp مثال‌ها: .INDENT 0.0 .TP .B bluetoothctl > remove .UNINDENT .SS void SetDiscoveryFilter(dict filter) .sp فیلتر شناسایی دستگاه را برای فراخواننده تنظیم می‌کند. هنگامی که این متد بدون پارامتر فیلتر فراخوانی شود، فیلتر حذف می‌شود. .sp مقادیر ممکن برای فیلتر: .INDENT 0.0 .TP .B array{string} UUIDs فیلتر بر اساس UUIDهای سرویس؛ مقدار خالی به معنای تطابق با \fIهر\fP UUID است. .sp هنگامی که دستگاه راه دور یافت شود که هر یک از UUIDهای موجود در فهرست UUIDها را تبلیغ (advertise) کند، تحت شرایط زیر گزارش خواهد شد: .INDENT 7.0 .IP \(bu 2 هر دو پارامتر \fBPathloss\fP و \fBRSSI\fP خالی باشند. .IP \(bu 2 فقط پارامتر \fBPathloss\fP تنظیم شده باشد، دستگاه توان ارسال (TX power) را تبلیغ کند، و افت مسیر محاسبه‌شده کمتر از پارامتر Pathloss باشد. .IP \(bu 2 فقط پارامتر \fBRSSI\fP تنظیم شده باشد، و RSSI دریافت‌شده بیشتر از پارامتر RSSI باشد. .UNINDENT .TP .B int16 RSSI مقدار آستانه RSSI. .sp سیگنال‌های PropertiesChanged برای اشیاء موجود Device با مقدار به‌روزشده RSSI ارسال خواهند شد. اگر یک یا چند فیلتر شناسایی تنظیم شده باشد، آستانه تغییرات RSSI (delta\-threshold) که به‌طور پیش‌فرض توسط StartDiscovery اعمال می‌شود، اعمال نخواهد شد. .TP .B uint16 Pathloss مقدار آستانه افت مسیر (Pathloss). .sp سیگنال‌های PropertiesChanged برای اشیاء موجود Device با مقدار به‌روزشده Pathloss ارسال خواهند شد. .TP .B string Transport (Default \(dqauto\(dq) پارامتر Transport نوع اسکن را تعیین می‌کند. .sp مقادیر ممکن: .INDENT 7.0 .TP .B \(dqauto\(dq اسکن درهم‌تنیده (Interleaved)، استفاده از LE، BREDR، یا هر دو، بسته به آنچه هم‌اکنون فعال است. .TP .B \(dqbredr\(dq فقط پرس‌وجوی BR/EDR (inquiry). .TP .B \(dqle\(dq فقط اسکن LE. .UNINDENT .TP .B bool DuplicateData (Default false) تشخیص داده‌های تکراری تبلیغات را غیرفعال می‌کند. .sp در صورت فعال بودن، هر بار که ManufacturerData و ServiceData کشف شوند، سیگنال‌های PropertiesChanged برای آن‌ها ایجاد خواهد شد. .TP .B bool Discoverable (Default false) آداپتور را در حین شناسایی قابل کشف (discoverable) می‌کند؛ اگر آداپتور از قبل قابل کشف باشد، تنظیم این فیلتر تاثیری نخواهد داشت. .TP .B string Pattern (Default none) دستگاه‌هایی را کشف می‌کند که الگوی مشخص‌شده با پیشوند آدرس یا نام دستگاه مطابقت داشته باشد؛ این روشی مناسب برای محدود کردن تعداد اشیاء دستگاه ایجادشده در طول یک شناسایی است. .sp در صورت تنظیم، پرچم‌های قابلیت کشف دستگاه نادیده گرفته می‌شوند. .sp توجه: تطبیق الگو در صورتی که کلاینت‌های دیگری وجود داشته باشند که هیچ الگویی تنظیم نکرده باشند نادیده گرفته می‌شود زیرا عملکردی شبیه به OR منطقی دارد؛ همچنین تنظیم رشته خالی \(dq\(dq به عنوان الگو با هر دستگاه یافت‌شده‌ای مطابقت خواهد داشت. .TP .B bool AutoConnect (Default false) در صورتی که الگو (Pattern) تنظیم شده باشد و با آدرس یا نام دستگاه مطابقت داشته باشد و دستگاه قابلیت اتصال داشته باشد، به طور خودکار به دستگاه‌های کشف‌شده متصل می‌شود. .UNINDENT .sp هنگامی که فیلتر شناسایی تنظیم شود، اشیاء Device با کشف دستگاه‌های جدید دارای معیارهای منطبق ایجاد خواهند شد، صرف‌نظر از اینکه آن‌ها قابل اتصال یا قابل کشف باشند؛ این امر امکان شنود دستگاه‌های غیرقابل اتصال و غیرقابل کشف را فراهم می‌کند. .sp هنگامی که چند کلاینت SetDiscoveryFilter را فراخوانی کنند، فیلترهای آن‌ها در داخل ترکیب شده و اعلان‌های مربوط به دستگاه‌های جدید برای تمام کلاینت‌ها ارسال می‌شود. بنابراین، هر کلاینت باید بررسی کند که به‌روزرسانی‌های دستگاه واقعاً با فیلتر آن مطابقت دارد. .sp هنگامی که SetDiscoveryFilter چندین بار توسط یک کلاینت فراخوانی شود، آخرین فیلتر ارائه‌شده برای آن کلاینت فعال خواهد بود. .sp متد SetDiscoveryFilter می‌تواند پیش از StartDiscovery فراخوانی شود. این متد زمانی مفید است که کلاینت نخستین نشست شناسایی را ایجاد می‌کند تا اطمینان حاصل شود که اسکن مناسب بلافاصله پس از فراخوانی StartDiscovery آغاز می‌گردد. .sp خطاهای ممکن: .INDENT 0.0 .TP .B org.bluez.Error.NotReady .TP .B org.bluez.Error.NotSupported .TP .B org.bluez.Error.Failed .UNINDENT .sp مثال‌ها: .INDENT 0.0 .TP .B bluetoothctl [scan] > uuids [all/uuid1 uuid2 ...] .TP .B bluetoothctl [scan] > rssi [rssi] .TP .B bluetoothctl [scan] > pathloss [pathloss] .TP .B bluetoothctl [scan] > transport [auto/bredr/le] .TP .B bluetoothctl [scan] > duplicate\-data [on/off] .TP .B bluetoothctl [scan] > discoverable [on/off] .TP .B bluetoothctl [scan] > pattern [value] .TP .B bluetoothctl [scan] > clear [filter] .UNINDENT .SS array{string} GetDiscoveryFilters() .sp فیلترهای موجود را که می‌توان به \fBSetDiscoveryFilter\fP داد، بازمی‌گرداند. .sp خطاهای ممکن: هیچ (None) .SS object ConnectDevice(dict properties) [experimental] .sp بدون نیاز به انجام شناسایی عمومی (General Discovery)، به دستگاه متصل می‌شود. .sp مکانیسم اتصال مشابه متد Connect در واسط \fBorg.bluez.Device1(5)\fP است، با این تفاوت که این متد پس از برقراری اتصال فیزیکی موفقیت را بازمی‌گرداند و می‌توانید حامل (bearer) مورد نظر را برای اتصال با استفاده از پارامتر تعیین کنید. .sp پس از بازگشت این متد، شناسایی سرویس‌ها ادامه خواهد یافت و هر پروفایل پشتیبانی‌شده متصل خواهد شد. نیازی به فراخوانی Connect در Device1 پس از این فراخوانی نیست. اگر اتصال موفقیت‌آمیز باشد، این متد مسیر شیء را به شیء دستگاه ایجادشده یا دستگاهی که از قبل وجود دارد بازمی‌گرداند. .sp مقادیر ممکن برای ویژگی‌ها (properties): .INDENT 0.0 .TP .B string Address (Mandatory) آدرس دستگاه بلوتوثِ دستگاه راه دور. .TP .B string AddressType (Default \(dqBR/EDR\(dq) نوع آدرس دستگاه بلوتوث. این نوع آدرسی است که باید برای اتصال اولیه استفاده شود. .sp مقادیر ممکن: .INDENT 7.0 .TP .B \(dqpublic\(dq آدرس عمومی (Public address) .TP .B \(dqrandom\(dq آدرس تصادفی (Random address) .UNINDENT .UNINDENT .sp خطاهای ممکن: .INDENT 0.0 .TP .B org.bluez.Error.InvalidArguments .TP .B org.bluez.Error.AlreadyExists .TP .B org.bluez.Error.NotSupported .TP .B org.bluez.Error.NotReady .TP .B org.bluez.Error.Failed .UNINDENT .SS "ویژگی‌ها (Properties)" .SS string Address [readonly] .sp آدرس دستگاه بلوتوث. .SS string AddressType [readonly] .sp نوع آدرس بلوتوث. برای آداپتورهای دوحالته (dual\-mode) و فقط BR/EDR، مقدار پیش‌فرض آن \(dqpublic\(dq است. آداپتورهای LE تک‌حالته ممکن است هر یک از این مقادیر را داشته باشند. در صورت فعال بودن حریم خصوصی (privacy)، این ویژگی حاوی نوع آدرس هویت (Identity Address) است و نه نوع آدرس مورد استفاده برای اتصال. .sp مقادیر ممکن: .INDENT 0.0 .TP .B \(dqpublic\(dq آدرس عمومی (Public address). .TP .B \(dqrandom\(dq آدرس تصادفی (Random address). .UNINDENT .SS string Name [readonly] .sp نام سیستمی بلوتوث (pretty hostname). .sp این ویژگی یا یک مقدار پیش‌فرض استاتیک سیستمی است یا توسط یک دیمن خارجی که دسترسی به پیکربندی pretty hostname را فراهم می‌کند، کنترل می‌شود. .SS string Alias [readwrite] .sp نام دوستانه و کاربرپسند بلوتوث (friendly name). این مقدار قابل تغییر است. .sp در صورتی که نام مستعاری تنظیم نشده باشد، نام ارائه‌شده توسط سیستم بازگردانده می‌شود. تنظیم یک رشته خالی به عنوان نام مستعار، آن را به نام ارائه‌شده توسط سیستم بازمی‌گرداند. .sp هنگام بازنشانی نام مستعار با یک رشته خالی، ویژگی به مقدار پیش‌فرض نام سیستم بازمی‌گردد. .sp در سیستمی با پیکربندی مناسب، هرگز نیازی به تغییر این ویژگی نیست زیرا به طور پیش‌فرض روی نام سیستم قرار دارد و pretty hostname را ارائه می‌دهد. .sp این ویژگی تنها در صورتی که لازم باشد نام محلی با pretty hostname متفاوت باشد، باید به عنوان آخرین راهکار استفاده شود. .sp مثال‌ها: .INDENT 0.0 .TP .B bluetoothctl > system\-alias .TP .B bluetoothctl > reset\-alias .UNINDENT .SS uint32 Class [readonly] .sp کلاس دستگاه بلوتوث (Class of device). .sp این ویژگی نشان‌دهنده مقداری است که یا به طور خودکار توسط اطلاعات DMI/ACPI پیکربندی شده یا به عنوان پیکربندی استاتیک ارائه شده است. .SS boolean Connectable [readwrite] .sp آداپتور را در وضعیت قابل اتصال (connectable) یا غیرقابل اتصال قرار می‌دهد. این یک تنظیم سراسری است و فقط باید توسط برنامه تنظیمات استفاده شود. .sp تنظیم این ویژگی روی false، ویژگی Discoverable آداپتور را نیز روی false قرار می‌دهد که در صورت برگرداندن Connectable به true، به وضعیت قبل بازنمی‌گردد. .sp در صورت نیاز، برنامه باید به صورت دستی Discoverable را روی true تنظیم کند. .sp توجه داشته باشید که این ویژگی تنها بر اتصالات ورودی تأثیر می‌گذارد. .SS boolean Powered [readwrite] .sp آداپتور را روشن یا خاموش می‌کند. این کار همچنین وضعیت اتصال‌پذیری مناسب کنترلر را تنظیم می‌کند. .sp مقدار این ویژگی ماندگار (persistent) نیست. پس از راه‌اندازی مجدد سیستم یا جدا کردن آداپتور، دوباره به false بازنشانی می‌شود. .sp مثال‌ها: .INDENT 0.0 .TP .B bluetoothctl > power .UNINDENT .SS string PowerState [readonly, experimental] .sp وضعیت توان (برق) آداپتور. .sp وضعیت توان مشخص می‌کند که آیا آداپتور در حال خاموش شدن است یا در حال روشن شدن، و همچنین روشن است یا خاموش. .sp مقادیر ممکن: .INDENT 0.0 .TP .B \(dqon\(dq روشن (Powered on). .TP .B \(dqoff\(dq خاموش (Powered off). .TP .B \(dqoff\-enabling\(dq در حال گذار از \(dqoff\(dq به \(dqon\(dq. .TP .B \(dqon\-disabling\(dq در حال گذار از \(dqon\(dq به \(dqoff\(dq. .TP .B \(dqoff\-blocked\(dq مسدودشده توسط rfkill. .UNINDENT .SS boolean Discoverable [readwrite] (Default: false) .sp وضعیت آداپتور را برای مرئی کردن یا پنهان کردن آن به قابل کشف (discoverable) یا غیرقابل کشف تغییر می‌دهد. این یک تنظیم سراسری است و فقط باید توسط برنامه تنظیمات استفاده شود. .sp اگر DiscoverableTimeout روی یک مقدار غیر صفر تنظیم شده باشد، پس از انقضای زمان‌سنج، سیستم این مقدار را به false بازمی‌گرداند. .sp در صورتی که آداپتور خاموش باشد، تنظیم این مقدار با شکست مواجه می‌شود. .sp هنگام تغییر ویژگی Powered، وضعیت جدید این ویژگی از طریق سیگنال PropertiesChanged به‌روزرسانی می‌شود. .sp مثال‌ها: .INDENT 0.0 .TP .B bluetoothctl > discoverable .UNINDENT .SS boolean Pairable [readwrite] (Default: true) .sp وضعیت آداپتور را به جفت‌پذیر (pairable) یا غیرقابل جفت‌سازی تغییر می‌دهد. این یک تنظیم سراسری است و فقط باید توسط برنامه تنظیمات استفاده شود. .sp توجه داشته باشید که این ویژگی تنها بر درخواست‌های جفت‌سازی ورودی تأثیر می‌گذارد. .sp مثال‌ها: .INDENT 0.0 .TP .B bluetoothctl > pairable .UNINDENT .SS uint32 PairableTimeout [readwrite] (Default: 0) .sp مدت‌زمان وقفه جفت‌پذیری بر حسب ثانیه. مقدار صفر یعنی مهلت زمانی غیرفعال است و آداپتور برای همیشه در حالت جفت‌پذیر باقی می‌ماند. .SS uint32 DiscoverableTimeout [readwrite] (Default: 180) .sp مدت‌زمان وقفه قابلیت کشف بر حسب ثانیه. مقدار صفر یعنی مهلت زمانی غیرفعال است و آداپتور برای همیشه در حالت قابل کشف/محدود باقی می‌ماند. .sp مثال‌ها: .INDENT 0.0 .TP .B bluetoothctl > discoverable\-timeout [value] .UNINDENT .SS boolean Discovering [readonly] .sp نشان می‌دهد که یک فرایند شناسایی دستگاه فعال است. .SS array{string} UUIDs [readonly] .sp فهرستی از UUIDهای ۱۲۸ بیتی که سرویس‌های محلی موجود را نشان می‌دهند. .SS string Modalias [readonly, optional] .sp اطلاعات شناسه محلی دستگاه (Local Device ID) در قالب modalias که توسط هسته (kernel) و udev استفاده می‌شود. .SS array{string} Roles [readonly] .sp فهرست نقش‌های پشتیبانی‌شده. .sp مقادیر ممکن: .INDENT 0.0 .TP .B \(dqcentral\(dq از نقش مرکزی (central) پشتیبانی می‌کند. .TP .B \(dqperipheral\(dq از نقش جانبی (peripheral) پشتیبانی می‌کند. .TP .B \(dqcentral\-peripheral\(dq از هر دو نقش به صورت هم‌زمان پشتیبانی می‌کند. .UNINDENT .SS array{string} ExperimentalFeatures [readonly, optional] .sp فهرستی از UUIDهای ۱۲۸ بیتی که ویژگی‌های آزمایشی فعال کنونی را نشان می‌دهند. .SS uint16 Manufacturer [readonly] .sp سازنده دستگاه، به عنوان شناسه شرکت از نوع uint16 تعریف‌شده در مشخصات هسته بلوتوث (Core Bluetooth Specification). .SS byte Version [readonly] .sp نسخه بلوتوث پشتیبانی‌شده توسط دستگاه، به عنوان کد نسخه هسته تعریف‌شده در مشخصات هسته بلوتوث (Core Bluetooth Specification). .\" End of generated man page.