UICC--Android O

Uicc card

关于这部分的流程，UiccController.java中的注释写的很清楚，先把这部分注释拿出来，如下：

 * Once created UiccController registers with RIL for "on" and "unsol_sim_status_changed"
 * notifications. When such notification arrives UiccController will call
 * getIccCardStatus (GET_SIM_STATUS). Based on the response of GET_SIM_STATUS
 * request appropriate tree of uicc objects will be created.
 *
 * Following is class diagram for uicc classes:
                              UiccController
                                      #
                                      |
                                  UiccCard
                                    #   #
                                    |     ------------------
                        UiccCardApplication            CatService
                               #          #
                               |          |
                        IccRecords    IccFileHandler
                        ^ ^ ^          ^ ^ ^ ^ ^
          SIMRecords----  | |          | | | | ---SIMFileHandle
           RuimRecords----  |          | | | ----RuimFileHandler
          IsimUiccRecords---           | | -----UsimFileHandler
                                       | -------CsimFileHandler
                                       -----IsimFileHandler

上面的注释是简单明了，按照代码流程看几遍，记住每个类的主要作用， 这部分也就算是掌握了。

UiccController

UiccController是在PhoneApp启动的过程中创建的，算是这部分知识的一个起点;UiccController构造函数里面便注册了RIL监听， 后续根据这些监听反馈便逐层创建了各个对象。
比较重要的两个点：
1.调用Ril的getIccCardStatus方法向modem查询card的状态。
2.用onGetIccCardStatusDone方法处理modem的反馈结果，UiccCard对象就是在这个方法里面创建的。

UiccCard

UiccCard—每个对象对应一张卡。
1.创建UiccCardApplication—每张卡最多有8个应用。
2.创建Catservice。
3.通过这个对象提供的API可以获取Card state，application等信息。
UiccCard的update方法用来更新对象的内部信息，方法如下：

 public void update(Context c, CommandsInterface ci, IccCardStatus ics) {
        synchronized (mLock) {
            CardState oldState = mCardState;
            mCardState = ics.mCardState;//更新card state
            mUniversalPinState = ics.mUniversalPinState;//更新pin state
            mGsmUmtsSubscriptionAppIndex = ics.mGsmUmtsSubscriptionAppIndex;//更新application的index，下面两句也是这个作用.
            mCdmaSubscriptionAppIndex = ics.mCdmaSubscriptionAppIndex;
            mImsSubscriptionAppIndex = ics.mImsSubscriptionAppIndex;
            mContext = c;
            mCi = ci;

            //update applications
            if (DBG) log(ics.mApplications.length + " applications");
            for ( int i = 0; i < mUiccApplications.length; i++) {
            //下面这段代码用来创建/删除UiccCardApplication对象。
                if (mUiccApplications[i] == null) {
                    //Create newly added Applications
                    if (i < ics.mApplications.length) {
                        mUiccApplications[i] = new UiccCardApplication(this,
                                ics.mApplications[i], mContext, mCi);
                    }
                } else if (i >= ics.mApplications.length) {
                    //Delete removed applications
                    mUiccApplications[i].dispose();
                    mUiccApplications[i] = null;
                } else {
                    //Update the rest
                    mUiccApplications[i].update(ics.mApplications[i], mContext, mCi);
                }
            }

            createAndUpdateCatService();//catservice相关的操作。

            // Reload the carrier privilege rules if necessary.
            log("Before privilege rules: " + mCarrierPrivilegeRules + " : " + mCardState);
            if (mCarrierPrivilegeRules == null && mCardState == CardState.CARDSTATE_PRESENT) {
                mCarrierPrivilegeRules = new UiccCarrierPrivilegeRules(this,
                        mHandler.obtainMessage(EVENT_CARRIER_PRIVILIGES_LOADED));
            } else if (mCarrierPrivilegeRules != null && mCardState != CardState.CARDSTATE_PRESENT) {
                mCarrierPrivilegeRules = null;
            }

            sanitizeApplicationIndexes();//通过判断Application是否有效来确定application index有效性.

            RadioState radioState = mCi.getRadioState();
            if (DBG) log("update: radioState=" + radioState + " mLastRadioState="
                    + mLastRadioState);
            // No notifications while radio is off or we just powering up
            if (radioState == RadioState.RADIO_ON && mLastRadioState == RadioState.RADIO_ON) {
            //下面这段代码用于提示用户卡插入或者拔出，重启手机。
                if (oldState != CardState.CARDSTATE_ABSENT &&
                        mCardState == CardState.CARDSTATE_ABSENT) {
                    if (DBG) log("update: notify card removed");
                    mAbsentRegistrants.notifyRegistrants();
                    mHandler.sendMessage(mHandler.obtainMessage(EVENT_CARD_REMOVED, null));
                } else if (oldState == CardState.CARDSTATE_ABSENT &&
                        mCardState != CardState.CARDSTATE_ABSENT) {
                    if (DBG) log("update: notify card added");
                    mHandler.sendMessage(mHandler.obtainMessage(EVENT_CARD_ADDED, null));
                }
            }
            mLastRadioState = radioState;
        }
    }

上面update方法根据卡的状态变化发出EVENT_CARD_REMOVED/EVENT_CARD_ADDED 消息，handler处理这两个消息时会调用onIccSwap(boolean isAdded) 方法。

    private void onIccSwap(boolean isAdded) {
        boolean isHotSwapSupported = mContext.getResources().getBoolean(//判断是否支持热插拔。
                R.bool.config_hotswapCapable);
        if (isHotSwapSupported) {//如果支持热插拔就不需要重启手机。
            log("onIccSwap: isHotSwapSupported is true, don't prompt for rebooting");
            return;
        }
        log("onIccSwap: isHotSwapSupported is false, prompt for rebooting");

        promptForRestart(isAdded);//用于不支持热插拔时，提示用户重启手机，并调用PowerManager
    }

UiccCardApplication

1.内部存储了Pin1，Pin2， FDN等信息; 所以可以通过这个对象提供的API来查询这些信息。
2.内部有IccFileHandler，SIMRecords对象; 可以通过这个对象提供的API来获取这两个对象。

SIMRecords

IccRecords有三个子类，分别对应了一种卡，主要看看SIMRecords。
1.fetchSimRecords是重要的一个方法， 这个方法获取了卡里的很多数据，像IMSI, Spn，PLMN，PNN, CPHS等;SIM refresh，ready时会调用该方法。
2.SIMRecords对象在RIL里注册了SIM refresh监听，在UiccCardApplication里面注册了app ready/lock事件，还注册了ACTION_CARRIER_CONFIG_CHANGED的广播(用于spn的override)。

IccCardProxy

另外IccCardProxy也要说下，根据这个名字也能猜到这个类的大致作用; 这个类实现了IccCard接口，根据注释，
这个接口是为了外部应用(主要是PhoneApp)可以方便的操作icc card相关的功能，这当然也是IccCardProxy的作用了。
这个类的对象是在phone对象初始化的过程中创建的，我们通过phone.getIccCard()获取的也是这个类的对象。
由于这个类的作用是方便外部应用操作icc card相关的功能， 所以这个类的方法很多， 而具体方法里的实现自然要用到UiccController，Uicard, UiccCardApplication, IccRecords和IccFileHandler。IccCardProxy 会通过ACTION_SIM_STATE_CHANGED 将SIM state发出去。当IccCardProxy收到IccCardConstants.INTENT_VALUE_ICC_LOCKED的状态，SIMRecords的records loaded以及UiccCard 的EVENT_CARRIER_PRIVILIGES_LOADED的通知后，还会发送ACTION_INTERNAL_SIM_STATE_CHANGED广播。

ICC Card状态(IccCardStatus.CardState)

CARDSTATE_ABSENT,
CARDSTATE_PRESENT,
CARDSTATE_ERROR,
CARDSTATE_RESTRICTED;

SIM状态(IccCardConstants.State)

UNKNOWN,        /** ordinal(0) == {@See TelephonyManager#SIM_STATE_UNKNOWN} */
ABSENT,         /** ordinal(1) == {@See TelephonyManager#SIM_STATE_ABSENT} */
PIN_REQUIRED,   /** ordinal(2) == {@See TelephonyManager#SIM_STATE_PIN_REQUIRED} */
PUK_REQUIRED,   /** ordinal(3) == {@See TelephonyManager#SIM_STATE_PUK_REQUIRED} */
NETWORK_LOCKED, /** ordinal(4) == {@See TelephonyManager#SIM_STATE_NETWORK_LOCKED} */
READY,          /** ordinal(5) == {@See TelephonyManager#SIM_STATE_READY} */
NOT_READY,      /** ordinal(6) == {@See TelephonyManager#SIM_STATE_NOT_READY} */
PERM_DISABLED,  /** ordinal(7) == {@See TelephonyManager#SIM_STATE_PERM_DISABLED} */
CARD_IO_ERROR,  /** ordinal(8) == {@See TelephonyManager#SIM_STATE_CARD_IO_ERROR} */
CARD_RESTRICTED;/** ordinal(9) == {@See TelephonyManager#SIM_STATE_CARD_RESTRICTED} */

icc card的状态比较好理解，通过UiccCard的getCardState方法可以获取。
我们比较常用的是SIM状态，可以通过TelephonyManger提供的getSimState(int slotIndex)/getSimState() 这两个API获取。getSimState(int slotIndex)/getSimState()内部进一步调用了SubscriptionController里面的方法getSimStateForSlotIndex(int index)，而getSimStateForSlotIndex(int index)进一步调用了IccCardProxy的getState()方法，所以如果可以获取GsmCdmaPhone对象，可以通过getIccCard()方法获取IccCardProxy对象，进而调用getState()方法获取SIM状态。getState()方法只是返回了一个成员变量mExternalState，而这个变量值的更新是通过IccCardProxy在UiccController，UiccCard以及UiccApplication里面注册的监听驱动的(registerUiccCardEvents方法), 这个成员变量的赋值操作是通过setExternalState方法，下面几个情况会调用这个方法：
1.构造函数State.NOT_READY
2.updateQuietMode

• EVENT_CDMA_SUBSCRIPTION_SOURCE_CHANGED
• EVENT_RADIO_ON
• setVoiceRadioTech

3.handleMessage

• EVENT_RADIO_OFF_OR_UNAVAILABLE
• EVENT_ICC_ABSENT
• EVENT_APP_READY
• EVENT_NETWORK_LOCKED

4.updateExternalState

• updateIccAvailability<–EVENT_ICC_CHANGED
• onSubscriptionActivated<–EVENT_SUBSCRIPTION_ACTIVATED
• onSubscriptionDeactivated<–EVENT_SUBSCRIPTION_DEACTIVATED

5.processLockedState

• handleMessage:EVENT_ICC_LOCKED

SIM state的定义是综合了IccCardStatus.CardState，IccCardStatus.PinState以及IccCardApplicationStatus.AppState。
下面的表格根据IccCardProxy里面的代码逻辑，总结了SIM state各个状态所依赖的条件。

SIM state	Depends on
State.UNKNOWN	UNKNOWN只是一个短暂的状态， 比如在一些状态转换的时候会处于该状态。除了APPSTATE_UNKNOWN时为UNKOWN外，UNKNOWN也被用于其他特殊情况。
State.ABSENT	CARDSTATE_ABSENT
State.NOT_READY	Radio 不可用， 获取不到UiccCard或者UiccApplication对象的情况下设置为此状态。
State.READY	APPSTATE_READY CARDSTATE_PRESENT
State.PIN_REQUIRED	APPSTATE_PIN
State.PUK_REQUIRED	APPSTATE_PUK
State.NETWORK_LOCKED	APPSTATE_SUBSCRIPTION_PERSO, SIMLock开启时
State.PERM_DISABLED	PinState.PINSTATE_ENABLED_PERM_BLOCKED
State.CARD_IO_ERROR	CARDSTATE_ERROR
State.CARD_RESTRICTED	CARDSTATE_RESTRICTED

---

开机SIM状态更新

命令GET_SIM_STATUS, 首先返回CARDSTATE_ABSENT, 然后是CARDSTATE_PRESENT, 这些RIL消息里面会带有PIN lock等信息。

onRecordLoaded

对于SIMRecords中的onRecordLoaded方法， 从定义和调用角度考虑，分成两部分：

1. 在IccRecords中定义的onRecordLoaded方法，子类SIMRecords复写了该方法。
   IccRecords的handleMessage(EVENT_GET_ICC_RECORD_DONE)中调用该方法,
   SIMRecords重写了IccRecords的handleMessage方法(在default中调用IccRecords的handleMessage方法)，
   对onRecordLoaded的调用也做了调整，将调用放在了handleMessage的末尾，通过变量isRecordLoadResponse做调用控制，所有需要调用该方法的EVENT可以将isRecordLoadResponse赋值为true。该方法会调用onAllRecordsLoaded(所有records都加载完成时)，onAllRecordsLoaded除了保存一些数据之外还会通知监听了records loaded的观察者，比如IccCardProxy。
2. 在IccRecords中的接口IccRecordLoaded中定义的onRecordLoaded方法，SIMRecords中的私有类EfPlLoaded和EfUsimLiLoaded都实现了IccRecordLoaded接口,
   也实现了onRecordLoaded方法。 接口IccRecordLoaded是用来作为call
   back的，根据code，是作为EVENT_GET_ICC_RECORD_DONE的call
   back用来获取EF_LI和EF_PL这两个文件的值(SIMRecords.loadEfLiAndEfPl)。