From c0fe2bac0152690569909f32cdaf56d4f2643875 Mon Sep 17 00:00:00 2001 From: Yu-Han Yang Date: Fri, 28 Feb 2020 11:39:47 -0800 Subject: Add comments to messageId, subMessageId and data Bug: 147768625 Test: doc only and builds Change-Id: I4a75d0cb015c47caaeaf93acffbca34d9eaea523 --- .../android/location/GnssNavigationMessage.java | 22 ++++++++++++++++++++++ 1 file changed, 22 insertions(+) (limited to 'location') diff --git a/location/java/android/location/GnssNavigationMessage.java b/location/java/android/location/GnssNavigationMessage.java index ca0bfb1added..27d363783a5a 100644 --- a/location/java/android/location/GnssNavigationMessage.java +++ b/location/java/android/location/GnssNavigationMessage.java @@ -272,6 +272,14 @@ public final class GnssNavigationMessage implements Parcelable { * range of 1-12 *
  • For Galileo I/NAV nominal frame structure, this refers to the subframe number in the * range of 1-24
    • + *
  • For SBAS and Beidou CNAV2, this is unused and can be set to -1.
    • + *
  • For QZSS L1 C/A subframe 4 and 5, this value corresponds to the 'frame id' of the + * navigation message, in the range of 1-25 (Subframe 1, 2, 3 does not contain a 'frame id' and + * this value can be set to -1.)
    • + *
  • For Beidou CNAV1 this refers to the page type number in the range of 1-63.
    • + *
  • For IRNSS L5 C/A subframe 3 and 4, this value corresponds to the Message Id of the + * navigation message, in the range of 1-63. (Subframe 1 and 2 does not contain a message type + * id and this value can be set to -1.)
    • * */ public int getMessageId() { @@ -299,6 +307,13 @@ public final class GnssNavigationMessage implements Parcelable { *
  • For Galileo in particular, the type information embedded within the data bits may be even * more useful in interpretation, than the nominal page and word types provided in this * field.
    • + *
  • For SBAS, the submessage id corresponds to the message type, in the range 1-63.
    • + *
  • For Beidou CNAV1, the submessage id corresponds to the subframe number of the + * navigation message, in the range of 1-3.
    • + *
  • For Beidou CNAV2, the submessage id corresponds to the message type, in the range + * 1-63.
    • + *
  • For IRNSS L5 C/A, the submessage id corresponds to the subframe number of the + * navigation message, in the range of 1-4.
    • * */ public int getSubmessageId() { @@ -333,6 +348,13 @@ public final class GnssNavigationMessage implements Parcelable { *
  • For Galileo I/NAV, each page contains 2 page parts, even and odd, with a total of 2x114 = * 228 bits, (sync & tail excluded) that should be fit into 29 bytes, with MSB first (skip * B229-B232).
    • + *
  • For SBAS, each block consists of 250 data bits, that should be fit into 32 bytes. MSB + * first (skip B251-B256).
    • + *
  • For Beidou CNAV1, subframe #1 consists of 14 data bits, that should be fit into 2 + * bytes. MSB first (skip B15-B16). subframe #2 consists of 600 bits that should be fit into + * 75 bytes. subframe #3 consists of 264 data bits that should be fit into 33 bytes.
    • + *
  • For Beidou CNAV2, each subframe consists of 288 data bits, that should be fit into 36 + * bytes.
    • * */ @NonNull -- cgit v1.2.3