ICIMACS for CCDS v5.0 Instrument Electronics (IE) Command Set

2/17/00 : JAM

(ICIMACS = Instrument Control and Image Acquisition System

USAGE: Most commands for the IE can be entered either from its keyboard, with output appearing on the IE monitor, or through a serial port, with output returned through that port. The ICIMACS interface allows commands to come from any machine connected on the ICIMACS network. See the ICIMACS Command Protocol page for inter-machine communication specifics. The exception is INCR, which requires use of the IE keyboard up and down arrow keys.
For commands with optional parameters, entering the command alone will return its current values.


Program Control

QUIT
Saves the current configuration and quits the program
STATUS, ISTATUS [1]
Returns the mechanism positions and any errors in the positions. Adding the 1 parameter gives a fits-compliant version of the same information.
MSTATUS mechname
Returns the status of mechanism mechname, or lists the mechanism names.
VERSION
Returns the program version number, executable path and name, and compilation date and time
SAVECONFIG filename
Saves current settings to the IECCDS.INI file, or to the file filename
LOADCONFIG filename
Loads settings from the file IECCDS.INI, or from the file filename

Mechanism Control

SETADR n
Select address n
CURRENT n [m]
Set current for current mechanism, or mechanism m
DELAY n m
Set step delay for current mechanism or mechanism m to n microseconds
RESET
reset all mechanisms
GRATNAME gratingname
Set grating name to store in header
GROOVES n
Number of grooves/mm to store in header
ORDER n
Grating order to store in header
CENWAVE l p
Approximate central wavelength l at pixel p to store in header
FILTERID [n[ filtername]]
Identify filter positions by name
PREFILTID [n [filtername]]
Identify prefilter positions by name
EXERCISE
runs all mechanisms through their full range of travel continuously
FILTER [n,RESET]
Move filter slide to position n, or reset it
PREFILT [n,RESET]
Move prefilter slide to position n, or reset it
COLFOCUS [n][RESET][HOME]
Set collimator focus position to n, or resets the collimator focus
SLITWIDTH [n][RESET][HOME]
Set slit width to n, or resets the slit
GRATTILT [n][RESET][HOME]
Set grating tilt to n, or resets the grating
OFFSET n [X]
Offset active mechanism by n steps; X uses expert mode (no interlock)
INCR [n]
Steps active mechanism or mechanism n on up or down arrow keypress. exits.
ISTATUS [1]
Return instrument status string; ISTATUS 1 gives long FITS format string
MSTATUS [name]
Return status of mechanism name or list mechanisms

Engineering-level Commands

SETADR,ADR,ADDRESS n
Selects electronics box address n
SETCUR,CURRENT n
Set current used with selected mechanism to n units (Range is 0-255, conversion is n/128 = Amps)
SETDELAY,DELAY,STEPDELAY n
Set the step delay for the selected mechanism to n microseconds.
OFFSET n [X]
Offsets active mechanism by n steps; X enables expert mode (no interlock).
INCR n
Steps the current mechanism, or mechanism n, on every up arrow or down arrow keypress. "Q" exits.

Utilities

TIME dd/mm/yy hh:mm:ss timezone
Sets the system time, and the timezone identifier.
FREE
Prints the status of the system memory

Communication Control

RECOVER
Reinitializes communication without resetting current table of active hosts
RESTART
Clears table of hosts and path mount table and reinitializes communication
PING [ALL]
Communication initialization request; responds with a PONG
PONG
Communication initialization acknowledge; no response is given
BUFFER n
Display contents of communication port n buffer
FLUSH n
Clear contents of communication port n buffer
PORTS
Returns a list of the active ports (keyboard/screen=0,com ports=1-2).
HOSTS
Lists all message sender addresses that have been received.
VERBOSE
Echoes all incoming and outgoing communications onscreen
CONCISE
Suppresses echoing of communications onscreen

Imaging Sciences Laboratory
Revised: February 17, 2000 [jam]