Brian Antonishek (antonis@nist.gov)                12/16/1999


******************************************************************
*** Running the Bird Server 
******************************************************************
To get things working you need to first get the FOBServer process
running on the machine which has the camera attached to its serial
port.

The command to run the server with java:

    Usage: java FOBServer [<portnum>] default: 7997)

PCs and Suns
------------
On Windows and Solaris, FOBServer uses the Java COMM API 2.0 
extension for serial port communications.  You just need to be sure
that you have the Java COMM API extension installed correctly.  
See:   http://java.sun.com/products/javacomm/index.html


Once you have the server running you can test the server by telneting
directly to the server and giving commands found in FlockBase.java.
That is, if the camera server is running on host host1.nist.gov and
listening on port 7997 then your session would look like this:

  telnet host1.nist.gov 7997
  Trying 129.6.x.x
  Connected to host1.
  Escape character is '^]'.
  FOB_Init
  FOB_PosInq        
  125, 200, 100
  bye
  Exit command received.  Bye.
  Connection closed by foreign host.

This is the quickest way to make sure your server is running
correctly.  



******************************************************************
*** Using a Client application 
******************************************************************

Next take a look at the imageMapExample/ directory for example
code for a client application.



******************************************************************
*** Proxy Server
******************************************************************
If you try and run a Java applet client by connecting to the
camera server make sure that you get the controlling java applet 
from a web server that is running on the same machine as the 
camera server.  This is necessary because of the Java security 
feature that applets can only open sockets to the host from which
they came.

But, it is pretty simple setting up a proxy server application
that can get around this situation.  See the nice proxy server
example from the javaExamplesInANutshell book at:

   http://www.davidflanagan.com/javaexamples



******************************************************************
***
******************************************************************

Have fun!  Let me know if you have any suggestions or get it 
running on any other platforms.  Thanks!

-Brian (antonis@nist.gov)

-----------------------------------------------------------------------