org.bluez.LEAdvertisingManager(5) مدیریت سیستم لینوکس org.bluez.LEAdvertisingManager(5)

org.bluez.LEAdvertisingManager - رابط کاربری D-Bus برای مدیریت تبلیغات بلوتوث کم‌مصرف در BlueZ

مدیر تبلیغات (Advertising Manager) به برنامه‌های خارجی امکان می‌دهد تا داده‌های تبلیغاتی (Advertisement Data) را که باید به دستگاه‌ها اعلان عمومی شوند، ثبت نمایند. عناصر داده‌های تبلیغاتی باید از API برای داده‌های تبلیغاتی LE که شرح داده شده پیروی کنند.

سرویس (Service)
org.bluez
واسط (Interface)
org.bluez.LEAdvertisingManager1
مسیر شیء (Object path)
/org/bluez/{hci0,hci1,...}
مورد استفاده توسط (Used by)
bluetoothctl(1)

یک شیء تبلیغاتی را برای ارسال بر روی کانال تبلیغات LE ثبت می‌کند.

این سرویس باید واسط org.bluez.LEAdvertisement(5) را پیاده‌سازی کند.

خطاهای ممکن:

نشان می‌دهد شیء دارای ویژگی‌های نامعتبر یا دارای تداخل است.
نشان می‌دهد شیء از قبل ثبت شده است.
نشان می‌دهد داده‌های ارائه‌شده یک بسته داده بیش از حد طولانی ایجاد می‌کنند.
نشان می‌دهد حداکثر تعداد نمونه‌های تبلیغاتی تکمیل شده است.

مثال‌ها:

> advertise <on/off/type>

تبلیغی را که پیش‌تر با استفاده از RegisterAdvertisement() ثبت شده است لغو ثبت می‌کند.

پارامتر مسیر شیء باید با همان مقداری که هنگام ثبت استفاده شده است مطابقت داشته باشد.

خطاهای ممکن:

تعداد نمونه‌های تبلیغاتی فعال.

تعداد نمونه‌های تبلیغاتی در دسترس.

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

مقادیر ممکن:

"tx-power"
"appearance"
"local-name"
"rsi"

فهرست کانال‌های ثانویه پشتیبانی‌شده. کانال‌های ثانویه می‌توانند برای تبلیغ با لایه فیزیکی (PHY) مربوطه استفاده شوند.

مقادیر ممکن:

"1M"
"2M"
"Coded"

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

مقادیر ممکن:

حداکثر طول داده‌های تبلیغات
حداکثر طول پاسخ پویش (scan response) تبلیغات
حداقل توان ارسال تبلیغات (dBm)
حداکثر توان ارسال تبلیغات (dBm)

فهرست ویژگی‌های پلتفرم پشتیبانی‌شده. اگر هیچ ویژگی در پلتفرم موجود نباشد، آرایه SupportedFeatures خالی خواهد بود.

مقادیر ممکن:

"CanSetTxPower"
نشان می‌دهد آیا پلتفرم می‌تواند توان ارسال را برای هر نمونه تبلیغاتی تعیین کند یا خیر.
"HardwareOffload"
نشان می‌دهد آیا تبلیغات چندگانه به کنترل‌کننده واگذار (offload) خواهد شد یا خیر.
اکتبر 2023 BlueZ