bluetoothctl-mgmt(1) Linux System Administration bluetoothctl-mgmt(1)

bluetoothctl-mgmt - زیرمنوی مدیریت (Management Submenu)

bluetoothctl [--options] [mgmt.commands]

نکته:

این زیرمنو مستقیماً از طریق سوکت مدیریت بلوتوث (mgmt) با هسته ارتباط برقرار می‌کند و API مربوط به D-Bus دیمن BlueZ را دور می‌زند. فرمان‌ها از Bluetooth Management API تعریف‌شده در مستندات هسته استفاده می‌کنند.

گزینش شناسه‌ای دیگر

کاربرد (Usage)
> select <index>
<index>
شماره شناسه کنترل‌کننده (مبتنی بر صفر) برای گزینش
مثال: گزینش شناسه کنترل‌کننده 0 (hci0)
> select 0
مثال: گزینش شناسه کنترل‌کننده 1 (hci1)
> select 1
مثال: گزینش شناسه کنترل‌کننده 2 (hci2)
> select 2

دریافت نسخه بازنگری (Revision) سوکت MGMT

کاربرد (Usage)
> revision
مثال: نمایش اطلاعات بازنگری MGMT API
> revision

فهرست کردن فرمان‌های پشتیبانی‌شده

کاربرد (Usage)
> commands
مثال: فهرست کردن تمام فرمان‌های مدیریتی پشتیبانی‌شده
> commands

نمایش اطلاعات پیکربندی

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

نمایش اطلاعات کنترل‌کننده

کاربرد (Usage)
> info
مثال: نمایش اطلاعات تفصیلی کنترل‌کننده
> info

نمایش اطلاعات تکمیلی کنترل‌کننده

کاربرد (Usage)
> extinfo
مثال: نمایش اطلاعات تکمیلی کنترل‌کننده
> extinfo

تأمین توان تمامی قابلیت‌های در دسترس

کاربرد (Usage)
> auto-power
مثال: تأمین خودکار توان تمامی قابلیت‌های در دسترس کنترل‌کننده
> auto-power

تغییر وضعیت روشن/خاموش بودن

کاربرد (Usage)
> power <on/off>
<on/off>
وضعیت روشن/خاموش - "on" برای فعال‌سازی کنترل‌کننده، "off" برای غیرفعال‌سازی
مثال روشن کردن کنترل‌کننده (Example Power on the controller)
> power on
مثال خاموش کردن کنترل‌کننده (Example Power off the controller)
> power off

تغییر وضعیت کشف‌پذیری

کاربرد (Usage)
> discov <yes/no/limited> [timeout]
<yes/no/limited>
حالت کشف‌پذیری - "yes" برای عمومی، "no" برای غیرفعال‌سازی، "limited" برای کشف‌پذیری محدود
[timeout]
مهلت زمانی اختیاری به ثانیه برای مدت‌زمان حالت کشف‌پذیری
مثال کشف‌پذیر کردن کنترل‌کننده برای مدت نامحدود (Example Make controller discoverable indefinitely)
> discov yes
مثال غیرفعال کردن کشف‌پذیری کنترل‌کننده (Example Make controller non-discoverable)
> discov no
مثال فعال‌سازی حالت کشف‌پذیری محدود (Example Enable limited discoverable mode)
> discov limited
مثال کشف‌پذیر کردن برای ۳۰ ثانیه (Example Make discoverable for 30 seconds)
> discov yes 30
مثال کشف‌پذیر کردن برای ۲ دقیقه (Example Make discoverable for 2 minutes)
> discov yes 120
مثال کشف‌پذیر کردن برای ۵ دقیقه (Example Make discoverable for 5 minutes)
> discov yes 300
مثال کشف‌پذیری محدود برای ۶۰ ثانیه (Example Limited discoverable for 60 seconds)
> discov limited 60

تغییر وضعیت اتصال‌پذیری

کاربرد (Usage)
> connectable <on/off>
<on/off>
وضعیت اتصال‌پذیری - "on" برای پذیرش اتصالات، "off" برای رد کردن
مثال اتصال‌پذیر کردن کنترل‌کننده (Example Make controller connectable)
> connectable on
مثال غیرفعال کردن اتصال‌پذیری کنترل‌کننده (Example Make controller non-connectable)
> connectable off

تغییر وضعیت اتصال‌پذیری سریع

کاربرد (Usage)
> fast-conn <on/off>
<on/off>
وضعیت اتصال‌پذیری سریع - "on" برای فعال‌سازی حالت اتصال سریع، "off" برای غیرفعال‌سازی
مثال فعال‌سازی حالت اتصال‌پذیری سریع (Example Enable fast connectable mode)
> fast-conn on
مثال غیرفعال‌سازی حالت اتصال‌پذیری سریع (Example Disable fast connectable mode)
> fast-conn off

تغییر وضعیت پیوندپذیری

کاربرد (Usage)
> bondable <on/off>
<on/off>
وضعیت پیوندپذیری - "on" برای فعال‌سازی قابلیت پیوند، "off" برای غیرفعال‌سازی
مثال فعال‌سازی قابلیت پیوند (Example Enable bonding capability)
> bondable on
مثال غیرفعال‌سازی قابلیت پیوند (Example Disable bonding capability)
> bondable off

تغییر وضعیت جفت‌پذیری

کاربرد (Usage)
> pairable <on/off>
<on/off>
وضعیت جفت‌پذیری - "on" برای فعال‌سازی قابلیت جفت‌سازی، "off" برای غیرفعال‌سازی
مثال فعال‌سازی قابلیت جفت‌سازی (Example Enable pairing capability)
> pairable on
مثال غیرفعال‌سازی قابلیت جفت‌سازی (Example Disable pairing capability)
> pairable off

تغییر وضعیت امنیت سطح پیوند

کاربرد (Usage)
> linksec <on/off>
<on/off>
امنیت سطح پیوند - "on" برای فعال‌سازی، "off" برای غیرفعال‌سازی
مثال: فعال‌سازی امنیت سطح پیوند
> linksec on
مثال: غیرفعال‌سازی امنیت سطح پیوند
> linksec off

تغییر وضعیت حالت جفت‌سازی ساده امن (SSP)

کاربرد (Usage)
> ssp <on/off>
<on/off>
حالت جفت‌سازی ساده امن (Secure Simple Pairing) - "on" برای فعال‌سازی SSP، "off" برای غیرفعال‌سازی
مثال: فعال‌سازی جفت‌سازی ساده امن (Secure Simple Pairing)
> ssp on
مثال: غیرفعال‌سازی جفت‌سازی ساده امن (Secure Simple Pairing)
> ssp off

تغییر وضعیت پشتیبانی از اتصال‌های امن (SC)

کاربرد (Usage)
> sc <on/off/only>
<on/off/only>
پشتیبانی از اتصال‌های امن (Secure Connections) - "on" برای فعال‌سازی، "off" برای غیرفعال‌سازی، "only" برای استفاده اختصاصی
مثال: فعال‌سازی پشتیبانی از اتصال‌های امن (Secure Connections)
> sc on
مثال: غیرفعال‌سازی پشتیبانی از اتصال‌های امن (Secure Connections)
> sc off
مثال: استفاده اختصاصی از اتصال‌های امن (Secure Connections)
> sc only

تغییر وضعیت پشتیبانی از سرعت بالا (HS)

کاربرد (Usage)
> hs <on/off>
<on/off>
پشتیبانی از سرعت بالا (High Speed) - "on" برای فعال‌سازی 802.11 High Speed، "off" برای غیرفعال‌سازی
مثال: فعال‌سازی پشتیبانی از سرعت بالا (High Speed)
> hs on
مثال: غیرفعال‌سازی پشتیبانی از سرعت بالا (High Speed)
> hs off

تغییر وضعیت پشتیبانی از کم‌مصرف (LE)

کاربرد (Usage)
> le <on/off>
<on/off>
پشتیبانی از کم‌مصرف (Low Energy) - "on" برای فعال‌سازی قابلیت LE، "off" برای غیرفعال‌سازی
مثال: فعال‌سازی پشتیبانی از کم‌مصرف (Low Energy)
> le on
مثال: غیرفعال‌سازی پشتیبانی از کم‌مصرف (Low Energy)
> le off

تغییر وضعیت اعلان LE (LE advertising)

کاربرد (Usage)
> advertising <on/off>
<on/off>
وضعیت اعلان LE - "on" برای فعال‌سازی اعلان، "off" برای غیرفعال‌سازی
مثال: فعال‌سازی اعلان LE
> advertising on
مثال: غیرفعال‌سازی اعلان LE
> advertising off

تغییر وضعیت پشتیبانی از BR/EDR

کاربرد (Usage)
> bredr <on/off>
<on/off>
پشتیبانی از BR/EDR - "on" برای فعال‌سازی بلوتوث کلاسیک (Classic Bluetooth)، "off" برای غیرفعال‌سازی
مثال: فعال‌سازی پشتیبانی از BR/EDR (بلوتوث کلاسیک)
> bredr on
مثال: غیرفعال‌سازی پشتیبانی از BR/EDR
> bredr off

تغییر وضعیت پشتیبانی از حریم خصوصی

کاربرد (Usage)
> privacy <on/off> [irk]
<on/off>
پشتیبانی از حریم خصوصی - "on" برای فعال‌سازی قابلیت‌های حریم خصوصی، "off" برای غیرفعال‌سازی
[irk]
کلید اختیاری ۳۲-نویسه‌ای هگزادسیمال تفکیک هویت (Identity Resolving Key)
مثال فعال‌سازی حریم خصوصی با IRK خودکار تولیدشده (Example Enable privacy with auto-generated IRK)
> privacy on
مثال غیرفعال‌سازی حریم خصوصی (Example Disable privacy)
> privacy off
مثال فعال‌سازی حریم خصوصی با IRK مشخص (Example Enable privacy with specific IRK)
> privacy on 0123456789abcdef0123456789abcdef
مثال فعال‌سازی حریم خصوصی با IRK متفاوت (Example Enable privacy with different IRK)
> privacy on 1234567890abcdef1234567890abcdef

تنظیم رده اصلی/فرعی دستگاه

کاربرد (Usage)
> class <major> <minor>
<major>
کد رده اصلی دستگاه (هگزادسیمال)
<minor>
کد رده فرعی دستگاه (هگزادسیمال)
مثال تنظیم رده روی صوتی/تصویری - هدست پوشیدنی (Example Set class to Audio/Video - Wearable Headset)
> class 0x04 0x01
مثال تنظیم رده روی صوتی/تصویری - هندزفری (Example Set class to Audio/Video - Hands-free)
> class 0x04 0x02
مثال تنظیم رده روی صوتی/تصویری - هدفون (Example Set class to Audio/Video - Headphones)
> class 0x04 0x06
مثال تنظیم رده روی صوتی/تصویری - دستگاه ویدیو (Example Set class to Audio/Video - VCR)
> class 0x04 0x0B
مثال تنظیم رده روی رایانه - ایستگاه کاری رومیزی (Example Set class to Computer - Desktop workstation)
> class 0x01 0x01
مثال تنظیم رده روی رایانه - کارگزار (Example Set class to Computer - Server)
> class 0x01 0x02
مثال تنظیم رده روی رایانه - لپ‌تاپ (Example Set class to Computer - Laptop)
> class 0x01 0x03
مثال تنظیم رده روی رایانه - رایانه دستی/پی‌دی‌ای (Example Set class to Computer - Handheld PC/PDA)
> class 0x01 0x04
مثال تنظیم رده روی تلفن - تلفن همراه (Example Set class to Phone - Cellular)
> class 0x02 0x01
مثال تنظیم رده روی تلفن - تلفن بی‌سیم (Example Set class to Phone - Cordless)
> class 0x02 0x02
مثال تنظیم رده روی تلفن - تلفن هوشمند (Example Set class to Phone - Smart phone)
> class 0x02 0x03

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

کاربرد (Usage)
> disconnect [-t type] <remote address>
[-t type]
نوع اختیاری نشانی (public، random، le_public، le_random)
<remote address>
نشانی بلوتوث دستگاه برای قطع اتصال
مثال قطع اتصال دستگاه با استفاده از نشانی عمومی (Example Disconnect device using public address)
> disconnect 00:11:22:33:44:55
مثال قطع اتصال دستگاهی دیگر (Example Disconnect another device)
> disconnect AA:BB:CC:DD:EE:FF
مثال قطع اتصال دستگاه با نوع نشانی عمومی (Example Disconnect device with public address type)
> disconnect -t public 00:11:22:33:44:55
مثال قطع اتصال دستگاه با نوع نشانی تصادفی (Example Disconnect device with random address type)
> disconnect -t random AA:BB:CC:DD:EE:FF
مثال قطع اتصال دستگاه LE با نشانی عمومی (Example Disconnect LE device with public address)
> disconnect -t le_public 11:22:33:44:55:66
مثال قطع اتصال دستگاه LE با نشانی تصادفی (Example Disconnect LE device with random address)
> disconnect -t le_random CC:DD:EE:FF:00:11

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

کاربرد (Usage)
> con
مثال فهرست کردن همه اتصال‌های فعال (Example List all active connections)
> con

کشف دستگاه‌های نزدیک.

کاربرد (Usage)
> find [-l|-b] [-L]
[-l|-b]
نوع کشف - "-l" فقط برای LE،‏ "-b" فقط برای BR/EDR (پیش‌فرض: هر دو)
[-L]
پرچم حالت کشف محدود
مثال کشف هم‌زمان دستگاه‌های LE و BR/EDR (Example Discover both LE and BR/EDR devices)
> find
مثال کشف فقط دستگاه‌های LE (Example Discover LE devices only)
> find -l
مثال کشف فقط دستگاه‌های BR/EDR (Example Discover BR/EDR devices only)
> find -b
مثال کشف دستگاه‌ها در حالت محدود (Example Discover devices in limited mode)
> find -L
مثال کشف دستگاه‌های LE در حالت محدود (Example Discover LE devices in limited mode)
> find -l -L
مثال کشف دستگاه‌های BR/EDR در حالت محدود (Example Discover BR/EDR devices in limited mode)
> find -b -L

کشف سرویس‌های نزدیک.

کاربرد (Usage)
> find-service [-u UUID] [-r RSSI_Threshold] [-l|-b]
[-u UUID]
شناسه یکتای سرویس (UUID) برای جست‌وجو (16 بیتی، 32 بیتی یا 128 بیتی)
[-r RSSI_Threshold]
حداقل مقدار RSSI بر حسب dBm برای پالایش دستگاه‌ها
[-l|-b]
نوع کشف - "-l" فقط برای LE،‏ "-b" فقط برای BR/EDR
مثال یافتن دستگاه‌ها با سرویس Generic Access (Example Find devices with Generic Access service)
> find-service -u 0x1800
مثال یافتن دستگاه‌ها با سرویس Battery Service (Example Find devices with Battery Service)
> find-service -u 0x180F
مثال یافتن دستگاه‌ها با سرویس سفارشی (Example Find devices with custom service)
> find-service -u 12345678-1234-5678-9abc-123456789abc
مثال یافتن دستگاه‌ها با RSSI ≥ -60 dBm (Example Find devices with RSSI ≥ -60 dBm)
> find-service -r -60
مثال یافتن دستگاه‌ها با RSSI ≥ -80 dBm (Example Find devices with RSSI ≥ -80 dBm)
> find-service -r -80
مثال یافتن دستگاه‌های دارای Battery Service با RSSI ≥ -70 dBm (Example Find Battery Service devices with RSSI ≥ -70 dBm)
> find-service -u 0x180F -r -70
مثال یافتن Generic Access روی دستگاه‌های LE با سیگنال قوی (Example Find Generic Access on LE devices with strong signal)
> find-service -u 0x1800 -r -50 -l
مثال یافتن Serial Port Profile روی دستگاه‌های BR/EDR (Example Find Serial Port Profile on BR/EDR devices)
> find-service -u 0x1101 -b
مثال یافتن Battery Service روی دستگاه‌های LE (Example Find Battery Service on LE devices)
> find-service -u 0x180F -l

توقف کشف.

کاربرد (Usage)
> stop-find [-l|-b]
[-l|-b]
نوع کشف برای متوقف ساختن - "-l" فقط برای LE،‏ "-b" فقط برای BR/EDR (پیش‌فرض: همه)
مثال توقف همه عملیات کشف (Example Stop all discovery)
> stop-find
مثال توقف فقط کشف LE (Example Stop LE discovery only)
> stop-find -l
مثال توقف فقط کشف BR/EDR (Example Stop BR/EDR discovery only)
> stop-find -b

تنظیم نام محلی

کاربرد (Usage)
> name <name> [shortname]
<name>
نام محلی کامل برای کنترل‌کننده
[shortname]
نام محلی کوتاه اختیاری
مثال تنظیم نام محلی کامل (Example Set complete local name)
> name "My Bluetooth Device"
مثال تنظیم نام بدون فاصله (Example Set name without spaces)
> name MyComputer
مثال تنظیم نام با خط پیوند (Example Set name with hyphens)
> name "Home-Office-PC"
مثال تنظیم هر دو نام کامل و کوتاه (Example Set both complete and shortened names)
> name "My Long Device Name" MyDevice
مثال تنظیم نام‌های توصیفی و کوتاه (Example Set descriptive and short names)
> name "Professional Workstation" ProWork
مثال تنظیم نام‌های دستگاه صوتی (Example Set audio device names)
> name "Bluetooth Audio Headset" BT-Audio

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

کاربرد (Usage)
> pair [-c cap] [-t type] <remote address>
[-c cap]
قابلیت ورودی/خروجی (DisplayOnly، DisplayYesNo، KeyboardOnly، NoInputNoOutput، KeyboardDisplay)
[-t type]
نوع نشانی (public، random، le_public، le_random)
<remote address>
نشانی بلوتوث دستگاه برای جفت‌سازی با آن
مثال جفت‌سازی با دستگاه با استفاده از تنظیمات پیش‌فرض (Example Pair with device using default settings)
> pair 00:11:22:33:44:55
مثال جفت‌سازی با دستگاهی دیگر (Example Pair with another device)
> pair AA:BB:CC:DD:EE:FF
مثال جفت‌سازی با قابلیت ورودی/خروجی فقط نمایشگر (Example Pair with display-only IO capability)
> pair -c DisplayOnly 00:11:22:33:44:55
مثال جفت‌سازی با قابلیت نمایشگر و بله/خیر (Example Pair with display and yes/no capability)
> pair -c DisplayYesNo AA:BB:CC:DD:EE:FF
مثال جفت‌سازی با قابلیت فقط صفحه‌کلید (Example Pair with keyboard-only capability)
> pair -c KeyboardOnly 11:22:33:44:55:66
مثال جفت‌سازی بدون قابلیت ورودی/خروجی (Example Pair with no I/O capability)
> pair -c NoInputNoOutput CC:DD:EE:FF:00:11
مثال جفت‌سازی با قابلیت صفحه‌کلید و نمایشگر (Example Pair with keyboard and display capability)
> pair -c KeyboardDisplay 22:33:44:55:66:77
مثال جفت‌سازی با دستگاه دارای نشانی عمومی (Example Pair with public address device)
> pair -t public 00:11:22:33:44:55
مثال جفت‌سازی با دستگاه دارای نشانی تصادفی (Example Pair with random address device)
> pair -t random AA:BB:CC:DD:EE:FF
مثال جفت‌سازی با دستگاه LE دارای نشانی عمومی (Example Pair with LE public address device)
> pair -t le_public 11:22:33:44:55:66
مثال جفت‌سازی با دستگاه LE دارای نشانی تصادفی (Example Pair with LE random address device)
> pair -t le_random CC:DD:EE:FF:00:11
مثال جفت‌سازی دستگاه LE با قابلیت صفحه‌کلید/نمایشگر (Example Pair LE device with keyboard/display capability)
> pair -c KeyboardDisplay -t le_public 00:11:22:33:44:55
مثال جفت‌سازی دستگاه دارای نشانی تصادفی با قابلیت نمایشگر/بله-خیر (Example Pair random address device with display/yes-no capability)
> pair -c DisplayYesNo -t random AA:BB:CC:DD:EE:FF

لغو جفت‌سازی

کاربرد (Usage)
> cancelpair [-t type] <remote address>
[-t type]
نوع نشانی (public، random، le_public، le_random)
<remote address>
نشانی بلوتوث دستگاه برای لغو جفت‌سازی با آن
مثال لغو جفت‌سازی در حال انجام با دستگاه (Example Cancel ongoing pairing with device)
> cancelpair 00:11:22:33:44:55
مثال لغو جفت‌سازی با دستگاهی دیگر (Example Cancel pairing with another device)
> cancelpair AA:BB:CC:DD:EE:FF
مثال لغو جفت‌سازی با دستگاه دارای نشانی عمومی (Example Cancel pairing with public address device)
> cancelpair -t public 00:11:22:33:44:55
مثال لغو جفت‌سازی با دستگاه LE دارای نشانی تصادفی (Example Cancel pairing with LE random address device)
> cancelpair -t le_random AA:BB:CC:DD:EE:FF

لغو جفت‌سازی دستگاه

کاربرد (Usage)
> unpair [-t type] <remote address>
[-t type]
نوع نشانی (public، random، le_public، le_random)
<remote address>
نشانی بلوتوث دستگاه جهت لغو جفت‌سازی
مثال حذف جفت‌سازی با دستگاه (Example Remove pairing with device)
> unpair 00:11:22:33:44:55
مثال حذف جفت‌سازی با دستگاهی دیگر (Example Remove pairing with another device)
> unpair AA:BB:CC:DD:EE:FF
مثال لغو جفت‌سازی دستگاه با نشانی عمومی (Example Unpair public address device)
> unpair -t public 00:11:22:33:44:55
مثال لغو جفت‌سازی دستگاه با نشانی عمومی LE (Example Unpair LE public address device)
> unpair -t le_public 11:22:33:44:55:66
مثال لغو جفت‌سازی دستگاه با نشانی تصادفی LE (Example Unpair LE random address device)
> unpair -t le_random CC:DD:EE:FF:00:11

بارگذاری کلیدهای پیوند

کاربرد (Usage)
> keys
مثال بارگذاری کلیدهای پیوند ذخیره‌شده (Example Load stored link keys)
> keys

بارگذاری کلیدهای بلندمدت

کاربرد (Usage)
> ltks
مثال بارگذاری کلیدهای بلندمدت ذخیره‌شده LE (Example Load stored LE long term keys)
> ltks

بارگذاری کلیدهای حل هویت

کاربرد (Usage)
> irks [--local index] [--file file path]
[--local index]
شناسه کنترل‌کننده محلی جهت استفاده
[--file file path]
مسیر پرونده پیکربندی سفارشی IRK
مثال بارگذاری IRKها با شناسه محلی و پرونده پیش‌فرض (Example Load IRKs with default local index and file)
> irks
مثال بارگذاری IRKها برای شناسه کنترل‌کننده 0 (Example Load IRKs for controller index 0)
> irks --local 0
مثال بارگذاری IRKها برای شناسه کنترل‌کننده 1 (Example Load IRKs for controller index 1)
> irks --local 1
مثال بارگذاری IRKها از پرونده پیکربندی سفارشی (Example Load IRKs from custom configuration file)
> irks --file /etc/bluetooth/irks.conf
مثال بارگذاری IRKها از پرونده کاربر (Example Load IRKs from user file)
> irks --file /home/user/bluetooth_irks.txt
مثال بارگذاری IRKها برای hci0 از پرونده مشخص (Example Load IRKs for hci0 from specific file)
> irks --local 0 --file /etc/bluetooth/hci0_irks.conf

مسدودسازی دستگاه

کاربرد (Usage)
> block [-t type] <remote address>
[-t type]
نوع نشانی (public، random، le_public، le_random)
<remote address>
نشانی بلوتوث دستگاه جهت مسدود کردن
مثال مسدود کردن دستگاه با استفاده از نوع نشانی پیش‌فرض (Example Block device using default address type)
> block 00:11:22:33:44:55
مثال مسدود کردن دستگاهی دیگر (Example Block another device)
> block AA:BB:CC:DD:EE:FF
مثال مسدود کردن دستگاه با نشانی عمومی (Example Block device with public address)
> block -t public 00:11:22:33:44:55
مثال مسدود کردن دستگاه با نشانی تصادفی (Example Block device with random address)
> block -t random AA:BB:CC:DD:EE:FF
مثال مسدود کردن دستگاه LE با نشانی عمومی (Example Block LE device with public address)
> block -t le_public 11:22:33:44:55:66
مثال مسدود کردن دستگاه LE با نشانی تصادفی (Example Block LE device with random address)
> block -t le_random CC:DD:EE:FF:00:11

رفع مسدودیت دستگاه

کاربرد (Usage)
> unblock [-t type] <remote address>
[-t type]
نوع نشانی (public، random، le_public، le_random)
<remote address>
نشانی بلوتوث دستگاه جهت رفع مسدودیت
مثال رفع مسدودیت دستگاه با استفاده از نوع نشانی پیش‌فرض (Example Unblock device using default address type)
> unblock 00:11:22:33:44:55
مثال رفع مسدودیت دستگاهی دیگر (Example Unblock another device)
> unblock AA:BB:CC:DD:EE:FF
مثال رفع مسدودیت دستگاه با نشانی عمومی (Example Unblock device with public address)
> unblock -t public 00:11:22:33:44:55
مثال رفع مسدودیت دستگاه با نشانی تصادفی (Example Unblock device with random address)
> unblock -t random AA:BB:CC:DD:EE:FF
مثال رفع مسدودیت دستگاه LE با نشانی عمومی (Example Unblock LE device with public address)
> unblock -t le_public 11:22:33:44:55:66
مثال رفع مسدودیت دستگاه LE با نشانی تصادفی (Example Unblock LE device with random address)
> unblock -t le_random CC:DD:EE:FF:00:11

افزودن UUID

کاربرد (Usage)
> add-uuid <UUID> <service class hint>
<UUID>
شناسه یکتای سرویس (قالب ۱۶-بیتی، ۳۲-بیتی یا ۱۲۸-بیتی)
<service class hint>
بیت‌ماسک راهنمای رده سرویس (هگزادسیمال)
مثال افزودن Serial Port Profile همراه با راهنمای انتقال شیء (Example Add Serial Port Profile with object transfer hint)
> add-uuid 0x1101 0x100000
مثال افزودن A2DP همراه با راهنمای صوتی (Example Add A2DP with audio hint)
> add-uuid 0x110E 0x200000
مثال افزودن HFP همراه با راهنمای صوتی (Example Add HFP with audio hint)
> add-uuid 0x111E 0x200000
مثال افزودن UUID سرویس سفارشی بدون راهنما (Example Add custom service UUID with no hint)
> add-uuid 12345678-1234-5678-9abc-123456789abc 0x000000
مثال افزودن UUID سفارشی همراه با راهنمای انتقال شیء (Example Add custom UUID with object transfer hint)
> add-uuid ABCD1234-ABCD-1234-ABCD-123456789ABC 0x100000
مثال افزودن Generic Access بدون راهنمای مشخص (Example Add Generic Access with no specific hint)
> add-uuid 0x1800 0x000000
مثال افزودن Battery Service بدون راهنما (Example Add Battery Service with no hint)
> add-uuid 0x180F 0x000000

حذف UUID

کاربرد (Usage)
> rm-uuid <UUID>
<UUID>
شناسه یکتای سرویس جهت حذف (قالب ۱۶-بیتی، ۳۲-بیتی، یا ۱۲۸-بیتی)
مثال حذف UUID مربوط به Serial Port Profile (Example Remove Serial Port Profile UUID)
> rm-uuid 0x1101
مثال حذف UUID مربوط به A2DP (Example Remove A2DP UUID)
> rm-uuid 0x110E
مثال حذف UUID سرویس سفارشی (Example Remove custom service UUID)
> rm-uuid 12345678-1234-5678-9abc-123456789abc

پاک‌سازی UUIDها

کاربرد (Usage)
> clr-uuids
مثال پاک‌سازی تمام UUIDهای ثبت‌شده (Example Clear all registered UUIDs)
> clr-uuids

داده‌های محلی OOB

کاربرد (Usage)
> local-oob
مثال تولید و نمایش داده‌های احراز هویت محلی OOB (Example Generate and display local OOB authentication data)
> local-oob

داده‌های OOB دوردست

کاربرد (Usage)
> remote-oob [-t <addr_type>] [-r <rand192>] [-h <hash192>] [-R <rand256>] [-H <hash256>] <addr>
[-t <addr_type>]
نوع نشانی (public، random، le_public، le_random)
[-r <rand192>]
مقدار تصادفی P-192 (۳۲ نویسه هگزادسیمال)
[-h <hash192>]
مقدار درهم‌سازی P-192 (۳۲ نویسه هگزادسیمال)
[-R <rand256>]
مقدار تصادفی P-256 (۶۴ نویسه هگزادسیمال)
[-H <hash256>]
مقدار درهم‌سازی P-256 (۶۴ نویسه هگزادسیمال)
<addr>
نشانی بلوتوث دستگاه دوردست
مثال تنظیم داده‌های OOB دوردست برای دستگاه (کمینه) (Example Set remote OOB data for device (minimal))
> remote-oob 00:11:22:33:44:55
مثال تنظیم مقادیر تصادفی و درهم‌سازی P-192 (Example Set P-192 random and hash values)
> remote-oob -r 0123456789abcdef0123456789abcdef -h fedcba9876543210fedcba9876543210 00:11:22:33:44:55
مثال تنظیم مقادیر تصادفی و درهم‌سازی P-256 (Example Set P-256 random and hash values)
> remote-oob -R 0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef -H fedcba9876543210fedcba9876543210fedcba9876543210fedcba9876543210 AA:BB:CC:DD:EE:FF
مثال تنظیم داده‌های OOB برای دستگاه با نشانی عمومی LE (Example Set OOB data for LE public address device)
> remote-oob -t le_public 11:22:33:44:55:66
مثال تنظیم داده‌های OOB برای دستگاه با نشانی تصادفی LE (Example Set OOB data for LE random address device)
> remote-oob -t le_random CC:DD:EE:FF:00:11
مثال تنظیم داده‌های کامل OOB به همراه هر دو مقدار P-192 و P-256 (Example Set complete OOB data with both P-192 and P-256 values)
> remote-oob -t public -r 0123456789abcdef0123456789abcdef -h fedcba9876543210fedcba9876543210 -R 0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef -H fedcba9876543210fedcba9876543210fedcba9876543210fedcba9876543210 00:11:22:33:44:55

تنظیم شناسه دستگاه (Device ID)

کاربرد (Usage)
> did <source>:<vendor>:<product>:<version>
<source>:<vendor>:<product>:<version>
شناسه دستگاه در قالب source:vendor:product:version (همگی هگزادسیمال)
مثال تنظیم منبع USB با شناسه سازنده Linux Foundation (Example Set USB source with Linux Foundation vendor ID)
> did 0x0002:0x1D6B:0x0001:0x0100
مثال تنظیم دستگاه USB با شناسه سازنده Cypress (Example Set USB device with Cypress vendor ID)
> did 0x0002:0x04B4:0x1234:0x0200
مثال تنظیم منبع Bluetooth SIG با سازنده Broadcom (Example Set Bluetooth SIG source with Broadcom vendor)
> did 0x0001:0x000F:0x0001:0x0100
مثال تنظیم منبع Bluetooth SIG با سازنده Apple (Example Set Bluetooth SIG source with Apple vendor)
> did 0x0001:0x004C:0x0001:0x0100
مثال تنظیم شناسه سفارشی دستگاه USB (Example Set custom USB device ID)
> did 0x0002:0xFFFF:0x1234:0x5678
مثال تنظیم دستگاه بلوتوث Qualcomm (Example Set Qualcomm Bluetooth device)
> did 0x0001:0x05F1:0xABCD:0x0001

تنظیم نشانی ایستا

کاربرد (Usage)
> static-addr <address>
<address>
نشانی تصادفی ایستای بلوتوث (بیت‌های ۴۷-۴۶ باید روی ۱۱ تنظیم شده باشند)
مثال تنظیم نشانی تصادفی ایستا (بیت ۴۷=۱، بیت ۴۶=۱) (Example Set static random address (bit 47=1, bit 46=1))
> static-addr C0:00:00:00:00:01
مثال تنظیم یک نشانی تصادفی ایستای دیگر (Example Set another static random address)
> static-addr D0:11:22:33:44:55
مثال تنظیم نشانی ایستای متفاوت (Example Set different static address)
> static-addr E0:AA:BB:CC:DD:EE

تنظیم نشانی عمومی

کاربرد (Usage)
> public-addr <address>
<address>
نشانی عمومی بلوتوث برای تنظیم روی کنترل‌کننده
مثال تنظیم نشانی عمومی بلوتوث (Example Set public Bluetooth address)
> public-addr 00:11:22:33:44:55
مثال تنظیم نشانی عمومی متفاوت (Example Set different public address)
> public-addr AA:BB:CC:DD:EE:FF
مثال تنظیم نشانی عمومی سفارشی (Example Set custom public address)
> public-addr 12:34:56:78:9A:BC

پیکربندی خارجی

کاربرد (Usage)
> ext-config <on/off>
<on/off>
پیکربندی خارجی - "on" برای فعال‌سازی پیکربندی خارجی، "off" برای غیرفعال‌سازی
مثال فعال‌سازی پیکربندی خارجی (Example Enable external configuration)
> ext-config on
مثال غیرفعال‌سازی پیکربندی خارجی (Example Disable external configuration)
> ext-config off

تغییر وضعیت کلیدهای اشکال‌زدایی

کاربرد (Usage)
> debug-keys <on/off>
<on/off>
پشتیبانی از کلیدهای اشکال‌زدایی - "on" برای فعال‌سازی کلیدهای اشکال‌زدایی، "off" برای غیرفعال‌سازی
مثال فعال‌سازی پشتیبانی از کلید اشکال‌زدایی (Example Enable debug key support)
> debug-keys on
مثال غیرفعال‌سازی پشتیبانی از کلید اشکال‌زدایی (Example Disable debug key support)
> debug-keys off

دریافت اطلاعات اتصال

کاربرد (Usage)
> conn-info [-t type] <remote address>
[-t type]
نوع نشانی (public، random، le_public، le_random)
<remote address>
نشانی بلوتوث دستگاه متصل
مثال دریافت اطلاعات اتصال برای دستگاه (Example Get connection information for device)
> conn-info 00:11:22:33:44:55
مثال دریافت اطلاعات برای دستگاهی دیگر (Example Get info for another device)
> conn-info AA:BB:CC:DD:EE:FF
مثال دریافت اطلاعات برای دستگاه با نشانی عمومی (Example Get info for public address device)
> conn-info -t public 00:11:22:33:44:55
مثال دریافت اطلاعات برای دستگاه با نشانی عمومی LE (Example Get info for LE public address device)
> conn-info -t le_public 11:22:33:44:55:66
مثال دریافت اطلاعات برای دستگاه با نشانی تصادفی LE (Example Get info for LE random address device)
> conn-info -t le_random CC:DD:EE:FF:00:11

تنظیم قابلیت ورودی/خروجی (IO Capability)

کاربرد (Usage)
> io-cap <cap>
<cap>
قابلیت ورودی/خروجی (DisplayOnly، DisplayYesNo، KeyboardOnly، NoInputNoOutput، KeyboardDisplay)
مثال تنظیم قابلیت ورودی/خروجی روی فقط نمایشگر (Example Set IO capability to display only)
> io-cap DisplayOnly
مثال تنظیم قابلیت ورودی/خروجی روی نمایشگر با بله/خیر (Example Set IO capability to display with yes/no)
> io-cap DisplayYesNo
مثال تنظیم قابلیت ورودی/خروجی روی فقط صفحه‌کلید (Example Set IO capability to keyboard only)
> io-cap KeyboardOnly
مثال تنظیم قابلیت ورودی/خروجی روی بدون ورودی و خروجی (Example Set IO capability to no input/output)
> io-cap NoInputNoOutput
مثال تنظیم قابلیت ورودی/خروجی روی صفحه‌کلید و نمایشگر (Example Set IO capability to keyboard and display)
> io-cap KeyboardDisplay

تنظیم پارامترهای پویش

کاربرد (Usage)
> scan-params <interval> <window>
<interval>
بازه زمانی پویش به هگزادسیمال (0x0004 تا 0x4000، با واحدهای ۰٫۶۲۵ میلی‌ثانیه)
<window>
پنجره پویش به هگزادسیمال (0x0004 تا 0x4000، با واحدهای ۰٫۶۲۵ میلی‌ثانیه)
مثال تنظیم پویش سریع (بازه ۱۶ میلی‌ثانیه، پنجره ۱۶ میلی‌ثانیه) (Example Set fast scan (16ms interval, 16ms window))
> scan-params 0x0010 0x0010
مثال تنظیم پویش با سرعت متوسط (بازه ۳۲ میلی‌ثانیه، پنجره ۳۲ میلی‌ثانیه) (Example Set moderate fast scan (32ms interval, 32ms window))
> scan-params 0x0020 0x0020
مثال تنظیم پویش متوازن (بازه ۹۶ میلی‌ثانیه، پنجره ۴۸ میلی‌ثانیه) (Example Set balanced scan (96ms interval, 48ms window))
> scan-params 0x0060 0x0030
مثال تنظیم پویش آهسته (بازه ۲۵۶ میلی‌ثانیه، پنجره ۸۰ میلی‌ثانیه) (Example Set slow scan (256ms interval, 80ms window))
> scan-params 0x0100 0x0050
مثال تنظیم پویش پس‌زمینه (بازه ۲٫۵۶ ثانیه، پنجره ۱۸ میلی‌ثانیه) (Example Set background scan (2.56s interval, 18ms window))
> scan-params 0x0800 0x0012
مثال تنظیم پویش پس‌زمینه بسیار آهسته (Example Set very slow background scan)
> scan-params 0x1000 0x0020

دریافت اطلاعات ساعت

کاربرد (Usage)
> get-clock [address]
[address]
نشانی بلوتوث اختیاری دستگاه دوردست (برای ساعت محلی نادیده گرفته شود)
مثال دریافت اطلاعات ساعت بلوتوث محلی (Example Get local Bluetooth clock information)
> get-clock
مثال دریافت اطلاعات ساعت برای دستگاه دوردست (Example Get clock information for remote device)
> get-clock 00:11:22:33:44:55
مثال دریافت ساعت برای یک دستگاه دوردست دیگر (Example Get clock for another remote device)
> get-clock AA:BB:CC:DD:EE:FF

افزودن دستگاه

کاربرد (Usage)
> add-device [-a action] [-t type] <address>
[-a action]
کنش دستگاه (auto، allow، deny) - "auto" برای اتصال خودکار، "allow" برای فقط مجاز، "deny" برای مسدودسازی
[-t type]
نوع نشانی (public، random، le_public، le_random)
<address>
نشانی بلوتوث دستگاه مورد نظر برای افزودن
مثال افزودن دستگاه با کنش اتصال خودکار و نوع پیش‌فرض (Example Add device with auto-connect action and default type)
> add-device 00:11:22:33:44:55
مثال افزودن دستگاهی دیگر با مقادیر پیش‌فرض (Example Add another device with defaults)
> add-device AA:BB:CC:DD:EE:FF
مثال افزودن دستگاه با کنش اتصال خودکار (Example Add device with auto-connect action)
> add-device -a auto 00:11:22:33:44:55
مثال افزودن دستگاه با کنش فقط مجاز (بدون اتصال خودکار) (Example Add device with allow-only action (no auto-connect))
> add-device -a allow 11:22:33:44:55:66
مثال افزودن دستگاه با کنش منع (مسدودشده) (Example Add device with deny action (blocked))
> add-device -a deny CC:DD:EE:FF:00:11
مثال افزودن دستگاه با نوع نشانی عمومی (Example Add device with public address type)
> add-device -t public 00:11:22:33:44:55
مثال افزودن دستگاه با نوع نشانی تصادفی (Example Add device with random address type)
> add-device -t random AA:BB:CC:DD:EE:FF
مثال افزودن دستگاه LE با نشانی عمومی (Example Add LE device with public address)
> add-device -t le_public 11:22:33:44:55:66
مثال افزودن دستگاه LE با نشانی تصادفی (Example Add LE device with random address)
> add-device -t le_random CC:DD:EE:FF:00:11
مثال افزودن دستگاه عمومی LE با اتصال خودکار (Example Add LE public device with auto-connect)
> add-device -a auto -t le_public 00:11:22:33:44:55
مثال افزودن دستگاه با نشانی تصادفی و کنش مجاز (Example Add random address device with allow action)
> add-device -a allow -t random AA:BB:CC:DD:EE:FF
مثال افزودن دستگاه تصادفی LE با کنش منع (Example Add LE random device with deny action)
> add-device -a deny -t le_random CC:DD:EE:FF:00:11

حذف دستگاه

کاربرد (Usage)
> del-device [-t type] <address>
[-t type]
نوع نشانی (public، random، le_public، le_random)
<address>
نشانی بلوتوث دستگاه مورد نظر برای حذف
مثال حذف دستگاه با استفاده از نوع نشانی پیش‌فرض (Example Remove device using default address type)
> del-device 00:11:22:33:44:55
مثال حذف دستگاهی دیگر (Example Remove another device)
> del-device AA:BB:CC:DD:EE:FF
مثال حذف دستگاه با نوع نشانی عمومی (Example Remove device with public address type)
> del-device -t public 00:11:22:33:44:55
مثال حذف دستگاه با نوع نشانی تصادفی (Example Remove device with random address type)
> del-device -t random AA:BB:CC:DD:EE:FF
مثال حذف دستگاه LE با نشانی عمومی (Example Remove LE device with public address)
> del-device -t le_public 11:22:33:44:55:66
مثال حذف دستگاه LE با نشانی تصادفی (Example Remove LE device with random address)
> del-device -t le_random CC:DD:EE:FF:00:11

پاک‌سازی دستگاه‌ها

کاربرد (Usage)
> clr-devices
مثال پاک‌سازی همه دستگاه‌ها از فهرست دستگاه‌ها (Example Clear all devices from the device list)
> clr-devices

داده‌های محلی OOB (BR/EDR)

کاربرد (Usage)
> bredr-oob
مثال تولید و نمایش داده‌های احراز هویت محلی OOB برای BR/EDR (Example Generate and display local BR/EDR OOB authentication data)
> bredr-oob

داده‌های محلی OOB (LE)

کاربرد (Usage)
> le-oob
مثال تولید و نمایش داده‌های احراز هویت محلی OOB برای LE (Example Generate and display local LE OOB authentication data)
> le-oob

نمایش قابلیت‌های تبلیغ

کاربرد (Usage)
> advinfo
مثال نمایش قابلیت‌های تبلیغ و ویژگی‌های پشتیبانی‌شده (Example Display advertising capabilities and supported features)
> advinfo

نمایش اطلاعات اندازه تبلیغ

کاربرد (Usage)
> advsize [options] <instance_id>
[options]
پرچم‌های گزینه‌های تبلیغ
<instance_id>
شناسه نمونه تبلیغ (مبتنی بر صفر)
مثال نمایش اطلاعات اندازه داده‌های تبلیغ برای نمونه 0 (Example Show advertising data size information for instance 0)
> advsize 0
مثال نمایش اطلاعات اندازه برای نمونه تبلیغ 1 (Example Show size information for advertising instance 1)
> advsize 1
مثال نمایش اطلاعات اندازه برای نمونه تبلیغ 5 (Example Show size information for advertising instance 5)
> advsize 5

افزودن نمونه تبلیغ

کاربرد (Usage)
> add-adv [options] <instance_id>
[options]
گزینه‌های تبلیغ (-c اتصال‌پذیر، -s پویش‌پذیر، -g کشف‌پذیر عمومی، -l کشف‌پذیر محدود، -m پرچم‌های مدیریت‌شده، -p توان ارسال TX)
<instance_id>
شناسه نمونه تبلیغ (مبتنی بر صفر)
مثال افزودن نمونه تبلیغ 0 با تنظیمات پیش‌فرض (Example Add advertising instance 0 with default settings)
> add-adv 0
مثال افزودن نمونه تبلیغ 1 (Example Add advertising instance 1)
> add-adv 1
مثال افزودن نمونه تبلیغ 5 (Example Add advertising instance 5)
> add-adv 5
مثال افزودن نمونه تبلیغ اتصال‌پذیر 0 (Example Add connectable advertising instance 0)
> add-adv -c 0
مثال افزودن نمونه تبلیغ پویش‌پذیر 1 (Example Add scannable advertising instance 1)
> add-adv -s 1
مثال افزودن نمونه تبلیغ با کشف‌پذیری عمومی 2 (Example Add general discoverable advertising instance 2)
> add-adv -g 2
مثال افزودن نمونه تبلیغ با کشف‌پذیری محدود 3 (Example Add limited discoverable advertising instance 3)
> add-adv -l 3
مثال افزودن نمونه تبلیغ با پرچم‌های مدیریت‌شده 4 (Example Add managed flags advertising instance 4)
> add-adv -m 4
مثال افزودن نمونه تبلیغ با توان ارسال 5 (Example Add TX power advertising instance 5)
> add-adv -p 5
مثال افزودن نمونه تبلیغ اتصال‌پذیر و پویش‌پذیر (Example Add connectable and scannable advertising instance)
> add-adv -c -s 0
مثال افزودن با کشف‌پذیری عمومی به همراه توان ارسال TX (Example Add general discoverable with TX power)
> add-adv -g -p 1
مثال افزودن اتصال‌پذیر، کشف‌پذیر عمومی و پویش‌پذیر (Example Add connectable, general discoverable, and scannable)
> add-adv -c -g -s 2

حذف نمونه تبلیغ (Remove advertising instance)

کاربرد (Usage)
> rm-adv <instance_id>
<instance_id>
شناسه نمونه تبلیغ (مبتنی بر صفر) برای حذف
مثال حذف نمونه تبلیغ 0 (Example Remove advertising instance 0)
> rm-adv 0
مثال حذف نمونه تبلیغ 1 (Example Remove advertising instance 1)
> rm-adv 1
مثال حذف نمونه تبلیغ 5 (Example Remove advertising instance 5)
> rm-adv 5

پاک‌سازی نمونه‌های تبلیغ (Clear advertising instances)

کاربرد (Usage)
> clr-adv
مثال پاک‌سازی همه نمونه‌های تبلیغ (Example Clear all advertising instances)
> clr-adv

افزودن پارامترهای تبلیغ گسترش‌یافته (Add extended advertising params)

کاربرد (Usage)
> add-ext-adv-params [options] <instance_id>
[options]
گزینه‌های تبلیغ گسترش‌یافته (-c اتصال‌پذیر، -s پویش‌پذیر، -d هدایت‌شده، -h چرخه کاری بالا، -l بسته PDU سنتی، -a ناشناس، -i شامل توان ارسال TX)
<instance_id>
شناسه نمونه تبلیغ گسترش‌یافته (مبتنی بر صفر)
مثال افزودن پارامترهای تبلیغ گسترش‌یافته برای نمونه 0 (Example Add extended advertising parameters for instance 0)
> add-ext-adv-params 0
مثال افزودن پارامترهای تبلیغ گسترش‌یافته برای نمونه 1 (Example Add extended advertising parameters for instance 1)
> add-ext-adv-params 1
مثال افزودن تبلیغ گسترش‌یافته اتصال‌پذیر برای نمونه 0 (Example Add connectable extended advertising for instance 0)
> add-ext-adv-params -c 0
مثال افزودن تبلیغ گسترش‌یافته پویش‌پذیر برای نمونه 1 (Example Add scannable extended advertising for instance 1)
> add-ext-adv-params -s 1
مثال افزودن تبلیغ گسترش‌یافته هدایت‌شده برای نمونه 2 (Example Add directed extended advertising for instance 2)
> add-ext-adv-params -d 2
مثال افزودن تبلیغ گسترش‌یافته با چرخه کاری بالا برای نمونه 3 (Example Add high duty cycle extended advertising for instance 3)
> add-ext-adv-params -h 3
مثال افزودن تبلیغ گسترش‌یافته با PDU سنتی برای نمونه 4 (Example Add legacy PDU extended advertising for instance 4)
> add-ext-adv-params -l 4
مثال افزودن تبلیغ گسترش‌یافته ناشناس برای نمونه 5 (Example Add anonymous extended advertising for instance 5)
> add-ext-adv-params -a 5
مثال افزودن تبلیغ گسترش‌یافته شامل توان TX برای نمونه 6 (Example Add include TX power extended advertising for instance 6)
> add-ext-adv-params -i 6
مثال افزودن تبلیغ گسترش‌یافته اتصال‌پذیر و پویش‌پذیر (Example Add connectable and scannable extended advertising)
> add-ext-adv-params -c -s 0
مثال افزودن تبلیغ گسترش‌یافته اتصال‌پذیر همراه با توان TX (Example Add connectable extended advertising with TX power)
> add-ext-adv-params -c -i 1
مثال افزودن تبلیغ گسترش‌یافته پویش‌پذیر با PDU سنتی (Example Add scannable legacy PDU extended advertising)
> add-ext-adv-params -s -l 2

افزودن داده‌های تبلیغ گسترش‌یافته (Add extended advertising data)

کاربرد (Usage)
> add-ext-adv-data [options] <instance_id>
[options]
گزینه‌های داده (-s برای داده‌های پاسخ پویش، -c برای داده‌های کامل)
<instance_id>
شناسه نمونه تبلیغ گسترش‌یافته (مبتنی بر صفر)
مثال افزودن داده‌های تبلیغ به نمونه گسترش‌یافته 0 (Example Add advertising data to extended instance 0)
> add-ext-adv-data 0
مثال افزودن داده‌های تبلیغ به نمونه گسترش‌یافته 1 (Example Add advertising data to extended instance 1)
> add-ext-adv-data 1
مثال افزودن داده‌های پاسخ پویش به نمونه گسترش‌یافته 0 (Example Add scan response data to extended instance 0)
> add-ext-adv-data -s 0
مثال افزودن داده‌های پاسخ پویش به نمونه گسترش‌یافته 1 (Example Add scan response data to extended instance 1)
> add-ext-adv-data -s 1
مثال افزودن داده‌های کامل تبلیغ به نمونه 0 (Example Add complete advertising data to instance 0)
> add-ext-adv-data -c 0
مثال افزودن داده‌های کامل پاسخ پویش به نمونه 1 (Example Add complete scan response data to instance 1)
> add-ext-adv-data -c -s 1

تنظیم ظاهر

کاربرد (Usage)
> appearance <appearance>
<appearance>
مقدار ظاهر (عدد صحیح ۱۶-بیتی) بیانگر نوع دستگاه
مثال تنظیم ظاهر روی ناشناخته (Example Set appearance to Unknown)
> appearance 0
مثال تنظیم ظاهر روی تلفن عمومی (Example Set appearance to Generic Phone)
> appearance 64
مثال تنظیم ظاهر روی رایانه عمومی (Example Set appearance to Generic Computer)
> appearance 128
مثال تنظیم ظاهر روی دستگاه صوتی/تصویری عمومی (Example Set appearance to Generic Audio/Video device)
> appearance 832
مثال تنظیم ظاهر روی بلندگو (Example Set appearance to Speaker)
> appearance 833
مثال تنظیم ظاهر روی میکروفون (Example Set appearance to Microphone)
> appearance 834
مثال تنظیم ظاهر روی هدست (Example Set appearance to Headset)
> appearance 835
مثال تنظیم ظاهر روی هدفون (Example Set appearance to Headphones)
> appearance 836
مثال تنظیم ظاهر روی HID عمومی (Example Set appearance to Generic HID)
> appearance 960
مثال تنظیم ظاهر روی صفحه‌کلید (Example Set appearance to Keyboard)
> appearance 961
مثال تنظیم ظاهر روی موشواره (Example Set appearance to Mouse)
> appearance 962
مثال تنظیم ظاهر روی دسته بازی (Example Set appearance to Joystick)
> appearance 963
مثال تنظیم ظاهر روی حسگر سلامت عمومی (Example Set appearance to Generic Health Sensor)
> appearance 1344
مثال تنظیم ظاهر روی حسگر ضربان قلب (Example Set appearance to Heart Rate Sensor)
> appearance 1345
مثال تنظیم ظاهر روی پایشگر فشار خون (Example Set appearance to Blood Pressure Monitor)
> appearance 1346
مثال تنظیم ظاهر روی ورزش و تناسب اندام عمومی (Example Set appearance to Generic Sports and Fitness)
> appearance 1472
مثال تنظیم ظاهر روی نمایشگر مکان (Example Set appearance to Location Display)
> appearance 1473
مثال تنظیم ظاهر روی نمایشگر ناوبری مکان (Example Set appearance to Location Navigation Display)
> appearance 1474

دریافت/تنظیم پیکربندی PHY

کاربرد (Usage)
> phy [LE1MTX] [LE1MRX] [LE2MTX] [LE2MRX] [LECODEDTX] [LECODEDRX] [BR1M1SLOT] [BR1M3SLOT] [BR1M5SLOT][EDR2M1SLOT] [EDR2M3SLOT] [EDR2M5SLOT][EDR3M1SLOT] [EDR3M3SLOT] [EDR3M5SLOT]
[PHY flags]
پرچم‌های پیکربندی PHY برای فعال‌سازی (LE1MTX، LE1MRX، LE2MTX، LE2MRX، LECODEDTX، LECODEDRX، BR1M1SLOT و غیره)
مثال نمایش پیکربندی کنونی PHY (Example Display current PHY configuration)
> phy
مثال فعال‌سازی LE 1M TX PHY (Example Enable LE 1M TX PHY)
> phy LE1MTX
مثال فعال‌سازی LE 1M RX PHY (Example Enable LE 1M RX PHY)
> phy LE1MRX
مثال فعال‌سازی LE 2M TX PHY (Example Enable LE 2M TX PHY)
> phy LE2MTX
مثال فعال‌سازی LE 2M RX PHY (Example Enable LE 2M RX PHY)
> phy LE2MRX
مثال فعال‌سازی LE Coded TX PHY (Example Enable LE Coded TX PHY)
> phy LECODEDTX
مثال فعال‌سازی LE Coded RX PHY (Example Enable LE Coded RX PHY)
> phy LECODEDRX
مثال فعال‌سازی بسته‌های ۱-اسلات BR 1M (Example Enable BR 1M 1-slot packets)
> phy BR1M1SLOT
مثال فعال‌سازی بسته‌های ۳-اسلات BR 1M (Example Enable BR 1M 3-slot packets)
> phy BR1M3SLOT
مثال فعال‌سازی بسته‌های ۵-اسلات BR 1M (Example Enable BR 1M 5-slot packets)
> phy BR1M5SLOT
مثال فعال‌سازی بسته‌های ۱-اسلات EDR 2M (Example Enable EDR 2M 1-slot packets)
> phy EDR2M1SLOT
مثال فعال‌سازی بسته‌های ۳-اسلات EDR 2M (Example Enable EDR 2M 3-slot packets)
> phy EDR2M3SLOT
مثال فعال‌سازی بسته‌های ۵-اسلاتی EDR 2M (Example Enable EDR 2M 5-slot packets)
> phy EDR2M5SLOT
مثال فعال‌سازی بسته‌های ۱-اسلاتی EDR 3M (Example Enable EDR 3M 1-slot packets)
> phy EDR3M1SLOT
مثال فعال‌سازی بسته‌های ۳-اسلاتی EDR 3M (Example Enable EDR 3M 3-slot packets)
> phy EDR3M3SLOT
مثال فعال‌سازی بسته‌های ۵-اسلاتی EDR 3M (Example Enable EDR 3M 5-slot packets)
> phy EDR3M5SLOT
مثال فعال‌سازی لایه‌های فیزیکی (PHY) ارسال و دریافت LE 1M (Example Enable LE 1M TX and RX PHYs)
> phy LE1MTX LE1MRX
مثال فعال‌سازی لایه‌های فیزیکی (PHY) ارسال و دریافت LE 1M و LE 2M (Example Enable LE 1M and 2M TX/RX PHYs)
> phy LE1MTX LE1MRX LE2MTX LE2MRX
مثال فعال‌سازی بسته‌های ۱-اسلاتی برای تمام لایه‌های فیزیکی BR/EDR (Example Enable 1-slot packets for all BR/EDR PHYs)
> phy BR1M1SLOT EDR2M1SLOT EDR3M1SLOT

تغییر وضعیت پشتیبانی از گفتار با پهنای باند گسترده (Wideband-Speech)

کاربرد (Usage)
> wbs <on/off>
<on/off>
پشتیبانی از گفتار با پهنای باند گسترده (Wideband Speech) - "on" برای فعال‌سازی برای نمایه‌های صوتی، "off" برای غیرفعال‌سازی
مثال فعال‌سازی پشتیبانی از گفتار با پهنای باند گسترده برای نمایه‌های صوتی (Example Enable Wideband Speech support for audio profiles)
> wbs on
مثال غیرفعال‌سازی پشتیبانی از گفتار با پهنای باند گسترده (Example Disable Wideband Speech support)
> wbs off

نمایش اطلاعات امنیتی

کاربرد (Usage)
> secinfo
مثال نمایش ویژگی‌ها و قابلیت‌های امنیتی (Example Display security features and capabilities)
> secinfo

نمایش ویژگی‌های آزمایشی

کاربرد (Usage)
> expinfo
مثال نمایش ویژگی‌های آزمایشی دردسترس و وضعیت آن‌ها (Example Display available experimental features and their status)
> expinfo

تنظیم ویژگی اشکال‌زدایی

کاربرد (Usage)
> exp-debug <on/off>
<on/off>
ویژگی‌های آزمایشی اشکال‌زدایی - "on" برای فعال‌سازی، "off" برای غیرفعال‌سازی
مثال فعال‌سازی ویژگی‌های آزمایشی اشکال‌زدایی (Example Enable experimental debug features)
> exp-debug on
مثال غیرفعال‌سازی ویژگی‌های آزمایشی اشکال‌زدایی (Example Disable experimental debug features)
> exp-debug off

تنظیم ویژگی حریم خصوصی لایه پیوند (LL)

کاربرد (Usage)
> exp-privacy <on/off>
<on/off>
حریم خصوصی آزمایشی لایه پیوند (Link Layer) - "on" برای فعال‌سازی قابلیت‌های حریم خصوصی LL، "off" برای غیرفعال‌سازی
مثال فعال‌سازی قابلیت‌های آزمایشی حریم خصوصی لایه پیوند (Example Enable experimental Link Layer privacy features)
> exp-privacy on
مثال غیرفعال‌سازی قابلیت‌های آزمایشی حریم خصوصی لایه پیوند (Example Disable experimental Link Layer privacy features)
> exp-privacy off

تنظیم ویژگی گزارش کیفیت بلوتوث

کاربرد (Usage)
> exp-quality <on/off>
<on/off>
گزارش‌دهی آزمایشی کیفیت - "on" برای فعال‌سازی گزارش‌های کیفیت بلوتوث، "off" برای غیرفعال‌سازی
مثال فعال‌سازی گزارش‌دهی آزمایشی کیفیت بلوتوث (Example Enable experimental Bluetooth quality reporting)
> exp-quality on
مثال غیرفعال‌سازی گزارش‌دهی آزمایشی کیفیت بلوتوث (Example Disable experimental Bluetooth quality reporting)
> exp-quality off

تغییر وضعیت پشتیبانی از کدک

کاربرد (Usage)
> exp-offload <on/off>
<on/off>
برون‌سپاری آزمایشی کدک - "on" برای فعال‌سازی پشتیبانی از برون‌سپاری کدک، "off" برای غیرفعال‌سازی
مثال فعال‌سازی پشتیبانی از برون‌سپاری آزمایشی کدک (Example Enable experimental codec offload support)
> exp-offload on
مثال غیرفعال‌سازی پشتیبانی از برون‌سپاری آزمایشی کدک (Example Disable experimental codec offload support)
> exp-offload off

تغییر وضعیت پشتیبانی از سوکت ISO

کاربرد (Usage)
> exp-iso <on/off>
<on/off>
پشتیبانی آزمایشی از سوکت ISO - "on" برای فعال‌سازی پشتیبانی از سوکت ISO،‏ "off" برای غیرفعال‌سازی
مثال فعال‌سازی پشتیبانی آزمایشی از سوکت ISO (Example Enable experimental ISO Socket support)
> exp-offload on
مثال غیرفعال‌سازی پشتیبانی آزمایشی از سوکت ISO (Example Disable experimental ISO Socket support)
> exp-offload off

خواندن پیکربندی سامانه

کاربرد (Usage)
> read-sysconfig
مثال خواندن پارامترهای جاری پیکربندی سامانه (Example Read current system configuration parameters)
> read-sysconfig

تنظیم پیکربندی سامانه

کاربرد (Usage)
> set-sysconfig <-v|-h> [options...]
<-v|-h>
خروجی پرگو یا پرچم راهنما
[options...]
گزینه‌های پیکربندی سامانه (--br-page-scan-type، --br-page-scan-interval و غیره)
مثال نمایش راهنما برای گزینه‌های پیکربندی سامانه (Example Show help for system configuration options)
> set-sysconfig -h
مثال تنظیم پیکربندی سامانه با خروجی پرگو (Example Set system configuration with verbose output)
> set-sysconfig -v
مثال تنظیم نوع پویش فراخوانی BR/EDR با خروجی پرگو (Example Set BR/EDR page scan type with verbose output)
> set-sysconfig -v --br-page-scan-type=0
مثال تنظیم بازه زمانی پویش فراخوانی BR/EDR (Example Set BR/EDR page scan interval)
> set-sysconfig -v --br-page-scan-interval=0x800
مثال تنظیم پنجره زمانی پویش فراخوانی BR/EDR (Example Set BR/EDR page scan window)
> set-sysconfig -v --br-page-scan-window=0x12
مثال تنظیم نوع پویش پرس‌وجوی BR/EDR (Example Set BR/EDR inquiry scan type)
> set-sysconfig -v --br-inquiry-scan-type=0
مثال تنظیم مهلت زمانی نظارت بر پیوند BR/EDR (Example Set BR/EDR link supervision timeout)
> set-sysconfig -v --br-link-supervision-timeout=0x2000
مثال تنظیم کمینه بازه زمانی اتصال LE (Example Set LE minimum connection interval)
> set-sysconfig -v --le-min-connection-interval=0x18
مثال تنظیم بیشینه بازه زمانی اتصال LE (Example Set LE maximum connection interval)
> set-sysconfig -v --le-max-connection-interval=0x28
مثال تنظیم چندین پارامتر پویش BR/EDR (Example Set multiple BR/EDR scan parameters)
> set-sysconfig -v --br-page-scan-type=0 --br-page-scan-interval=0x800 --br-page-scan-window=0x12
مثال تنظیم چندین پارامتر اتصال LE (Example Set multiple LE connection parameters)
> set-sysconfig -v --le-min-connection-interval=0x18 --le-max-connection-interval=0x28 --le-connection-latency=0

دریافت پرچم‌های دستگاه

کاربرد (Usage)
> get-flags [-t type] <address>
[-t type]
نوع نشانی (public، random، le_public، le_random)
<address>
نشانی بلوتوث دستگاه جهت پرس‌وجوی پرچم‌ها
مثال دریافت پرچم‌های دستگاه با نوع پیش‌فرض (Example Get device flags for device using default type)
> get-flags 00:11:22:33:44:55
مثال دریافت پرچم‌ها برای دستگاهی دیگر (Example Get flags for another device)
> get-flags AA:BB:CC:DD:EE:FF
مثال دریافت پرچم‌ها برای دستگاه با نشانی عمومی (Example Get flags for public address device)
> get-flags -t public 00:11:22:33:44:55
مثال دریافت پرچم‌ها برای دستگاه با نشانی تصادفی (Example Get flags for random address device)
> get-flags -t random AA:BB:CC:DD:EE:FF
مثال دریافت پرچم‌ها برای دستگاه با نشانی عمومی LE (Example Get flags for LE public address device)
> get-flags -t le_public 11:22:33:44:55:66
مثال دریافت پرچم‌ها برای دستگاه با نشانی تصادفی LE (Example Get flags for LE random address device)
> get-flags -t le_random CC:DD:EE:FF:00:11

تنظیم پرچم‌های دستگاه

کاربرد (Usage)
> set-flags [-f flags] [-t type] <address>
[-f flags]
ماسک بیتی پرچم‌های دستگاه به صورت هگزادسیمال (0x01=بیدارباش از دوردست / remote wake، 0x02=حریم خصوصی / privacy)
[-t type]
نوع نشانی (public، random، le_public، le_random)
<address>
نشانی بلوتوث دستگاه مورد نظر برای تنظیم پرچم‌ها
مثال تنظیم پرچم‌های پیش‌فرض برای دستگاه (Example Set default flags for device)
> set-flags 00:11:22:33:44:55
مثال تنظیم پرچم‌های پیش‌فرض برای دستگاهی دیگر (Example Set default flags for another device)
> set-flags AA:BB:CC:DD:EE:FF
مثال تنظیم پرچم بیدارباش از دوردست برای دستگاه (Example Set remote wake flag for device)
> set-flags -f 0x01 00:11:22:33:44:55
مثال تنظیم پرچم حریم خصوصی دستگاه (Example Set device privacy flag)
> set-flags -f 0x02 AA:BB:CC:DD:EE:FF
مثال تنظیم هر دو پرچم بیدارباش از دوردست و حریم خصوصی (Example Set both remote wake and privacy flags)
> set-flags -f 0x03 11:22:33:44:55:66
مثال تنظیم بیدارباش از دوردست برای دستگاه با نشانی عمومی (Example Set remote wake for public address device)
> set-flags -f 0x01 -t public 00:11:22:33:44:55
مثال تنظیم پرچم حریم خصوصی برای دستگاه عمومی LE (Example Set privacy flag for LE public device)
> set-flags -f 0x02 -t le_public 11:22:33:44:55:66
مثال تنظیم چند پرچم برای دستگاه تصادفی LE (Example Set multiple flags for LE random device)
> set-flags -f 0x03 -t le_random CC:DD:EE:FF:00:11
مثال پاک کردن همه پرچم‌ها برای دستگاه (Example Clear all flags for device)
> set-flags -f 0x00 00:11:22:33:44:55
مثال پاک کردن همه پرچم‌ها برای دستگاه عمومی LE (Example Clear all flags for LE public device)
> set-flags -f 0x00 -t le_public 11:22:33:44:55:66

http://www.bluez.org

<linux-bluetooth@vger.kernel.org>

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

July 2023 BlueZ