本页总结了支持 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 实现。
对于支持 MEP 的设备,请参阅 对于 MEP 的 HAL 要求。
在 Radio HAL v1.1 中实现 setSimPower
调制解调器支持 setSimPower
方法。
在 IRadioConfig HAL v1.2 中实现 getSimSlotsStatus
调制解调器支持 getSimSlotsStatus
方法,该方法会指出插槽中是否有 eSIM 卡。
此方法是在 v1.0 中引入的。在 v1.2 中,SimSlotStatus
包含 EID。
在 IRadio HAL v1.4 中实现 getIccCardStatus
调制解调器在 getIccCardStatusResponse
方法中提供卡状态的复位应答 (ATR) 和插槽 ID。此方法是在 v1.0 中引入的。v1.2 中对 CardStatus
进行了更改,纳入了 ATR。
在 v1.4 中,CardStatus
包含EID。
在 SIM 卡锁定功能(subsidy 锁)上设置 CardState:RESTRICTED
如果 eSIM 卡处于 SIM 锁定(subsidy 锁定)状态,调制解调器会在 getIccCardStatusResponse
方法中将卡状态设置为 CardState:RESTRICTED
。
(可选)在 IRadioConfig HAL v1.0 中实现 setSimSlotsMapping
调制解调器支持 setSimSlotsMapping
方法,该方法能够设置从实体插槽到逻辑插槽的映射。LPA 使用此方法来选择处于有效状态的 SIM 卡插槽。
日志记录要求
以下是用于调试 eSIM 卡问题的一般调制解调器日志记录要求。
日志捕获
日志记录可捕获处理器间通信、SIM 卡功能、无线接口层 (RIL) 日志记录以及应用协议数据单元 (APDU) 日志记录。
设备上的日志记录
设备软件支持设备上的调制解调器日志捕获机制。
日志配置支持
设备软件支持不同的调制解调器日志记录配置(级别、模块)。设备上的日志记录和基于 PC 工具的日志记录都必须支持这些配置。
Android bug 报告
错误报告包含调制解调器日志、供应商 RIL 日志、应急签名日志和 Android 日志。