A.  Hardware:

    Since this software is a Java application.  You can run it on virtually any hardware platform.  I have tested the software for the following platforms:  SGI O2, SUN ULTRA, PC - Pentium 200Mhz.

    B.  Software:

    In order to run this application you need to have the Java installed on your machine:

        JDK - Java Development Kit  version 1.1.5.  Try this link  JAVA Products
        NOTE:  The newest version of JDK is version 1.1.6.  I have not yet tested this application using JDK 1.1.6.
 
        If you want to be able to record packets originating from outside of your subnet.  Your machine must also be able to accept IP multicast packets.  Here are some good links for informatin on joining the MBONE  the MBONE faq and  Dan's Quick and Dirty Guide to Getting Connected to the MBONE .

       You can run the program without MBONE connectivity.  But, you can only send multicast packets inside your local subnet.

        You will also need an DIS-Java-VRML application along with a VRML browser.  Download the distribution file from  NPS DIS-Java-VRML Distribution Page .  This page has good instructions on the installation of the distribution file.  It also has a link to some VRML browsers.  You will be using the EspduSender and EspduReadTransformTraceExample.wrl to test this recorder.

II.  Instructions

    A.  Setup

        First create a subdirectory.  Place the logger.zip file in that subdirectory.  Unzip the logger.zip file.  This will create two subdirectories -- ver1 and ver2 along with the documentation files.

    B.  Starting the Application

        To start the application go to the following subdirectory

        ..\ver1\dis\

        Enter "java DisPlayer1"

       You will get the following user interface.

    C.  Recording Dis Packets

        One way to create the DIS packets to record is to use the EspduSender applet from the Naval Post Graduate school.  You can launch this applet from the web browser.  You can also launch it from the command line.  To launch the applet from the command line type

c:\dis-java-vrml\mil\navy\nps\Awt\java AwtEspduSender
 

        Make the following changes.

• Change the Site &App ID field to 0.0.01
• Change the Entity ID field to 2
• cut and paste data from the  EspduDataSheet  for the location and velocity fields

        Lastly, press the "RECORD" button on the DisPlayer application.

        To stop the recording press the "STOP" button on the DisPlayer application.  Also press the "Stop" button on the AwtEspduSender applet.

        If you want to see the movement based on the DIS packets being sent, launch the Naval Post Grad School's EspduReadTransformTraceExample.wrl from the browser.  You will see the AUV vehicle move around the Monterey bay.

        NOTES:

• This version does not use a linked list to store the packets.  It automatically writes to the file.  Make sure you type in a new file name for each recording.  Otherwise, it will overwrite the file.
• You have to be sure the entity ID's are lined up between the sender and

the code in the .wrl file. They both need to be exactly the same.  This is why we set the Site &App ID to 0.0.0.1 and the Entity ID Field to 2.  (This information was given by Don McGregor of the Naval Post Graduate School.)

        To play audio.  aunch the Naval Post Grad School's EspduReadTransformTraceExample.wrl from the browser.

        Choose the "File" menu.  Then, choose "Open".  You will get a chance to pick the file you want to play.

        Next fill in the following fields:  IP address, port number and TTL.  Make sure it is set to the same IP and port number as the EspduReadTransformTraceExample applet.

• IP Adress -- 224.2.181.145
• Port Number -- 62040
• TTL -- 15

        Press the "PLAY" button to start sending the DIS packets.  You should see the vehicle move around the Monterey bay.  Press the "STOP" button to stop sending the packets.

    E.  QUIT

        To exit the application press the "QUIT" button.

    F.  CODE DOCUMENTATION

        Documentation for the Java application was created using the javadoc utility.  The documentation can be found at
DisPlayer Version 1 Code Documentation

    G.  SOURCE CODE

        The source code is included as part of the zip file.  It can be found in the following subdirectory:

        ..\ver1\dis\