April 25, 2001
J. D. Monnier

Location and Use of Important New Code
======================================

This is a brief message to document where the latest VxWorks routines
are which I worked on during 2001April.  This will also describe the
XDisplay helper utilities for viewing startracker and PICNIC data, and
how to use IDL to read shared memory.  This was for Solaris 2.7, and I
hope the shared memory functionality (via the C routine 'map') will be
maintained.

A. Tornado Workspace
--------------------

 I've created a new workspace for tornado (user: iota) which contains
only the most recent working versions of the code.  It is called
IOTA_Clean_2001April and is located in ~iota.


1. StarTracker

  The latest code for the startracker (which runs on interrupts and
incorporates shutter control) is in:
  
   ~iota/mc/Startracker_2001April

I've included both the fpga code and the startracker-proper itself
here in the same directory, renamed some files, and cleaned things up
considerably.

This code is accessible from the Startracker Project in
IOTA_Clean_2001April workspace

2. DAQ
 
The DAQ code is located in:
 
  ~iota/mc/DAQ

This code is accessible from the DAQ Project in IOTA_Clean_2001April
workspace

If you are intersted in perusing the current flow of the
DAQ_Scheduler, you can find my drawing at:

http://cfa-www.harvard.edu/~jmonnier/JDM_IOTA/Drawings/DAQ.2001Apr09.ps

Please write me with suggestions, comments, complaints, etc.etc.etc.

3. serial board files and cbcom.

These files are collected in the last (third) project of
IOTA_Clean_2001April, but the code is distributed in a variety of
places (as originally designated by Amherst developers).  I think the
serial board files are actually in: 
       ~iota/vmivme/sw-6016-abc-030

and the cbcom files are in: 
	~iota/mc/cbcom

I suggest a CLEAN distribution of these files should be put together
since the current distribution (especially vmivme/ !!) is confusing as
to which is the most up-to-date version to use.

XDisplays
---------
I've collected the two main X11 programs in the directory:

  ~iota/XDisplays  [ on the Solaris 2.8 partition only!]

This contains the source code and the executable for the Quadrant
display program and the Startracker_Display program.  The compiler
flags needed to make the executables are documented in the top of each
C program.

IDL
---

Currently the only examples of how to use IDL to read shared memory
are in the directories:

 ~jmonnier/Idlstuff/C++

The clearest examples are in Quadrant and SeeScans, used to read the
picnic quadrant and/or read scans from shared memory.  The files in
Startracker are not as clean since they were my first development
project and haven't been re-documented.

Also note, I've installed a bunch of useful IDL libraries on my
account under ~jmonnier/Idlstuff.  Most of these should eventually be
put somewhere accessible to all users.

*** However, none of this has been tested with the NEW solaris 2.8
machine, so there may be problems getting it to work at first *** Same
goes for the All of the ABOVE!