include/roc/Board.h (r4864/r4162)

Go to the documentation of this file.

#ifndef ROC_BOARD_H
#define ROC_BOARD_H

#include "base/commons.h"

#include "roc/Message.h"

#include "base/Board.h"


namespace roc {

  enum ClientRole {
     roleNone      = base::roleNone,               
     roleObserver  = base::roleObserver,           
     roleControl   = base::roleControl,            
     roleDAQ       = base::roleDAQ                 
   };

   // symbolic names for ROC-related configuration parameters
   extern const char* xmlRocPool;
   extern const char* xmlTransportWindow;
   extern const char* xmlTransportKind;
   extern const char* xmlBoardAddr;
   extern const char* xmlRole;
   extern const char* xmlRocNumber;
   extern const char* xmlLowWater;
   extern const char* xmlHighWater;
   extern const char* xmlMsgFormat;
   extern const char* xmlFlushTime;

   extern const char* typeUdpDevice;
   extern const char* typeAbbDevice;

   enum ERocBufferTypes {
      rbt_RawRocData     = 234
   };
   
   enum ETransportKinds {
      kind_UDP = base::kind_UDP,
      kind_ABB = base::kind_ABB,
      kind_File = base::kind_File
   };

   enum EFrontendKinds {
      kind_nXYTER = 1,  // normal nXYTER
      kind_oldFEET = 2, // old GET4, keep for historical reasons
      kind_FEET = 3,    // new GET4 v1.0,
      kind_newNX = 4    // new readout for nXYTER with SysCore3
   };

   enum EBackendKinds {
      kind_Optic    = 1,  // normal Optic readout - CBMNet v1
      kind_FX20     = 2,
      kind_FX40     = 3,
      kind_FX60     = 4,
      kind_newOptic = 5  // new optic readout - CBMNet v2
   };


   class Board : public base::Board {

      protected:
         Board();
         virtual ~Board();

      public:

         // --------------------------------------------------------------------
         // methods for controlling ROC and components
         // --------------------------------------------------------------------

         static uint32_t getRoclibVersion();
         uint32_t getRocFpgaType();
         uint32_t getRocSvnRev();
         uint32_t getRocBuildTime();

         uint32_t getRocHardwareVersion();
         uint32_t getRocHardwareType();

         uint32_t getRocFrontendKind() { return getRocHardwareType() >> 16; }

         uint32_t getRocBackendKind() { return getRocHardwareType() & 0xffff; }

         virtual uint32_t getRocBackendVersion() { return 0; }


         uint32_t rocNumber() const { return boardNumber(); }

         uint32_t getRocNumber() { return getBoardNumber(); }
         void setRocNumber(uint32_t num) { setBoardNumber(num); }

         int uploadCommandsList(unsigned num, const base::OperList& lst, double tmout = 0.);

         int downloadCommandsList(unsigned num, base::OperList& lst, double tmout = 0.);

         int invokeCommandsList(unsigned num, double tmout = 0.);

         int uploadStartDaqCmdList(bool reset_frontend = false, bool reset_fifo = true);

         int uploadStopDaqCmdList();

         virtual int invokeDLM(unsigned num, double tmout = 0.) { return 0; }

         void clearRocFifo();
         void restartRoc();

         virtual bool restartBoard() { restartRoc(); return true; }


         int getRocThrottleState(uint32_t& val);

         virtual unsigned GetBoardId() const { return rocNumber(); }


         // DAQ functions


         // virtual bool startDaq() = 0;


         // virtual bool suspendDaq() = 0;


         // virtual bool stopDaq() = 0;



         //virtual bool getNextBuffer(void* &buf, unsigned& len, double tmout = 1.) = 0;


         // virtual int getMsgFormat() const = 0;


         //virtual void setFlushTimeout(double tmout) {}



         virtual int setToDefault();


         virtual bool enableCalibration(double period = 10., double calibr = 0.1, int cnt = -1) { return false; }

         virtual bool disableCalibration() { return enableCalibration(-1., -1., 0); }


         static bool IsUdpAddress(const char* name);
         static bool IsOpticAddress(const char* name);
         static bool IsLmdFileAddress(const char* name);

         static Board* Connect(const char* name, ClientRole role = roleDAQ);
         static bool Close(Board* brd);
   };

}

#endif