自 2025 年 3 月 27 日起,我们建议您使用 android-latest-release
而非 aosp-main
构建 AOSP 并为其做出贡献。如需了解详情,请参阅 AOSP 的变更。
UWB
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
Android 13 中引入的超宽带 (UWB) 模块在 HAL 接口之上包含一个 UWB 堆栈,该堆栈采用 FiRa 规范。
UWB 模块可为设备制造商带来以下好处:
- 提供适用于支持 UWB 的设备的完整 Android 原生 UWB 堆栈
- 提高了整个 Android 生态系统中 UWB 的质量和互操作性
- 针对新的 FiRa 用例和规范更新提供更快、更灵活的支持
详细信息
UWB 模块的详细信息如下:
- Android 13 中的 AOSP 中包含完整的 UWB 堆栈,该堆栈使用 FiRa 定义的 UCI 规范作为 HAL 接口。
- 支持系统应用配置自定义配置文件。
- 包含一个系统 API Surface,支持系统应用在其范围确定会话中使用自定义配置文件。
- 包含用于公开 RRO 的基础架构,设备制造商可以使用 RRO 自定义堆栈的行为。
UWB 堆栈架构
UWB 堆栈由 UWB Mainline 模块和 UWB 芯片供应商提供的 HAL 实现组成。
图 1. UWB 堆栈架构
模块边界
模块代码位于以下位置:
UWB 模块 (com.google.android.uwb
) 使用 APEX 格式。
依赖项
UWB Mainline 模块依赖于以下各项:
- UWB 芯片供应商提供的 HAL 实现。
- 适用于所有 OOB 交互的蓝牙堆栈。
- 适用于所有安全服务交互的安全元件。
- 强制执行 UWB 运行时权限的核心框架。
本页面上的内容和代码示例受内容许可部分所述许可的限制。Java 和 OpenJDK 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-03-10。
[null,null,["最后更新时间 (UTC):2025-03-10。"],[],[],null,["# UWB\n\nThe ultra-wideband (UWB) module, introduced in Android 13, contains a UWB stack\nabove the HAL interface, which is based on the FiRa specification.\n\nThe UWB module provides the following benefits for device manufacturers:\n\n- A complete Android native UWB stack available for UWB capable devices\n- Improved quality and interoperability of UWB across the Android ecosystem\n- Faster and more flexible support for new FiRa use cases and specification updates\n\n### Details\n\nThe following are details of the UWB module:\n\n- Includes a complete UWB stack in AOSP in Android 13 that uses the UCI specification defined by FiRa as the HAL interface.\n- Allows system apps to provision custom profiles.\n- Includes a system API surface to allows system apps to use custom profiles in their ranging sessions.\n- Includes infrastructure to expose RROs that can be used by device manufacturers to customize the behavior of the stack.\n\nUWB stack architecture\n----------------------\n\nThe UWB stack consists of the UWB mainline module and the HAL implementation\nprovided by a UWB chip vendor.\n\n**Figure 1.** UWB stack architecture\n\nModule boundary\n---------------\n\nThe module code is in the following locations:\n\n- **UWB Mainline Apex** : `com.android.uwb`\n\n - UWB API surface (Java)\n\n - Code location: `packages/modules/Uwb/framework`\n - Process: `\u003cbootclasspath\u003e`\n - UwbService (Java)\n\n - Code location: `packages/modules/Uwb/service`\n - Process: `system_server`\n - Uwb Native stack (C++/Rust)\n\n - Code location: `external/uwb`\n - Process: `system_server`\n- **HAL interface and implementations (C++)**\n\n - Interface code location: `hardware/interfaces/uwb`\n - Implementation code location: `vendor/\u003cvendor-name\u003e/uwb`\n - Process: `\u003cvendor defined\u003e`\n\nPackage format\n--------------\n\nThe UWB module (`com.google.android.uwb`) uses the\n[APEX](/docs/core/ota/apex) format.\n\nDependencies\n------------\n\nThe UWB mainline module depends on the following:\n\n- HAL implementation from a UWB chip vendor.\n- Bluetooth stack for all OOB interactions.\n- Secure element for all secure service interactions.\n- Core framework for UWB runtime permission enforcement."]]