/home/kopmann/git-mirror/fdhwlib/fdhwlib/Pbus/Pbus.h

Go to the documentation of this file.

/***************************************************************************

    Pbus.h  -  description
    
    begin                : Thu Jun 29 2000
    copyright            : (C) 2000 by Andreas Kopmann
    email                : kopmann@hpe.fzk.de
 ***************************************************************************/


#if defined (_MSC_VER) && (_MSC_VER >= 1000)
#pragma once
#endif
#ifndef _INC_PBUS_3911814503CA_INCLUDED
#define _INC_PBUS_3911814503CA_INCLUDED


#define PBUS_VER          110
#define PBUS_VERSION      "1.10"
//#define PBUS_VCLASS

//-----programm switches-----
// choose only one of these modes
//#define PBUS_SIM     // enable a protocol of the rw access, do nothing
//#define PBUS_TEST    // test of process synchronization and mEnable
//#define PBUS_DIRECT  // direct hw access
//#define PBUS_IP      // access to the hw via ip connection

#define PBUS_MODE_SIM     0
#define PBUS_MODE_TEST    1
#define PBUS_MODE_DIRECT  2
#define PBUS_MODE_IP      3
#define PBUS_MODE_DMA     4
#define PBUS_MODE_FAST    5
#define PBUS_MODE_1394    6
#define PBUS_MODE_DYN     7
#define PBUS_MODE_PCI     8
#define PBUS_MODE_PCIDMA  9
#define PBUS_MODE_TEMPLATE 99

// For compatibility reasons
#define SIM               PBUS_MODE_SIM
#define TEST              PBUS_MODE_TEST
#define DIRECT            PBUS_MODE_DIRECT
#define IP                PBUS_MODE_IP
#define DMA               PBUS_MODE_DMA
#define FAST              PBUS_MODE_FAST


// Select the appropriate mode in the project file
// don't change the header file. This will cause recompilation
// of nearly all files!!!
// Linux:
//#define PBUS_MODE SIM
//#define PBUS_MODE TEST
//#define PBUS_MODE IP
//#define PBUS_MODE DIRECT

// default value
#ifndef PBUS_MODE
#define PBUS_MODE PBUS_MODE_SIM
#endif

#if defined PBUS_MODE && (PBUS_MODE == PBUS_MODE_SIM)
#define PBUS_SIM
#endif


#if defined PBUS_MODE  && (PBUS_MODE == PBUS_MODE_TEST)
#define PBUS_DIRECT
#define PBUS_TEST
#endif

#if defined PBUS_MODE  && (PBUS_MODE == PBUS_MODE_DIRECT)
#define PBUS_DIRECT
#endif

#if defined PBUS_MODE  && (PBUS_MODE == PBUS_MODE_IP)
#define PBUS_IP
#endif

#if defined PBUS_MODE  && (PBUS_MODE == PBUS_MODE_1394)
#define PBUS_1394
#endif

#if defined PBUS_MODE  && (PBUS_MODE == PBUS_MODE_DYN)
#define PBUS_DYN
#endif

#if defined PBUS_MODE  && (PBUS_MODE == PBUS_MODE_PCI)
#define PBUS_PCI
#endif

#if defined PBUS_MODE  && (PBUS_MODE == PBUS_MODE_PCIDMA)
#define PBUS_PCIDMA
#endif

#if defined PBUS_MODE  && (PBUS_MODE == PBUS_MODE_TEMPLATE)
#define PBUS_TEMPLATE
#endif


//#define PBUS_FAST // use the increment mode in readBlock
                  // To use this function an apropriate flt
                  // design is required!

//#undef PBUS_STATE // report pbus states
//#define PBUS_STATE

#ifdef __GNUC__
//#if defined __GNUC__  && (PBUS_MODE != PBUS_MODE_1394)
// Also the fire wire interface will need the semaphores
// Otherwise we can't keep control of bitwise manipulation
// of regiserts!!!
#ifdef __linux__
#define PBUS_DLL_EXT "so"
#define USE_SEMAPHORE // remove this for no semas
#endif
#ifdef __APPLE__
#define PBUS_DLL_EXT "dynlib"
#define USE_SEMAPHORE
#endif
#endif


#ifdef PBUS_SIM
#define PBUS_MODE_TXT     "Simulation Mode"
#define PBUS_LIB          "Sim"
//#define USE_EXT_SIM
#undef USE_ME
#ifdef __GNUC__
#define USE_SHM
// #undef USE_SEMAPHORE
#else // Windows
#undef USE_SEMAPHORE
#endif
#endif


#ifdef PBUS_DIRECT
#ifdef __linux__
#define LINUX  // the microEnable lib need this
#endif

#ifdef PBUS_TEST
#define PBUS_MODE_TXT     "MicroEnable Test Mode (without FD hardware)"
#define PBUS_LIB          "Test"
#define USE_EXT_SIM
#else
#ifdef PBUS_DMA
#define PBUS_MODE_TXT     "Direct connection via microEnable"
#define PBUS_LIB          "DMA"
#else
#ifdef PBUS_FAST
#define PBUS_MODE_TXT     "Direct connection via microEnable"
#define PBUS_LIB          "Fast"
#else
#define PBUS_MODE_TXT     "Direct connection via microEnable"
#define PBUS_LIB          "Direct"
#endif
#endif
#endif
#define USE_ME
#endif

#ifdef PBUS_IP
#define PBUS_MODE_TXT     "IP connection"
#define PBUS_LIB          "Proxy"
//#undef USE_SEMAPHORE
#ifdef __GNUC__
//#define USE_SEMAPHORE // needed to blPbus::initPbusock parent and child process, if both
                   // use the same socket connection!?
#undef USE_SEMAPHORE
#endif

#ifdef WIN32 // Windows Proxy Implementation flags
// The windows socket implementation needs synchronization
// to be thread safe !!!                        

#define USE_MFC_LOCAL_SYNC // the class semaphores does not work?!
#endif

#undef USE_ME
#endif // end of PBUS_IP


#ifdef PBUS_1394
#define PBUS_MODE_TXT     "Direct connection via IEEE1394"
#define PBUS_LIB          "1394"
#endif

#ifdef PBUS_DYN
#define PBUS_MODE_TXT     "Dynamic loading of the Pbus library"
#define PBUS_LIB          "Dyn"
#endif

#ifdef PBUS_PCI
#define PBUS_MODE_TXT     "Direct connection via SLT-PCI interface"
#define PBUS_LIB          "PCI"
#endif

#ifdef PBUS_PCIDMA
#define PBUS_MODE_TXT     "Direct connection via SLT-PCI interface, DMA enabled"
#define PBUS_LIB          "PCIDMA"
#endif

#ifdef PBUS_TEMPLATE
#define PBUS_MODE_TXT     "Template for other Pbus libraries"
#define PBUS_LIB          "Template"
#endif

// Test switches
//#define USE_SEMAPHORE
//#define USE_MFC_LOCAL_SYNC

//#define EXCEPTIONS



//----------includes------------
#ifdef USE_MFC_LOCAL_SYNC
#include <afxmt.h>
class CMutex;
#endif


#include <cstdio>
#include <ctime>

#include <iostream>
#include <string>
#include <stdexcept>

#if HAVE_STDINT_H
  #include <stdint.h>
#else
    //almost all systems have this; if not, define int32_t and uint32_t -tb-
#endif

#include <akutil/akinifile.h>
#include <akutil/procDuration.h>

#ifdef PBUS_IP
#include <akutil/simplesocket.h>
//#define PBUS_IP_BLOCK     250   // long words,
                                // optimized for FLT_PAGE_SIZE = 1000
                                // means two calls per block !?
#endif

#ifdef USE_ME
#include <menable.h>
#endif

//#ifdef PBUS_1394
//#include <libraw1394/raw1394.h>
//#include <libraw1394/csr.h>
//
//#define PBUS1394_MAXPORTS 16
//#endif

#ifdef PBUS_DYN
#include <dlfcn.h>
#endif

#include <Pbus/MicroEnableError.h>
#include <Pbus/PbusError.h>


#ifdef PBUS_VCLASS
class MicroEnableVersion;
class PbusVersion;
#endif

class PbusImp;

class Pbus
{
public:




  static int init(const char * inifile = "FE.ini", int host = 0);

  static int free(int host = 0);


  int reset();

  unsigned long getState();

  unsigned long getState(unsigned long addr);

  int get(std::string item, std::string *value);

  int set(std::string item, std::string value);  

  
  unsigned long read(unsigned long addr);

  void write(unsigned long addr, unsigned long data);

        int readBlock(unsigned long addr, unsigned long * data,
               unsigned long n, unsigned long incr=1);



        void writeBlock(unsigned long addr, unsigned long * data,
              unsigned long n, unsigned long incr=1);



        void clearBlock(unsigned long addr, unsigned long data,
              unsigned long n, unsigned long incr=1);

  void readRegisterBlock(unsigned long addr, unsigned long *data,
                         unsigned long nPix, unsigned long incrPix,
                         unsigned long nSlots=0, unsigned long incrSlots=0);


        void writeBits(unsigned long addr, unsigned long data, unsigned long mask,
                 int shift);


  void setBitsToHigh(unsigned long addr, unsigned long mask);

  void setBitsToLow(unsigned long addr, unsigned long mask);


        int waitForIR(int timeout = 0);

        int checkIR();

        unsigned long getIRvector();

  int getIRorigin(unsigned long irvector);



  void stop();

  void cont();


#ifdef PBUS_VCLASS
  void displayVersion(FILE *fout);
#endif

  const char * getVersion();

  const char * getMode();

  int getModeId();


#ifdef PBUS_VCLASS
  PbusVersion * getPbusVersion();
#endif

  static int sltVersion;

  static int fltVersion;

  static void selectTelescope(int id);

  static int getTelescope();

  static int getNTelescopes();


  static bool isAvailable();
  
  static bool isConnected(int id=0);


  unsigned long simReadIRvector();

  void simWriteIRvector(unsigned long vector);


  static void setDebugLevel(int level);

public: // Members

  static void debugMsg(const char *msg, ...);

private:

  static bool pImpAvailable;

  static bool pImpConnected;


#ifdef PBUS_VCLASS
  static PbusVersion * pver;
#endif


#ifdef PBUS_DYN

  static void *dllHandle;

  //static Pbus *pPbusDll;
#endif


//protected:
public:
  static PbusImp *pImp;

};


#endif /* _INC_PBUS_3911814503CA_INCLUDED */