19066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/* 29066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Copyright (C) 2006 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 android.telephony.gsm; 189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.os.Bundle; 209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.telephony.CellLocation; 219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/** 239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Represents the cell location on a GSM phone. 249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2504e71b3db84fd5f7fc4eefb49a33154ea91ec9fcWink Savillepublic class GsmCellLocation extends CellLocation { 269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private int mLac; 279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private int mCid; 2805a5a88a171721705685d1ae3dcfe82780907210jsh private int mPsc; 299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Empty constructor. Initializes the LAC and CID to -1. 329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public GsmCellLocation() { 349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mLac = -1; 359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mCid = -1; 3605a5a88a171721705685d1ae3dcfe82780907210jsh mPsc = -1; 379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Initialize the object from a bundle. 419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public GsmCellLocation(Bundle bundle) { 439384b145e625b3bb6ff8b829ddb1466e16a78f49Mark Vandevoorde mLac = bundle.getInt("lac", mLac); 449384b145e625b3bb6ff8b829ddb1466e16a78f49Mark Vandevoorde mCid = bundle.getInt("cid", mCid); 4505a5a88a171721705685d1ae3dcfe82780907210jsh mPsc = bundle.getInt("psc", mPsc); 469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return gsm location area code, -1 if unknown, 0xffff max legal value 509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getLac() { 529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mLac; 539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return gsm cell id, -1 if unknown, 0xffff max legal value 579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getCid() { 599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mCid; 609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 632ec0e6fe1e5382d93cb28c97d24c7b0a0387c8eejsh * On a UMTS network, returns the primary scrambling code of the serving 642ec0e6fe1e5382d93cb28c97d24c7b0a0387c8eejsh * cell. 652ec0e6fe1e5382d93cb28c97d24c7b0a0387c8eejsh * 6605a5a88a171721705685d1ae3dcfe82780907210jsh * @return primary scrambling code for UMTS, -1 if unknown or GSM 6705a5a88a171721705685d1ae3dcfe82780907210jsh */ 6805a5a88a171721705685d1ae3dcfe82780907210jsh public int getPsc() { 6905a5a88a171721705685d1ae3dcfe82780907210jsh return mPsc; 7005a5a88a171721705685d1ae3dcfe82780907210jsh } 7105a5a88a171721705685d1ae3dcfe82780907210jsh 7205a5a88a171721705685d1ae3dcfe82780907210jsh /** 739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Invalidate this object. The location area code and the cell id are set to -1. 749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setStateInvalid() { 769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mLac = -1; 779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mCid = -1; 7805a5a88a171721705685d1ae3dcfe82780907210jsh mPsc = -1; 799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Set the location area code and the cell id. 839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setLacAndCid(int lac, int cid) { 859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mLac = lac; 869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mCid = cid; 879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8905a5a88a171721705685d1ae3dcfe82780907210jsh /** 9005a5a88a171721705685d1ae3dcfe82780907210jsh * Set the primary scrambling code. 9105a5a88a171721705685d1ae3dcfe82780907210jsh * @hide 9205a5a88a171721705685d1ae3dcfe82780907210jsh */ 9305a5a88a171721705685d1ae3dcfe82780907210jsh public void setPsc(int psc) { 9405a5a88a171721705685d1ae3dcfe82780907210jsh mPsc = psc; 9505a5a88a171721705685d1ae3dcfe82780907210jsh } 9605a5a88a171721705685d1ae3dcfe82780907210jsh 979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int hashCode() { 999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mLac ^ mCid; 1009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 1039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean equals(Object o) { 1049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project GsmCellLocation s; 10504e71b3db84fd5f7fc4eefb49a33154ea91ec9fcWink Saville 1069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 1079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project s = (GsmCellLocation)o; 1089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (ClassCastException ex) { 1099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 1109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (o == null) { 1139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 1149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11605a5a88a171721705685d1ae3dcfe82780907210jsh return equalsHandlesNulls(mLac, s.mLac) && equalsHandlesNulls(mCid, s.mCid) 11705a5a88a171721705685d1ae3dcfe82780907210jsh && equalsHandlesNulls(mPsc, s.mPsc); 1189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 1219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public String toString() { 12205a5a88a171721705685d1ae3dcfe82780907210jsh return "["+ mLac + "," + mCid + "," + mPsc + "]"; 1239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12404e71b3db84fd5f7fc4eefb49a33154ea91ec9fcWink Saville 1259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Test whether two objects hold the same data values or both are null 1279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param a first obj 1299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param b second obj 1309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if two objects equal or both are null 1319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static boolean equalsHandlesNulls(Object a, Object b) { 1339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return (a == null) ? (b == null) : a.equals (b); 1349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Set intent notifier Bundle based on service state 1389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param m intent notifier Bundle 1409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void fillInNotifierBundle(Bundle m) { 1429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project m.putInt("lac", mLac); 1439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project m.putInt("cid", mCid); 14405a5a88a171721705685d1ae3dcfe82780907210jsh m.putInt("psc", mPsc); 1459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14641a46718b3deec95661e149b3acea2a9e54016beJohn Wang 14741a46718b3deec95661e149b3acea2a9e54016beJohn Wang /** 14841a46718b3deec95661e149b3acea2a9e54016beJohn Wang * @hide 14941a46718b3deec95661e149b3acea2a9e54016beJohn Wang */ 15041a46718b3deec95661e149b3acea2a9e54016beJohn Wang public boolean isEmpty() { 15105a5a88a171721705685d1ae3dcfe82780907210jsh return (mLac == -1 && mCid == -1 && mPsc == -1); 15241a46718b3deec95661e149b3acea2a9e54016beJohn Wang } 1539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project} 154