Console

The console implements a simple command line interface (CLI) for parsing APRS packets and listening for packets from TNCs and APRS-IS servers.

Listen to APRS-IS

The following command connects the console to APRS-IS server <host> at <port> identifying it self as <user> with <passcode>:

> java -jar io-aprs-<version>-fat.jar -s is -h <host>:<port> -u <user> -p <passcode>

After the initial handshake, the console will print out packets as they come from the server. Additional parameters are:

• -o <trace>: save trace to file
• -e: only output unknown, incomplete or invalid packet

Exit the console by pressing CTRL+C.

Parse input

The following command opens the console in interactive parse mode:

> java -jar io-aprs-<version>-fat.jar -s in -i
Enter APRS packet: -----------------------------------------------
>

Input a packet and press ENTER. For example:

Enter APRS packet: -----------------------------------------------
> OH2LIY>APRX20,TCPIP*,qAC,T2FINLAND:!6020.87NR02504.81E&MDR + WRT54 + Aprx v2 Rx-iGate

which outputs

PARSE: -----------------------------------------------
Packet parsed as: T_POSITION [AprsPosition]
Unknown? false
Complete? true
Valid? true
Time: 4/21/12 6:30 PM
Payload: OH2LIY>APRX20,TCPIP*,qAC,T2FINLAND:!6020.87NR02504.81E&MDR + WRT54 + Aprx v2 Rx-iGate
Comment: MDR + WRT54 + Aprx v2 Rx-iGate
Symbol (alternate): &, overlay: R, label: HF Gateway (diamond)
From: OH2LIY
To: APRX20
Path: TCPIP*,qAC,T2FINLAND
Header Type: TNC2
isThirdParty: false
Extension Type: T_NONE
NMEA? false
MIC-e? false
Position: POINT (25.080166666666663 60.347833333333334)
Altitude: null

Exit the console by pressing CTRL+C.

If you only want to parse a single packet, enter the following command

> -s in "OH2LIY>APRX20,TCPIP*,qAC,T2FINLAND:!6020.87NR02504.81E&MDR + WRT54 + Aprx v2 Rx-iGate"

Note: Always enclose packets with double apostrophes: "...". Additional parameters are:

• -o <trace>: save trace to file
• -e: only output unknown, incomplete or invalid packet