.\" 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.AdvertisementMonitor" "5" "اکتبر 2023" "BlueZ" "مدیریت سیستم لینوکس"
.SH "نام (NAME)"
org.bluez.AdvertisementMonitor \- مستندات واسط D\-Bus پایشگر آگهی در BlueZ
.SH "توضیحات (DESCRIPTION)"
.sp
این واسط به کلاینت اجازه می‌دهد تا با ثبت ریشه سلسله‌مراتب و سپس ارائه (expose) پایشگرهای آگهی تحت این ریشه به همراه شرایط پالایش، آستانه‌های RSSI و زمان‌سنج‌های آستانه RSSI، یک وظیفه پایش آگهی‌ها را مشخص کند.
.sp
هنگامی که یک وظیفه پایش توسط \fBbluetoothd(8)\fP فعال شود، کلاینت می‌تواند انتظار داشته باشد که اعلان‌های مربوط به آگهی‌های هدف را صرف‌نظر از اینکه یک نشست پویش فعال در حال اجرا است یا خیر (نگاه کنید به \fBStartDiscovery()\fP در \fBorg.bluez.Adapter(5)\fP) دریافت کند.
.SH "واسط (INTERFACE)"
.INDENT 0.0
.TP
.B سرویس (Service)
org.bluez
.TP
.B واسط (Interface)
org.bluez.AdvertisementMonitor1 [experimental]
.TP
.B مسیر شیء (Object path)
به صورت آزاد قابل تعریف است (freely definable)
.TP
.B مورد استفاده توسط (Used by)
\fBbluetoothctl\-monitor(1)\fP
.UNINDENT
.SS "متدها (Methods)"
.SS void Release() [noreply]
.sp
این متد به عنوان سیگنالی برای انجام وظایف پاک‌سازی توسط کلاینت فراخوانی می‌شود هنگامی که:
.INDENT 0.0
.IP \(bu 2
پایشگر پس از ارائه شدن، امکان فعال‌سازی نداشته باشد.
.IP \(bu 2
پایشگر غیرفعال شده باشد.
.UNINDENT
.SS void Activate() [noreply]
.sp
پس از اینکه یک پایشگر ارائه شد، این متد به عنوان سیگنالی برای آگاه‌سازی کلاینت از فعال شدن پایشگر فراخوانی می‌شود تا کلاینت بتواند انتظار دریافت فراخوانی‌های \fBDeviceFound()\fP یا \fBDeviceLost()\fP را داشته باشد.
.SS void DeviceFound(object device) [noreply]
.sp
این متد برای آگاه‌سازی کلاینت از پیدا شدن دستگاه مورد نظر فراخوانی می‌شود.
.sp
پس از دریافت این فراخوانی، کلاینت باید پایش دستگاه مربوطه را برای دریافت تغییرات RSSI و محتوای آگهی آغاز کند.
.SS void DeviceLost(object device) [noreply]
.sp
این متد برای آگاه‌سازی کلاینت از دست رفتن دستگاه مورد نظر فراخوانی می‌شود.
.sp
پس از دریافت این فراخوانی، کلاینت باید پایش دستگاه مربوطه را متوقف کند.
.SS "ویژگی‌ها (Properties)"
.SS string Type [read\-only]
.sp
نوع پایشگر. برای گزینه‌های موجود، \fBSupportedMonitorTypes\fP را در \fBorg.bluez.AdvertisementMonitorManager(5)\fP ببینید.
.SS int16 RSSILowThreshold [read\-only, optional]
.sp
در ترکیب با \fBRSSILowTimeout\fP برای تعیین اینکه آیا دستگاهی از محدوده خارج (out\-of\-range) شده است یا خیر استفاده می‌شود.
.sp
محدوده معتبر بین \-127 تا 20 (برحسب dBm) است، در حالی که 127 نشان‌دهنده تنظیم‌نشده (unset) بودن است.
.SS int16 RSSIHighThreshold [read\-only, optional]
.sp
در ترکیب با \fBRSSIHighTimeout\fP برای تعیین اینکه آیا دستگاهی وارد محدوده (in\-range) شده است یا خیر استفاده می‌شود.
.sp
محدوده معتبر بین \-127 تا 20 (برحسب dBm) است، در حالی که 127 نشان‌دهنده تنظیم‌نشده (unset) بودن است.
.SS uint16 RSSILowTimeout [read\-only, optional]
.sp
مدت زمانی که لازم است تا دستگاهی خارج از محدوده در نظر گرفته شود. اگر این تعداد ثانیه بدون دریافت هیچ سیگنالی که دست‌کم به اندازه \fBRSSILowThreshold\fP قوی باشد سپری شود، دستگاهی که در حال حاضر درون محدوده است به عنوان خارج از محدوده (دست‌رفته یا lost) در نظر گرفته خواهد شد. محدوده معتبر بین 1 تا 300 (ثانیه) است، در حالی که 0 نشان‌دهنده تنظیم‌نشده بودن است.
.SS uint16 RSSIHighTimeout [read\-only, optional]
.sp
مدت زمانی که لازم است تا دستگاهی درون محدوده در نظر گرفته شود. اگر این تعداد ثانیه در حال دریافت مداوم سیگنال‌هایی که دست‌کم به اندازه \fBRSSIHighThreshold\fP قوی هستند سپری شود، دستگاهی که در حال حاضر خارج از محدوده است به عنوان درون محدوده (یافت‌شده یا found) در نظر گرفته خواهد شد.
.sp
محدوده معتبر بین 1 تا 300 (ثانیه) است، در حالی که 0 نشان‌دهنده تنظیم‌نشده بودن است.
.SS uint16 RSSISamplingPeriod [read\-only, optional]
.sp
قوانین گروه‌بندی درباره نحوه ارسال بسته‌های آگهی دریافت‌شده به کلاینت.
.sp
مقادیر ممکن:
.INDENT 0.0
.TP
.B 0
تمام بسته‌های آگهی از دستگاه‌های درون محدوده ارسال خواهند شد.
.TP
.B 255
تنها نخستین بسته آگهی دستگاه‌های درون محدوده ارسال خواهد شد. اگر دستگاه از دست برود، نخستین بسته پس از یافتن دوباره آن نیز ارسال خواهد شد.
.TP
.B 1 to 254
بسته‌های آگهی در بازه‌های زمانی 100ms * N گروه‌بندی می‌شوند. بسته‌های موجود در یک گروه تنها یک بار گزارش خواهند شد و مقدار RSSI میانگین‌گیری می‌شود.
.sp
در حال حاضر این ویژگی در فضای کاربری پیاده‌سازی نشده است، بنابراین این مقدار صرفاً جهت ارسال به هسته استفاده می‌شود.
.UNINDENT
.SS array{(uint8, uint8, array{byte})} Patterns [read\-only, optional]
.sp
اگر ویژگی \fBType\fP روی \fB\(dqor_patterns\(dq\fP تنظیم شده باشد، این ویژگی باید وجود داشته باشد و دست‌کم شامل یک مورد در آرایه باشد.
.sp
ساختار یک الگو شامل موارد زیر است:
.INDENT 0.0
.TP
.B uint8 start_position
اندیس در فیلد داده‌ای AD که جستجو باید از آنجا آغاز شود. ابتدای یک فیلد داده‌ای AD، اندیس 0 است.
.TP
.B uint8 AD_data_type
برای مقادیر مجاز ممکن،
\%<https://www.bluetooth.com/specifications/assigned-numbers/generic-access-profile>
را ببینید.
.TP
.B array{byte} content_of_pattern
این مقدار الگو است. حداکثر طول بایت‌ها ۳۱ است.
.UNINDENT
.\" End of generated man page.