roclib/src_base/Board.cxx (r4864/r4190)

Go to the documentation of this file.

#include "base/Board.h"

#include <stdio.h>
#include <stdarg.h>
#include <string.h>

//----------------------------------------------------------------------------

const char* base::roleToString(base::ClientRole role)
{
   switch (role) {
      case roleNone: return 0;
      case roleObserver: return "Observer";
      case roleControl: return "Control";
      case roleDAQ: return "DAQ";
   }
   return 0;
}

//----------------------------------------------------------------------------

base::ClientRole base::defineClientRole(const char* name, base::ClientRole dflt)
{
   if ((name==0) || (strlen(name)==0)) return dflt;
   if (strcmp(name,"Observer")==0) return roleObserver;
   if (strcmp(name,"Control")==0) return roleControl;
   if (strcmp(name,"DAQ")==0) return roleDAQ;
   return dflt;
}



base::Board::Board() :
   fBrdFactory(0),
   fDefaultTimeout(2.),
   fVerbosity(0),
   fOperTrace(1),
   fRole(roleNone),
   fBrdNumber(0)
{
}

base::Board::~Board()
{
}

//----------------------------------------------------------------------------

void base::Board::Debug(int lvl, const char *fmt, ...)
{
   if (!fmt || (lvl>getVerbosity())) return;

   va_list args;
   va_start(args, fmt);

   int  result(128), length(128);
   char *buffer = 0;
   while (result==length) {
      if (buffer) delete [] buffer;
      length *= 2;
      buffer = new char [length + 1];
      memset(buffer, 0, length + 1);
      result = vsnprintf(buffer, length, fmt, args);
      if (result<0) break;
   }

   if (fBrdFactory)
      fBrdFactory->ShowDebug(lvl, buffer);
   else
      fprintf(lvl<0 ? stderr : stdout, "%s\n", buffer);

   delete [] buffer;
   va_end(args);
}



//----------------------------------------------------------------------------

void base::Board::traceOper(OperList& lst, int rc)
{
   if (fOperTrace == 0) return;
   if (fOperTrace == 1 && rc != kOperNetworkErr) return;
   if (fOperTrace == 2 && rc == 0) return;

   for (int i=0; i<lst.number(); i++) {
      const char* aname = findRegNameByAddress(lst.oper(i).addr);
      if (aname==0) aname = "???";

      if (lst.number() == 1) {
         Debug(0, "%3s   (%u,%08x %-27s) %s 0x%08x %10d %s",
                  (lst.oper(i).isput ? "put" : "get"),
                  GetBoardId(), lst.oper(i).addr, aname,
                  (lst.oper(i).isput) ? "<-" : "->",
                  lst.oper(i).value, lst.oper(i).value,
                  (rc == 0) ? "ok" : "FAIL");

      } else {
         const char* stat = "";
         if (i == lst.number()-1) stat = (rc == 0) ? "ok" : "FAIL";
         Debug(0, "op[%02d](%u,%08x %-27s) %s 0x%08x %10d %s",
               i, GetBoardId(), lst.oper(i).addr, aname,
               (lst.oper(i).isput ? "<-" : "->"),
               lst.oper(i).value, lst.oper(i).value, stat);
      }

      if (rc != 0) {
         std::string str = operErrToString(rc);
         Debug(0, "   %s", str.c_str());
      }
   }
}

int base::Board::operGen(bool* isput,
                        uint32_t* addr,
                        uint32_t* value,
                        int num,
                        double tmout)
{
   OperList lst(num, isput, addr, value);

   int res = operGen(lst, tmout);

   for (int n=0;n<num;n++)
      if (!isput[n]) value[n] = lst.oper(n).value;

   return res;
}


int base::Board::put(uint32_t addr, uint32_t value, double tmout)
{
   bool isput = true;

   return operGen(&isput, &addr, &value, 1, tmout);
}

int base::Board::get(uint32_t addr, uint32_t& value, double tmout)
{
   bool isput = false;

   return operGen(&isput, &addr, &value, 1, tmout);
}


//----------------------------------------------------------------------------

int base::Board::operPP(uint32_t addr0, uint32_t  val0p,
                       uint32_t addr1, uint32_t  val1p,
                       double tmout)
{
  bool isput[2];
  uint32_t addr[2];
  uint32_t data[2];

  isput[0] = true;  addr[0] = addr0;    data[0] = val0p;
  isput[1] = true;  addr[1] = addr1;    data[1] = val1p;

  int rc = operGen(isput, addr, data, 2, tmout);
  return rc;
}

//----------------------------------------------------------------------------

int base::Board::operPG(uint32_t addr0, uint32_t  val0p,
                       uint32_t addr1, uint32_t& val1g,
                       double tmout)
{
  bool isput[2];
  uint32_t addr[2];
  uint32_t data[2];

  isput[0] = true;  addr[0] = addr0;    data[0] = val0p;
  isput[1] = false; addr[1] = addr1;

  int rc = operGen(isput, addr, data, 2, tmout);
  val1g = data[1];
  return rc;
}

//----------------------------------------------------------------------------

int base::Board::operPPP(uint32_t addr0, uint32_t  val0p,
                        uint32_t addr1, uint32_t  val1p,
                        uint32_t addr2, uint32_t  val2p,
                        double tmout)
{
  bool isput[3];
  uint32_t addr[3];
  uint32_t data[3];

  isput[0] = true;  addr[0] = addr0;    data[0] = val0p;
  isput[1] = true;  addr[1] = addr1;    data[1] = val1p;
  isput[2] = true;  addr[2] = addr2;    data[2] = val2p;

  int rc = operGen(isput, addr, data, 3, tmout);
  return rc;
}

//----------------------------------------------------------------------------

int base::Board::operGGG(uint32_t addr0, uint32_t&  val0p,
                        uint32_t addr1, uint32_t&  val1p,
                        uint32_t addr2, uint32_t&  val2p,
                        double tmout)
{
  bool isput[3];
  uint32_t addr[3];
  uint32_t data[3];

  isput[0] = false;  addr[0] = addr0;
  isput[1] = false;  addr[1] = addr1;
  isput[2] = false;  addr[2] = addr2;

  int rc = operGen(isput, addr, data, 3, tmout);

  val0p = data[0];
  val1p = data[1];
  val2p = data[2];

  return rc;
}

//----------------------------------------------------------------------------

int base::Board::operPPPP(uint32_t addr0, uint32_t  val0p,
                         uint32_t addr1, uint32_t  val1p,
                         uint32_t addr2, uint32_t  val2p,
                         uint32_t addr3, uint32_t  val3p,
                         double tmout)
{
  bool isput[4];
  uint32_t addr[4];
  uint32_t data[4];

  isput[0] = true;  addr[0] = addr0;    data[0] = val0p;
  isput[1] = true;  addr[1] = addr1;    data[1] = val1p;
  isput[2] = true;  addr[2] = addr2;    data[2] = val2p;
  isput[3] = true;  addr[3] = addr3;    data[3] = val3p;

  int rc = operGen(isput, addr, data, 4, tmout);
  return rc;
}

//----------------------------------------------------------------------------

const char* base::Board::operErrCodeName(int rc)
{
   switch(operErrCode(rc)) {
      case kOperSuccess:    return "success";
      case kOperAddrErr:    return "invalid address";
      case kOperValueErr:   return "value not allowed";
      case kOperStateErr:   return "operation not allowed";
      case kOperNetworkErr: return "communication error";
      case kOperVerifyErr:  return "readback verify error";
      case kOperBusErr:     return "secondary bus error";
   }
  return "";
}

//----------------------------------------------------------------------------

std::string base::Board::operErrToString(int rc)
{
  char buf[32];
  if (rc <0) {
    snprintf(buf, sizeof(buf), "rc = %d", rc);
    return std::string(buf);
  }

  snprintf(buf, sizeof(buf), "rc = %4d,%2d -> ",
           operErrIndex(rc), operErrCode(rc));
  std::string str(buf);
  return str+operErrCodeName(rc);
}


//----------------------------------------------------------------------------

void base::Board::addRegAddrMapping(const char* name, uint32_t addr)
{
  std::string sname(name);
  fMapName2Addr[sname] = addr;
  fMapAddr2Name[addr]  = sname;
}

//----------------------------------------------------------------------------

uint32_t base::Board::findRegAddressByName(const char* name)
{
  mapn2a_t::iterator it = fMapName2Addr.find(std::string(name));
  if (it != fMapName2Addr.end())
    return it->second;
  return kAddrError;
}


//----------------------------------------------------------------------------

const char* base::Board::findRegNameByAddress(uint32_t addr)
{
   if (addr==kAddrError) return 0;
   mapa2n_t::iterator it = fMapAddr2Name.find(addr);
   if (it != fMapAddr2Name.end())
     return it->second.c_str();            // ok because entries never deleted
   return 0;
}

//----------------------------------------------------------------------------

void base::Board::printRegAddressMap(std::ostream& os, bool byname)
{
   char sbuf[1000];

   if (byname) {
      for (mapn2a_t::iterator it=fMapName2Addr.begin(); it!=fMapName2Addr.end(); it++) {
         snprintf(sbuf, sizeof(sbuf), "0x08x : %s", (unsigned) it->second, (const char*) (it->first.c_str()));
         os << sbuf << std::endl;
      }
   } else {
      for (mapa2n_t::iterator it=fMapAddr2Name.begin(); it!=fMapAddr2Name.end(); it++) {
         snprintf(sbuf, sizeof(sbuf), "0x08x : %s", (unsigned) it->first, (const char*) (it->second.c_str()));
         os << sbuf << std::endl;
      }
   }
}

//----------------------------------------------------------------------------
void base::Board::fillRegAddrNames(std::list<std::string>& lst)
{
   for (mapn2a_t::iterator it=fMapName2Addr.begin(); it!=fMapName2Addr.end(); it++)
      lst.push_back(it->first);
}



//----------------------------------------------------------------------------

const char* base::Board::versionToString(uint32_t ver)
{
   static char sbuf[100];
   snprintf(sbuf, sizeof(sbuf), "%u.%u.%u.%u",
           (ver >> 24),
           (ver >> 16) & 0xff,
           (ver >> 8) & 0xff,
           ver & 0xff);
   return sbuf;
}


base::Board* base::Board::Connect(const char* url, ClientRole role)
{
   return base::BoardFactory::CreateBoard(url, role);
}

bool base::Board::Close(Board* brd)
{
   return base::BoardFactory::DestroyBoard(brd);
}


//----------------------------------------------------------------------------

uint32_t base::Board::getHardwareVersion()
{
   uint32_t val = 0;
   get(base::addr_HardwareVersion, val);
   return val;
}

//----------------------------------------------------------------------------

uint32_t base::Board::getHardwareType()
{
   uint32_t val = 0;
   get(base::addr_HardwareType, val);
   return val;
}


//----------------------------------------------------------------------------

uint32_t base::Board::initBoard(const char* name, uint32_t minversion)
{
   base::OperList lst;
   lst.addGet(base::addr_BoardId);
   lst.addGet(base::addr_HardwareVersion);
   lst.addGet(base::addr_HardwareType);
   if (operGen(lst)!=0) return 0;

   fBrdNumber          = lst.oper(0).value;
   uint32_t roc_hw_ver = lst.oper(1).value;
   uint32_t roc_typ    = lst.oper(2).value;

   if(roc_hw_ver < minversion) {
      Debug(-1, "The %s you want to access has hardware version %s", name, versionToString(roc_hw_ver));
      Debug(-1, "Please update your hardware to version %s", versionToString(minversion));
   }

   const char* fe_typ = "<unknown>";
   switch (roc_typ >> 16) {
      case base::kind_nXYTER:  fe_typ = "nXYTER"; break;
      case base::kind_oldFEET: fe_typ = "FEET 0.1"; break;
      case base::kind_FEET:    fe_typ = "FEET"; break;
      case base::kind_newNX:   fe_typ = "nXYTER 2.0"; break;
      case base::kind_SPADIC:  fe_typ = "SPADIC"; break;
   }

   const char* be_typ = "<unknown>";
   switch (roc_typ & 0xffff) {
      case base::kind_Optic: be_typ = "Optic"; break;
      case base::kind_FX20:  be_typ = "Eth-FX20"; break;
      case base::kind_FX40:  be_typ = "Eth-FX40"; break;
      case base::kind_FX60:  be_typ = "Eth-FX60"; break;
      case base::kind_newOptic: be_typ = "Optic2"; break;
   }

   Debug(0, "BRD%u %s HW version: %s; front:%s; back:%s",
         fBrdNumber, name, versionToString(roc_hw_ver), fe_typ, be_typ);

   return roc_hw_ver;
}


//----------------------------------------------------------------------------

uint32_t base::Board::getBoardNumber()
{
   uint32_t num = 0;
   if (get(base::addr_BoardId, num)==0)
      fBrdNumber = num;
   return num;
}


//----------------------------------------------------------------------------

void base::Board::setBoardNumber(uint32_t num)
{
   put(base::addr_BoardId, num);
}



// =============================================================================

base::BoardFactory* base::BoardFactory::gArr[base::BoardFactory::MaxNumFactories] =
                   { 0, 0, 0, 0, 0, 0, 0, 0, 0, 0 };

//----------------------------------------------------------------------------

base::BoardFactory::BoardFactory()
{
   for (int n=0;n<MaxNumFactories;n++)
     if (gArr[n]==0) {
        gArr[n] = this;
        break;
     }
}

//----------------------------------------------------------------------------

base::BoardFactory::~BoardFactory()
{
   for (int n=0;n<MaxNumFactories;n++)
     if (gArr[n]==this) gArr[n] = 0;
}

//----------------------------------------------------------------------------


base::Board* base::BoardFactory::CreateBoard(const char* url, ClientRole role)
{
   if ((url==0) || (strlen(url)==0)) return 0;

   // first check
   for (int n=0;n<MaxNumFactories;n++) {
     if (gArr[n]==0) continue;
     if (!gArr[n]->IsFactoryFor(url)) continue;

     base::Board* brd = gArr[n]->DoConnect(url, role);

     if (brd==0) {
        fprintf(stderr,"Fail to create board with url %s\n", url);
        return 0;
     }

     brd->fBrdFactory = gArr[n];

     return brd;
   }

   fprintf(stderr,"Cannot create board with url %s - no proper factory found\n", url);

   return 0;
}

bool base::BoardFactory::DestroyBoard(base::Board* brd)
{
   if (brd==0) return true;

   BoardFactory* fact = brd->fBrdFactory;

   if (fact==0) return false;

   return fact->DoClose(brd);
}


void base::BoardFactory::ShowDebug(int lvl, const char* msg)
{
   if (msg!=0) fprintf(lvl<0 ? stderr : stdout, "%s\n", msg);
}