From tigwiki

[edit] Chris's description -- start here

Parameters are stored in odb tree: /Equipment/Trigger/settings

This page contains global settings and subdirectories for each collector: master,slave1-6

[edit] Global settings

  Command                 ...   - Used for testing
  block start stop        n     - Used for testing
  use_dma_transfer        0     - Use 64bit block transfer mode (still has bugs?)
  frontend_event_assembly 1     - Assemble events in frontend (delays data)
  debug_event_interval    25000 - Print event contents on terminal
  debug event channels    490   - Number of channels to print
  debug channel offset    0     - Starting channel to print
  frontend_quiet          n     - disable frontend error messages
  Trigger Mode            2     - select one of the predefined trigger modes
  Prescale Factor         25    - Allows control of one prescale factor
  Reinitialise            n     - Perform full system reset at run start **
  Hardware Gainmatch      y     - Recently added + can cause some confusion
  .
  **Do Not use Reinitialise unless it solves some problem.  Particularly do not change
  several settings, attempting to solve a daq problem, and then leave them all changed
  without determining which (if any) had the desired effect.

[edit] Master and Slave Subdirectories

  Collector Mask          0     - bitmask for which ports contain TIG-C (1=TIGC)
  Disabled Port Mask 0xf000     - bitmask for disabled ports (1=Disabled)
  Port Detector Type  0x492     - bitmask for detector type attached to each port 0=GE 1=BGO
  GE                            - Subdirectory containing Ge  settings
  BGO                           - Subdirectory containing BGO settings

[edit] The Ge/BGO Subdirectories

• Time-related quantities are in units of samples (10ns)
• Amplitude-related quantities are in units of samples (16k samples = 1V or 4V)

  channel trigger mask     1    - bitmask for which channels generate trigger requests
  Pedestal                 0    - unused?
  Hit Threshold           50    - Threshold for Charge/Time calculation
  Trigger Threshold       50    - Threshold for Trigger request
  Hit Detector Clip Delay 30    - >= MaxRiseTime for risetime-independant-threshold
  Pre-trigger            100    - Waveform samples before trigger position
  Sample window size      10    - Number of Waveform samples
  K_param                500    - Integration time
  L_param                580    - Window width
  Mode                0x3610    - See below
  Latency                140    - Fudge factor
  CFD Delay               10    - 
  Attenuation factor     500    - Should be same as Integration time
  Dispersion               4    - Chan/KeV, when Hardware gainmatched
  M Param[120]          5000    - Preamplifier signal Decay time
  Delta Threshold[120]     0    - individual channel threshold tuning
  Gain[120]             ~0.6    - Gains for hardware gainmatching

The relationship between the Latency L, Pre-Trigger P, and Sample window size S are as follows. Once a Master Trigger Request comes back down from the Master Card, the waveform buffer is inspected starting (L+P) samples back, and reads S samples. Ideally the Latency (Fudge Factor) should be set to the real amount of time between when the TIG-10 generates a pre-trigger and the time when the master trigger data request returns.

[edit] Mode bits

The mode bits on the 16-bit mode word are as follows:

The original documentation from Chris is as follows

  default: 0       0 : Enable simulation       
           0       1 : Suppress Raw Data
           0       2 : select deconvoluted raw data
           0       3 : Positive input
           ---------
          01     4-5 : Baseline Restore speed (1,8,64,256)
           0       6 : Freeze blr
           0       7 : Disable Trigger Request (was select clipped mode)
           ---------
           0       8 : Disable ADC
          00    9-10 : DC Offset (00:-ve offset,11:+ve,01:central(bipolar)
           0      11 : 0=>High Gain(1V range), 1=>Low Gain (4V range)
           ---------
           1      12 : Enable Zero-suppression (was board revision)
           1      13 : 1 => Board Revision=2   (i.e. invert Polarity/Offset)
           0      14 :                         (was board revision)
           0      15 :                         (was board revision)
           ---------

A useful list of HEX words is here #Useful Hex Words

A HEX word generator for this task can be found at http://trshare.triumf.ca/~garns/TIGRESS_HEX_words.html

[edit] Frequently asked but sometimes Unanswerable Questions

[edit] How do I set up a "Disabled Port Mask"?

How to set a port mask. Note that the ports that are disabled are the ones that are empty.

The Disabled port mask tells the TIG-C which ports not to read from (In reverse it tells the master which ports the ethernet cables from each collector card are plugged into). See in the photo to the right of the VME crate which the master and collector cards occupy.

• Starting from the top of the TIG-C and working down the disabled port mask binary word is built.
• Ports which have cables plugged into them are set to 0 and the ports which are empty are set to 1.
• There are 12 ports so the last 4 bits of the 16 bit binary word will always be 1111.
• Convert the binary word to Hex (The scientific calculator on linux can help alot here!). Enter the word in Hex form into the odb.
• Remember that just because an ethernet cable is plugged into a port on the master does not mean that the other end of that cable is plugged into a collector - follow the cables!

[edit] How do I set up a "Port Detector Type" mask?

The port numbering on the TIG-C modules follows the same convention for the Port Detector Type mask as it has for the Disabled Port Mask, the top port is Port 0, through to the bottom port which is Port 12.

• Starting from the top of the Top of the TIG-C and working down build the binary word
• 0 is germanium, 1 is BGO
• Thus for the standard TIGRESS setup of ge,bgo,ge,ge,bgo,ge for each detector, with two detectors per slave TIG-C we get 0x492 in hex

[edit] Useful Hex words