| bluetoothctl-scan(1) | Linux System Administration | bluetoothctl-scan(1) |
نام (NAME)
bluetoothctl-scan - زیردستور پویش و مدیریت فیلترهای اسکن در bluetoothctl
خلاصه دستور (SYNOPSIS)
bluetoothctl [--options] [scan.commands]
این زیرمنو فیلترهای کشف (discovery) را با استفاده از متد SetDiscoveryFilter در org.bluez.Adapter(5) پیکربندی میکند.
دستورات پویش (SCAN COMMANDS)
uuids
تنظیم/دریافت فیلتر UUIDها.
- کاربرد (Usage)
- > uuids [all/uuid1 uuid2 ...]
- استفادهها (Uses)
- متد SetDiscoveryFilter در org.bluez.Adapter(5)، مشخصه UUIDs
- [all/uuid1 uuid2 ...]
- فهرستی از UUIDها برای فیلتر کردن در هنگام پویش (پیشفرض: هیچکدام، از "all" برای پویش هرگونه UUID استفاده کنید)
- مثال نمایش تنظیمات فعلی فیلتر UUID
-
> uuids
- مثال فیلتر کردن فقط برای سرویس Generic Access
-
> uuids 0x1800
- مثال فیلتر کردن فقط برای سرویس باتری (Battery)
-
> uuids 0x180F
- مثال فیلتر کردن برای سرویسهای Generic Access و باتری
-
> uuids 0x1800 0x180F
- مثال فیلتر کردن برای سرویسهای اطلاعات دستگاه، باتری و سنجش محیطی (Environmental Sensing)
-
> uuids 0x180A 0x180F 0x181A
- مثال فیلتر کردن برای Generic Access با استفاده از UUID کامل
-
> uuids 00001800-0000-1000-8000-00805f9b34fb
- مثال فیلتر کردن با استفاده از شکلهای کوتاه و بلند ترکیبی
-
> uuids 00001800-0000-1000-8000-00805f9b34fb 0000180f-0000-1000-8000-00805f9b34fb
- مثال حذف فیلتر کردن UUID (پویش برای همه دستگاهها)
-
> uuids all
rssi
تنظیم/دریافت فیلتر RSSI، و پاکسازی افت مسیر (pathloss).
این دستور مقدار کمینه RSSI را برای گزارش اعلانهای تبلیغاتی (advertisements) دستگاه تنظیم میکند.
این مقدار بر حسب dBm است.
اگر یک یا چند فیلتر کشف تنظیم شده باشند، آستانه تغییرات (delta-threshold) مربوط به RSSI که به طور پیشفرض هنگام آغاز کشف اعمال میشود، اعمال نخواهد شد.
- کاربرد (Usage)
- > rssi [rssi]
- استفادهها (Uses)
- متد SetDiscoveryFilter در org.bluez.Adapter(5)، مشخصه RSSI
- [rssi]
- مقدار آستانه کمینه RSSI بر حسب dBm (اختیاری؛ در صورت حذف، مقدار فعلی نمایش داده میشود)
- مثال نمایش تنظیم فعلی فیلتر RSSI
-
> rssi
- مثال گزارش تنها دستگاههای با RSSI ≥ -60 dBm (برد نزدیک)
-
> rssi -60
- مثال گزارش دستگاههای با RSSI ≥ -80 dBm (برد متوسط)
-
> rssi -80
- مثال گزارش دستگاههای با RSSI ≥ -90 dBm (برد گسترده)
-
> rssi -90
- مثال گزارش تنها دستگاههای بسیار نزدیک (RSSI ≥ -40 dBm)
-
> rssi -40
- مثال گزارش دستگاههای با سیگنال بسیار ضعیف (بیشینه حساسیت)
-
> rssi -100
pathloss
تنظیم/دریافت فیلتر افت مسیر (Pathloss)، و پاکسازی RSSI.
این دستور بیشینه مقدار افت مسیر (pathloss) را برای گزارش اعلانهای تبلیغاتی دستگاه تنظیم میکند.
این مقدار بر حسب dB است.
اگر یک یا چند فیلتر کشف تنظیم شده باشند، آستانه تغییرات مربوط به RSSI که به طور پیشفرض هنگام آغاز کشف اعمال میشود، اعمال نخواهد شد.
- کاربرد (Usage)
- > pathloss [pathloss]
- استفادهها (Uses)
- متد SetDiscoveryFilter در org.bluez.Adapter(5)، مشخصه Pathloss
- [pathloss]
- مقدار آستانه بیشینه افت مسیر بر حسب dB (اختیاری؛ در صورت حذف، مقدار فعلی نمایش داده میشود)
- مثال نمایش تنظیم فعلی فیلتر افت مسیر
-
> pathloss
- مثال گزارش دستگاهها با حداکثر افت مسیر 4 dB (بسیار نزدیک)
-
> pathloss 4
- مثال گزارش دستگاهها با حداکثر افت مسیر 10 dB (برد نزدیک)
-
> pathloss 10
- مثال گزارش دستگاهها با حداکثر افت مسیر 20 dB (برد متوسط)
-
> pathloss 20
- مثال گزارش دستگاهها با حداکثر افت مسیر 30 dB (برد گسترده)
-
> pathloss 30
- مثال گزارش دستگاهها با حداکثر افت مسیر 50 dB (حداکثر برد)
-
> pathloss 50
transport
تنظیم/دریافت فیلتر لایه انتقال (Transport).
پارامتر لایه انتقال نوع پویش را مشخص میکند.
مقدار پیشفرض auto است.
مقادیر ممکن:
- "auto": پویش درهمتنیده (interleaved scan)
- "bredr": استعلام BR/EDR
- "le": فقط پویش کممصرف (LE)
اگر لایه انتقال "le" یا "bredr" درخواست شود و کنترلر از آن پشتیبانی نکند، خطای org.bluez.Error.Failed بازگردانده خواهد شد.
اگر لایه انتقال "auto" درخواست شود، پویش بسته به آنچه در حال حاضر روی کنترلر فعال است، از LE، BREDR یا هر دو استفاده خواهد کرد.
- کاربرد (Usage)
- > transport [auto/bredr/le]
- [auto/bredr/le]
- نوع لایه انتقال برای پویش (اختیاری؛ در صورت حذف، مقدار فعلی نمایش داده میشود)
- مثال نمایش تنظیم فعلی فیلتر لایه انتقال
-
> transport
- مثال استفاده از انتخاب خودکار لایه انتقال (LE + BR/EDR)
-
> transport auto
- مثال پویش فقط دستگاههای کممصرف (Low Energy)
-
> transport le
- مثال پویش فقط دستگاههای BR/EDR (بلوتوث سنتی / Classic Bluetooth)
-
> transport bredr
duplicate-data
تنظیم/دریافت فیلتر دادههای تکراری (Duplicate Data).
تشخیص و فیلتر دادههای تکراری اعلانهای تبلیغاتی را غیرفعال میکند.
در صورت فعال بودن، هر بار که ManufacturerData و ServiceData کشف شوند، سیگنالهای PropertiesChanged تولید خواهند شد.
- کاربرد (Usage)
- > duplicate-data [on/off]
- [on/off]
- فعال یا غیرفعال کردن گزارش دادههای تکراری اعلانهای تبلیغاتی (اختیاری؛ در صورت حذف، وضعیت فعلی نمایش داده میشود)
- مثال نمایش تنظیم فعلی فیلتر دادههای تکراری
-
> duplicate-data
- مثال فعال کردن گزارش دادههای تکراری اعلانهای تبلیغاتی
-
> duplicate-data on
- مثال غیرفعال کردن گزارش دادههای تکراری (فیلتر کردن موارد تکراری)
-
> duplicate-data off
discoverable
تنظیم/دریافت فیلتر قابلکشف بودن (Discoverable).
آداپتور را در حین انجام فرآیند کشف، برای دیگران نیز قابلکشف میسازد.
اگر آداپتور از قبل قابلکشف باشد، تنظیم این فیلتر هیچ اثری نخواهد داشت.
- کاربرد (Usage)
- > discoverable [on/off]
- [on/off]
- قابلکشف کردن آداپتور در حین پویش (اختیاری؛ در صورت حذف، وضعیت فعلی نمایش داده میشود)
- مثال نمایش تنظیم فعلی فیلتر قابلکشف بودن
-
> discoverable
- مثال قابلکشف کردن آداپتور در حین پویش
-
> discoverable on
- مثال غیرقابلکشف نگه داشتن آداپتور در حین پویش
-
> discoverable off
pattern
تنظیم/دریافت فیلتر الگو (Pattern).
کشف دستگاههایی که الگوی مشخصشده با پیشوند نشانی یا نام دستگاه مطابقت داشته باشد؛ این روش راهی مناسب برای محدود کردن تعداد اشیاء دستگاه ایجادشده در حین کشف است.
هنگام تنظیم این فیلتر، پرچمهای قابلکشف بودن دستگاه نادیده گرفته میشوند.
- نکته
- اگر کلاینتهای دیگری وجود داشته باشند که هیچ الگویی تعیین نکردهاند، تطبیق الگو نادیده گرفته میشود زیرا به صورت OR منطقی عمل میکند. همچنین تنظیم الگوی رشته خالی "" با هر دستگاه یافتشدهای مطابقت خواهد داشت.
- کاربرد (Usage)
- > pattern [value]
- [value]
- الگو برای مطابقت با پیشوند نشانی یا نام دستگاه (اختیاری؛ در صورت حذف، مقدار فعلی نمایش داده میشود)
- مثال نمایش تنظیم فعلی فیلتر الگو
-
> pattern
- مثال کشف دستگاههایی با نام شامل "Samsung"
-
> pattern Samsung
- مثال کشف دستگاههایی با نام شامل "iPhone"
-
> pattern iPhone
- مثال کشف دستگاههایی با نام شامل "Headphones"
-
> pattern Headphones
- مثال کشف دستگاههایی با نشانیهایی که با 00:11:22 شروع میشوند
-
> pattern 00:11:22
- مثال کشف دستگاههایی با نشانیهایی که با AA:BB:CC شروع میشوند
-
> pattern AA:BB:CC
- مثال پاکسازی فیلتر الگو (مطابقت با هر دستگاه)
-
> pattern ""
auto-connect
تنظیم/دریافت فیلتر اتصال خودکار (Auto-connect).
اتصال خودکار به دستگاههای کشفشده در صورتی که فیلتر الگو تنظیم شده باشد، با نشانی یا نام دستگاه مطابقت داشته باشد و دستگاه قابلاتصال باشد.
- کاربرد (Usage)
- > auto-connect [on/off]
- [on/off]
- اتصال خودکار به دستگاههای کشفشده منطبق با فیلتر الگو (اختیاری؛ در صورت حذف، وضعیت فعلی نمایش داده میشود)
- مثال نمایش تنظیم فعلی فیلتر اتصال خودکار
-
> auto-connect
- مثال فعالسازی اتصال خودکار به دستگاههای منطبق
-
> auto-connect on
- مثال غیرفعالسازی اتصال خودکار (نیاز به اتصال دستی)
-
> auto-connect off
clear
فیلترهای کشف را پاک میکند.
- کاربرد (Usage)
- > clear [uuids/rssi/pathloss/transport/duplicate-data/discoverable/pattern/auto-connect]
- [uuids/rssi/pathloss/transport/duplicate-data/discoverable/pattern/auto-connect]
- فیلتر(های) مشخص برای پاکسازی (اختیاری؛ در صورت حذف، همه موارد پاک میشوند)
- مثال پاکسازی تمام فیلترهای کشف
-
> clear
- مثال پاکسازی فقط فیلتر UUID
-
> clear uuids
- مثال پاکسازی فقط فیلتر RSSI
-
> clear rssi
- مثال پاکسازی فقط فیلتر افت مسیر (pathloss)
-
> clear pathloss
- مثال پاکسازی فقط فیلتر لایه انتقال (transport)
-
> clear transport
- مثال پاکسازی فقط فیلتر دادههای تکراری
-
> clear duplicate-data
- مثال پاکسازی فقط فیلتر قابلکشف بودن
-
> clear discoverable
- مثال پاکسازی فقط فیلتر الگو
-
> clear pattern
- مثال پاکسازی فقط فیلتر اتصال خودکار
-
> clear auto-connect
- مثال پاکسازی فیلترهای UUID و RSSI
-
> clear uuids rssi
- مثال پاکسازی فیلترهای لایه انتقال و الگو
-
> clear transport pattern
- مثال پاکسازی فیلترهای الگو و اتصال خودکار
-
> clear pattern auto-connect
- مثال پاکسازی فیلترهای RSSI، افت مسیر و قابلکشف بودن
-
> clear rssi pathloss discoverable
منابع (RESOURCES)
گزارش اشکالات (REPORTING BUGS)
<linux-bluetooth@vger.kernel.org>
حق نشر (COPYRIGHT)
استفاده آزاد از این نرمافزار تحت شرایط مجوز عمومی کمتر گنو (LGPL) اعطا شده است.
| July 2023 | BlueZ |