---

crate.h

Go to the documentation of this file.

#ifndef SCTAPI_CRATE
#define SCTAPI_CRATE

#include <list>
#include <map>
#include <memory>
#include <mrs/message.h>

#include <boost/thread.hpp>
#include <boost/shared_ptr.hpp>

#include "primListWrapper.h"

#include "RodCrate/TimModule.h"              // For TimMaskFrequency
#if USE_THREADS
enum RodPrimState { MYPRIM_LOADED, MYPRIM_EXECUTING, MYPRIM_COMPLETE, MYPRIM_IDLE };
#endif

using boost::shared_ptr;

namespace SctPixelRod {
  class RodOutList;
  class RodModule;
/*   class TimModule; */   // Included anyway
}

class VmeInterface;

namespace SctConfiguration {
  class Configuration;
}

namespace SctApi {
  struct RodStatus {
#if USE_THREADS
    std::list<boost::shared_ptr<PrimListWrapper> > listQueue;
    boost::mutex mutex;
    RodPrimState currState;
#endif
    int slaves;
  };

class Crate {
  // Don't use copy constructor or assignment operator
  Crate(const Crate&);
  Crate &operator=(const Crate&);
 public:

  Crate(unsigned int partition, unsigned int crate, 
        boost::shared_ptr<SctConfiguration::Configuration> newConf = boost::shared_ptr<SctConfiguration::Configuration>() );

  ~Crate();

  /************** Interaction with Configuration **************/


  int initialiseTim();


  int initialiseRod(unsigned int rod);


  int initialiseBOC(unsigned int rod);


  int configureBOC(unsigned int rod);

  /*************** Primlists *********************/


  int sendPrimList(unsigned int rod, shared_ptr<PrimListWrapper> prim);


  int sendPrimListAll(shared_ptr<PrimListWrapper> prim);


  int awaitResponse(unsigned int rod, int timeout);


  int awaitResponseAll(int timeout);


  shared_ptr<SctPixelRod::RodOutList> getResponse(unsigned int rod);

  void setMrsStream(MRSStream *stream);

  /***************** Messages ******************/


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

  /************** Misc read/writes *****************/


  int mdspBlockRead(unsigned int rod, long dspStart, unsigned long *buffer, long numWords);


  int slvBlockRead(unsigned int rod, long dspStart, unsigned long *buffer, long numWords, long slaveNumber);


  int slvBlockWrite(unsigned int rod, long dspStart, unsigned long* buffer, long numWords, long dspNumber);


  int mdspBlockWrite(const unsigned int rod, const long dspStart, unsigned long *buffer, const long numWords);


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



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


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


  int dspSingleWrite(unsigned int rod, unsigned long dspAddr, unsigned long buffer, long dspNumber);

  void status();


  enum PLControl {
    C_PL_STOP,
    C_PL_PAUSE,
    C_PL_RESUME,
    C_PL_CANCEL };

  void primListControl(unsigned int rod, PLControl function);

  void printBOCSetup(unsigned int rod);

  void printBOCRegisters(unsigned int rod);

  bool checkBOCLasersOn(unsigned int rod);

  void enterBOCClockBy2Mode(unsigned int rod);

  void leaveBOCClockBy2Mode(unsigned int rod);

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

  void lasersOff();

  /* ******************* TIM Functions ***************************/

  void freeTriggers(SctPixelRod::TimMaskFrequency freq = SctPixelRod::TIM_MASK_TRIG_10_0KHZ);

  void stopTriggers();

  void timL1A();

  void timCalL1A(int delay);

  bool slavePresent(int rod, int index) const;

  bool RODPresent(int rod) const;

 private:

  SctPixelRod::RodModule *getRod(unsigned int rod) const;

  const RodStatus &getRodData(unsigned int rod) const;
  RodStatus &getRodData(unsigned int rod);

  void doTextBuffer(SctPixelRod::RodModule &rod0);

#if USE_THREADS
  void pollingLoop();
#endif

  typedef std::map<unsigned int, std::pair<RodStatus *, SctPixelRod::RodModule *> > RodMap;

  RodMap rodMap;

  SctPixelRod::TimModule *tim;

  boost::shared_ptr<SctConfiguration::Configuration> config;

  SctPixelRod::VmeInterface *vme;

  const unsigned int partition;

  const unsigned int crate;

  MRSStream *mrs;

  // Leave this in for no threads (its nice and small...)
  bool stopPolling;

#if USE_THREADS

  std::list<shared_ptr<PrimListWrapper> > listQueueAll;

  /* **********  Mutexes  ********** */
  boost::mutex vmeMutex;

  /* ******* Threads ******/
  std::auto_ptr<boost::thread> pollThread;
#endif
};

}  // End of namespace SctApi
#endif

---