ATSpectrograph

Note

This page is generated by python script generate_cet.py.

Back to table

Commands

changeDisperser

EFDB_Topic

ATSpectrograph_command_changeDisperser

disperser

IDL_Type

long

Units

unitless

Description: ID of the disperser/grating slot to select corresponding to the markings on the disperser wheel (0 through 3)

name

IDL_Type

string

IDL_Size

256

Units

unitless

Description: Name of the grating to select. Command gets rejected if both are set.

changeFilter

EFDB_Topic

ATSpectrograph_command_changeFilter

filter

IDL_Type

long

Units

unitless

Description: ID of the filter slot to select corresponding to the markings on the filter wheel (0 through 3)

name

IDL_Type

string

IDL_Size

256

Units

unitless

Description: Name of the filter to select. Command gets rejected if both are set.

homeLinearStage

EFDB_Topic

ATSpectrograph_command_homeLinearStage

value

IDL_Type

boolean

Units

unitless

Description: Needed by the SAL API, but is unused.

moveLinearStage

EFDB_Topic

ATSpectrograph_command_moveLinearStage

distanceFromHome

IDL_Type

double

Units

mm

Description: The distance from home.

stopAllAxes

EFDB_Topic

ATSpectrograph_command_stopAllAxes

value

IDL_Type

boolean

Units

unitless

Description: Needed by the SAL API, but is unused.

disable

Description: Transition from state Enabled to Disabled.

EFDB_Topic

SALGeneric_command_disable

Category

csc

enable

Description: Transition from state Disabled to Enabled.

EFDB_Topic

SALGeneric_command_enable

Category

csc

exitControl

Description: Transition from state Standby to Offline. For CSCs that start in Standby state this makes the CSC quit. CSCs that start in Offline state, they remain active.

EFDB_Topic

SALGeneric_command_exitControl

Category

csc

setAuthList

EFDB_Topic

SALGeneric_command_setAuthList

Category

csc

authorizedUsers

IDL_Type

string

Units

unitless

Description: Comma seperated list of authorized users currently allowed to command this CSC,

in the form user@host. If the first character is +/- then the specified users are added/removed. Duplicates are silently ignored. The CSC’s own user@host is silently ignored, because it is always authorized. For removal, CSCs that are not in the list are silently ignored. Whitespace is allowed after the optional initial +/- and after each comma.

nonAuthorizedCSCs

IDL_Type

string

Units

unitless

Description: Comma seperated list of CSC’s not currently allowed to command this CSC,

in the form name[:index]. An index of 0 is stripped (name:0 becomes name). If the first character is +/- then the specified CSCs are added/removed. Duplicates are silently ignored. For removal, CSCs that are not in the list are silently ignored. Whitespace is allowed after the optional initial +/- and after each comma.

setLogLevel

Description: Set the logging level.

EFDB_Topic

SALGeneric_command_setLogLevel

Category

csc

level

IDL_Type

int

Units

unitless

Description: Logging level, as a Python logging level: error=40, warning=30, info=20, debug=10.

subsystem

IDL_Type

string

Units

unitless

Description: Subsystem this applies to. If empty, the change applies to all subsystems. Beyond that, the meaning depends on the CSC.

standby

Description: Transition from state Offline, Disabled or Fault to Standby.

EFDB_Topic

SALGeneric_command_standby

Category

csc

start

Description: Transition from state Standby to Disable, in a specified configuration.

EFDB_Topic

SALGeneric_command_start

Category

csc

settingsToApply

IDL_Type

string

IDL_Size

256

Units

unitless

Description: Name of the selected settings set

Enumerations

Status
Error
Port

  • Nasmyth1

  • Nasmyth2

Events

detailedState

EFDB_Topic

ATSpectrograph_logevent_detailedState

detailedState

IDL_Type

long

Units

unitless

Description: The substate of the CSC.

disperserInPosition

EFDB_Topic

ATSpectrograph_logevent_disperserInPosition

inPosition

IDL_Type

boolean

Units

unitless

Description: Is the grating/disperser in position?

filterInPosition

EFDB_Topic

ATSpectrograph_logevent_filterInPosition

inPosition

IDL_Type

boolean

Units

unitless

Description: Is the filter in position?

fwState

EFDB_Topic

ATSpectrograph_logevent_fwState

state

IDL_Type

long

Units

unitless

Description: The state of the filter wheel.

gwState

EFDB_Topic

ATSpectrograph_logevent_gwState

state

IDL_Type

long

Units

unitless

Description: The state of the disperser.

linearStageInPosition

EFDB_Topic

ATSpectrograph_logevent_linearStageInPosition

inPosition

IDL_Type

boolean

Units

unitless

Description: Is the linear stage in position?

lsState

EFDB_Topic

ATSpectrograph_logevent_lsState

state

IDL_Type

long

Units

unitless

Description: The state of the linear stage.

reportedDisperserPosition

EFDB_Topic

ATSpectrograph_logevent_reportedDisperserPosition

slot

IDL_Type

long

Units

unitless

Description: The numbered slot indicated on the grating/disperser wheel (0 through 3).

name

IDL_Type

string

IDL_Size

256

Units

unitless

Description: Name of the physical grating/disperser in the beam. Should be a unique identifier for the specific disperser.

band

IDL_Type

string

IDL_Size

256

Units

unitless

Description: Descriptive name associated with the grating/disperser in the beam (e.g. R100).

focusOffset

IDL_Type

float

Units

mm

Description: Focus offset to be applied on the secondary mirror in units of mm, relative to no glass

being installed. Positive values push the secondary down and increase the back focal distance, therefore adding glass thickness will result in positive focus offsets.

pointingOffsets

IDL_Type

float

Units

arcsec

Count

2

Description: Pointing offset to be applied to the boresight in units of arcseconds, relative

to no glass being installed. Relative to the center of the detector,positive X-values result in moving along rows, to higher pixel values

reportedFilterPosition

EFDB_Topic

ATSpectrograph_logevent_reportedFilterPosition

slot

IDL_Type

long

Units

unitless

Description: The numbered slot indicated on the filter wheel (0 through 3).

name

IDL_Type

string

IDL_Size

256

Units

unitless

Description: Name of the physical filter in the beam. Should be a unique identifier for the specific filter.

band

IDL_Type

string

IDL_Size

256

Units

unitless

Description: Descriptive bandpass associated with the filter in the beam (e.g. u,g,r,i,z,y).

centralWavelength

IDL_Type

float

Units

nm

Description: Wavelength for which optical system will be optimized in units of nm.

Approximations are sufficient as the focus dependence on wavelength is weak.

focusOffset

IDL_Type

float

Units

mm

Description: Focus offset to be applied on the secondary mirror in units of mm, relative to no glass

being installed. Positive values push the secondary down and increase the back focal distance, therefore adding glass thickness will result in positive focus offsets.

pointingOffsets

IDL_Type

float

Units

arcsec

Count

2

Description: Pointing offset to be applied to the boresight in units of arcseconds, relative

to no glass being installed. Relative to the center of the detector,positive X-values result in moving along rows, to higher pixel values

reportedLinearStagePosition

EFDB_Topic

ATSpectrograph_logevent_reportedLinearStagePosition

position

IDL_Type

float

Units

mm

Description: The reported linear stage position.

settingsAppliedValues

EFDB_Topic

ATSpectrograph_logevent_settingsAppliedValues

host

IDL_Type

string

IDL_Size

16

Units

unitless

Description: IP of the controller in the format XXX.XXX.XXX.XXX

port

IDL_Type

long

Units

unitless

Description: Port to connect to controller.

connectionTimeout

IDL_Type

float

Units

second

Description: How long to wait for a response from the low level controller when establishing the connection.

responseTimeout

IDL_Type

float

Units

second

Description: How long to wait for a response from low level controller when a command

or request is sent.

moveTimeout

IDL_Type

float

Units

second

Description: How long to wait for a move command to complete, for filter/grating wheels and linear stage.

linearStageMinPos

IDL_Type

float

Units

mm

Description: The minimum linear stage position.

linearStageMaxPos

IDL_Type

float

Units

mm

Description: The maximum linear stage position.

linearStageSpeed

IDL_Type

float

Units

mm/s

Description: The speed of the linear stage.

filterNames

IDL_Type

string

IDL_Size

256

Units

unitless

Description: Comma separated list of filter names.

filterCentralWavelengths

IDL_Type

string

IDL_Size

256

Units

unitless

Description: Comma separated list of filter central wavelengths.

filterFocusOffsets

IDL_Type

string

IDL_Size

256

Units

unitless

Description: Comma separated list of filter focus offsets to be applied to the hexapod [in mm].

filterPointingOffsets

IDL_Type

string

IDL_Size

256

Units

unitless

Description: Comma separated list of [X,Y] filter pointing offsets to be applied to boresight [in arcsec].

gratingNames

IDL_Type

string

IDL_Size

256

Units

unitless

Description: Comma separated list of disperser/grating names.

gratingFocusOffsets

IDL_Type

string

IDL_Size

256

Units

unitless

Description: Comma separated list of disperser/grating focus offsets to be applied to the hexapod [in mm].

gratingPointingOffsets

IDL_Type

string

IDL_Size

256

Units

unitless

Description: Comma separated list of [X,Y] grating pointing offsets to be applied to boresight [in arcsec].

instrumentPort

IDL_Type

long

Units

unitless

Description: Port the instrument is mounted in.

appliedSettingsMatchStart

EFDB_Topic

SALGeneric_logevent_appliedSettingsMatchStart

Category

configurable

appliedSettingsMatchStartIsTrue

IDL_Type

boolean

Units

unitless

Description: True when the configuration matches the start conditions

authList

EFDB_Topic

SALGeneric_logevent_authList

Category

csc

authorizedUsers

IDL_Type

string

Units

unitless

Description: Comma seperated list of authorized users currently allowed to command this CSC.

nonAuthorizedCSCs

IDL_Type

string

Units

unitless

Description: Comma seperated list of CSC’s not currently allowed to command this CSC.

errorCode

Description: Output when a CSC goes into the Fault state as an explanation of the problem.

EFDB_Topic

SALGeneric_logevent_errorCode

Category

csc

errorCode

IDL_Type

long

Units

unitless

Description: A numeric error code

errorReport

IDL_Type

string

Units

unitless

Description: An string providing detailed information about the error

traceback

IDL_Type

string

Units

unitless

Description: An optional stack trace of the error condition

heartbeat

EFDB_Topic

SALGeneric_logevent_heartbeat

Category

mandatory

heartbeat

IDL_Type

boolean

Units

unitless

Description: Beats the drum.

logLevel

Description: Current logging level.

EFDB_Topic

SALGeneric_logevent_logLevel

Category

mandatory

level

IDL_Type

int

Units

unitless

Description: Current logging level, a Python logging level: error=40, warning=30, info=20, debug=10.

subsystem

IDL_Type

string

Units

unitless

Description: Subsystem this applies to. The empty string if all subsystems. Beyond that, the meaning depends on the CSC.

logMessage

Description: A log message.

EFDB_Topic

SALGeneric_logevent_logMessage

Category

mandatory

name

IDL_Type

string

Units

unitless

Description: Log name.

level

IDL_Type

int

Units

unitless

Description: Message level, a Python logging level: error=40, warning=30, info=20, debug=10.

message

IDL_Type

string

Units

unitless

Description: Log message.

traceback

IDL_Type

string

Units

unitless

Description: Exception traceback; “” if not an exception.

filePath

IDL_Type

string

Units

unitless

Description: Path to source file.

functionName

IDL_Type

string

Units

unitless

Description: Function or method name.

lineNumber

IDL_Type

long

Units

unitless

Description: Line number in the file specified by filePath.

process

IDL_Type

long

Units

unitless

Description: Process ID.

timestamp

IDL_Type

double

Units

second

Description: The time at which the condition being reported was observed (TAI unix seconds). 0 if unspecified.

settingVersions

Description: Information about settings which can be specified in the start command.

EFDB_Topic

SALGeneric_logevent_settingVersions

Category

configurable

recommendedSettingsVersion

IDL_Type

string

Units

unitless

Description: List of comma seperated recomended versions of settings sets

recommendedSettingsLabels

IDL_Type

string

Units

unitless

Description: List of comma seperated names of settings sets

settingsUrl

IDL_Type

string

Units

unitless

Description: The URL where the settings sets definitions can be found

settingsApplied

Description: Base settings applied.

EFDB_Topic

SALGeneric_logevent_settingsApplied

Category

configurable

settingsVersion

IDL_Type

string

IDL_Size

256

Units

unitless

Description: The SHA or name corresponding to the published configuration

otherSettingsEvents

IDL_Type

string

Units

unitless

Description: A comma delimited list of other specific CSC configuration events. This may be blank if no other CSC specific events are necessary

simulationMode

Description: Current simulation mode.

EFDB_Topic

SALGeneric_logevent_simulationMode

Category

csc

mode

IDL_Type

int

Units

unitless

Description: Current simulation mode; 0 for normal operation (no simulation); other supported values are specific to each CSC.

softwareVersions

Description: Current versions of software in use by CSC.

EFDB_Topic

SALGeneric_logevent_softwareVersions

Category

mandatory

salVersion

IDL_Type

string

IDL_Size

256

Units

unitless

Description: This is the current version of SAL generation

xmlVersion

IDL_Type

string

IDL_Size

256

Units

unitless

Description: This is the current version of CSC XML

openSpliceVersion

IDL_Type

string

IDL_Size

256

Units

unitless

Description: This is the current version of OpenSplice

cscVersion

IDL_Type

string

IDL_Size

256

Units

unitless

Description: This is the top-level version of the CSC

subsystemVersions

IDL_Type

string

Units

unitless

Description: A comma delimited list of key=value pairs relating subsystem name (key) to its version number (value). This may be left blank if there are no subsystems within a CSC

summaryState

Description: Current summary state of the CSC

EFDB_Topic

SALGeneric_logevent_summaryState

Category

csc

summaryState

IDL_Type

long

Units

unitless

Description: High level state machine state identifier