Setting Up for Forced-Trigger Runs

This page describes how to setup the data acquisition system to take forced-trigger data. "Forced trigger" refers to situations in which acquisitions are triggered by external pulses rather than nsum signals. Currently supported run-types that operate under the forced-trigger condition are ID and OD peripheral LED runs, and US and Japanese laser runs. At this time, we ask that no other run-types be attempted without consulting a trigger expert.

Forced trigger data can be taken in two modes, forced acquisition or global acquisition. "Forced acquisition" means that data is acquired from every channel regardless of whether or not that channel was over threshold. "Global acquisition" acquires data only from those channels which go over threshold after the arrival of the trigger signal. The setup for both modes is the same so that the timing of the external pulse does not have to be adjusted to switch modes. The acquisition mode may be selected on the data-taking control panel.

The external pulse is sent to the trigger via one of 10 inputs on a NIM-ECL converter in the NIM crate below the trigger. The location of the NIM crate and a close-up of the NIM-ECL converter are shown in the photos. Inputs 1-5 are sent to the ID, and inputs 6-10 are sent to the OD. Which input the trigger actually reads is set by the value of the calibration_source variable in the appropriate on command block in the KamTrigger.kts script. We ask that these settings not be changed except by a trigger expert. The current settings are as follows:

Run type Input
ID LED 1
US laser 2
Jp. laser 3
OD LED 6

In addition to the NIM-ECL converter there is also a TTL-NIM converter available for use in the crates below the trigger. The user is responsible for making his external signal TTL or NIM.

Some runs require supernova triggers to be disabled. Connect the two limo cables that disable supernova triggers if this is necessary. Make sure that you disconnect the cables when you are finished taking your data.


A close-up of a few of the modules in the NIM crate below the trigger.


A close-up of a few of the modules in the NIM crate below the trigger.

If the signal is not on the same grounding path as the trigger, it must be ground isolated before connecting it to the trigger in order to not introduce grounding loops into the system. There is a panel of transformer isolators at the bottom of the trigger rack to accomplish this. Currently several transformers are available for use. If in the future this panel becomes full, it is the responsibility of the user to provide his own ground isolation.

In nearly all cases it is necessary to delay the external signal before sending it to the trigger to ensure that the desired pulses are captured by the ATWDs. Right now there are six gate generators being used to delay signals. Two are used by the Japanese laser system, two by the OD LED system, one by the ID LED system, and the last is used by the US laser system. The settings on these gate generators should not be touched in order to expedite system setup in the future. Be particularly careful not to touch modules labelled "Adjusted for Timing [date]".

Even if a system seems to have not been modified since the last time it was used, it is still a good idea to check the timing before attempting to run. In fact, to date there have been only one or two instances in which it was not necessary to make adjustments before running. Setting the delay properly is the most difficult part of the setup, and we recommend a trigger expert be present if possible. If not, we ask that a trigger expert be contacted so that he can make himself immediately available by phone during the adjustment.

To set the delay, do the following:

  • Ensure that PMT pulses come after the external trigger. Look at the external trigger (before it is sent through the ground isolator or the delay) on an oscilliscope along with one (or more) of the PMT signals that you want to acquire, as demonstrated in Figure 1. Verify that PMT pulses are actually coming (that is, that your laser or LED is flashing), and that those pulses arrive after the external trigger. If they don't you will need to adjust the way the trigger pulses are produced or the length of the cable until they do.
  • Ensure that the PMT pulses come after the delayed external trigger. Do the same as before, but look at the external trigger after it comes out of the delay and before it is sent to the NIM-ECL converter. This verifies that pre-trigger electronics (i.e. the transformer isolator and/or gate generator) are working.
  • Send the external pulse to the trigger. Connect the delay output to the proper input on the NIM-ECL converter. You may wish to send one of the other delay outputs to the oscilliscope to check yourself later on.
  • Read the trigger clock on the scope. The clock on the trigger is fanned out to all the FBE crates on the same ribbon cables that carry the trigger signals. There is one spare ribbon cable resting above crate 4 that is used for diagnostic purposes for ID triggers (see Figure 2). For OD calibrations, it will be necessary to use instead the thinnest of the ribbon cables connected to the back of the OD crate. In both cases, the two wires on the side of the cable colored brown carry the clock signal, as shown in Figure 3. To read the clock, you need to connect it to the scope via one of our make-shift differential probes. These probes, one of which is shown in Figure 4, consist of two wires connected to either side of a resistor on one end, and to a black connector at the other end. Connect the black connector to the clock wires on the ribbon cable using a female-to-female ribbon cable connector, or just using two wires if the connector cannot be found. Insert the ends of the resistor into two of the oscilliscope inputs, and connect the ground of the probe to the oscilliscope ground, as shown in Figure 5. The 40 MHz clock signal should be visible on both scope inputs (see Figure 6), although one should be the negative of the other. (Note: to read the "true" differential signal, one would need to subtract one of these signals from the other, but that is not necessary for our purposes).
  • Run the trigger and find the trigger signal. Login as daq on hoots11 (if you don't know the password, probably you shouldn't be messing with the trigger on your own. Get some help). Go to daq/sys/KamDAQ/Trigger/Scripts. Copy KamTrigger.kts to KamTrigger[your name].kts and open the new file in your favorite editor. Find the declaration of the variable "enable_calibration_ft" and initialize it to "1" instead of "0". Then find the declaration of the variable "calibration_source" and initialze it to the ECL input number for your signal. Save the file, and at the command line type "tinykinoko KamTrigger[your name].kts -f". The trigger should now be sending signals to the ATWDs along the same ribbon cable from which you read the clock earlier. Move the probe to the next wire over from the clock and look for the signal on the scope. If you cannot find it, ask a trigger expert.
  • Set the delay. Look at the trigger pulse from the ribbon cable on the scope and connect a pmt signal immediately before it is sent into an ATWD input. Adjust the delay on the gate generator until the earliest pmt signal arrives ~40 ns after trigger pulse. If the delay is set to its minimum and the PMT pulses are still coming too early, try by-passing the gate generator entirely. If the PMT pulses are still too early, you will need to modify the way the external pulse is created or shorten the cable length to make it arrive earlier.
  • Check with other PMTs It is a good idea to check the timing with several PMTs in different regions of the detector. Just keep in mind that if you need to connect an extension for PMT cables that won't reach the scope, you will have to add 5 ns per meter to get the timing right.
  • Check the timing on any other input signals. Some runs, for example US and Japanese laser runs, have required an additional signal to be sent to the ATWDs. In order for these signals to be captured, they must be timed to arrive coincident with the PMT signals. This timing should be adjusted after the delay for the external pulse has been set as described above.
  • Clean up End tinykinoko on hoots11 by pressing ctrl-c. Copy your KamTrigger[your name].kts script to your directory if you would like to keep it, but delete it from the trigger scripts directory on the daq account to keep it clean. Next return all PMT cables back to their proper inputs. If you make a mistake, we will not take data from those tubes until your mistake is discovered. So if you are unsure of yourself, find an expert to help you. It is also important that you do not tangle the cables up. The cables from one board must not be entangled with those from another board so that the boards can be completely removed without disconnecting cables. If you do get the cables tangled, the FBE experts will be upset with you. Return the make-shift differential probe and it's connector/wires to where you found them. Clean up any other cabling mess and turn off the scope.


Figure 1: a PMT pulse following an external trigger
Pink: external pulse from the OD LED flasher.
Yellow: signal on an OD PMT


Figure 2: the location of the spare ribbon cable that sends clocks and trigger commands to the FBE crates. This ribbon cable should be used for setting up ID calibrations. For OD calibrations, use a similar cable connected to the back of Crate 6.


Figure 3: a close-up of the ribbon cable with the female-to-female connector attached.


Figure 4: the make-shift probe used to examine the clock and trigger pulses on the scope.


Figure 5: connecting the make-shift probe to the scope


Figure 6: the clock signal