ATDome¶
Commands¶
moveAzimuth¶
Description: Rotate the dome to the specified azimuth.
| Subsystem: | ATDome |
|---|---|
| Version: | 3.8.2 |
| EFDB_Topic: | ATDome_command_moveAzimuth |
azimuth¶
| IDL_Type: | float |
|---|---|
| Units: | deg |
| Count: | 1 |
Description: Desired azimuth; must be in the range 0 to 360. The dome will take the shortest route to the specified position.
closeShutter¶
Description: Close both shutter doors. This is the preferred way to close the shutter, because it automatically sequences the doors to prevent the main door from interfering with the dropout door.
| Subsystem: | ATDome |
|---|---|
| Version: | 3.8.2 |
| EFDB_Topic: | ATDome_command_closeShutter |
openShutter¶
Description: Open both shutter doors. This is the preferred way to open the shutter because it automatically sequences the doors to prevent the main door from interfering with the dropout door.
| Subsystem: | ATDome |
|---|---|
| Version: | 3.8.2 |
| EFDB_Topic: | ATDome_command_openShutter |
stopMotion¶
Description: Stop all motion: azimuth, dropout door and main door.
| Subsystem: | ATDome |
|---|---|
| Version: | 3.8.2 |
| EFDB_Topic: | ATDome_command_stopMotion |
homeAzimuth¶
Description: Home the azimuth axis.
| Subsystem: | ATDome |
|---|---|
| Version: | 3.8.2 |
| EFDB_Topic: | ATDome_command_homeAzimuth |
moveShutterDropoutDoor¶
Description: Open or close the shutter dropout door. Intended for engineering; use the openShutter and closeShutter commands for normal operation since they automatically sequence the doors to prevent the main door from interfering with the dropout door.
| Subsystem: | ATDome |
|---|---|
| Version: | 3.8.2 |
| EFDB_Topic: | ATDome_command_moveShutterDropoutDoor |
open¶
| IDL_Type: | boolean |
|---|---|
| Units: | unitless |
| Count: | 1 |
Description: Open the door if true, close it if false.
moveShutterMainDoor¶
Description: Open or close the main shutter door. Intended for engineering; use the openShutter and closeShutter commands for normal operation since they automatically sequence the doors to prevent the main door from interfering with the dropout.
| Subsystem: | ATDome |
|---|---|
| Version: | 3.8.2 |
| EFDB_Topic: | ATDome_command_moveShutterMainDoor |
open¶
| IDL_Type: | boolean |
|---|---|
| Units: | unitless |
| Count: | 1 |
Description: Open the door if true, close it if false.
Events¶
- AzimuthCommandedState_Unknown
- AzimuthCommandedState_GoToPosition
- AzimuthCommandedState_Home
- AzimuthCommandedState_Stop
- AzimuthState_NotInMotion
- AzimuthState_MovingCW
- AzimuthState_MovingCCW
- ShutterDoorCommandedState_Unknown
- ShutterDoorCommandedState_Closed
- ShutterDoorCommandedState_Opened
- ShutterDoorCommandedState_Stop
- ShutterDoorState_Closed
- ShutterDoorState_Opened
- ShutterDoorState_PartiallyOpened
- ShutterDoorState_Opening
- ShutterDoorState_Closing
azimuthCommandedState¶
Description: Commanded state of azimuth drive.
| Subsystem: | ATDome |
|---|---|
| Version: | 3.8.2 |
| EFDB_Topic: | ATDome_logevent_azimuthCommandedState |
azimuth¶
| IDL_Type: | float |
|---|---|
| Units: | deg |
| Count: | 1 |
Description: Position commanded by the most recent moveAzimuth command; nan when the CSC starts up or when homing.
azimuthState¶
Description: Current state of azimuth drive.
| Subsystem: | ATDome |
|---|---|
| Version: | 3.8.2 |
| EFDB_Topic: | ATDome_logevent_azimuthState |
dropoutDoorCommandedState¶
Description: Commanded state of the dropout shutter door.
| Subsystem: | ATDome |
|---|---|
| Version: | 3.8.2 |
| EFDB_Topic: | ATDome_logevent_dropoutDoorCommandedState |
dropoutDoorState¶
Description: Current state of the dropout shutter door.
| Subsystem: | ATDome |
|---|---|
| Version: | 3.8.2 |
| EFDB_Topic: | ATDome_logevent_dropoutDoorState |
mainDoorCommandedState¶
Description: Commanded state of the main shutter door.
| Subsystem: | ATDome |
|---|---|
| Version: | 3.8.2 |
| EFDB_Topic: | ATDome_logevent_mainDoorCommandedState |
mainDoorState¶
Description: Current state of the main shutter door.
| Subsystem: | ATDome |
|---|---|
| Version: | 3.8.2 |
| EFDB_Topic: | ATDome_logevent_mainDoorState |
azimuthInPosition¶
Description: Is the dome azimuth in the commanded position? Note: this will be false when the CSC starts up until a position is commanded.
| Subsystem: | ATDome |
|---|---|
| Version: | 3.8.2 |
| EFDB_Topic: | ATDome_logevent_azimuthInPosition |
shutterInPosition¶
Description: Are the shutter doors in their commanded positions? Note: this will be false when the CSC starts up until a position is commanded for both doors.
| Subsystem: | ATDome |
|---|---|
| Version: | 3.8.2 |
| EFDB_Topic: | ATDome_logevent_shutterInPosition |
allAxesInPosition¶
Description: Are all axes (azimuth and both shutter doors) in position?
| Subsystem: | ATDome |
|---|---|
| Version: | 3.8.2 |
| EFDB_Topic: | ATDome_logevent_allAxesInPosition |
doorEncoderExtremes¶
Description: Encoder values of the doors when fully closed or fully opened. Reported in full status as Main Door Encoder Closed, etc.
| Subsystem: | ATDome |
|---|---|
| Version: | 3.8.2 |
| EFDB_Topic: | ATDome_logevent_doorEncoderExtremes |
mainClosed¶
| IDL_Type: | long long |
|---|---|
| Units: | unitless |
| Count: | 1 |
Description: Encoder position for main door when fully closed.
mainOpened¶
| IDL_Type: | long long |
|---|---|
| Units: | unitless |
| Count: | 1 |
Description: Encoder position for main door when fully opened.
dropoutClosed¶
| IDL_Type: | long long |
|---|---|
| Units: | unitless |
| Count: | 1 |
Description: Encoder position for dropout door when fully closed.
dropoutOpened¶
| IDL_Type: | long long |
|---|---|
| Units: | unitless |
| Count: | 1 |
Description: Encoder position for dropout door when fully opened.
lastAzimuthGoTo¶
Description: The most recently commanded azimuth position.
| Subsystem: | ATDome |
|---|---|
| Version: | 3.8.2 |
| EFDB_Topic: | ATDome_logevent_lastAzimuthGoTo |
emergencyStop¶
Description: Has the emergency stop button been activated?
| Subsystem: | ATDome |
|---|---|
| Version: | 3.8.2 |
| EFDB_Topic: | ATDome_logevent_emergencyStop |
active¶
| IDL_Type: | boolean |
|---|---|
| Units: | unitless |
| Count: | 1 |
Description: Is the estop active (e.g. estop button pressed)?
scbLink¶
Description: Can the main controller box (MCB) communicate with the shutter control box (SCB)?
| Subsystem: | ATDome |
|---|---|
| Version: | 3.8.2 |
| EFDB_Topic: | ATDome_logevent_scbLink |
settingsAppliedDomeController¶
Description: Settings internal to the ATDome TCP/IP controller.
| Subsystem: | ATDome |
|---|---|
| Version: | 3.8.2 |
| EFDB_Topic: | ATDome_logevent_settingsAppliedDomeController |
rainSensorEnabled¶
| IDL_Type: | boolean |
|---|---|
| Units: | unitless |
| Count: | 1 |
Description: Is the rain/snow sensor enabled?
cloudSensorEnabled¶
| IDL_Type: | boolean |
|---|---|
| Units: | unitless |
| Count: | 1 |
Description: Is the cloud sensor enabled?
tolerance¶
| IDL_Type: | float |
|---|---|
| Units: | deg |
| Count: | 1 |
Description: A request to move less than this amount in azimuth is ignored.
highSpeedDistance¶
| IDL_Type: | float |
|---|---|
| Units: | deg |
| Count: | 1 |
Description: The minimum distance in azimuth that the dome must move to invoke high speed motion.
watchdogTimer¶
| IDL_Type: | float |
|---|---|
| Units: | second |
| Count: | 1 |
Description: The time interval between loss of communication between the shutter control box (SCB) and main control box (MCB) and the SCB closing the shutter.
dropoutTimer¶
| IDL_Type: | float |
|---|---|
| Units: | second |
| Count: | 1 |
Description: What is this? How does it differ from doorMoveTimeout?
reversalDelay¶
| IDL_Type: | float |
|---|---|
| Units: | second |
| Count: | 1 |
Description: The delay between reversing motor directions for the shutter doors, where 0 < t <= 6. For a 240 VAC system this parameter can be set to 0.
autoShutdownEnabled¶
| IDL_Type: | boolean |
|---|---|
| Units: | unitless |
| Count: | 1 |
Description: Is automatic closing of the shutter enabled? If enabled then the shutter will be closed if rain, snow or clouds are detected, or if the shutter control box (SCB) loses radio contact with the main control box (MCB).
encoderCountsPer360¶
| IDL_Type: | long long |
|---|---|
| Units: | unitless |
| Count: | 1 |
Description: Number of azimuth encoder counts per full rotation.
doorMoveTimeout¶
| IDL_Type: | float |
|---|---|
| Units: | second |
| Count: | 1 |
Description: Timeout for opening or closing (what? either shutter door?).
settingsAppliedDomeTcp¶
Description: Settings related to communication between the ATDome CSC and the ATDome TCP/IP controller.
| Subsystem: | ATDome |
|---|---|
| Version: | 3.8.2 |
| EFDB_Topic: | ATDome_logevent_settingsAppliedDomeTcp |
host¶
| IDL_Type: | string |
|---|---|
| IDL_Size: | 1 |
| Units: | unitless |
| Count: | 1 |
Description: Host name of the ATDome TCP/IP controller.
port¶
| IDL_Type: | long |
|---|---|
| Units: | unitless |
| Count: | 1 |
Description: Port number of the ATDome TCP/IP controller.
readTimeout¶
| IDL_Type: | float |
|---|---|
| Units: | second |
| Count: | 1 |
Description: Read timeout before going into a fault state.
connectionTimeout¶
| IDL_Type: | float |
|---|---|
| Units: | second |
| Count: | 1 |
Description: Connection timeout before going into a fault state.
Telemetry¶
position¶
Description: Current position of azimuth and both shutter doors.
| Subsystem: | ATDome |
|---|---|
| Version: | 3.8.2 |
| EFDB_Topic: | ATDome_position |
dropoutDoorOpeningPercentage¶
| IDL_Type: | float |
|---|---|
| Units: | unitless |
| Count: | 1 |
Description: Current dropout shutter door opening percentage.
mainDoorOpeningPercentage¶
| IDL_Type: | float |
|---|---|
| Units: | unitless |
| Count: | 1 |
Description: Current main shutter door opening percentage.
azimuthEncoderPosition¶
| IDL_Type: | long long |
|---|---|
| Units: | unitless |
| Count: | 1 |
Description: Current azimuth encoder reading.