Phone.java revision 7a043b351b43e963605afef6ab76a52ae3a9270e
19066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/* 29066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Copyright (C) 2007 The Android Open Source Project 39066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 49066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Licensed under the Apache License, Version 2.0 (the "License"); 59066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * you may not use this file except in compliance with the License. 69066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * You may obtain a copy of the License at 79066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 89066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * http://www.apache.org/licenses/LICENSE-2.0 99066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Unless required by applicable law or agreed to in writing, software 119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * distributed under the License is distributed on an "AS IS" BASIS, 129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * See the License for the specific language governing permissions and 149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * limitations under the License. 159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpackage com.android.internal.telephony; 189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.content.Context; 20767a662ecde33c3979bf02b793d392aca0403162Wink Savilleimport android.content.SharedPreferences; 219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.os.Handler; 229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.os.Message; 23767a662ecde33c3979bf02b793d392aca0403162Wink Savilleimport android.preference.PreferenceManager; 249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.telephony.CellLocation; 251c42769339d8fe98ecb2698c64e7dc6672e3d59dJaikumar Ganeshimport android.telephony.PhoneStateListener; 269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.telephony.ServiceState; 27e9b06d754af03faf27012fbed1e7559ec1ba7c79Wink Savilleimport android.telephony.SignalStrength; 28767a662ecde33c3979bf02b793d392aca0403162Wink Saville 29767a662ecde33c3979bf02b793d392aca0403162Wink Savilleimport com.android.internal.telephony.DataConnection; 309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport com.android.internal.telephony.gsm.NetworkInfo; 319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport com.android.internal.telephony.gsm.PdpConnection; 329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport com.android.internal.telephony.test.SimulatedRadioControl; 339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport java.util.List; 359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/** 379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Internal interface used to control the phone; SDK developers cannot 389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * obtain this interface. 399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@hide} 419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpublic interface Phone { 449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** used to enable additional debug messages */ 469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project static final boolean DEBUG_PHONE = true; 479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 48767a662ecde33c3979bf02b793d392aca0403162Wink Saville 49767a662ecde33c3979bf02b793d392aca0403162Wink Saville /** 509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The phone state. One of the following:<p> 519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <ul> 529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>IDLE = no phone activity</li> 53767a662ecde33c3979bf02b793d392aca0403162Wink Saville * <li>RINGING = a phone call is ringing or call waiting. 549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * In the latter case, another call is active as well</li> 559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>OFFHOOK = The phone is off hook. At least one call 569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * exists that is dialing, active or holding and no calls are 579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * ringing or waiting.</li> 589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * </ul> 599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project enum State { 619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IDLE, RINGING, OFFHOOK; 629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project }; 639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The state of a data connection. 669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <ul> 679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>CONNECTED = IP traffic should be available</li> 689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>CONNECTING = Currently setting up data connection</li> 699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>DISCONNECTED = IP not available</li> 709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>SUSPENDED = connection is created but IP traffic is 719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * temperately not available. i.e. voice call is in place 729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * in 2G network</li> 739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * </ul> 749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project enum DataState { 769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project CONNECTED, CONNECTING, DISCONNECTED, SUSPENDED; 779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project }; 789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 79767a662ecde33c3979bf02b793d392aca0403162Wink Saville public enum DataActivityState { 809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The state of a data activity. 829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <ul> 839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>NONE = No traffic</li> 849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>DATAIN = Receiving IP ppp traffic</li> 859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>DATAOUT = Sending IP ppp traffic</li> 869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>DATAINANDOUT = Both receiving and sending IP ppp traffic</li> 87e9b06d754af03faf27012fbed1e7559ec1ba7c79Wink Saville * <li>DORMANT = The data connection is still active, 88e9b06d754af03faf27012fbed1e7559ec1ba7c79Wink Saville but physical link is down</li> 899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * </ul> 909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 91e9b06d754af03faf27012fbed1e7559ec1ba7c79Wink Saville NONE, DATAIN, DATAOUT, DATAINANDOUT, DORMANT; 929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project }; 939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project enum SuppService { 959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project UNKNOWN, SWITCH, SEPARATE, TRANSFER, CONFERENCE, REJECT, HANGUP; 969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project }; 979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project static final String STATE_KEY = "state"; 999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project static final String PHONE_NAME_KEY = "phoneName"; 1009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project static final String FAILURE_REASON_KEY = "reason"; 1019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project static final String STATE_CHANGE_REASON_KEY = "reason"; 10242acef37339afe6ac608c842f1637870ee9c4f6cRobert Greenwalt static final String DATA_APN_TYPES_KEY = "apnType"; 1039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project static final String DATA_APN_KEY = "apn"; 10442acef37339afe6ac608c842f1637870ee9c4f6cRobert Greenwalt 1059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project static final String DATA_IFACE_NAME_KEY = "iface"; 1069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project static final String NETWORK_UNAVAILABLE_KEY = "networkUnvailable"; 107dda5391d5079537e275c9f4ed2637a1484d0e4e8Wink Saville static final String PHONE_IN_ECM_STATE = "phoneinECMState"; 1089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * APN types for data connections. These are usage categories for an APN 1119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * entry. One APN entry may support multiple APN types, eg, a single APN 1129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * may service regular internet traffic ("default") as well as MMS-specific 1139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * connections.<br/> 1149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * APN_TYPE_ALL is a special type to indicate that this APN entry can 1159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * service all data connections. 1169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project static final String APN_TYPE_ALL = "*"; 1189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** APN type for default data traffic */ 1199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project static final String APN_TYPE_DEFAULT = "default"; 1209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** APN type for MMS traffic */ 1219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project static final String APN_TYPE_MMS = "mms"; 12242ad56ead40f6c5986bd2d298b1d36f42da489a1Mike Lockwood /** APN type for SUPL assisted GPS */ 12342ad56ead40f6c5986bd2d298b1d36f42da489a1Mike Lockwood static final String APN_TYPE_SUPL = "supl"; 12442acef37339afe6ac608c842f1637870ee9c4f6cRobert Greenwalt /** APN type for DUN traffic */ 12542acef37339afe6ac608c842f1637870ee9c4f6cRobert Greenwalt static final String APN_TYPE_DUN = "dun"; 12642acef37339afe6ac608c842f1637870ee9c4f6cRobert Greenwalt /** APN type for HiPri traffic */ 12742acef37339afe6ac608c842f1637870ee9c4f6cRobert Greenwalt static final String APN_TYPE_HIPRI = "hipri"; 1289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // "Features" accessible through the connectivity manager 1309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project static final String FEATURE_ENABLE_MMS = "enableMMS"; 13142ad56ead40f6c5986bd2d298b1d36f42da489a1Mike Lockwood static final String FEATURE_ENABLE_SUPL = "enableSUPL"; 13242acef37339afe6ac608c842f1637870ee9c4f6cRobert Greenwalt static final String FEATURE_ENABLE_DUN = "enableDUN"; 13342acef37339afe6ac608c842f1637870ee9c4f6cRobert Greenwalt static final String FEATURE_ENABLE_HIPRI = "enableHIPRI"; 1349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return codes for <code>enableApnType()</code> 1379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project static final int APN_ALREADY_ACTIVE = 0; 1399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project static final int APN_REQUEST_STARTED = 1; 1409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project static final int APN_TYPE_NOT_AVAILABLE = 2; 1419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project static final int APN_REQUEST_FAILED = 3; 1429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Optional reasons for disconnect and connect 1469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project static final String REASON_ROAMING_ON = "roamingOn"; 1489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project static final String REASON_ROAMING_OFF = "roamingOff"; 1499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project static final String REASON_DATA_DISABLED = "dataDisabled"; 1509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project static final String REASON_DATA_ENABLED = "dataEnabled"; 1519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project static final String REASON_GPRS_ATTACHED = "gprsAttached"; 1529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project static final String REASON_GPRS_DETACHED = "gprsDetached"; 153767a662ecde33c3979bf02b793d392aca0403162Wink Saville static final String REASON_CDMA_DATA_ATTACHED = "cdmaDataAttached"; 154767a662ecde33c3979bf02b793d392aca0403162Wink Saville static final String REASON_CDMA_DATA_DETACHED = "cdmaDataDetached"; 1559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project static final String REASON_APN_CHANGED = "apnChanged"; 1569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project static final String REASON_APN_SWITCHED = "apnSwitched"; 1579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project static final String REASON_RESTORE_DEFAULT_APN = "restoreDefaultApn"; 1589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project static final String REASON_RADIO_TURNED_OFF = "radioTurnedOff"; 1599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project static final String REASON_PDP_RESET = "pdpReset"; 1609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project static final String REASON_VOICE_CALL_ENDED = "2GVoiceCallEnded"; 1619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project static final String REASON_VOICE_CALL_STARTED = "2GVoiceCallStarted"; 1624df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project static final String REASON_PS_RESTRICT_ENABLED = "psRestrictEnabled"; 1634df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project static final String REASON_PS_RESTRICT_DISABLED = "psRestrictDisabled"; 164ba87e3e6c985e7175152993b5efcc7dd2f0e1c93The Android Open Source Project static final String REASON_SIM_LOADED = "simLoaded"; 165e9b06d754af03faf27012fbed1e7559ec1ba7c79Wink Saville 1664df2423a947bcd3f024cc3d3a1a315a8dc428598The Android Open Source Project // Used for band mode selection methods 1679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project static final int BM_UNSPECIFIED = 0; // selected by baseband automatically 1689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project static final int BM_EURO_BAND = 1; // GSM-900 / DCS-1800 / WCDMA-IMT-2000 1699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project static final int BM_US_BAND = 2; // GSM-850 / PCS-1900 / WCDMA-850 / WCDMA-PCS-1900 1709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project static final int BM_JPN_BAND = 3; // WCDMA-800 / WCDMA-IMT-2000 1719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project static final int BM_AUS_BAND = 4; // GSM-900 / DCS-1800 / WCDMA-850 / WCDMA-IMT-2000 1729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project static final int BM_AUS2_BAND = 5; // GSM-900 / DCS-1800 / WCDMA-850 1739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project static final int BM_BOUNDARY = 6; // upper band boundary 1749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Used for preferred network type 176767a662ecde33c3979bf02b793d392aca0403162Wink Saville // Note NT_* substitute RILConstants.NETWORK_MODE_* above the Phone 177ee748d37b01b3affb72b701d95ba20c189887b5fJaikumar Ganesh int NT_MODE_WCDMA_PREF = RILConstants.NETWORK_MODE_WCDMA_PREF; 178ee748d37b01b3affb72b701d95ba20c189887b5fJaikumar Ganesh int NT_MODE_GSM_ONLY = RILConstants.NETWORK_MODE_GSM_ONLY; 179ee748d37b01b3affb72b701d95ba20c189887b5fJaikumar Ganesh int NT_MODE_WCDMA_ONLY = RILConstants.NETWORK_MODE_WCDMA_ONLY; 180ee748d37b01b3affb72b701d95ba20c189887b5fJaikumar Ganesh int NT_MODE_GSM_UMTS = RILConstants.NETWORK_MODE_GSM_UMTS; 181ee748d37b01b3affb72b701d95ba20c189887b5fJaikumar Ganesh 182ee748d37b01b3affb72b701d95ba20c189887b5fJaikumar Ganesh int NT_MODE_CDMA = RILConstants.NETWORK_MODE_CDMA; 183ee748d37b01b3affb72b701d95ba20c189887b5fJaikumar Ganesh 184ee748d37b01b3affb72b701d95ba20c189887b5fJaikumar Ganesh int NT_MODE_CDMA_NO_EVDO = RILConstants.NETWORK_MODE_CDMA_NO_EVDO; 185ee748d37b01b3affb72b701d95ba20c189887b5fJaikumar Ganesh int NT_MODE_EVDO_NO_CDMA = RILConstants.NETWORK_MODE_EVDO_NO_CDMA; 186ee748d37b01b3affb72b701d95ba20c189887b5fJaikumar Ganesh int NT_MODE_GLOBAL = RILConstants.NETWORK_MODE_GLOBAL; 187ee748d37b01b3affb72b701d95ba20c189887b5fJaikumar Ganesh 188ee748d37b01b3affb72b701d95ba20c189887b5fJaikumar Ganesh int PREFERRED_NT_MODE = RILConstants.PREFERRED_NETWORK_MODE; 189767a662ecde33c3979bf02b793d392aca0403162Wink Saville 190767a662ecde33c3979bf02b793d392aca0403162Wink Saville 191767a662ecde33c3979bf02b793d392aca0403162Wink Saville // Used for CDMA roaming mode 192e9b06d754af03faf27012fbed1e7559ec1ba7c79Wink Saville static final int CDMA_RM_HOME = 0; // Home Networks only, as defined in PRL 193e9b06d754af03faf27012fbed1e7559ec1ba7c79Wink Saville static final int CDMA_RM_AFFILIATED = 1; // Roaming an Affiliated networks, as defined in PRL 194e9b06d754af03faf27012fbed1e7559ec1ba7c79Wink Saville static final int CDMA_RM_ANY = 2; // Roaming on Any Network, as defined in PRL 195767a662ecde33c3979bf02b793d392aca0403162Wink Saville 196767a662ecde33c3979bf02b793d392aca0403162Wink Saville // Used for CDMA subscription mode 197e9b06d754af03faf27012fbed1e7559ec1ba7c79Wink Saville static final int CDMA_SUBSCRIPTION_RUIM_SIM = 0; // RUIM/SIM (default) 198e9b06d754af03faf27012fbed1e7559ec1ba7c79Wink Saville static final int CDMA_SUBSCRIPTION_NV = 1; // NV -> non-volatile memory 199e9b06d754af03faf27012fbed1e7559ec1ba7c79Wink Saville 200e9b06d754af03faf27012fbed1e7559ec1ba7c79Wink Saville static final int PREFERRED_CDMA_SUBSCRIPTION = CDMA_SUBSCRIPTION_NV; 201e9b06d754af03faf27012fbed1e7559ec1ba7c79Wink Saville 202e9b06d754af03faf27012fbed1e7559ec1ba7c79Wink Saville static final int TTY_MODE_OFF = 0; 203e9b06d754af03faf27012fbed1e7559ec1ba7c79Wink Saville static final int TTY_MODE_FULL = 1; 204e9b06d754af03faf27012fbed1e7559ec1ba7c79Wink Saville static final int TTY_MODE_HCO = 2; 205e9b06d754af03faf27012fbed1e7559ec1ba7c79Wink Saville static final int TTY_MODE_VCO = 3; 206767a662ecde33c3979bf02b793d392aca0403162Wink Saville 207dda5391d5079537e275c9f4ed2637a1484d0e4e8Wink Saville /** 208dda5391d5079537e275c9f4ed2637a1484d0e4e8Wink Saville * CDMA OTA PROVISION STATUS, the same as RIL_CDMA_OTA_Status in ril.h 209dda5391d5079537e275c9f4ed2637a1484d0e4e8Wink Saville */ 210dda5391d5079537e275c9f4ed2637a1484d0e4e8Wink Saville 211dda5391d5079537e275c9f4ed2637a1484d0e4e8Wink Saville public static final int CDMA_OTA_PROVISION_STATUS_SPL_UNLOCKED = 0; 212dda5391d5079537e275c9f4ed2637a1484d0e4e8Wink Saville public static final int CDMA_OTA_PROVISION_STATUS_SPC_RETRIES_EXCEEDED = 1; 213dda5391d5079537e275c9f4ed2637a1484d0e4e8Wink Saville public static final int CDMA_OTA_PROVISION_STATUS_A_KEY_EXCHANGED = 2; 214dda5391d5079537e275c9f4ed2637a1484d0e4e8Wink Saville public static final int CDMA_OTA_PROVISION_STATUS_SSD_UPDATED = 3; 215dda5391d5079537e275c9f4ed2637a1484d0e4e8Wink Saville public static final int CDMA_OTA_PROVISION_STATUS_NAM_DOWNLOADED = 4; 216dda5391d5079537e275c9f4ed2637a1484d0e4e8Wink Saville public static final int CDMA_OTA_PROVISION_STATUS_MDN_DOWNLOADED = 5; 217dda5391d5079537e275c9f4ed2637a1484d0e4e8Wink Saville public static final int CDMA_OTA_PROVISION_STATUS_IMSI_DOWNLOADED = 6; 218dda5391d5079537e275c9f4ed2637a1484d0e4e8Wink Saville public static final int CDMA_OTA_PROVISION_STATUS_PRL_DOWNLOADED = 7; 219dda5391d5079537e275c9f4ed2637a1484d0e4e8Wink Saville public static final int CDMA_OTA_PROVISION_STATUS_COMMITTED = 8; 220dda5391d5079537e275c9f4ed2637a1484d0e4e8Wink Saville public static final int CDMA_OTA_PROVISION_STATUS_OTAPA_STARTED = 9; 221dda5391d5079537e275c9f4ed2637a1484d0e4e8Wink Saville public static final int CDMA_OTA_PROVISION_STATUS_OTAPA_STOPPED = 10; 222dda5391d5079537e275c9f4ed2637a1484d0e4e8Wink Saville public static final int CDMA_OTA_PROVISION_STATUS_OTAPA_ABORTED = 11; 223dda5391d5079537e275c9f4ed2637a1484d0e4e8Wink Saville 224dda5391d5079537e275c9f4ed2637a1484d0e4e8Wink Saville 225767a662ecde33c3979bf02b793d392aca0403162Wink Saville /** 226767a662ecde33c3979bf02b793d392aca0403162Wink Saville * Get the current ServiceState. Use 2279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <code>registerForServiceStateChanged</code> to be informed of 2289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * updates. 2299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project ServiceState getServiceState(); 2319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Get the current CellLocation. 2349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project CellLocation getCellLocation(); 236767a662ecde33c3979bf02b793d392aca0403162Wink Saville 2379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Get the current DataState. No change notification exists at this 239767a662ecde33c3979bf02b793d392aca0403162Wink Saville * interface -- use 240b111554883ef3d4101c2f3fe9d630f5c1d3bbf7aMarco Nelissen * {@link com.android.telephony.PhoneStateListener PhoneStateListener} 241767a662ecde33c3979bf02b793d392aca0403162Wink Saville * instead. 2429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project DataState getDataConnectionState(); 2449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Get the current DataActivityState. No change notification exists at this 2479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * interface -- use 2489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link TelephonyManager} instead. 2499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project DataActivityState getDataActivityState(); 251767a662ecde33c3979bf02b793d392aca0403162Wink Saville 2529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Gets the context for the phone, as set at initialization time. 2549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Context getContext(); 2569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 257767a662ecde33c3979bf02b793d392aca0403162Wink Saville /** 258767a662ecde33c3979bf02b793d392aca0403162Wink Saville * Disables the DNS check (i.e., allows "0.0.0.0"). 259767a662ecde33c3979bf02b793d392aca0403162Wink Saville * Useful for lab testing environment. 260767a662ecde33c3979bf02b793d392aca0403162Wink Saville * @param b true disables the check, false enables. 261767a662ecde33c3979bf02b793d392aca0403162Wink Saville */ 262767a662ecde33c3979bf02b793d392aca0403162Wink Saville void disableDnsCheck(boolean b); 263767a662ecde33c3979bf02b793d392aca0403162Wink Saville 264767a662ecde33c3979bf02b793d392aca0403162Wink Saville /** 265767a662ecde33c3979bf02b793d392aca0403162Wink Saville * Returns true if the DNS check is currently disabled. 266767a662ecde33c3979bf02b793d392aca0403162Wink Saville */ 267767a662ecde33c3979bf02b793d392aca0403162Wink Saville boolean isDnsCheckDisabled(); 268767a662ecde33c3979bf02b793d392aca0403162Wink Saville 269767a662ecde33c3979bf02b793d392aca0403162Wink Saville /** 2709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Get current coarse-grained voice call state. 2711c42769339d8fe98ecb2698c64e7dc6672e3d59dJaikumar Ganesh * Use {@link #registerForPreciseCallStateChanged(Handler, int, Object) 2721c42769339d8fe98ecb2698c64e7dc6672e3d59dJaikumar Ganesh * registerForPreciseCallStateChanged()} for change notification. <p> 2739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * If the phone has an active call and call waiting occurs, 2749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * then the phone state is RINGING not OFFHOOK 275767a662ecde33c3979bf02b793d392aca0403162Wink Saville * <strong>Note:</strong> 2769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This registration point provides notification of finer-grained 2779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * changes.<p> 2789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project State getState(); 2819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 282767a662ecde33c3979bf02b793d392aca0403162Wink Saville /** 2839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns a string identifier for this phone interface for parties 2849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * outside the phone app process. 2859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return The string name. 2869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String getPhoneName(); 2889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 289767a662ecde33c3979bf02b793d392aca0403162Wink Saville /** 2909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns an array of string identifiers for the APN types serviced by the 2919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * currently active or last connected APN. 2929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return The string array. 2939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String[] getActiveApnTypes(); 295767a662ecde33c3979bf02b793d392aca0403162Wink Saville 296767a662ecde33c3979bf02b793d392aca0403162Wink Saville /** 2979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns a string identifier for currently active or last connected APN. 2989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return The string name. 2999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String getActiveApn(); 301767a662ecde33c3979bf02b793d392aca0403162Wink Saville 302767a662ecde33c3979bf02b793d392aca0403162Wink Saville /** 303dda5391d5079537e275c9f4ed2637a1484d0e4e8Wink Saville * Get current signal strength. No change notification available on this 304dda5391d5079537e275c9f4ed2637a1484d0e4e8Wink Saville * interface. Use <code>PhoneStateNotifier</code> or an equivalent. 305dda5391d5079537e275c9f4ed2637a1484d0e4e8Wink Saville * An ASU is 0-31 or -1 if unknown (for GSM, dBm = -113 - 2 * asu). 306dda5391d5079537e275c9f4ed2637a1484d0e4e8Wink Saville * The following special values are defined:</p> 307dda5391d5079537e275c9f4ed2637a1484d0e4e8Wink Saville * <ul><li>0 means "-113 dBm or less".</li> 308dda5391d5079537e275c9f4ed2637a1484d0e4e8Wink Saville * <li>31 means "-51 dBm or greater".</li></ul> 309767a662ecde33c3979bf02b793d392aca0403162Wink Saville * 310e9b06d754af03faf27012fbed1e7559ec1ba7c79Wink Saville * @return Current signal strength as SignalStrength 3119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 312e9b06d754af03faf27012fbed1e7559ec1ba7c79Wink Saville SignalStrength getSignalStrength(); 313767a662ecde33c3979bf02b793d392aca0403162Wink Saville 314767a662ecde33c3979bf02b793d392aca0403162Wink Saville /** 3159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Notifies when a previously untracked non-ringing/waiting connection has appeared. 3169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This is likely due to some other entity (eg, SIM card application) initiating a call. 3179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project void registerForUnknownConnection(Handler h, int what, Object obj); 3199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Unregisters for unknown connection notifications. 3229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project void unregisterForUnknownConnection(Handler h); 3249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 325767a662ecde33c3979bf02b793d392aca0403162Wink Saville /** 3261c42769339d8fe98ecb2698c64e7dc6672e3d59dJaikumar Ganesh * Register for getting notifications for change in the Call State {@link Call.State} 3271c42769339d8fe98ecb2698c64e7dc6672e3d59dJaikumar Ganesh * This is called PreciseCallState because the call state is more precise than the 3281c42769339d8fe98ecb2698c64e7dc6672e3d59dJaikumar Ganesh * {@link Phone.State} which can be obtained using the {@link PhoneStateListener} 3291c42769339d8fe98ecb2698c64e7dc6672e3d59dJaikumar Ganesh * 3309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Resulting events will have an AsyncResult in <code>Message.obj</code>. 3319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * AsyncResult.userData will be set to the obj argument here. 3329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The <em>h</em> parameter is held only by a weak reference. 3339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3341c42769339d8fe98ecb2698c64e7dc6672e3d59dJaikumar Ganesh void registerForPreciseCallStateChanged(Handler h, int what, Object obj); 3359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 337767a662ecde33c3979bf02b793d392aca0403162Wink Saville * Unregisters for voice call state change notifications. 3389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Extraneous calls are tolerated silently. 3399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3401c42769339d8fe98ecb2698c64e7dc6672e3d59dJaikumar Ganesh void unregisterForPreciseCallStateChanged(Handler h); 3419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 343767a662ecde33c3979bf02b793d392aca0403162Wink Saville /** 3449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Notifies when a new ringing or waiting connection has appeared.<p> 3459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Messages received from this: 3479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Message.obj will be an AsyncResult 3489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * AsyncResult.userObj = obj 3499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * AsyncResult.result = a Connection. <p> 3509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Please check Connection.isRinging() to make sure the Connection 3519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * has not dropped since this message was posted. 352767a662ecde33c3979bf02b793d392aca0403162Wink Saville * If Connection.isRinging() is true, then 3539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Connection.getCall() == Phone.getRingingCall() 3549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project void registerForNewRingingConnection(Handler h, int what, Object obj); 3569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 358767a662ecde33c3979bf02b793d392aca0403162Wink Saville * Unregisters for new ringing connection notification. 3599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Extraneous calls are tolerated silently 3609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project void unregisterForNewRingingConnection(Handler h); 3639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 364767a662ecde33c3979bf02b793d392aca0403162Wink Saville /** 3659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Notifies when an incoming call rings.<p> 3669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Messages received from this: 3689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Message.obj will be an AsyncResult 3699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * AsyncResult.userObj = obj 3709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * AsyncResult.result = a Connection. <p> 3719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project void registerForIncomingRing(Handler h, int what, Object obj); 373767a662ecde33c3979bf02b793d392aca0403162Wink Saville 3749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 375767a662ecde33c3979bf02b793d392aca0403162Wink Saville * Unregisters for ring notification. 3769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Extraneous calls are tolerated silently 3779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 378767a662ecde33c3979bf02b793d392aca0403162Wink Saville 3799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project void unregisterForIncomingRing(Handler h); 380767a662ecde33c3979bf02b793d392aca0403162Wink Saville 381767a662ecde33c3979bf02b793d392aca0403162Wink Saville 382767a662ecde33c3979bf02b793d392aca0403162Wink Saville /** 3839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Notifies when a voice connection has disconnected, either due to local 3849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * or remote hangup or error. 385767a662ecde33c3979bf02b793d392aca0403162Wink Saville * 3869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Messages received from this will have the following members:<p> 3879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <ul><li>Message.obj will be an AsyncResult</li> 3889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>AsyncResult.userObj = obj</li> 389767a662ecde33c3979bf02b793d392aca0403162Wink Saville * <li>AsyncResult.result = a Connection object that is 3909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * no longer connected.</li></ul> 3919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project void registerForDisconnect(Handler h, int what, Object obj); 3939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 395767a662ecde33c3979bf02b793d392aca0403162Wink Saville * Unregisters for voice disconnection notification. 3969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Extraneous calls are tolerated silently 3979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project void unregisterForDisconnect(Handler h); 3999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Register for notifications of initiation of a new MMI code request. 4039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * MMI codes for GSM are discussed in 3GPP TS 22.030.<p> 4049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Example: If Phone.dial is called with "*#31#", then the app will 4069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * be notified here.<p> 4079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The returned <code>Message.obj</code> will contain an AsyncResult. 4099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <code>obj.result</code> will be an "MmiCode" object. 4119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project void registerForMmiInitiate(Handler h, int what, Object obj); 4139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 415767a662ecde33c3979bf02b793d392aca0403162Wink Saville * Unregisters for new MMI initiate notification. 4169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Extraneous calls are tolerated silently 4179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project void unregisterForMmiInitiate(Handler h); 4199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Register for notifications that an MMI request has completed 4229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * its network activity and is in its final state. This may mean a state 4239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * of COMPLETE, FAILED, or CANCELLED. 4249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <code>Message.obj</code> will contain an AsyncResult. 4269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <code>obj.result</code> will be an "MmiCode" object 4279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project void registerForMmiComplete(Handler h, int what, Object obj); 4299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 431767a662ecde33c3979bf02b793d392aca0403162Wink Saville * Unregisters for MMI complete notification. 4329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Extraneous calls are tolerated silently 4339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project void unregisterForMmiComplete(Handler h); 4359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 43795a1d1a89e383dab893750638c2393dec54833ffWink Saville * Registration point for Ecm timer reset 43895a1d1a89e383dab893750638c2393dec54833ffWink Saville * @param h handler to notify 43995a1d1a89e383dab893750638c2393dec54833ffWink Saville * @param what user-defined message code 44095a1d1a89e383dab893750638c2393dec54833ffWink Saville * @param obj placed in Message.obj 44195a1d1a89e383dab893750638c2393dec54833ffWink Saville */ 44295a1d1a89e383dab893750638c2393dec54833ffWink Saville public void registerForEcmTimerReset(Handler h, int what, Object obj); 44395a1d1a89e383dab893750638c2393dec54833ffWink Saville 44495a1d1a89e383dab893750638c2393dec54833ffWink Saville /** 44595a1d1a89e383dab893750638c2393dec54833ffWink Saville * Unregister for notification for Ecm timer reset 44695a1d1a89e383dab893750638c2393dec54833ffWink Saville * @param h Handler to be removed from the registrant list. 44795a1d1a89e383dab893750638c2393dec54833ffWink Saville */ 44895a1d1a89e383dab893750638c2393dec54833ffWink Saville public void unregisterForEcmTimerReset(Handler h); 44995a1d1a89e383dab893750638c2393dec54833ffWink Saville 45095a1d1a89e383dab893750638c2393dec54833ffWink Saville /** 4519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns a list of MMI codes that are pending. (They have initiated 4529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * but have not yet completed). 4539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Presently there is only ever one. 454767a662ecde33c3979bf02b793d392aca0403162Wink Saville * Use <code>registerForMmiInitiate</code> 4559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * and <code>registerForMmiComplete</code> for change notification. 4569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public List<? extends MmiCode> getPendingMmiCodes(); 4589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Sends user response to a USSD REQUEST message. An MmiCode instance 4619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * representing this response is sent to handlers registered with 4629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * registerForMmiInitiate. 4639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param ussdMessge Message to send in the response. 4659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void sendUssdResponse(String ussdMessge); 4679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 469767a662ecde33c3979bf02b793d392aca0403162Wink Saville * Register for ServiceState changed. 4709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Message.obj will contain an AsyncResult. 4719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * AsyncResult.result will be a ServiceState instance 4729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project void registerForServiceStateChanged(Handler h, int what, Object obj); 4749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 476767a662ecde33c3979bf02b793d392aca0403162Wink Saville * Unregisters for ServiceStateChange notification. 4779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Extraneous calls are tolerated silently 4789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project void unregisterForServiceStateChanged(Handler h); 4809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Register for Supplementary Service notifications from the network. 4839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Message.obj will contain an AsyncResult. 4849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * AsyncResult.result will be a SuppServiceNotification instance. 4859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param h Handler that receives the notification message. 4879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param what User-defined message code. 4889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param obj User object. 4899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project void registerForSuppServiceNotification(Handler h, int what, Object obj); 4919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 493767a662ecde33c3979bf02b793d392aca0403162Wink Saville * Unregisters for Supplementary Service notifications. 4949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Extraneous calls are tolerated silently 495767a662ecde33c3979bf02b793d392aca0403162Wink Saville * 4969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param h Handler to be removed from the registrant list. 4979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project void unregisterForSuppServiceNotification(Handler h); 4999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Register for notifications when a supplementary service attempt fails. 5029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Message.obj will contain an AsyncResult. 5039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param h Handler that receives the notification message. 5059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param what User-defined message code. 5069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param obj User object. 5079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project void registerForSuppServiceFailed(Handler h, int what, Object obj); 5099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Unregister for notifications when a supplementary service attempt fails. 5129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Extraneous calls are tolerated silently 513767a662ecde33c3979bf02b793d392aca0403162Wink Saville * 5149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param h Handler to be removed from the registrant list. 5159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project void unregisterForSuppServiceFailed(Handler h); 5179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 518767a662ecde33c3979bf02b793d392aca0403162Wink Saville /** 519767a662ecde33c3979bf02b793d392aca0403162Wink Saville * Register for notifications when a sInCall VoicePrivacy is enabled 520767a662ecde33c3979bf02b793d392aca0403162Wink Saville * 521767a662ecde33c3979bf02b793d392aca0403162Wink Saville * @param h Handler that receives the notification message. 522767a662ecde33c3979bf02b793d392aca0403162Wink Saville * @param what User-defined message code. 523767a662ecde33c3979bf02b793d392aca0403162Wink Saville * @param obj User object. 524767a662ecde33c3979bf02b793d392aca0403162Wink Saville */ 525767a662ecde33c3979bf02b793d392aca0403162Wink Saville void registerForInCallVoicePrivacyOn(Handler h, int what, Object obj); 526767a662ecde33c3979bf02b793d392aca0403162Wink Saville 527767a662ecde33c3979bf02b793d392aca0403162Wink Saville /** 528767a662ecde33c3979bf02b793d392aca0403162Wink Saville * Unegister for notifications when a sInCall VoicePrivacy is enabled 529767a662ecde33c3979bf02b793d392aca0403162Wink Saville * 530767a662ecde33c3979bf02b793d392aca0403162Wink Saville * @param h Handler to be removed from the registrant list. 531767a662ecde33c3979bf02b793d392aca0403162Wink Saville */ 532767a662ecde33c3979bf02b793d392aca0403162Wink Saville void unregisterForInCallVoicePrivacyOn(Handler h); 533767a662ecde33c3979bf02b793d392aca0403162Wink Saville 534767a662ecde33c3979bf02b793d392aca0403162Wink Saville /** 535767a662ecde33c3979bf02b793d392aca0403162Wink Saville * Register for notifications when a sInCall VoicePrivacy is disabled 536767a662ecde33c3979bf02b793d392aca0403162Wink Saville * 537767a662ecde33c3979bf02b793d392aca0403162Wink Saville * @param h Handler that receives the notification message. 538767a662ecde33c3979bf02b793d392aca0403162Wink Saville * @param what User-defined message code. 539767a662ecde33c3979bf02b793d392aca0403162Wink Saville * @param obj User object. 540767a662ecde33c3979bf02b793d392aca0403162Wink Saville */ 541767a662ecde33c3979bf02b793d392aca0403162Wink Saville void registerForInCallVoicePrivacyOff(Handler h, int what, Object obj); 542767a662ecde33c3979bf02b793d392aca0403162Wink Saville 543767a662ecde33c3979bf02b793d392aca0403162Wink Saville /** 544767a662ecde33c3979bf02b793d392aca0403162Wink Saville * Unegister for notifications when a sInCall VoicePrivacy is disabled 545767a662ecde33c3979bf02b793d392aca0403162Wink Saville * 546767a662ecde33c3979bf02b793d392aca0403162Wink Saville * @param h Handler to be removed from the registrant list. 547767a662ecde33c3979bf02b793d392aca0403162Wink Saville */ 548767a662ecde33c3979bf02b793d392aca0403162Wink Saville void unregisterForInCallVoicePrivacyOff(Handler h); 549767a662ecde33c3979bf02b793d392aca0403162Wink Saville 550767a662ecde33c3979bf02b793d392aca0403162Wink Saville /** 551dda5391d5079537e275c9f4ed2637a1484d0e4e8Wink Saville * Register for notifications when CDMA OTA Provision status change 552e9b06d754af03faf27012fbed1e7559ec1ba7c79Wink Saville * 553e9b06d754af03faf27012fbed1e7559ec1ba7c79Wink Saville * @param h Handler that receives the notification message. 554e9b06d754af03faf27012fbed1e7559ec1ba7c79Wink Saville * @param what User-defined message code. 555e9b06d754af03faf27012fbed1e7559ec1ba7c79Wink Saville * @param obj User object. 556e9b06d754af03faf27012fbed1e7559ec1ba7c79Wink Saville */ 557dda5391d5079537e275c9f4ed2637a1484d0e4e8Wink Saville void registerForCdmaOtaStatusChange(Handler h, int what, Object obj); 558e9b06d754af03faf27012fbed1e7559ec1ba7c79Wink Saville 559e9b06d754af03faf27012fbed1e7559ec1ba7c79Wink Saville /** 560dda5391d5079537e275c9f4ed2637a1484d0e4e8Wink Saville * Unegister for notifications when CDMA OTA Provision status change 561e9b06d754af03faf27012fbed1e7559ec1ba7c79Wink Saville * @param h Handler to be removed from the registrant list. 562e9b06d754af03faf27012fbed1e7559ec1ba7c79Wink Saville */ 563dda5391d5079537e275c9f4ed2637a1484d0e4e8Wink Saville void unregisterForCdmaOtaStatusChange(Handler h); 564e9b06d754af03faf27012fbed1e7559ec1ba7c79Wink Saville 565e9b06d754af03faf27012fbed1e7559ec1ba7c79Wink Saville /** 5669e652dcc213b96087ccadc730b1e6b1891cd02aeJinghui Guo * Registration point for subscription info ready 5679e652dcc213b96087ccadc730b1e6b1891cd02aeJinghui Guo * @param h handler to notify 5689e652dcc213b96087ccadc730b1e6b1891cd02aeJinghui Guo * @param what what code of message when delivered 5699e652dcc213b96087ccadc730b1e6b1891cd02aeJinghui Guo * @param obj placed in Message.obj 5709e652dcc213b96087ccadc730b1e6b1891cd02aeJinghui Guo */ 5719e652dcc213b96087ccadc730b1e6b1891cd02aeJinghui Guo public void registerForSubscriptionInfoReady(Handler h, int what, Object obj); 5729e652dcc213b96087ccadc730b1e6b1891cd02aeJinghui Guo 5739e652dcc213b96087ccadc730b1e6b1891cd02aeJinghui Guo /** 5749e652dcc213b96087ccadc730b1e6b1891cd02aeJinghui Guo * Unregister for notifications for subscription info 5759e652dcc213b96087ccadc730b1e6b1891cd02aeJinghui Guo * @param h Handler to be removed from the registrant list. 5769e652dcc213b96087ccadc730b1e6b1891cd02aeJinghui Guo */ 5779e652dcc213b96087ccadc730b1e6b1891cd02aeJinghui Guo public void unregisterForSubscriptionInfoReady(Handler h); 5789e652dcc213b96087ccadc730b1e6b1891cd02aeJinghui Guo 5799e652dcc213b96087ccadc730b1e6b1891cd02aeJinghui Guo /** 580767a662ecde33c3979bf02b793d392aca0403162Wink Saville * Returns SIM record load state. Use 5819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <code>getSimCard().registerForReady()</code> for change notification. 5829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 583767a662ecde33c3979bf02b793d392aca0403162Wink Saville * @return true if records from the SIM have been loaded and are 5849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * available (if applicable). If not applicable to the underlying 5859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * technology, returns true as well. 5869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 587767a662ecde33c3979bf02b793d392aca0403162Wink Saville boolean getIccRecordsLoaded(); 5889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 590767a662ecde33c3979bf02b793d392aca0403162Wink Saville * Returns the ICC card interface for this phone, or null 5919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * if not applicable to underlying technology. 5929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 593767a662ecde33c3979bf02b793d392aca0403162Wink Saville IccCard getIccCard(); 5949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 596767a662ecde33c3979bf02b793d392aca0403162Wink Saville * Answers a ringing or waiting call. Active calls, if any, go on hold. 5979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Answering occurs asynchronously, and final notification occurs via 5981c42769339d8fe98ecb2698c64e7dc6672e3d59dJaikumar Ganesh * {@link #registerForPreciseCallStateChanged(android.os.Handler, int, 5991c42769339d8fe98ecb2698c64e7dc6672e3d59dJaikumar Ganesh * java.lang.Object) registerForPreciseCallStateChanged()}. 6009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @exception CallStateException when no call is ringing or waiting 6029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project void acceptCall() throws CallStateException; 6049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 605767a662ecde33c3979bf02b793d392aca0403162Wink Saville /** 606767a662ecde33c3979bf02b793d392aca0403162Wink Saville * Reject (ignore) a ringing call. In GSM, this means UDUB 607767a662ecde33c3979bf02b793d392aca0403162Wink Saville * (User Determined User Busy). Reject occurs asynchronously, 608767a662ecde33c3979bf02b793d392aca0403162Wink Saville * and final notification occurs via 6091c42769339d8fe98ecb2698c64e7dc6672e3d59dJaikumar Ganesh * {@link #registerForPreciseCallStateChanged(android.os.Handler, int, 6101c42769339d8fe98ecb2698c64e7dc6672e3d59dJaikumar Ganesh * java.lang.Object) registerForPreciseCallStateChanged()}. 6119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @exception CallStateException when no call is ringing or waiting 6139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project void rejectCall() throws CallStateException; 6159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 616767a662ecde33c3979bf02b793d392aca0403162Wink Saville /** 6179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Places any active calls on hold, and makes any held calls 6189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * active. Switch occurs asynchronously and may fail. 619767a662ecde33c3979bf02b793d392aca0403162Wink Saville * Final notification occurs via 6201c42769339d8fe98ecb2698c64e7dc6672e3d59dJaikumar Ganesh * {@link #registerForPreciseCallStateChanged(android.os.Handler, int, 6211c42769339d8fe98ecb2698c64e7dc6672e3d59dJaikumar Ganesh * java.lang.Object) registerForPreciseCallStateChanged()}. 6229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @exception CallStateException if a call is ringing, waiting, or 6249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * dialing/alerting. In these cases, this operation may not be performed. 6259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project void switchHoldingAndActive() throws CallStateException; 6279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 629767a662ecde33c3979bf02b793d392aca0403162Wink Saville * Whether or not the phone can conference in the current phone 6309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * state--that is, one call holding and one call active. 631767a662ecde33c3979bf02b793d392aca0403162Wink Saville * @return true if the phone can conference; false otherwise. 6329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project boolean canConference(); 6349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 636767a662ecde33c3979bf02b793d392aca0403162Wink Saville * Conferences holding and active. Conference occurs asynchronously 637767a662ecde33c3979bf02b793d392aca0403162Wink Saville * and may fail. Final notification occurs via 6381c42769339d8fe98ecb2698c64e7dc6672e3d59dJaikumar Ganesh * {@link #registerForPreciseCallStateChanged(android.os.Handler, int, 6391c42769339d8fe98ecb2698c64e7dc6672e3d59dJaikumar Ganesh * java.lang.Object) registerForPreciseCallStateChanged()}. 640767a662ecde33c3979bf02b793d392aca0403162Wink Saville * 6419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @exception CallStateException if canConference() would return false. 6429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * In these cases, this operation may not be performed. 6439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project void conference() throws CallStateException; 6459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 647767a662ecde33c3979bf02b793d392aca0403162Wink Saville * Enable or disable enhanced Voice Privacy (VP). If enhanced VP is 648767a662ecde33c3979bf02b793d392aca0403162Wink Saville * disabled, normal VP is enabled. 649767a662ecde33c3979bf02b793d392aca0403162Wink Saville * 650767a662ecde33c3979bf02b793d392aca0403162Wink Saville * @param enable whether true or false to enable or disable. 651767a662ecde33c3979bf02b793d392aca0403162Wink Saville * @param onComplete a callback message when the action is completed. 652767a662ecde33c3979bf02b793d392aca0403162Wink Saville */ 653767a662ecde33c3979bf02b793d392aca0403162Wink Saville void enableEnhancedVoicePrivacy(boolean enable, Message onComplete); 654767a662ecde33c3979bf02b793d392aca0403162Wink Saville 655767a662ecde33c3979bf02b793d392aca0403162Wink Saville /** 656767a662ecde33c3979bf02b793d392aca0403162Wink Saville * Get the currently set Voice Privacy (VP) mode. 657767a662ecde33c3979bf02b793d392aca0403162Wink Saville * 658767a662ecde33c3979bf02b793d392aca0403162Wink Saville * @param onComplete a callback message when the action is completed. 659767a662ecde33c3979bf02b793d392aca0403162Wink Saville */ 660767a662ecde33c3979bf02b793d392aca0403162Wink Saville void getEnhancedVoicePrivacy(Message onComplete); 661767a662ecde33c3979bf02b793d392aca0403162Wink Saville 662767a662ecde33c3979bf02b793d392aca0403162Wink Saville /** 6639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Whether or not the phone can do explicit call transfer in the current 6649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * phone state--that is, one call holding and one call active. 6659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the phone can do explicit call transfer; false otherwise. 6669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project boolean canTransfer(); 6689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Connects the two calls and disconnects the subscriber from both calls 6719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Explicit Call Transfer occurs asynchronously 6729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * and may fail. Final notification occurs via 6731c42769339d8fe98ecb2698c64e7dc6672e3d59dJaikumar Ganesh * {@link #registerForPreciseCallStateChanged(android.os.Handler, int, 6741c42769339d8fe98ecb2698c64e7dc6672e3d59dJaikumar Ganesh * java.lang.Object) registerForPreciseCallStateChanged()}. 6759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @exception CallStateException if canTransfer() would return false. 6779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * In these cases, this operation may not be performed. 6789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project void explicitCallTransfer() throws CallStateException; 6809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Clears all DISCONNECTED connections from Call connection lists. 6839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Calls that were in the DISCONNECTED state become idle. This occurs 6849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * synchronously. 6859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project void clearDisconnected(); 6879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 689767a662ecde33c3979bf02b793d392aca0403162Wink Saville /** 690767a662ecde33c3979bf02b793d392aca0403162Wink Saville * Gets the foreground call object, which represents all connections that 691767a662ecde33c3979bf02b793d392aca0403162Wink Saville * are dialing or active (all connections 6929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * that have their audio path connected).<p> 6939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The foreground call is a singleton object. It is constant for the life 6959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * of this phone. It is never null.<p> 696767a662ecde33c3979bf02b793d392aca0403162Wink Saville * 6979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The foreground call will only ever be in one of these states: 698767a662ecde33c3979bf02b793d392aca0403162Wink Saville * IDLE, ACTIVE, DIALING, ALERTING, or DISCONNECTED. 6999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 7009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * State change notification is available via 7011c42769339d8fe98ecb2698c64e7dc6672e3d59dJaikumar Ganesh * {@link #registerForPreciseCallStateChanged(android.os.Handler, int, 7021c42769339d8fe98ecb2698c64e7dc6672e3d59dJaikumar Ganesh * java.lang.Object) registerForPreciseCallStateChanged()}. 7039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Call getForegroundCall(); 7059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 706767a662ecde33c3979bf02b793d392aca0403162Wink Saville /** 7079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Gets the background call object, which represents all connections that 7089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * are holding (all connections that have been accepted or connected, but 7099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * do not have their audio path connected). <p> 7109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 7119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The background call is a singleton object. It is constant for the life 7129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * of this phone object . It is never null.<p> 713767a662ecde33c3979bf02b793d392aca0403162Wink Saville * 7149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The background call will only ever be in one of these states: 7159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * IDLE, HOLDING or DISCONNECTED. 7169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 7179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * State change notification is available via 7181c42769339d8fe98ecb2698c64e7dc6672e3d59dJaikumar Ganesh * {@link #registerForPreciseCallStateChanged(android.os.Handler, int, 7191c42769339d8fe98ecb2698c64e7dc6672e3d59dJaikumar Ganesh * java.lang.Object) registerForPreciseCallStateChanged()}. 7209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Call getBackgroundCall(); 7229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 723767a662ecde33c3979bf02b793d392aca0403162Wink Saville /** 724767a662ecde33c3979bf02b793d392aca0403162Wink Saville * Gets the ringing call object, which represents an incoming 7259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * connection (if present) that is pending answer/accept. (This connection 7269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * may be RINGING or WAITING, and there may be only one.)<p> 7279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The ringing call is a singleton object. It is constant for the life 7299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * of this phone. It is never null.<p> 730767a662ecde33c3979bf02b793d392aca0403162Wink Saville * 7319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The ringing call will only ever be in one of these states: 7329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * IDLE, INCOMING, WAITING or DISCONNECTED. 7339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 7349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * State change notification is available via 7351c42769339d8fe98ecb2698c64e7dc6672e3d59dJaikumar Ganesh * {@link #registerForPreciseCallStateChanged(android.os.Handler, int, 7361c42769339d8fe98ecb2698c64e7dc6672e3d59dJaikumar Ganesh * java.lang.Object) registerForPreciseCallStateChanged()}. 7379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Call getRingingCall(); 7399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 740767a662ecde33c3979bf02b793d392aca0403162Wink Saville /** 7419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Initiate a new voice connection. This happens asynchronously, so you 7429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * cannot assume the audio path is connected (or a call index has been 7439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * assigned) until PhoneStateChanged notification has occurred. 7449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 7459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @exception CallStateException if a new outgoing call is not currently 746767a662ecde33c3979bf02b793d392aca0403162Wink Saville * possible because no more call slots exist or a call exists that is 747767a662ecde33c3979bf02b793d392aca0403162Wink Saville * dialing, alerting, ringing, or waiting. Other errors are 7489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * handled asynchronously. 7499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Connection dial(String dialString) throws CallStateException; 7519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Handles PIN MMI commands (PIN/PIN2/PUK/PUK2), which are initiated 7549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * without SEND (so <code>dial</code> is not appropriate). 755767a662ecde33c3979bf02b793d392aca0403162Wink Saville * 7569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param dialString the MMI command to be executed. 7579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if MMI command is executed. 7589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project boolean handlePinMmi(String dialString); 7609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Handles in-call MMI commands. While in a call, or while receiving a 7639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * call, use this to execute MMI commands. 7649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * see 3GPP 20.030, section 6.5.5.1 for specs on the allowed MMI commands. 7659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 7669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param command the MMI command to be executed. 7679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if the MMI command is executed. 7689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @throws CallStateException 7699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project boolean handleInCallMmiCommands(String command) throws CallStateException; 7719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 773767a662ecde33c3979bf02b793d392aca0403162Wink Saville * Play a DTMF tone on the active call. Ignored if there is no active call. 7749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param c should be one of 0-9, '*' or '#'. Other values will be 7759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * silently ignored. 7769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project void sendDtmf(char c); 7789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Start to paly a DTMF tone on the active call. Ignored if there is no active call 7819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * or there is a playing DTMF tone. 7829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param c should be one of 0-9, '*' or '#'. Other values will be 7839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * silently ignored. 7849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project void startDtmf(char c); 7869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Stop the playing DTMF tone. Ignored if there is no playing DTMF 7899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * tone or no active call. 7909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project void stopDtmf(); 7929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 793e9b06d754af03faf27012fbed1e7559ec1ba7c79Wink Saville /** 794dda5391d5079537e275c9f4ed2637a1484d0e4e8Wink Saville * send burst DTMF tone, it can send the string as single character or multiple character 795dda5391d5079537e275c9f4ed2637a1484d0e4e8Wink Saville * ignore if there is no active call or not valid digits string. 796dda5391d5079537e275c9f4ed2637a1484d0e4e8Wink Saville * Valid digit means only includes characters ISO-LATIN characters 0-9, *, # 797dda5391d5079537e275c9f4ed2637a1484d0e4e8Wink Saville * The difference between sendDtmf and sendBurstDtmf is sendDtmf only sends one character, 798dda5391d5079537e275c9f4ed2637a1484d0e4e8Wink Saville * this api can send single character and multiple character, also, this api has response 799dda5391d5079537e275c9f4ed2637a1484d0e4e8Wink Saville * back to caller. 800dda5391d5079537e275c9f4ed2637a1484d0e4e8Wink Saville * 801dda5391d5079537e275c9f4ed2637a1484d0e4e8Wink Saville * @param dtmfString is string representing the dialing digit(s) in the active call 802dafa22a3ef9328c72319aeec605f6a6d20e46080jsh * @param on the DTMF ON length in milliseconds, or 0 for default 803dafa22a3ef9328c72319aeec605f6a6d20e46080jsh * @param off the DTMF OFF length in milliseconds, or 0 for default 804dda5391d5079537e275c9f4ed2637a1484d0e4e8Wink Saville * @param onCompelte is the callback message when the action is processed by BP 805dda5391d5079537e275c9f4ed2637a1484d0e4e8Wink Saville * 806e9b06d754af03faf27012fbed1e7559ec1ba7c79Wink Saville */ 807dafa22a3ef9328c72319aeec605f6a6d20e46080jsh void sendBurstDtmf(String dtmfString, int on, int off, Message onComplete); 8089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 810767a662ecde33c3979bf02b793d392aca0403162Wink Saville * Sets the radio power on/off state (off is sometimes 811767a662ecde33c3979bf02b793d392aca0403162Wink Saville * called "airplane mode"). Current state can be gotten via 812767a662ecde33c3979bf02b793d392aca0403162Wink Saville * {@link #getServiceState()}.{@link 8139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * android.telephony.ServiceState#getState() getState()}. 814767a662ecde33c3979bf02b793d392aca0403162Wink Saville * <strong>Note: </strong>This request is asynchronous. 8159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * getServiceState().getState() will not change immediately after this call. 816767a662ecde33c3979bf02b793d392aca0403162Wink Saville * registerForServiceStateChanged() to find out when the 8179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * request is complete. 8189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 819767a662ecde33c3979bf02b793d392aca0403162Wink Saville * @param power true means "on", false means "off". 8209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project void setRadioPower(boolean power); 8229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 823767a662ecde33c3979bf02b793d392aca0403162Wink Saville /** 8249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Get voice message waiting indicator status. No change notification 8259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * available on this interface. Use PhoneStateNotifier or similar instead. 8269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 8279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if there is a voice message waiting 8289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project boolean getMessageWaitingIndicator(); 8309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Get voice call forwarding indicator status. No change notification 8339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * available on this interface. Use PhoneStateNotifier or similar instead. 8349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 8359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if there is a voice call forwarding 8369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project boolean getCallForwardingIndicator(); 8389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Get the line 1 phone number (MSISDN).<p> 8419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 8429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return phone number. May return null if not 8439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * available or the SIM is not ready 8449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String getLine1Number(); 8469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the alpha tag associated with the msisdn number. 8499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * If there is no alpha tag associated or the record is not yet available, 8509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * returns a default localized string. <p> 8519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String getLine1AlphaTag(); 8539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Sets the MSISDN phone number in the SIM card. 8569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 8579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param alphaTag the alpha tag associated with the MSISDN phone number 8589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * (see getMsisdnAlphaTag) 8599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param number the new MSISDN phone number to be set on the SIM. 8609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param onComplete a callback message when the action is completed. 8619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project void setLine1Number(String alphaTag, String number, Message onComplete); 8639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 865767a662ecde33c3979bf02b793d392aca0403162Wink Saville * Get the voice mail access phone number. Typically dialed when the 866767a662ecde33c3979bf02b793d392aca0403162Wink Saville * user holds the "1" key in the phone app. May return null if not 8679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * available or the SIM is not ready.<p> 8689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String getVoiceMailNumber(); 8709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 872dda5391d5079537e275c9f4ed2637a1484d0e4e8Wink Saville * Returns unread voicemail count. This count is shown when the voicemail 873dda5391d5079537e275c9f4ed2637a1484d0e4e8Wink Saville * notification is expanded.<p> 874dda5391d5079537e275c9f4ed2637a1484d0e4e8Wink Saville */ 875ce099c3226b33b43e0dd5d1f24347b14a2223ee1David Krause int getVoiceMessageCount(); 876dda5391d5079537e275c9f4ed2637a1484d0e4e8Wink Saville 877dda5391d5079537e275c9f4ed2637a1484d0e4e8Wink Saville /** 8789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the alpha tag associated with the voice mail number. 8799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * If there is no alpha tag associated or the record is not yet available, 8809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * returns a default localized string. <p> 881767a662ecde33c3979bf02b793d392aca0403162Wink Saville * 882767a662ecde33c3979bf02b793d392aca0403162Wink Saville * Please use this value instead of some other localized string when 8839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * showing a name for this number in the UI. For example, call log 8849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * entries should show this alpha tag. <p> 8859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 8869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Usage of this alpha tag in the UI is a common carrier requirement. 8879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String getVoiceMailAlphaTag(); 8899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * setVoiceMailNumber 8929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * sets the voicemail number in the SIM card. 8939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 8949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param alphaTag the alpha tag associated with the voice mail number 8959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * (see getVoiceMailAlphaTag) 8969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param voiceMailNumber the new voicemail number to be set on the SIM. 8979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param onComplete a callback message when the action is completed. 8989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project void setVoiceMailNumber(String alphaTag, 9009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String voiceMailNumber, 9019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Message onComplete); 9029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 9049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * getCallForwardingOptions 905767a662ecde33c3979bf02b793d392aca0403162Wink Saville * gets a call forwarding option. The return value of 906767a662ecde33c3979bf02b793d392aca0403162Wink Saville * ((AsyncResult)onComplete.obj) is an array of CallForwardInfo. 907767a662ecde33c3979bf02b793d392aca0403162Wink Saville * 908767a662ecde33c3979bf02b793d392aca0403162Wink Saville * @param commandInterfaceCFReason is one of the valid call forwarding 909767a662ecde33c3979bf02b793d392aca0403162Wink Saville * CF_REASONS, as defined in 910dda5391d5079537e275c9f4ed2637a1484d0e4e8Wink Saville * <code>com.android.internal.telephony.CommandsInterface.</code> 9119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param onComplete a callback message when the action is completed. 912767a662ecde33c3979bf02b793d392aca0403162Wink Saville * @see com.android.internal.telephony.CallForwardInfo for details. 9139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 9149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project void getCallForwardingOption(int commandInterfaceCFReason, 9159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Message onComplete); 916767a662ecde33c3979bf02b793d392aca0403162Wink Saville 9179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 9189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * setCallForwardingOptions 9199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * sets a call forwarding option. 920767a662ecde33c3979bf02b793d392aca0403162Wink Saville * 921767a662ecde33c3979bf02b793d392aca0403162Wink Saville * @param commandInterfaceCFReason is one of the valid call forwarding 922767a662ecde33c3979bf02b793d392aca0403162Wink Saville * CF_REASONS, as defined in 923dda5391d5079537e275c9f4ed2637a1484d0e4e8Wink Saville * <code>com.android.internal.telephony.CommandsInterface.</code> 924767a662ecde33c3979bf02b793d392aca0403162Wink Saville * @param commandInterfaceCFAction is one of the valid call forwarding 925767a662ecde33c3979bf02b793d392aca0403162Wink Saville * CF_ACTIONS, as defined in 926dda5391d5079537e275c9f4ed2637a1484d0e4e8Wink Saville * <code>com.android.internal.telephony.CommandsInterface.</code> 927767a662ecde33c3979bf02b793d392aca0403162Wink Saville * @param dialingNumber is the target phone number to forward calls to 9289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param timerSeconds is used by CFNRy to indicate the timeout before 9299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * forwarding is attempted. 9309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param onComplete a callback message when the action is completed. 9319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 9329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project void setCallForwardingOption(int commandInterfaceCFReason, 9339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int commandInterfaceCFAction, 9349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String dialingNumber, 9359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int timerSeconds, 9369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Message onComplete); 937767a662ecde33c3979bf02b793d392aca0403162Wink Saville 9389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 9399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * getOutgoingCallerIdDisplay 940767a662ecde33c3979bf02b793d392aca0403162Wink Saville * gets outgoing caller id display. The return value of 9419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * ((AsyncResult)onComplete.obj) is an array of int, with a length of 2. 942767a662ecde33c3979bf02b793d392aca0403162Wink Saville * 9439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param onComplete a callback message when the action is completed. 944767a662ecde33c3979bf02b793d392aca0403162Wink Saville * @see com.android.internal.telephony.CommandsInterface.getCLIR for details. 9459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 9469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project void getOutgoingCallerIdDisplay(Message onComplete); 947767a662ecde33c3979bf02b793d392aca0403162Wink Saville 9489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 9499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * setOutgoingCallerIdDisplay 950767a662ecde33c3979bf02b793d392aca0403162Wink Saville * sets a call forwarding option. 951767a662ecde33c3979bf02b793d392aca0403162Wink Saville * 952767a662ecde33c3979bf02b793d392aca0403162Wink Saville * @param commandInterfaceCLIRMode is one of the valid call CLIR 953767a662ecde33c3979bf02b793d392aca0403162Wink Saville * modes, as defined in 954767a662ecde33c3979bf02b793d392aca0403162Wink Saville * <code>com.android.internal.telephony.CommandsInterface./code> 9559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param onComplete a callback message when the action is completed. 9569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 9579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project void setOutgoingCallerIdDisplay(int commandInterfaceCLIRMode, 9589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Message onComplete); 959767a662ecde33c3979bf02b793d392aca0403162Wink Saville 9609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 9619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * getCallWaiting 962767a662ecde33c3979bf02b793d392aca0403162Wink Saville * gets call waiting activation state. The return value of 9639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * ((AsyncResult)onComplete.obj) is an array of int, with a length of 1. 964767a662ecde33c3979bf02b793d392aca0403162Wink Saville * 9659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param onComplete a callback message when the action is completed. 966767a662ecde33c3979bf02b793d392aca0403162Wink Saville * @see com.android.internal.telephony.CommandsInterface.queryCallWaiting for details. 9679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 9689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project void getCallWaiting(Message onComplete); 969767a662ecde33c3979bf02b793d392aca0403162Wink Saville 9709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 9719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * setCallWaiting 972767a662ecde33c3979bf02b793d392aca0403162Wink Saville * sets a call forwarding option. 973767a662ecde33c3979bf02b793d392aca0403162Wink Saville * 974767a662ecde33c3979bf02b793d392aca0403162Wink Saville * @param enable is a boolean representing the state that you are 9759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * requesting, true for enabled, false for disabled. 9769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param onComplete a callback message when the action is completed. 9779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 9789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project void setCallWaiting(boolean enable, Message onComplete); 979767a662ecde33c3979bf02b793d392aca0403162Wink Saville 9809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 9819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Scan available networks. This method is asynchronous; . 9829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * On completion, <code>response.obj</code> is set to an AsyncResult with 9839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * one of the following members:.<p> 9849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project *<ul> 985767a662ecde33c3979bf02b793d392aca0403162Wink Saville * <li><code>response.obj.result</code> will be a <code>List</code> of 986767a662ecde33c3979bf02b793d392aca0403162Wink Saville * <code>com.android.internal.telephony.gsm.NetworkInfo</code> objects, or</li> 987767a662ecde33c3979bf02b793d392aca0403162Wink Saville * <li><code>response.obj.exception</code> will be set with an exception 9889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * on failure.</li> 9899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * </ul> 9909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 991767a662ecde33c3979bf02b793d392aca0403162Wink Saville void getAvailableNetworks(Message response); 9929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 9949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Switches network selection mode to "automatic", re-scanning and 9959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * re-selecting a network if appropriate. 996767a662ecde33c3979bf02b793d392aca0403162Wink Saville * 997767a662ecde33c3979bf02b793d392aca0403162Wink Saville * @param response The message to dispatch when the network selection 9989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is complete. 999767a662ecde33c3979bf02b793d392aca0403162Wink Saville * 1000767a662ecde33c3979bf02b793d392aca0403162Wink Saville * @see #selectNetworkManually(com.android.internal.telephony.gsm.NetworkInfo, 10019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * android.os.Message ) 10029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 10039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project void setNetworkSelectionModeAutomatic(Message response); 10049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1006767a662ecde33c3979bf02b793d392aca0403162Wink Saville * Manually selects a network. <code>response</code> is 10079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * dispatched when this is complete. <code>response.obj</code> will be 10089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * an AsyncResult, and <code>response.obj.exception</code> will be non-null 10099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * on failure. 1010767a662ecde33c3979bf02b793d392aca0403162Wink Saville * 10119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #setNetworkSelectionModeAutomatic(Message) 10129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1013767a662ecde33c3979bf02b793d392aca0403162Wink Saville void selectNetworkManually(NetworkInfo network, 10149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Message response); 10159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 10179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Requests to set the preferred network type for searching and registering 10189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * (CS/PS domain, RAT, and operation mode) 10199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param networkType one of NT_*_TYPE 10209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param response is callback message 10219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 10229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project void setPreferredNetworkType(int networkType, Message response); 10239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 10259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Query the preferred network type setting 10269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 10279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param response is callback message to report one of NT_*_TYPE 10289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 10299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project void getPreferredNetworkType(Message response); 10309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1032c06ce125408696fd49c7fa9e1189ecb61804007ajsh * Gets the default SMSC address. 1033c06ce125408696fd49c7fa9e1189ecb61804007ajsh * 1034c06ce125408696fd49c7fa9e1189ecb61804007ajsh * @param result Callback message contains the SMSC address. 1035c06ce125408696fd49c7fa9e1189ecb61804007ajsh */ 1036c06ce125408696fd49c7fa9e1189ecb61804007ajsh void getSmscAddress(Message result); 1037c06ce125408696fd49c7fa9e1189ecb61804007ajsh 1038c06ce125408696fd49c7fa9e1189ecb61804007ajsh /** 1039c06ce125408696fd49c7fa9e1189ecb61804007ajsh * Sets the default SMSC address. 1040c06ce125408696fd49c7fa9e1189ecb61804007ajsh * 1041c06ce125408696fd49c7fa9e1189ecb61804007ajsh * @param address new SMSC address 1042c06ce125408696fd49c7fa9e1189ecb61804007ajsh * @param result Callback message is empty on completion 1043c06ce125408696fd49c7fa9e1189ecb61804007ajsh */ 1044c06ce125408696fd49c7fa9e1189ecb61804007ajsh void setSmscAddress(String address, Message result); 1045c06ce125408696fd49c7fa9e1189ecb61804007ajsh 1046c06ce125408696fd49c7fa9e1189ecb61804007ajsh /** 10479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Query neighboring cell IDs. <code>response</code> is dispatched when 10489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * this is complete. <code>response.obj</code> will be an AsyncResult, 10499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * and <code>response.obj.exception</code> will be non-null on failure. 10509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * On success, <code>AsyncResult.result</code> will be a <code>String[]</code> 10519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * containing the neighboring cell IDs. Index 0 will contain the count 10529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * of available cell IDs. Cell IDs are in hexadecimal format. 10539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 10549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param response callback message that is dispatched when the query 1055767a662ecde33c3979bf02b793d392aca0403162Wink Saville * completes. 10569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 10579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project void getNeighboringCids(Message response); 10589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 10609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Sets an event to be fired when the telephony system processes 10619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * a post-dial character on an outgoing call.<p> 10629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 10639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Messages of type <code>what</code> will be sent to <code>h</code>. 10649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The <code>obj</code> field of these Message's will be instances of 10659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <code>AsyncResult</code>. <code>Message.obj.result</code> will be 10669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * a Connection object.<p> 10679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1068767a662ecde33c3979bf02b793d392aca0403162Wink Saville * Message.arg1 will be the post dial character being processed, 10699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * or 0 ('\0') if end of string.<p> 10709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1071767a662ecde33c3979bf02b793d392aca0403162Wink Saville * If Connection.getPostDialState() == WAIT, 1072767a662ecde33c3979bf02b793d392aca0403162Wink Saville * the application must call 1073767a662ecde33c3979bf02b793d392aca0403162Wink Saville * {@link com.android.internal.telephony.Connection#proceedAfterWaitChar() 1074767a662ecde33c3979bf02b793d392aca0403162Wink Saville * Connection.proceedAfterWaitChar()} or 1075767a662ecde33c3979bf02b793d392aca0403162Wink Saville * {@link com.android.internal.telephony.Connection#cancelPostDial() 10769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Connection.cancelPostDial()} 1077767a662ecde33c3979bf02b793d392aca0403162Wink Saville * for the telephony system to continue playing the post-dial 10789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * DTMF sequence.<p> 10799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1080767a662ecde33c3979bf02b793d392aca0403162Wink Saville * If Connection.getPostDialState() == WILD, 1081767a662ecde33c3979bf02b793d392aca0403162Wink Saville * the application must call 10829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link com.android.internal.telephony.Connection#proceedAfterWildChar 10839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Connection.proceedAfterWildChar()} 1084767a662ecde33c3979bf02b793d392aca0403162Wink Saville * or 1085767a662ecde33c3979bf02b793d392aca0403162Wink Saville * {@link com.android.internal.telephony.Connection#cancelPostDial() 10869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Connection.cancelPostDial()} 1087767a662ecde33c3979bf02b793d392aca0403162Wink Saville * for the telephony system to continue playing the 10889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * post-dial DTMF sequence.<p> 1089767a662ecde33c3979bf02b793d392aca0403162Wink Saville * 10909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Only one post dial character handler may be set. <p> 10919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Calling this method with "h" equal to null unsets this handler.<p> 10929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 10939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project void setOnPostDialCharacter(Handler h, int what, Object obj); 10949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1097767a662ecde33c3979bf02b793d392aca0403162Wink Saville * Mutes or unmutes the microphone for the active call. The microphone 1098767a662ecde33c3979bf02b793d392aca0403162Wink Saville * is automatically unmuted if a call is answered, dialed, or resumed 10999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * from a holding state. 1100767a662ecde33c3979bf02b793d392aca0403162Wink Saville * 1101767a662ecde33c3979bf02b793d392aca0403162Wink Saville * @param muted true to mute the microphone, 11029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * false to activate the microphone. 11039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 11049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project void setMute(boolean muted); 11069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1108767a662ecde33c3979bf02b793d392aca0403162Wink Saville * Gets current mute status. Use 11091c42769339d8fe98ecb2698c64e7dc6672e3d59dJaikumar Ganesh * {@link #registerForPreciseCallStateChanged(android.os.Handler, int, 11101c42769339d8fe98ecb2698c64e7dc6672e3d59dJaikumar Ganesh * java.lang.Object) registerForPreciseCallStateChanged()} 11119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * as a change notifcation, although presently phone state changed is not 11129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * fired when setMute() is called. 11139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 11149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true is muting, false is unmuting 11159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 11169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project boolean getMute(); 11179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 11199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Invokes RIL_REQUEST_OEM_HOOK_RAW on RIL implementation. 1120767a662ecde33c3979bf02b793d392aca0403162Wink Saville * 11219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param data The data for the request. 1122767a662ecde33c3979bf02b793d392aca0403162Wink Saville * @param response <strong>On success</strong>, 11239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * (byte[])(((AsyncResult)response.obj).result) 1124767a662ecde33c3979bf02b793d392aca0403162Wink Saville * <strong>On failure</strong>, 1125767a662ecde33c3979bf02b793d392aca0403162Wink Saville * (((AsyncResult)response.obj).result) == null and 11269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * (((AsyncResult)response.obj).exception) being an instance of 11279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * com.android.internal.telephony.gsm.CommandException 11289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 11299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #invokeOemRilRequestRaw(byte[], android.os.Message) 11309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 11319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project void invokeOemRilRequestRaw(byte[] data, Message response); 11329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 11349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Invokes RIL_REQUEST_OEM_HOOK_Strings on RIL implementation. 1135767a662ecde33c3979bf02b793d392aca0403162Wink Saville * 11369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param strings The strings to make available as the request data. 1137767a662ecde33c3979bf02b793d392aca0403162Wink Saville * @param response <strong>On success</strong>, "response" bytes is 11389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * made available as: 11399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * (String[])(((AsyncResult)response.obj).result). 1140767a662ecde33c3979bf02b793d392aca0403162Wink Saville * <strong>On failure</strong>, 1141767a662ecde33c3979bf02b793d392aca0403162Wink Saville * (((AsyncResult)response.obj).result) == null and 11429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * (((AsyncResult)response.obj).exception) being an instance of 11439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * com.android.internal.telephony.gsm.CommandException 11449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 11459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #invokeOemRilRequestStrings(java.lang.String[], android.os.Message) 11469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 11479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project void invokeOemRilRequestStrings(String[] strings, Message response); 11489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 11509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Get the current active PDP context list 11519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1152767a662ecde33c3979bf02b793d392aca0403162Wink Saville * @deprecated 11539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param response <strong>On success</strong>, "response" bytes is 11549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * made available as: 11559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * (String[])(((AsyncResult)response.obj).result). 11569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <strong>On failure</strong>, 11579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * (((AsyncResult)response.obj).result) == null and 11589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * (((AsyncResult)response.obj).exception) being an instance of 11599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * com.android.internal.telephony.gsm.CommandException 11609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 11619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project void getPdpContextList(Message response); 11629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1164767a662ecde33c3979bf02b793d392aca0403162Wink Saville * Get the current active Data Call list, substitutes getPdpContextList 1165767a662ecde33c3979bf02b793d392aca0403162Wink Saville * 1166767a662ecde33c3979bf02b793d392aca0403162Wink Saville * @param response <strong>On success</strong>, "response" bytes is 1167767a662ecde33c3979bf02b793d392aca0403162Wink Saville * made available as: 1168767a662ecde33c3979bf02b793d392aca0403162Wink Saville * (String[])(((AsyncResult)response.obj).result). 1169767a662ecde33c3979bf02b793d392aca0403162Wink Saville * <strong>On failure</strong>, 1170767a662ecde33c3979bf02b793d392aca0403162Wink Saville * (((AsyncResult)response.obj).result) == null and 1171767a662ecde33c3979bf02b793d392aca0403162Wink Saville * (((AsyncResult)response.obj).exception) being an instance of 1172767a662ecde33c3979bf02b793d392aca0403162Wink Saville * com.android.internal.telephony.gsm.CommandException 1173767a662ecde33c3979bf02b793d392aca0403162Wink Saville */ 1174767a662ecde33c3979bf02b793d392aca0403162Wink Saville void getDataCallList(Message response); 1175767a662ecde33c3979bf02b793d392aca0403162Wink Saville 1176767a662ecde33c3979bf02b793d392aca0403162Wink Saville /** 11779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Get current mutiple PDP link status 1178767a662ecde33c3979bf02b793d392aca0403162Wink Saville * 1179767a662ecde33c3979bf02b793d392aca0403162Wink Saville * @deprecated 11809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return list of pdp link connections 11819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 11829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project List<PdpConnection> getCurrentPdpList (); 11839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1185767a662ecde33c3979bf02b793d392aca0403162Wink Saville * Get current mutiple data connection status 1186767a662ecde33c3979bf02b793d392aca0403162Wink Saville * 1187767a662ecde33c3979bf02b793d392aca0403162Wink Saville * @return list of data connections 1188767a662ecde33c3979bf02b793d392aca0403162Wink Saville */ 1189767a662ecde33c3979bf02b793d392aca0403162Wink Saville List<DataConnection> getCurrentDataConnectionList (); 1190767a662ecde33c3979bf02b793d392aca0403162Wink Saville 1191767a662ecde33c3979bf02b793d392aca0403162Wink Saville /** 11927a043b351b43e963605afef6ab76a52ae3a9270eTammo Spalink * Update the ServiceState CellLocation for current network registration. 11939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 11947a043b351b43e963605afef6ab76a52ae3a9270eTammo Spalink void updateServiceLocation(); 11959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 11979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Enable location update notifications. 11989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 11999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project void enableLocationUpdates(); 12009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 12029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Disable location update notifications. 12039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 12049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project void disableLocationUpdates(); 12059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1207767a662ecde33c3979bf02b793d392aca0403162Wink Saville * For unit tests; don't send notifications to "Phone" 12089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * mailbox registrants if true. 12099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 12109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project void setUnitTestMode(boolean f); 1211767a662ecde33c3979bf02b793d392aca0403162Wink Saville 12129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 12139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true If unit test mode is enabled 12149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 12159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project boolean getUnitTestMode(); 12169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 12189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Assign a specified band for RF configuration. 12199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 12209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param bandMode one of BM_*_BAND 12219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param response is callback message 12229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 12239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project void setBandMode(int bandMode, Message response); 12249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 12269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Query the list of band mode supported by RF. 12279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 12289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param response is callback message 12299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * ((AsyncResult)response.obj).result is an int[] with every 12309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * element representing one avialable BM_*_BAND 12319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 12329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project void queryAvailableBandMode(Message response); 12339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 12359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if enable data connection on roaming 12369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 12379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project boolean getDataRoamingEnabled(); 12389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 12409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param enable set true if enable data connection on roaming 12419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 12429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project void setDataRoamingEnabled(boolean enable); 12439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1245767a662ecde33c3979bf02b793d392aca0403162Wink Saville * Query the CDMA roaming preference setting 1246767a662ecde33c3979bf02b793d392aca0403162Wink Saville * 1247767a662ecde33c3979bf02b793d392aca0403162Wink Saville * @param response is callback message to report one of CDMA_RM_* 1248767a662ecde33c3979bf02b793d392aca0403162Wink Saville */ 1249767a662ecde33c3979bf02b793d392aca0403162Wink Saville void queryCdmaRoamingPreference(Message response); 1250767a662ecde33c3979bf02b793d392aca0403162Wink Saville 1251767a662ecde33c3979bf02b793d392aca0403162Wink Saville /** 1252767a662ecde33c3979bf02b793d392aca0403162Wink Saville * Requests to set the CDMA roaming preference 1253767a662ecde33c3979bf02b793d392aca0403162Wink Saville * @param cdmaRoamingType one of CDMA_RM_* 1254767a662ecde33c3979bf02b793d392aca0403162Wink Saville * @param response is callback message 1255767a662ecde33c3979bf02b793d392aca0403162Wink Saville */ 1256767a662ecde33c3979bf02b793d392aca0403162Wink Saville void setCdmaRoamingPreference(int cdmaRoamingType, Message response); 1257767a662ecde33c3979bf02b793d392aca0403162Wink Saville 1258767a662ecde33c3979bf02b793d392aca0403162Wink Saville /** 1259767a662ecde33c3979bf02b793d392aca0403162Wink Saville * Requests to set the CDMA subscription mode 1260767a662ecde33c3979bf02b793d392aca0403162Wink Saville * @param cdmaSubscriptionType one of CDMA_SUBSCRIPTION_* 1261767a662ecde33c3979bf02b793d392aca0403162Wink Saville * @param response is callback message 1262767a662ecde33c3979bf02b793d392aca0403162Wink Saville */ 1263767a662ecde33c3979bf02b793d392aca0403162Wink Saville void setCdmaSubscription(int cdmaSubscriptionType, Message response); 1264767a662ecde33c3979bf02b793d392aca0403162Wink Saville 1265767a662ecde33c3979bf02b793d392aca0403162Wink Saville /** 12669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * If this is a simulated phone interface, returns a SimulatedRadioControl. 1267767a662ecde33c3979bf02b793d392aca0403162Wink Saville * @ return A SimulatedRadioControl if this is a simulated interface; 12689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * otherwise, null. 12699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 12709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project SimulatedRadioControl getSimulatedRadioControl(); 12719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 12739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Allow mobile data connections. 12749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return {@code true} if the operation started successfully 12759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <br/>{@code false} if it 12769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * failed immediately.<br/> 12779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Even in the {@code true} case, it may still fail later 12789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * during setup, in which case an asynchronous indication will 12799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * be supplied. 12809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 12819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project boolean enableDataConnectivity(); 12829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 12849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Disallow mobile data connections, and terminate any that 12859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * are in progress. 12869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return {@code true} if the operation started successfully 12879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <br/>{@code false} if it 12889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * failed immediately.<br/> 12899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Even in the {@code true} case, it may still fail later 12909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * during setup, in which case an asynchronous indication will 12919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * be supplied. 12929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 12939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project boolean disableDataConnectivity(); 12949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1296c6d6b687af385d2a4e5f5210a9111d7b1acc233cWink Saville * Report the current state of data connectivity (enabled or disabled) 1297c6d6b687af385d2a4e5f5210a9111d7b1acc233cWink Saville * @return {@code false} if data connectivity has been explicitly disabled, 1298c6d6b687af385d2a4e5f5210a9111d7b1acc233cWink Saville * {@code true} otherwise. 1299c6d6b687af385d2a4e5f5210a9111d7b1acc233cWink Saville */ 1300c6d6b687af385d2a4e5f5210a9111d7b1acc233cWink Saville boolean isDataConnectivityEnabled(); 1301c6d6b687af385d2a4e5f5210a9111d7b1acc233cWink Saville 1302c6d6b687af385d2a4e5f5210a9111d7b1acc233cWink Saville /** 13039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Enables the specified APN type. Only works for "special" APN types, 13049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * i.e., not the default APN. 13059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param type The desired APN type. Cannot be {@link #APN_TYPE_DEFAULT}. 13069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return <code>APN_ALREADY_ACTIVE</code> if the current APN 13079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * services the requested type.<br/> 13089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <code>APN_TYPE_NOT_AVAILABLE</code> if the carrier does not 13099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * support the requested APN.<br/> 13109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <code>APN_REQUEST_STARTED</code> if the request has been initiated.<br/> 13119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <code>APN_REQUEST_FAILED</code> if the request was invalid.<br/> 13129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * A <code>ACTION_ANY_DATA_CONNECTION_STATE_CHANGED</code> broadcast will 13139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * indicate connection state progress. 13149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 13159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int enableApnType(String type); 13169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 13179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 13189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Disables the specified APN type, and switches back to the default APN, 13199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * if necessary. Switching to the default APN will not happen if default 13209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * data traffic has been explicitly disabled via a call to {@link #disableDataConnectivity}. 13219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p/>Only works for "special" APN types, 13229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * i.e., not the default APN. 13239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param type The desired APN type. Cannot be {@link #APN_TYPE_DEFAULT}. 13249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return <code>APN_ALREADY_ACTIVE</code> if the default APN 13259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is already active.<br/> 13269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <code>APN_REQUEST_STARTED</code> if the request to switch to the default 13279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * APN has been initiated.<br/> 13289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <code>APN_REQUEST_FAILED</code> if the request was invalid.<br/> 13299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * A <code>ACTION_ANY_DATA_CONNECTION_STATE_CHANGED</code> broadcast will 13309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * indicate connection state progress. 13319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 13329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int disableApnType(String type); 13339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 13349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 13359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Report on whether data connectivity is allowed. 13369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 13379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project boolean isDataConnectivityPossible(); 13389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 13399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 13409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the name of the network interface used by the specified APN type. 13419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 13429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String getInterfaceName(String apnType); 13439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 13449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 13459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the IP address of the network interface used by the specified 13469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * APN type. 13479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 13489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String getIpAddress(String apnType); 13499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 13509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 13519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the gateway for the network interface used by the specified APN 13529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * type. 13539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 13549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String getGateway(String apnType); 13559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 13569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 13579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the DNS servers for the network interface used by the specified 13589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * APN type. 13599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 13609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public String[] getDnsServers(String apnType); 13619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 13629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1363767a662ecde33c3979bf02b793d392aca0403162Wink Saville * Retrieves the unique device ID, e.g., IMEI for GSM phones and MEID for CDMA phones. 13649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 13659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String getDeviceId(); 13669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 13679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 13689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Retrieves the software version number for the device, e.g., IMEI/SV 13699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * for GSM phones. 13709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 13719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String getDeviceSvn(); 13729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 13739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 13749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Retrieves the unique sbuscriber ID, e.g., IMSI for GSM phones. 13759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 13769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String getSubscriberId(); 13779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 13789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1379767a662ecde33c3979bf02b793d392aca0403162Wink Saville * Retrieves the serial number of the ICC, if applicable. 1380767a662ecde33c3979bf02b793d392aca0403162Wink Saville */ 1381767a662ecde33c3979bf02b793d392aca0403162Wink Saville String getIccSerialNumber(); 1382767a662ecde33c3979bf02b793d392aca0403162Wink Saville 1383a3659232ba9f7f3ba87ff036d17e08a46cf1be62Wink Saville /* CDMA support methods */ 1384767a662ecde33c3979bf02b793d392aca0403162Wink Saville 1385dda5391d5079537e275c9f4ed2637a1484d0e4e8Wink Saville /* 1386dda5391d5079537e275c9f4ed2637a1484d0e4e8Wink Saville * TODO(Moto) TODO(Teleca): can getCdmaMin, getEsn, getMeid use more generic calls 1387dda5391d5079537e275c9f4ed2637a1484d0e4e8Wink Saville * already defined getXxxx above? 1388dda5391d5079537e275c9f4ed2637a1484d0e4e8Wink Saville */ 1389dda5391d5079537e275c9f4ed2637a1484d0e4e8Wink Saville 1390e9b06d754af03faf27012fbed1e7559ec1ba7c79Wink Saville /** 1391e9b06d754af03faf27012fbed1e7559ec1ba7c79Wink Saville * Retrieves the MIN for CDMA phones. 1392e9b06d754af03faf27012fbed1e7559ec1ba7c79Wink Saville */ 1393dda5391d5079537e275c9f4ed2637a1484d0e4e8Wink Saville String getCdmaMin(); 1394767a662ecde33c3979bf02b793d392aca0403162Wink Saville 1395767a662ecde33c3979bf02b793d392aca0403162Wink Saville /** 13969e652dcc213b96087ccadc730b1e6b1891cd02aeJinghui Guo * Check if subscription data has been assigned to mMin 13979e652dcc213b96087ccadc730b1e6b1891cd02aeJinghui Guo * 13989e652dcc213b96087ccadc730b1e6b1891cd02aeJinghui Guo * return true if MIN info is ready; false otherwise. 13999e652dcc213b96087ccadc730b1e6b1891cd02aeJinghui Guo */ 14009e652dcc213b96087ccadc730b1e6b1891cd02aeJinghui Guo boolean isMinInfoReady(); 14019e652dcc213b96087ccadc730b1e6b1891cd02aeJinghui Guo 14029e652dcc213b96087ccadc730b1e6b1891cd02aeJinghui Guo /** 140322ccaf5321cf9d2df57cf0d686d1abcd74acb193Wink Saville * Retrieves PRL Version for CDMA phones 140422ccaf5321cf9d2df57cf0d686d1abcd74acb193Wink Saville */ 140522ccaf5321cf9d2df57cf0d686d1abcd74acb193Wink Saville String getCdmaPrlVersion(); 140622ccaf5321cf9d2df57cf0d686d1abcd74acb193Wink Saville 140722ccaf5321cf9d2df57cf0d686d1abcd74acb193Wink Saville /** 1408767a662ecde33c3979bf02b793d392aca0403162Wink Saville * Retrieves the ESN for CDMA phones. 14099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1410767a662ecde33c3979bf02b793d392aca0403162Wink Saville String getEsn(); 1411767a662ecde33c3979bf02b793d392aca0403162Wink Saville 1412767a662ecde33c3979bf02b793d392aca0403162Wink Saville /** 1413767a662ecde33c3979bf02b793d392aca0403162Wink Saville * Retrieves MEID for CDMA phones. 1414767a662ecde33c3979bf02b793d392aca0403162Wink Saville */ 1415767a662ecde33c3979bf02b793d392aca0403162Wink Saville String getMeid(); 1416767a662ecde33c3979bf02b793d392aca0403162Wink Saville 1417767a662ecde33c3979bf02b793d392aca0403162Wink Saville /** 1418767a662ecde33c3979bf02b793d392aca0403162Wink Saville * Retrieves the PhoneSubInfo of the Phone 1419767a662ecde33c3979bf02b793d392aca0403162Wink Saville */ 1420767a662ecde33c3979bf02b793d392aca0403162Wink Saville public PhoneSubInfo getPhoneSubInfo(); 1421767a662ecde33c3979bf02b793d392aca0403162Wink Saville 1422767a662ecde33c3979bf02b793d392aca0403162Wink Saville /** 1423767a662ecde33c3979bf02b793d392aca0403162Wink Saville * Retrieves the IccSmsInterfaceManager of the Phone 1424767a662ecde33c3979bf02b793d392aca0403162Wink Saville */ 1425767a662ecde33c3979bf02b793d392aca0403162Wink Saville public IccSmsInterfaceManager getIccSmsInterfaceManager(); 1426767a662ecde33c3979bf02b793d392aca0403162Wink Saville 1427767a662ecde33c3979bf02b793d392aca0403162Wink Saville /** 1428767a662ecde33c3979bf02b793d392aca0403162Wink Saville * Retrieves the IccPhoneBookInterfaceManager of the Phone 1429767a662ecde33c3979bf02b793d392aca0403162Wink Saville */ 1430767a662ecde33c3979bf02b793d392aca0403162Wink Saville public IccPhoneBookInterfaceManager getIccPhoneBookInterfaceManager(); 1431767a662ecde33c3979bf02b793d392aca0403162Wink Saville 1432767a662ecde33c3979bf02b793d392aca0403162Wink Saville /** 1433e9b06d754af03faf27012fbed1e7559ec1ba7c79Wink Saville * setTTYMode 1434767a662ecde33c3979bf02b793d392aca0403162Wink Saville * sets a TTY mode option. 1435767a662ecde33c3979bf02b793d392aca0403162Wink Saville * 1436767a662ecde33c3979bf02b793d392aca0403162Wink Saville * @param enable is a boolean representing the state that you are 1437767a662ecde33c3979bf02b793d392aca0403162Wink Saville * requesting, true for enabled, false for disabled. 1438767a662ecde33c3979bf02b793d392aca0403162Wink Saville * @param onComplete a callback message when the action is completed 1439767a662ecde33c3979bf02b793d392aca0403162Wink Saville */ 1440e9b06d754af03faf27012fbed1e7559ec1ba7c79Wink Saville void setTTYMode(int ttyMode, Message onComplete); 1441767a662ecde33c3979bf02b793d392aca0403162Wink Saville 1442767a662ecde33c3979bf02b793d392aca0403162Wink Saville /** 1443e9b06d754af03faf27012fbed1e7559ec1ba7c79Wink Saville * queryTTYMode 1444767a662ecde33c3979bf02b793d392aca0403162Wink Saville * query the status of the TTY mode 1445767a662ecde33c3979bf02b793d392aca0403162Wink Saville * 1446767a662ecde33c3979bf02b793d392aca0403162Wink Saville * @param onComplete a callback message when the action is completed. 1447767a662ecde33c3979bf02b793d392aca0403162Wink Saville */ 1448e9b06d754af03faf27012fbed1e7559ec1ba7c79Wink Saville void queryTTYMode(Message onComplete); 1449e9b06d754af03faf27012fbed1e7559ec1ba7c79Wink Saville 1450e9b06d754af03faf27012fbed1e7559ec1ba7c79Wink Saville /** 1451767a662ecde33c3979bf02b793d392aca0403162Wink Saville * Activate or deactivate cell broadcast SMS. 1452767a662ecde33c3979bf02b793d392aca0403162Wink Saville * 1453767a662ecde33c3979bf02b793d392aca0403162Wink Saville * @param activate 1454767a662ecde33c3979bf02b793d392aca0403162Wink Saville * 0 = activate, 1 = deactivate 1455767a662ecde33c3979bf02b793d392aca0403162Wink Saville * @param response 1456767a662ecde33c3979bf02b793d392aca0403162Wink Saville * Callback message is empty on completion 1457767a662ecde33c3979bf02b793d392aca0403162Wink Saville */ 1458767a662ecde33c3979bf02b793d392aca0403162Wink Saville void activateCellBroadcastSms(int activate, Message response); 1459767a662ecde33c3979bf02b793d392aca0403162Wink Saville 1460767a662ecde33c3979bf02b793d392aca0403162Wink Saville /** 1461767a662ecde33c3979bf02b793d392aca0403162Wink Saville * Query the current configuration of cdma cell broadcast SMS. 1462767a662ecde33c3979bf02b793d392aca0403162Wink Saville * 1463767a662ecde33c3979bf02b793d392aca0403162Wink Saville * @param response 1464767a662ecde33c3979bf02b793d392aca0403162Wink Saville * Callback message is empty on completion 1465767a662ecde33c3979bf02b793d392aca0403162Wink Saville */ 1466767a662ecde33c3979bf02b793d392aca0403162Wink Saville void getCellBroadcastSmsConfig(Message response); 1467767a662ecde33c3979bf02b793d392aca0403162Wink Saville 1468767a662ecde33c3979bf02b793d392aca0403162Wink Saville /** 1469767a662ecde33c3979bf02b793d392aca0403162Wink Saville * Configure cell broadcast SMS. 1470767a662ecde33c3979bf02b793d392aca0403162Wink Saville * 1471e9b06d754af03faf27012fbed1e7559ec1ba7c79Wink Saville * TODO: Change the configValuesArray to a RIL_BroadcastSMSConfig 1472e9b06d754af03faf27012fbed1e7559ec1ba7c79Wink Saville * 1473767a662ecde33c3979bf02b793d392aca0403162Wink Saville * @param response 1474767a662ecde33c3979bf02b793d392aca0403162Wink Saville * Callback message is empty on completion 1475767a662ecde33c3979bf02b793d392aca0403162Wink Saville */ 1476767a662ecde33c3979bf02b793d392aca0403162Wink Saville public void setCellBroadcastSmsConfig(int[] configValuesArray, Message response); 1477767a662ecde33c3979bf02b793d392aca0403162Wink Saville 1478767a662ecde33c3979bf02b793d392aca0403162Wink Saville public void notifyDataActivity(); 1479e9b06d754af03faf27012fbed1e7559ec1ba7c79Wink Saville 1480e9b06d754af03faf27012fbed1e7559ec1ba7c79Wink Saville /** 1481e9b06d754af03faf27012fbed1e7559ec1ba7c79Wink Saville * Returns the CDMA ERI icon index to display 1482e9b06d754af03faf27012fbed1e7559ec1ba7c79Wink Saville */ 1483e9b06d754af03faf27012fbed1e7559ec1ba7c79Wink Saville public int getCdmaEriIconIndex(); 1484e9b06d754af03faf27012fbed1e7559ec1ba7c79Wink Saville 1485e9b06d754af03faf27012fbed1e7559ec1ba7c79Wink Saville /** 1486e9b06d754af03faf27012fbed1e7559ec1ba7c79Wink Saville * Returns the CDMA ERI icon mode, 1487e9b06d754af03faf27012fbed1e7559ec1ba7c79Wink Saville * 0 - ON 1488e9b06d754af03faf27012fbed1e7559ec1ba7c79Wink Saville * 1 - FLASHING 1489e9b06d754af03faf27012fbed1e7559ec1ba7c79Wink Saville */ 1490e9b06d754af03faf27012fbed1e7559ec1ba7c79Wink Saville public int getCdmaEriIconMode(); 1491e9b06d754af03faf27012fbed1e7559ec1ba7c79Wink Saville 1492e9b06d754af03faf27012fbed1e7559ec1ba7c79Wink Saville /** 1493e9b06d754af03faf27012fbed1e7559ec1ba7c79Wink Saville * Returns the CDMA ERI text, 1494e9b06d754af03faf27012fbed1e7559ec1ba7c79Wink Saville */ 1495e9b06d754af03faf27012fbed1e7559ec1ba7c79Wink Saville public String getCdmaEriText(); 1496e9b06d754af03faf27012fbed1e7559ec1ba7c79Wink Saville 1497dda5391d5079537e275c9f4ed2637a1484d0e4e8Wink Saville /** 1498dda5391d5079537e275c9f4ed2637a1484d0e4e8Wink Saville * request to exit emergency call back mode 1499dda5391d5079537e275c9f4ed2637a1484d0e4e8Wink Saville * the caller should use setOnECMModeExitResponse 1500dda5391d5079537e275c9f4ed2637a1484d0e4e8Wink Saville * to receive the emergency callback mode exit response 1501dda5391d5079537e275c9f4ed2637a1484d0e4e8Wink Saville */ 1502dda5391d5079537e275c9f4ed2637a1484d0e4e8Wink Saville void exitEmergencyCallbackMode(); 1503dda5391d5079537e275c9f4ed2637a1484d0e4e8Wink Saville 1504dda5391d5079537e275c9f4ed2637a1484d0e4e8Wink Saville /** 1505dda5391d5079537e275c9f4ed2637a1484d0e4e8Wink Saville * this decides if the dial number is OTA(Over the air provision) number or not 1506dda5391d5079537e275c9f4ed2637a1484d0e4e8Wink Saville * @param dialStr is string representing the dialing digit(s) 1507dda5391d5079537e275c9f4ed2637a1484d0e4e8Wink Saville * @return true means the dialStr is OTA number, and false means the dialStr is not OTA number 1508dda5391d5079537e275c9f4ed2637a1484d0e4e8Wink Saville */ 1509dda5391d5079537e275c9f4ed2637a1484d0e4e8Wink Saville boolean isOtaSpNumber(String dialStr); 1510dda5391d5079537e275c9f4ed2637a1484d0e4e8Wink Saville 1511dda5391d5079537e275c9f4ed2637a1484d0e4e8Wink Saville /** 1512dda5391d5079537e275c9f4ed2637a1484d0e4e8Wink Saville * Register for notifications when CDMA call waiting comes 1513dda5391d5079537e275c9f4ed2637a1484d0e4e8Wink Saville * 1514dda5391d5079537e275c9f4ed2637a1484d0e4e8Wink Saville * @param h Handler that receives the notification message. 1515dda5391d5079537e275c9f4ed2637a1484d0e4e8Wink Saville * @param what User-defined message code. 1516dda5391d5079537e275c9f4ed2637a1484d0e4e8Wink Saville * @param obj User object. 1517dda5391d5079537e275c9f4ed2637a1484d0e4e8Wink Saville */ 1518dda5391d5079537e275c9f4ed2637a1484d0e4e8Wink Saville void registerForCallWaiting(Handler h, int what, Object obj); 1519dda5391d5079537e275c9f4ed2637a1484d0e4e8Wink Saville 1520dda5391d5079537e275c9f4ed2637a1484d0e4e8Wink Saville /** 1521dda5391d5079537e275c9f4ed2637a1484d0e4e8Wink Saville * Unegister for notifications when CDMA Call waiting comes 1522dda5391d5079537e275c9f4ed2637a1484d0e4e8Wink Saville * @param h Handler to be removed from the registrant list. 1523dda5391d5079537e275c9f4ed2637a1484d0e4e8Wink Saville */ 1524dda5391d5079537e275c9f4ed2637a1484d0e4e8Wink Saville void unregisterForCallWaiting(Handler h); 1525dda5391d5079537e275c9f4ed2637a1484d0e4e8Wink Saville 1526dda5391d5079537e275c9f4ed2637a1484d0e4e8Wink Saville 1527dda5391d5079537e275c9f4ed2637a1484d0e4e8Wink Saville /** 1528dda5391d5079537e275c9f4ed2637a1484d0e4e8Wink Saville * Register for signal information notifications from the network. 1529dda5391d5079537e275c9f4ed2637a1484d0e4e8Wink Saville * Message.obj will contain an AsyncResult. 1530dda5391d5079537e275c9f4ed2637a1484d0e4e8Wink Saville * AsyncResult.result will be a SuppServiceNotification instance. 1531dda5391d5079537e275c9f4ed2637a1484d0e4e8Wink Saville * 1532dda5391d5079537e275c9f4ed2637a1484d0e4e8Wink Saville * @param h Handler that receives the notification message. 1533dda5391d5079537e275c9f4ed2637a1484d0e4e8Wink Saville * @param what User-defined message code. 1534dda5391d5079537e275c9f4ed2637a1484d0e4e8Wink Saville * @param obj User object. 1535dda5391d5079537e275c9f4ed2637a1484d0e4e8Wink Saville */ 1536dda5391d5079537e275c9f4ed2637a1484d0e4e8Wink Saville 1537dda5391d5079537e275c9f4ed2637a1484d0e4e8Wink Saville void registerForSignalInfo(Handler h, int what, Object obj) ; 1538dda5391d5079537e275c9f4ed2637a1484d0e4e8Wink Saville /** 1539dda5391d5079537e275c9f4ed2637a1484d0e4e8Wink Saville * Unregisters for signal information notifications. 1540dda5391d5079537e275c9f4ed2637a1484d0e4e8Wink Saville * Extraneous calls are tolerated silently 1541dda5391d5079537e275c9f4ed2637a1484d0e4e8Wink Saville * 1542dda5391d5079537e275c9f4ed2637a1484d0e4e8Wink Saville * @param h Handler to be removed from the registrant list. 1543dda5391d5079537e275c9f4ed2637a1484d0e4e8Wink Saville */ 1544dda5391d5079537e275c9f4ed2637a1484d0e4e8Wink Saville void unregisterForSignalInfo(Handler h); 1545dda5391d5079537e275c9f4ed2637a1484d0e4e8Wink Saville 1546dda5391d5079537e275c9f4ed2637a1484d0e4e8Wink Saville /** 1547dda5391d5079537e275c9f4ed2637a1484d0e4e8Wink Saville * Register for display information notifications from the network. 1548dda5391d5079537e275c9f4ed2637a1484d0e4e8Wink Saville * Message.obj will contain an AsyncResult. 1549dda5391d5079537e275c9f4ed2637a1484d0e4e8Wink Saville * AsyncResult.result will be a SuppServiceNotification instance. 1550dda5391d5079537e275c9f4ed2637a1484d0e4e8Wink Saville * 1551dda5391d5079537e275c9f4ed2637a1484d0e4e8Wink Saville * @param h Handler that receives the notification message. 1552dda5391d5079537e275c9f4ed2637a1484d0e4e8Wink Saville * @param what User-defined message code. 1553dda5391d5079537e275c9f4ed2637a1484d0e4e8Wink Saville * @param obj User object. 1554dda5391d5079537e275c9f4ed2637a1484d0e4e8Wink Saville */ 1555dda5391d5079537e275c9f4ed2637a1484d0e4e8Wink Saville void registerForDisplayInfo(Handler h, int what, Object obj); 1556dda5391d5079537e275c9f4ed2637a1484d0e4e8Wink Saville 1557dda5391d5079537e275c9f4ed2637a1484d0e4e8Wink Saville /** 1558dda5391d5079537e275c9f4ed2637a1484d0e4e8Wink Saville * Unregisters for display information notifications. 1559dda5391d5079537e275c9f4ed2637a1484d0e4e8Wink Saville * Extraneous calls are tolerated silently 1560dda5391d5079537e275c9f4ed2637a1484d0e4e8Wink Saville * 1561dda5391d5079537e275c9f4ed2637a1484d0e4e8Wink Saville * @param h Handler to be removed from the registrant list. 1562dda5391d5079537e275c9f4ed2637a1484d0e4e8Wink Saville */ 1563dda5391d5079537e275c9f4ed2637a1484d0e4e8Wink Saville void unregisterForDisplayInfo(Handler h) ; 1564dda5391d5079537e275c9f4ed2637a1484d0e4e8Wink Saville 156522ccaf5321cf9d2df57cf0d686d1abcd74acb193Wink Saville /** 156622ccaf5321cf9d2df57cf0d686d1abcd74acb193Wink Saville * Register for CDMA number information record notification from the network. 156722ccaf5321cf9d2df57cf0d686d1abcd74acb193Wink Saville * Message.obj will contain an AsyncResult. 156822ccaf5321cf9d2df57cf0d686d1abcd74acb193Wink Saville * AsyncResult.result will be a CdmaInformationRecords.CdmaNumberInfoRec 156922ccaf5321cf9d2df57cf0d686d1abcd74acb193Wink Saville * instance. 157022ccaf5321cf9d2df57cf0d686d1abcd74acb193Wink Saville * 157122ccaf5321cf9d2df57cf0d686d1abcd74acb193Wink Saville * @param h Handler that receives the notification message. 157222ccaf5321cf9d2df57cf0d686d1abcd74acb193Wink Saville * @param what User-defined message code. 157322ccaf5321cf9d2df57cf0d686d1abcd74acb193Wink Saville * @param obj User object. 157422ccaf5321cf9d2df57cf0d686d1abcd74acb193Wink Saville */ 157522ccaf5321cf9d2df57cf0d686d1abcd74acb193Wink Saville void registerForNumberInfo(Handler h, int what, Object obj); 157622ccaf5321cf9d2df57cf0d686d1abcd74acb193Wink Saville 157722ccaf5321cf9d2df57cf0d686d1abcd74acb193Wink Saville /** 157822ccaf5321cf9d2df57cf0d686d1abcd74acb193Wink Saville * Unregisters for number information record notifications. 157922ccaf5321cf9d2df57cf0d686d1abcd74acb193Wink Saville * Extraneous calls are tolerated silently 158022ccaf5321cf9d2df57cf0d686d1abcd74acb193Wink Saville * 158122ccaf5321cf9d2df57cf0d686d1abcd74acb193Wink Saville * @param h Handler to be removed from the registrant list. 158222ccaf5321cf9d2df57cf0d686d1abcd74acb193Wink Saville */ 158322ccaf5321cf9d2df57cf0d686d1abcd74acb193Wink Saville void unregisterForNumberInfo(Handler h); 158422ccaf5321cf9d2df57cf0d686d1abcd74acb193Wink Saville 158522ccaf5321cf9d2df57cf0d686d1abcd74acb193Wink Saville /** 158622ccaf5321cf9d2df57cf0d686d1abcd74acb193Wink Saville * Register for CDMA redirected number information record notification 158722ccaf5321cf9d2df57cf0d686d1abcd74acb193Wink Saville * from the network. 158822ccaf5321cf9d2df57cf0d686d1abcd74acb193Wink Saville * Message.obj will contain an AsyncResult. 158922ccaf5321cf9d2df57cf0d686d1abcd74acb193Wink Saville * AsyncResult.result will be a CdmaInformationRecords.CdmaRedirectingNumberInfoRec 159022ccaf5321cf9d2df57cf0d686d1abcd74acb193Wink Saville * instance. 159122ccaf5321cf9d2df57cf0d686d1abcd74acb193Wink Saville * 159222ccaf5321cf9d2df57cf0d686d1abcd74acb193Wink Saville * @param h Handler that receives the notification message. 159322ccaf5321cf9d2df57cf0d686d1abcd74acb193Wink Saville * @param what User-defined message code. 159422ccaf5321cf9d2df57cf0d686d1abcd74acb193Wink Saville * @param obj User object. 159522ccaf5321cf9d2df57cf0d686d1abcd74acb193Wink Saville */ 159622ccaf5321cf9d2df57cf0d686d1abcd74acb193Wink Saville void registerForRedirectedNumberInfo(Handler h, int what, Object obj); 159722ccaf5321cf9d2df57cf0d686d1abcd74acb193Wink Saville 159822ccaf5321cf9d2df57cf0d686d1abcd74acb193Wink Saville /** 159922ccaf5321cf9d2df57cf0d686d1abcd74acb193Wink Saville * Unregisters for redirected number information record notification. 160022ccaf5321cf9d2df57cf0d686d1abcd74acb193Wink Saville * Extraneous calls are tolerated silently 160122ccaf5321cf9d2df57cf0d686d1abcd74acb193Wink Saville * 160222ccaf5321cf9d2df57cf0d686d1abcd74acb193Wink Saville * @param h Handler to be removed from the registrant list. 160322ccaf5321cf9d2df57cf0d686d1abcd74acb193Wink Saville */ 160422ccaf5321cf9d2df57cf0d686d1abcd74acb193Wink Saville void unregisterForRedirectedNumberInfo(Handler h); 160522ccaf5321cf9d2df57cf0d686d1abcd74acb193Wink Saville 160622ccaf5321cf9d2df57cf0d686d1abcd74acb193Wink Saville /** 160722ccaf5321cf9d2df57cf0d686d1abcd74acb193Wink Saville * Register for CDMA line control information record notification 160822ccaf5321cf9d2df57cf0d686d1abcd74acb193Wink Saville * from the network. 160922ccaf5321cf9d2df57cf0d686d1abcd74acb193Wink Saville * Message.obj will contain an AsyncResult. 161022ccaf5321cf9d2df57cf0d686d1abcd74acb193Wink Saville * AsyncResult.result will be a CdmaInformationRecords.CdmaLineControlInfoRec 161122ccaf5321cf9d2df57cf0d686d1abcd74acb193Wink Saville * instance. 161222ccaf5321cf9d2df57cf0d686d1abcd74acb193Wink Saville * 161322ccaf5321cf9d2df57cf0d686d1abcd74acb193Wink Saville * @param h Handler that receives the notification message. 161422ccaf5321cf9d2df57cf0d686d1abcd74acb193Wink Saville * @param what User-defined message code. 161522ccaf5321cf9d2df57cf0d686d1abcd74acb193Wink Saville * @param obj User object. 161622ccaf5321cf9d2df57cf0d686d1abcd74acb193Wink Saville */ 161722ccaf5321cf9d2df57cf0d686d1abcd74acb193Wink Saville void registerForLineControlInfo(Handler h, int what, Object obj); 161822ccaf5321cf9d2df57cf0d686d1abcd74acb193Wink Saville 161922ccaf5321cf9d2df57cf0d686d1abcd74acb193Wink Saville /** 162022ccaf5321cf9d2df57cf0d686d1abcd74acb193Wink Saville * Unregisters for line control information notifications. 162122ccaf5321cf9d2df57cf0d686d1abcd74acb193Wink Saville * Extraneous calls are tolerated silently 162222ccaf5321cf9d2df57cf0d686d1abcd74acb193Wink Saville * 162322ccaf5321cf9d2df57cf0d686d1abcd74acb193Wink Saville * @param h Handler to be removed from the registrant list. 162422ccaf5321cf9d2df57cf0d686d1abcd74acb193Wink Saville */ 162522ccaf5321cf9d2df57cf0d686d1abcd74acb193Wink Saville void unregisterForLineControlInfo(Handler h); 162622ccaf5321cf9d2df57cf0d686d1abcd74acb193Wink Saville 162722ccaf5321cf9d2df57cf0d686d1abcd74acb193Wink Saville /** 162822ccaf5321cf9d2df57cf0d686d1abcd74acb193Wink Saville * Register for CDMA T53 CLIR information record notifications 162922ccaf5321cf9d2df57cf0d686d1abcd74acb193Wink Saville * from the network. 163022ccaf5321cf9d2df57cf0d686d1abcd74acb193Wink Saville * Message.obj will contain an AsyncResult. 163122ccaf5321cf9d2df57cf0d686d1abcd74acb193Wink Saville * AsyncResult.result will be a CdmaInformationRecords.CdmaT53ClirInfoRec 163222ccaf5321cf9d2df57cf0d686d1abcd74acb193Wink Saville * instance. 163322ccaf5321cf9d2df57cf0d686d1abcd74acb193Wink Saville * 163422ccaf5321cf9d2df57cf0d686d1abcd74acb193Wink Saville * @param h Handler that receives the notification message. 163522ccaf5321cf9d2df57cf0d686d1abcd74acb193Wink Saville * @param what User-defined message code. 163622ccaf5321cf9d2df57cf0d686d1abcd74acb193Wink Saville * @param obj User object. 163722ccaf5321cf9d2df57cf0d686d1abcd74acb193Wink Saville */ 163822ccaf5321cf9d2df57cf0d686d1abcd74acb193Wink Saville void registerFoT53ClirlInfo(Handler h, int what, Object obj); 163922ccaf5321cf9d2df57cf0d686d1abcd74acb193Wink Saville 164022ccaf5321cf9d2df57cf0d686d1abcd74acb193Wink Saville /** 164122ccaf5321cf9d2df57cf0d686d1abcd74acb193Wink Saville * Unregisters for T53 CLIR information record notification 164222ccaf5321cf9d2df57cf0d686d1abcd74acb193Wink Saville * Extraneous calls are tolerated silently 164322ccaf5321cf9d2df57cf0d686d1abcd74acb193Wink Saville * 164422ccaf5321cf9d2df57cf0d686d1abcd74acb193Wink Saville * @param h Handler to be removed from the registrant list. 164522ccaf5321cf9d2df57cf0d686d1abcd74acb193Wink Saville */ 164622ccaf5321cf9d2df57cf0d686d1abcd74acb193Wink Saville void unregisterForT53ClirInfo(Handler h); 164722ccaf5321cf9d2df57cf0d686d1abcd74acb193Wink Saville 164822ccaf5321cf9d2df57cf0d686d1abcd74acb193Wink Saville /** 164922ccaf5321cf9d2df57cf0d686d1abcd74acb193Wink Saville * Register for CDMA T53 audio control information record notifications 165022ccaf5321cf9d2df57cf0d686d1abcd74acb193Wink Saville * from the network. 165122ccaf5321cf9d2df57cf0d686d1abcd74acb193Wink Saville * Message.obj will contain an AsyncResult. 165222ccaf5321cf9d2df57cf0d686d1abcd74acb193Wink Saville * AsyncResult.result will be a CdmaInformationRecords.CdmaT53AudioControlInfoRec 165322ccaf5321cf9d2df57cf0d686d1abcd74acb193Wink Saville * instance. 165422ccaf5321cf9d2df57cf0d686d1abcd74acb193Wink Saville * 165522ccaf5321cf9d2df57cf0d686d1abcd74acb193Wink Saville * @param h Handler that receives the notification message. 165622ccaf5321cf9d2df57cf0d686d1abcd74acb193Wink Saville * @param what User-defined message code. 165722ccaf5321cf9d2df57cf0d686d1abcd74acb193Wink Saville * @param obj User object. 165822ccaf5321cf9d2df57cf0d686d1abcd74acb193Wink Saville */ 165922ccaf5321cf9d2df57cf0d686d1abcd74acb193Wink Saville void registerForT53AudioControlInfo(Handler h, int what, Object obj); 166022ccaf5321cf9d2df57cf0d686d1abcd74acb193Wink Saville 166122ccaf5321cf9d2df57cf0d686d1abcd74acb193Wink Saville /** 166222ccaf5321cf9d2df57cf0d686d1abcd74acb193Wink Saville * Unregisters for T53 audio control information record notifications. 166322ccaf5321cf9d2df57cf0d686d1abcd74acb193Wink Saville * Extraneous calls are tolerated silently 166422ccaf5321cf9d2df57cf0d686d1abcd74acb193Wink Saville * 166522ccaf5321cf9d2df57cf0d686d1abcd74acb193Wink Saville * @param h Handler to be removed from the registrant list. 166622ccaf5321cf9d2df57cf0d686d1abcd74acb193Wink Saville */ 166722ccaf5321cf9d2df57cf0d686d1abcd74acb193Wink Saville void unregisterForT53AudioControlInfo(Handler h); 1668dda5391d5079537e275c9f4ed2637a1484d0e4e8Wink Saville 1669dda5391d5079537e275c9f4ed2637a1484d0e4e8Wink Saville /** 1670dda5391d5079537e275c9f4ed2637a1484d0e4e8Wink Saville * registers for exit emergency call back mode request response 1671dda5391d5079537e275c9f4ed2637a1484d0e4e8Wink Saville * 1672dda5391d5079537e275c9f4ed2637a1484d0e4e8Wink Saville * @param h Handler that receives the notification message. 1673dda5391d5079537e275c9f4ed2637a1484d0e4e8Wink Saville * @param what User-defined message code. 1674dda5391d5079537e275c9f4ed2637a1484d0e4e8Wink Saville * @param obj User object. 1675dda5391d5079537e275c9f4ed2637a1484d0e4e8Wink Saville */ 1676dda5391d5079537e275c9f4ed2637a1484d0e4e8Wink Saville 1677dda5391d5079537e275c9f4ed2637a1484d0e4e8Wink Saville void setOnEcbModeExitResponse(Handler h, int what, Object obj); 1678dda5391d5079537e275c9f4ed2637a1484d0e4e8Wink Saville 1679dda5391d5079537e275c9f4ed2637a1484d0e4e8Wink Saville /** 1680dda5391d5079537e275c9f4ed2637a1484d0e4e8Wink Saville * Unregisters for exit emergency call back mode request response 1681dda5391d5079537e275c9f4ed2637a1484d0e4e8Wink Saville * 1682dda5391d5079537e275c9f4ed2637a1484d0e4e8Wink Saville * @param h Handler to be removed from the registrant list. 1683dda5391d5079537e275c9f4ed2637a1484d0e4e8Wink Saville */ 1684dda5391d5079537e275c9f4ed2637a1484d0e4e8Wink Saville void unsetOnEcbModeExitResponse(Handler h); 1685dda5391d5079537e275c9f4ed2637a1484d0e4e8Wink Saville 1686dda5391d5079537e275c9f4ed2637a1484d0e4e8Wink Saville 16879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project} 1688