FERS_config.h

Go to the documentation of this file.

 
#ifndef _FERSCFG_H
#define _FERSCFG_H              // Protect against multiple inclusion
 
// _Thread_local is C11 with thread support
#if (__STDC_VERSION__ >= 201112L) && !defined(__STDC_NO_THREADS__)
#define THREAD_LOCAL                _Thread_local
#elif defined(_WIN32)
#define THREAD_LOCAL                __declspec(thread)
#elif defined(__GNUC__)
#define THREAD_LOCAL                __thread
#else
#error unsupported compiler
#endif
 
#define ARRAY_SIZE(x)               (sizeof(x)/sizeof((x)[0]))
 
#include "FERSlib.h"
#include "FERS_MultiPlatform.h"
#include "FERS_Registers_520X.h"
#include "FERS_Registers_5215.h"
 
// ***************************************************************************
// Variables
// ***************************************************************************
extern int BoardConnected[FERSLIB_MAX_NBRD]; // = { 0 };            // Board connection status
extern int NumBoardConnected; // = 0;                               // Number of boards connected
extern float CLK_PERIOD[FERSLIB_MAX_NBRD];
extern FERS_BoardInfo_t* FERS_BoardInfo[FERSLIB_MAX_NBRD];  // pointers to the board info structs 
extern uint16_t MaxEnergyRange;
extern float TDL_FiberDelayAdjust[FERSLIB_MAX_NCNC][FERSLIB_MAX_NTDL][FERSLIB_MAX_NNODES];
//****************************************************************************
// struct that contains the configuration parameters (HW and SW)
//****************************************************************************
typedef struct Config_t {
 
    // Board mutex
    mutex_t bmutex;
 
    // System info 
    //char ConnPath[200];                   // IP address of the board. Set by FERSlib_open
    int handle;
 
    // -------------------------------------------------------------
    // Raw data parameters
    // -------------------------------------------------------------
    uint8_t OF_RawData;                                 
    uint8_t OF_LimitedSize;                             
    float MaxSizeDataOutputFile;                        
    char OF_RawDataPath[200];                           
    
    // -------------------------------------------------------------
    // Settings for the acquisition modes and I/O masks
    // -------------------------------------------------------------
    int AcquisitionMode;                                
    int StartRunMode;                                   
    int StopRunMode;                                    
    uint32_t TestMode;                                  
 
    uint32_t TriggerMask;                               
    uint32_t T0_outMask;                                
    uint32_t T1_outMask;                                
    uint32_t Tref_Mask;                                 
    uint32_t Veto_Mask;                                 
    uint32_t Validation_Mask;                           
    uint32_t Validation_Mode;                           
    uint32_t Counting_Mode;                             
    uint32_t TrgIdMode;                                 
    uint32_t EnableServiceEvents;                       
    uint32_t EnableCntZeroSuppr;                        
    uint32_t Dis_tdl;                                   
    uint32_t EnableChannelTrgout;                       
    uint32_t Enable_2nd_tstamp;                         
    uint32_t EnableToT;                                 
    uint32_t WaveformLength;                            
    uint32_t WaveformSource;                            
    uint32_t Range_14bit;                               
    uint32_t En_Empty_Ev_Suppr;                         
    float GateWidth;                                    
    float TrefWindow;                                   
    float TrefDelay;                                    
    float PtrgPeriod;                                   
    float TrgHoldOff;                                   
 
    // -------------------------------------------------------------
    // Settings for Channel enabling
    // -------------------------------------------------------------
    uint64_t ChEnableMask;                              
    uint64_t ChEnableMask_e;                            
 
    // -------------------------------------------------------------
    // Settings for analog and digital probes
    // -------------------------------------------------------------
    uint32_t AnalogProbe[2];                            
    uint32_t DigitalProbe[2];                           
    uint32_t ProbeChannel[2];                           
 
    // -------------------------------------------------------------
    // Settings for DT5215 (Concentrator)
    // -------------------------------------------------------------
    float FiberDelayAdjust[FERSLIB_MAX_NCNC][8][16];    
    uint32_t TdlClkPhase;                               
    uint32_t MaxPck_Block;                              
    uint32_t MaxPck_Train;                              
    uint32_t CncBufferSize;                             
    uint32_t CncProbe_A;                                
    uint32_t CncProbe_B;                                
 
    // -------------------------------------------------------------
    // Settings for FPGA trigger logic
    // -------------------------------------------------------------
    uint64_t Tlogic_Mask;                               
    uint32_t TriggerLogic;                              
    uint32_t MajorityLevel;                             
    float ChTrg_Width;                                  
    float Tlogic_Width;                                 
 
    // -------------------------------------------------------------
    // Settings for XROC ASICs
    // -------------------------------------------------------------
    uint16_t ZS_Threshold_LG[FERSLIB_MAX_NCH_5202];     
    uint16_t ZS_Threshold_HG[FERSLIB_MAX_NCH_5202];     
    uint16_t QD_FineThreshold[FERSLIB_MAX_NCH_5202];    
    uint16_t TD_FineThreshold[FERSLIB_MAX_NCH_5202];    
    uint16_t HG_Gain[FERSLIB_MAX_NCH_5202];             
    uint16_t LG_Gain[FERSLIB_MAX_NCH_5202];             
    uint16_t PAQ_Gain[FERSLIB_MAX_NCH_5204];            
    uint16_t PAQ_Comp[FERSLIB_MAX_NCH_5204];            
    uint16_t HV_IndivAdj[FERSLIB_MAX_NCH_5202];         
    uint16_t InputPolarity[FERSLIB_MAX_NCH_5204];       
    uint64_t QD_Mask;                                   
    uint64_t TD1_Mask;                                  
    uint64_t TD2_Mask;                                  
    uint64_t TD_Mask;                                   
    uint64_t TOTD_Mask;                                 
    uint32_t TD_CoarseThreshold;                        
    uint32_t HG_ShapingTime;                            
    uint32_t LG_ShapingTime;                            
    uint32_t Enable_HV_Adjust;                          
    uint16_t HV_Adjust_Range;                           
    uint16_t T_Gain[FERSLIB_MAX_NCH_5204];              
    uint16_t TD1_CoarseThreshold;                       
    uint16_t TD2_CoarseThreshold;                       
    uint16_t TOTD_CoarseThreshold;                      
    uint16_t QD_CoarseThreshold;                        
    uint16_t TD1_FineThreshold[FERSLIB_MAX_NCH_5204];   
    uint16_t TD2_FineThreshold[FERSLIB_MAX_NCH_5204];   
    uint16_t TOTD_FineThreshold[FERSLIB_MAX_NCH_5204];  
    uint16_t HG_ShapingTime_ind[FERSLIB_MAX_NCH_5204];  
    uint16_t LG_ShapingTime_ind[FERSLIB_MAX_NCH_5204];  
    uint32_t PeakDetectorMode;                          
    uint32_t EnableQdiscrLatch;                         
    uint32_t FastShaperInput;                           
    uint32_t TestPulsePreamp;                           
    int TestPulseDestination;                           
    uint32_t CitirocCfgMode;                            
    float HoldDelay;                                    
    float MuxClkPeriod;                                 
    uint32_t MuxNSmean;                                 
    uint32_t GainSelect;                                
    uint16_t Pedestal;                                  
 
    // -------------------------------------------------------------
    // Settings for Analog Test Pulser
    // -------------------------------------------------------------
    int TestPulseSource;                                
    uint32_t TestPulseAmplitude;                        
 
 
    // -------------------------------------------------------------
    // Settings for HV
    // -------------------------------------------------------------
    float HV_Vbias;                                     
    float HV_Imax;                                      
    float TempSensCoeff[3];                             
    float TempFeedbackCoeff;                            
    int EnableTempFeedback;                             
 
 
    // -------------------------------------------------------------
    // Settings for picoTDC
    // -------------------------------------------------------------
    uint32_t MeasMode;                                  
    uint32_t En_Head_Trail;                             
    uint32_t HighResClock;                              
    uint32_t GlitchFilterDelay;                         
    uint32_t GlitchFilterMode;                          
    uint32_t TDC_ChBufferSize;                          
    uint32_t TriggerBufferSize;                         
    uint32_t HeaderField0;                              
    uint32_t HeaderField1;                              
    uint32_t LeadTrail_LSB;                             
    uint32_t ToT_LSB;                                   
    uint16_t ToT_reject_low_thr;                        
    uint16_t ToT_reject_high_thr;                       
    float TrgWindowWidth;                               
    float TrgWindowOffset;                              
    //uint8_t  En_128_ch;                               //!< Enable 128 channels
    float TDCpulser_Width;                              
    float TDCpulser_Period;                             
    uint32_t Ch_Offset[FERSLIB_MAX_NCH_5203];           
    //uint8_t InvertEdgePolarity[MAX_NCH];              //!< Invert edge polarity. NOTE: can be used in LEAD_TRAIL mode only
 
 
    // -------------------------------------------------------------
    // Settings for Adapters (A5256)
    // -------------------------------------------------------------
    int AdapterType; // MISSING in CFG                  //!< Adapter Type
    float DiscrThreshold[FERSLIB_MAX_NCH_5203];         
    float DiscrThreshold2[FERSLIB_MAX_NCH_5203];        
    int DisableThresholdCalib;                          
    int A5256_Ch0Polarity;                              
 
 
    // -------------------------------------------------------------
    // Generic write accesses 
    // -------------------------------------------------------------
    int GWn;
    uint32_t GWaddr[FERSLIB_MAX_GW];                    
    uint32_t GWdata[FERSLIB_MAX_GW];                    
    uint32_t GWmask[FERSLIB_MAX_GW];                    
 
} Config_t;
extern Config_t* FERScfg[FERSLIB_MAX_NBRD];             // Configuration parameters
 
 
//****************************************************************************
// Functions
//****************************************************************************
int Configure5202(int handle, int mode);
int Configure5203(int handle, int mode);
int Configure5204(int handle, int mode);
int FERS_DumpBoardRegister5202(int handle, char* filename);
int FERS_DumpBoardRegister5203(int handle, char* filename);
int FERS_DumpBoardRegister5204(int handle, char* filename);
int ConfigureProbe5202(int handle);
int ConfigureProbe5203(int handle);
int ConfigureProbe5204(int handle);
void Set_picoTDC_Default(picoTDC_Cfg_t* pcfg);
int Write_picoTDC_Cfg(int handle, int tdc, picoTDC_Cfg_t pcfg, int skipch);
int Read_picoTDC_Cfg(int handle, int tdc, picoTDC_Cfg_t* pcfg);
int Save_picoTDC_Cfg(int handle, int tdc, char* fname);
#endif