1b208a24cf521401912cfce16fce550a995cf1250Wink Saville/* 2b208a24cf521401912cfce16fce550a995cf1250Wink Saville * Copyright (C) 2012 The Android Open Source Project 3b208a24cf521401912cfce16fce550a995cf1250Wink Saville * 4b208a24cf521401912cfce16fce550a995cf1250Wink Saville * Licensed under the Apache License, Version 2.0 (the "License"); 5b208a24cf521401912cfce16fce550a995cf1250Wink Saville * you may not use this file except in compliance with the License. 6b208a24cf521401912cfce16fce550a995cf1250Wink Saville * You may obtain a copy of the License at 7b208a24cf521401912cfce16fce550a995cf1250Wink Saville * 8b208a24cf521401912cfce16fce550a995cf1250Wink Saville * http://www.apache.org/licenses/LICENSE-2.0 9b208a24cf521401912cfce16fce550a995cf1250Wink Saville * 10b208a24cf521401912cfce16fce550a995cf1250Wink Saville * Unless required by applicable law or agreed to in writing, software 11b208a24cf521401912cfce16fce550a995cf1250Wink Saville * distributed under the License is distributed on an "AS IS" BASIS, 12b208a24cf521401912cfce16fce550a995cf1250Wink Saville * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13b208a24cf521401912cfce16fce550a995cf1250Wink Saville * See the License for the specific language governing permissions and 14b208a24cf521401912cfce16fce550a995cf1250Wink Saville * limitations under the License. 15b208a24cf521401912cfce16fce550a995cf1250Wink Saville */ 16b208a24cf521401912cfce16fce550a995cf1250Wink Saville 17b208a24cf521401912cfce16fce550a995cf1250Wink Savillepackage android.telephony; 18b208a24cf521401912cfce16fce550a995cf1250Wink Saville 19b208a24cf521401912cfce16fce550a995cf1250Wink Savilleimport android.os.Parcel; 20b208a24cf521401912cfce16fce550a995cf1250Wink Savilleimport android.os.Parcelable; 21599a90c2a02645a5f2d189b9065b863397a4076eWink Savilleimport android.telephony.Rlog; 22b208a24cf521401912cfce16fce550a995cf1250Wink Saville 23017e7f90eea67b0ecd002d1ab193f60238ad0555Nathan Haroldimport java.util.Objects; 24017e7f90eea67b0ecd002d1ab193f60238ad0555Nathan Harold 25b208a24cf521401912cfce16fce550a995cf1250Wink Saville/** 26e3a9cbc052db7f00a96cc7b9580097d67538f360Wink Saville * GSM signal strength related information. 27b208a24cf521401912cfce16fce550a995cf1250Wink Saville */ 28c6e4917adda19beb780386bcc26b652748b8ab13Wink Savillepublic final class CellSignalStrengthGsm extends CellSignalStrength implements Parcelable { 29b208a24cf521401912cfce16fce550a995cf1250Wink Saville 30b208a24cf521401912cfce16fce550a995cf1250Wink Saville private static final String LOG_TAG = "CellSignalStrengthGsm"; 31b208a24cf521401912cfce16fce550a995cf1250Wink Saville private static final boolean DBG = false; 32b208a24cf521401912cfce16fce550a995cf1250Wink Saville 33b208a24cf521401912cfce16fce550a995cf1250Wink Saville private static final int GSM_SIGNAL_STRENGTH_GREAT = 12; 34b208a24cf521401912cfce16fce550a995cf1250Wink Saville private static final int GSM_SIGNAL_STRENGTH_GOOD = 8; 35e3a9cbc052db7f00a96cc7b9580097d67538f360Wink Saville private static final int GSM_SIGNAL_STRENGTH_MODERATE = 5; 36b208a24cf521401912cfce16fce550a995cf1250Wink Saville 379d729c5304508b355345e5490d69f9509bb1cb4dNathan Harold private int mSignalStrength; // in ASU; Valid values are (0-31, 99) as defined in TS 27.007 8.5 38b208a24cf521401912cfce16fce550a995cf1250Wink Saville private int mBitErrorRate; // bit error rate (0-7, 99) as defined in TS 27.007 8.5 399d729c5304508b355345e5490d69f9509bb1cb4dNathan Harold private int mTimingAdvance; // range from 0-219 or Integer.MAX_VALUE if unknown 40b208a24cf521401912cfce16fce550a995cf1250Wink Saville 419d729c5304508b355345e5490d69f9509bb1cb4dNathan Harold /** @hide */ 42b208a24cf521401912cfce16fce550a995cf1250Wink Saville public CellSignalStrengthGsm() { 43b208a24cf521401912cfce16fce550a995cf1250Wink Saville setDefaultValues(); 44b208a24cf521401912cfce16fce550a995cf1250Wink Saville } 45b208a24cf521401912cfce16fce550a995cf1250Wink Saville 469d729c5304508b355345e5490d69f9509bb1cb4dNathan Harold /** @hide */ 47b208a24cf521401912cfce16fce550a995cf1250Wink Saville public CellSignalStrengthGsm(int ss, int ber) { 489d729c5304508b355345e5490d69f9509bb1cb4dNathan Harold this(ss, ber, Integer.MAX_VALUE); 49b208a24cf521401912cfce16fce550a995cf1250Wink Saville } 50b208a24cf521401912cfce16fce550a995cf1250Wink Saville 519d729c5304508b355345e5490d69f9509bb1cb4dNathan Harold /** @hide */ 529d729c5304508b355345e5490d69f9509bb1cb4dNathan Harold public CellSignalStrengthGsm(int ss, int ber, int ta) { 53b208a24cf521401912cfce16fce550a995cf1250Wink Saville mSignalStrength = ss; 54b208a24cf521401912cfce16fce550a995cf1250Wink Saville mBitErrorRate = ber; 559d729c5304508b355345e5490d69f9509bb1cb4dNathan Harold mTimingAdvance = ta; 560c86efdbd93beba03f29bf4a771bd0917d3af46aSanket Padawe } 570c86efdbd93beba03f29bf4a771bd0917d3af46aSanket Padawe 589d729c5304508b355345e5490d69f9509bb1cb4dNathan Harold /** @hide */ 599d729c5304508b355345e5490d69f9509bb1cb4dNathan Harold public CellSignalStrengthGsm(CellSignalStrengthGsm s) { 609d729c5304508b355345e5490d69f9509bb1cb4dNathan Harold copyFrom(s); 61b208a24cf521401912cfce16fce550a995cf1250Wink Saville } 62b208a24cf521401912cfce16fce550a995cf1250Wink Saville 639d729c5304508b355345e5490d69f9509bb1cb4dNathan Harold /** @hide */ 64b208a24cf521401912cfce16fce550a995cf1250Wink Saville protected void copyFrom(CellSignalStrengthGsm s) { 65b208a24cf521401912cfce16fce550a995cf1250Wink Saville mSignalStrength = s.mSignalStrength; 66b208a24cf521401912cfce16fce550a995cf1250Wink Saville mBitErrorRate = s.mBitErrorRate; 670c86efdbd93beba03f29bf4a771bd0917d3af46aSanket Padawe mTimingAdvance = s.mTimingAdvance; 68b208a24cf521401912cfce16fce550a995cf1250Wink Saville } 69b208a24cf521401912cfce16fce550a995cf1250Wink Saville 709d729c5304508b355345e5490d69f9509bb1cb4dNathan Harold /** @hide */ 71b208a24cf521401912cfce16fce550a995cf1250Wink Saville @Override 72b208a24cf521401912cfce16fce550a995cf1250Wink Saville public CellSignalStrengthGsm copy() { 73b208a24cf521401912cfce16fce550a995cf1250Wink Saville return new CellSignalStrengthGsm(this); 74b208a24cf521401912cfce16fce550a995cf1250Wink Saville } 75b208a24cf521401912cfce16fce550a995cf1250Wink Saville 76b208a24cf521401912cfce16fce550a995cf1250Wink Saville /** @hide */ 77b208a24cf521401912cfce16fce550a995cf1250Wink Saville @Override 78b208a24cf521401912cfce16fce550a995cf1250Wink Saville public void setDefaultValues() { 79b208a24cf521401912cfce16fce550a995cf1250Wink Saville mSignalStrength = Integer.MAX_VALUE; 80b208a24cf521401912cfce16fce550a995cf1250Wink Saville mBitErrorRate = Integer.MAX_VALUE; 810c86efdbd93beba03f29bf4a771bd0917d3af46aSanket Padawe mTimingAdvance = Integer.MAX_VALUE; 82b208a24cf521401912cfce16fce550a995cf1250Wink Saville } 83b208a24cf521401912cfce16fce550a995cf1250Wink Saville 84b208a24cf521401912cfce16fce550a995cf1250Wink Saville /** 8582e6ee62b2be3c716c215e4ba72c8a12c58620fbWink Saville * Get signal level as an int from 0..4 86b208a24cf521401912cfce16fce550a995cf1250Wink Saville */ 87b208a24cf521401912cfce16fce550a995cf1250Wink Saville @Override 88b208a24cf521401912cfce16fce550a995cf1250Wink Saville public int getLevel() { 89b208a24cf521401912cfce16fce550a995cf1250Wink Saville int level; 90b208a24cf521401912cfce16fce550a995cf1250Wink Saville 91b208a24cf521401912cfce16fce550a995cf1250Wink Saville // ASU ranges from 0 to 31 - TS 27.007 Sec 8.5 92b208a24cf521401912cfce16fce550a995cf1250Wink Saville // asu = 0 (-113dB or less) is very weak 93b208a24cf521401912cfce16fce550a995cf1250Wink Saville // signal, its better to show 0 bars to the user in such cases. 94b208a24cf521401912cfce16fce550a995cf1250Wink Saville // asu = 99 is a special case, where the signal strength is unknown. 95b208a24cf521401912cfce16fce550a995cf1250Wink Saville int asu = mSignalStrength; 96b208a24cf521401912cfce16fce550a995cf1250Wink Saville if (asu <= 2 || asu == 99) level = SIGNAL_STRENGTH_NONE_OR_UNKNOWN; 97b208a24cf521401912cfce16fce550a995cf1250Wink Saville else if (asu >= GSM_SIGNAL_STRENGTH_GREAT) level = SIGNAL_STRENGTH_GREAT; 98b208a24cf521401912cfce16fce550a995cf1250Wink Saville else if (asu >= GSM_SIGNAL_STRENGTH_GOOD) level = SIGNAL_STRENGTH_GOOD; 99b208a24cf521401912cfce16fce550a995cf1250Wink Saville else if (asu >= GSM_SIGNAL_STRENGTH_MODERATE) level = SIGNAL_STRENGTH_MODERATE; 100b208a24cf521401912cfce16fce550a995cf1250Wink Saville else level = SIGNAL_STRENGTH_POOR; 101b208a24cf521401912cfce16fce550a995cf1250Wink Saville if (DBG) log("getLevel=" + level); 102b208a24cf521401912cfce16fce550a995cf1250Wink Saville return level; 103b208a24cf521401912cfce16fce550a995cf1250Wink Saville } 104b208a24cf521401912cfce16fce550a995cf1250Wink Saville 105b208a24cf521401912cfce16fce550a995cf1250Wink Saville /** 10690bc8e30ad3b0c211ef6e4a2e54cfadd28df1b2dNathan Harold * Get the GSM timing advance between 0..219 symbols (normally 0..63). 10790bc8e30ad3b0c211ef6e4a2e54cfadd28df1b2dNathan Harold * Integer.MAX_VALUE is reported when there is no RR connection. 10890bc8e30ad3b0c211ef6e4a2e54cfadd28df1b2dNathan Harold * Refer to 3GPP 45.010 Sec 5.8 10990bc8e30ad3b0c211ef6e4a2e54cfadd28df1b2dNathan Harold * @return the current GSM timing advance, if available. 11090bc8e30ad3b0c211ef6e4a2e54cfadd28df1b2dNathan Harold */ 11190bc8e30ad3b0c211ef6e4a2e54cfadd28df1b2dNathan Harold public int getTimingAdvance() { 11290bc8e30ad3b0c211ef6e4a2e54cfadd28df1b2dNathan Harold return mTimingAdvance; 11390bc8e30ad3b0c211ef6e4a2e54cfadd28df1b2dNathan Harold } 11490bc8e30ad3b0c211ef6e4a2e54cfadd28df1b2dNathan Harold 11590bc8e30ad3b0c211ef6e4a2e54cfadd28df1b2dNathan Harold /** 11682e6ee62b2be3c716c215e4ba72c8a12c58620fbWink Saville * Get the signal strength as dBm 117b208a24cf521401912cfce16fce550a995cf1250Wink Saville */ 118b208a24cf521401912cfce16fce550a995cf1250Wink Saville @Override 119b208a24cf521401912cfce16fce550a995cf1250Wink Saville public int getDbm() { 120b208a24cf521401912cfce16fce550a995cf1250Wink Saville int dBm; 121b208a24cf521401912cfce16fce550a995cf1250Wink Saville 122b208a24cf521401912cfce16fce550a995cf1250Wink Saville int level = mSignalStrength; 123b208a24cf521401912cfce16fce550a995cf1250Wink Saville int asu = (level == 99 ? Integer.MAX_VALUE : level); 124b208a24cf521401912cfce16fce550a995cf1250Wink Saville if (asu != Integer.MAX_VALUE) { 125b208a24cf521401912cfce16fce550a995cf1250Wink Saville dBm = -113 + (2 * asu); 126b208a24cf521401912cfce16fce550a995cf1250Wink Saville } else { 127b208a24cf521401912cfce16fce550a995cf1250Wink Saville dBm = Integer.MAX_VALUE; 128b208a24cf521401912cfce16fce550a995cf1250Wink Saville } 129b208a24cf521401912cfce16fce550a995cf1250Wink Saville if (DBG) log("getDbm=" + dBm); 130b208a24cf521401912cfce16fce550a995cf1250Wink Saville return dBm; 131b208a24cf521401912cfce16fce550a995cf1250Wink Saville } 132b208a24cf521401912cfce16fce550a995cf1250Wink Saville 133b208a24cf521401912cfce16fce550a995cf1250Wink Saville /** 134e3a9cbc052db7f00a96cc7b9580097d67538f360Wink Saville * Get the signal level as an asu value between 0..31, 99 is unknown 135b208a24cf521401912cfce16fce550a995cf1250Wink Saville * Asu is calculated based on 3GPP RSRP. Refer to 3GPP 27.007 (Ver 10.3.0) Sec 8.69 136b208a24cf521401912cfce16fce550a995cf1250Wink Saville */ 137b208a24cf521401912cfce16fce550a995cf1250Wink Saville @Override 138b208a24cf521401912cfce16fce550a995cf1250Wink Saville public int getAsuLevel() { 139b208a24cf521401912cfce16fce550a995cf1250Wink Saville // ASU ranges from 0 to 31 - TS 27.007 Sec 8.5 140b208a24cf521401912cfce16fce550a995cf1250Wink Saville // asu = 0 (-113dB or less) is very weak 141b208a24cf521401912cfce16fce550a995cf1250Wink Saville // signal, its better to show 0 bars to the user in such cases. 142b208a24cf521401912cfce16fce550a995cf1250Wink Saville // asu = 99 is a special case, where the signal strength is unknown. 143b208a24cf521401912cfce16fce550a995cf1250Wink Saville int level = mSignalStrength; 144b208a24cf521401912cfce16fce550a995cf1250Wink Saville if (DBG) log("getAsuLevel=" + level); 145b208a24cf521401912cfce16fce550a995cf1250Wink Saville return level; 146b208a24cf521401912cfce16fce550a995cf1250Wink Saville } 147b208a24cf521401912cfce16fce550a995cf1250Wink Saville 148b208a24cf521401912cfce16fce550a995cf1250Wink Saville @Override 149b208a24cf521401912cfce16fce550a995cf1250Wink Saville public int hashCode() { 150017e7f90eea67b0ecd002d1ab193f60238ad0555Nathan Harold return Objects.hash(mSignalStrength, mBitErrorRate, mTimingAdvance); 151b208a24cf521401912cfce16fce550a995cf1250Wink Saville } 152b208a24cf521401912cfce16fce550a995cf1250Wink Saville 153b208a24cf521401912cfce16fce550a995cf1250Wink Saville @Override 154b208a24cf521401912cfce16fce550a995cf1250Wink Saville public boolean equals (Object o) { 155b208a24cf521401912cfce16fce550a995cf1250Wink Saville CellSignalStrengthGsm s; 156b208a24cf521401912cfce16fce550a995cf1250Wink Saville 157b208a24cf521401912cfce16fce550a995cf1250Wink Saville try { 158b208a24cf521401912cfce16fce550a995cf1250Wink Saville s = (CellSignalStrengthGsm) o; 159b208a24cf521401912cfce16fce550a995cf1250Wink Saville } catch (ClassCastException ex) { 160b208a24cf521401912cfce16fce550a995cf1250Wink Saville return false; 161b208a24cf521401912cfce16fce550a995cf1250Wink Saville } 162b208a24cf521401912cfce16fce550a995cf1250Wink Saville 163b208a24cf521401912cfce16fce550a995cf1250Wink Saville if (o == null) { 164b208a24cf521401912cfce16fce550a995cf1250Wink Saville return false; 165b208a24cf521401912cfce16fce550a995cf1250Wink Saville } 166b208a24cf521401912cfce16fce550a995cf1250Wink Saville 1670c86efdbd93beba03f29bf4a771bd0917d3af46aSanket Padawe return mSignalStrength == s.mSignalStrength && mBitErrorRate == s.mBitErrorRate && 1680c86efdbd93beba03f29bf4a771bd0917d3af46aSanket Padawe s.mTimingAdvance == mTimingAdvance; 169b208a24cf521401912cfce16fce550a995cf1250Wink Saville } 170b208a24cf521401912cfce16fce550a995cf1250Wink Saville 171b208a24cf521401912cfce16fce550a995cf1250Wink Saville /** 172b208a24cf521401912cfce16fce550a995cf1250Wink Saville * @return string representation. 173b208a24cf521401912cfce16fce550a995cf1250Wink Saville */ 174b208a24cf521401912cfce16fce550a995cf1250Wink Saville @Override 175b208a24cf521401912cfce16fce550a995cf1250Wink Saville public String toString() { 176b208a24cf521401912cfce16fce550a995cf1250Wink Saville return "CellSignalStrengthGsm:" 177b208a24cf521401912cfce16fce550a995cf1250Wink Saville + " ss=" + mSignalStrength 1780c86efdbd93beba03f29bf4a771bd0917d3af46aSanket Padawe + " ber=" + mBitErrorRate 1790c86efdbd93beba03f29bf4a771bd0917d3af46aSanket Padawe + " mTa=" + mTimingAdvance; 180b208a24cf521401912cfce16fce550a995cf1250Wink Saville } 181b208a24cf521401912cfce16fce550a995cf1250Wink Saville 182b208a24cf521401912cfce16fce550a995cf1250Wink Saville /** Implement the Parcelable interface */ 183b208a24cf521401912cfce16fce550a995cf1250Wink Saville @Override 184b208a24cf521401912cfce16fce550a995cf1250Wink Saville public void writeToParcel(Parcel dest, int flags) { 185b208a24cf521401912cfce16fce550a995cf1250Wink Saville if (DBG) log("writeToParcel(Parcel, int): " + toString()); 186b208a24cf521401912cfce16fce550a995cf1250Wink Saville dest.writeInt(mSignalStrength); 187b208a24cf521401912cfce16fce550a995cf1250Wink Saville dest.writeInt(mBitErrorRate); 1880c86efdbd93beba03f29bf4a771bd0917d3af46aSanket Padawe dest.writeInt(mTimingAdvance); 189b208a24cf521401912cfce16fce550a995cf1250Wink Saville } 190b208a24cf521401912cfce16fce550a995cf1250Wink Saville 191b208a24cf521401912cfce16fce550a995cf1250Wink Saville /** 192b208a24cf521401912cfce16fce550a995cf1250Wink Saville * Construct a SignalStrength object from the given parcel 193b208a24cf521401912cfce16fce550a995cf1250Wink Saville * where the token is already been processed. 194b208a24cf521401912cfce16fce550a995cf1250Wink Saville */ 195b208a24cf521401912cfce16fce550a995cf1250Wink Saville private CellSignalStrengthGsm(Parcel in) { 196b208a24cf521401912cfce16fce550a995cf1250Wink Saville mSignalStrength = in.readInt(); 197b208a24cf521401912cfce16fce550a995cf1250Wink Saville mBitErrorRate = in.readInt(); 1980c86efdbd93beba03f29bf4a771bd0917d3af46aSanket Padawe mTimingAdvance = in.readInt(); 199b208a24cf521401912cfce16fce550a995cf1250Wink Saville if (DBG) log("CellSignalStrengthGsm(Parcel): " + toString()); 200b208a24cf521401912cfce16fce550a995cf1250Wink Saville } 201b208a24cf521401912cfce16fce550a995cf1250Wink Saville 202b208a24cf521401912cfce16fce550a995cf1250Wink Saville /** Implement the Parcelable interface */ 203b208a24cf521401912cfce16fce550a995cf1250Wink Saville @Override 204b208a24cf521401912cfce16fce550a995cf1250Wink Saville public int describeContents() { 205b208a24cf521401912cfce16fce550a995cf1250Wink Saville return 0; 206b208a24cf521401912cfce16fce550a995cf1250Wink Saville } 207b208a24cf521401912cfce16fce550a995cf1250Wink Saville 208b208a24cf521401912cfce16fce550a995cf1250Wink Saville /** Implement the Parcelable interface */ 209b208a24cf521401912cfce16fce550a995cf1250Wink Saville @SuppressWarnings("hiding") 210b208a24cf521401912cfce16fce550a995cf1250Wink Saville public static final Parcelable.Creator<CellSignalStrengthGsm> CREATOR = 211b208a24cf521401912cfce16fce550a995cf1250Wink Saville new Parcelable.Creator<CellSignalStrengthGsm>() { 212b208a24cf521401912cfce16fce550a995cf1250Wink Saville @Override 213b208a24cf521401912cfce16fce550a995cf1250Wink Saville public CellSignalStrengthGsm createFromParcel(Parcel in) { 214c6e4917adda19beb780386bcc26b652748b8ab13Wink Saville return new CellSignalStrengthGsm(in); 215b208a24cf521401912cfce16fce550a995cf1250Wink Saville } 216b208a24cf521401912cfce16fce550a995cf1250Wink Saville 217b208a24cf521401912cfce16fce550a995cf1250Wink Saville @Override 218b208a24cf521401912cfce16fce550a995cf1250Wink Saville public CellSignalStrengthGsm[] newArray(int size) { 219b208a24cf521401912cfce16fce550a995cf1250Wink Saville return new CellSignalStrengthGsm[size]; 220b208a24cf521401912cfce16fce550a995cf1250Wink Saville } 221b208a24cf521401912cfce16fce550a995cf1250Wink Saville }; 222b208a24cf521401912cfce16fce550a995cf1250Wink Saville 223b208a24cf521401912cfce16fce550a995cf1250Wink Saville /** 224b208a24cf521401912cfce16fce550a995cf1250Wink Saville * log 225b208a24cf521401912cfce16fce550a995cf1250Wink Saville */ 226b208a24cf521401912cfce16fce550a995cf1250Wink Saville private static void log(String s) { 227599a90c2a02645a5f2d189b9065b863397a4076eWink Saville Rlog.w(LOG_TAG, s); 228b208a24cf521401912cfce16fce550a995cf1250Wink Saville } 229b208a24cf521401912cfce16fce550a995cf1250Wink Saville} 230