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);
int _setDefaultConfig(int brd);
 
#endif