MSCB Custom Page Documentation

Introduction

The MSCB Custom page (Figure 2) is accessed from the MIDAS main status page by clicking the button custom (see Figure 1).

Figure 1 :  Status page showing custom button

status page showing
      custom button


The MSCB Custom page allows the user any easy way of setting the values of the Threshold and ADC-Gain channels for the GEOTOMO experiment.

The custom page writes to the MIDAS ODB  at the paths
It reads from the ODB at the paths

** In all cases,  NN runs from 00 to 02 for the three possible frontends.

Using the Custom page


Figure 2 shows the MSCN custom page.

The Threshold values appear in the left-hand (green) frame, and the  8 channels of ADC-Gain values appear in the right-hand (mauve) frame. By default, all 64 channels of Threshold are shown. Eight groups are defined for the Thresholds, each of which contains 8 channels.

Various features are numbered in Figure 2. The key to the numbers appears below.

Figure 2: MSCB Custom Page

mscb custom page

Key to Number on Figure 2


  1. Page Switch Buttons
  2. Select Frontend pull-down menu
  3. Run State
  4. Set Threshold or Gain to ALL channels of ALL Modules
  5. Selected Frontend
  6. Display of Threshold and Gain of Selected Frontend
  7. Select Threshold Group using pull-down menu
  8. Writing set values of Thresholds/Gain to Individual Channels of Selected Frontend
  9. Writing set values of Thresholds/Gain to Checked Channels of the Selected Frontend
  10. Write set values of Threshold and Gain to a ALL Channels of Selected Frontend
  11. Write set values of Threshold to a GROUP of Channels of Selected Frontend
  12. Page Update


1. Page Switch Buttons

The page switch buttons are located at the top of the page.  The user may return to the mhttpd main status page by clicking the  Status button. ODB and Message  have the same effect as those on the main status page (i.e. switch to ODB and Message pages) . The fourth button is the MSCB Page Help  which opens this page.  

2. Select Frontend pull-down menu

For operations on a particular frontend the user selects the required frontend using the Select Frontend: pull-down menu.  When a different frontend is selected, the name of the selected frontend and the banner changes colour (compare Figure 2 and Figure 4). The default frontend is FE00.

3. Run State

The current run state is displayed. This is updated automatically approximately every 15s.


4. Set ALL channels of ALL Modules (Threshold, Gain)

Clicking either of
opens a dialogue box directly underneath (Figure 3a) in which to enter the desired value. A confirmation box will appear when the Set button is pressed (Figure 3b). Press Cancel to abort.


Figure 3a: Set All  Thresholds Checkbox and All ADC-Gains Checkbox are checked

Figure 3b:  Set All ADC-Gains Confirm Box

ALL threshold and Gains checkboxes
              checked confirm box for all


Operations on the Selected Frontend

5. Selected Frontend and Coloured Banners


One of the three Frontends may be selected using the Select MADC module pull-down menu (see 2 above).
When a different frontend is selected, the name of the selected frontend changes, and the coloured banners  change colour.
All the display between the top and bottom coloured banners refer to the selected Frontend.
Contrast Figure 2 where FE01 is selected with Figure 4 where FE00 is selected.

Figure 4 shows FE00 as the Selected Frontend and the Threshold Group "all"

custom page with
      different frontend selected


6. Threshold and ADC-Gain

The custom page below the "Selected Module" banner  is divided into two areas which each contain a frame.

For the selected frontend:
....  unless a Group other than "all" is selected (see Select threshold group ) in which case


7. Select Threshold Group


The Threshold Group may be selected with the Select Group pull-down menu, located below the Threshold frame (Figure 5).   The 64 channels of Threshold for each frontend are divided into 8 groups of 8 channels. The pull-down menu shows the 8 groups (numbered from 1 to 8) and the option "all" to select all groups (i.e. all 64 channels). Each group is of 8 consecutive channels, e.g.
 
If a group other than "all" is selected, only the selected group of 8 Threshold channels are displayed in the Threshold frame (Figure 5)  To display all 64 of the Threshold values, select the group "all".

Figure 5: Threshold Frame showing Threshold Group 2 selected


threshold group
      selection

8.  To Write set values of Threshold and ADC-Gain to Individual Channels of Selected Frontend

To write set values to individual channels of the selected frontend, click on the individual hyperlinks in the frames.
A popup with an input box will appear in which to enter the desired set value for that channel (Figure 6).  Click OK or Cancel.


Figure 6a: Click on individual hyperlink  (Ch 21) to change value of a channel.

Figure 6b: Threshold value for Ch 21 has changed to 18

change one value using hyperlink
one value has changed



9.  To Write set values of  Threshold and ADC-Gain to Selected Checked Channels of Selected Module

To write the same set value to selected channels of the selected module, use the select checkboxes in the appropriate frame to select channels, then (in the same frame) click  the Write Selected Channels button. The frame will change to show an input box in which the desired set value is entered, and the  set (or cancel ) button is clicked.

For example,

  1. select the channels using the Select Checkboxes... e.g. Figure 7a where channels 1,2,5,6 are selected
  2. click  Write Selected Channels button. This will cause an input box to be displayed.
  3. enter the desired value (e.g. 12) in the input box and click set button (Figure 7b)
  4. the selected channels are set to 12 (Figure 7c)

Figure 7:  Entering a Threshold value to a group of selected channels

Figure 7a Select some channels using checkbox

Figure 7b Input box

Figure 7c  Values of selected channels has changed

select a group of channels, click
              button above
enter value in input box
value changed on selected group of
              channels


10. Write set values of Threshold and/or ADC-Gain to  ALL Channels of Selected Frontend


To write the same set value to all channels of the selected frontend:


An input box will appear below the appropriate frame in which to enter the value to be written.  Click Set (or Cancel).


Figure 8: Input boxes for writing a set value (Threshold or ADC-Gain) to all channels of selected frontend


checkboxes below frames are checked



11.  Write set values of Threshold  to  a Group of Channels of Selected Frontend

To write the same set Threshold value to a Group of 8 consecutive channels of the selected frontend:


Figure 9a: Writing a set value to a Group of Threshold values

Figure 9b: set value has been written to the selected group

set value to group of thresh
              channels
value has been set to group of thr
              channels



12. Page Updates


The user may update the Custom Page (including the contents of the frames) by pressing the browser Reload button. Parts of the page also update using innerHTML. A timer updates using innerHTML every 15s, so that the current run state is displayed. The timer does not update the contents of the frames. When one of the buttons is pressed, the relevent parts of the page are updated automatically using innerHTML.
Each frame updates when the set values are changed, and when either  Update threshold frame or Update adc frame buttons is pressed. Both frames update if the frontend is changed.
After changing a set value, the set value(s) will change immediately. Since the hardware readback is not instantaneous, the Readback value may not have changed. Click the browser Reload button  after a short interval to see the updated readback.