ICIMACS v5.9 Instrument Electronics (IE) Command Set for MODS

06/25/01 : JAM

(ICIMACS = Instrument Control and Image Acquisition System

USAGE: 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. See the ICIMACS Command Protocol page for inter-machine communication specifics.
For commands with optional parameters, entering the command alone will return its current values.


NOTE: The collimator and camera mechanism names have been changed since the last version of this document:

RCTILT => RCOLTILT

BCTILT => BCOLTILT

RPTILT => RCAMTILT

BPTILT => BCAMTILT


New Commands:
 
SIMMODE [ON/OFF]
Turn mechanism simulation on or off. Note that IE always starts with SIMMODE=OFF, so the first comand sent to the simulator should be SIMMODE ON.
Returns:
DONE: All mechanisms are now simulated. SIMMODE=ON
DONE: Mechanism simulation disabled. SIMMODE=OFF
SLIT [n/IN/OUT] !NOT ENABLED!
Select slit mask n, insert, or retract the slit mask
GFILTID [n [filtername]]
identify guider filter positions by name
Returns:
STATUS: GuiderFilterIDs: 0='' 1='' 2='' 3=''
DONE: GuiderFilterID 1='B'

RFILTID [n[ filtername]]
identify red channel filter positions by name
Returns: Same as above, "RFilterID" replaces "GuiderFilterID"

BFILTID [n [filtername]]
identify blue channel filter positions by name
Returns: Same as above, using "BFilterID"

RGRATID [n [filtername]]
identify red channel grating turret positions by grating name
Returns: Same as above, using "RGratingID"

BGRATID [n [filtername]]
identify blue channel grating turret positions by grating name
Returns: Same as above, using "BGratingID"

RFILT [n]
Rotate red channel filter wheel to position n
Returns:
STATUS: RFILT=0
DONE: RFILT=1

BFILT [n]
Rotate blue channel filter wheel to position n
Returns: same as above, using 'BFILT'

RGRAT [n]
Rotate red channel grating turret to position n
Returns: same as above, using 'RGRAT'

BGRAT [n]
Rotate blue channel grating turret to position n
Returns: same as above, using'BGRAT'

GFILT [n]
Rotate guider filter wheel to position n
Returns: same as above, using 'GFILT'

DICHROIC n
Select dichroic position
Returns: same as above, using 'DICHROIC'

RMASK n
Select red CCD transfer mask position
Returns: same as above, using 'RCCDMASK'

BMASK n
Select blue CCD transfer mask position
Returns: same as above, using 'BCCDMASK'

GUIDERX n/RESET/HOME/HILIMIT
move guider x-axis
Returns:
DONE: GUIDERX=0
STATUS: GUIDERX=HILIMIT
ERROR: GUIDERX=HILIMIT
ERROR: GUIDERX=LOLIMIT

GUIDERY n/RESET/HOME/HILIMIT
move guider y-axis
Returns: Same as above, using 'GUIDERY"

GUIDERFOCUS n/RESET/HOME/HILIMIT
move guider focus
Returns: Same as above, using 'GUIDERFOCUS'

RCOLTILT a b c/RESET/HOME/HILIMIT
move red collimator tilt mechanisms
Returns: Same as above, using 'RCOLTILT1', 'RCOLTILT2', 'RCOLTILT3', and 'RCOLFOC'

RCOLTILT1 n/RESET/HOME/HILIMIT
move red collimator tilt 1 mechanism
Returns: Same as above, using 'RCOLTILT1'

RCOLTILT2 n/RESET/HOME/HILIMIT
move red collimator tilt 2 mechanism
Returns: Same as above, using 'RCOLTILT2'

RCOLTILT3 n/RESET/HOME/HILIMIT
move red collimator tilt 3 mechanism
Returns: Same as above, using 'RCOLTILT3'

BCOLTILT a b c/RESET/HOME/HILIMIT
move blue collimator tilt mechanisms
Returns: Same as above, using 'BCOLTILT1', 'BCOLTILT2', 'BCOLTILT3', and 'BCOLFOC'

BCOLTILT1 n/RESET/HOME/HILIMIT
move blue collimator tilt 1 mechanism
Returns: Same as above, using 'BCOLTILT1'

BCOLTILT2 n/RESET/HOME/HILIMIT
move blue collimator tilt 2 mechanism
Returns: Same as above, using 'BCOLTILT2'

BCOLTILT3 n/RESET/HOME/HILIMIT
move blue collimator tilt 3 mechanism
Returns: Same as above, using 'BCOLTILT3'

RG1TILT n/RESET/HOME/HILIMIT
move red grating 1 tilt mechanism
Returns: Same as above, using 'RGR1TILT'

BG1TILT n/RESET/HOME/HILIMIT
move blue grating 1 tilt mechanism
Returns: Same as above, using 'BGR1TILT'

RG2TILT n/RESET/HOME/HILIMIT
move red grating 2 tilt mechanism
Returns: Same as above, using 'RGR2TILT'

BG2TILT n/RESET/HOME/HILIMIT
move blue grating 2 tilt mechanism
Returns: Same as above, using 'BGR2TILT'

RG3TILT n/RESET/HOME/HILIMIT
move red grating 3 tilt mechanism
Returns: Same as above, using 'RGR3TILT'

BG3TILT n/RESET/HOME/HILIMIT
move blue grating 3 tilt mechanism
Returns: Same as above, using 'BGR3TILT'

RCAMTILT a b c/RESET/HOME/HILIMIT
move red primary tilt mechanisms
Returns: Same as above, using 'RCAMTILT1', 'RCAMTILT2', 'RCAMTILT3', and 'RCAMFOC'

RCAMTILT1 n/RESET/HOME/HILIMIT
move red primary mirror tilt 1 mechanism
Returns: Same as above, using 'RCAMTILT1'

RCAMTILT2 n/RESET/HOME/HILIMIT
move red primary mirror tilt 2 mechanism
Returns: Same as above, using 'RCAMTILT2'

RCAMTILT3 n/RESET/HOME/HILIMIT
move red primary mirror tilt 3 mechanism
Returns: Same as above, using 'RCAMTILT3'

BCAMTILT a b c/RESET/HOME/HILIMIT
move blue primary tilt mechanisms
Returns: Same as above, using 'BCAMTILT1', 'BCAMTILT2', 'BCAMTILT3', and 'BCAMFOC'

BCAMTILT1 n/RESET/HOME/HILIMIT
move blue primary mirror tilt 1 mechanism
Returns: Same as above, using 'BCAMTILT1'

BCAMTILT2 n/RESET/HOME/HILIMIT
move blue primary mirror tilt 2 mechanism
Returns: Same as above, using 'BCAMTILT2'

BCAMTILT3 n/RESET/HOME/HILIMIT
move blue primary mirror tilt 3 mechanism
Returns: Same as above, using 'BCAMTILT3'

 


Old Commands, Unchanged From Previous IE Versions
 
RESET
reset all mechanisms
 
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
 
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.
 
ADC a p c
read ADC for address a, position p, using current of c
 
ADC m p c t
read ADC for motor m, position p, using current of c, every t seconds
 
ISTATUS [1]
Return instrument status string; ISTATUS 1 gives long FITS format string
 
MSTATUS [name]
Return status of mechanism name or list mechanisms
 
SAVECONFIG name
save current configuration to name.ini file on disk
 
LOADCONFIG name
load current configuration file name.ini
 
HELP/ HELP command
Return help message for command; help by itself lists commands
 
VERBOSE
Echo all communications to screen
 
CONCISE
Supress echoing of communications to screen
 
UDELAY n
Delay n timer ticks (one tick = 838 nanoseconds)
 
PEEK varname
Display value of variable varname
 
POKE varname n
Change value of variable varname to n
 
QUIT
End the program and exit to system
 
PING
Communication initialization request
 
PONG
indicates an active machine
 
REGISTER
respond with a ping to sender
 
BUFFER n
Display contents of port buffer n
 
FLUSH n
Flush contents of port buffer n
 
RECOVER
Reinitializes communication
 
RESTART
Clears host table and reinitializes communication
 
HOSTS
prints list of available machines
 
PORTS
prints valid port numbers
 
TIME dd/mm/yy hh
mm:ss timezone : sets system time and zone information
 
VERSION
show software version #, executable name, and compilation date and time
 
FREE
shows available memory and excess stack