From 90bc8e30ad3b0c211ef6e4a2e54cfadd28df1b2d Mon Sep 17 00:00:00 2001 From: Nathan Harold Date: Thu, 10 Nov 2016 09:15:44 -0800 Subject: [PATCH] Expose GSM Timing Advance, Update LTE TA docstring -Expose the GSM timing advance -Add a spec reference to the LTE Timing Advance Bug: 28910982 Test: None Change-Id: I7573dbb1316a2ab52051072ebad2532601f4299c --- api/current.txt | 1 + api/system-current.txt | 1 + api/test-current.txt | 1 + .../java/android/telephony/CellSignalStrengthGsm.java | 10 ++++++++++ .../java/android/telephony/CellSignalStrengthLte.java | 6 ++++-- 5 files changed, 17 insertions(+), 2 deletions(-) diff --git a/api/current.txt b/api/current.txt index 9cfbbc7d4ef3f..bbbca7f88c874 100644 --- a/api/current.txt +++ b/api/current.txt @@ -36855,6 +36855,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 CREATOR; diff --git a/api/system-current.txt b/api/system-current.txt index fab5e00919234..798c420a41d2e 100644 --- a/api/system-current.txt +++ b/api/system-current.txt @@ -39790,6 +39790,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 CREATOR; diff --git a/api/test-current.txt b/api/test-current.txt index 7a58e1e17177a..2609e52331d03 100644 --- a/api/test-current.txt +++ b/api/test-current.txt @@ -36932,6 +36932,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 CREATOR; diff --git a/telephony/java/android/telephony/CellSignalStrengthGsm.java b/telephony/java/android/telephony/CellSignalStrengthGsm.java index addf7ef025aaa..4137853e79aa8 100644 --- a/telephony/java/android/telephony/CellSignalStrengthGsm.java +++ b/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 */ diff --git a/telephony/java/android/telephony/CellSignalStrengthLte.java b/telephony/java/android/telephony/CellSignalStrengthLte.java index 3c0a8d6f8a38d..bc8c85c83fc26 100644 --- a/telephony/java/android/telephony/CellSignalStrengthLte.java +++ b/telephony/java/android/telephony/CellSignalStrengthLte.java @@ -206,8 +206,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;