jwo.landserf.process.gps.garmin
Class PVTDataPacket

java.lang.Object
  jwo.landserf.process.gps.garmin.GarminPacket
      jwo.landserf.process.gps.garmin.PVTDataPacket

All Implemented Interfaces:

GPSTime, Position

public class PVTDataPacket

extends GarminPacket

implements GPSTime, Position

Represents a packet containing PVT data (position, velocity, time). This is used for real-time transmission of data. After receiving a Cmnd_Start_Pvt-packet, the GPS will continually transmit packets of the PVT-type until told to stop. Garmin GPS being used.

Version:

2.2, 24th June, 2004

Author:

Jo Wood, based on the design by Henrik Sorensen (haas@itu.dk).

Field Summary

Fields inherited from class jwo.landserf.process.gps.garmin.GarminPacket

Cmnd_Abort_Transfer, Cmnd_Start_Pvt_Data, Cmnd_Stop_Pvt_Data, Cmnd_Transfer_Alm, Cmnd_Transfer_Posn, Cmnd_Transfer_Prx, Cmnd_Transfer_Rte, Cmnd_Transfer_Time, Cmnd_Transfer_Trk, Cmnd_Transfer_Wpt, Cmnd_Turn_Off_Pwr, DLE, ETX, packet, Pid_Ack_Byte, Pid_Almanac_Data, Pid_Command_Data, Pid_Date_Time_Data, Pid_Nak_Byte, Pid_Position_Data, Pid_Product_Data, Pid_Product_Rqst, Pid_Protocol_Array, Pid_Prx_Wpt_Data, Pid_Pvt_Data, Pid_Records, Pid_Rte_Hdr, Pid_Rte_Link_Data, Pid_Rte_Wpt_Data, Pid_Trk_Data, Pid_Trk_Hdr, Pid_Wpt_Data, Pid_Xfer_Cmplt

Constructor Summary

PVTDataPacket(GarminPacket packet)
Creates a PVT packet from the given packet data.

PVTDataPacket(int[] packet)
Creates a PVT packet from the given data.

Method Summary

float	getAltitude() Reports the altitude of this position.
short	getHours() Reports the hour of the day stored in the packet.
AngleRadians	getLatitude() Reports the latitude of the position.
AngleRadians	getLongitude() Reports the longitude of the position.
short	getMinutes() Reports the minutes of the hour stored in the packet.
short	getSeconds() Reports the second of the minute stored in the packet.
String	toString() Reports a textual representation of this packet.

Methods inherited from class jwo.landserf.process.gps.garmin.GarminPacket

calcChecksum, commandToString, createBasicPacket, createCommandPacket, getByte, getDataLength, getID, getLength, getPacket, getRawPacket, idToString, isLegal, readByte, readDouble, readFloat, readLong, readNullTerminatedString, readWord, setPacket

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

PVTDataPacket

public PVTDataPacket(int[] packet)

Creates a PVT packet from the given data.

Parameters:

packet - Data representing the PVT data packet.

Throws:

PacketNotRecognizedException - if the data do not represent a PVT packet.

InvalidPacketException - if the packet data are not the expected length.

PVTDataPacket

public PVTDataPacket(GarminPacket packet)

Creates a PVT packet from the given packet data.

Parameters:

packet - Packet to copy.

Throws:

PacketNotRecognizedException - if the given packet is not a PVT packet.

Method Detail

getHours

public short getHours()

Reports the hour of the day stored in the packet.

Specified by:

getHours in interface GPSTime

Returns:

Hour of the day (0-23).

getMinutes

public short getMinutes()

Reports the minutes of the hour stored in the packet.

Specified by:

getMinutes in interface GPSTime

Returns:

Minutes of the hour (0-59).

getSeconds

public short getSeconds()

Reports the second of the minute stored in the packet.

Specified by:

getSeconds in interface GPSTime

Returns:

Second of the minute (0-59).

getLatitude

public AngleRadians getLatitude()

Reports the latitude of the position.

Specified by:

getLatitude in interface Position

Returns:

Latitude in radians.

getLongitude

public AngleRadians getLongitude()

Reports the longitude of the position.

Specified by:

getLongitude in interface Position

Returns:

Lonitude in radians.

getAltitude

public float getAltitude()

Reports the altitude of this position.

Specified by:

getAltitude in interface Position

Returns:

Altitude of this position in units determined by the GPS. May be 0 if GPS unit does not record waypoint altitude.

toString

public String toString()

Reports a textual representation of this packet.

Overrides:

toString in class GarminPacket

Returns:

String containing the position in a human readable format.