【笔记】EF文件中定义的SPN显示协议规则

规则配置

SPN_bit 和PLMN_bit对应EF_SPN的bit1和bit2

如EF_SPN: bit1=0；bit2 = 0，则HOME显示SPN，ROAMING显示SPN-PLMN

SPN_bit = 2, PLMN_bit = 0 显示SPN，不显示PLMN。

客制化通过CarrierConfig “spn_display_condition_override_int” 覆写SIM EF显示规则。

**spn_display_condition_override_int**
	显示规则	EF_SPN	Bit2	Biit1
-1	默认，按协议文件上报 SIM卡内EF_SPN信息规定的规则	-	-	-
0	HOME显示SPN，ROAMING显示PLMN	bit1=0；bit2 = 1	1	0
1	HOME显示SPN-PLMN，ROAMING显示PLMN	bit1=1；bit2 = 1	1	1
2	HOME显示SPN，ROAMING显示SPN-PLMN	bit1=0；bit2 = 0	0	0
3	HOME显示SPN-PLMN，ROAMING显示SPN-PLMN	bit1=1；bit2 = 0	0	1
4	客制化，比如HOME和漫游均显示PLMN	-	-	-

代码

AOSP

源码：https://cs.android.com/

CarrierDisplayNameResolver

frameworks/opt/telephony/src/java/com/android/internal/telephony/cdnr/CarrierDisplayNameResolver.java

    //判断是否漫游private boolean isRoaming() {// Currently use the roaming state from ServiceState.// EF_SPDI is only used when determine the service provider name and PLMN network name// display condition rule.// All the PLMNs will be considered HOME PLMNs if there is a brand override.return getServiceState().getRoaming()&& !getEfSpdi().contains(getServiceState().getOperatorNumeric());}//从SIM EF获取运营商名称显示规则private CarrierDisplayNameData getCarrierDisplayNameFromEf() {CarrierDisplayNameConditionRule displayRule = getDisplayRule();String registeredPlmnName = getServiceState().getOperatorAlpha();String registeredPlmnNumeric = getServiceState().getOperatorNumeric();String spn = getEfSpn();// Resolve the PLMN network nameList<OperatorPlmnInfo> efOpl = getEfOpl();List<PlmnNetworkName> efPnn = getEfPnn();String plmn = null;if (isRoaming()) {plmn = registeredPlmnName;} else {if (efOpl.isEmpty()) {// If the EF_OPL is not present, then the first record in EF_PNN is used for the// default network name when registered in the HPLMN or an EHPLMN(if the EHPLMN// list is present).plmn = efPnn.isEmpty() ? "" : getPlmnNetworkName(efPnn.get(0));} else {// TODO: Check the TAC/LAC & registered PLMN numeric in OPL list to determine which// PLMN name should be used to override the current one.}}// If no PLMN override is present, then the PLMN should be displayed:// - operator alpha if it's not empty.// - operator numeric.if (TextUtils.isEmpty(plmn)) {plmn = TextUtils.isEmpty(registeredPlmnName) ? registeredPlmnNumeric: registeredPlmnName;}boolean showSpn = displayRule.shouldShowSpn(spn);boolean showPlmn = TextUtils.isEmpty(spn) || displayRule.shouldShowPlmn(plmn);//加点debug logRlog.d(TAG, "getCarrierDisplayNameFromEf displayRule = " + displayRule + "; spn = " + spn + "; plmn = " + plmn + "; showSpn = " + showSpn + "; showPlmn = " + showPlmn);return new CarrierDisplayNameData.Builder().setSpn(spn).setShowSpn(showSpn).setPlmn(plmn).setShowPlmn(showPlmn).build();}//获取显示规则@NonNullprivate CarrierDisplayNameConditionRule getDisplayRule() {boolean isRoaming = isRoaming();for (int i = 0; i < mEf.size(); i++) {if (mEf.valueAt(i).getServiceProviderNameDisplayCondition(isRoaming)!= IccRecords.INVALID_CARRIER_NAME_DISPLAY_CONDITION_BITMASK) {return new CarrierDisplayNameConditionRule(mEf.valueAt(i).getServiceProviderNameDisplayCondition(isRoaming));}}return DEFAULT_CARRIER_DISPLAY_NAME_RULE;}

EfData

/frameworks/opt/telephony/src/java/com/android/internal/telephony/cdnr/EfData.java

    /*** Get the display condition of service provider name and PLMN network name. The display* condition has two bits(lsb). Service provider name display is required if the first bit* is set to 1. PLMN network name display is required if the second bit is set to 1.** @see {@link IccRecords#CARRIER_NAME_DISPLAY_CONDITION_BITMASK_PLMN}* @see {@link IccRecords#CARRIER_NAME_DISPLAY_CONDITION_BITMASK_SPN}** Reference: 3GPP TS 131.102 Section 4.2.12 EF_SPN** @retrun the bitmask of display condition or {@link com.android.internal.telephony.uicc* .IccRecords.INVALID_CARRIER_NAME_DISPLAY_CONDITION_BITMASK} if it's not existed.*/@CarrierNameDisplayConditionBitmaskdefault int getServiceProviderNameDisplayCondition(boolean isRoaming) {return IccRecords.INVALID_CARRIER_NAME_DISPLAY_CONDITION_BITMASK;}

IccRecords

frameworks/opt/telephony/src/java/com/android/internal/telephony/uicc/IccRecords.java

IccRecords的KEY值INVALID_CARRIER_NAME_DISPLAY_CONDITION_BITMASK 对应CarrierConfig中的“spn_display_condition_override_int”字符配置

/*** {@hide}*/
public abstract class IccRecords extends Handler implements IccConstants {private static final String LOG_TAG = "IccRecords";// See {@link CarrierConfigManager#KEY_SPN_DISPLAY_CONDITION_OVERRIDE_INT}.public static final int INVALID_CARRIER_NAME_DISPLAY_CONDITION_BITMASK = -1;
}

CarrierConfigManager

frameworks/base/telephony/java/android/telephony/CarrierConfigManager.java

    /*** Override the SPN Display Condition 2 integer bits (lsb). B2, B1 is the last two bits of the* spn display condition coding.** The default value -1 mean this field is not set.** B1 = 0: display of registered PLMN name not required when registered PLMN is either HPLMN* or a PLMN in the service provider PLMN list (see EF_SPDI).* B1 = 1: display of registered PLMN name required when registered PLMN is either HPLMN or a* PLMN in the service provider PLMN list(see EF_SPDI).* B2 = 0: display of the service provider name is required when registered PLMN is neither* HPLMN nor a PLMN in the service provider PLMN list(see EF_SPDI).* B2 = 1: display of the service provider name is not required when registered PLMN is neither* HPLMN nor a PLMN in the service provider PLMN list(see EF_SPDI).** Reference: 3GPP TS 31.102 v15.2.0 Section 4.2.12 EF_SPN.* @hide*/public static final String KEY_SPN_DISPLAY_CONDITION_OVERRIDE_INT ="spn_display_condition_override_int";

AOSP逻辑，spn_display_condition_override_int值的映射功能关系，默认值是-1。

//比如CarrierConfigEfData对象初始化在获取显示规制时，
//会赋值IccRecords.INVALID_CARRIER_NAME_DISPLAY_CONDITION_BITMASKpublic CarrierConfigEfData(@NonNull PersistableBundle config) {// Save only the relevant keys of the config.mSpn = config.getString(CarrierConfigManager.KEY_CARRIER_NAME_STRING);mSpnDisplayCondition = config.getInt(CarrierConfigManager.KEY_SPN_DISPLAY_CONDITION_OVERRIDE_INT,IccRecords.INVALID_CARRIER_NAME_DISPLAY_CONDITION_BITMASK);mSpdi = config.getStringArray(CarrierConfigManager.KEY_SPDI_OVERRIDE_STRING_ARRAY);mEhplmn = config.getStringArray(CarrierConfigManager.KEY_EHPLMN_OVERRIDE_STRING_ARRAY);mPnn = config.getStringArray(CarrierConfigManager.KEY_PNN_OVERRIDE_STRING_ARRAY);mOpl = config.getStringArray(CarrierConfigManager.KEY_OPL_OVERRIDE_STRING_ARRAY);}

SubscriptionManagerService

frameworks/opt/telephony/src/java/com/android/internal/telephony/subscription/SubscriptionManagerService.java

此处获取displayNameSourse

    /*** Set display name of a subscription.** @param displayName The display name of SIM card.* @param subId The subscription id.* @param nameSource The display name source.** @return the number of records updated** @throws IllegalArgumentException if {@code nameSource} is invalid, or {@code subId} is* invalid.* @throws NullPointerException if {@code displayName} is {@code null}.* @throws SecurityException if callers do not hold the required permission.*/@Override@RequiresPermission(Manifest.permission.MODIFY_PHONE_STATE)public int setDisplayNameUsingSrc(@NonNull String displayName, int subId,@SimDisplayNameSource int nameSource) {enforcePermissions("setDisplayNameUsingSrc", Manifest.permission.MODIFY_PHONE_STATE);String callingPackage = getCallingPackage();final long identity = Binder.clearCallingIdentity();try {Objects.requireNonNull(displayName, "setDisplayNameUsingSrc");

OEM 可继承此类进行客制化

    @Overridepublic int setDisplayNameUsingSrc(String displayName, int subId,@SimDisplayNameSource int displayNameSource) {if (DBG) {logd("[setDisplayName]+  displayName:" + displayName + " subId:" + subId+ " displayNameSource:" + displayNameSource);}}

onCheckIfSubscriptionLoaded -> updateSubName -> setDisplayNameUsingSrc

日志分析

底层上报OPERATOR，是从SIM的“OPL/PNN”文件里面获取的。

04-09 06:13:40.771010 2141 2644 D RILJ : [0258]< OPERATOR {Movistar, Movistar, 73002} [PHONE0]

04-09 06:13:40.925365 2141 2141 D SMSVC: [setDisplayName]+ displayName:SPN TEST subId:2 displayNameSource:1

上层应用设置显示SIM卡名称或运营商名称一般从以下接口获取