---

TApi.h

Go to the documentation of this file.

// File: TApi.h

#ifndef SCTAPI_TAPI_H
#define SCTAPI_TAPI_H

#include <string>
#include <TArrayD.h>
#include <TArrayI.h>
#include <TArrayL.h>
#include <TArrayS.h>

// Declare classes for purposes of CINT interface
namespace SctApi {
class SctApi;
class Trigger;
class Scan; 

class TriggerImpl;
class ScanDefImpl;
}

#include "processor.h"

#include <TObject.h>

using std::string;

// using namespace SctPixelRod;

class TTrigger {
  TTrigger &operator=(const TTrigger &);

 public:
  TTrigger();

  TTrigger(const TTrigger &);

  virtual ~TTrigger();

  void singleL1A();
  void doubleL1A(int delay);
  void calL1A(int delay);
  void pulseL1A(int delay);
  void softL1A(int delay);
  void softCalL1A(int delay, int delay2);
  void softPulseL1A(int delay, int delay2);
  void bcL1A(int delay);
  void bcCalL1A(int delay, int delay2);
  void bcPulseL1A(int delay, int delay2);

  SctApi::Trigger *getTrigger();

  int incCmd;

  int incData;

 private:
  void update();

  SctApi::TriggerImpl *worker;

  // For CINT and ROOT
  ClassDef(TTrigger,1)
};

class TScanDef {
  TScanDef &operator=(const TScanDef &);

 public:
  TScanDef();

  TScanDef(const TScanDef &);

  virtual ~TScanDef();

  void print();

  void configure(UINT16 type, FLOAT32 start, FLOAT32 stop, FLOAT32 step);

  void configure2(UINT16 type, FLOAT32 start, FLOAT32 stop, FLOAT32 step);

  SctApi::Scan *getScan();

  long trigsPerBurst;

  int scanVariable;

  int scanVariable2;

  TTrigger trigSequence;

  TTrigger trigSequence2;

  int format;

  int full;

  int bits32;

  int loopCalLine;

  int distSlave;

  int debug;
 private:
  void update();

  SctApi::ScanDefImpl *worker;

  // For CINT and ROOT
  ClassDef(TScanDef,1)
};

class TApi : public TObject {
  public:
    TApi(int initDebug = 0);

    ~TApi();


    void initialiseAll(int runNumber);

    void shutdownAll();

    void setRunNumber(int newRun);

    void setScanNumber(int newScan);

    /*************** ROD Diagnostics ********************/


    void echo(unsigned int partition, unsigned int crate, unsigned int rod,
              unsigned int length, long *data);

    void loadConfiguration();

    void configureBOC(unsigned int partition, unsigned int crate, unsigned int rod);

    void awaitResponse(unsigned int partition, unsigned int crate, unsigned int rod, int timeout = 5);

    unsigned long *getResponse(unsigned int partition, unsigned int crate, unsigned int rod);

    unsigned long *getResponse(unsigned int partition, unsigned int crate, unsigned int rod, 
                               unsigned long *length);


    bool getRodMessage(unsigned int partition, unsigned int crate, unsigned int rod,
               char *buffer, int &length);


    void flashLED(unsigned int partition, unsigned int crate, unsigned int rod,
          unsigned long slaveNumber, long period = 1000, long flashes = 10);


    void status();

    /***************** Direct ROD access (Debug only) ********************/


    Int_t dspBlockDump(unsigned int partition, unsigned int crate, unsigned int rod,
                       long dspStart, long numWords, long dspNumber);


    Int_t dspBlockDumpFile(unsigned int partition, unsigned int crate, unsigned int rod,
                           long dspStart, long numWords, long dspNumber, const char *filename);


    unsigned long *dspBlockRead(unsigned int partition, unsigned int crate, unsigned int rod,
                       long dspStart, long numWords, long dspNumber, long *length);

    int dspBlockWrite(unsigned int partition, unsigned int crate, unsigned int rod,
                      unsigned long *buffer, unsigned long dspAddress, long numWords, long dspNumber);

    unsigned long readRodStatusReg(unsigned int partition, unsigned int crate, unsigned int rod,
                   long regNumber);

    unsigned long readRodCommandReg(unsigned int partition, unsigned int crate, unsigned int rod,
                    long regNumber);

    unsigned long dspSingleRead(unsigned int partition, unsigned int crate, unsigned int rod,
                const unsigned long dspAddr, long dspNumber);

    void dspSingleWrite(unsigned int partition, unsigned int crate, unsigned int rod,
                        unsigned long dspAddr, unsigned long value, long dspNumber);

    void createDebugPrimList();

    void addDebugPrimList(unsigned long length, long index, long id, long version,
              unsigned long * body);
    void sendDebugPrimList(unsigned int partition, unsigned int crate, unsigned int rod);

    void sendDebugSlavePrimList(unsigned int partition, unsigned int crate, unsigned int rod,
                                unsigned int slave, bool await, bool response);

    unsigned long *retrieveModule(UINT32 mid);

    /**** Official SCTAPI bit (majority unimplemented) ******/


    UINT32 findModule(string sn);

    UINT32 findModule(INT32 mur, INT32 module);

    UINT32 findBarrelModule(INT32 barrel, INT32 row, INT32 number);

    UINT32 findEndcapModule(INT32 disk, INT32 ring, INT32 number);

    void getABCDModule(UINT32 bank);

    void getABCDModule(UINT32 mid, UINT32 bank);

    void setABCDModule(UINT32 mid, UINT32 bank);


    void sendABCDModule(UINT32 mid, UINT32 bank, UINT32 type=2);

    void modifyABCDMask(UINT32 mid, UINT32* mask);

    void modifyABCDTrims(UINT32 mid, UINT8* trims);

    void modifyABCDVar(UINT32 typ, FLOAT32 var);

    void modifyABCDVar(UINT32 mid, UINT32 typ, FLOAT32 var);

    void modifyABCDVar(UINT32 mid, UINT32 c, UINT32 typ, FLOAT32 var);

    void modifyBOCParam(unsigned int partition, unsigned int crate, unsigned int rod,
                        unsigned int channel, unsigned int type, unsigned int val);

    void defaultScan(int type);

    void tidyHistogramming();

    void doScan(TScanDef scan);

    void doRawScan(TScanDef scan, int delay, bool configure = true, bool clkBy2 = false);

    void sendTrigger(unsigned int partition, unsigned int crate, unsigned int rod, TTrigger trig);


    void printABCDModule(int mid);


    void printABCDRodModule(int mid, int bank);

    void printBOCSetup(unsigned int partition, unsigned int crate, unsigned int rod);

    void printBOCRegisters(unsigned int partition, unsigned int crate, unsigned int rod);

    void rawData(unsigned int partition, unsigned int crate, unsigned int rod, int delay, int units, bool setMask = true, TTrigger trig = TTrigger());

    char *probe(unsigned int partition, unsigned int crate, unsigned int rod, signed int harness = -1);

    char *probeWithTrigger(unsigned int partition, unsigned int crate, unsigned int rod, TTrigger trig, signed int harness = -1);

    void bocHistogram(unsigned int partition, unsigned int crate, unsigned int rod, 
                      unsigned int samples, unsigned int numLoops);

    void rodMode(unsigned int partition, unsigned int crate, unsigned int rod,
                 int mode, int flag, int fifoSetup, int nBins, int delay, int message);

    void standardRegisterDump(unsigned int partition, unsigned int crate, unsigned int rod);


    void lasersOff();

    void decodeEvent(unsigned int partition, unsigned int crate, unsigned int rod, 
                     int sl, int index, bool extFlag = false, bool errorType = false);


    void setDebugLevel(unsigned int level);

    unsigned int getDebugLevel();

    void debugStepHistogram();

    void debugContinueHistogram();

    /* *************  TIM functs **************/


    void freeTriggers(unsigned int partition, unsigned int crate,
              double freq);

    void stopTriggers(unsigned int partition, unsigned int crate);

    void timL1A(unsigned int partition, unsigned int crate);

    void timCalL1A(unsigned int partition, unsigned int crate, int delay);

    void requestHardReset(UINT32 mid);

    void printHex(UINT32 num, int width);
 private:
    /********** Should these be part of the API? **************/


    int initialiseRod(unsigned int partition, unsigned int crate, unsigned int rod);


    int initialiseModule(string module);

 private:
    SctApi::SctApi *worker;

    // For CINT and ROOT
    ClassDef(TApi,1)
};

/*  
/*  //extern TApi *tapi; */
#endif

---