19066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/* 29066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project** Copyright 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 1704e71b3db84fd5f7fc4eefb49a33154ea91ec9fcWink Savillepackage com.android.internal.telephony; 189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1904e71b3db84fd5f7fc4eefb49a33154ea91ec9fcWink Savilleimport com.android.internal.telephony.AdnRecord; 209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2204e71b3db84fd5f7fc4eefb49a33154ea91ec9fcWink Saville 2304e71b3db84fd5f7fc4eefb49a33154ea91ec9fcWink Saville/** Interface for applications to access the ICC phone book. 249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>The following code snippet demonstrates a static method to 2604e71b3db84fd5f7fc4eefb49a33154ea91ec9fcWink Saville * retrieve the IIccPhoneBook interface from Android:</p> 2704e71b3db84fd5f7fc4eefb49a33154ea91ec9fcWink Saville * <pre>private static IIccPhoneBook getSimPhoneBookInterface() 289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throws DeadObjectException { 299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IServiceManager sm = ServiceManagerNative.getDefault(); 3004e71b3db84fd5f7fc4eefb49a33154ea91ec9fcWink Saville IIccPhoneBook spb; 3104e71b3db84fd5f7fc4eefb49a33154ea91ec9fcWink Saville spb = IIccPhoneBook.Stub.asInterface(sm.getService("iccphonebook")); 329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return spb; 339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project} 349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * </pre> 359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3704e71b3db84fd5f7fc4eefb49a33154ea91ec9fcWink Savilleinterface IIccPhoneBook { 389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Loads the AdnRecords in efid and returns them as a 419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * List of AdnRecords 429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param efid the EF id of a ADN-like SIM 449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return List of AdnRecord 459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project List<AdnRecord> getAdnRecordsInEf(int efid); 479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Replace oldAdn with newAdn in ADN-like record in EF 509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * getAdnRecordsInEf must be called at least once before this function, 529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * otherwise an error will be returned 539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param efid must be one among EF_ADN, EF_FDN, and EF_SDN 559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param oldTag adn tag to be replaced 569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param oldPhoneNumber adn number to be replaced 579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Set both oldTag and oldPhoneNubmer to "" means to replace an 589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * empty record, aka, insert new record 599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param newTag adn tag to be stored 609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param newPhoneNumber adn number ot be stored 619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Set both newTag and newPhoneNubmer to "" means to replace the old 629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * record with empty one, aka, delete old record 639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param pin2 required to update EF_FDN, otherwise must be null 649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true for success 659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project boolean updateAdnRecordsInEfBySearch(int efid, 679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String oldTag, String oldPhoneNumber, 689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String newTag, String newPhoneNumber, 699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String pin2); 709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Update an ADN-like EF record by record index 739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This is useful for iteration the whole ADN file, such as write the whole 759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * phone book or erase/format the whole phonebook 769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param efid must be one among EF_ADN, EF_FDN, and EF_SDN 789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param newTag adn tag to be stored 799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param newPhoneNumber adn number to be stored 809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Set both newTag and newPhoneNubmer to "" means to replace the old 819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * record with empty one, aka, delete old record 829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param index is 1-based adn record index to be updated 839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param pin2 required to update EF_FDN, otherwise must be null 849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true for success 859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project boolean updateAdnRecordsInEfByIndex(int efid, String newTag, 879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String newPhoneNumber, int index, 889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String pin2); 899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Get the max munber of records in efid 929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param efid the EF id of a ADN-like SIM 949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return int[3] array 959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * recordSizes[0] is the single record length 969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * recordSizes[1] is the total length of the EF file 979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * recordSizes[2] is the number of records in the EF file 989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int[] getAdnRecordsSize(int efid); 1009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project} 102