.. DISCOTools

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>``: 

.. code-block:: java
   
   > 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: 

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

Input a packet and press ``ENTER``. For example:

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

.. code-block:: java

   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

.. code-block:: java
   
   > -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