IPhoneSubInfo.aidl revision fb40dd4d00bd3361b2535bc866e6c21eadc52558
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 Project/** 209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Interface used to retrieve various phone-related subscriber information. 219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectinterface IPhoneSubInfo { 249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Retrieves the unique device ID, e.g., IMEI for GSM phones. 279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String getDeviceId(); 299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 31fb40dd4d00bd3361b2535bc866e6c21eadc52558Wink Saville * Retrieves the unique device ID of a subId for the device, e.g., IMEI 32fb40dd4d00bd3361b2535bc866e6c21eadc52558Wink Saville * for GSM phones. 33fb40dd4d00bd3361b2535bc866e6c21eadc52558Wink Saville */ 34fb40dd4d00bd3361b2535bc866e6c21eadc52558Wink Saville String getDeviceIdUsingSubId(long subId); 35fb40dd4d00bd3361b2535bc866e6c21eadc52558Wink Saville 36fb40dd4d00bd3361b2535bc866e6c21eadc52558Wink Saville 37fb40dd4d00bd3361b2535bc866e6c21eadc52558Wink Saville /** 389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Retrieves the software version number for the device, e.g., IMEI/SV 399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * for GSM phones. 409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String getDeviceSvn(); 429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Retrieves the unique sbuscriber ID, e.g., IMSI for GSM phones. 459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String getSubscriberId(); 479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 49fb40dd4d00bd3361b2535bc866e6c21eadc52558Wink Saville * Retrieves the unique subscriber ID of a given subId, e.g., IMSI for GSM phones. 50fb40dd4d00bd3361b2535bc866e6c21eadc52558Wink Saville */ 51fb40dd4d00bd3361b2535bc866e6c21eadc52558Wink Saville String getSubscriberIdUsingSubId(long subId); 52fb40dd4d00bd3361b2535bc866e6c21eadc52558Wink Saville 53fb40dd4d00bd3361b2535bc866e6c21eadc52558Wink Saville /** 5452a08cf683a6d183222d795862cfd135cec5694fSungmin Choi * Retrieves the Group Identifier Level1 for GSM phones. 5552a08cf683a6d183222d795862cfd135cec5694fSungmin Choi */ 5652a08cf683a6d183222d795862cfd135cec5694fSungmin Choi String getGroupIdLevel1(); 5752a08cf683a6d183222d795862cfd135cec5694fSungmin Choi 5852a08cf683a6d183222d795862cfd135cec5694fSungmin Choi /** 59fb40dd4d00bd3361b2535bc866e6c21eadc52558Wink Saville * Retrieves the Group Identifier Level1 for GSM phones of a subId. 60fb40dd4d00bd3361b2535bc866e6c21eadc52558Wink Saville */ 61fb40dd4d00bd3361b2535bc866e6c21eadc52558Wink Saville String getGroupIdLevel1UsingSubId(long subId); 62fb40dd4d00bd3361b2535bc866e6c21eadc52558Wink Saville 63fb40dd4d00bd3361b2535bc866e6c21eadc52558Wink Saville /** 6404e71b3db84fd5f7fc4eefb49a33154ea91ec9fcWink Saville * Retrieves the serial number of the ICC, if applicable. 659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6604e71b3db84fd5f7fc4eefb49a33154ea91ec9fcWink Saville String getIccSerialNumber(); 679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 69fb40dd4d00bd3361b2535bc866e6c21eadc52558Wink Saville * Retrieves the serial number of a given subId. 70fb40dd4d00bd3361b2535bc866e6c21eadc52558Wink Saville */ 71fb40dd4d00bd3361b2535bc866e6c21eadc52558Wink Saville String getIccSerialNumberUsingSubId(long subId); 72fb40dd4d00bd3361b2535bc866e6c21eadc52558Wink Saville 73fb40dd4d00bd3361b2535bc866e6c21eadc52558Wink Saville /** 749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Retrieves the phone number string for line 1. 759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String getLine1Number(); 779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 79fb40dd4d00bd3361b2535bc866e6c21eadc52558Wink Saville * Retrieves the phone number string for line 1 of a subcription. 80fb40dd4d00bd3361b2535bc866e6c21eadc52558Wink Saville */ 81fb40dd4d00bd3361b2535bc866e6c21eadc52558Wink Saville String getLine1NumberUsingSubId(long subId); 82fb40dd4d00bd3361b2535bc866e6c21eadc52558Wink Saville 83fb40dd4d00bd3361b2535bc866e6c21eadc52558Wink Saville 84fb40dd4d00bd3361b2535bc866e6c21eadc52558Wink Saville /** 859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Retrieves the alpha identifier for line 1. 869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String getLine1AlphaTag(); 889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8904e71b3db84fd5f7fc4eefb49a33154ea91ec9fcWink Saville /** 90fb40dd4d00bd3361b2535bc866e6c21eadc52558Wink Saville * Retrieves the alpha identifier for line 1 of a subId. 91fb40dd4d00bd3361b2535bc866e6c21eadc52558Wink Saville */ 92fb40dd4d00bd3361b2535bc866e6c21eadc52558Wink Saville String getLine1AlphaTagUsingSubId(long subId); 93fb40dd4d00bd3361b2535bc866e6c21eadc52558Wink Saville 94fb40dd4d00bd3361b2535bc866e6c21eadc52558Wink Saville 95fb40dd4d00bd3361b2535bc866e6c21eadc52558Wink Saville /** 9680c32a37b63ceff885199e22a8505ac557c86d35duckyoung.chai * Retrieves MSISDN Number. 9780c32a37b63ceff885199e22a8505ac557c86d35duckyoung.chai */ 9880c32a37b63ceff885199e22a8505ac557c86d35duckyoung.chai String getMsisdn(); 9980c32a37b63ceff885199e22a8505ac557c86d35duckyoung.chai 10080c32a37b63ceff885199e22a8505ac557c86d35duckyoung.chai /** 101fb40dd4d00bd3361b2535bc866e6c21eadc52558Wink Saville * Retrieves the Msisdn of a subId. 102fb40dd4d00bd3361b2535bc866e6c21eadc52558Wink Saville */ 103fb40dd4d00bd3361b2535bc866e6c21eadc52558Wink Saville String getMsisdnUsingSubId(long subId); 104fb40dd4d00bd3361b2535bc866e6c21eadc52558Wink Saville 105fb40dd4d00bd3361b2535bc866e6c21eadc52558Wink Saville /** 10604e71b3db84fd5f7fc4eefb49a33154ea91ec9fcWink Saville * Retrieves the voice mail number. 10704e71b3db84fd5f7fc4eefb49a33154ea91ec9fcWink Saville */ 1089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String getVoiceMailNumber(); 1099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11004e71b3db84fd5f7fc4eefb49a33154ea91ec9fcWink Saville /** 111fb40dd4d00bd3361b2535bc866e6c21eadc52558Wink Saville * Retrieves the voice mail number of a given subId. 112fb40dd4d00bd3361b2535bc866e6c21eadc52558Wink Saville */ 113fb40dd4d00bd3361b2535bc866e6c21eadc52558Wink Saville String getVoiceMailNumberUsingSubId(long subId); 114fb40dd4d00bd3361b2535bc866e6c21eadc52558Wink Saville 115fb40dd4d00bd3361b2535bc866e6c21eadc52558Wink Saville /** 116c69f5be0ed3529564e5db6874de52775c2c99007Wink Saville * Retrieves the complete voice mail number. 117c69f5be0ed3529564e5db6874de52775c2c99007Wink Saville */ 118c69f5be0ed3529564e5db6874de52775c2c99007Wink Saville String getCompleteVoiceMailNumber(); 119c69f5be0ed3529564e5db6874de52775c2c99007Wink Saville 120c69f5be0ed3529564e5db6874de52775c2c99007Wink Saville /** 121fb40dd4d00bd3361b2535bc866e6c21eadc52558Wink Saville * Retrieves the complete voice mail number for particular subId 122fb40dd4d00bd3361b2535bc866e6c21eadc52558Wink Saville */ 123fb40dd4d00bd3361b2535bc866e6c21eadc52558Wink Saville String getCompleteVoiceMailNumberUsingSubId(long subId); 124fb40dd4d00bd3361b2535bc866e6c21eadc52558Wink Saville 125fb40dd4d00bd3361b2535bc866e6c21eadc52558Wink Saville /** 12604e71b3db84fd5f7fc4eefb49a33154ea91ec9fcWink Saville * Retrieves the alpha identifier associated with the voice mail number. 12704e71b3db84fd5f7fc4eefb49a33154ea91ec9fcWink Saville */ 1289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String getVoiceMailAlphaTag(); 129463f22114587344c96460179069a08d7381fbfd6Jake Hamby 130463f22114587344c96460179069a08d7381fbfd6Jake Hamby /** 131fb40dd4d00bd3361b2535bc866e6c21eadc52558Wink Saville * Retrieves the alpha identifier associated with the voice mail number 132fb40dd4d00bd3361b2535bc866e6c21eadc52558Wink Saville * of a subId. 133fb40dd4d00bd3361b2535bc866e6c21eadc52558Wink Saville */ 134fb40dd4d00bd3361b2535bc866e6c21eadc52558Wink Saville String getVoiceMailAlphaTagUsingSubId(long subId); 135fb40dd4d00bd3361b2535bc866e6c21eadc52558Wink Saville 136fb40dd4d00bd3361b2535bc866e6c21eadc52558Wink Saville /** 137463f22114587344c96460179069a08d7381fbfd6Jake Hamby * Returns the IMS private user identity (IMPI) that was loaded from the ISIM. 138463f22114587344c96460179069a08d7381fbfd6Jake Hamby * @return the IMPI, or null if not present or not loaded 139463f22114587344c96460179069a08d7381fbfd6Jake Hamby */ 140463f22114587344c96460179069a08d7381fbfd6Jake Hamby String getIsimImpi(); 141463f22114587344c96460179069a08d7381fbfd6Jake Hamby 142463f22114587344c96460179069a08d7381fbfd6Jake Hamby /** 143463f22114587344c96460179069a08d7381fbfd6Jake Hamby * Returns the IMS home network domain name that was loaded from the ISIM. 144463f22114587344c96460179069a08d7381fbfd6Jake Hamby * @return the IMS domain name, or null if not present or not loaded 145463f22114587344c96460179069a08d7381fbfd6Jake Hamby */ 146463f22114587344c96460179069a08d7381fbfd6Jake Hamby String getIsimDomain(); 147463f22114587344c96460179069a08d7381fbfd6Jake Hamby 148463f22114587344c96460179069a08d7381fbfd6Jake Hamby /** 149463f22114587344c96460179069a08d7381fbfd6Jake Hamby * Returns the IMS public user identities (IMPU) that were loaded from the ISIM. 150463f22114587344c96460179069a08d7381fbfd6Jake Hamby * @return an array of IMPU strings, with one IMPU per string, or null if 151463f22114587344c96460179069a08d7381fbfd6Jake Hamby * not present or not loaded 152463f22114587344c96460179069a08d7381fbfd6Jake Hamby */ 153463f22114587344c96460179069a08d7381fbfd6Jake Hamby String[] getIsimImpu(); 154fb40dd4d00bd3361b2535bc866e6c21eadc52558Wink Saville 155fb40dd4d00bd3361b2535bc866e6c21eadc52558Wink Saville /** 156fb40dd4d00bd3361b2535bc866e6c21eadc52558Wink Saville * Returns the IMS Service Table (IST) that was loaded from the ISIM. 157fb40dd4d00bd3361b2535bc866e6c21eadc52558Wink Saville * @return IMS Service Table or null if not present or not loaded 158fb40dd4d00bd3361b2535bc866e6c21eadc52558Wink Saville */ 159fb40dd4d00bd3361b2535bc866e6c21eadc52558Wink Saville String getIsimIst(); 160fb40dd4d00bd3361b2535bc866e6c21eadc52558Wink Saville 161fb40dd4d00bd3361b2535bc866e6c21eadc52558Wink Saville /** 162fb40dd4d00bd3361b2535bc866e6c21eadc52558Wink Saville * Returns the IMS Proxy Call Session Control Function(PCSCF) that were loaded from the ISIM. 163fb40dd4d00bd3361b2535bc866e6c21eadc52558Wink Saville * @return an array of PCSCF strings with one PCSCF per string, or null if 164fb40dd4d00bd3361b2535bc866e6c21eadc52558Wink Saville * not present or not loaded 165fb40dd4d00bd3361b2535bc866e6c21eadc52558Wink Saville */ 166fb40dd4d00bd3361b2535bc866e6c21eadc52558Wink Saville String[] getIsimPcscf(); 167fb40dd4d00bd3361b2535bc866e6c21eadc52558Wink Saville 168fb40dd4d00bd3361b2535bc866e6c21eadc52558Wink Saville /** 169fb40dd4d00bd3361b2535bc866e6c21eadc52558Wink Saville * TODO: Deprecate and remove this interface. Superceded by getIccsimChallengeResponse. 170fb40dd4d00bd3361b2535bc866e6c21eadc52558Wink Saville * Returns the response of ISIM Authetification through RIL. 171fb40dd4d00bd3361b2535bc866e6c21eadc52558Wink Saville * @return the response of ISIM Authetification, or null if 172fb40dd4d00bd3361b2535bc866e6c21eadc52558Wink Saville * the Authentification hasn't been successed or isn't present iphonesubinfo. 173fb40dd4d00bd3361b2535bc866e6c21eadc52558Wink Saville */ 174fb40dd4d00bd3361b2535bc866e6c21eadc52558Wink Saville String getIsimChallengeResponse(String nonce); 175fb40dd4d00bd3361b2535bc866e6c21eadc52558Wink Saville 176fb40dd4d00bd3361b2535bc866e6c21eadc52558Wink Saville /** 177fb40dd4d00bd3361b2535bc866e6c21eadc52558Wink Saville * Returns the response of the SIM application on the UICC to authentication 178fb40dd4d00bd3361b2535bc866e6c21eadc52558Wink Saville * challenge/response algorithm. The data string and challenge response are 179fb40dd4d00bd3361b2535bc866e6c21eadc52558Wink Saville * Base64 encoded Strings. 180fb40dd4d00bd3361b2535bc866e6c21eadc52558Wink Saville * Can support EAP-SIM, EAP-AKA with results encoded per 3GPP TS 31.102. 181fb40dd4d00bd3361b2535bc866e6c21eadc52558Wink Saville * 182fb40dd4d00bd3361b2535bc866e6c21eadc52558Wink Saville * @param subId subscription ID to be queried 183fb40dd4d00bd3361b2535bc866e6c21eadc52558Wink Saville * @param appType ICC application type (@see com.android.internal.telephony.PhoneConstants#APPTYPE_xxx) 184fb40dd4d00bd3361b2535bc866e6c21eadc52558Wink Saville * @param data authentication challenge data 185fb40dd4d00bd3361b2535bc866e6c21eadc52558Wink Saville * @return challenge response 186fb40dd4d00bd3361b2535bc866e6c21eadc52558Wink Saville */ 187fb40dd4d00bd3361b2535bc866e6c21eadc52558Wink Saville String getIccSimChallengeResponse(long subId, int appType, String data); 1889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project} 189