Connection.java revision 0742246233c3f03f864d23e52d89e1845d994701
10825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville/* 20825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville * Copyright (C) 2006 The Android Open Source Project 30825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville * 40825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville * Licensed under the Apache License, Version 2.0 (the "License"); 50825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville * you may not use this file except in compliance with the License. 60825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville * You may obtain a copy of the License at 70825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville * 80825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville * http://www.apache.org/licenses/LICENSE-2.0 90825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville * 100825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville * Unless required by applicable law or agreed to in writing, software 110825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville * distributed under the License is distributed on an "AS IS" BASIS, 120825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 130825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville * See the License for the specific language governing permissions and 140825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville * limitations under the License. 150825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville */ 160825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville 170825495a331bb44df395a0cdb79fab85e68db5d5Wink Savillepackage com.android.internal.telephony; 180825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville 1999c2e1d6749cfad2a8ca94a47857d8c3bfc09454Wink Savilleimport android.telephony.Rlog; 200825495a331bb44df395a0cdb79fab85e68db5d5Wink Savilleimport android.util.Log; 210825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville 220825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville/** 230825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville * {@hide} 240825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville */ 250825495a331bb44df395a0cdb79fab85e68db5d5Wink Savillepublic abstract class Connection { 260825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville 270825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville //Caller Name Display 2822d85a8e3a575a6d01d2c788587971657dfe20c6Wink Saville protected String mCnapName; 2922d85a8e3a575a6d01d2c788587971657dfe20c6Wink Saville protected int mCnapNamePresentation = PhoneConstants.PRESENTATION_ALLOWED; 300825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville 31cbaa45bbf2cab852b6c9c3a887e9f803d4e857eaWink Saville private static String LOG_TAG = "Connection"; 320825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville 330825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville public enum DisconnectCause { 340825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville NOT_DISCONNECTED, /* has not yet disconnected */ 350825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville INCOMING_MISSED, /* an incoming call that was missed and never answered */ 360825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville NORMAL, /* normal; remote */ 370825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville LOCAL, /* normal; local hangup */ 380825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville BUSY, /* outgoing call to busy line */ 390825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville CONGESTION, /* outgoing call to congested network */ 400825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville MMI, /* not presently used; dial() returns null */ 410825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville INVALID_NUMBER, /* invalid dial string */ 420825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville NUMBER_UNREACHABLE, /* cannot reach the peer */ 430825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville SERVER_UNREACHABLE, /* cannot reach the server */ 440825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville INVALID_CREDENTIALS, /* invalid credentials */ 450825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville OUT_OF_NETWORK, /* calling from out of network is not allowed */ 460825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville SERVER_ERROR, /* server error */ 470825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville TIMED_OUT, /* client timed out */ 480825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville LOST_SIGNAL, 490825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville LIMIT_EXCEEDED, /* eg GSM ACM limit exceeded */ 500825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville INCOMING_REJECTED, /* an incoming call that was rejected */ 510825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville POWER_OFF, /* radio is turned off explicitly */ 520825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville OUT_OF_SERVICE, /* out of service */ 530825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville ICC_ERROR, /* No ICC, ICC locked, or other ICC error */ 540825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville CALL_BARRED, /* call was blocked by call barring */ 550825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville FDN_BLOCKED, /* call was blocked by fixed dial number */ 560825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville CS_RESTRICTED, /* call was blocked by restricted all voice access */ 570825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville CS_RESTRICTED_NORMAL, /* call was blocked by restricted normal voice access */ 580825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville CS_RESTRICTED_EMERGENCY, /* call was blocked by restricted emergency voice access */ 590825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville UNOBTAINABLE_NUMBER, /* Unassigned number (3GPP TS 24.008 table 10.5.123) */ 600825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville CDMA_LOCKED_UNTIL_POWER_CYCLE, /* MS is locked until next power cycle */ 610825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville CDMA_DROP, 620825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville CDMA_INTERCEPT, /* INTERCEPT order received, MS state idle entered */ 630825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville CDMA_REORDER, /* MS has been redirected, call is cancelled */ 640825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville CDMA_SO_REJECT, /* service option rejection */ 650825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville CDMA_RETRY_ORDER, /* requested service is rejected, retry delay is set */ 660825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville CDMA_ACCESS_FAILURE, 670825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville CDMA_PREEMPTED, 680825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville CDMA_NOT_EMERGENCY, /* not an emergency call */ 690825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville CDMA_ACCESS_BLOCKED, /* Access Blocked by CDMA network */ 700825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville ERROR_UNSPECIFIED 710825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville } 720825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville 7322d85a8e3a575a6d01d2c788587971657dfe20c6Wink Saville Object mUserData; 740825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville 750825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville /* Instance Methods */ 760825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville 770825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville /** 780825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville * Gets address (e.g. phone number) associated with connection. 790825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville * TODO: distinguish reasons for unavailability 800825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville * 810825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville * @return address or null if unavailable 820825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville */ 830825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville 840825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville public abstract String getAddress(); 850825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville 860825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville /** 870825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville * Gets CNAP name associated with connection. 880825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville * @return cnap name or null if unavailable 890825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville */ 900825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville public String getCnapName() { 9122d85a8e3a575a6d01d2c788587971657dfe20c6Wink Saville return mCnapName; 920825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville } 930825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville 940825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville /** 950825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville * Get original dial string. 960825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville * @return original dial string or null if unavailable 970825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville */ 980825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville public String getOrigDialString(){ 990825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville return null; 1000825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville } 1010825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville 1020825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville /** 1030825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville * Gets CNAP presentation associated with connection. 1040825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville * @return cnap name or null if unavailable 1050825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville */ 1060825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville 1070825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville public int getCnapNamePresentation() { 10822d85a8e3a575a6d01d2c788587971657dfe20c6Wink Saville return mCnapNamePresentation; 109cbaa45bbf2cab852b6c9c3a887e9f803d4e857eaWink Saville } 1100825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville 1110825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville /** 1120825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville * @return Call that owns this Connection, or null if none 1130825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville */ 1140825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville public abstract Call getCall(); 1150825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville 1160825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville /** 1170825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville * Connection create time in currentTimeMillis() format 1180825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville * Basically, set when object is created. 1190825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville * Effectively, when an incoming call starts ringing or an 1200825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville * outgoing call starts dialing 1210825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville */ 1220825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville public abstract long getCreateTime(); 1230825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville 1240825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville /** 1250825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville * Connection connect time in currentTimeMillis() format. 1260825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville * For outgoing calls: Begins at (DIALING|ALERTING) -> ACTIVE transition. 1270825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville * For incoming calls: Begins at (INCOMING|WAITING) -> ACTIVE transition. 1280825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville * Returns 0 before then. 1290825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville */ 1300825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville public abstract long getConnectTime(); 1310825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville 1320825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville /** 1330825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville * Disconnect time in currentTimeMillis() format. 1340825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville * The time when this Connection makes a transition into ENDED or FAIL. 1350825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville * Returns 0 before then. 1360825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville */ 1370825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville public abstract long getDisconnectTime(); 1380825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville 1390825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville /** 1400825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville * Returns the number of milliseconds the call has been connected, 1410825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville * or 0 if the call has never connected. 1420825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville * If the call is still connected, then returns the elapsed 1430825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville * time since connect. 1440825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville */ 1450825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville public abstract long getDurationMillis(); 1460825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville 1470825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville /** 1480825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville * If this connection is HOLDING, return the number of milliseconds 1490825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville * that it has been on hold for (approximately). 1500825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville * If this connection is in any other state, return 0. 1510825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville */ 1520825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville 1530825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville public abstract long getHoldDurationMillis(); 1540825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville 1550825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville /** 1560825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville * Returns "NOT_DISCONNECTED" if not yet disconnected. 1570825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville */ 1580825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville public abstract DisconnectCause getDisconnectCause(); 1590825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville 1600825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville /** 1610825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville * Returns true of this connection originated elsewhere 1620825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville * ("MT" or mobile terminated; another party called this terminal) 1630825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville * or false if this call originated here (MO or mobile originated). 1640825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville */ 1650825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville public abstract boolean isIncoming(); 1660825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville 1670825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville /** 1680825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville * If this Connection is connected, then it is associated with 1690825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville * a Call. 1700825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville * 1710825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville * Returns getCall().getState() or Call.State.IDLE if not 1720825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville * connected 1730825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville */ 1740825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville public Call.State getState() { 1750825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville Call c; 1760825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville 1770825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville c = getCall(); 1780825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville 1790825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville if (c == null) { 1800825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville return Call.State.IDLE; 1810825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville } else { 1820825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville return c.getState(); 1830825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville } 1840825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville } 1850825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville 1860825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville /** 1870825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville * isAlive() 1880825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville * 1890825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville * @return true if the connection isn't disconnected 1900825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville * (could be active, holding, ringing, dialing, etc) 1910825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville */ 1920825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville public boolean 1930825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville isAlive() { 1940825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville return getState().isAlive(); 1950825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville } 1960825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville 1970825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville /** 1980825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville * Returns true if Connection is connected and is INCOMING or WAITING 1990825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville */ 2000825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville public boolean 2010825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville isRinging() { 2020825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville return getState().isRinging(); 2030825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville } 2040825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville 2050825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville /** 2060825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville * 2070825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville * @return the userdata set in setUserData() 2080825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville */ 2090825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville public Object getUserData() { 21022d85a8e3a575a6d01d2c788587971657dfe20c6Wink Saville return mUserData; 2110825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville } 2120825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville 2130825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville /** 2140825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville * 2150825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville * @param userdata user can store an any userdata in the Connection object. 2160825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville */ 2170825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville public void setUserData(Object userdata) { 21822d85a8e3a575a6d01d2c788587971657dfe20c6Wink Saville mUserData = userdata; 2190825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville } 2200825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville 2210825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville /** 2220825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville * Hangup individual Connection 2230825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville */ 2240825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville public abstract void hangup() throws CallStateException; 2250825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville 2260825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville /** 2270825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville * Separate this call from its owner Call and assigns it to a new Call 2280825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville * (eg if it is currently part of a Conference call 2290825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville * TODO: Throw exception? Does GSM require error display on failure here? 2300825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville */ 2310825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville public abstract void separate() throws CallStateException; 2320825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville 2330825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville public enum PostDialState { 2340825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville NOT_STARTED, /* The post dial string playback hasn't 2350825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville been started, or this call is not yet 2360825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville connected, or this is an incoming call */ 2370825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville STARTED, /* The post dial string playback has begun */ 2380825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville WAIT, /* The post dial string playback is waiting for a 2390825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville call to proceedAfterWaitChar() */ 2400825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville WILD, /* The post dial string playback is waiting for a 2410825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville call to proceedAfterWildChar() */ 2420825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville COMPLETE, /* The post dial string playback is complete */ 2430825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville CANCELLED, /* The post dial string playback was cancelled 2440825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville with cancelPostDial() */ 2450825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville PAUSE /* The post dial string playback is pausing for a 2460825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville call to processNextPostDialChar*/ 2470825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville } 2480825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville 2490825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville public void clearUserData(){ 25022d85a8e3a575a6d01d2c788587971657dfe20c6Wink Saville mUserData = null; 2510825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville } 2520825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville 2530825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville public abstract PostDialState getPostDialState(); 2540825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville 2550825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville /** 2560825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville * Returns the portion of the post dial string that has not 2570825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville * yet been dialed, or "" if none 2580825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville */ 2590825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville public abstract String getRemainingPostDialString(); 2600825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville 2610825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville /** 2620825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville * See Phone.setOnPostDialWaitCharacter() 2630825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville */ 2640825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville 2650825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville public abstract void proceedAfterWaitChar(); 2660825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville 2670825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville /** 2680825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville * See Phone.setOnPostDialWildCharacter() 2690825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville */ 2700825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville public abstract void proceedAfterWildChar(String str); 2710825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville /** 2720825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville * Cancel any post 2730825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville */ 2740825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville public abstract void cancelPostDial(); 2750825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville 2760825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville /** 2770825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville * Returns the caller id presentation type for incoming and waiting calls 2780825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville * @return one of PRESENTATION_* 2790825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville */ 2800825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville public abstract int getNumberPresentation(); 2810825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville 2820825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville /** 2830825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville * Returns the User to User Signaling (UUS) information associated with 2840825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville * incoming and waiting calls 2850825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville * @return UUSInfo containing the UUS userdata. 2860825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville */ 2870825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville public abstract UUSInfo getUUSInfo(); 2880825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville 2890825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville /** 2900742246233c3f03f864d23e52d89e1845d994701Antonio Marín Cerezuela * Returns the CallFail reason provided by the RIL with the result of 2910742246233c3f03f864d23e52d89e1845d994701Antonio Marín Cerezuela * RIL_REQUEST_LAST_CALL_FAIL_CAUSE 2920742246233c3f03f864d23e52d89e1845d994701Antonio Marín Cerezuela */ 2930742246233c3f03f864d23e52d89e1845d994701Antonio Marín Cerezuela public abstract int getPreciseDisconnectCause(); 2940742246233c3f03f864d23e52d89e1845d994701Antonio Marín Cerezuela 2950742246233c3f03f864d23e52d89e1845d994701Antonio Marín Cerezuela /** 2960825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville * Build a human representation of a connection instance, suitable for debugging. 2970825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville * Don't log personal stuff unless in debug mode. 2980825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville * @return a string representing the internal state of this connection. 2990825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville */ 3000825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville public String toString() { 3010825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville StringBuilder str = new StringBuilder(128); 3020825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville 30399c2e1d6749cfad2a8ca94a47857d8c3bfc09454Wink Saville if (Rlog.isLoggable(LOG_TAG, Log.DEBUG)) { 3040825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville str.append("addr: " + getAddress()) 3050825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville .append(" pres.: " + getNumberPresentation()) 3060825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville .append(" dial: " + getOrigDialString()) 3070825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville .append(" postdial: " + getRemainingPostDialString()) 3080825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville .append(" cnap name: " + getCnapName()) 3090825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville .append("(" + getCnapNamePresentation() + ")"); 3100825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville } 3110825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville str.append(" incoming: " + isIncoming()) 3120825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville .append(" state: " + getState()) 3130825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville .append(" post dial state: " + getPostDialState()); 3140825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville return str.toString(); 3150825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville } 3160825495a331bb44df395a0cdb79fab85e68db5d5Wink Saville} 317