bluetoothctl(1) Linux System Administration bluetoothctl(1)

bluetoothctl - ابزار خط فرمان مدیریت بلوتوث

bluetoothctl [-a capability] [-e] [-m] [-t seconds] [-v] [-h]

ابزار تعاملی کنترل بلوتوث bluetoothctl(1). این ابزار با کنترل‌کننده‌های بلوتوث سنتی (BR/EDR) و بلوتوث کم‌مصرف (LE) کار می‌کند.

این ابزار مبتنی بر منو است اما قابلیت خودکارسازی از طریق خط فرمان را نیز دارد. نمونه‌هایی در بخش خودکارسازی آورده شده است.

این ابزار از طریق D-Bus با دیمن BlueZ ارتباط برقرار می‌کند، که عمدتاً با استفاده از رابط‌های org.bluez.Adapter(5) و org.bluez.Device(5) انجام می‌پذیرد. هر فرمان مشخص می‌کند که از کدام رابط D-Bus و متد/ویژگی بهره می‌برد.

ثبت گرداننده عامل (agent handler): <capability>
ثبت نقاط پایانی رسانه (Media endpoints)
فعال‌سازی خروجی پایشگر (monitor output)
مدت زمان انتظار به ثانیه برای حالت غیرتعاملی
نمایش نسخه
نمایش راهنما

فهرست کردن کنترل‌کننده‌های در دسترس.

کاربرد (Usage)
> list
مثال: نمایش تمام کنترل‌کننده‌های بلوتوث موجود در سامانه
> list

اطلاعات کنترل‌کننده.

کاربرد (Usage)
> show [ctrl]
کاربردها (Uses)
ویژگی‌های org.bluez.Adapter(5)
[ctrl]
نشانی کنترل‌کننده بلوتوث
مثال: نمایش اطلاعات کنترل‌کننده فعال کنونی
> show
مثال: نمایش اطلاعات کنترل‌کننده 00:11:22:33:44:55
> show 00:11:22:33:44:55

انتخاب کنترل‌کننده پیش‌فرض.

کاربرد (Usage)
> select <ctrl>
<ctrl>
نشانی کنترل‌کننده بلوتوث
مثال: انتخاب کنترل‌کننده 00:11:22:33:44:55
> select 00:11:22:33:44:55

فهرست کردن دستگاه‌های موجود، به همراه یک ویژگی اختیاری به عنوان پالایه (فیلتر).

کاربرد (Usage)
> devices [Paired/Bonded/Trusted/Connected]
[Paired/Bonded/Trusted/Connected]
پالایه برای نمایش تنها دستگاه‌های دارای ویژگی خاص (اختیاری)
مثال: فهرست کردن تمام دستگاه‌های کشف‌شده
> devices
مثال: فهرست کردن تنها دستگاه‌های جفت‌شده (Paired)
> devices Paired
مثال: فهرست کردن تنها دستگاه‌های پیوند‌خورده (Bonded)
> devices Bonded
مثال: فهرست کردن تنها دستگاه‌های مورد اعتماد (Trusted)
> devices Trusted
مثال: فهرست کردن تنها دستگاه‌های متصل کنونی (Connected)
> devices Connected

تنظیم نام مستعار کنترل‌کننده.

کاربرد (Usage)
> system-alias <name>
استفاده‌ها (Uses)
ویژگی Alias در org.bluez.Adapter(5)
<name>
نام مستعار جدید برای کنترل‌کننده بلوتوث (الزامی)
مثال تنظیم نام مستعار کنترل‌کننده با فاصله (به نقل‌قول‌ها دقت کنید) (Example Set controller alias with spaces (note quotes))
> system-alias "My Desktop Bluetooth"
مثال تنظیم نام مستعار کنترل‌کننده بدون فاصله (Example Set controller alias without spaces)
> system-alias MyLaptop
مثال تنظیم نام مستعار کنترل‌کننده با خط تیره (Example Set controller alias with hyphens)
> system-alias "Home-Office-PC"

بازنشانی نام مستعار کنترل‌کننده.

کاربرد (Usage)
> reset-alias
استفاده‌ها (Uses)
ویژگی Alias در org.bluez.Adapter(5)
مثال بازنشانی نام مستعار کنترل‌کننده به مقدار پیش‌فرض (معمولاً نام میزبان) (Example Reset controller alias to default (usually the hostname))
> reset-alias

تنظیم وضعیت برق کنترل‌کننده.

هنگامی که کنترل‌کننده خاموش می‌شود، درگاه USB که کنترل‌کننده به آن متصل است در وضعیت تعلیق قرار می‌گیرد.

کاربرد (Usage)
> power <on/off>
استفاده‌ها (Uses)
ویژگی Powered در org.bluez.Adapter(5)
<on/off>
وضعیت برق - "on" برای فعال‌سازی یا "off" برای غیرفعال‌سازی کنترل‌کننده (الزامی)
مثال روشن کردن کنترل‌کننده بلوتوث (Example Turn on the Bluetooth controller)
> power on
مثال خاموش کردن کنترل‌کننده بلوتوث (Example Turn off the Bluetooth controller)
> power off

فعال/غیرفعال‌سازی آگهی‌رسانی با نوع داده‌شده.

هنگامی که کنترل‌کننده یک دستگاه LE (جانبی) را آگهی‌رسانی می‌کند، در صورتی که کنترل‌کننده توانایی آن را داشته باشد، برای حفظ حریم خصوصی خود یک نشانی تصادفی تولید خواهد کرد؛ در صورتی که از این ویژگی پشتیبانی نکند، از نشانی عمومی خود (نشانی دستگاه) استفاده می‌کند.

یک دستگاه می‌تواند آگهی‌رسانی کند چنانچه اتصال به دستگاه آگهی‌رسان دیگری را آغاز کرده باشد.

کاربرد (Usage)
> advertise <on/off/type>
استفاده‌ها (Uses)
متد RegisterAdvertisement در org.bluez.LEAdvertisingManager(5)
<on/off/type>
حالت آگهی‌رسانی - "on"، "off"، "peripheral"، یا "broadcast" (الزامی)
مثال فعال‌سازی آگهی‌رسانی پایه LE (Example Enable basic LE advertising)
> advertise on
مثال غیرفعال‌سازی آگهی‌رسانی LE (Example Disable LE advertising)
> advertise off
مثال آگهی‌رسانی به عنوان دستگاه جانبی (Example Advertise as peripheral device)
> advertise peripheral
مثال آگهی‌رسانی به عنوان منبع پخش همگانی (Example Advertise as broadcast source)
> advertise broadcast

تنظیم نام مستعار دستگاه.

کاربرد (Usage)
> set-alias <alias>
استفاده‌ها (Uses)
ویژگی Alias در org.bluez.Device(5)
<alias>
نام مستعار جدید برای دستگاه (الزامی)
مثال تنظیم نام مستعار دستگاه با فاصله (به نقل‌قول‌ها دقت کنید) (Example Set device alias with spaces (note quotes))
> set-alias "My Headphones"
مثال تنظیم نام مستعار دستگاه بدون فاصله (Example Set device alias without spaces)
> set-alias MyMouse
مثال تنظیم نام مستعار دستگاه با خط تیره (Example Set device alias with hyphens)
> set-alias "Kitchen-Speaker"

پویش برای یافتن دستگاه‌ها.

برای LE، پویش یک پیش‌نیاز مهم پیش از اتصال یا جفت‌سازی است.

هدف از پویش، یافتن دستگاه‌هایی است که با پرچم کشف‌پذیری فعال (چه محدود و چه عمومی) در حال انتشار و اعلام حضور هستند. پس از یافتن نشانی، می‌توانید متصل یا جفت شوید.

کاربرد (Usage)
> scan <on/off/bredr/le>
استفاده‌ها (Uses)
متدهای StartDiscovery و StopDiscovery در org.bluez.Adapter(5)
<on/off/bredr/le>
حالت پویش - "on"، "off"، "bredr" برای کلاسیک، یا "le" برای کم‌مصرف (لازم)
مثال شروع پویش برای همه انواع دستگاه‌ها (LE + Classic) (Example Start scanning for all device types (LE + Classic))
> scan on
مثال توقف پویش (Example Stop scanning)
> scan off
مثال پویش تنها برای دستگاه‌های کم‌مصرف (Example Scan for Low Energy devices only)
> scan le
مثال پویش تنها برای دستگاه‌های BR/EDR (کلاسیک) (Example Scan for BR/EDR (Classic) devices only)
> scan bredr

جفت‌سازی با دستگاه.

این دستور با یک دستگاه جفت می‌شود و سپس به آن اعتماد کرده و متصل می‌گردد. اگر دستگاه از قبل جفت شده باشد، ابتدا پیوند جفت‌سازی برداشته خواهد شد.

این فرمان چه زمانی که کنترل‌کننده در وضعیت متصل باشد و چه در وضعیت غیرمتصل، قابل استفاده است.

اگر کنترل‌کننده از پیش متصل باشد، فرمان جفت‌سازی می‌تواند بدون آرگومان به کار رود. اگر کنترل‌کننده متصل نباشد، می‌توان نشانی دستگاهی دارای گزارش پویش فعال را به فرمان pair داد و این دستور پیش از جفت‌سازی، اتصال را برقرار خواهد کرد.

پیش از جفت‌سازی باید کارگزار برای انتخاب سازوکار احراز هویت برگزیده شود.

کاربرد (Usage)
> pair [dev]
استفاده‌ها (Uses)
متد Pair در org.bluez.Device(5)
[dev]
نشانی MAC دستگاه (XX:XX:XX:XX:XX:XX) (اختیاری، در صورت حذف از دستگاه فعلی استفاده می‌شود)
مثال جفت‌سازی با دستگاه با استفاده از نشانی MAC (Example Pair with device using MAC address)
> pair 00:11:22:33:44:55
مثال جفت‌سازی با دستگاهی دیگر (Example Pair with another device)
> pair AA:BB:CC:DD:EE:FF
مثال جفت‌سازی با استفاده از مسیر شیء دستگاه (Example Pair using device object path)
> pair /org/bluez/hci0/dev_00_11_22_33_44_55

تنظیم حالت جفت‌پذیری کنترل‌کننده.

این دستور جفت‌سازی را فعال/غیرفعال می‌کند. اگر جفت‌سازی غیرفعال باشد، کنترل‌کننده هیچ درخواست جفت‌سازی را نمی‌پذیرد.

کاربرد (Usage)
> pairable <on/off>
استفاده‌ها (Uses)
ویژگی Pairable در org.bluez.Adapter(5)
<on/off>
حالت جفت‌پذیری - "on" برای پذیرش یا "off" برای رد درخواست‌های جفت‌سازی (لازم)
مثال فعال کردن جفت‌سازی (پذیرش درخواست‌های جفت‌سازی) (Example Enable pairing (accept pairing requests))
> pairable on
مثال غیرفعال کردن جفت‌سازی (رد درخواست‌های جفت‌سازی) (Example Disable pairing (reject pairing requests))
> pairable off

تنظیم حالت کشف‌پذیری.

این دستور حالت کشف‌پذیری را فعال/غیرفعال می‌کند. اگر کشف‌پذیری غیرفعال باشد، کنترل‌کننده به هیچ درخواست پویشی پاسخ نخواهد داد.

در LE، اگر کشف‌پذیری خاموش باشد، کنترل‌کننده صرفاً به‌طور غیرفعال پویش می‌کند و به دستگاه‌های انتشاردهنده درخواستی برای پویش ارسال نمی‌کند. اگر روشن باشد، درخواست‌های تبلیغاتی ارسال خواهد کرد.

در صورت پشتیبانی کنترل‌کننده، از یک نشانی تصادفی استفاده خواهد شد. مدت زمانی که "discoverable on" معتبر است توسط فرمان discoverable-timeout مشخص می‌شود.

کاربرد (Usage)
> discoverable <on/off>
استفاده‌ها (Uses)
ویژگی Discoverable در org.bluez.Adapter(5)
<on/off>
حالت کشف‌پذیری - "on" برای کشف‌پذیر بودن یا "off" برای کشف‌ناپذیر بودن (لازم)
مثال کشف‌پذیر کردن کنترل‌کننده برای سایر دستگاه‌ها (Example Make controller discoverable to other devices)
> discoverable on
مثال کشف‌ناپذیر کردن کنترل‌کننده (Example Make controller non-discoverable)
> discoverable off

تنظیم مهلت زمان کشف‌پذیری.

مدت زمان به ثانیه که "discoverable on" معتبر است.

کاربرد (Usage)
> discoverable-timeout [value]
استفاده‌ها (Uses)
ویژگی DiscoverableTimeout در org.bluez.Adapter(5)
[value]
مدت زمان مهلت به ثانیه برای حالت کشف‌پذیری (۰ برای نامحدود، اختیاری)
مثال نمایش مقدار کنونی مهلت زمان کشف‌پذیری (Example Show current discoverable timeout value)
> discoverable-timeout
مثال تنظیم مهلت زمان کشف‌پذیری روی ۳۰ ثانیه (Example Set discoverable timeout to 30 seconds)
> discoverable-timeout 30
مثال تنظیم مهلت زمان کشف‌پذیری روی ۲ دقیقه (Example Set discoverable timeout to 2 minutes)
> discoverable-timeout 120
مثال تنظیم مهلت زمان کشف‌پذیری روی ۵ دقیقه (Example Set discoverable timeout to 5 minutes)
> discoverable-timeout 300
مثال تنظیم مهلت زمان نامحدود برای کشف‌پذیری (Example Set unlimited discoverable timeout)
> discoverable-timeout 0

فعال/غیرفعال کردن کارگزار با قابلیت داده‌شده.

این دستور سازوکار احراز هویت محلی کنترل‌کننده را تعیین می‌کند. این کار برای جفت‌سازی لازم است و به شما امکان می‌دهد قابلیت‌های ورودی/خروجی (IO) کنترل‌کننده را انتخاب کنید.

قابلیت‌های معتبر کارگزار عبارت‌اند از: DisplayOnly، DisplayYesNo، KeyboardDisplay، KeyboardOnly، NoInputNoOutput.

کاربرد (Usage)
> agent <on/off/auto/capability>
استفاده‌ها (Uses)
روش RegisterAgent در org.bluez.AgentManager(5)
<on/off/auto/capability>
حالت کارگزار - "on"، "off"، "auto"، یا نوع قابلیت (DisplayOnly، DisplayYesNo، KeyboardDisplay، KeyboardOnly، NoInputNoOutput) (الزامی)
مثال فعال‌سازی کارگزار با قابلیت پیش‌فرض (Example Enable agent with default capability)
> agent on
مثال غیرفعال‌سازی کارگزار (Example Disable agent)
> agent off
مثال فعال‌سازی کارگزاری با قابلیت صرفاً نمایش کدهای جفت‌سازی (Example Enable agent that can only display pairing codes)
> agent DisplayOnly
مثال فعال‌سازی کارگزاری با قابلیت نمایش کدها و پذیرش/رد (Example Enable agent that can display codes and accept/reject)
> agent DisplayYesNo
مثال فعال‌سازی کارگزاری با قابلیت نمایش و ورود کدهای جفت‌سازی (Example Enable agent that can display and input pairing codes)
> agent KeyboardDisplay
مثال فعال‌سازی کارگزاری که تنها قادر به ورود کدهای جفت‌سازی است (Example Enable agent that can only input pairing codes)
> agent KeyboardOnly
مثال فعال‌سازی کارگزار بدون ورودی/خروجی (JustWorks) (Example Enable agent with no input/output (JustWorks))
> agent NoInputNoOutput

تنظیم کارگزار کنونی به عنوان پیش‌فرض.

پس از گزینش کارگزار، این دستور آن را به عنوان کارگزار پیش‌فرض تعیین می‌کند.

کاربرد (Usage)
> default-agent
استفاده‌ها (Uses)
روش RequestDefaultAgent در org.bluez.AgentManager(5)
مثال تنظیم کارگزار کنونی به عنوان پیش‌فرض (Example Set the current agent as default)
> default-agent

معتمدسازی دستگاه.

کاربرد (Usage)
> trust [dev]
استفاده‌ها (Uses)
ویژگی Trusted در org.bluez.Device(5)
[dev]
نشانی MAC دستگاه (XX:XX:XX:XX:XX:XX) یا مسیر شیء (اختیاری، در صورت عدم ذکر از دستگاه کنونی استفاده می‌شود)
مثال معتمدسازی دستگاه با استفاده از نشانی MAC (Example Trust device using MAC address)
> trust 00:11:22:33:44:55
مثال معتمدسازی دستگاهی دیگر (Example Trust another device)
> trust AA:BB:CC:DD:EE:FF
مثال معتمدسازی دستگاه با استفاده از مسیر شیء (Example Trust device using object path)
> trust /org/bluez/hci0/dev_00_11_22_33_44_55

لغو اعتماد به دستگاه.

کاربرد (Usage)
> untrust [dev]
استفاده‌ها (Uses)
ویژگی Trusted در org.bluez.Device(5)
[dev]
نشانی MAC دستگاه (XX:XX:XX:XX:XX:XX) یا مسیر شیء (اختیاری؛ در صورت حذف از دستگاه فعلی استفاده می‌شود)
مثال لغو اعتماد از دستگاه با استفاده از نشانی MAC (Example Remove trust from device using MAC address)
> untrust 00:11:22:33:44:55
مثال لغو اعتماد از دستگاهی دیگر (Example Remove trust from another device)
> untrust AA:BB:CC:DD:EE:FF
مثال لغو اعتماد با استفاده از مسیر شیء (Example Remove trust using object path)
> untrust /org/bluez/hci0/dev_00_11_22_33_44_55

مسدود کردن دستگاه.

کاربرد (Usage)
> block [dev]
استفاده‌ها (Uses)
ویژگی Blocked در org.bluez.Device(5)
[dev]
نشانی MAC دستگاه (XX:XX:XX:XX:XX:XX) یا مسیر شیء (اختیاری؛ در صورت حذف از دستگاه فعلی استفاده می‌شود)
مثال مسدود کردن دستگاه با استفاده از نشانی MAC (Example Block device using MAC address)
> block 00:11:22:33:44:55
مثال مسدود کردن دستگاهی دیگر (Example Block another device)
> block AA:BB:CC:DD:EE:FF
مثال مسدود کردن دستگاه با استفاده از مسیر شیء (Example Block device using object path)
> block /org/bluez/hci0/dev_00_11_22_33_44_55

رفع انسداد دستگاه.

کاربرد (Usage)
> unblock [dev]
استفاده‌ها (Uses)
ویژگی Blocked در org.bluez.Device(5)
[dev]
نشانی MAC دستگاه (XX:XX:XX:XX:XX:XX) یا مسیر شیء (اختیاری؛ در صورت حذف از دستگاه فعلی استفاده می‌شود)
مثال رفع انسداد دستگاه با استفاده از نشانی MAC (Example Unblock device using MAC address)
> unblock 00:11:22:33:44:55
مثال رفع انسداد دستگاهی دیگر (Example Unblock another device)
> unblock AA:BB:CC:DD:EE:FF
مثال رفع انسداد دستگاه با استفاده از مسیر شیء (Example Unblock device using object path)
> unblock /org/bluez/hci0/dev_00_11_22_33_44_55

حذف دستگاه.

کاربرد (Usage)
> remove <dev>
استفاده‌ها (Uses)
روش RemoveDevice در org.bluez.Adapter(5)
<dev>
نشانی MAC دستگاه (XX:XX:XX:XX:XX:XX) یا مسیر شیء (الزامی)
مثال حذف دستگاه با استفاده از نشانی MAC (Example Remove device using MAC address)
> remove 00:11:22:33:44:55
مثال حذف دستگاهی دیگر (Example Remove another device)
> remove AA:BB:CC:DD:EE:FF
مثال حذف دستگاه با استفاده از مسیر شیء (Example Remove device using object path)
> remove /org/bluez/hci0/dev_00_11_22_33_44_55

اتصال به دستگاه.

این فرمان برقراری ارتباط با یک دستگاه را آغاز می‌کند.

به‌طور پیش‌فرض این فرمان تلاش می‌کند به تمامی نمایه‌هایی که دستگاه دوردست پشتیبانی می‌کند و به عنوان قابل اتصال خودکار علامت‌گذاری شده‌اند متصل شود. در صورتی که UUID خدمت دوردست داده شده باشد، تنها همان خدمت متصل خواهد شد. مقدار UUID می‌تواند به شکل کوتاه (UUID شانزده بیتی) یا به شکل بلند (UUID صد و بیست و هشت بیتی) باشد. همچنین مقادیر ویژه‌ای برای نمایه‌های شناخته‌شده مانند "a2dp-sink"، "a2dp-source"، "hfp-hf"، "hfp-ag"، "ftp" یا "spp" وجود دارد.

برای اتصال به دستگاه‌های LE (کم‌مصرف)، کنترل‌کننده باید یک گزارش پویش فعال از دستگاهی که قصد اتصال به آن دارد را در اختیار داشته باشد.

اگر هیچ گزارش تبلیغی (advertising report) پیش از سرآمدن مهلت دریافت نشود، خطای le-connection-abort-by-local صادر خواهد شد. در آن صورت، با فرض اینکه دستگاه در حال تبلیغ است، اتصال مجدد را امتحان کنید.

کاربرد (Usage)
> connect <dev> [uuid]
استفاده‌ها (Uses)
روش‌های Connect و ConnectProfile در org.bluez.Device(5)
<dev>
نشانی MAC دستگاه (XX:XX:XX:XX:XX:XX) یا مسیر شیء (الزامی)
[uuid]
شناسه یکتای (UUID) خدمت مشخص برای اتصال (UUID شانزده بیتی، ۱۲۸ بیتی یا نام نمایه مانند "a2dp-sink"، "hfp-hf" و غیره) (اختیاری)
مثال اتصال به دستگاه (تمام نمایه‌های پشتیبانی‌شده) (Example Connect to device (all supported profiles))
> connect 1C:48:F9:9D:81:5C
مثال اتصال به نمایه هدست HSP (Example Connect to HSP Headset profile)
> connect 1C:48:F9:9D:81:5C hsp-hs
مثال اتصال به نمایه مقصد صوتی A2DP (Example Connect to A2DP Sink profile)
> connect 1C:48:F9:9D:81:5C a2dp-sink
مثال اتصال به نمایه منبع صوتی A2DP (Example Connect to A2DP Source profile)
> connect 1C:48:F9:9D:81:5C a2dp-source
مثال اتصال به نمایه هندزفری HFP (Example Connect to HFP Hands-Free profile)
> connect 1C:48:F9:9D:81:5C hfp-hf
مثال اتصال به نمایه درگاه صوتی HFP (Example Connect to HFP Audio Gateway profile)
> connect 1C:48:F9:9D:81:5C hfp-ag
مثال اتصال به نمایه انتقال پرونده (Example Connect to File Transfer Profile)
> connect 1C:48:F9:9D:81:5C ftp
مثال اتصال به نمایه درگاه سریال (Example Connect to Serial Port Profile)
> connect 1C:48:F9:9D:81:5C spp
مثال اتصال با استفاده از UUID کامل ۱۲۸ بیتی (HSP) (Example Connect using full 128-bit UUID (HSP))
> connect 1C:48:F9:9D:81:5C 00001108-0000-1000-8000-00805f9b34fb
مثال اتصال با استفاده از UUID کوتاه ۱۶ بیتی (HSP) (Example Connect using short 16-bit UUID (HSP))
> connect 1C:48:F9:9D:81:5C 0x1108
مثال اتصال به نمایه A2DP با استفاده از UUID کوتاه (Example Connect to A2DP profile using short UUID)
> connect 1C:48:F9:9D:81:5C 0x110E

قطع اتصال دستگاه.

به‌طور پیش‌فرض، این دستور همه نمایه‌ها را قطع کرده و سپس اتصال را خاتمه می‌دهد. در صورتی که UUID خدمت دوردست داده شده باشد، تنها همان خدمت قطع خواهد شد.

برای LE، هنگام قطع اتصال از یک ارتباط فعال، نیازی به نشانی دستگاه نیست.

کاربرد (Usage)
> disconnect [dev] [uuid]
استفاده‌ها (Uses)
متدهای Disconnect و DisconnectProfile در org.bluez.Device(5)
[dev]
نشانی MAC دستگاه (XX:XX:XX:XX:XX:XX) یا مسیر شیء (اختیاری؛ در صورت حذف از دستگاه فعلی استفاده می‌شود)
[uuid]
شناسه یکتای (UUID) خدمت مشخص برای قطع اتصال (UUID شانزده بیتی، ۱۲۸ بیتی یا نام نمایه) (اختیاری)
مثال قطع تمام نمایه‌ها و خاتمه اتصال (Example Disconnect all profiles and terminate connection)
> disconnect 1C:48:F9:9D:81:5C
مثال قطع تنها نمایه A2DP Sink (Example Disconnect only A2DP Sink profile)
> disconnect 1C:48:F9:9D:81:5C a2dp-sink
مثال قطع تنها نمایه دست‌آزاد HFP (Example Disconnect only HFP Hands-Free profile)
> disconnect 1C:48:F9:9D:81:5C hfp-hf
مثال قطع تنها نمایه درگاه سریال (Example Disconnect only Serial Port Profile)
> disconnect 1C:48:F9:9D:81:5C spp
مثال قطع نمایه A2DP با استفاده از UUID کوتاه (Example Disconnect A2DP profile using short UUID)
> disconnect 1C:48:F9:9D:81:5C 0x110E
مثال قطع نمایه HSP با استفاده از UUID کامل (Example Disconnect HSP profile using full UUID)
> disconnect 1C:48:F9:9D:81:5C 00001108-0000-1000-8000-00805f9b34fb

اطلاعات دستگاه.

کاربرد (Usage)
> info [dev/set]
استفاده‌ها (Uses)
ویژگی‌های org.bluez.Device(5)
[dev/set]
نشانی MAC دستگاه (XX:XX:XX:XX:XX:XX)، مسیر شیء یا DeviceSet (اختیاری؛ در صورت حذف از دستگاه فعلی استفاده می‌شود)
مثال نمایش اطلاعات تفصیلی دستگاه (Example Show detailed information for device)
> info 1C:48:F9:9D:81:5C
مثال نمایش اطلاعات دستگاهی دیگر (Example Show information for another device)
> info 00:11:22:33:44:55
مثال نمایش اطلاعات دستگاه با استفاده از مسیر شیء (Example Show device info using object path)
> info /org/bluez/hci0/dev_1C_48_F9_9D_81_5C

دریافت/تنظیم حامل ترجیحی.

کاربرد (Usage)
> bearer <dev> [last-seen/bredr/le]
استفاده‌ها (Uses)
ویژگی PreferredBearer در org.bluez.Device(5)
<dev>
نشانی MAC دستگاه (XX:XX:XX:XX:XX:XX) یا مسیر شیء (الزامی)
[last-seen/bredr/le]
نوع حامل ترجیحی - "last-seen"، "bredr" برای سنتی (Classic) یا "le" برای کم‌مصرف (Low Energy) (اختیاری)
مثال دریافت حامل ترجیحی (Example get preferred bearer)
> bearer <addr>
PreferredBearer: last-seen
مثال تنظیم حامل ترجیحی روی LE (Example set preferred bearer to LE)
> bearer <addr> le
[CHG] Device <addr> PreferredBearer: le
Changing le succeeded
مثال تنظیم حامل ترجیحی روی BREDR (Example set preferred bearer to BREDR)
> bearer <addr> bredr
[CHG] Device <addr> PreferredBearer: bredr
Changing bredr succeeded

به bluetoothctl-advertise(1) مراجعه کنید.

به bluetoothctl-monitor(1) مراجعه کنید.

به bluetoothctl-scan(1) مراجعه کنید.

به bluetoothctl-gatt(1) مراجعه کنید.

به bluetoothctl-admin(1) مراجعه کنید.

به bluetoothctl-player(1) مراجعه کنید.

به bluetoothctl-endpoint(1) مراجعه کنید.

به bluetoothctl-transport(1) مراجعه کنید.

به bluetoothctl-mgmt(1) مراجعه کنید.

به bluetoothctl-assistant(1) مراجعه کنید.

به bluetoothctl-le(1) مراجعه کنید.

به bluetoothctl-bredr(1) مراجعه کنید.

دو روش متداول برای خودکارسازی این ابزار، استفاده از اسناد درجا (Here Docs) یا برنامه expect است. استفاده از اسناد درجا برای نمایش اطلاعات کنترل‌کننده بلوتوث:

bluetoothctl <<EOF
list
show
EOF

http://www.bluez.org

<linux-bluetooth@vger.kernel.org>

استفاده آزاد از این نرم‌افزار تحت شرایط مجوز عمومی همگانی کمتر گنو (LGPL) مجاز است.

March 2024 BlueZ