STK App源码解析

STK这个应用,源码比较少,但理解起来并太容易懂,理解这一部分代码,需要对Java的消息机制非常熟悉,它在底层的流程,基本上都是收发消息的处理,而上层的UI很简单,只有两种UI:Dialog和Menu,所有的Dialog都是在StkDialogActivity显示出来的,List都是在StkMenuActivity中显示,具体显示什么内容和哪种UI,上层主要是通过对底层上报上来的消息类型来处理的,在上层所有的UI是没有这些固定内容的,需要根据Modem临时上报上来的内容进行显示,不同的SIM卡具有不同的UI,下面就对每一层的源码进行详细分析

STK 应用层:

BootCompletedReceiver:继承了 BroadcastReceiver,它是一个广播接收类,它只负责接收一个广播,Intent.ACTION_BOOT_COMPLETED,即开机启动完成的广播,当接收到开机启动完成后,开启服务StkAppService,传递参数StkAppService.OPCODE,为StkAppService.OP_BOOT_COMPLETED。

StkCmdReceiver:继承BroadcastReceiver,广播接收类,主要接收来自framework层的StkService发送的针对RIL层上报上来的处理结果的响应信息(详见StkService的handleProactiveCommand()方法),它接收两种广播:
一种是AppInterface.STK_CMD_ACTION:处理从StkService服务上报上来的cmd回复信息,调用handleCommandMessage()方法,该方法中新建一个启动StkAppService服务的Intent,intent中装载参数StkAppService.OPCODE为StkAppService.OP_CMD,OP_CMD所作的具体处理详见StkAppService的onStart()方法。

另一种是AppInterface.STK_SESSION_END_ACTION:处理从RIL层上报上来的cmd回复信息,调用handleSessionEnd()方法,与handleCommandMessage()方法作用相同,启动StkAppService服务,但是Intent对象传递的参数StkAppService.OPCODE为StkAppService.OP_END_SESSION ,结束会话的响应信息,上层具体操作详见StkAppService的onStart()方法。

StkAppService:继承自Service实现了Runnable接口,由开机后通过开机广播接收器第一次启动该服务(详见BootCompletedReceiver类说明)。
onCreate()方法:通过调用StkService.getInstance()获取了StkService的实例(该   实例的创建详见StkService类说明);
onStart()方法:对接收到得intent传递的参数进行解析,通过mServiceHandler.obtainMessage()创建一个消息msg,匹配intent传递的参数OPCODE的值,对每一种值进行相应的处理,然后通过mServiceHandler.sendMessage(msg)发送(传递)消息,进行处理响应;
ServiceHandler类:是一个Handle类,处理onStart()方法传递过来的消息,
OP_LAUNCH_APP:传递menu消息,将menu装载到Intent里,启动StkMenuActivity
OP_CMD:来自底层AT指令响应后的处理,消息来自于StkCmdReceiver发送的上报信息,创建一个StkCmdMessage 消息,调用handleCmd方法(详见handleCmd方法的说明)
 OP_RESPONSE:处理上层的请求,主要来自于ToneDialog、StkInputActivity、StkMenuActivity的操作请求,然后调用handleCmdResponse方法(详见该方法说明)
OP_END_SESSION:处理会话结束,调用handleSessionEnd()方法(详见该方法说明)
OP_BOOT_COMPLETED:处理开机启动完成消息,通过调mStkService.stkResponse()给StkService发响应通知。StkService中会给Ril层下发一个请求RIL_REQUEST_STK_RESPONSE,告诉modem已经开机并要求启动STK,没有返回的响应信息。
OP_DELAYED_MSG:处理延时消息,调用handleDelayedCmd()

handleCmd()方法:这个方法主要通过对底层上报上来的消息的处理,在应用层执行相应的UI显示,获取的StkCmdMessage消息,根据不同的type的响应操作:
DISPLAY_TEXT:在屏幕上显示文字或图片,文字编码有三种格式
SELECT_ITEM:启动StkMenuActivity
SET_UP_MENU:建立一个菜单
GET_INPUT:
GET_INKEY:
SET_UP_IDLE_MODE_TEXT:
SEND_DTMF:
SEND_SMS:
SEND_SS:发送补充业务
SEND_USSD:发送USSD
LAUNCH_BROWSER:启动StkDialogActivity,显示一个确认Dialog
SET_UP_CALL:
PLAY_TONE:播放一个audio tone

handleCmdResponse()方法:这个方法,是对上层的请求的下发处理,根据接收到得消息,创建新的响应信息StkResponseMessage,通过mStkService.onCmdResponse(resMsg)下发消息到StkService,被StkService的handleMessage接收消息,调用handleCmdResponse((StkResponseMessage) msg.obj)处理响应(详见StkService的 handleCmdResponse()方法说明)。
StkMenuActivity:主要是装载title、ListView、dialog

StkMenuActivity中下边的每一个视图的装载,都是通过在onCreate()中向StkAppService发Intent,StkAppService接收到StkMenuActivity发送过来的Intent,Intent中绑定了Bundle对象,通过Bundle对象中的OPCODE值,决定需要装载哪个ListView的数据。装载数据成功后,StkMenuActivity中的onResume()获取StkAppService中的Menu数据,并通过适配器显示出来。

STK framework层:
StkService:extends Handler implements AppInterface,通过AppInterface这个接口,使STK的应用层和framework层有一个很好的交互。

getInstance()方法:遵循单例模式的原则创建创建StckService实例,如果该实例没有被初始化,则初始化,否则直接返回。此方法在GSMPhone的构造函数中被初始调用进行创建实例,在StkAppService的onCreate()方法中调用的StkService.getInstance()获取了已经初始化了的StkService实例。
StkService()方法:StkeService的构造方法,在getInstance()初始化StkService实例时被调用,new StkService(ci, sr, context, fh, sc); 同时获取RilMessageDecoder传来的处理消息,然后通过CommandsInterface的接口对象注册对RIL事件的处理,这些注册方法是在BaseCommands类中实现,注册后,能接收到来自RIL层的通知,详见RIL类的说明,注册的事件包括:

MSG_ID_SESSION_END,
MSG_ID_PROACTIVE_COMMAND,
MSG_ID_EVENT_NOTIFY,
MSG_ID_CALL_SETUP,

然后调用函数reportStkServiceIsRunning函数通知RIL层(详见RIL类说明),StkService服务已经启动。
handleMessage():StkService接收RIL层上报信息的重要消息处理方法,它接收的消息种类有:
MSG_ID_SESSION_END:此消息在StkService()构造函数中注册,当RIL层接收到上报消息RIL_UNSOL_STK_SESSION_END时,通知发送此消息,通知StkService会话结束

MSG_ID_PROACTIVE_COMMAND:此消息在StkService()构造函数中注册,当RIL层接收到上报消息RIL_UNSOL_STK_PROACTIVE_COMMAND时,通知发送此消息,发送来自modem的主动上报

MSG_ID_EVENT_NOTIFY:此消息在StkService()构造函数中注册,当RIL层接收到上报消息RIL_UNSOL_STK_EVENT_NOTIFY时,通知发送此消息,
MSG_ID_REFRESH:
MSG_ID_CALL_SETUP:此消息在StkService()构造函数中注册,当RIL层接收到上报消息RIL_UNSOL_STK_CALL_SETUP时,通知发送此消息,发送来自modem的拨打电话的主动上报消息

MSG_ID_SIM_LOADED:此消息在StkService()构造函数中注册,当Sim卡loaded完成,在SimRecords.java中会通知发送此消息,具体详见SimRecords.java中的onAllRecordsLoaded()方法

MSG_ID_RIL_MSG_DECODED:在RilMessageDecoder.java中对Ril上报消息进行解析后,将解析后的结果通过此消息发送回来,被StkService接收执行处理,接收此消息后,调用handleRilMsg((RilMessage) msg.obj)处理消息,详见handleRilMsg()方法说明

MSG_ID_RESPONSE:处理上层发过来的请求消息,调用handleCmdResponse((StkResponseMessage) msg.obj),详见handleCmdResponse()方法说明
handleRilMsg()方法:对各种消息进行解析处理后,调用此方法,具体处理各种消息:
MSG_ID_EVENT_NOTIFY:调用handleProactiveCommand()方法,详见handleProactiveCommand()方法说明
MSG_ID_PROACTIVE_COMMAND:调用handleProactiveCommand()方法,详见handleProactiveCommand()方法说明
MSG_ID_REFRESH:调用handleProactiveCommand()方法,详见handleProactiveCommand()方法说明
MSG_ID_SESSION_END:结束会话,调用handleSessionEnd()方法,创建一个Intent发送会话结束广播AppInterface.STK_SESSION_END_ACTION,此广播会被上层的StkCmdReceiver广播接收器接收,详见StkCmdReceiver类说明
MSG_ID_CALL_SETUP:
 
handleCmdResponse()方法:接收来自上层的处理要求,往RIL下发终端请求,除几种特殊请求外,最终均调用sendTerminalResponse()方法,在该方法中通过调用CommandsInterface的sendTerminalResponse()方法,将请求下发到RIL层,Ril实现了接口CommandsInterface,的类,sendTerminalResponse()的具体实现,详见Ril.java,其中文件请求类型有:
HELP_INFO_REQUIRED:
OK:
PRFRMD_WITH_PARTIAL_COMPREHENSION:
PRFRMD_WITH_MISSING_INFO:
PRFRMD_WITH_ADDITIONAL_EFS_READ:
PRFRMD_ICON_NOT_DISPLAYED:
PRFRMD_MODIFIED_BY_NAA:
PRFRMD_LIMITED_SERVICE:
PRFRMD_WITH_MODIFICATION:
PRFRMD_NAA_NOT_ACTIVE:
PRFRMD_TONE_NOT_PLAYED:根据请求类型,做往RIL发相应的请求,请求类型有:
SET_UP_MENU:装载menu的请求,调用sendMenuSelection()方法,将请求信息创   建为ByteArrayOutputStream字节数组输出流,通过调用CommandsInterface的sendEnvelope()方法,将请求下发到RIL层,RIL类是实现了CommandsInterface的类,sendEnvelope()的具体实现,详见RIL.java文件。
SELECT_ITEM:选中item的请求
GET_INPUT:在屏幕上显示文字或图片,文字编码有三种格式,并获取用户输入的字符串
GET_INKEY:在屏幕上显示文字或图片,文字编码有三种格式,并获取用户输入的一个字符
DISPLAY_TEXT:
LAUNCH_BROWSER:
SET_UP_CALL:打电话的请求,通过调用CommandsInterface的handleCallSetupRequestFromSim()方法,将请求下发到RIL层,RIL类是实现了CommandsInterface的类,handleCallSetupRequestFromSim()的具体实现,详见RIL.java文件
DISPLAY_TEXT:
LAUNCH_BROWSER
SET_UP_CALL
NO_RESPONSE_FROM_USER
UICC_SESSION_TERM_BY_USER
BACKWARD_MOVE_BY_USER
handleProactiveCommand()方法:在这个方法中,处理一批请求,请求的处理均是调用sendTerminalResponse()终端响应方法,sendTerminalResponse()的说明详见handleCmdResponse()方法,最后创建一个Intent,发一条广播:AppInterface.STK_CMD_ACTION到上层, AppInterface.STK_CMD_ACTION的处理详见StkCmdReceiver类的说明。

sendTerminalResponse()方法:此方法在StkService接收到底层上报上来的消息时,会被调用,往RIL层下发请求,告诉modem终端已响应,modem稍后会主动上报会话结束通知回来,同时,StkService会启动上层的StkAppService去处理UI显示。
RIL层:
reportStkServiceIsRunning()方法:通知modem请求,StkService已经启动,转换为一条REQUEST: RIL_REQUEST_REPORT_STK_SERVICE_IS_RUNNING ,无响应返回信息
stkRefresh()方法:通知modem请求刷新,转换为一条REQUEST: RIL_REQUEST_STK_REFRESH,无返回响应信息

stkResponse()方法:通知modem,开机完成,启动Stk工具包,转换为一条REQUEST: RIL_REQUEST_STK_RESPONSE ,无返回响应信息
sendTerminalResponse()方法:处理StkService发过来的终端操作的响应请求,转换为一条REQUEST: RIL_REQUEST_STK_SEND_TERMINAL_RESPONSE,具体AT指令详见reference-sc8800s.c文件说明,无返回的响应信息,在processSolicited()方法中有相应的处理
sendEnvelope()方法:处理StkService发过来的

handleCallSetupRequestFromSim()方法:处理Stk拨打电话请求,转换为REQUEST: RIL_REQUEST_STK_HANDLE_CALL_SETUP_REQUESTED_FROM_SIM, 具体AT指令详见reference-sc8800s.c文件说明,返回的响应信息,在processSolicited()方法中有相应的处理
processUnsolicited()方法:stk请求modem未响应处理,通知StkService
RIL_UNSOL_STK_SESSION_END:
RIL_UNSOL_STK_PROACTIVE_COMMAND
RIL_UNSOL_STK_EVENT_NOTIFY
RIL_UNSOL_STK_CALL_SETUP

RIL的处理:
********************上报************************
RIL_UNSOL_STK_SESSION_END
RIL_UNSOL_STK_PROACTIVE_COMMAND
RIL_UNSOL_STK_EVENT_NOTIFY
RIL_UNSOL_STK_CALL_SETUP
RIL_UNSOL_SIM_REFRESH
********************命令************************
RIL_REQUEST_STK_GET_PROFILE
RIL_REQUEST_STK_SET_PROFILE
RIL_REQUEST_STK_SEND_ENVELOPE_COMMAND
RIL_REQUEST_STK_SEND_TERMINAL_RESPONSE
RIL_REQUEST_STK_HANDLE_CALL_SETUP_REQUESTED_FROM_SIM