فراپهن‌باند

از Android 13،‏ Android پیاده‌سازی چارچوب پیش‌فرضی برای فناوری رادیویی «فراپهن‌باند» (UWB) ارائه می‌دهد که امکان فاصله‌یابی دقیق و بسیار ایمن بین دستگاه‌های پشتیبانی‌شده را فراهم می‌کند. پلاتفرم پشته AOSP UWB را به‌عنوان یک واحد اختیاری برای سازندگان دستگاه ارائه می‌دهد. برای جزئیات بیشتر درباره واحد، واحد: UWB را ببینید.

معماری

پشته «فراپهن‌باند» از واحد اصلی «فراپهن‌باند» و پیاده‌سازی HAL ارائه‌شده توسط فروشنده تراشه «فراپهن‌باند» تشکیل شده است. شکل ۱ معماری پشته UWB را نشان می‌دهد:

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

شکل ۱. معماری پشته فراپهن‌باند.

پشته AOSP

پشته AOSP UWB که به‌عنوان یک مدول اختیاری بسته‌بندی شده است، com.google.android.uwb، شامل اجزای زیر است:

  • سطح میانای برنامه‌سازی کاربردی پلاتفرم فراپهن‌باند: مکان کد: packages/modules/Uwb/framework
  • کتابخانه پشتیبانی: مکان کد: packages/modules/Uwb/service/support_lib
  • لایه UwbService و عناصر «لایه مدیریت خدمات مشترک» (CSML) تعریف‌شده توسط FiRa مکان کد: packages/modules/Uwb/service
  • لایه بومی Rust برای UCI: مکان کد: external/uwb
  • میانای UWB HAL براساس مشخصات میانای فرمان UWB (UCI) که توسط FiRa تعریف شده است مکان کد: hardware/interfaces/uwb

عناصر فروشنده

پشته فروشنده شامل پیاده‌سازی فروشنده UWB HAL، درایور UWB، و دستگاه UWB است.

سطوح میانای برنامه‌سازی کاربردی برای فراپهن‌باند

پشته فراپهن‌باند شامل سطوح میانای برنامه‌سازی کاربردی برای برنامه‌های سیستم و برنامه‌های شخص ثالث است.

برنامه‌های سیستم

تولیدکنندگان دستگاه از android.uwb.UwbManager میانای برنامه‌سازی کاربردی سیستم برای ارائه دسترسی سطح پایین به برنامه‌های سیستم استفاده می‌کنند. برای استفاده از این میانای برنامه‌سازی کاربردی، برنامه‌های سیستم باید از کتابخانه پشتیبانی (packages/modules/Uwb/service/support_lib) استفاده کنند.

برنامه‌های شخص ثالث

برنامه‌های طرف سوم از Jetpack UWB public API (میانای برنامه‌سازی کاربردی عمومی فراپهن‌باند Jetpack) استفاده می‌کنند، androidx.core.uwb. برای اطلاعات بیشتر، «فراپهن‌باند»]۶ را ببینید.

درستی‌سنجی

برای درستی‌سنجی پیاده‌سازی UWB، مطمئن شوید دستگاهتان آزمون‌های CTS را در فهرست راهنمای /cts/tests/uwb با موفقیت پشت سر می‌گذارد.