MTDome¶
Note
This page is generated by python script generate_cet.py.
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 elevation.
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 dome to the specified azimuth position and start moving at the specified, constant velocity from there.
- 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
resetDrivesAz¶
Description: Reset one or more AZ drives. This is necessary when exiting from FAULT state without going to Degraded Mode since the drives don’t reset themselves.
- EFDB_Topic
MTDome_command_resetDrivesAz
reset¶
- IDL_Type
boolean
- Units
unitless
- Count
5
Description: Desired reset action to execute on each AZ drive: false means don’t reset, true means reset.
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 subsystems.
- 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.
setZeroAz¶
Description: Take the current position of the dome as zero. This is necessary as long as the racks and pinions on the drives have not been installed yet to compensate for slippage of the drives.
- EFDB_Topic
MTDome_command_setZeroAz
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
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: If the CSC itself has sub-ordinate components, they may be listed here. An empty string means the setting applies to all such sub-ordinate components, or just to the CSC itself.
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
configurationOverride¶
- IDL_Type
string
- Units
unitless
- Description:
Configuration override in the form [{name}][:{version}]. For salobj-based CSCs: name is a filename with “.yaml” suffix and version is a git hash; for example:
“foo.yaml” specifies just a file. Two or three config files are loaded: “_init.yaml”, “_{site}.yaml” (if present), and “foo.yaml”.
“:37bf936” specifies just a git hash. One or two config files are loaded from the specified git commit: “_init.yaml” and “_{site}.yaml” (if present.
“bar.yaml:HEAD~2” specifies both a file and a git hash. Two or three config files are read from the specified git commit: “_init.yaml”, “_{site}.yaml” (if present), and “bar.yaml”.
Enumerations¶
- EnabledState
Disabled
Enabled
Fault
- MotionState
Closed
Crawling
Moving
Open
Parked
Parking
Stopped
Stopping
Stopping_Braking
Stopped_Braked
Brakes_Disengaged
Brakes_Engaged
Deflated
Deflating
Disabling_Motor_Power
Disengaging_Brakes
Enabling_Motor_Power
Engaging_Brakes
Go_Degraded
Go_Normal
Go_Stationary
Inflated
Inflating
Lp_Disengaged
Lp_Disengaging
Lp_Engaged
Lp_Engaging
Motor_Cooling_Off
Motor_Cooling_On
Motor_Power_Off
Motor_Power_On
Starting_Motor_Cooling
Stopping_Motor_Cooling
- 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
N2=33
- SubSystemId
AMCS=0x1
LWSCS=0x2
APSCS=0x4
LCS=0x8
THCS=0x10
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.
authList¶
- EFDB_Topic
SALGeneric_logevent_authList
- Category
csc
configurationApplied¶
Description: Information about CSC’s configuration.
- EFDB_Topic
SALGeneric_logevent_configurationApplied
- Category
configurable
configurations¶
- IDL_Type
string
- Units
unitless
Description: A comma-separated list of configurations applied. If configuration comes from a clone of a git repo, or similar directory, then it will be a list of file names, without the file extension. Ignore whitespace after commas.
version¶
- IDL_Type
string
- Units
unitless
Description: Version of the configuration source. For a clone of a git repo it will be a git hash.
url¶
- IDL_Type
string
- Units
unitless
Description: URL of the configuration source. For a clone of a git repo this will be a file URL. For a database it will be a standard database URL. This should always match the same-named field in configurationsAvailable.
schemaVersion¶
- IDL_Type
string
- Units
unitless
Description: Version of config schema used by the CSC. For a configuration git repo, this is the name of a folder in the config package, and is typically something like “v1”. This should always match the same-named field in configurationsAvailable.
otherInfo¶
- IDL_Type
string
- Units
unitless
Description: A comma-separated list of event topics (without the logevent prefix) used to publish the entire set of configuration parameters loaded by the CSC, and any other pertinent information. Ignore whitespace after commas.
configurationsAvailable¶
Description: Information about the source of configuration information for the CSC.
- EFDB_Topic
SALGeneric_logevent_configurationsAvailable
- Category
configurable
overrides¶
- IDL_Type
string
- Units
unitless
Description: Available overrides as a comma-separated list. Each entry is a possible value of the configurationOverride field of the start command. Ignore whitespace after commas.
version¶
- IDL_Type
string
- Units
unitless
Description: Version of the configuration source. For a clone of a git repo it will be a git hash.
url¶
- IDL_Type
string
- Units
unitless
Description: URL of the configuration source. For a clone of a git repo this will be a file URL. For a database it will be a standard database URL.
schemaVersion¶
- IDL_Type
string
- Units
unitless
Description: Version of config schema used by the CSC. For a configuration git repo, this is the name of a folder in the config package, and is typically something like “v1”.
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: If the CSC itself has sub-ordinate components, they may be listed here. An empty string means the setting applies to all such sub-ordinate components, or just to the CSC itself.
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.
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).