CalibFormats/SiPixelObjects/interface/PixelFECConfigInterface.h - master - githubmirror/cmssw

CalibFormats/SiPixelObjects/interface/PixelFECConfigInterface.h
161 строка6 KB
Shahzad Malik Muzaffar
[ALCA] Changes suggested by new llvm18 clang-format
05 сен 2024, 17:03
05 сен 2024, 17:03dfd2283
#ifndef PIXELFECCONFIGINTERFACE_H
#define PIXELFECCONFIGINTERFACE_H
/**
*   \file CalibFormats/SiPixelObjects/interface/PixelFECConfigInterface.h
*   \brief This class intends to define an abstract interface for the commands to talk to the PixelFEC.
*
*   ******THIS SHOULD REALLY BE IN A SEPARATE PACKAGE*****
*
*   A longer explanation will be placed here later
*/

#include <vector>
#include <string>
#include "CalibFormats/SiPixelObjects/interface/PixelHdwAddress.h"

namespace pos {
  /*! \class PixelFECConfigInterface PixelFECConfigInterface.h "interface/PixelFECConfigInterface.h"
*   \brief This class implements..
*
*   A longer explanation will be placed here later

*/
  class PixelFECConfigInterface {
  public:
    PixelFECConfigInterface() {}

    virtual ~PixelFECConfigInterface() {}

    //Generate the commands needed to set the trim and mask bits that
    //are specified by the vector allPixels.

    virtual void setMaskAndTrimAll(const PixelHdwAddress& theROC,
                                   const std::vector<unsigned char>& allPixels,
                                   const bool buffermode = false) = 0;

    virtual void setDcolEnableAll(const PixelHdwAddress& theROC,
                                  unsigned char maskAndTrim,
                                  const bool buffermode = false) = 0;

    //Generate the commands needed to set the trim and mask bits for all
    //pixels to the common value specified by maskAndTrim.
    // DO WE REALY NEED THIS?? Danek 15/4/08
    //virtual void setMaskAndTrimCommon(const PixelHdwAddress& theROC,
    //			      unsigned char maskAndTrim,)=0;

    //Generate the commands needed to set the DAC values for a ROC.
    virtual void setAllDAC(const PixelHdwAddress& theROC,
                           const std::vector<unsigned int>& dacs,
                           const bool buffermode = false) = 0;

    virtual int roctrimload(int mfec,
                            int fecchannel,
                            int hubaddress,
                            int portaddress,
                            int rocid,
                            const std::vector<unsigned char>& allPixels) = 0;

    virtual int rocinit(int mfec, int fecchannel, int hubaddress, int portaddress, int rocid, int mask, int trim) = 0;

    virtual int injectrstroc(const int mfec, const int bitstate) = 0;
    virtual int injecttrigger(const int mfec, const int bitstate) = 0;
    virtual int injectrsttbm(const int mfec, const int bitstate) = 0;
    virtual int injectrstcsr(const int mfec, const int bitstate) = 0;
    virtual int enablecallatency(const int mfec, const int bitstate) = 0;
    virtual int disableexttrigger(const int mfec, const int bitstate) = 0;
    virtual int loopnormtrigger(const int mfec, const int bitstate) = 0;
    virtual int loopcaltrigger(const int mfec, const int bitstate) = 0;
    virtual int callatencycount(const int mfec, const int latency) = 0;
    virtual int getversion(const int mfec, unsigned long* data) = 0;
    virtual int getversion(unsigned long* data) = 0;

    virtual int progdac(int mfec,
                        int fecchannel,
                        int hubaddress,
                        int portaddress,
                        int rocid,
                        int dacaddress,
                        int dacvalue,
                        bool buffermode = false) = 0;

    virtual int clrcal(
        int mfec, int fecchannel, int hubaddress, int portaddress, int rocid, bool buffermode = false) = 0;

    virtual int calpix(int mfec,
                       int mfecchannel,
                       int hubaddress,
                       int portaddress,
                       int rocid,
                       int coladdr,
                       int rowaddress,
                       int caldata,
                       bool buffermode = false) = 0;

    virtual int tbmcmd(int mfec,
                       int fecchannel,
                       int tbmchannel,
                       int hubaddress,
                       int portaddress,
                       int offset,
                       int databyte,
                       int direction) = 0;

    virtual int dcolenable(int mfec,
                           int mfecchannel,
                           int hubaddress,
                           int portaddress,
                           int rocid,
                           int dcol,
                           int dcolstate,
                           bool buffermode = false) = 0;

    //Need to give this a different name as otherwise ambiguous
    virtual int progpix1(int mfec,
                         int mfecchannel,
                         int hubaddress,
                         int portaddress,
                         int rocid,
                         int coladdr,
                         int rowaddress,
                         int mask,
                         int trim,
                         bool buffermode = false) = 0;

    virtual int progpix(int mfec,
                        int mfecchannel,
                        int hubaddress,
                        int portaddress,
                        int rocid,
                        int coladdr,
                        int rowaddress,
                        unsigned char databyte,
                        bool buffermode = false) = 0;

    virtual int qbufsend(void) = 0;

    virtual void fecDebug(int newstate) = 0;

    virtual int delay25Test(int mymfec,
                            int myfecchannel,
                            int myhubaddress,
                            int mytbmchannel,
                            int myportaddress,
                            int myrocid,
                            int mymask,
                            int mytrim,
                            int nTry,
                            int commands,
                            int& success0,
                            int& success1,
                            int& success2,
                            int& success3,
                            int& success4) = 0;

    virtual int rocreset(int mfec, int fecchannel, int tbmchannel, int hubaddress) = 0;

    //virtual void setVCalDAC(std::string ROC, unsigned char dac)=0;

    //... maybe some more
  };
}  // namespace pos
#endif