/* * 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 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"; // 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 = "android.intent.action.stk.icc_status_change"; /* * 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; } } }