org.ka2ddo.aprs

Class APRSStack

java.lang.Object

org.ka2ddo.aprs.APRSStack

All Implemented Interfaces:

AX25Parser

public class APRSStack
extends java.lang.Object
implements AX25Parser

This class parses incoming binary messages into the appropriate classes of APRS message objects.

See Also:

Message

Field Summary

Fields

Modifier and Type	Field and Description
static boolean	debug Flag to enable extra debugging stack traces for common cases that don't normally need stack traces.

Method Summary

Modifier and Type	Method and Description
static APRSStack	getInstance() Get the singleton instance of APRSStack.
AX25Message	parse(byte[] body, AX25Callsign src, AX25Callsign dest, long rcvTimestamp, Connector connector) Parse a message to the appropriate object class.
static Message	parse(byte[] body, int offset, AX25Callsign src, AX25Callsign dest, java.lang.String tp, long rcvTimestamp, Connector connector) Analyze the contents of an AX.25 packet that appears to be identified as an APRS packet.

Methods inherited from class java.lang.Object

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

Field Detail

debug

public static boolean debug

Flag to enable extra debugging stack traces for common cases that don't normally need stack traces.

Method Detail

getInstance

public static APRSStack getInstance()

Get the singleton instance of APRSStack.

Returns:

APRSStack singleton Object

parse

public static Message parse(byte[] body,
                            int offset,
                            AX25Callsign src,
                            AX25Callsign dest,
                            java.lang.String tp,
                            long rcvTimestamp,
                            Connector connector)

Analyze the contents of an AX.25 packet that appears to be identified as an APRS packet.

Parameters:

body - byte array containing the packet body

offset - zero-based starting index in the body array where the message is supposed to start

src - AX25Callsign of transmitting station

dest - AX25Callsign of destination station (or tocall)

tp - String of third party prefix, or null if no third-party prefix detected yet

rcvTimestamp - time (in milliseconds since Jan 1 1970 UTC) that message was received

connector - Connector that received the packet

Returns:

Message object of the decoded APRS frame (if not valid APRS, it will be an instance of DefaultMessage marked invalid)

parse

public AX25Message parse(byte[] body,
                         AX25Callsign src,
                         AX25Callsign dest,
                         long rcvTimestamp,
                         Connector connector)

Parse a message to the appropriate object class.

Specified by:

parse in interface AX25Parser

Parameters:

body - byte array containing the message to be parsed

src - AX25Callsign of the sending station

dest - AX25Callsign of the destination (probably an APRS alias)

rcvTimestamp - the time in Java/Unix milliseconds since midnight Jan 1, 1970 UTC when this message was actually received (as opposed to any timestamp that might be embedded in the message body)

connector - Connector over which the message was received (null if from a file)

Returns:

the decoded Message (if not decipherable, a DefaultMessage is returned)