bluetoothctl-monitor(1) مدیریت سیستم لینوکس bluetoothctl-monitor(1)

bluetoothctl-monitor - زیرمنوی پایش (Monitor)

bluetoothctl [--options] [monitor.commands]

این زیرمنو پایشگرهای تبلیغ (advertisement monitors) را با استفاده از رابط‌های org.bluez.AdvertisementMonitor(5) و org.bluez.AdvertisementMonitorManager(5) پیکربندی می‌کند.

تنظیم پارامتر آستانه RSSI

کاربرد
> set-rssi-threshold <low_threshold> <high_threshold>
<low_threshold>
مقدار آستانه پایینی RSSI بر حسب dBm برای پایش
<high_threshold>
مقدار آستانه بالایی RSSI بر حسب dBm برای پایش
مثال تنظیم آستانه پایینی روی 80- دسی‌بل‌میلی‌وات و آستانه بالایی روی 40- دسی‌بل‌میلی‌وات
> set-rssi-threshold -80 -40
مثال تنظیم آستانه پایینی روی 70- دسی‌بل‌میلی‌وات و آستانه بالایی روی 30- دسی‌بل‌میلی‌وات
> set-rssi-threshold -70 -30
مثال تنظیم آستانه بسیار حساس پایینی و آستانه بالایی متوسط
> set-rssi-threshold -90 -50
مثال تنظیم آستانه‌های کم‌حساس‌تر برای پایش در برد نزدیک
> set-rssi-threshold -60 -20

تنظیم پارامتر مهلت زمانی RSSI

کاربرد
> set-rssi-timeout <low_timeout> <high_timeout>
<low_timeout>
مقدار مهلت زمانی بر حسب ثانیه برای آستانه پایین RSSI
<high_timeout>
مقدار مهلت زمانی بر حسب ثانیه برای آستانه بالای RSSI
مثال تنظیم مهلت پایین به ۵ ثانیه و مهلت بالا به ۱۰ ثانیه
> set-rssi-timeout 5 10
مثال تنظیم پاسخ مهلت سریع برای هر دو آستانه
> set-rssi-timeout 1 5
مثال تنظیم دوره‌های مهلت طولانی‌تر برای پایش پایدار
> set-rssi-timeout 10 30
مثال تنظیم مقادیر مهلت نامتقارن
> set-rssi-timeout 3 15

تنظیم پارامتر دوره نمونه‌برداری RSSI

کاربرد
> set-rssi-sampling-period <sampling_period>
<sampling_period>
دوره نمونه‌برداری بر حسب واحدهای ۱۰۰ میلی‌ثانیه‌ای (۰ تا ۲۵۵، که در آن ۰ به معنی گزارش همه، و ۲۵۵ به معنی گزارش فقط اولین است)
مثال تنظیم دوره نمونه‌برداری روی ۱۰۰ میلی‌ثانیه (۱ واحد)
> set-rssi-sampling-period 1
مثال تنظیم دوره نمونه‌برداری روی ۵۰۰ میلی‌ثانیه (۵ واحد)
> set-rssi-sampling-period 5
مثال تنظیم دوره نمونه‌برداری روی ۱ ثانیه (۱۰ واحد)
> set-rssi-sampling-period 10
مثال گزارش تمامی تبلیغات (بدون نمونه‌برداری)
> set-rssi-sampling-period 0
مثال گزارش فقط اولین تبلیغ
> set-rssi-sampling-period 255

ثبت پایشگر از نوع الگوی OR با پارامترهای RSSI مشخص‌شده

هر الگو به ۳ آرگومان نیاز دارد: <start_position> <ad_data_type> <content_of_pattern> برای ایجاد شرط OR می‌توان چندین الگو مشخص کرد.

کاربرد
> add-or-pattern <start_pos> <ad_type> <content> [start_pos ad_type content ...]
استفاده می‌کند از
متد RegisterMonitor در org.bluez.AdvertisementMonitorManager(5)
<start_pos>
موقعیت بایتی در داده تبلیغ که تطبیق الگو از آنجا آغاز می‌شود (مبتنی بر صفر)
<ad_type>
نوع داده تبلیغ (برای مثال ۹ برای Complete Local Name، ۱ برای Flags)
<content>
محتوای الگوی هگزادسیمال جهت تطبیق
مثال پایش برای Samsung در نام محلی کامل (نوع ۹)
> add-or-pattern 0 9 53616d73756e67
مثال پایش دستگاه‌هایی با نوع پرچم‌ها (نوع ۱) حاوی 0x06
> add-or-pattern 0 1 06
مثال پایش برای دو الگوی مختلف (شرط OR)
> add-or-pattern 0 9 53616d73756e67 0 9 4170706c65
مثال پایش برای داده‌های سازنده مشخص (نوع ۲۵۵)
> add-or-pattern 0 255 4c000215

دریافت پایشگر تبلیغ

کاربرد
> get-pattern <monitor-id/all>
<monitor-id/all>
شماره شناسه پایشگر برای دریافت جزئیات، یا "all" برای تمامی پایشگرهای فعال
مثال دریافت جزئیات پایشگر با شناسه ۰
> get-pattern 0
مثال دریافت جزئیات پایشگر با شناسه ۱
> get-pattern 1
مثال دریافت جزئیات پایشگر با شناسه ۵
> get-pattern 5
مثال دریافت جزئیات تمام پایشگرهای فعال
> get-pattern all

حذف پایشگر تبلیغ

کاربرد
> remove-pattern <monitor-id/all>
استفاده می‌کند از
متد UnregisterMonitor در org.bluez.AdvertisementMonitorManager(5)
<monitor-id/all>
شماره شناسه پایشگر برای حذف، یا "all" برای حذف تمامی پایشگرهای فعال
مثال حذف پایشگر با شناسه ۰
> remove-pattern 0
مثال حذف پایشگر با شناسه ۱
> remove-pattern 1
مثال حذف پایشگر با شناسه ۳
> remove-pattern 3
مثال حذف تمامی پایشگرهای فعال تبلیغ
> remove-pattern all

دریافت قابلیت‌ها و انواع پایشگرهای پشتیبانی‌شده توسط مدیر تبلیغات

کاربرد
> get-supported-info
استفاده می‌کند از
ویژگی‌های org.bluez.AdvertisementMonitorManager(5)
مثال نمایش قابلیت‌ها و انواع پایشگرهای پشتیبانی‌شده
> get-supported-info

چاپ نحوه استفاده از دستور

کاربرد
> print-usage <add-or-pattern>
<add-or-pattern>
نام دستور جهت نمایش اطلاعات تفصیلی نحوه استفاده
مثال نمایش نحوه استفاده با جزئیات برای دستور add-or-pattern
> print-usage add-or-pattern

http://www.bluez.org

<linux-bluetooth@vger.kernel.org>

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

July 2023 BlueZ