Files used during VxWorks startup are located in /usr/aos/hbar/etc. The main startup file is HBARStartup.cmd. This file will source several other startup files to load the various components of the HBAR system. The EPICS startup file is located in /usr/aos/hbar/epics/bin/mv177/startup.
Certain files in /usr/aos/hbar/config are used by the system during operation. The files are grouped into several categories listed below. Except as noted these files are installed during the system build and WILL BE OVERWRITTEN! In order to edit these files a version of the software must be checked out and the sources edited (See Obtaining the Sources above). After the changes have been made the files can be installed.
Two files control configurable system parameters. The file Options.db sets default values for User configurable options. The file System.parameters controls system parameters that affect the operation of the wavefront sensing algorithms.
Each motorized stage has a parameter file that is used during initialization to set the values in the IMS stepper motor driver. The parameter file for a stage is the stage name with a .parameter suffix. The current set of stages is: fsmTip, fsmTilt, fsrfs, fsrfz, hlas, rlm, tcx, tcy, tcz, tfw, wfs, and wfsfw. The file Stage.parameters contains the list of known (AOA) stages along with default positions for the MLM's, filter wheels, WFS cameras, etc.
The sound files used for the voice annunciator are not installed during a system build. The only copies of these files are located in this directory. The sound files are AOError.au, GeneralError.au, and StageError.au.
The files in this category are not installed by a system build. The only copies of these files are located in this directory. The file DMBias contains the signal levels for the deformable mirror to produce a flat surface. This file is used by the runtime system to flatten the mirror. The file Gain contains the gain levels for the LLCCD camera. The file ModeToActMapping contains the master mapping from the modal space of the control system to the actuator space. This file is used to generate reconstructor and injection matrices.
Two files are read from the users home directory: $HOME/.hbarrc and $HOME/.hbarpref. .hbarrc contains Tcl commands that are read at startup. The most important line tells Tcl where to find the scripts used by the system. A sample .hbarrc file follows:
#
# ${HOME}/.hbarrc
#
# Startup file for the HBAR Tcl executable
#
#
# Add the Scripts directory to our search path
#
set auto_path [linsert $auto_path 0 $env(HBAR_ROOT)/lib/scripts]
set auto_path [linsert $auto_path 0 .]
#
# Get rid of the default Tk window
#
wm withdraw .
#
# Start the HBAR GUI
#
hbar
The .hbarpref file is used to set user preferences. A sample follows:
#
# User Preferences
#
#
# Logging Message Display
#
showErrorMessages = TRUE
showWarningMessages = TRUE
showInfoMessages = TRUE
showDebugMessages = FALSE
#
# Voice Annunciator
#
voiceAnnunciator = TRUE
Certain system parameters are set at compile time. These are values that must remain fixed during the operation of the system or are values that reflect physical constants (number of camera pixels, number of DM actuators, ...). These parameters are located in include/hbarConfig.h. The file includes descriptions of each of the parameters. Two parameters that will require change are the default host IP numbers for the AO and Stage server programs. These are programs that run under VxWorks and accept commands from remote machines. The IP address of the VME chassis while at AOA/Cambridge was set to 199.93.217.49. This value needs to be changed when the system is moved t a different network. This value can be changed at the Tcl level. Changing it at compile-time will result in a new default value as determined by include/hbarConfig.h.
The file /etc/rc3.d/S90aoa was added. This file is executed when the system is rebooted. It starts the AOA logging daemon (AOALogd).
The file /etc/rc2.d/S69inet was modified. A line was added to the file to correct a bug when booting VxWorks from a Solaris 2.x machine. As per Wind River Systems the following line was added:
ndd -set /dev/tcp tcp_close_wait_interval 1000