TAURUS-2 U-TASK command set
The TAURUS-2 U_TASK provides full control over the TAURUS-2 micro
and/or a system status display.
1 PARAMETERS
2 etalon_door Current state of the etalon wheel access door
read only (OPEN or CLOSED)
2 pupil_door Current state of the pupil wheel access door
read only (OPEN or CLOSED)
2 fpfw_door Current state of the focal plane filter wheel access door
read only (OPEN or CLOSED)
2 aw_door Current state of the focal plane aperture wheel access door
read only (OPEN or CLOSED)
2 tau_pres_os Pressure outside TAURUS-2
read only in millibars
2 tau_pres_et Pressure in the etalon plane
read only in millibars
2 tau_temp_et Temperature of the etalon currently being servoed
read only in degrees celsius
2 tau_temp_fp Temperature in the focal plane
read only in degrees celsius
2 tau_temp_os Temperature outside TAURUS-2
read only in degrees celsius
2 fp_filter The focal plane filter
Specify filter 1 to 8 or a prevously defined name
of that filter. Default names are ONE, TWO ...
EIGHT. Define name with the define filter command.
use '?' to get the list of filter names
2 set_aperture The focal plane aperture
Specify aperture 1 to 8 or a prevously defined name
of that aperture. Default names are ONE, TWO ...
EIGHT. Define name with the define filter command.
use '?' to get the list of aperture names
2 etalon_path The etalon in the light path
Specify etalon 1 to 6 or a prevously defined name
of that etalon. Default names are ONE, TWO ...
SIX. Define name with the define filter command.
use '?' to get the list of etalon names
2 etalon_table The etalon in the light table (etalon access position)
Specify etalon 1 to 6 or a prevously defined name
of that etalon. Default names are ONE, TWO ...
SIX. Define name with the define filter command.
use '?' to get the list of etalon names
2 pp_filter The pupil plane filter in the light path
Specify filter 1 to 8 or a prevously defined name
of that filter. Default names are ONE, TWO ...
EIGHT. Define name with the define filter command.
use '?' to get the list of filter names
2 pupil_table The pupil plane filter in the light table (access position)
Specify filter 1 to 8 or a prevously defined name
of that filter. Default names are ONE, TWO ...
EIGHT. Define name with the define filter command.
use '?' to get the list of filter names
(read only)
2 filter_tilt Focal plane filter tilt
(can be 0 to 16 (degrees), 16 = disengaged,
-1 = position unknown)
2 iris_position Iris size
(can be 1 to 15 (cm), -1 = position unknown)
2 camera_focus Camera focus length
(can be 0 - 900 (range of 6 mm), -1 = position unknown)
2 fpfw_detent Focal plane filter wheel detent
(IN or OUT)
2 pfw_detent Pupil plane filter wheel detent
(IN or OUT)
2 aw_detent Focal plane aperture wheel detent
(IN or OUT)
2 erw_detent Etalon rotator wheel detent
(IN or OUT)
2 cs_reset CS100 reset, always OFF after setup
but can be monetarly reset. (ON or OFF (logical))
2 loop_status Current status of the cs100 loop
Do not confuse with the parameter CS_LOOPS which is used
to close or open the loops. This parameter is the
current status of the loop which may differ from CS_LOOPS
due if the cs100 is reset, not in external mode etc.
read only (OPEN or CLOSED (logical))
2 overload TRUE on etalon overload, FALSE otherwise. (logical)
2 x_offset The setting for the cs100 etalon x offset
(range -2048 to 2047)
2 y_offset The setting for the cs100 etalon y offset
(range -2048 to 2047)
2 z_offset The setting for the cs100 etalon z offset
(range -2048 to 2047)
2 CS_loop_gain The setting for the cs100 etalon loop gain
(range 0 to 9)
2 cs_time_con The setting for the cs100 etalon time constant
(range 0 to 9)
2 cs100_external cs100 eternal mode
ON - set cs100 external mode on, computer control
OFF - set cs100 external mode off, front panel control
(logical)
2 cs_integ The setting for the cs100 integrator
(IN or OUT (logical))
2 cs_loops Setting of cs100 loops
Do not confuse with the parameter LOOP_STATUS which is
is the current status of the loop which may differ
from CS_LOOPS if the cs100 is reset, not in external mode
etc. (OPEN or CLOSED (logical))
2 sel_servo The servoed etalon
Specify etalon 1 to 6 or a prevously defined name
of that etalon. Default names are ONE, TWO ...
SIX. Define name with the define filter command.
use '?' to get the list of etalon names
2 cur_state The current utask state
(read only, see HELP STATES for a list of states)
2 door_interlock Select door interlock overrides
NORMAL motors may not be run, and the shutter may
not be opened with one or more doors open
MOTOR O/R motors may be run, but the shutter may not
be opened with one or more doors open
SHUTTER O/R motors may be run and shutter opened with
one or more doors open
2 inlet_value The setting for the gas inlet valve
(OPEN or CLOSED (logical))
2 outlet_value The setting for the gas outlet valve
(OPEN or CLOSED (logical))
2 inlet_value The setting for the gas inlet valve
(OPEN or CLOSED (logical))
2 shutter specifiy setting for the shutter
OPEN for open shutter
Anything else to close shutter
2 oper_shutter The setting of the shutter
(OPEN or CLOSED (logical))
2 expose_time Exposure time in seconds
(Real, but only integer second value used)
2 cmd_line Line of text to be sent to micro by the CMD action
3 micro_cmds
di door interlock overrides
rx radix used in commands and status
iv gas inlet valve
ov gas outlet valve
sh shutter
xs CS100 xs position
ys CS100 ys position
zs CS100 zs position
ga CS100 gain
tc CS100 time constant
en CS100 external control
ig CS100 integrator
rc CS100 reset
cl CS100 servo loop
sv CS100 high voltage
sr etalon slow run
fw focal plane filter wheel
aw aperture wheel
lt number of er position in light table
pw pupil plane filter wheel
pl pupil plane filter wheel position in light table
ew etalon wheel
fd fpfw detent
ad aw detent
pd pfw detent
ew erw detent
in tilt
is iris
cf camera focussing
ft focal plane temp
et etalon temp
ot outside temp
ep etalon pressure
op outside pressure
lp etalon loop open or closed
fl fpfw door open
al aw door open
pl pfw door open
el etalon door open
lk reset after a door has been opened
sf selective fill of etalon array
if increment fill of etalon array
af automatic fill of etalon array
fi output etalon array
fr etalon fast run
ar etalon automatic run
?s store cs100 settings
!s restore cs100 settings
os go through zero
ex open shutter of specified number of seconds
io set new input device
od return to original input device
lg start logging
?a do not send status codes
!a send status codes
ps output all status values
am abort motor operation
qu quit taurus
2 setup_file Current setup file (default file type .TSF)
Only a file previously produced by the UTASK
is valid. Use # to select default file name
which is TAU_SETUP.TSF or the presiously specified
file.
2 filter_file Filter definition file (default file type TFD)
Use # to select default file name
which is TAU_SETUP.TFD or the presiously specified
file. When asked for a filter file to be associated
with a setup file. use ^ to specify the same name
assuming default filetypes. ^ should not be used if
the default filetype are not being used.
A filter definition file produced by the UTASK
can be edited and used a new input file.
Format example
* test file
FILTER FOCAL
2 GREEN
3 RED
ENDFILTER
FILTER ETALON
5 JOHN
6 FRED
ENDFILTER
This defines focal filter position 2 as GREEN,
position 3 as RED, ETALON 5 as JOHN
and ETALON 6 as FRED.
A * causes the rest of the line to be ignored.
If the first character of the first line is a *
then that line is used as the title and is placed
in the fcomment parameter.
Defintions should not start with a number and must
be in upper case.
2 array_file File to Store an etalon array. (Default file type TEA)
Only a file previously produced by the UTASK
is valid. Use # to select default file name
which is TAU_ARRAY.TEA or the presiously specified
file.
2 fcomment Comment to be placed in or taken from a filter definition file
2 scomment Comment to be placed in or taken from a setup file
2 acomment Comment to be placed in or taken from an etalon array file
2 fdate Creation date of filter file
2 sdate Creation date of setup file
2 adate Creation date of array file
2 def_filter One off wheel position definitions
format examples
"FOCAL 4 BLUE"
"APERTURE 3 TWENTY"
"PUPIL 3 RED"
"ETALON 2 IR"
Defintions should not start with a number.
2 af_start Automatic fill of etalon array start position
2 af_incr Automatic fill of etalon array increment
2 sf_element Selective fill of etalon array, array element
2 sf_data Selective fill of etalon array, value to be placed in element
2 stop_act Action to be stopped by the STOP action
(SLOW_RUN, AUTO_RUN, PASSTHROUGH)
2 log_act Actions to be logged
Messages from microprocessor - FROM_MICRO
Messages to microprocessor - TO_MICRO
All messages from/to micro - BOTH
STop logging - STOP
1 STATES
In this section, individual details of utask states are given.
Commands valid in all states
Exit Exit taurus utask, exit os9 system taurus software (CRTL-Z)
SHUTTER Open/close shutter (PF4)
Close shutter (DO)
LOG Enable/disable logging of microprocessor communications
(F17 = LOG BOTH)
2 INITIAL
This is the initial utask state entered on startup. Only the default
commands EXIT, HELP etc. may be entered. When initialization of taurus
is complete the state will be changed to MAIN_MENU
2 MAIN_MENU
The default state, gives a status display of general information on the
status of taurus.
3 SETUP Enter the setup control state (KP7)
3 CS100 Enter the cs100 control state (KP8)
3 RUN Enter the etalon run control state (KP9)
3 MISC Enter the miscellaneous menu (KP minus)
2 SETUP_1
Position wheels, iris, tilt etc. Define wheel position names
3 MAIN_MENU Return to the main menu (PF1,KP7)
3 CS100 Enter the cs100 control state (KP8)
3 RUN Enter the etalon run control state (KP9)
3 MISC Enter the miscellaneous menu (KP minus)
3 FOCAL Select focal filter (KP4)
3 PUPIL Select pupil filter (KP5)
3 APERTURE Select aperture (KP6)
3 ETALON Select etalon in light path (KP comma)
3 LIGHT_TABLE Select etalon in light table (KP1)
3 TILT Position focal plane filter tilt (KP2)
3 IRIS Select iris size (KP3)
3 CAMERA Select camera focus distance (ENTER)
3 INTERLOCK Set door interlocks (KP0)
3 RETRY Abort all current motor operations and retry
This command is designed to help in error recovery. The AM (abort motor
operation) command is sent to the micro attempts are made to reposition all
motors that have timed out, or whose position is unknown. (KP period)
3 SETF Define wheel position names (F18)
3 OUTF Output wheel position names (F19)
3 NEXT_MENU Change to setup menu 2 (F20)
SETUP_2
Load and save instrument setups, wheel position definitions and the
etalon array. The current setup, array and filter definition filenames,
comments and creation dates are displayed.
3 MAIN_MENU Return to the main menu (PF1,KP7)
3 CS100 Enter the cs100 control state (KP8)
3 RUN Enter the etalon run control state (KP9)
3 MISC Enter the miscellaneous menu (KP minus)
3 SETUP Return to SETUP_1 menu (F20)
3 LOADA Load the etalon array from a file (.TEA) (KP4)
3 SAVEA Save the etalon array to a file (.TEA) (KP5)
3 OUTA Output the etalon array to the terminal (KP6)
3 LOADF Load wheel position definitions from a file (.TFD) (KP1)
See HELP PARAMETER FILTER_FILE to determine the file format.
3 SAVEF Save wheel position definitions to a file (.TFD) (KP2)
See HELP PARAMETER FILTER_FILE to determine the file format.
3 OUTF Output wheel position definitions to terminal (KP3)
3 SETF Define a wheel position (KP0)
Format "WHEEL POSITION DEFINITION" Where wheel = FOCAL, APERTURE, ETALON
or PUPIL (only first letter required), POSITION is the number of the position
you wish to define, Definition is the definition of the position. The first
letter must not be a number.
3 LOADS Load a setup from a file (.TSF) (KP period)
3 SAVES Save a setup to a file (.TSF) (KP enter)
2 MOTOR_MOD
The state is selected while the motors are being repositioned. Since
the state should not be changed while in this state, the state change
commands are disabled. Other commands are as per the SETUP_1 state.
When there is not longer any motors being moved the state is returned
to SETUP_1
2 CS100
Setup of the CS100 is carried out from this state. All settings are
displayed
3 SETUP Enter to SETUP menu (KP7)
3 MAIN_MENU Return to the main menu (PF1,KP8)
3 RUN Enter the etalon run control state (KP9)
3 MISC Enter the miscellaneous menu (KP minus)
3 XSET Set the CS100 x offset (KP4)
3 YSET Set the CS100 y offset (KP5)
3 ZSET Set the CS100 z offset (KP6)
3 GAIN Set the CS100 loop gain (KP comma)
3 TIME_CON Set the CS100 loop time constant (KP1)
3 EXTERNAL Enable/disable CS100 external control (KP2)
3 INTEGRATOR Set the cs100 integrator function IN or OUT (KP3)
3 RESET Momentarly reset the CS100 (enter)
3 CLOSE_LOOPS Open/close CS100 loops (KP0)
3 SERVO Select the etalon to be servoed (KP period)
2 RUN
Filling of the etalon array, selection of the run type and loading
of setups are made from this state
3 SETUP Enter to SETUP menu (KP7)
3 CS100 Enter the cs100 control state (KP8)
3 MAIN_MENU Return to the main menu (PF1,KP9)
3 MISC Enter the miscellaneous menu (KP minus)
3 SLOW_RUN Execute an IPCS slow etalon run (status updated)(kp4)
3 FAST_RUN Execute an IPCS fast etalon run (no status update)(KP5)
3 AUTO_RUN Execute an automatic etalon run. (KP6)
Ramp etalon up and down etalon array. Status updated
3 AFILL Automatic fill of etalon array. (kp1)
Array channel #1 = af_start
Array channel #a (1 < a < 256) = af_start + a*af_step
3 SFILL Selective fill of etalon array (KP2)
Array channel sf_element = sf_data
3 OUTA output the etalon array to the terminal (KP3)
3 ZSET Set the cs100 z offset (KP0)
3 SERVO Select the etalon to be servoed (KP period)
3 LOADS Load a setup from a file (.TSF) (KP period)
2 SLOW_RUN
Entered during an IPCS slow run. Exits after an etalon overload, 0 from
the IPCS or STOP SLOW_RUN command
3 STOP SLOW_RUN Stop an IPCS slow run (PF1)
2 AUTO_RUN
Entered during an Automatic etalon run. Exists after an etalon overload or
a STOP AUTO_RUN command.
3 STOP AUTO_RUN Stop an automatic etalon run. (PF1)
Note it may take some time for this to take affect.
2 FAST_RUN
Entered during an IPCS fast run. Exists only after a zero is received
from the IPCS. (If this does not occur for some reason pushing the panic
button will cause an exit)
2 MISC
Provides status display and commands for functions that are not normally
required or do not belong to another state.
3 SETUP Enter the setup control state (KP7)
3 CS100 Enter the cs100 control state (KP8)
3 RUN Enter the etalon run control state (KP9)
3 MAIN_MENU Return to the main menu (PF1,KP minus)
3 EXPOSE Start an exposure (KP5)
(open shutter for a specified number of seconds)
3 VALVES Operate the gas valves (KP6)
3 DETENT Operate the detents. (KP7 comma)
3 CMD Send a command to the TAURUS-2 microprocessor (KP 1)
3 PASSTHROUGH Stop interpreting messages from micro (KP2)
All messages from the micro will be displayed but
not interpreted
3 STOP PASSTHROUGH Revert to interpreting messages from the microprocessor (KP3)
3 LOG Enable/disable logging of microprocessor communications (KP4)
(F17 = LOG BOTH)
2 DETENT_MOD
The state is selected while the detent motors are being repositioned.
Since the state should not be changed while in this state, the state
change commands are disabled. Other commands are as per the MISC state.
When there is not longer any motors being moved the state is returned
to MISC.
2 PANIC
This state is entered after reception of a panic interrupt message.
3 PANIC Continue after panic. (PF1)
Any motor that was panic stopped will be returned to its correct position
The shutter will be closed.
2 PANIC_RECOVERY
This state is entered while reseting taurus after a panic interrupt. When
all motors are in there correct position state will revert to the MAIN_MENU.