FTPC Electronics to DAQ Mapping






 MapFtpcElectronicsToDaq contains the programs which map the FTPC electronics to
 daqrows and daqpads (see Mapping).

 Hardware:
      2 FTPC's - FTPC west and FTPC East
      10 padrows/FTPC
      6 sectors/padrow
      160 pads/sector; 960 pads/padrow
      60 sectors/FTPC
      9600 pads/FTPC
       

 Electronics:
      20 readout boards (RDO)
      10 RDO/FTPC
      3 mezzanine cards/RDO
      6 asics/mezzanine card (only 5 used for FTPC)
      30 sectors/FTPC
      2 daqrows/sector
      160 daqpads/daqrow
      320 daqpads/sector

  The Asic (A-F) mapping within the Daq ADCR bank  is A,B,C,D,E,(F),
  where the RDO sends the Fee-Cards in the order (1,3,5,2,4,(6)).The RDO 
  sends 20 bit words (10 lower, 10 upper bits).  Each of the 10 bits holds 
  the information from one card.

  RDO sending (Fred):
  
  19........10,9..........0        
      2              1
  19........10,9..........0        
      4              3
  19........10,9..........0        
      6              5
 
  ASIC mapping (Tonko):

  19........10,9..........0   
        D            A
  19........10,9..........0   
        E            B
  19........10,9..........0   
        F            C
       
  ADCR Bank:

  -----------------
         A
  -----------------
         B
  -----------------
         C
  -----------------
         D
  -----------------
         E
  -----------------
        (F)
  -----------------


  Each FTPC has 30 sectors. Each sector contains 2 daqrows and 320 daqpads
  (160 daqpads/daqrow).  The counting of the daqrow within the physical row
  is linear i.e. 
  
  West:
  row 1 == daqrows  1-6 ; sectors 1-6
  row 2 == daqrows 7-12 ; sectors 7-12
  ....
  
  East:
  row 1 == daqrows  1-6  ; sectors 6-1
  row 2 == daqrows  7-12 ; sectors 12-7
  ....
  
  Within a daqrow the daqpads are counted linearly from 1-160.
  The pads within a row a counted counter clockwise for both FTPCs  
  looking in direction of the positive z-axis (west) in the STAR 
  global coordinate system. 

  !!!!!  IT'S NOT SYMMETRIC IN RESPECT TO THE COLLISION POINT !!!!!!!!
  
  This means that pad 1 of each row of the west FTPC starts on sectors 
  1 7 13 19 25 and for the east FTPC on sectors 6 12 18 24 30.
  
  The FTPC's are read out by 20 RDOs which contain 3 Mezzanine cards each.
  The readout cycle between the FTPC RDO and the DAQ Receiver is as following:
  
  The RDO sends first the first time sequence of the first pad of FEE-Card 1,
  followed by the first time sequence of first pad of FEE-Card 2 ....... .
  Each Mezzanine serves one sector and each Asic within the Mezzanine
  handles one FEE-Card.
  
  Due to the fact the we have less pads (320) per Mezzanine than the TPC
  (384) the RDO sends junk data for the 6th Asic of all Mezzannine cards 
  which looks like a phantom FEE-Card.
  
  Software:
    
    Asic_Row - create an include file which defines the asic to hardware 
               sector relationship.
   
               Input Files: 
                             padfinder.h  - defines the Receiver-Mezzanine 
                                            to daqrow mapping
                             ASIC_MAP.h   - defines the Mezzanine-ASIC to
                                            daqpad mapping
                             Asic_Row.c
         
                Executable:
                             make Asic_Row

                Output File:
                             ASIC_ROW.h   - defines Receiver-Mezzanine-Asic
                                            to daqpad mapping
                                           

     FtpcKeys -

                Input Files: 
                             ASIC_MAP.h
                             ASIC_ROW.h
                             FtpcKeys.c

                Executable:
                             make FtpcKeys
                  
                Output File:
                             FTPC_PADKEY.h  - this is the file Tonko uses
                                              in the DAQ to map the 
                                              FTPC electronic signals to
                                              daqrow and daqpad

   Use "make clean" to remove files created by "Asic_Row" and "FtpcKeys"