====== Catania 09 TB ======

Going to acquire:
  - Start counter (1 or 2): Scintillator
  - Tracker: DCH
  - Dump: Scintillator 

=== STC ===

Readout (splitted channels): 
  * 2 channels that go to Discriminator to NIM - ECL converter to Fast TDC.
  * 2 channels go to WVF

=== Dump ===

Readout (splitted channels): 
  * 2 channels that go to Discriminator to NIM - ECL converter to Fast TDC.
  * 2 channels go to WVF


=== DCH ===

Readout :
  * 16 channels that go to discriminator to NIM - ECL converter to Fast TDC.

===== Hardware =====

==== Power Supply ====

  - Low voltage Power supply for DCH readout [OK]
  - Low voltage Power supply for STC [OK]

==== Gas ====

  - Gas mixture: Ar, CO2, Iso [available @ CT]
  - Gas pipes + connections [available @ CT]
  - Mixer + fluximeter : to be brought


==== Cables ====

HV cables

  - 2 cables are needed for DCH [@ CT]
  - 2(3) cables are needed for Dump or CsI [@ CT]

LV cables

  - LV is needed by Photomultipliers of STC


Chmb Acquisition

  - Need 16 Long Lemo from CHMb to Discriminator
  - Need 16 short Lemo from Discriminator to Nim - Ecl converter
  - Need 16 flat cables from converter to TDC

STC + Dump Acquisition 

  - Need 6 Long Lemo from detector to Splitter
  - Need 6 Short Lemo from Splitter to Discriminator
  - Need 6 Short Lemo from Splitter to WVD
  - Need 6 Short Lemo from Discriminator to Trigger Logic

Trigger Logic

  - Need Short Lemo cables from Discriminator to Coincidence unit

==== HV ====

  - Two HV modules needed (one for STC + Dump and one for DCH)

==== LV ====

  - One module plus cables is needed [brought it]

==== Trigger ====

  - 1 PLU [need 1 as spare] for 4 input from scintillators
    - Exit goes to 
        * TDC trigger
        * WFD trigger
        * I/O reg trigger
  - Dual timer: needed to implement busy

==== DAQ ====

  - Splitter [Splitting cables?? will save module]
     * Needed to split the output of Scintillators to TDC, WVD
     * Available only 4 Channels: Ok for 1 STC + Dump. **Problem if STC>1 or DCH splitted**
  - Discriminator
     * Need to discriminate 16 (max) DCH +  4 Dump + STC
     * Currently available only 8 chs : **2*8 chs missing**
  - Coincidence Unit
  - I/O Register
  - Converter
     * 2 modules available: 1*16 + 1*8 = 24 chs total [OK]
  - Fast TDC
     * 64 Channels available [OK]
  - WaveForm digitizer
     * 8 Chs available with sampling @ 500 MHz [OK?]

===== Software =====

==== ACQ Code ====

=== Acquisition ===

The acquisition code is compiled on the CPU.
Performs the reading of the various modules (returning each a vector with the needed information)
and also the event writing. Writing is implemented as unformatted/binary.
  - Hardware: CPU
  - Code location: /home/daq/CT 
  - Running instructions:
    - compile with make acquire
    - run with ./acquire + options.
Provided options are:
  - [-n] : number of events to be acquired
  - [-p] : number of events on which the ACQ rate is computed
  - [-f] : Full path to output file (binary, unformatted)
  - [-z] : switch on and off of zero suppression

=== Monitoring ===

  - Hardware: PC daq
  - Code location: /home/daq/acq
  - Running instructions:
    - compile with make Analizer
    - run with ./Analizer + options
Provided options are:
  - [-in] : full path top input file (link to data/ dire of acquisition is provided)
  - [-out] : output root file

==== Event structure ====

  - Evt num
  - Num boards
  - Then for each of the boards in the event: b{j}_nwords [j=0,N_boards]
  - Then for each of the boards in the event: b{j}_words{i} [j=0,N_boards][i=0,b{j}_nwords]

Boards order:
  - IOREG
  - TDC1190
  - WVD

=== Structure of Board events ===

== IOREG ==

To be implemented

== TDC1190 ==
  - 1w ->Evnum
  - 3w*n_firing_cha ->For each firing channel 3 words containing event number channel and measurement are stored
  - 1w ->Trailer (possible check of errors)

== WVD ==

To test the zero suppression you need to test the 3rd word  of the event, checking the 24th bit (if == 1 -> zs data):  data>>24 & 0x1; 

  - if zero suppression
    - 1w -> n of words in the event
    - 1w -> falg for checking ZS data
    - 1w -> mask of enabled channels
    - 1w -> Trigger time
    - Then For each channel
      - 1w -> Total channel words [included this one] 
      - 1w -> Number of 32 bit words skipped
        - nsam*1w -> Number of words with samples over threshold
        - 1w -> Number of 32 bits skipped
  - else
    - 1w -> n of words in the event
    - 1w -> falg for checking ZS data
    - 1w -> mask of enabled channels
    - 1w -> Trigger time
    - 512w*ncha -> 512 words for each enabled channel


==== To Do List ====

  - Test TDC
  - Calibrations
    * 32 chs TDC
    * 8 chs