diff --git a/location/java/android/location/GnssMeasurement.java b/location/java/android/location/GnssMeasurement.java index ce23176dd7dbc..aac9727614eac 100644 --- a/location/java/android/location/GnssMeasurement.java +++ b/location/java/android/location/GnssMeasurement.java @@ -660,8 +660,14 @@ public final class GnssMeasurement implements Parcelable { /** * Gets the carrier frequency of the tracked signal. * - *

For example it can be the GPS L1 = 1.57542e9 Hz, or L2, L5, varying GLO channels, etc. If - * the field is not set, it is the primary common use frequency, e.g. L1 for GPS. + *

For example it can be the GPS central frequency for L1 = 1575.45 MHz, or L2 = 1227.60 MHz, + * L5 = 1176.45 MHz, varying GLO channels, etc. If the field is not set, it is the primary + * common use central frequency, e.g. L1 = 1575.45 MHz for GPS. + * + * For an L1, L5 receiver tracking a satellite on L1 and L5 at the same time, two raw + * measurement objects will be reported for this same satellite, in one of the measurement + * objects, all the values related to L1 will be filled, and in the other all of the values + * related to L5 will be filled. * *

The value is only available if {@link #hasCarrierFrequencyHz()} is {@code true}. */ @@ -882,7 +888,7 @@ public final class GnssMeasurement implements Parcelable { } /** - * Returns {@code true} if {@link #getAutomaticGainControlLevelInDb()} is available, + * Returns {@code true} if {@link #getAutomaticGainControlLevelInDb()} is available, * {@code false} otherwise. */ public boolean hasAutomaticGainControlLevelInDb() { @@ -892,11 +898,12 @@ public final class GnssMeasurement implements Parcelable { /** * Gets the Automatic Gain Control level in dB. * - *

AGC acts as a variable gain amplifier adjusting the power of the incoming signal to - * minimize the quantization losses. The AGC level may be used to indicate potential - * interference. When AGC is at a nominal level, this value must be set as 0. Higher gain - * (and/or lower input power) shall be output as a positive number. Hence in cases of strong - * jamming, in the band of this signal, this value will go more negative. + *

AGC acts as a variable gain amplifier adjusting the power of the incoming signal. The AGC + * level may be used to indicate potential interference. When AGC is at a nominal level, this + * value must be set as 0. Higher gain (and/or lower input power) shall be output as a positive + * number. Hence in cases of strong jamming, in the band of this signal, this value will go more + * negative. + * *

Note: Different hardware designs (e.g. antenna, pre-amplification, or other RF HW * components) may also affect the typical output of of this value on any given hardware design * in an open sky test - the important aspect of this output is that changes in this value are diff --git a/location/java/android/location/GnssStatus.java b/location/java/android/location/GnssStatus.java index 78dbc71268acc..e90a174eb9be3 100644 --- a/location/java/android/location/GnssStatus.java +++ b/location/java/android/location/GnssStatus.java @@ -231,8 +231,13 @@ public final class GnssStatus { /** * Gets the carrier frequency of the signal tracked. * - * For example it can be the GPS L1 = 1.57542e9 Hz, or L2, L5, varying GLO channels, etc. If - * the field is not set, it is the primary common use frequency, e.g. L1 for GPS. + *

For example it can be the GPS central frequency for L1 = 1575.45 MHz, or L2 = 1227.60 MHz, + * L5 = 1176.45 MHz, varying GLO channels, etc. If the field is not set, it is the primary + * common use central frequency, e.g. L1 = 1575.45 MHz for GPS. + * + * For an L1, L5 receiver tracking a satellite on L1 and L5 at the same time, two measurements + * will be reported for this same satellite, in one all the values related to L1 will be filled, + * and in the other all of the values related to L5 will be filled. * *

The value is only available if {@link #hasCarrierFrequency(int satIndex)} is {@code true}. */