针对 eSIM 支持的调制解调器要求

本页总结了支持 eSIM 芯片或可卸载 eSIM 4FF 卡所需的调制解调器功能。

常规要求

以下是针对常规 eSIM 支持的调制解调器要求。只有在调制解调器满足下列所有要求时，本地配置文件助理程序 (LPA) 才可正常发挥作用。

正确处理默认启动配置文件

如果未在 eSIM 卡上启用操作或测试配置文件，则系统会启用默认启动配置文件。调制解调器应将已启用默认启动配置文件的 eSIM 卡识别为有效的 SIM 卡。调制解调器应将相应的卡报告至上层，且不应关闭 SIM 卡电源。

正确发送终端功能

接通电源后，调制解调器应向 eSIM 卡发送正确的终端功能。终端功能必须进行编码以支持 eUICC 卡功能：“本地配置文件管理”和“配置文件下载”。

请参阅 ETSI TS 102 221 第 11.1.19.2.4 节：“Additional Terminal capability indications related to eUICC”。字节 [1-3] 应为：‘83’（代码）‘01’（长度）‘07’（eUICC 功能）。

（可选）支持 eSIM 卡操作系统 OTA 更新

调制解调器应该支持 eSIM 卡操作系统 OTA 更新的所有要求，例如切换到直通模式并确保 eSIM 卡在 OTA 更新过程中一直处于通电状态。

HAL 要求

以下是常规 eSIM 卡支持所需的 API 实现。

在 Radio HAL v1.1 中实现 setSimPower API

调制解调器应该支持 setSimPower API。

在 IRadioConfig HAL v1.0 中实现 getSimSlotsStatus API

调制解调器应该支持 getSimSlotsStatus API，此 API 会指出插槽中是否有 eSIM 卡。

在 IRadio HAL v1.2 中实现 getIccCardStatus API

调制解调器应在 getIccCardStatusResponse API 中提供卡状态的复位应答 (ATR) 和插槽 ID。在 v1.0 中引入了此 API，并且在 v1.2 中，对 CardStatus 进行了更改以纳入 ATR。

在 SIM 卡锁定功能（subsidy 锁）上设置 CardState:RESTRICTED

如果 eSIM 卡处于 SIM 锁定（subsidy 锁定）状态，则调制解调器应在 getIccCardStatusResponse API 中将卡状态设置为 CardState:RESTRICTED。

（可选）在 IRadioConfig HAL v1.0 中实现 setSimSlotsMapping API

调制解调器应支持 setSimSlotsMapping API，此 API 能够设置从实体插槽到逻辑插槽的映射。LPA 使用此 API 来选择处于有效状态的 SIM 卡插槽。

日志记录要求

以下是用于调试 eSIM 卡问题的一般调制解调器日志记录要求。

日志捕获

日志记录应捕获处理器间通信、SIM 卡功能、无线接口层 (RIL) 日志记录以及应用协议数据单元 (APDU) 日志记录。

设备上的日志记录

设备软件应该支持设备上的调制解调器日志捕获机制。

日志配置支持

设备软件应该支持不同的调制解调器日志记录配置（级别、模块）。设备上的日志记录和基于 PC 工具的日志记录都应该支持这些配置。

Android 错误报告

错误报告应该包含调制解调器日志、供应商 RIL 日志、应急签名日志和 Android 日志。