Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit 881f5433 authored by TreeHugger Robot's avatar TreeHugger Robot Committed by Automerger Merge Worker
Browse files

Merge "Update javadoc for carrierFrequency and AGC" into sc-dev am: 5611e4d8 

Original change: https://googleplex-android-review.googlesource.com/c/platform/frameworks/base/+/13562511

MUST ONLY BE SUBMITTED BY AUTOMERGER

Change-Id: Icf960e637b28521b215b034f52399932824c9275
parents b3c88901 5611e4d8

location/java/android/location/GnssMeasurement.java

+3 −8
Original line number Diff line number Diff line
@@ -1096,13 +1096,7 @@ public final class GnssMeasurement implements Parcelable { 
     * Gets the carrier frequency of the tracked signal.

     *

     * <p>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.

     *

     * <p> 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.

     * L5 = 1176.45 MHz, varying GLO channels, etc.

     *

     * <p>The value is only available if {@link #hasCarrierFrequencyHz()} is {@code true}.

     *
@@ -1382,7 +1376,8 @@ public final class GnssMeasurement implements Parcelable { 
     * <p> AGC acts as a variable gain amplifier adjusting the power of the incoming signal. The AGC

     * level may be used to indicate potential interference. 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.

     * signal, this value will go more negative. This value must be consistent given the same level

     * of the incoming signal power.

     *

     * <p> 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

location/java/android/location/GnssStatus.java

+1 −6
Original line number Diff line number Diff line
@@ -284,12 +284,7 @@ public final class GnssStatus implements Parcelable { 
     * Gets the carrier frequency of the signal tracked.

     *

     * <p>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.

     * MHz, L5 = 1176.45 MHz, varying GLO channels, etc.

     *

     * <p>The value is only available if {@link #hasCarrierFrequencyHz(int satelliteIndex)} is

     * {@code true}.