Merge "Expose GSM Timing Advance, Update LTE TA docstring" am: 4134ccb214 am: 8fabfd639e am: 64a8a387a4

am: 729a5ae511

Change-Id: Id046a2fbf946f7b42dd56763a8b403cbde802d7e

api/current.txt

@@ -37427,6 +37427,7 @@ package android.telephony {
     method public int getAsuLevel();
     method public int getDbm();
     method public int getLevel();
+    method public int getTimingAdvance();
     method public int hashCode();
     method public void writeToParcel(android.os.Parcel, int);
     field public static final android.os.Parcelable.Creator<android.telephony.CellSignalStrengthGsm> CREATOR;

api/system-current.txt

@@ -40509,6 +40509,7 @@ package android.telephony {
     method public int getAsuLevel();
     method public int getDbm();
     method public int getLevel();
+    method public int getTimingAdvance();
     method public int hashCode();
     method public void writeToParcel(android.os.Parcel, int);
     field public static final android.os.Parcelable.Creator<android.telephony.CellSignalStrengthGsm> CREATOR;

api/test-current.txt

@@ -37523,6 +37523,7 @@ package android.telephony {
     method public int getAsuLevel();
     method public int getDbm();
     method public int getLevel();
+    method public int getTimingAdvance();
     method public int hashCode();
     method public void writeToParcel(android.os.Parcel, int);
     field public static final android.os.Parcelable.Creator<android.telephony.CellSignalStrengthGsm> CREATOR;

telephony/java/android/telephony/CellSignalStrengthGsm.java

@@ -140,6 +140,16 @@ public final class CellSignalStrengthGsm extends CellSignalStrength implements P
         return level;
     }
 
+    /**
+     * Get the GSM timing advance between 0..219 symbols (normally 0..63).
+     * Integer.MAX_VALUE is reported when there is no RR connection.
+     * Refer to 3GPP 45.010 Sec 5.8
+     * @return the current GSM timing advance, if available.
+     */
+    public int getTimingAdvance() {
+        return mTimingAdvance;
+    }
+
     /**
      * Get the signal strength as dBm
      */

telephony/java/android/telephony/CellSignalStrengthLte.java

@@ -220,8 +220,10 @@ public final class CellSignalStrengthLte extends CellSignalStrength implements P
     }
 
     /**
-     * Get the timing advance value for LTE.
-     * See 3GPP xxxx
+     * Get the timing advance value for LTE, as a value between 0..63.
+     * Integer.MAX_VALUE is reported when there is no active RRC
+     * connection. Refer to 3GPP 36.213 Sec 4.2.3
+     * @return the LTE timing advance, if available.
      */
     public int getTimingAdvance() {
         return mTimingAdvance;