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.