MTDome Handover Procedure¶
Overview¶
The MTDome Handover Procedure ensures the dome is ready for nighttime observations. The majority of this procedure is carried out by the daytime engineering team, usually starts around 3:30pm CLT.
The team starts with a walk around, which consists of carefully walking the dome floor and ensuring it is clear for movement. Then they check the dome controller by moving it to an azimuth of 328 deg, and then configure it for remote control. Finally, the observing team must perform a test to move the Dome Az, shutter and Louvers remotely via CSC. If that test succeeds, the handover is complete.
This document focuses on the actions performed by the Observing Specialist (OS) team to test motion control via CSC. The complete dome handover procedure is described in the Rubin Technical Document (RTD-1131).
Points of Contact: Juan Fabrega, Luis Vergara, Hernán Herrera, and Eduardo Serrano.
Reminder
The subSystemIds for the Dome components are:
DomeAz:
0x1Dome shutter:
0x4Louvers:
0x8
Precondition¶
Laptops are configured and pre-loaded with necessary tools before arriving at Level 7.
M1M3 mirror cover is closed (deployed) to protect the mirror during dome shutter tests.
Exception: If the TMA is parked at the horizon, the shutter may be opened slightly without the mirror cover deployed.
The Electrical team has delivered the dome at 328 degrees.
Capacitor banks are connected (if operating in full performance).
Dome crane lights are off.
Access to main-brick01.cp.lsst.org (Windows 10 VM via https://ls.st/main-brick01) is verified for troubleshooting.
Post-Condition¶
MTDome control is given to the observing team and can be controlled remotely via CSC.
Procedure Steps¶
1. Preliminary Verifications¶
Weather Assessment
If there was precipitation, high humidity, or low temperature the previous day, assess the dome for ice or snow to prevent falls onto the TMA:
Park the TMA near zenith (>80°).
Ensure authorized personnel inspect the panoramic platform via the hatches.
If no ice or snow is present, proceed to open the dome shutter.
Warning
If no personnel are available to perform the inspection, the dome must remain closed. If weather was bad but no snow/freezing occurred, follow the MTDome Post-Bad Weather Safety Inspection procedure.
Assert Dome Status
Confirm the dome is in the parking position (328 deg).
Confirm the dome is in remote mode and at least 2 minutes have elapsed since the mode change.
Confirm capacitor banks are connected (for Full Performance).
Transition the MTDome CSC from
STANDBYtoDISABLED.
Note
When switching to remote mode, listen for a click from the brakes engaging. In the MTDome Azimuth Status Dashboard, the Azimuth Motion State should be
STOPPED_BRAKED.Warning
Allow sufficient time for the MTDome CSC to stabilize after a state transition before issuing further commands.
Verify Shutter Mode
Verify the Dome shutter is in normal mode using the Simonyi Integrated Telemetry Dashboard.
To change the operational mode if necessary, use
run_command.py:component: MTDome cmd: setOperationalMode parameters: operationalMode: 1 subSystemIds: 0x4
2. Enable MTDome CSC¶
Transition MTDome CSC from
DISABLEDtoENABLED, and wait 2-3 min.Clear any low-level faults, if present (refer to Dome Az cRIO reboot ).
3. Dome Az Checkout¶
Verify Position
If telemetry does not match 328 degrees (MTDome Azimuth Status Dashboard), follow the Homing the Dome procedure.
- Test MotionMove the Dome Az via CSC in both directions:
Move to Az: 320 deg
Wait until stopped and verify via the dashboard.
Move to Az: 90 deg (position away from the Sun).
Use the following configuration with themaintel/mtdome/slew_dome.pyscript:az: 320 ignore: - mtm1m3 - mtm2 - mtaos - mtdometrajectory - mthexapod_1 - mthexapod_2 - mtmount - mtptg - mtrotator
Caution
If this step doesn’t move refer to Dome Az cRIO reboot.
Engage Dome Azimuth Brakes
Use
run_command.py:component: MTDome cmd: stop parameters: engageBrakes: True subSystemIds: 1
4. Dome Louvers checkout¶
Partially open the Louvers to 10% using
run_command.py(Currently available: B1, E1, E2, H1, H2, M1).component: MTDome cmd: setLouvers parameters: position: [0.0, 0.0, 10.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 10.0, 10.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 10.0, 10.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 10.0, 0.0, 0.0, 0.0, 0.0]
Close the Louvers using
closeLouvers.component: MTDome cmd: closeLouvers
5. Dome shutter checkout¶
Caution
If the dome shutter has faults refer to Standard-Operations-MTDome-handover-Clear-Dome-shutter-fault.
Ensure Preconditions are met (mirror covers closed, dome pointing South, etc.).
Using MTQueue, run the block
BLOCK-T70. This script performs:Open shutter.
Wait 5 seconds.
Stop shutter.
Close shutter.
Configuration for
maintel/scheduler/add_block.py:id: BLOCK-T70 override: sleep_for: 5
Warning
Safety Critical: Monitor the shutter and script execution closely.
If the block fails while the shutter is opening, the stop and closeShutter
commands will not execute. You must manually issue stop followed by
closeShutter immediately.
run_command.py Configurations
component: MTDome
cmd: stop
parameters:
subSystemIds: 0x4
component: MTDome
cmd: closeShutter
6. Turn lights off¶
Confirm the physical switch in the dome shutter drives cabinet (Level 8) is set to OFF.
Park the dome using
park_dome.py.Disable MTDome using
set_summary_state.py.Use the dome trapped key.
Manually turn off the lights from the Level 8 cabinet using the Manual Override Lighting Control switch..
Verify that scheduled lights (e.g., 18:30 or 19:30 CLT) turned off automatically.
Perform a final visual inspection to ensure all lights (including Level 3 and PFlow) are off before observing.
Note
Troubleshooting¶
Clear Dome Az fault¶
If a FAULT is reported in the Azimuth Control Software Status:
Send an
exitFaultcommand.If
exitFaultfails due to an “incorrect state,” issue astopcommand to engage brakes.If the
stopcommand is refused with a “drive in fault” message, issue aresetDrivesAzcommand to reset the azimuth drives.Retry the
stopcommand, then theexitFaultcommand.
run_command.py Configurations
component: MTDome
cmd: exitFault
parameters:
subSystemIds: 0x1
component: MTDome
cmd: stop
parameters:
engageBrakes: true
subSystemIds: 0x1
component: MTDome
cmd: resetDrivesAz
parameters:
reset: [true, true, true, true, true]
Dome Az cRIO reboot¶
If we cannot clear faults and move the Dome Az. It is likely the cRIO must be rebooted, check the detailed instructions, but in summary the steps are:
Set MTDome CSC to
STANDBY.Open ls.st/main-brick01 to log into the http://main-brick01.cp.lsst.org
Wait 2-3 mins, and then set MTDome CSC to
ENABLED.
This will reset the zero position in the cRIO so after a reboot there is no need to home the dome . After a reboot, you may need to send an
exitFaultcommand (see step 2). If the azimuth control software is not in fault, the command will still be accepted.
Now, you should be able to move the dome via CSC. Sometimes you will have to state cycle the MTDome if the telemetry is lost.
Warning
If the previous step did not work, the cRIO must be rebooted manually.
Consider asking electrical team to power cycle the drives at L7.
Alternatively, in an emergency situation, ask a Summit Support Scientist if they can follow the EIE procedure (08815-PRO314a). After power cycling the drives, you should restart the procedure.
Dome Shutter/Louvers Faults¶
If the dome shutter has faults, try an
exitFaultcommand. If the faults persist, you may need to issue aresetDrivesShuttercommand.run_command.pyConfigurationscomponent: MTDome cmd: exitFault parameters: subSystemIds: 0x4
component: MTDome cmd: resetDrivesShutter parameters: reset: [true,true,true,true]
If the louvers have faults, try an
exitFaultcommand.component: MTDome cmd: exitFault parameters: subSystemIds: 0x8
Contingency¶
If the procedure was not successful, report the issue in #mtdome-worklog on Slack, or contact one of the following dome experts for assistance:
Wouter van Reeven (Primary Contact)
Marina Pavlovic
Brian Stalder
Lorenzo Vio