1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
|
/*
* Copyright (C) 2006 The Android Open Source Project
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package com.android.internal.telephony.cat;
/**
* Interface for communication between STK App and CAT Telephony
*
* {@hide}
*/
public interface AppInterface {
/*
* Intent's actions which are broadcasted by the Telephony once a new CAT
* proactive command, session end, ALPHA during STK CC arrive.
*/
public static final String CAT_CMD_ACTION =
"android.intent.action.stk.command";
public static final String CAT_SESSION_END_ACTION =
"android.intent.action.stk.session_end";
public static final String CAT_ALPHA_NOTIFY_ACTION =
"org.codeaurora.intent.action.stk.alpha_notify";
//This is used to send ALPHA string from card to STK App.
public static final String ALPHA_STRING = "alpha_string";
// This is used to send refresh-result when MSG_ID_ICC_REFRESH is received.
public static final String REFRESH_RESULT = "refresh_result";
//This is used to send card status from card to STK App.
public static final String CARD_STATUS = "card_status";
//Intent's actions are broadcasted by Telephony once IccRefresh occurs.
public static final String CAT_ICC_STATUS_CHANGE =
"org.codeaurora.intent.action.stk.icc_status_change";
/*
* This is broadcast from the ActivityManagerService when the screen
* switches to idle or busy state
*/
public static final String CAT_IDLE_SCREEN_ACTION =
"org.codeaurora.intent.action.stk.idle_screen";
/*
* This is broadcast from the Stk Apps to ActivityManagerService when the screen
* status is requested.
*/
public static final String CHECK_SCREEN_IDLE_ACTION =
"org.codeaurora.intent.action.stk.check_screen_idle";
/*
* Callback function from app to telephony to pass a result code and user's
* input back to the ICC.
*/
void onCmdResponse(CatResponseMessage resMsg);
/*
* Enumeration for representing "Type of Command" of proactive commands.
* Those are the only commands which are supported by the Telephony. Any app
* implementation should support those.
* Refer to ETSI TS 102.223 section 9.4
*/
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),
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;
}
/**
* Create a CommandType object.
*
* @param value Integer value to be converted to a CommandType object.
* @return CommandType object whose "Type of Command" value is {@code
* value}. If no CommandType object has that value, null is
* returned.
*/
public static CommandType fromInt(int value) {
for (CommandType e : CommandType.values()) {
if (e.mValue == value) {
return e;
}
}
return null;
}
}
}
|