stk.docx

stk.docx

《stk.docx》由会员分享，可在线阅读，更多相关《stk.docx（11页珍藏版）》请在冰豆网上搜索。

stk

SimToolkitApplication（STK）

Thisdocumentoffersahigh-leveloverviewoftheSIMToolkitApplicationforAndroid1.0andisprimarilyofinterestforimplementorsoftheRadioInterfaceLayer（RIL）.TheSTKisR96compatible（3GPPTS11.14v5.9.0）andcompliespartiallywithR99（3GPPTS101.267v8.17.0）.SeetheSTKFeatureListforthecompletefeaturelist.

.

TheAndroidSTKimplementationincludesthreelayers:

STKRIL:

Low-levellayerprovidedbythevendorpluslibril.

STKTelephony:

ProtocoltranslationlayerthatconvertsrawmessagesprovidedbytheSTKRILtoapplicationlevelmessages.

STKApplication:

ProvidestheuserinterfaceinteractionsneededbytheSTK.

TheSimToolkitcommunicationflowisbi-directionalandcommandscanoriginatefromthe

STKRILpackagedinRIL_UNSOL_STK_PROACTIVE_COMMAND,RIL_UNSOL_STK_EVENT_NOTIFY,RIL_UNSOL_REFRESHandRIL_UNSOL_STK_SESSION_ENDmessages.

CommandsoriginatingfromtheSTKApporSTKTelephonylayersarepackagedinRIL_REQUEST_STK_SEND_TERMINAL_REPSONSE,RIL_REQUEST_SEND_ENVELOPE_COMMANDorRIL_REQUEST_HANDLE_CALL_SETUP_REQUESTED_FROM_SIM.

ForcommandssentorrecievedbytheSTKRIL,it'snotnecessarytoremoveunusedsub-commandsbecausetheupperlayerswillgracefullyignoreunusedinformationcontainedinthemessage.ThecontentofeachmessageisencodedintheBER-TLVformatexceptfortwo:

RIL_UNSOL_STK_SESSION_END:

hasnodata

RIL_REQUEST_HANDLE_CALL_SETUP_REQUESTED_FROM_SIM:

hasasinglebyteofdatathatindicatesaccept/reject.

SeetheAndroidPlatformDevelopmentKitfordetails.

CommunicationfromtheRILup

CommunicationtotheupperlayersisdoneusingtheRIL_UNSOL_xxxfamilyofcommandsdefinedin/hardware/ril/include/ril.h.ThepayloadforeachcommandisencodedusingBER-TLV.Asstatedabove,itisnotnecessarytoremoveextraneousfields.ThisallowstheSIMtopassacompletecommandtotheupperlayersandsimplifiesSTKRILcode.BelowisthemappingfromRIL_UNSOL_xxxcommandstotheSIMcommands.

RIL_UNSOL_STK_PROACTIVE_COMMAND

TheSimToolkitcommunicationflowisbi-directionalandcommandscanoriginatefromtheSTKRILpackagedinRIL_UNSOL_STK_PROACTIVE_COMMAND,RIL_UNSOL_STK_EVENT_NOTIFY,RIL_UNSOL_REFRESHandRIL_UNSOL_STK_SESSION_ENDmessages.

DISPLAYTEXT（6.4.1）

ThiscommandishandledbyStkDialogActivity.Iftheimmediateresponseflagisset,theterminalresponseissentwithan"OK"（0x00）resultcodewhenthemessageisfirstreceived.Otherwisetheterminalresponseissentwhenthedialogisdismissedeitherfromuseractionorittimesout.

Theuserseesadialogboxwithamessageand/oricon,anOKbutton,andaCancelbutton.

Terminalresponsesinclude:

"OK"（0x00）

"Sessionterminatedbyuser"（0x10）

"Backwardmovebyuser"（0x11）

"Noresponsefromuser"（0x12）

GETINKEY（6.4.2）

ThiscommandisprocessedbyStkInputActivity.Itdisplaysadialogboxwithapromptandoraniconandyesandnobuttons.

Terminalresponsesinclude:

“OK”（0x00）with“Yes”or“No”astheresponsetext

“Sessionterminatedbyuser”（0x10）<

“Backwardmovebyuser”（0x11）

“Noresponsefromuser”（0x12）

GETINPUT（6.4.3）

ThiscommandishandledbyStkInputActivity.

Theuserseesadialogboxwithapromptand/oranicon,atextboxwithoptionaldefaulttext,andanOKbutton.'digitsonly,''min,''max,'and'hidden'modesareallsupported.

Terminalresponsesinclude:

OK”（0x00）iftheinputcriteriaismet

“Sessionterminatedbyuser”（0x10）<

“Backwardmovebyuser”（0x11）

“Noresponsefromuser”（0x12）

PLAYTONE（6.4.5）

ThiscommandisprocessedbyToneDialog.

Theuserseesadialogboxwithapromptforthedurationofthetoneoruntiltheuserpressesthebackkey.

Terminalresponsesinclude:

"OK"（0x00）ifthetoneisplayedtocompletion

“Sessionterminatedbyuser”（0x10）ifbackbuttonispressed

SETUPMENU（6.4.8）

ThiscommandisprocessedbyStkAppService.ItinstallstheSTKICONonthehomepageandpreparestheMainmenuforusewhentheICONisselected.TypicallythisisthefirstRILunsolicitedcommandandshouldnotbesentuntilaftertheRIL_RadioFunctions.getVersionroutineiscalled.

Terminalreponses:

“OK”（0x00）

Atalatertime,theSTKICONwillbeselectedandStkMenuActivitywilllaunchanddisplaytheMainmenutotheuser.Ifanitemisselected,itwillbereturnedtotheRILinRIL_REQUEST_STK_SEND_ENVELOPE_COMMANDwiththeitemid.Ifnoitemisselected,theStkMenuActivitywillreceiveatimeoutmessageandreturntotheMainmenuandnomessagewillbesenttotheRIL.

Dependinguponwhatitemisselected,theSIMmayperformanotheraction,suchassendinganothersetofmenuitemsviaaSELECTITEMcommandorperforminganactionlikesendanSMSortextdisplay.

SELECTITEM（6.4.9）

ThiscommandisprocessedbyStkMenuActivity.InsteadofdisplayingtheMainmenu,thelistofmenuitemsprovidedinthiscommandaredisplayed.

Terminalresponses:

“OK”（0x00）

ThecommandthenproceedsasintheSETUPMENU.

SETUPIDLEMODETEXT（6.4.22）

StkAppServicedisplaysthemessageandoriconasanAndroidnotification.

Terminalresponsesinclude:

OK”（0x00）

LAUNCHBROWSER（6.4.26）

ThiscommandisinitiallyhandledbyStkDialogActivityandpresentstheuserwithaconfirmationdialog,aURL,andOK,andcancelbuttons.IftheuserpressesOK,thebrowserislaunchedusingtheURL.

Terminalresponsesinclude:

“OK”（0x00）thebrowserhasbeenlaunched

“Sessionterminatedbyuser”（0x10）

“Backwardmovebyuser”（0x11）

“Noresponsefromuser”（0x12）

RIL_UNSOL_STK_EVENT_NOTIFY

Thecommandsinthissectionareproactiveinnature.TheyarehandledbytheSTKRILandtheupperlayersanddeliveredusingRIL_UNSOL_STK_EVENT_NOTIFYmessage.ThisdistinctionisanimplementationdetailofAndroidandisnotdefinedinthe3GPPsepcifications.

TheupperlayershandletheUIandtheSTKRILhandlesallotheraspectsofeachcommand,whichmeansthattheSTKRILsendstheterminalresponse（itisneversentbytheSTKApp）.Eachcommandmustbeaproperlery-formedproactivecommand.Itisnotnecessarytoremoveunusedfields.ThebehaviorofanyothercommandwithinthiscontextsentbyRIL_UNSOL_STK_EVENT_NOTIFYisundefined.SeeEventNotifyCommandDetails.

SENDSMS（6.4.10）–noresponse

SENDSS（6.4.11）–noresponse

SENDUSSD（6.4.12）–noresponse

SETUPCALL（6.4.13）–respondswithRIL_REQUEST_STK_HANDLE_CALL_SETUP_REQUESTED_FROM_SIM

SENDDTMF（6.4.24）–noresponse

RIL_UNSOL_SIM_REFRESH

UsedtosendtheREFRESHcommand.Noresponse.

REFRESH（6.4.7）

RIL_UNSOL_STK_SESSION_END

SentbytheSIMtosignaltheendofasession.Nocontentandnoresponse.

RIL_UNSOL_STK_SESSION_END

SentbySIMtosignalendofsession.Nocontentandnoresponse.

Communicationfromtheapplicationdown

CommunicationfromtheupperlayerstotheRILusesthecommandsbelow（definedinril.h）:

RIL_REQUEST_STK_SEND_TERMINAL_REPSONSE

UsedtosendaterminalresponseforcommandssentviaRIL_UNSOL_STK_PROACTIVE_COMMAND.

ContentsincludeTERMINALRESPONSE（6.8）.

RIL_REQUEST_STK_SEND_ENVELOPE_COMMAND

UsedtosendinformationfromtoSIMencodedasBER-TLVtags（seeR96section13）.Twotagsaresupported:

BER_MENU_SELECTION_TAG（0xd3）;Contents:

MENUSELECTION（8）

BER_EVENT_DOWNLOAD_TAG（0xd6）;Contents:

EVENTDOWNLOADLanguageselection（11.8）

Contentforthesetagsinclude:

MENUSELECTION（8）

EVENTDOWNLOADLanguageselection（11.8）

RIL_REQUEST_HANDLE_CALL_SETUP_REQUESTED_FROM_SIM

Returnsasingle-byteparameter:

1:

accepted

0:

notaccepted

ThisshouldcausetheterminalresponsetobesenttotheSIM.

Telephony

STKTelephonyisaprotocoltranslationlayerusedtoconvertmessagesfromBERL-TLVformattoApplicationmessagesandback.

OntheSTKRILside,STKTelphonyreceivesrawbuffermessagesfromRILI/Fanddecodesthemintoacommandparameterscontainerbeforepassingthemontotheapplication.OntheApplicationside,thislayerreceivesapplicationresponsesforcommandsandencodesthemintorawbuffermessages,whichthengetsentovertheRILI/FbacktotheSIMcard.

FeatureList

FeatureSupportImplementedby

PROFILEDOWNLOAD-beforeradioturn-onYESBaseband

SETUPMENUYESME

SELECTITEMYESME

GETINPUTYESME

GETINKEYYESME

DISPLAYTEXTYESME

SETUPIDLEMODETEXTYESME

SENDSHORTMESSAGEYESBaseband–ME

SENDSSYESBaseband–ME

SENDUSSDYESBaseband–ME

SENDDTMFYESBaseband–ME

LAUNCHBROWSERYESME

SETUPCALLYESBaseband–ME

PLAYTONEYESME

POLLINTERVALYESBaseband

POLLINGOFFYESBaseband

TIMERMANAGEMENTYESBaseband

MORETIMEYESBaseband

PROVIDELOCALINFORMATION（MCC,MNC,LAC,CellID&IMEI）YESBaseband

PROVIDELOCALINFORMATION（NMR）YESBaseband

PROVIDELOCALINFORMATION（TimingAdvance）YESBaseband

PROVIDELOCALINFORMATION（batterystate）YESBaseband

PROVIDELOCALINFORMATION（IMEISV）YESBaseband

PROVIDELOCALINFORMATION（NMR（UTRAN））YESBaseband

PROVIDELOCALINFORMATION（SearchModechange）YESBaseband

REFRESHYESME

SETUPEVENTLISTYESBaseband–ME

Event:

MTcallYESBaseband

Event:

Callconnected（allmodes）YESBaseband

Event:

Calldisconnected（allmodes）YESBaseband

Event:

IdlescreenavailableNO

Event:

BrowserterminationNO

Event:

LocationstatusYESBaseband

Event:

DataavailableNO

Event:

ChannelstatusNO

Event:

AccessTechnologychangedYESBaseband

Event:

LocalConnectionNO

Event:

NetworkSearchModeChangeYESBaseband

GETREADERSTATUSNO

POWERONCARDNO

POWEROFFCARDNO

PERFORMCARDADPUNO

RUNATCOMMANDNO

OPENCHANNELNO

CLOSECHANNELNO

RECEIVEDATANO

SENDDATANO

GETCHANNELSTATUSNO

CALLCONTROLBYSIMYESBaseband

SMS-PPdatadownloadYESBaseband

SMS-CBdatadown