Modules: Instructor & Driver
08/24/98
by Ilya S. Gaysinskiy

Files and Directories:

SBRecord.java         - The Instructor Module (Java)
SBRecord.conf         - The Instructor Module configuration file (see below)

linux                 - The Driver Module (C - Linux version)
solaris               - The Driver Module (C - Solaris version)

sbdriver              - Symbolic link to either linux or solaris


1. Installation
--------------------------------------------------------------

Make sure that linux and solaris directories are under the 
directory containing SBRecord.java and SBRecord.conf files.

sbdriver should point to either linux or solaris directory 
depending on the platform.

Compile SBRecord.java using jdk1.1.6 or above.
	javac SBRecord.java

2. Configuration
---------------------------------------------------------------

2.1 Instructor Module
        
All of the configuration information for the Instructor Module is stored
in SBRecord.conf file.  The order of items is important. 

Here is an example:

TTL=5
Multicast Port=2255
Multicast IP=225.225.225.225
Driver Port=6666
Driver IP=128.59.16.150
Local Server Port=7777
PT=50

TTL is the time-to-live for multicast. Multicast Port and Multicast
IP are for the server to use when sending strokes via multicast.
Driver Port and Driver IP are of the machine local to the Softboard,
in most cases it will be the same as the instructor's machine, however
one can change them in case the local machine is very slow.
Local Server Port is the port used by the Instructor's module in 
communicating back with the driver.
PT is part of the RTP header that is settable from the outside. PT is
0-127.

2.2 Driver Module

All of the configuration information for the Driver Module is stored
in sbdriver.conf in the driver directory. The order of items is 
important. 

Example:


Local Port=6666
Remote IP=128.59.16.3
Remote Port=7777

Local Port is the port that the driver is listening on, the instructor
will connect to this port. 
Remote IP and Port are those of the instructor machine.

3. Running
-------------------------------------------------------------------

Go to the machine that is directly connected to the Softboard.
From the directory containing SBRecord.java run:

# For Linux
cd sbdriver; sbdriver /dev/ttyS0; cd ..
# For Solaris
cd sbdriver; sbdriver /dev/ttya; cd ..

If the local machine is not too slow open another xterm and
run instructor's module:

java SBRecord
OR
java SBRecord -d # to see the debug information

If the local machine is too slow, login to the remote machine to be
used as the instructor's machine, export the display and run 
java SBRecord.

Make sure that the configuration file reflects your physical computer
setup.