CAENcard.h

Go to the documentation of this file.

/*
#
#    This software is Copyright by the Board of Trustees of Michigan
#    State University (c) Copyright 2005.
#
#    You may use this software under the terms of the GNU public license
#    (GPL).  The terms of this license are described at:
#
#     http://www.gnu.org/licenses/gpl.txt
#
#     Author:
#             Ron Fox
#            NSCL
#            Michigan State University
#            East Lansing, MI 48824-1321
#
*/

#ifndef CAENCARD_H
#define CAENCARD_H

#include <stdio.h>
#include <sys/types.h>
#include <sys/stat.h>
#include <sys/mman.h>
#include <errno.h>
#include <fcntl.h>
#include <unistd.h>
#include <signal.h>
#include <sys/ioctl.h>

#ifndef __CVMEINTERFACE_H
#include <CVMEInterface.h>
#endif

#ifndef SPECTRODAQ_H
 // Hate to do this here, but I have no real choice:

#ifdef HAVE_STD_NAMESPACE
using namespace std;
#endif

#include <spectrodaq.h>
#endif


#ifndef HAVE_VME_MAPPING
#include <VmeModule.h>          // Needed to access registers via peek/poke.
#endif

//Constants used to determine the type of data being returned from the card

#define CAEN_DATUM_TYPE    0x07000000
#define CAEN_HEADER        0x02000000
#define CAEN_DATA          0x00000000
#define CAEN_FOOTER        0x04000000
#define CAEN_INVALID       0x06000000


class CAENcard {
 public:                        // Data types
  typedef enum _ChainMember {   // Possible chain memberships
    NotInChain,
    FirstInChain,
    LastInChain,
    IntermediateInChain
  } ChainMember;

 protected:
  int    m_nSlot;               
  int    m_nCrate;              
  bool   m_fGeo;                
  unsigned long   m_nBase;      
#ifdef HAVE_VME_MAPPING
  volatile unsigned short* m_pModule;   
#else
  CVmeModule* m_pModule;
#endif
  long   m_nCardType;          
  void*  m_nFd;                 
  int    m_nSerialno;           
  int    m_nHardwareRev;        
  bool   m_fSmallThresholds;    
  int    m_nInvalidTrailers;    
  int    m_nChancountHigh;      
  int    m_nChancountLow;       
  int    m_nEvents;             
  unsigned short m_nFirmware;    




/*************************begin public section*********************************/
public:
  //
  // Constructors and canonical operations.
  //
  
  CAENcard(int slotNum = -1, int crateNum = 0, 
           bool fGeo=true, long nBase = 0); 
  CAENcard(const CAENcard& card); 
  CAENcard& operator=(const CAENcard& card); 
  ~CAENcard();          

  // selectors:
  int getPhysicalCrate() const {
    return m_nCrate;
  }
  int getSlot() const {
    return m_nSlot;
  }
  bool isGeo() const {
    return m_fGeo;
  }
  unsigned long getBase() const {
    return m_nBase;
  }
  int getSerial() const {
    return  m_nSerialno;
  }
  int getHardwareRev() const {
    return m_nHardwareRev;
  }

  //   Operations on the card.

    int  cardType();            
  int  getFirmware();           
    int  getCrate();            
    void setCrate(int crateNum);  
    void setThreshold(int ch, int threshold); 
    void setThresholdVoltage(int ch, double voltage);
    void keepUnderThresholdData(); 
    void discardUnderThresholdData(); 
    void keepOverflowData();    
    void discardOverflowData(); 
    void keepInvalidData();     
    void discardInvalidData();  
    void emptyEnable();         
    void emptyDisable();        
    void commonStart();         
    void commonStop();          
    void setRange(int range);   
    void setPedestalCurrent(int ped);
    void cardOff();             
    void cardOn();              
    void channelOff(int ch);    
    void channelOn(int ch);     
    void resetEventCounter();   
    void clearData();           
    void reset();               
    bool dataPresent();         
    bool gdataPresent();
    bool Busy();
    bool gBusy();
    bool MEBFull();
    bool MEBEmpty();
    int readEvent(void* buf);   
    int readEvent(DAQWordBuffer& wbuf, int offset);
    int readEvent(DAQWordBufferPtr& wp); 
    int readEvent(DAQDWordBuffer& dwbuf, int offset);
    int readEvent(DAQDWordBufferPtr& dwp); 
    void setIped(int value); 
    int  getIped();     
    void setFastClearWindow(int n);  
    void enableSmallThresholds();   
    void disableSmallThresholds();  
  void SetCBLTChainMembership(int cbltaddr,
                              ChainMember where); 

  void ClearStatistics();       
  int  InvalidTrailerCount();
  int  ChannelsTooBigCount();
  int  ChannelsTooSmallCount();
  int  EventCount();

  //Utility functions:
protected:
  void  DestroyCard();          
  void  slotInit();             
  void  MapCard();              
private:
   void Bitset1(short mask);    
   void Bitclear1(short mask);  
   void Bitset2(short mask);    
   void Bitclear2(short mask);  
   void ReadBufferBlock(int* pDest, Int_t size); // Read block from data buf.
};

#endif

---