UWB HAL 接口

使用合集保持井井有条 根据您的偏好保存内容并对其进行分类。

AOSP 超宽带 (UWB) 堆栈使用 FiRa 定义的 UCI 接口 作为 HAL 表面。HAL 接口使用不透明管道（IUwbChip::sendUciMessage() 和 IUwbClientCallback::onUciMessage()）来发送和接收 UWB 命令接口 (UCI) 命令、响应和通知。所有 Android UWB 供应商都必须支持所有 FiRa 规范定义的消息。UWB 框架向后兼容，并且可以与设备上 UWB 供应商实现的任何 UCI 版本配合使用。由于 AOSP UWB 框架是一个 模块，因此它还可以选择性地为主要 FiRa 标准版本草案 UCI 规范中批准的更改请求 (CR) 添加支持。任何已实现的此类草案 CR 都可能会发生更改。

接口定义

UWB HAL 接口使用 stable AIDL 定义。主接口使用 android.hardware.uwb 包。

以下是 android.hardware.uwb 包中的两个主要接口。

IUwbChip.aidl

package android.hardware.uwb;

interface IUwbChip {

 String getName();

 void open(in android.hardware.uwb.IUwbClientCallback clientCallback);

 void close();

 void coreInit();

 void sessionInit(int sessionId);

 int getSupportedAndroidUciVersion();

 int sendUciMessage(in byte[] data);

}

IUwbClientCallback.aidl

package android.hardware.uwb;

interface IUwbClientCallback {

 oneway void onUciMessage(in byte[] data);

 oneway void onHalEvent(in android.hardware.uwb.UwbEvent event, in android.hardware.uwb.UwbStatus status);

}

来自 UWB 框架的 HAL 调用流程

以下图片说明了来自 UWB 框架的 UWB 堆栈初始化、UWB 堆栈反初始化以及 UWB 会话启动和停止过程的调用流程。

图 1. UWB 堆栈初始化调用流程（UWB 开启）

图 2. UWB 堆栈反初始化调用流程（UWB 关闭）

图 3. UWB 会话启动/停止流程

UWB 国家/地区代码配置

如图 1 所示，UWB 框架在 UWB 堆栈初始化期间使用供应商空间 UCI 命令 ANDROID_SET_COUNTRY_CODE (GID=0xC, OID=0x1) 配置 UWB 国家/地区代码。UWB 框架尝试使用以下来源（按优先级顺序列出）确定 UWB 国家/地区代码。UWB 框架会在第一个确定国家/地区代码的来源处停止。

1. 替换国家/地区代码：通过 adb shell 命令强制指定的国家/地区代码（本地或自动化测试）。
2. 电话国家/地区代码：通过蜂窝网络检索的国家/地区代码。如果多个 SIM 卡返回不同的代码，则选择的国家/地区代码是不确定的。
3. Wi-Fi 国家/地区代码：通过 Wi-Fi (80211.ad) 检索的国家/地区代码。
4. 上次已知的电话国家/地区代码：上次通过蜂窝网络检索的已知国家/地区代码。如果多个 SIM 卡返回不同的代码，则选择的国家/地区代码是不确定的。
5. 位置国家/地区代码：从 LocationManager 融合位置信息提供程序检索的国家/地区代码。
6. OEM 默认国家/地区代码：设备制造商设置的国家/地区代码。

如果 UWB 框架无法确定 UWB 国家/地区代码，它会使用值 DEFAULT_COUNTRY_CODE ("00") 调用 ANDROID_SET_COUNTRY_CODE UCI 命令，并通知 UWB 应用 UWB 堆栈状态为 DISABLED。稍后，当 UWB 框架能够确定有效的国家/地区代码时，它会使用 ANDROID_SET_COUNTRY_CODE 命令配置新的国家/地区代码，并通知 UWB 应用 UWB 堆栈为 READY。

如果由于某个国家/地区的当地法规而无法使用 UWB，则 UWB 控制器会返回 STATUS_CODE_ANDROID_REGULATION_UWB_OFF 状态代码。然后，UWB 框架会通知 UWB 应用 UWB 堆栈状态为 DISABLED。

当用户前往其他国家/地区时，UWB 框架会使用 ANDROID_SET_COUNTRY_CODE UCI 命令配置新的国家/地区代码。根据 UWB 控制器返回的状态代码（基于新国家/地区的 UWB 法规），这可能会导致 UWB 堆栈状态发生变化。

FIRA UCI 规范定义的命令格式

有关 UCI 控制数据包的格式，请参阅 UCI 规范的第 4.4.2 节。

接口版本控制

UCI 规范允许 UWB 供应商使用 UCI_GET_DEVICE_INFO_RSP 和 UCI_GET_CAPS_INFO_RSP 命令公开设备实现的 UCI 堆栈版本。框架使用这些命令来获取设备的 UCI 版本，并据此更改其行为。

UWB 模块支持的草案 CR 列表

版本 #330810000 的 UWB 模块支持以下 FiRa 2.0 草案 CR

• CR 287
• CCC 数字密钥接口要求的 SUS API 和 UCI 规范支持

Android UCI 接口（FiRa 供应商部分）

UCI 规范为所有规范定义的消息定义了一组组标识符 (GID) 和操作码标识符 (OID)。该规范还保留了一组专门供供应商使用的 GID。AOSP UWB 堆栈将其中一些供应商 GID 和 OID 用于规范中未定义的特定于 Android 的命令。有关详情，请参阅 UCI 规范的第 8.4 节。

Android 使用的这些供应商消息在 android.hardware.uwb.fira_android HAL 包中定义。

供应商接口版本控制

UWB 供应商必须通过 IUwbChip.getSupportedAndroidUciVersion() 公开设备上支持的 android.hardware.uwb.fira_android HAL 包的版本。框架使用此版本控制信息来处理向后兼容性。

Android GID 和 OID 列表

下表列出了 Android 的 GID 和 OID。GID 0xE 和 0xF 保留供 Android OEM 使用。

UCI 规范定义的消息的供应商扩展

本节介绍了 UCI 规范定义的消息的供应商扩展的详细信息。

SESSION_SET_APP_CONFIG_[CMD|RSP] 和 SESSION_GET_APP_CONFIG_[CMD|RSP]

以下是由 AOSP 堆栈在 APP_CONFIG 中的 TLV 供应商保留部分定义的类型长度值 (TLV)

• GID：0001b（UWB 会话配置组）
• OID：000011b (SESSION_SET_APP_CONFIG_CMD)
• OID：000100b (SESSION_GET_APP_CONFIG_CMD)

下表列出了 UWB 会话配置消息的参数。

CORE_GET_CAPS_INFO_RSP

以下是由 AOSP 堆栈在 CAPS_INFO 中的 TLV 供应商保留部分定义的 TLV

• GID：0000b（UWB 核心组）
• OID：000011b (CORE_GET_CAPS_INFO_RSP)

下表列出了 UWB 功能消息的参数。

状态代码

以下是供应商空间中的状态代码。这些代码由 UWB 子系统 (UWBS) 在 UCI 响应（例如 SESSION_START_RSP）中返回。

SESSION_STATUS_NTF 中的状态更改原因代码

以下是在供应商空间中为 SESSION_STATUS_NTF 中 UWBS 返回的状态字段定义的状态更改原因代码。当测距会话的状态更改时（例如，从 ACTIVE 更改为 IDLE），UWBS 会发送此通知。