Package org.openstreetmap.josm.io.nmea

Enum Sentence

java.lang.Object

java.lang.Enum<Sentence>

org.openstreetmap.josm.io.nmea.Sentence

All Implemented Interfaces:

java.io.Serializable, java.lang.Comparable<Sentence>

public enum Sentence
extends java.lang.Enum<Sentence>

An NMEA sentence consists of a start delimiter, followed by a comma-separated sequence of fields, followed by the character * (ASCII 42), the checksum and an end-of-line marker. The start delimiter is normally $ (ASCII 36).

Most GPS sensors emit only RMC, GGA, GSA, GSV, GLL, VTG, and (rarely) ZDA. Newer ones conforming to NMEA 3.x may emit GBS as well. Other NMEA sentences are usually only emitted by high-end maritime navigation systems.

See NMEA Encoding Conventions

Since:

12421

Enum Constant Summary

Enum Constants

Enum Constant	Description
GBS	GBS - GPS Satellite Fault Detection
GGA	GGA - Global Positioning System Fix Data
GLL	GLL - Geographic Position - Latitude/Longitude
GSA	GSA - GPS DOP and active satellites
GST	GST - GPS Pseudorange Noise Statistics
GSV	GSV - Satellites in view
RMC	RMC - Recommended Minimum Navigation Information
VTG	VTG - Track made good and Ground speed
ZDA	ZDA - Time & Date - UTC, day, month, year and local time zone

Constructor Summary

Constructors

Modifier	Constructor	Description
private	Sentence()

Method Summary

Modifier and Type	Method	Description
static Sentence	valueOf(java.lang.String name)	Returns the enum constant of this type with the specified name.
static Sentence[]	values()	Returns an array containing the constants of this enum type, in the order they are declared.

Methods inherited from class java.lang.Enum

clone, compareTo, equals, finalize, getDeclaringClass, hashCode, name, ordinal, toString, valueOf

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Enum Constant Detail

GBS

public static final Sentence GBS

GBS - GPS Satellite Fault Detection

            1      2   3   4   5   6   7   8   9
            |      |   |   |   |   |   |   |   |
 $--GBS,hhmmss.ss,x.x,x.x,x.x,x.x,x.x,x.x,x.x*hh
 

Field Number:

1. UTC time of the GGA or GNS fix associated with this sentence
2. Expected error in latitude (meters)
3. Expected error in longitude (meters)
4. Expected error in altitude (meters)
5. PRN of most likely failed satellite
6. Probability of missed detection for most likely failed satellite
7. Estimate of bias in meters on most likely failed satellite
8. Standard deviation of bias estimate
9. Checksum

See GBS

GGA

public static final Sentence GGA

GGA - Global Positioning System Fix Data

                                                      11
        1         2       3 4        5 6 7  8   9  10 |  12 13  14   15
        |         |       | |        | | |  |   |   | |   | |   |    |
 $--GGA,hhmmss.ss,llll.ll,a,yyyyy.yy,a,x,xx,x.x,x.x,M,x.x,M,x.x,xxxx*hh
 

Field Number:

1. Universal Time Coordinated (UTC)
2. Latitude
3. N or S (North or South)
4. Longitude
5. E or W (East or West)
6. GPS Quality Indicator,
   • 0 - fix not available,
   • 1 - GPS fix,
   • 2 - Differential GPS fix (values above 2 are 2.3 features)
   • 3 = PPS fix
   • 4 = Real Time Kinematic
   • 5 = Float RTK
   • 6 = estimated (dead reckoning)
   • 7 = Manual input mode
   • 8 = Simulation mode
7. Number of satellites in view, 00 - 12
8. Horizontal Dilution of precision (meters)
9. Antenna Altitude above/below mean-sea-level (geoid) (in meters)
10. Units of antenna altitude, meters
11. Geoidal separation, the difference between the WGS-84 earth ellipsoid and mean-sea-level (geoid), "-" means mean-sea-level below ellipsoid
12. Units of geoidal separation, meters
13. Age of differential GPS data, time in seconds since last SC104 type 1 or 9 update, null field when DGPS is not used
14. Differential reference station ID, 0000-1023
15. Checksum

See GGA

GSA

public static final Sentence GSA

GSA - GPS DOP and active satellites

        1 2 3                        14 15  16  17  18
        | | |                         |  |   |   |   |
 $--GSA,a,a,x,x,x,x,x,x,x,x,x,x,x,x,x,x,x.x,x.x,x.x*hh
 

Field Number:

1. Selection mode: M=Manual, forced to operate in 2D or 3D, A=Automatic, 3D/2D
2. Mode (1 = no fix, 2 = 2D fix, 3 = 3D fix)
3. ID of 1st satellite used for fix
4. ID of 2nd satellite used for fix
5. ID of 3rd satellite used for fix
6. ID of 4th satellite used for fix
7. ID of 5th satellite used for fix
8. ID of 6th satellite used for fix
9. ID of 7th satellite used for fix
10. ID of 8th satellite used for fix
11. ID of 9th satellite used for fix
12. ID of 10th satellite used for fix
13. ID of 11th satellite used for fix
14. ID of 12th satellite used for fix
15. PDOP
16. HDOP
17. VDOP
18. Checksum

See GSA

GSV

public static final Sentence GSV

GSV - Satellites in view

        1 2 3 4 5 6 7     n
        | | | | | | |     |
 $--GSV,x,x,x,x,x,x,x,...*hh
 

Field Number:

1. total number of GSV messages to be transmitted in this group
2. 1-origin number of this GSV message within current group
3. total number of satellites in view (leading zeros sent)
4. satellite PRN number (leading zeros sent)
5. elevation in degrees (00-90) (leading zeros sent)
6. azimuth in degrees to true north (000-359) (leading zeros sent)
7. SNR in dB (00-99) (leading zeros sent) more satellite info quadruples like 4-7 n) checksum

See GSV

GLL

public static final Sentence GLL

GLL - Geographic Position - Latitude/Longitude

        1       2 3        4 5         6 7   8
        |       | |        | |         | |   |
 $--GLL,llll.ll,a,yyyyy.yy,a,hhmmss.ss,a,m,*hh
 

Field Number:

1. Latitude
2. N or S (North or South)
3. Longitude
4. E or W (East or West)
5. Universal Time Coordinated (UTC)
6. Status A - Data Valid, V - Data Invalid
7. FAA mode indicator (NMEA 2.3 and later)
8. Checksum

See GLL

GST

public static final Sentence GST

GST - GPS Pseudorange Noise Statistics

              1    2 3 4 5 6 7 8   9
              |    | | | | | | |   |
 $ --GST,hhmmss.ss,x,x,x,x,x,x,x*hh
 

Field Number:

1. UTC time of associated GGA fix
2. Total RMS standard deviation of ranges inputs to the navigation solution
3. Standard deviation (meters) of semi-major axis of error ellipse
4. Standard deviation (meters) of semi-minor axis of error ellipse
5. Orientation of semi-major axis of error ellipse (true north degrees)
6. Standard deviation (meters) of latitude error
7. Standard deviation (meters) of longitude error
8. Standard deviation (meters) of altitude error
9. Checksum

See GST

RMC

public static final Sentence RMC

RMC - Recommended Minimum Navigation Information

                                                          12
        1         2 3       4 5        6  7   8   9    10 11|  13
        |         | |       | |        |  |   |   |    |  | |   |
 $--RMC,hhmmss.ss,A,llll.ll,a,yyyyy.yy,a,x.x,x.x,xxxx,x.x,a,m,*hh
 

Field Number:

1. UTC Time
2. Status, V=Navigation receiver warning A=Valid
3. Latitude
4. N or S
5. Longitude
6. E or W
7. Speed over ground, knots
8. Track made good, degrees true
9. Date, ddmmyy
10. Magnetic Variation, degrees
11. E or W
12. FAA mode indicator (NMEA 2.3 and later)
13. Checksum

See RMC

VTG

public static final Sentence VTG

VTG - Track made good and Ground speed

         1  2  3  4  5  6  7  8 9   10
         |  |  |  |  |  |  |  | |   |
 $--VTG,x.x,T,x.x,M,x.x,N,x.x,K,m,*hh
 

Field Number:

1. Track Degrees
2. T = True
3. Track Degrees
4. M = Magnetic
5. Speed Knots
6. N = Knots
7. Speed Kilometers Per Hour
8. K = Kilometers Per Hour
9. FAA mode indicator (NMEA 2.3 and later)
10. Checksum

See VTG

ZDA

public static final Sentence ZDA

ZDA - Time & Date - UTC, day, month, year and local time zone

        1         2  3  4    5  6  7
        |         |  |  |    |  |  |
 $--ZDA,hhmmss.ss,xx,xx,xxxx,xx,xx*hh
 

Field Number:

1. UTC time (hours, minutes, seconds, may have fractional subsecond)
2. Day, 01 to 31
3. Month, 01 to 12
4. Year (4 digits)
5. Local zone description, 00 to +- 13 hours
6. Local zone minutes description, apply same sign as local hours
7. Checksum

See ZDA

Constructor Detail

Sentence

private Sentence()

Method Detail

values

public static Sentence[] values()

Returns an array containing the constants of this enum type, in the order they are declared. This method may be used to iterate over the constants as follows:

for (Sentence c : Sentence.values())
    System.out.println(c);

Returns:

an array containing the constants of this enum type, in the order they are declared

valueOf

public static Sentence valueOf(java.lang.String name)

Returns the enum constant of this type with the specified name. The string must match exactly an identifier used to declare an enum constant in this type. (Extraneous whitespace characters are not permitted.)

Parameters:

name - the name of the enum constant to be returned.

Returns:

the enum constant with the specified name

Throws:

java.lang.IllegalArgumentException - if this enum type has no constant with the specified name

java.lang.NullPointerException - if the argument is null