From 6c109ef89e241845ca155f202379078901dfde83 Mon Sep 17 00:00:00 2001 From: Yu-Han Yang Date: Tue, 22 Nov 2022 21:32:06 +0000 Subject: Clarify javadoc of Full Tracking Bug: 257549183 Test: doc update only Change-Id: Ia66235c20a527c4355b1ce9fae7c157dd90d2c84 --- location/java/android/location/GnssMeasurementRequest.java | 7 ++++--- location/java/android/location/GnssMeasurementsEvent.java | 7 ++++--- 2 files changed, 8 insertions(+), 6 deletions(-) (limited to 'location/java') diff --git a/location/java/android/location/GnssMeasurementRequest.java b/location/java/android/location/GnssMeasurementRequest.java index 5cf10678622e..3813e97e04fc 100644 --- a/location/java/android/location/GnssMeasurementRequest.java +++ b/location/java/android/location/GnssMeasurementRequest.java @@ -76,9 +76,10 @@ public final class GnssMeasurementRequest implements Parcelable { *

If true, GNSS chipset switches off duty cycling. In such a mode, no clock * discontinuities are expected, and when supported, carrier phase should be continuous in * good signal conditions. All non-blocklisted, healthy constellations, satellites and - * frequency bands that the chipset supports must be reported in this mode. The GNSS chipset - * will consume more power in full tracking mode than in duty cycling mode. If false, GNSS - * chipset optimizes power via duty cycling, constellations and frequency limits, etc. + * frequency bands that are meaningful to positioning accuracy must be tracked and reported in + * this mode. The GNSS chipset will consume more power in full tracking mode than in duty + * cycling mode. If false, GNSS chipset optimizes power via duty cycling, constellations and + * frequency limits, etc. * *

Full GNSS tracking mode affects GnssMeasurement and other GNSS functionalities * including GNSS location. diff --git a/location/java/android/location/GnssMeasurementsEvent.java b/location/java/android/location/GnssMeasurementsEvent.java index a8b0dc235b43..1e3574bebbf5 100644 --- a/location/java/android/location/GnssMeasurementsEvent.java +++ b/location/java/android/location/GnssMeasurementsEvent.java @@ -163,8 +163,8 @@ public final class GnssMeasurementsEvent implements Parcelable { * True indicates that this event was produced while the chipset was in full tracking mode, ie, * the GNSS chipset switched off duty cycling. In this mode, no clock discontinuities are * expected and, when supported, carrier phase should be continuous in good signal conditions. - * All non-blocklisted, healthy constellations, satellites and frequency bands must be tracked - * and reported in this mode. + * All non-blocklisted, healthy constellations, satellites and frequency bands that are + * meaningful to positioning accuracy must be tracked and reported in this mode. * * False indicates that the GNSS chipset may optimize power via duty cycling, constellations and * frequency limits, etc. @@ -307,7 +307,8 @@ public final class GnssMeasurementsEvent implements Parcelable { * mode, ie, the GNSS chipset switched off duty cycling. In this mode, no clock * discontinuities are expected and, when supported, carrier phase should be continuous in * good signal conditions. All non-blocklisted, healthy constellations, satellites and - * frequency bands must be tracked and reported in this mode. + * frequency bands that are meaningful to positioning accuracy must be tracked and reported + * in this mode. * * False indicates that the GNSS chipset may optimize power via duty cycling, constellations * and frequency limits, etc. -- cgit v1.2.3-59-g8ed1b