II. The DSP Directory Structure
Throughout this document I will refer to directories that
currently exist on our observing computers, mrwhoopie and natasha.
Here is a visual representation of the DSP
directory structure. These directories are:
- /applic/dsp
The top level directory of all dsp related software.
- /applic/dsp/csource
The top level directory for all dsp code written in the
C language.
- /applic/dsp/csource/cforth1.y
These directories hold the various versions of Mitch Bradley's
CFORTH FORTH compiler.
- /applic/dsp/csource/driver
Contains all the code needed to create the device driver.
- /applic/dsp/run
The top level directory for all files used by CFORTH while
running the dsp system.
- /applic/dsp/runtime/det
Contains the files which cforth loads to initialize
the different detector files. The file last.run, which records
the important parameters from the most recent run, resides here.
- /applic/dsp/runtime/dsp56k
Contains the code CFORTH needs for the Spectrum Data Boards.
- /applic/dsp/runtime/dsp56k/clocks
Assembly language programs that control the clocking board. These
programs mainly deal with sampling modes, clock pulses, and convert
pulses.
- /applic/dsp/runtime/dsp56k/dataacq
Data programs for IR arrays and Spectrum DSP board. Does all 7
standard sampling modes plus Fowler sampling.
- /applic/dsp/runtime/fthsysx.y
The different versions of the DSP observing system. Older
versions are kept around in case of bugs in newer versions.
Beware of bugs in CFORTH, I have found many. Email Mitch
Bradley (wmb@forthware.com) if his code isn't doing what the
documentation says.
- /applic/dsp/runtime/fthsysx.y/bin
Here lie the executables and the initializing file, dspsys.fth,
which tells CFORTH which DSP files to load.
- /applic/dsp/runtime/fthsysx.y/src
The guts of the DSP software.
- /applic/dsp/runtime/fwheels
The files located here each represent a different filter wheel.