CatService详解
相关类路径frameworks/opt/telephony/src/java/com/android/internal/telephony/cat/
下面有如下多个类
AppInterface.java
BerTlv.java
CallControlResult.java
CatCmdMessage.java
CatException.java
CatLanguageDecoder.java
CatLog.java
CatResponseMessage.java
CatService.java
ChannelData.java
CommandDetails.java
//1、解析SIM卡上报的STK数据；2、将解析后的数据发送给RilMessageDecoder
CommandParamsFactory.java
CommandParams.java
ComprehensionTlv.java
//COMPREHENSION-TLV对象的枚举类型
ComprehensionTlvTag.java
DtmfMessage.java
Duration.java
FontSize.java
IATUtils.java
IconLoader.java
IconLoaderProxy.java
ImageDescriptor.java
Input.java
Item.java
LanguageMessage.java
LaunchBrowserMode.java
Menu.java
OpenChannelData.java
package.html
PresentationType.java
ReceiveChannelData.java
ResponseData.java
ResultCode.java
ResultException.java
RilMessageDecoder.java
SendChannelData.java
StkServiceProxy.java
TextAlignment.java
TextAttribute.java
TextColor.java
TextMessage.java
Tone.java
ToneSettings.java
ValueParser.java
什么是TLV
TLV格式及其编码
TLV一种可变格式，TLV的意思就是：Type类型， Lenght长度，Value值。
在CAT相关源码中的体现
ComprehensionTlvTag.java
这是TLV中的T，即TAG
//枚举,用于表示COMPREHENSION-TLV对象的标记值。 如果要获取实际值，请调用value()方法
public enum ComprehensionTlvTag {
COMMAND_DETAILS(0x01), //命令详情
DEVICE_IDENTITIES(0x02), //设备ID标识
RESULT(0x03), //结果
DURATION(0x04), //时长
ALPHA_ID(0x05),
ADDRESS(0x06), //地址
USSD_STRING(0x0a),
SMS_TPDU(0x0b),
TEXT_STRING(0x0d),
TONE(0x0e),
ITEM(0x0f),
ITEM_ID(0x10),
RESPONSE_LENGTH(0x11),
FILE_LIST(0x12),
HELP_REQUEST(0x15),
DEFAULT_TEXT(0x17),
NEXT_ACTION_INDICATOR(0x18),
EVENT_LIST(0x19),
ICON_ID(0x1e),
ITEM_ICON_ID_LIST(0x1f),
DATE_TIME_TIMEZONE(0x26),
IMMEDIATE_RESPONSE(0x2b),
//Deal With DTMF Message Start
DTMF(0x2c),
//Deal With DTMF Message End
LANGUAGE(0x2d),
URL(0x31),
BROWSER_TERMINATION_CAUSE(0x34),
BEARER_DESCRIPTION(0x35),
CHANNEL_DATA(0x36),
CHANNEL_DATA_LENGTH(0x37),
CHANNEL_STATUS(0x38),
BUFFER_SIZE(0x39),
TRANSPORT_LEVEL(0x3c),
OTHER_ADDRESS(0x3e),
NETWORK_ACCESS_NAME(0x47),
TEXT_ATTRIBUTE(0x50);
private int mValue;
ComprehensionTlvTag(int value) {
mValue = value;
}
//返回此COMPREHENSION-TLV对象的实际值
public int value() {
return mValue;
}
//value转为枚举类型
public static ComprehensionTlvTag fromInt(int value) {
for (ComprehensionTlvTag e : ComprehensionTlvTag.values()) {
if (e.mValue == value) {
return e;
}
}
return null;
}
}
ComprehensionTlv.java
表示COMPREHENSION-TLV对象的类，里面包含了T,L,V
class ComprehensionTlv {
private static final String LOG_TAG = "ComprehensionTlv";
private int mTag; //TLV中的T
private boolean mCr;
private int mLength; //TLV中的L
private int mValueIndex;
private byte[] mRawValue; //存储数据的字节数组，TLV中的V
/**
* 私有构造函数，请使用decodeMany或decode方法来获取对象实例
*/
protected ComprehensionTlv(int tag, boolean cr, int length, byte[] data,
int valueIndex) {
mTag = tag;
mCr = cr;
mLength = length;
mValueIndex = valueIndex;
mRawValue = data;
}
/**
* 解析字节数组中的COMPREHENSION-TLV对象列表.
*/
public static List<ComprehensionTlv> decodeMany(byte[] data, int startIndex)
throws ResultException {
ArrayList<ComprehensionTlv> items = new ArrayList<ComprehensionTlv>();
int endIndex = data.length;
while (startIndex < endIndex) {
ComprehensionTlv ctlv = ComprehensionTlv.decode(data, startIndex);
if (ctlv != null) {
items.add(ctlv);
startIndex = ctlv.mValueIndex + ctlv.mLength;
} else {
CatLog.d(LOG_TAG, "decodeMany: ctlv is null, stop decoding");
items.clear();
break;
}
}
return items;
}
/**
* 从字节数组解析COMPREHENSION-TLV对象。
*/
public static ComprehensionTlv decode(byte[] data, int startIndex)
throws ResultException {
int curIndex = startIndex;
int endIndex = data.length;
try {
/* tag */
int tag;
boolean cr; // Comprehension required flag
int temp = data[curIndex++] & 0xff;
switch (temp) {
case 0:
tag = 0;
cr = false;
break;
case 0xff:
...
...
return new ComprehensionTlv(tag, cr, length, data, curIndex);
}
CommandParamsFactory.java
/**
* 从tlv列表中找到指定TAG的TLV对象
*/
private ComprehensionTlv searchForTag(ComprehensionTlvTag tag,
List<ComprehensionTlv> ctlvs) {
Iterator<ComprehensionTlv> iter = ctlvs.iterator();
return searchForNextTag(tag, iter);
}
/**
*SIM卡中proactive commands 的详细对象类
*/
public class CommandDetails extends ValueObject implements Parcelable {
public boolean compRequired;
public int commandNumber;
public int typeOfCommand;
public int commandQualifier;
@Override
public ComprehensionTlvTag getTag() {
return ComprehensionTlvTag.COMMAND_DETAILS;
}
...
...
}
AppInterface
/**
* STK APP与CAT Telephony通信的接口
*/
public interface AppInterface {
/*
*用于表示proactive commands的命令类型枚举。这些是Telephony支持的唯一命令
*/
public static enum CommandType {
DISPLAY_TEXT(0x21),
GET_INKEY(0x22),
GET_INPUT(0x23),
LAUNCH_BROWSER(0x15),
PLAY_TONE(0x20),
REFRESH(0x01),
SELECT_ITEM(0x24),
SEND_SS(0x11),
SEND_USSD(0x12),
SEND_SMS(0x13),
SEND_DTMF(0x14),
SET_UP_EVENT_LIST(0x05),
SET_UP_IDLE_MODE_TEXT(0x28),
SET_UP_MENU(0x25),
SET_UP_CALL(0x10),
PROVIDE_LOCAL_INFORMATION(0x26),
/* SPRD: add for USAT 27.22.4.25 LANGUAGE NOTIFICATION @{ */
LANGUAGE_NOTIFACTION(0x35),
/* @}*/
OPEN_CHANNEL(0x40),
CLOSE_CHANNEL(0x41),
RECEIVE_DATA(0x42),
SEND_DATA(0x43),
GET_CHANNEL_STATUS(0x44);
private int mValue;
CommandType(int value) {
mValue = value;
}
public int value() {
return mValue;
}
public static CommandType fromInt(int value) {
for (CommandType e : CommandType.values()) {
if (e.mValue == value) {
return e;
}
}
return null;
}
}
}
RilMessageDecoder.java
用于解析RilMessage的类
//用于对原始 ril 消息进行排队的类，将它们解码为 CommanParams
对象并将结果发送回 CAT 服务。
class RilMessageDecoder extends StateMachine {
private class StateStart extends State {
@Override
public boolean processMessage(Message msg) {
if (msg.what == CMD_START) {
if (decodeMessageParams((RilMessage)msg.obj)) {
transitionTo(mStateCmdParamsReady);
}
} else {
CatLog.d(this, "StateStart unexpected expecting START=" +
CMD_START + " got " + msg.what);
}
return true;
}
}
/**
在decodeMessageParams()中先通过hexStringToBytes()方法将得到的Modem数据
转换为byte类型的数组数据rawData，然后将此数据交给CommandParamsFactory类
的make()方法去解析，经过make的解析就可以得到每项STK菜单的图标、菜单文本以
及需要的控件等信息
*/
private boolean decodeMessageParams(RilMessage rilMsg) {
boolean decodingStarted;
mCurrentRilMessage = rilMsg;
switch(rilMsg.mId) {
...
case CatService.MSG_ID_PROACTIVE_COMMAND:
case CatService.MSG_ID_EVENT_NOTIFY:
case CatService.MSG_ID_REFRESH:
byte[] rawData = null;
try {
//转为字节数组
rawData = IccUtils.hexStringToBytes((String) rilMsg.mData);
CatLog.d(this, "[stk]rawData length"+rawData.length);
if (rawData.length == 0) {
CatLog.d(this, "[stk]rawData is empty");
decodingStarted = false;
break;
}
} catch (Exception e) {
// zombie messages are dropped
CatLog.d(this, "[stk] decodemessage Exception e:" + e);
decodingStarted = false;
break;
}
try {
//开始异步解析命令参数
mCmdParamsFactory.make(BerTlv.decode(rawData));
decodingStarted = true;
} catch (ResultException e) {
// send to Service for proper RIL communication.
CatLog.d(this, "[stk]mCmdParamsFactory.make Exception = " + e);
mCurrentRilMessage.mId = CatService.MSG_ID_SESSION_END;
mCurrentRilMessage.mResCode = e.result();
sendCmdForExecution(mCurrentRilMessage);
decodingStarted = false;
}
break;
default:
decodingStarted = false;
break;
}
return decodingStarted;
}
https://blog.csdn.net/zhanggong2046/article/details/17114031
packages\apps\stk\src\com\android\stk\StkCmdReceiver.java
Uicc之CatService
广播接收类，主要接收来自framework层的CatService发送的针对RIL层上报上来的处理结果的响应信息
1、目前Stk 只使用packages/apps/Stk/src/com/android/stk/下面的代码处理Stk 相关的逻辑
不需要关注Stk1,Stk2；
2、modem 上报Get input command，通过RIL_UNSOL_STK_PROACTIVE_COMMAND上报给上层
网友评论