| org.bluez.Bearer.LE(5) | Linux System Administration | org.bluez.Bearer.LE(5) |
نام (NAME)
org.bluez.Bearer.LE - رابط کاربری D-Bus برای حامل بلوتوث کممصرف (LE) در BlueZ
واسط (INTERFACE)
- سرویس (Service)
- org.bluez
- واسط (Interface)
- org.bluez.Bearer.LE1
- مسیر شیء (Object path)
- [variable prefix]/{hci0,hci1,...}/dev_{BDADDR}
متدها (Methods)
void Connect() [experimental]
تمام پروفایلهای LE را که دستگاه راه دور پشتیبانی میکند، امکان اتصال به آنها وجود دارد و به عنوان اتصال خودکار (auto-connectable) نشانهگذاری شدهاند، متصل میکند. اگر تنها زیرمجموعهای از پروفایلها در حال حاضر متصل باشند، سعی میکند موارد قطعشده فعلی را متصل کند.
اگر حداقل یک پروفایل با موفقیت متصل شود، این متد موفقیت را نشان خواهد داد.
خطاهای احتمالی:
void Disconnect() [experimental]
تمام پروفایلهای متصل را قطع کرده و سپس اتصال سطح پایین ACL-LE را خاتمه میدهد.
اتصال ACL-LE حتی در صورتی که برخی از پروفایلها به طور مناسب قطع نشده باشند (مثلاً به دلیل رفتار نامناسب دستگاه) نیز خاتمه داده خواهد شد.
از این متد میتوان برای لغو فراخوانی متد پیشین Connect پیش از دریافت پاسخ آن نیز استفاده کرد.
برای دستگاههای متصل غیرقابلاعتماد (non-trusted)، فراخوانی این متد اتصالهای ورودی را تا زمانی که متد Connect دوباره فراخوانی شود، غیرفعال خواهد کرد.
خطاهای احتمالی:
سیگنالها (Signals)
void Disconnected(string reason, string message) [experimental]
این سیگنال هنگام قطع اتصال یک دستگاه، همراه با علت قطع اتصال، ارسال میشود.
این سیگنال بسته به خطمشی داخلی برنامه کلاینت، میتواند برای تلاش مجدد جهت اتصال به دستگاه در صورت بروز اتمام مهلت زمانی (timeout) یا قطع اتصال نامشخص، و یا تلاش برای اتصال به دستگاهی دیگر مورد استفاده قرار گیرد.
علل احتمالی:
- org.bluez.Reason.Unknown
- org.bluez.Reason.Timeout
- اتمام مهلت
زمانی
اتصال (Connection timeout).
مهلت زمانی نظارت بر پیوند (link supervision timeout) برای یک اتصال به پایان رسیده است یا مهلت زمانی همگامسازی برای یک پخش عمومی (broadcast) منقضی شده است.
- org.bluez.Reason.Local
- اتصال توسط
میزبان
محلی خاتمه
یافته است.
دستگاه محلی اتصال را خاتمه داده، همگامسازی با پخشکننده را متوقف کرده، یا ارسال بستههای پخش عمومی را متوقف کرده است.
- org.bluez.Reason.Remote
- اتصال توسط
میزبان راه
دور خاتمه
یافته است.
این قطع اتصال میتواند ناشی از موارد زیر باشد:
- کاربر در دستگاه راه دور اتصال را خاتمه داده یا پخش بستهها را متوقف کرده است،
- دستگاه راه دور به دلیل کمبود منابع اتصال را قطع کرده است،
- دستگاه راه دور به دلیل اینکه در حال خاموش شدن است اتصال را قطع کرده است.
- org.bluez.Reason.Authentication
- اتصال به دلیل شکست در احراز هویت (authentication failure) خاتمه یافته است.
- org.bluez.Reason.Suspend
- اتصال توسط میزبان محلی به دلیل تعلیق سیستم (suspend) خاتمه یافته است.
ویژگیها (Properties)
object Adapter [readonly, experimental]
مسیر شیء آداپتوری که این مجموعه به آن تعلق دارد.
boolean Paired [readonly, experimental]
نشان میدهد آیا دستگاه راه دور با حامل LE جفت (paired) شده است یا خیر.
جفتشده (Paired) به این معناست که فرآیند جفتسازی، که طی آن دستگاهها اطلاعات لازم برای برقراری یک اتصال رمزگذاریشده را تبادل میکنند، کامل شده است.
boolean Bonded [readonly, experimental]
نشان میدهد آیا دستگاه راه دور با حامل LE پیوند پایدار (bonded) برقرار کرده است یا خیر.
پیوند پایدار (Bonded) به این معناست که اطلاعات تبادلشده در فرآیند جفتسازی ذخیره شده و ماندگار خواهد بود.
boolean Connected [readonly, experimental]
نشان میدهد آیا دستگاه راه دور در حال حاضر به حامل LE متصل است یا خیر.
سیگنال PropertiesChanged تغییرات این وضعیت را اعلام میکند.
| July 2025 | BlueZ |