关闭

Uicc之UiccController(原)

标签: Telephony源码框架Android
2082人阅读 评论(1) 收藏 举报
分类:

        UiccController是整个UICC事务处理的入口,负责对外提供IccRecords、IccFileHandler、UiccCardApplication等对象,并完成整个UICC系统的初始化工作。


一、UiccController提供的主要功能


        我们通过其提供的public方法来看他的主要功能:
        public UiccCard getUiccCard() {}
        public UiccCardApplication getUiccCardApplication(int family) {}
        public IccRecords getIccRecords(int family) {}
        public IccFileHandler getIccFileHandler(int family) {}
        public void registerForIccChanged(Handler h, int what, Object obj) {}

        从上面提供的方法可以知道,UiccController的主要作用体现在两个方面:

        1、创建并向外提供UiccCard、UiccCardApplication、IccRecords、IccFileHandler等对象

        2、提供对SIM状态的监听


二、UiccController的创建过程


        我们先来看一下UiccController是在哪里被创建的。

        我们知道,Phone对象是在Phone模块的初始化中通过PhoneFactory创建的:
        @PhoneGlobals.java
        public void onCreate() {
            if (phone == null) {
                //创建Phone对象
                PhoneFactory.makeDefaultPhones(this);
                //得到Phone对象
                phone = PhoneFactory.getDefaultPhone();
            }
        }
        然后看makeDefaultPhones()的过程:
        @PhoneFactory.java
        public static void makeDefaultPhones(Context context) {
            makeDefaultPhone(context);
        }
        public static void makeDefaultPhone(Context context) { 
            //获取RILJ
            sCommandsInterface = new RIL(context, networkMode, cdmaSubscription);
            //创建UiccController
            UiccController.make(context, sCommandsInterface);
            //得到phone的Type
            int phoneType = TelephonyManager.getPhoneType(networkMode);
            //创建PhoneProxy对象
            if (phoneType == PhoneConstants.PHONE_TYPE_GSM) {
                sProxyPhone = new PhoneProxy(new GSMPhone(context, sCommandsInterface, sPhoneNotifier));
            } else if (phoneType == PhoneConstants.PHONE_TYPE_CDMA) {
                switch (TelephonyManager.getLteOnCdmaModeStatic()) {
                    case PhoneConstants.LTE_ON_CDMA_TRUE:
                        sProxyPhone = new PhoneProxy(new CDMALTEPhone(context, sCommandsInterface, sPhoneNotifier));
                        break;
                    case PhoneConstants.LTE_ON_CDMA_FALSE:
                    default:
                        sProxyPhone = new PhoneProxy(new CDMAPhone(context, sCommandsInterface, sPhoneNotifier));
                        break;
                }
            }
        }
        这里看到,在new完RIL对象之后,就通过UiccController的make()方法对UiccController进行创建,而且传递进去的两个参数,其中一个是Context类型对象,另一个是CommandsInterface类型的RIL对象。
        接下来我们通过UiccController的make()方法来看具体的创建过程:
        @UiccController.java
        public static UiccController make(Context c, CommandsInterface ci) {
            synchronized (mLock) {
                if (mInstance != null) {
                    throw new RuntimeException("UiccController.make() should only be called once");
                }
                mInstance = new UiccController(c, ci);
                return mInstance;
            }
        }
        这里需要注意,UiccController的make()方法只能调用一次,也就是说,在整个全局中,只存在一个UiccController对象
        private UiccController(Context c, CommandsInterface ci) {
            mContext = c;
            mCi = ci;
            mCi.registerForIccStatusChanged(this, EVENT_ICC_STATUS_CHANGED, null);
            mCi.registerForOn(this, EVENT_ICC_STATUS_CHANGED, null);
        }

        我们看到,在UiccController的构造函数中,只完成了一件事情,就是注册了两个监听器:registerForIccStatusChanged和registerForOn。这两个监听器监听的是SIM卡和Radio的状态,他们是UiccController更新的触发器。


三、UiccController更新机制

        

        刚才讲到,UiccController的初始化过程主要向RILJ注册了两个监听器,而这两个监听器就是UiccController更新机制的触发点,当监听的事件发生时,UiccController就会启动整个UICC框架的更新机制。

        下面来看具体的更新过程。

3.1、监听器所监听的事件


3.1.1、registerForIccStatusChanged监听器

        对于registerForIccStatusChanged这个注册的动作,并没有直接调用到RIL类里面,而是调用到了RIL的父类BaseCommands中:

        @BaseCommands.java
        public void registerForIccStatusChanged(Handler h, int what, Object obj) {
            Registrant r = new Registrant (h, what, obj);
            mIccStatusChangedRegistrants.add(r);
        }
        我们看到,这里的注册过程其实就是在mIccStatusChangedRegistrants对象List中添加当前的注册对象,然后当以下两种事件发生时就会遍历该List中的监听者进行通知:
        1、输入错误的PIN或PUK时:
        private RILRequest processSolicited (Parcel p) {
            switch (rr.mRequest) {
                case RIL_REQUEST_ENTER_SIM_PUK:
                case RIL_REQUEST_ENTER_SIM_PUK2:
                    if (mIccStatusChangedRegistrants != null) {
                        mIccStatusChangedRegistrants.notifyRegistrants();
                    }
                    break;
            }
        }
        2、当SIM卡状态发生改变时:
        private void processUnsolicited (Parcel p) {
            switch(response) {
                case RIL_UNSOL_RESPONSE_SIM_STATUS_CHANGED:
                    if (mIccStatusChangedRegistrants != null) {
                        mIccStatusChangedRegistrants.notifyRegistrants();
                    }
                    break;
            }
        }

3.1.2、registerForOn监听器

        与registerForIccStatusChanged类似,registerForOn()也是在BaseCommands中被实现的:
        @BaseCommands.java
        public void registerForOn(Handler h, int what, Object obj) {
            Registrant r = new Registrant (h, what, obj);
            synchronized (mStateMonitor) {
                //将注册信息保存在mOnRegistrants列表中
                mOnRegistrants.add(r);
                if (mState.isOn()) {
                    r.notifyRegistrant(new AsyncResult(null, null, null));
                }
            }
        }
        注册的过程就是把监听者信息保存在mOnRegistrants变量的List列表中,然后当以下两种事件发生时就会遍历该List并通知监听者:
        1、Radio状态发生改变时:
        private void processUnsolicited (Parcel p) {
            switch(response) {
                case RIL_UNSOL_RESPONSE_RADIO_STATE_CHANGED:
                    RadioState newState = getRadioStateFromInt(p.readInt());
                    switchToRadioState(newState);
                    break;
            }
        }
        private void switchToRadioState(RadioState newState) {
            setRadioState(newState);
        }
        protected void setRadioState(RadioState newState) {
            synchronized (mStateMonitor) {
                //通知监听者
                mRadioStateChangedRegistrants.notifyRegistrants();
            }
        }
        2、RILJ与RILC通道断开时
        class RILReceiver implements Runnable {
            @Override
            public void run() {
                //Socket通道断开,设置Radio状态为unavailable状态
                setRadioState (RadioState.RADIO_UNAVAILABLE);
            }
        }

        经过上面的分析,我们可以看到,当发生以下事件时,RIL就会对当前的UiccController发起通知:
        1、输入错误的PIN、PUK码
        2、SIM卡状态发生改变
        3、Radio状态发生改变
        4、Socket通道断开

        接下来我们查看当上述情况发生时,UiccController的动作:


3.2、UiccController对监听事件的处理流程

        由于UiccController注册以上两种监听器时所使用的what参数均为“EVENT_ICC_STATUS_CHANGED”,因此上述监听的事件发生时,都会进入同一个EVENT_ICC_STATUS_CHANGED的case分支:
        @UiccController.java
        public void handleMessage (Message msg) {
            synchronized (mLock) {
                switch (msg.what) {
                    case EVENT_ICC_STATUS_CHANGED:
                        //无论是SIM卡的状态或者Radio的状态发生改变,都会进入该case中
                        mCi.getIccCardStatus(obtainMessage(EVENT_GET_ICC_STATUS_DONE));
                        break;
                    case EVENT_GET_ICC_STATUS_DONE:
                        AsyncResult ar = (AsyncResult)msg.obj;
                        onGetIccCardStatusDone(ar);
                        break;
                    default:
                        Rlog.e(LOG_TAG, " Unknown Event " + msg.what);
                }
            }
        }
        然后就会调用RIL.java的getIccCardStatus()方法,去查询最新的SIM和Radio状态。
        当RILJ获取到getIccCardStatus()的请求后,就会向Modem发起请求查询当前的SIM卡状态:
        @RIL.java
        public void getIccCardStatus(Message result) {
            //向Modem发送请求,获取当前的SIM卡状态
            RILRequest rr = RILRequest.obtain(RIL_REQUEST_GET_SIM_STATUS, result);
            send(rr);
        }
        然后获取到最新状态后,将结果反馈给发起请求的对象,当前就是UiccController:
        private RILRequest processSolicited (Parcel p) {
            switch (rr.mRequest) {
                case RIL_REQUEST_GET_SIM_STATUS: 
                    //根据Modem得到的返回值构建IccCardStatus对象
                    ret =  responseIccCardStatus(p); break;
            }
            if (rr.mResult != null) {
                AsyncResult.forMessage(rr.mResult, ret, null);
                //将结果返回给UiccController
                rr.mResult.sendToTarget();
            }
        }
        接下来,UiccController就再次通过handleMessage()方法来处理接下来的流程,只不过这次进入的是EVENT_GET_ICC_STATUS_DONE的case流程:
        @UiccController.java
        public void handleMessage (Message msg) {
            synchronized (mLock) {
                switch (msg.what) {
                    case EVENT_ICC_STATUS_CHANGED:
                        //得到状态改变通知,发起请求
                        mCi.getIccCardStatus(obtainMessage(EVENT_GET_ICC_STATUS_DONE));
                        break;
                    case EVENT_GET_ICC_STATUS_DONE:
                        //获取最新的SIM卡状态
                        AsyncResult ar = (AsyncResult)msg.obj;
                        onGetIccCardStatusDone(ar);
                        break;
                    default:
                        Rlog.e(LOG_TAG, " Unknown Event " + msg.what);
                }
            }
        }
        继续看UiccController对最新状态的处理:
        private synchronized void onGetIccCardStatusDone(AsyncResult ar) {
            if (ar.exception != null) {
                return;
            }
            //拿到RIL中创建的IccCardStatus对象
            IccCardStatus status = (IccCardStatus)ar.result;

            //创建或更新UiccCard
            if (mUiccCard == null) {
                mUiccCard = new UiccCard(mContext, mCi, status);
            } else {
                mUiccCard.update(mContext, mCi , status);
            }
            //继续向其他对象派发消息
            mIccChangedRegistrants.notifyRegistrants();
        }
        到这里我们看到,UiccController获取到最新的SIM卡状态之后,做了两件事情:1、创建或更新UiccCard;2、通知其他子监听对象
        而且我们获取到两个信息:1、UiccCard对象是在UiccController更新SIM卡状态时创建的;2、其他对象可以通过registerForIccChanged()方法向UiccController申请监听SIM卡状态监听。
        至此,UiccController的分析结束,下一章将会介绍UiccCard对象。

1
0

查看评论
* 以上用户言论只代表其个人观点,不代表CSDN网站的观点或立场
    个人资料
    • 访问:283970次
    • 积分:3366
    • 等级:
    • 排名:第10025名
    • 原创:63篇
    • 转载:0篇
    • 译文:0篇
    • 评论:103条
    最新评论