MTDome

Note

This page is generated by python script generate_cet.py.

Back to table

Commands

closeLouvers

Description: Close all louvers.

EFDB_Topic

MTDome_command_closeLouvers

closeShutter

Description: Close the shutter.

EFDB_Topic

MTDome_command_closeShutter

crawlAz

Description: Move the azimuth axis at constant velocity.

EFDB_Topic

MTDome_command_crawlAz

velocity

IDL_Type

double

Units

deg/second

Description: The velocity. Positive is the direction of increasing azimuth.

crawlEl

Description: Move the elevation axis (light/wind screen) at constant velocity.

EFDB_Topic

MTDome_command_crawlEl

velocity

IDL_Type

double

Units

deg/second

Description: The velocity. Positive is the direction of increasing azimuth.

exitFault

Description: Indicate that all hardware errors, leading to fault state, have been resolved for the indicated subsystem(s).

EFDB_Topic

MTDome_command_exitFault

subSystemIds

IDL_Type

int

Units

unitless

Description: Bitmask of SubSystemId.

moveAz

Description: Move the azimuth axis at constant velocity, starting from a specified position.

EFDB_Topic

MTDome_command_moveAz

position

IDL_Type

double

Units

deg

Description: The position.

velocity

IDL_Type

double

Units

deg/second

Description: The velocity. Positive is the direction of increasing azimuth.

moveEl

Description: Move the elevation axis (light/wind screen) to a specified position.

EFDB_Topic

MTDome_command_moveEl

position

IDL_Type

double

Units

deg

Description: The position.

openShutter

Description: Open the shutter.

EFDB_Topic

MTDome_command_openShutter

park

Description: Move all components to park position and engage the brakes and locking pins.

EFDB_Topic

MTDome_command_park

setLouvers

Description: Move one or more louvers. The Louver enumeration describes the louver indices.

EFDB_Topic

MTDome_command_setLouvers

position

IDL_Type

float

Units

unitless

Count

34

Description: Desired percent open of each louver: 0 is fully closed, 100 is fully open, -1 is don’t move.

setOperationalMode

Description: Set the OperationalMode for the indicated subsytems.

EFDB_Topic

MTDome_command_setOperationalMode

operationalMode

IDL_Type

int

Units

unitless

Description: Operational mode; an OperationalMode enum.

subSystemIds

IDL_Type

int

Units

unitless

Description: Bitmask of SubSystemId.

setTemperature

Description: Set the desired temperature of the MTDome heat sources (motors and cabinets).

EFDB_Topic

MTDome_command_setTemperature

temperature

IDL_Type

double

Units

deg_C

Description: Desired temperature.

stop

Description: For all indicated subsystems that are moving: stop the motion and then optionally apply the brakes. For all indicated subsystems that are not moving: disengage the locking pins (unparking the dome) and engage or disengage the brakes.

EFDB_Topic

MTDome_command_stop

engageBrakes

IDL_Type

boolean

Units

unitless

Description: Engage the brakes (true) or not (false).

subSystemIds

IDL_Type

int

Units

unitless

Description: Bitmask of SubSystemId.

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

EnabledState

• Disabled

• Enabled

• Fault

MotionState

• Closed

• Crawling

• Moving

• Open

• Parked

• Parking

• Stopped

• :any:`Stopping

<lsst.ts.idl.enums.MTDome.MotionState.STOPPING

>`

Louver

• A1=0

• A2=1

• B1=2

• B2=3

• B3=4

• C1=5

• C2=6

• C3=7

• D1=8

• D2=9

• D3=10

• E1=11

• E2=12

• E3=13

• F1=14

• F2=15

• F3=16

• G1=17

• G2=18

• G3=19

• H1=20

• H2=21

• H3=22

• I1=23

• I2=24

• I3=25

• L1=26

• L2=27

• L3=28

• M1=29

• M2=30

• M3=31

• N1=32

• :any:`N2=33

  <lsst.ts.idl.enums.MTDome.Louver.N2=33

  >`

SubSystemId

• AMCS=0x1

• LWSCS=0x2

• APSCS=0x4

• LCS=0x8

• THCS=0x10

• :any:`MONCS=0x20

<lsst.ts.idl.enums.MTDome.SubSystemId.MONCS=0X20

>`

OperationalMode

• Normal

• Degraded

Events

azEnabled

Description: Azimuth axis enabled state.

EFDB_Topic

MTDome_logevent_azEnabled

state

IDL_Type

int

Units

unitless

Description: Enabled state; an EnabledState enum.

faultCode

IDL_Type

string

Units

unitless

Description: The fault code; ignore if not in Fault state.

azMotion

Description: Azimuth axis motion state.

EFDB_Topic

MTDome_logevent_azMotion

state

IDL_Type

int

Units

unitless

Description: The motion state; a MotionState enum.

inPosition

IDL_Type

boolean

Units

unitless

Description: Is the axis in position?

azTarget

Description: Azimuth axis target position and velocity.

EFDB_Topic

MTDome_logevent_azTarget

position

IDL_Type

float

Units

deg

Description: Target position; nan for the crawlAz command.

velocity

IDL_Type

float

Units

deg/second

Description: Target velocity.

brakesEngaged

EFDB_Topic

MTDome_logevent_brakesEngaged

brakes

IDL_Type

int

Units

unitless

Description: Bitmask of brakes that are engaged.

The bits are defined by the Brake enum.

elEnabled

Description: Elevation axis (wind baffle/light screen) enabled state.

EFDB_Topic

MTDome_logevent_elEnabled

state

IDL_Type

int

Units

unitless

Description: Enabled state; an EnabledState enum.

faultCode

IDL_Type

string

Units

unitless

Description: The fault code; ignore if not in Fault state.

elMotion

Description: Elevation axis (light/wind screen) motion state.

EFDB_Topic

MTDome_logevent_elMotion

state

IDL_Type

int

Units

unitless

Description: The motion state; a MotionState enum.

inPosition

IDL_Type

boolean

Units

unitless

Description: Is the axis in position?

elTarget

Description: Elevation axis (light/wind screen) target position and velocity.

EFDB_Topic

MTDome_logevent_elTarget

position

IDL_Type

float

Units

deg

Description: Target position; nan for the crawlEl command.

velocity

IDL_Type

float

Units

deg/second

Description: Target velocity; 0 for the moveEl command.

interlocks

EFDB_Topic

MTDome_logevent_interlocks

interlocks

IDL_Type

int

Units

unitless

Description: Bitmask of safety interlocks that are latched.

The bits are defined by the Interlock enum.

lockingPinsEngaged

EFDB_Topic

MTDome_logevent_lockingPinsEngaged

engaged

IDL_Type

int

Units

unitless

Description: Bitmask of locking pins that have been engaged.

The bits are defined by the LockingPin enum.

operationalMode

Description: OperationalMode change.

EFDB_Topic

MTDome_logevent_operationalMode

operationalMode

IDL_Type

int

Units

unitless

Description: Operational mode; an OperationalMode enum.

subSystemId

IDL_Type

int

Units

unitless

Description: The subsystem, as a single SubSystemID value.

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

Telemetry

apertureShutter

EFDB_Topic

MTDome_apertureShutter

positionActual

IDL_Type

float

Units

unitless

Count

2

Description: Measured position of the aperture shutter (percent open).

positionCommanded

IDL_Type

float

Units

unitless

Description: Commanded position of the aperture shutter (percent open).

driveTorqueActual

IDL_Type

float

Units

J

Count

4

Description: Measured torque for each aperture shutter drive.

driveTorqueCommanded

IDL_Type

float

Units

J

Count

4

Description: Commanded torque for each aperture shutter drive.

driveCurrentActual

IDL_Type

float

Units

A

Count

4

Description: Measured current drawn by each aperture shutter drive.

driveTemperature

IDL_Type

float

Units

deg_C

Count

4

Description: Measured temperature of each aperture shutter drive/motors.

resolverHeadRaw

IDL_Type

float

Units

unitless

Count

4

Description: Raw value of each aperture shutter drive resolver.

resolverHeadCalibrated

IDL_Type

float

Units

deg

Count

4

Description: Calibrated value of each aperture shutter drive resolver.

powerDraw

IDL_Type

float

Units

W

Description: Total power drawn by all shutter drives.

timestamp

IDL_Type

double

Units

second

Description: Time at which the data was determined (TAI unix seconds).

azimuth

Description: Status of the azimuth axis and drives.

EFDB_Topic

MTDome_azimuth

positionActual

IDL_Type

float

Units

deg

Description: Measured azimuth axis position.

positionCommanded

IDL_Type

float

Units

deg

Description: Commanded azimuth azimuth position.

velocityActual

IDL_Type

float

Units

deg/second

Description: Measured azimuth axis velocity.

velocityCommanded

IDL_Type

float

Units

deg/second

Description: Commanded azimuth axis velocity.

driveTorqueActual

IDL_Type

float

Units

J

Count

5

Description: Measured torque for each azimuth drive.

driveTorqueCommanded

IDL_Type

float

Units

J

Count

5

Description: Commanded torque for each azimuth drive.

driveCurrentActual

IDL_Type

float

Units

A

Count

5

Description: Measured current drawn by each azimuth drive.

driveTemperature

IDL_Type

float

Units

deg_C

Count

13

Description: Measured temperature of each azimuth drive.

encoderHeadRaw

IDL_Type

float

Units

unitless

Count

5

Description: Raw readout of each azimuth encoder head.

encoderHeadCalibrated

IDL_Type

float

Units

deg

Count

5

Description: Calibrated readout of each azimuth encoder head.

barcodeHeadRaw

IDL_Type

float

Units

unitless

Count

3

Description: Raw readout of each azimuth position encoder.

barcodeHeadCalibrated

IDL_Type

float

Units

deg

Count

3

Description: Calibrated readout of each azimuth position encoder.

barcodeHeadWeighted

IDL_Type

float

Units

deg

Count

3

Description: Weighted values of each azimuth position encoder that enter the control loop.

timestamp

IDL_Type

double

Units

second

Description: Time at which the data was determined (TAI unix seconds).

interlocks

Description: Status of the global interlock system.

EFDB_Topic

MTDome_interlocks

data

IDL_Type

float

Units

unitless

Count

16

Description: Safety monitoring.

timestamp

IDL_Type

double

Units

second

Description: Time at which the data was determined (TAI unix seconds).

lightWindScreen

Description: Status of the light/wind screen (elevation axis).

EFDB_Topic

MTDome_lightWindScreen

positionActual

IDL_Type

float

Units

deg

Description: Measured position of the light/wind screen.

positionCommanded

IDL_Type

float

Units

deg

Description: Commanded position of the light/wind screen.

velocityActual

IDL_Type

float

Units

deg/second

Description: Measured velocity of the light/wind screen.

velocityCommanded

IDL_Type

float

Units

deg/second

Description: Commanded velocity of the light/wind screen.

driveTorqueActual

IDL_Type

float

Units

J

Count

2

Description: Measured torque of each light/wind screen drive.

driveTorqueCommanded

IDL_Type

float

Units

J

Count

2

Description: Commanded torque of each light/screen drive.

driveCurrentActual

IDL_Type

float

Units

A

Count

2

Description: Measured current drawn by each light/wind screen drive.

driveTemperature

IDL_Type

float

Units

deg_C

Count

2

Description: Temperature of each light/wind screen drive.

encoderHeadRaw

IDL_Type

float

Units

unitless

Count

2

Description: Raw value of each light/wind screen encoder.

encoderHeadCalibrated

IDL_Type

float

Units

deg

Count

2

Description: Calibrated value of each light/wind screen encoder.

resolverRaw

IDL_Type

float

Units

unitless

Count

2

Description: Raw value of each light/wind screen resolver.

resolverCalibrated

IDL_Type

float

Units

deg

Count

2

Description: Calibrated value of each light/wind screen resolver.

powerDraw

IDL_Type

float

Units

W

Description: Total power drawn by all light/wind screen drives.

timestamp

IDL_Type

double

Units

second

Description: Time at which the data was determined (TAI unix seconds).

louvers

Description: Status of the louvers. The Louver enumeration describes the louver indices. Each louver has two drives and the drive indices for louver N are 2N and 2N+1.

EFDB_Topic

MTDome_louvers

positionActual

IDL_Type

float

Units

unitless

Count

34

Description: Measured position of each louver (percent open).

positionCommanded

IDL_Type

float

Units

unitless

Count

34

Description: Commanded position of each louver (percent open).

driveTorqueActual

IDL_Type

float

Units

J

Count

68

Description: Actual torque for each louver drive.

driveTorqueCommanded

IDL_Type

float

Units

J

Count

68

Description: Commanded torque for each louver drive.

driveCurrentActual

IDL_Type

float

Units

A

Count

68

Description: Actual current drawn by each louver drive.

driveTemperature

IDL_Type

float

Units

deg_C

Count

68

Description: Measured temperature of each louver drive.

encoderHeadRaw

IDL_Type

float

Units

unitless

Count

68

Description: Raw value of each louver drive encoder.

encoderHeadCalibrated

IDL_Type

float

Units

deg

Count

68

Description: Calibrated value of each louver drive encoder.

powerDraw

IDL_Type

float

Units

W

Description: Total power drawn by all louver drives.

timestamp

IDL_Type

double

Units

second

Description: Time at which the data was determined (TAI unix seconds).

thermal

EFDB_Topic

MTDome_thermal

temperature

IDL_Type

float

Units

deg_C

Count

13

Description: Measured temperature of each heat source.

timestamp

IDL_Type

double

Units

second

Description: Time at which the data was determined (TAI unix seconds).