.. ifconfig:: includeDevInfo in ('true')

     .. raw:: html

        <style> .red {color:#aa0060; font-weight:bold; font-size:16px} </style>

     .. role:: red


     .. raw:: html

        <style> .blue {color:#0000FF; font-weight:bold; font-size:16px} </style>

     .. role:: blue

     Miscellanea
     ===========

     Connecting to the online cluster
     --------------------------------

     Quick checks on data can be done on the online cluster without the need of migrating the runs beforehand. To do that, log in with your username and :code:`kerberos` password to :code:`exfl-onc-sa3`.

     Setting up the DSSC processor viewer
     ------------------------------------

     It can be useful to set up a special viewer (at the moment available for Q2M4 and Q4M4) which shows the maximum signal collected by the pixel over a certain number of trains (see the scene below). In order to activate it, the pipeline devices relative to these modules need to be switched OFF.

     Look for the server :code:`exflong24` and find the devices :code:`cppServers/scs_cal_7`

     .. figure:: Figures/figure5.1.png
        :width: 100%

     Normally, these devices are called :code:`SPLITTER_Q4M4` and :code:`SPLITTER_Q2M4`. Shutdown both devices. Then go to the :code:`DSSC_PROC_HIST` subproject of :code:`DSSC_ONLINE_CAL`. There, the same devices are available and shall be instantiated:

     .. figure:: Figures/figure5.2.png
        :width: 100%

     Right click on the :code:`cppServers/scs_cal_7` and select 'Instantiate all devices'. The devices shall go green as seen in the picture.

     After that, the viewer is available in the :code:`PROC_VIEW` scene.

     .. figure:: Figures/figure5.3.png
        :width: 100%
 
     To go back to the 'normal' online viewer, proceed as follows:

        - Shutdown the :code:`scs_cal_7` servers in the :code:`DSSC_PROC_HIST` subprojects.
        - Restart the calibration pipeline.

     Detector synchronization
     ------------------------

     The trigger server for DSSC is :code:`SCS_RR_SYS/TSYS/UTC-1-S2`. If one clicks to get the configuration editor for this, several options are available. The DSSC trigger is called back trigger 3 (:code:`BACK TRG 3`). A screenshot of how it looks like can be seen below.

     .. figure:: Figures/figure5.4.png
        :width: 100%

     The delay parameter there is very important as it sets the timing of the DSSC detector. It defines the delay between the dynamic trigger and the arrival of the first XFEL pulse. It has been found in May 2019 to be 4757083, normally it needs to be re-tuned after every shutdown.

     This parameter must normally not be touched or changed.

     In case it needs to be retuned, the best procedure consists in configuring some ladders to visualize the maximum measured ADU counts per pixel over a whole train. This way, the timing can be localized within the time frame of a whole train and not of a single pulse.

     After the train where the signal has been identified, the pulse(s) containing the signals need to be identified. This is done by changing the 'Pulse to preview' in the :code:`PREVIEW` scene. This can be a lengthy procedure, especially if DSSC is set up to collect a large number of frames.

     After the pulse with the signal is identified, the timing needs to be shifted such that this pulse arrives in DSSC cell number zero. This is done by *adding* to the timing a value corresponding to 24 :math:`\times` (number of cells where the pulse has been found). The reason for that is that in the delay parameter, a change of 24 units corresponds to exactly the distance between two pulses of the European XFEL when it runs at 1.1 MHz repetition rate.

     So, for example, if the pulse is found in cell 18, one needs to add to the timing a value equal to 24 :math:`\times` 18 :math:`=` 432 to place the pulse in cell number zero.

     DSSC manual powering up procedure: Switching ON the in-vacuum electronics up to ASICs
     -------------------------------------------------------------------------------------

     In :code:`SCS_DSSC` :math:`\rightarrow` :code:`Subprojects` :math:`\rightarrow` :code:`DSSC_POWER` open the scenes:

        - :code:`DSSC_Power_Status` (monitoring low voltages and currents)
        - :code:`Manual_power` (manual power settings)
        - :code:`Dssc_hv_status` (monitoring high voltages and currents)

     The quadrants are switched on independently using the :code:`manual_power` scene. **It must be first checked that the channels AON in the DSSC_Power_Status scene are all ON.**

     .. figure:: Figures/figure5.5.png
        :width: 100%

     .. figure:: Figures/figure5.6.png
         :width: 100%

     .. figure:: Figures/figure5.7.png
         :width: 100%

     To power up the detector when all AON channels are ON, follow the manual powering steps on the :code:`manual_power` scene quadrant by quadrant **until point 5 (channels tagged as ioba)**. With qi (i = quadrant number, i.e., q1, q2, q3, q4) proceed as follows:

        - Type in the right box :code:`qi,mbjt`, press enter and then press ON.
        - Type in the right box :code:`qi,rb`, press enter and then press ON.
        - Type in the right box :code:`qi, iob`, press enter and then press ON.
        - Type in the right box :code:`qi, ioba`, press enter and then press ON.

     **Check that the corresponding channels go ON and green in the DSSC Power Status scene before proceeding to the next step.**

     At the end of point 5, the detector is powered up to the ASICs and the ASICs need to be programmed at this stage.

     Configuring the detector ASICs
     ------------------------------

     Follow :numref:`config`.

     Manual procedure: powering up the source voltages and the high voltage channels
     -------------------------------------------------------------------------------

     Restart from point 6 of the :code:`manual_power` scene. Switch on the source voltages as described in point 6 below:

     6. Type :code:`qi, source` in the right box, press enter and then press ON.

     Before point 7, check from the MPOD web interface (192.168.177.9i, i=quadrant number) the channels 100-103, 112-115, 212-215, 200-203. :red:`All the voltages must be set to 20V.` If not, it must be set from the :code:`manual_power` view. This step is critical for the detector safety. If you feel unsure about this, please contact DET OCD.

     Proceed with caution with point 7, 8 and 9. Be careful that in point 9 the channels of some channels which are already ON need to be updated. This is not done by pressing the ON button, but by updating the voltage value in the 'Voltage' field and then pressing 'Execute'.

     Wait until a step is completed before proceeding with the next!!!

     7. Type :code:`qi, ring1` in the right box, press enter and then press ON.

     8. Type :code:`qi, back` in the right box, press enter and then press ON.

     9. Type :code:`qi, ring2` in the right box, type 25 in the Voltage field and then press Execute as described above.

     Manual procedure: powering off the DSSC detector
     ------------------------------------------------

     Follow the instructions in the :code:`manual_power` scene, :code:`Power down the detector` section. Wait until a step is completed before proceeding with the next. Execute the procedure quadrant by quadrant.

     .. figure:: Figures/figure5.8.png
        :width: 100%



     1. Bring the :code:`ring2` channels back to 20 V. To do this:
         - Type :code:`qi, ring2` in the right text field, press enter, confirm that the same is written in the left text field.
         - Update the voltage value to 20 V in the 'Voltage' field. Press enter.
         - Check that the voltages of the corresponding channels go to 20 V in the :code:`HV scene`.
     2. Type :code:`qi, back` in the right text field, press enter and then press OFF. This step will take a while. Wait until the channels are OFF before proceeding.
     3. Type :code:`qi, ring1` in the right text field, press enter and then press OFF.
     4. Type :code:`qi, source` in the right text field, press enter and then press OFF.
     5. The other channels can be switched OFF all together. Type :code:`qi, ioba|iob|rb|mbjt` in the right text field, press enter and then press OFF.

     At this point all the in-vacuum electronics of DSSC are OFF and the detector does not need to be cooled any more.

     Leave the AON channels ON so that the PPT and the SIB stay ON.

     **Expert-level troubleshooting at PPT level:**

     If a PPT has to be power cycled, :red:`DO NOT SWITCH OFF ALL THE AUTO-ON POWER SUPPLIES but call DET OCD.`

     To power cycle the PPT, first, all the other channels of the quadrant need to be OFF. Therefore, follow the manual power off procedure (:code:`manual_power` scene) for the problematic quadrant until point 5, leaving only the AON channels ON. 

     To safely power cycle the PPT, the PPT must be electrically isolated from the SIB. To do that, follow the instructions below, available also on the DSSC 1 Mpixel detector elog, entry #142. 

        1. Shutdown the corresponding SIB Karabo device (i.e. if the PPT of quadrant 2 needs to be power cycled, the device to be shutdown is :code:`SIB_2`).
        #. Connect to the DSSC control server, :code:`exflcon145`.
        #. :code:`cd SIB_scripts/`
        #. :code:`python IsolatePPT.py [quadrant number, from 1 to 4]`. The output of the script *must* be the following:
            - | :blue:`Welcome to the DSSC Safety Interlock Board. BuildNumber: 5da843a` 
              | :blue:`Password:`
              | :blue:`AUTH OK;`
              | :blue:`PPT LINES ISOLATED (RSV_3V3_2,4,10 no 8,9)`
              | :blue:`Press Enter to connect PPT again...`
              | If the line 'PPT LINES ISOLATED (RSV_3V3_2,4,10 no 8,9)' does not appear, it means that the PPT is not isolated and the power cycling cannot take place. Stop the procedure here.
        #. At this point, power cycle channel 704 on the corresponding MPOD power supply Karabo device (:code:`SCS_CDIDET_DSSC/MCPS/MPOD_X`).
            - Select the proper MPOD device, :code:`SCS_CDIDET_DSSC/MCPS/MPOD_i`, where i is the quadrant number.
            - In the configuration editor, scroll down and open the channel list. Select channel U704. Select Switch property, select zero and press enter. After the channel state goes to OFF, select switch property, select 1 and press enter. The channel shall go ON again.

        #. Go back to the terminal where the SIB script is being executed and press ENTER. The output must be the following: 
              | :blue:`PPT LINES ENABLED` 
              | :blue:`Connection closed`. 
              | If the line 'PPT LINES ENABLED' does not appear, it means that the PPT is still isolated and the SIB will not get the data from it. 

        #. Instantiate again the corresponding SIB Karabo device. Procedure is finished. 

     In case the PPT device cannot be killed any more, log into the DSSC control server :code:`exflcon145`. Then type the following:

    :code:`karabo-kill [device name]`