החל מ-27 במרץ 2025, מומלץ להשתמש ב-android-latest-release
במקום ב-aosp-main
כדי ליצור תרומות ל-AOSP. מידע נוסף זמין במאמר שינויים ב-AOSP.
Ultra Wideband (UWB)
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
החל מ-Android 13, מערכת Android כוללת הטמעה של מסגרת ברירת מחדל לטכנולוגיית רדיו של תדר רחב במיוחד (UWB). טכנולוגיה שמאפשרת למדוד טווחים בצורה מאובטחת ומדויקת מאוד בין מכשירים נתמכים. סטאק UWB של פלטפורמת AOSP זמין כמודול אופציונלי ליצרני מכשירים.
פרטים נוספים על המודול זמינים במאמר מודול: UWB.
ארכיטקטורה
סטאק UWB מורכב מהמודול הראשי של UWB ומהטמעת HAL שספק הצ'יפים של UWB מספק, כפי שמוצג באיור 1.
איור 1. ארכיטקטורת מחסנית UWB
סטאק AOSP
סטאק UWB של AOSP, שמארז כמודול אופציונלי, com.google.android.uwb
, מכיל את הרכיבים הבאים:
- ממשק ה-API של פלטפורמת UWB
- מיקום הקוד:
packages/modules/Uwb/framework
- ספריית תמיכה
- מיקום הקוד:
packages/modules/Uwb/service/support_lib
- שכבת UwbService ושכבת ניהול שירותים משותפת (CSML) – רכיבים מוגדרים לפי FiRa
- מיקום הקוד:
packages/modules/Uwb/service
- שכבת UCI מקורית ב-Rust
- ממשק HAL של UWB שמבוסס על מפרט ממשק הפקודה (UCI) של UWB שמוגדר על ידי FiRa
- מיקום הקוד:
hardware/interfaces/uwb
רכיבים של ספקים
סטאק הספק כולל הטמעה של UWB HAL של ספק, מנהל UWB ומכשיר UWB.
ממשקי API ל-UWB
מקבץ ה-UWB כולל ממשקי API לאפליקציות מערכת ולאפליקציות צד שלישי.
אפליקציות מערכת
יצרני המכשירים משתמשים בממשק ה-API של המערכת android.uwb.UwbManager
כדי לאפשר לאפליקציות מערכת גישה ברמה נמוכה. כדי להשתמש בממשק ה-API הזה, אפליקציות מערכת צריכות להשתמש בספריית התמיכה (packages/modules/Uwb/service/support_lib
).
אפליקציות של צד שלישי
אפליקציות של צד שלישי משתמשות בממשק ה-API הציבורי של Jetpack UWB, androidx.core.uwb
.
מידע נוסף זמין במאמר תקשורת ברצועה רחבה במיוחד.
אימות
כדי לאמת את ההטמעה של UWB, צריך לוודא שהמכשיר עובר את בדיקות ה-CTS שמפורטות בקטע /cts/tests/uwb
.
דוגמאות התוכן והקוד שבדף הזה כפופות לרישיונות המפורטים בקטע רישיון לתוכן. Java ו-OpenJDK הם סימנים מסחריים או סימנים מסחריים רשומים של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-07-27 (שעון UTC).
[[["התוכן קל להבנה","easyToUnderstand","thumb-up"],["התוכן עזר לי לפתור בעיה","solvedMyProblem","thumb-up"],["סיבה אחרת","otherUp","thumb-up"]],[["חסרים לי מידע או פרטים","missingTheInformationINeed","thumb-down"],["התוכן מורכב מדי או עם יותר מדי שלבים","tooComplicatedTooManySteps","thumb-down"],["התוכן לא עדכני","outOfDate","thumb-down"],["בעיה בתרגום","translationIssue","thumb-down"],["בעיה בדוגמאות/בקוד","samplesCodeIssue","thumb-down"],["סיבה אחרת","otherDown","thumb-down"]],["עדכון אחרון: 2025-07-27 (שעון UTC)."],[],[],null,["# Ultra-wideband\n\nFrom Android 13, Android includes a default framework\nimplementation for ultra-wideband (UWB) radio technology, a technology that\nenables highly secure, precise ranging between supported devices. The platform\nAOSP UWB stack is available as an optional\n[module](/docs/core/architecture/modular-system) for device manufacturers.\nFor more details on the module, see\n[Module: UWB](/docs/core/ota/modular-system/uwb).\n\nArchitecture\n------------\n\nThe UWB stack consists of the UWB mainline module and the HAL implementation\nprovided by a UWB chip vendor as shown in Figure 1.\n\n**Figure 1.** UWB stack architecture\n\n### AOSP stack\n\nThe AOSP UWB stack, packaged as an optional module, `com.google.android.uwb`,\ncontains the following components:\n\n- UWB platform API surface\n - Code location: `packages/modules/Uwb/framework`\n- Support library\n - Code location: `packages/modules/Uwb/service/support_lib`\n- UwbService layer and Common Service Management Layer (CSML) defined components defined by [FiRa](https://www.firaconsortium.org/)\n - Code location: `packages/modules/Uwb/service`\n- Rust native UCI layer\n - Code location: `external/uwb`\n- UWB HAL interface based on the UWB command interface (UCI) specification defined by [FiRa](https://www.firaconsortium.org/)\n - Code location: `hardware/interfaces/uwb`\n\n### Vendor components\n\nThe vendor stack includes a UWB HAL vendor implementation, UWB driver, and a\nUWB device.\n\nAPI surfaces for UWB\n--------------------\n\nThe UWB stack includes API surfaces for system apps and third-party apps.\n\n### System apps\n\nDevice manufacturers use the\n[`android.uwb.UwbManager`](https://cs.android.com/android/platform/superproject/+/android-latest-release:packages/modules/Uwb/framework/java/android/uwb/UwbManager.java)\nsystem API surface to allow low-level access for system apps. To use this\nAPI surface, system apps must use the support library\n(`packages/modules/Uwb/service/support_lib`).\n\n### Third-party apps\n\nThird-party apps use the Jetpack UWB public API surface,\n[`androidx.core.uwb`](https://developer.android.com/reference/kotlin/androidx/core/uwb/package-summary).\nFor more information, see\n[Ultra-wide band communication](https://developer.android.com/guide/topics/connectivity/uwb).\n\nVerification\n------------\n\nTo verify your implementation of UWB, ensure that your device passes the CTS\ntests located under `/cts/tests/uwb`."]]