DREAM¶
Note
This page is generated by python script generate_cet.py
.
Commands¶
pause¶
- Description:
Operator triggered pause in the operations. If issued while the DREAM dome is opened, the dome shall close and observation either stopped or switched to acquire calibration data.
- EFDB_Topic:
DREAM_command_pause
resume¶
- Description:
Operator triggered resume of the operations. If issued while dome is closed and weather is within limits for operations, dome shall open.
- EFDB_Topic:
DREAM_command_resume
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. Most CSCs will quit, but CSCs that support the enterControl command will keep running.
- EFDB_Topic:
SALGeneric_command_exitControl
- 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 this 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 this CSC itself.
standby¶
Description: Transition from state Offline/Available, 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¶
- Camera:
East=0
West=1
North=2
Central=3
South=4
- CameraServerMode:
Auto=0
Idle=1
Standby=2
Blanks=3
Bias=4
Flats=5
Darks=6
Science=7
Shutdown=8
- DomeTargetState:
Auto=0
Open=1
Closed=2
Stop=3
ForceOpen=4
- DomeState:
Open=0
Closed=1
Opening=2
Closing=3
Stop=4
- HeaterState:
Auto=0
On=1
Off=2
Unknown=3
- PeltierState:
Auto=0
Cool=1
Heat=2
Off=3
Unknown=4
- Warning:
PowersavingActivated=0x01
UpsOnBattery=0x02
DomeClosedByNogo=0x04
DomeClosedBySun=0x08
DomeClosedByEnv=0x10
DomeClosedByUps=0x20
DomeClosedByTimer=0x40
DomeStopped=0x80
DomeForcedOped=0x100
DomeClosedByDoor=0x200
RubinNoClient=0x400
RubinMultipleClients=0x800
RubinClientStale=0x1000
RubinWeatherTooOld=0x2000
RubinBadWeather=0x4000
RubinNogo=0x8000
ScriptClientActive=0x10000
InletHumWarning=0x20000
InletTempWarning=0x40000
CameraNNotConnected=0x80000
CameraSNotConnected=0x100000
CameraENotConnected=0x200000
CameraWNotConnected=0x400000
CameraCNotConnected=0x800000
SimulatedDome=0x1000000
SimulatedLeds=0x2000000
SimulatedUps=0x4000000
SimulatedPdu=0x8000000
SimulatedEnv=0x10000000
SimulatedSun=0x20000000
- Error:
LimitSwitchError=0x01
DomeError=0x02
BackdoorOpen=0x04
DoorOpen=0x08
UpsError=0x10
Pdu1Error=0x20
Pdu2Error=0x40
TemphumError=0x80
PsuError=0x100
UpsBatteryNeedsReplace=0x200
CameraBayTempError=0x400
CameraBayHumError=0x800
ElectronicsHumidityError=0x1000
DomeHumidityError=0x2000
- Weather:
WeatherBad=0x001
WindBad=0x002
HumidityBad=0x004
PrecipitationBad=0x008
Events¶
alerts¶
Description: DREAM alerts.
- EFDB_Topic:
DREAM_logevent_alerts
outsideHumidity¶
- IDL_Type:
boolean
- Units:
unitless
Description: True if outside humidity, reported by the observatory, is outside safe limits.
outsideTemperature¶
- IDL_Type:
boolean
- Units:
unitless
Description: True if outside temperature, reported by the observatory, is outside safe limits.
camera¶
Description: DREAM camera imaging events. Each event corresponds to an exposure.
- EFDB_Topic:
DREAM_logevent_camera
source¶
- IDL_Type:
int
- Units:
unitless
Description: The camera that is the source of this event. A Camera enumeration.
cameraMode¶
- IDL_Type:
int
- Units:
unitless
Description: Current operating mode of the camera. A CameraServerMode enumeration.
nBlank¶
- IDL_Type:
int
- Units:
unitless
- Description:
Number of images of type “blank” collected by the camera. These images are not saved but their collection is recorded for completeness.
nDark¶
- IDL_Type:
int
- Units:
unitless
Description: Number of dark images collected by the camera.
nBias¶
- IDL_Type:
int
- Units:
unitless
Description: Number of bias images collected by the camera.
nFlat¶
- IDL_Type:
int
- Units:
unitless
Description: Number of flat field images collected by the camera.
nScience¶
- IDL_Type:
int
- Units:
unitless
Description: Number of science images collected by the camera.
nMissed¶
- IDL_Type:
int
- Units:
unitless
Description: Number of images that were “missed” by the pipeline.
lastSequenceNumber¶
- IDL_Type:
int
- Units:
unitless
Description: Sequence number of the most recent collected image.
lastTriggerTime¶
- IDL_Type:
float
- Units:
second
Description: Trigger time (TAI) of the most recent collected image.
lastImageTimingLatency¶
- IDL_Type:
float
- Units:
second
Description: Timing latency of the most recent collected image.
lastImageUSBLatency¶
- IDL_Type:
float
- Units:
second
Description: USB latency of the most recent collected image.
lastImageArtificialLatency¶
- IDL_Type:
float
- Units:
second
Description: Artificial latency of the most recent collected image.
lastImageType¶
- IDL_Type:
int
- Units:
unitless
Description: Image type of the most recent collected image. A CameraServerMode enumeration.
lastImagePixelMedian¶
- IDL_Type:
float
- Units:
unitless
Description: Median pixel value of the most recent collected image.
errors¶
Description: DREAM alerts.
- EFDB_Topic:
DREAM_logevent_errors
domeHumidity¶
- IDL_Type:
boolean
- Units:
unitless
Description: True if dome humidity is outside safe range.
enclosureTemperature¶
- IDL_Type:
boolean
- Units:
unitless
Description: True if enclosure temperature is outside safe range.
enclosureHumidity¶
- IDL_Type:
boolean
- Units:
unitless
Description: True if enclosure humidity is outside safe range.
electronicsBoxCommunication¶
- IDL_Type:
boolean
- Units:
unitless
Description: True if electronics box cannot be reached.
temperatureSensorCommunication¶
- IDL_Type:
boolean
- Units:
unitless
- Count:
3
Description: True if given temperature sensor doesn’t provide temperature updates.
domePositionUnknown¶
- IDL_Type:
boolean
- Units:
unitless
Description: True if dome position as reported by the absolute encoder is unknown, and therefore system cannot operate the dome.
daqCommunication¶
- IDL_Type:
boolean
- Units:
unitless
Description: True if communication with DAQ (Data Acquisition) is lost.
pduCommunication¶
- IDL_Type:
boolean
- Units:
unitless
Description: True if communication with the Power Distribution Unit (PDU) is lost.
powerSupply¶
Description: Power supply error events.
- EFDB_Topic:
DREAM_logevent_powerSupply
temperatureError¶
- IDL_Type:
boolean
- Units:
unitless
- Description:
If true, the temperature status feedback channel for the power supply has become active.
inputVoltageError¶
- IDL_Type:
boolean
- Units:
unitless
- Description:
If true, the input voltage status feedback channel for the power supply has become active.
setRoof¶
Description: Most recent setRoof command from the CSC to the DREAM controller.
- EFDB_Topic:
DREAM_logevent_setRoof
roof¶
- IDL_Type:
boolean
- Units:
unitless
- Description:
Most recent data sent to DREAM with the
setRoof
command, indicating whether DREAM should proceed with observing.
setWeather¶
Description: Most recent setWeather command from the CSC to the DREAM controller.
- EFDB_Topic:
DREAM_logevent_setWeather
weather¶
- IDL_Type:
boolean
- Units:
unitless
- Description:
Most recent data sent to DREAM with the
setWeather
command, indicating that it is okay to open.
status¶
Description: DREAM subsystem status.
- EFDB_Topic:
DREAM_logevent_status
paused¶
- IDL_Type:
boolean
- Units:
unitless
Description: If true, DREAM observations are paused by operator, using pause command.
observingMode¶
- IDL_Type:
int
- Units:
unitless
- Description:
The current observing mode for DREAM. A CameraServerMode enumeration.
targetObservingMode¶
- IDL_Type:
int
- Units:
unitless
- Description:
The desired mode for DREAM, which DREAM should be working to enter. A CameraServerMode enumeration.
dome¶
- IDL_Type:
int
- Units:
unitless
- Description:
The current state of the enclosure. A DomeState enumeration.
targetDome¶
- IDL_Type:
int
- Units:
unitless
- Description:
The desired state of the enclosure, which DREAM should be working to enter. A DomeTargetState enumeration.
heater¶
- IDL_Type:
int
- Units:
unitless
- Description:
The current state of the heater. A HeaterState enumeration.
targetHeater¶
- IDL_Type:
int
- Units:
unitless
- Description:
The desired state of the heater, which DREAM should be working to enter. A HeaterState enumeration.
peltier¶
- IDL_Type:
int
- Units:
unitless
- Description:
The current state of the peltier regulator. A PeltierState enumeration.
targetPeltier¶
- IDL_Type:
int
- Units:
unitless
- Description:
The desired state of the peltier regulator, which DREAM should be working to enter. A PeltierState enumeration.
power¶
- IDL_Type:
boolean
- Units:
unitless
- Count:
15
- Description:
For each of the devices controlled by the power distribution unit, true if the PDU is supplying power to that device. The devices are:
Switch
USB hub
PSU 1
PSU 2
Central Camera
North Camera
East Camera
South Camera
West Camera
Command Server
Central Server
North Server
East Server
South Server
West Server
relayState¶
- IDL_Type:
boolean
- Units:
unitless
- Count:
5
- Description:
Whether each of DREAM’s relays are switched. The relay controls are:
Motor power
Motor direction
Peltier power
Peltier direction
Window heater power
errorFlags¶
- IDL_Type:
long long
- Units:
unitless
- Description:
A bit flag indicating errors reported by DREAM, defined by the Error enumeration.
warningFlags¶
- IDL_Type:
long long
- Units:
unitless
- Description:
A bit flag indicating warnings reported by DREAM, defined by the Warning enumeration.
additionalErrors¶
- IDL_Type:
string
- Units:
unitless
- Description:
Any errors reported by DREAM that are not in the Error enumeration. The string contains a brief text description of the each error, with the errors separated by semicolons.
additionalWarnings¶
- IDL_Type:
string
- Units:
unitless
- Description:
Any warnings reported by DREAM that are not in the Warning enumeration. The string contains a brief text description of the each warning, with the warnings separated by semicolons.
temperatureControl¶
Description: DREAM temperature control status.
- EFDB_Topic:
DREAM_logevent_temperatureControl
heatingOn¶
- IDL_Type:
boolean
- Units:
unitless
Description: Heating on/off. True for on.
coolingOn¶
- IDL_Type:
boolean
- Units:
unitless
Description: Cooling on/off. True for on.
ups¶
Description: DREAM Uninterruptible Power Supply (UPS) status.
- EFDB_Topic:
DREAM_logevent_ups
online¶
- IDL_Type:
boolean
- Units:
unitless
Description: True when UPS is online. False when UPS is offline.
batteryLow¶
- IDL_Type:
boolean
- Units:
unitless
Description: True when UPS battery charge is low.
batteryNeedsReplacing¶
- IDL_Type:
boolean
- Units:
unitless
Description: True when UPS reports that it needs a new battery.
inputLastError¶
- IDL_Type:
string
- Units:
unitless
Description: The last reason reported by the UPS for switching to battery.
notOnMains¶
- IDL_Type:
boolean
- Units:
unitless
Description: True when UPS commercial power isn’t running, the UPS is providing power from its battery.
communicationError¶
- IDL_Type:
boolean
- Units:
unitless
Description: True for communication error.
weather¶
- Description:
Current weather status inferred from the ESS CSC for the weather station. This is a bitmask, with each set bit indicating that the corresponding weather parameter is NOT acceptable for operation of DREAM. Flags are documented by the Weather enum and may be extended as needed.
- EFDB_Topic:
DREAM_logevent_weather
weatherFlags¶
- IDL_Type:
long
- Units:
unitless
Description: Bitmask indicating good weather to open DREAM.
configurationApplied¶
Description: Information about this CSC’s current configuration overrides.
- 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 this 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 this CSC, and any other pertinent information. Ignore whitespace after commas.
configurationsAvailable¶
Description: Available configuration overrides for this 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 this 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 this 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¶
Description: Event output at regular intervals (typcally once per second) to show that the SAL component is alive.
- EFDB_Topic:
SALGeneric_logevent_heartbeat
- Category:
mandatory
heartbeat¶
- IDL_Type:
boolean
- Units:
unitless
Description: Deprecated field that you should ignore.
largeFileObjectAvailable¶
Description: A new large file object is available.
- EFDB_Topic:
SALGeneric_logevent_largeFileObjectAvailable
url¶
- IDL_Type:
string
- IDL_Size:
256
- Units:
unitless
Description: A Uniform Resource Locator which links to a Large File Object either for ingest into the EFD Large File Annex, or to announce the successful copy of same to the EFD Large File Annex.Protocols are those supported by the cURL library.
generator¶
- IDL_Type:
string
- IDL_Size:
256
- Units:
unitless
Description: Name of the package which generated the file being announced.
version¶
- IDL_Type:
float
- Units:
unitless
Description: A dotted x.y version number denoting the file format revision.
byteSize¶
- IDL_Type:
long
- Units:
unitless
Description: Size of file in bytes.
checkSum¶
- IDL_Type:
string
- IDL_Size:
256
- Units:
unitless
Description: Hexadecimal character string holding the checksum of the file.
mimeType¶
- IDL_Type:
string
- IDL_Size:
256
- Units:
unitless
Description: Mime Type code for the file.
id¶
- IDL_Type:
string
- IDL_Size:
256
- Units:
unitless
Description: A generic identifier field.
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 this 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 this 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.
cscVersion¶
- IDL_Type:
string
- IDL_Size:
256
- Units:
unitless
Description: The software version of this 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 this CSC.
summaryState¶
Description: Current summary state of this CSC.
- EFDB_Topic:
SALGeneric_logevent_summaryState
- Category:
csc
summaryState¶
- IDL_Type:
long
- Units:
unitless
Description: High level state machine state identifier.
Telemetry¶
camera¶
Description: Telemetry for the DREAM cameras. Each attribute has five values, one for each camera:
East
West
North
Central
South
- EFDB_Topic:
DREAM_camera
lastCameraHeartbeatTimestamp¶
- IDL_Type:
float
- Units:
second
- Count:
5
Description: Time (TAI) of last camera server heartbeat.
ccdTemperature¶
- IDL_Type:
float
- Units:
deg_C
- Count:
5
Description: CCD temperature.
dome¶
Description: DREAM dome telemetry.
- EFDB_Topic:
DREAM_dome
encoder¶
- IDL_Type:
int
- Units:
unitless
Description: Dome encoder readout.
environment¶
- Description: Ambient environment measured in various locations within DREAM. Indexed by location:
Electronics top
Camera bay
Electronics box
Rack top
Rack bottom
DREAM inlet
- EFDB_Topic:
DREAM_environment
temperature¶
- IDL_Type:
float
- Units:
deg_C
- Count:
6
Description: Measured temperature.
humidity¶
- IDL_Type:
float
- Units:
%
- Count:
6
Description: Measured humidity.
powerSupply¶
Description: DREAM power supply status.
- EFDB_Topic:
DREAM_powerSupply
voltage¶
- IDL_Type:
float
- Units:
V
- Count:
2
Description: Power supply output voltage (0) feedback and (1) setpoint.
current¶
- IDL_Type:
float
- Units:
A
- Count:
2
Description: Power supply output current (0) feedback and (1) setpoint.
ups¶
Description: DREAM UPS telemetry.
- EFDB_Topic:
DREAM_ups
batteryCharge¶
- IDL_Type:
float
- Units:
%
Description: Battery charge percentage. Reported by the UPS, 100 means the battery is fully charged.
batteryTemperature¶
- IDL_Type:
float
- Units:
deg_C
Description: Battery temperature reported by the UPS.
batteryVoltage¶
- IDL_Type:
float
- Units:
V
Description: Battery voltage reported by the UPS.
timeRemaining¶
- IDL_Type:
float
- Units:
min
Description: Estimated run time remaining, reported by the UPS.
outputLoad¶
- IDL_Type:
float
- Units:
%
Description: Output load currently reported by the UPS as a percent of total capacity.
outputCurrent¶
- IDL_Type:
float
- Units:
amp
Description: Output current reported by the UPS.
lastOnline¶
- IDL_Type:
float
- Units:
second
Description: Timestamp (TAI) of the most recent information update from the UPS.