source: fact/FADctrl/FAD.cc@ 10118

/********************************************************************\

  FAD.cc

  Main class of FADCtrl


 Comment 19/10/2010: It is assumed that boolean access is an atomic operation.
     
\********************************************************************/

#include "FAD.h"
using namespace std;

static const struct CL_Struct { const char *Name;    
              void (FAD::*CommandPointer)();
                          bool NeedIdle;
                          unsigned int MinNumParameter;
                          const char *Parameters;
                          const char *Help;
  } CommandList[] = 
  {{"board", &FAD::cmd_board, true, 1, "[+|-]<range>" ,"Activate or deactivate boards"},
   {"status", &FAD::cmd_status, false, 0, "[range]", "Show board status information"},
   {"domino", &FAD::cmd_domino, true, 1, "<on|off>", "Switch Domino wave"},
   {"dwrite", &FAD::cmd_dwrite, true, 1, "<on|off>", "Set DWRITE"},
   {"phase", &FAD::cmd_phase, true, 1, "<phase>", "Adjust ADC phase (in 'steps')"},
   {"srclk", &FAD::cmd_srclk, true, 1, "<on|off>", "Set SRCLK"},
   {"sclk", &FAD::cmd_sclk, true, 1, "<on|off>", "Set SCLK"},
   {"trigger", &FAD::cmd_trigger, false, 0, "[n|cont|stop|enable|disable]", "Issue software triggers"},
   {"roi", &FAD::cmd_roi, true, 2, "<channel range> <value>", "Set region-of-interest to value"},
   {"dac", &FAD::cmd_dac, true, 2, "<range> <value>", "Set DAC numbers in range to value"},
   {"address", &FAD::cmd_address, true, 2, "<range> <value>", "Set addresses in range to value"},
   {"send", &FAD::cmd_send, true, 1, "<value>", "Send arbitrary data to board"},
   {"take", &FAD::cmd_take, true, 1, "<n> <dir>", "Start run with n events, write to directory"},
   {"acalib", &FAD::cmd_acalib, true, 0, "[n|invalidate|file]", "Perform or read amplitude calibration (n events)"},
   //{"wmode", &FAD::cmd_wmode, 0, "<run|stop>", "Domino wave running or stopped during read out"},
   //{"rmode", &FAD::cmd_rmode, 0, "<first|stop>", "Readout start at first bin or stop position (DRS4)"},
   //{"dmode", &FAD::cmd_dmode, 0, "<single|continuous>", "Domino wave single shot or continuous"},
   {"stop", &FAD::cmd_stop, false, 0, "", "Stop current operation/run"},
   {"update", &FAD::cmd_update, false, 1, "<sec>", "Minimum delay between updates to DIM event service"},                 
   {"socketmode", &FAD::cmd_socketmode, true, 1, "<com|daq>", "Choose which Sockets are used for data transmission"},             
   {"exit", &FAD::cmd_exit, true, 0, "", "Exit program"},
   {"help", &FAD::cmd_help, false, 0, "", "Print help"}};



// ------------------------------------
// *****  Constructor/Destructor  *****
// ------------------------------------

//
// Constructor
// 
FAD::FAD(): EvidenceServer(SERVER_NAME) {

  // Initialization
  ConsoleText = NULL;
  MainThread = pthread_self();
  Mode = idle;
  Datafile = -1;
  EventUpdateDelay = atof(GetConfig("EventUpdateDelay", "0.5").c_str());

  // Create pipe for data exchange
  if (pipe(Pipe) == -1) Message(FATAL, "pipe() failed in FAD::FAD() (%s)", strerror(errno));

  // DIM console service used in PrintMessage()
  ConsoleOut = new DimService(SERVER_NAME"/ConsoleOut", (char *) "");

  // Construct boards
  BoardList = Tokenize(GetConfig("BoardList","129.217.160.119"));
  BoardList = Tokenize("192.33.99.225");

  for (unsigned int i=0; i<BoardList.size(); i++) {
    Boards.push_back(new class FADBoard(BoardList[i], 5000, this, i));

        // Check if initialised OK
        if (!Boards.back()->InitOK) {
          Message(WARN, "Failed to initialize board %s\n", BoardList[i].c_str());
          delete Boards.back();
          Boards.pop_back();
        }
  }

  // Create DIM event service thread
  int Ret;
  if ((Ret = pthread_create(&Thread, NULL, (void * (*)(void *)) LaunchEventThread,(void *) this)) != 0) {
    Message(ERROR, "pthread_create() failed in FAD::FAD() (%s)", strerror(Ret));
        Thread = pthread_self();
  }

  // Install DIM command (after all initialized)
  Command = new DimCommand((char *) SERVER_NAME"/Command", (char *) "C", this);
}

//
// Destructor
//
FAD::~FAD() {

  int Ret;

  // Close pipe (will make read() on pipe in DIM service thread return)
  if (close(Pipe[0]) == -1) Message(ERROR, "close() on Pipe[0] failed in FAD::~FAD() (%s)", strerror(errno));;
  if (close(Pipe[1]) == -1) Message(ERROR, "close() on Pipe[1] failed in FAD::~FAD() (%s)", strerror(errno));;

  // Wait for DIM service thread to quit
  if (pthread_equal(Thread, pthread_self()) == 0) {
        if ((Ret = pthread_join(Thread, NULL)) != 0) Message(ERROR, "pthread_join() failed in ~FAD() (%s)", strerror(Ret));
  }

  // Delete all boards (cancels threads automatically)
  for (unsigned int i=0; i<Boards.size(); i++) delete Boards[i];

  delete Command;
  delete ConsoleOut;
  free(ConsoleText);  
}

// ------------------------------
// *****  Command handling  *****
// ------------------------------

//
// DIM command handler
// Handler must be non-blocking, otherwise a DIM rpc would dead-lock.
//
void FAD::commandHandler() {

  char *Command = getCommand()->getString();

  // Ignore empty or illegal strings
  if (getCommand()->getSize() == 0 || *(Command+getCommand()->getSize()-1) != '\0' ||
          strlen(Command) == 0) return;

  // Shell command
  if (Command[0]=='.') {
    system(&(Command[1]));
    return;
  }

  // Parse command into tokens
  Parameter.clear();
  char *Start; 
  while(true) {
    while (isspace(*Command)) Command++; // Ignore initial white spaces
    if(*Command=='\0') break;
    if (*Command == '\"') {
          Start = ++Command;
      while(*Command!='\"' && *Command!='\0') Command++;
    }
    else {
          Start = Command;
      while(!isspace(*Command) && *Command!='\0') Command++;
    }
    if(*Command != '\0') *Command++ = '\0';
        Parameter.push_back(Start);
  }

  // Search for command in command list
  for(unsigned int i=0; i<sizeof(CommandList)/sizeof(CL_Struct); i++) {
    if (Match(Parameter[0], CommandList[i].Name)) {
          // Check if number of parameters
      if(Parameter.size()-1 < CommandList[i].MinNumParameter) {
                PrintMessage("Usage: %s %s\n", CommandList[i].Name, CommandList[i].Parameters);
                return;
          }
          // Check if idle mode required
          if (CommandList[i].NeedIdle && Mode != idle) {
                PrintMessage("Current mode is not idle ('stop' will stop current operation)\n");
                return;
          }
          // Jump to command function
          (this->*CommandList[i].CommandPointer)();
          return;  
    }
  }
  
  PrintMessage("Unknown command '%s'\n", Parameter[0].c_str());
}

//
// Switch SRCLK
//
void FAD::cmd_srclk() {

  for (unsigned int i=0; i<Boards.size(); i++) {
        if (Match(Parameter[1],"on")) Boards[i]->Send(CMD_SRCLK_ON);
        else if (Match(Parameter[1],"off")) Boards[i]->Send(CMD_SRCLK_OFF);
  }

  if (Match(Parameter[1],"on")) PrintMessage("SRCLK switched on for all active boards\n");
  else if (Match(Parameter[1],"off")) PrintMessage("SRCLK switched off for all active boards\n");
  else PrintUsage();
} 

//
// Switch socket mode
// "com" - command mode (only socket 0 is used)
// "daq" - daq mode (only sockets 1 - 7 are used)
// 
//      Note that socket 0 is always used to issue commands
//
void FAD::cmd_socketmode() {

  for (unsigned int i=0; i<Boards.size(); i++) {
        if (Match(Parameter[1],"com")) Boards[i]->Send(CMD_Stop);
        else if (Match(Parameter[1],"daq")) Boards[i]->Send(CMD_Start);
  }

  if (Match(Parameter[1],"com")) PrintMessage("all active boards switched to command mode - socket 0\n");
  else if (Match(Parameter[1],"daq")) PrintMessage("all active boards switched to DAQ mode - socket 1..7\n");
  else PrintUsage();
} 

//
// Switch SCLK
//
void FAD::cmd_sclk() {

  for (unsigned int i=0; i<Boards.size(); i++) {
        if (Match(Parameter[1],"on")) Boards[i]->Send(CMD_SCLK_ON);
        else if (Match(Parameter[1],"off")) Boards[i]->Send(CMD_SCLK_OFF);
  }

  if (Match(Parameter[1],"on")) PrintMessage("SCLK switched on for all active boards\n");
  else if (Match(Parameter[1],"off")) PrintMessage("SCLK switched off for all active boards\n");
  else PrintUsage();
} 

//
// Switch Domino wave
//
void FAD::cmd_domino() {

  for (unsigned int i=0; i<Boards.size(); i++) {
        if (Match(Parameter[1],"on")) Boards[i]->Send(CMD_DENABLE);
        else if (Match(Parameter[1],"off")) Boards[i]->Send(CMD_DDISABLE);
  }
  
  if (Match(Parameter[1],"on")) PrintMessage("Domino wave switched on for all active boards\n");
  else if (Match(Parameter[1],"off")) PrintMessage("Domino wave switched off for all active boards\n");
  else PrintUsage();
} 

//
// Switch DWRITE
//
void FAD::cmd_dwrite() {

  for (unsigned int i=0; i<Boards.size(); i++) {
        if (Match(Parameter[1],"on")) Boards[i]->Send(CMD_DWRITE_RUN);
        else if (Match(Parameter[1],"off")) Boards[i]->Send(CMD_DWRITE_STOP);
  }

  if (Match(Parameter[1],"on")) PrintMessage("DWRITE set high for all active boards\n");
  else if (Match(Parameter[1],"off")) PrintMessage("DWRITE set low for all active boards\n");
  else PrintUsage();
} 

//
// Issue soft trigger
//
void FAD::cmd_trigger() {

  int Num;
  
  for (unsigned int i=0; i<Boards.size(); i++) {
        if (Parameter.size() == 1) Boards[i]->Send(CMD_Trigger);
        else if (ConvertToInt(Parameter[1], &Num)) {
          for (int j=0; j<Num; j++) {
            Boards[i]->Send(CMD_Trigger);
                usleep(10000);
          }
        }
        else if (Match(Parameter[1],"continuous")) Boards[i]->Send(CMD_Trigger_C);
        else if (Match(Parameter[1],"stop")) Boards[i]->Send(CMD_Trigger_S);
        else if (Match(Parameter[1],"enable")) Boards[i]->Send(CMD_TRIGGERS_ON);
        else if (Match(Parameter[1],"disable")) Boards[i]->Send(CMD_TRIGGERS_OFF);
        else {
          PrintUsage();
          break;
        }
  }

  if (Match(Parameter[1],"enable")) PrintMessage("all active boards accept now incoming triggers\n");
  else if (Match(Parameter[1],"disable")) PrintMessage("no active board accepts any incoming trigger anymore.\n");
} 

//
// Set DAC
//
void FAD::cmd_dac() {

  int Value;
  struct Range R = {0, NDAC-1};
  unsigned short Buffer[2*NDAC] = {0};

  // Check ranges  
  if(!ConvertToRange(Parameter[1], R)) {
        PrintMessage("Error, DAC number out of range.\n");
        return;
  }
  
  if (!ConvertToInt(Parameter[2], &Value) || Value<0 || Value>MAX_DACVAL) {
        PrintMessage("Error, DAC value out of range.\n");
        return;
  }
  
  // Prepare command buffer
  for (int i=R.Min; i<=R.Max; i++) {
        Buffer[2*i] = htons(CMD_Write | (BADDR_DAC + i));
        Buffer[2*i+1] = htons(Value);
  }

  // Send command buffer
  for (unsigned int i=0; i<Boards.size(); i++) {
        Boards[i]->Send(Buffer, sizeof(Buffer));
  }
} 

//
// Set region-of-interest
//
void FAD::cmd_roi() {

  int Value;
  struct Range R = {0, NChips*NChannels-1};
  unsigned short Buffer[2*NChips*NChannels] = {0};

  // Check ranges  
  if (!ConvertToRange(Parameter[1], R)) {
        PrintMessage("Error, ROI number out of range.\n");
        return;
  }
  
  if (!ConvertToInt(Parameter[2], &Value) || Value<0 || Value>MAX_ROIVAL) {
        PrintMessage("Error, ROI value out of range.\n");
        return;
  }
  
  // Prepare command buffer
  for (int i=R.Min; i<=R.Max; i++) {
        Buffer[2*i] = htons(CMD_Write | (BADDR_ROI + i));
        Buffer[2*i+1] = htons(Value);
  }
  
  // Send command buffer
  for (unsigned int i=0; i<Boards.size(); i++) {
        Boards[i]->Send(Buffer, sizeof(Buffer));
  }
} 

//
// Set addresses to value
//
void FAD::cmd_address() {

  int Value;
  struct Range R = {0, MAX_ADDR};
  unsigned short Buffer[2*MAX_ADDR] = {0};

  // Check ranges  
  if (!ConvertToRange(Parameter[1], R)) {
        PrintMessage("Error, address out of range.\n");
        return;
  }
  
  if (!ConvertToInt(Parameter[2], &Value) || Value<0 || Value>MAX_VAL) {
        PrintMessage("Error, value out of range.\n");
        return;
  }
  
  // Prepare command buffer
  for (int i=R.Min; i<=R.Max; i++) {
        Buffer[2*i] = htons(CMD_Write | i);
        Buffer[2*i+1] = htons(Value);
  }
  
  // Send command buffer
  for (unsigned int i=0; i<Boards.size(); i++) {
        Boards[i]->Send(Buffer, 2*(R.Max-R.Min+1)*sizeof(unsigned short));
  }
} 

//
// Set ADC phase
//
void FAD::cmd_phase() {

  int Value;

  if (!ConvertToInt(Parameter[1], &Value)) {
        PrintMessage("Error, illegal phase value\n");
        return;
  }
  
  // Prepare command buffer
  unsigned short *Buffer = new unsigned short [abs(Value)];
  for (int i=0; i<abs(Value); i++) Buffer[i] = htons(CMD_PS_DO);
  
  // Execute phase setting
  for (unsigned int i=0; i<Boards.size(); i++) {
    Boards[i]->Send(CMD_PS_RESET);
    if (Value < 0) Boards[i]->Send(CMD_PS_DIRDEC);
        else Boards[i]->Send(CMD_PS_DIRINC);
        Boards[i]->Send(Buffer, abs(Value)*sizeof(unsigned short));
  }
  
  delete[] Buffer;
} 

//
// Send arbitrary data to board
//
void FAD::cmd_send() {

  int Value;

  if (!ConvertToInt(Parameter[1], &Value) || Value<0 || Value>MAX_VAL) {
        PrintMessage("Error, illegal value\n");
        return;
  }
  
  for (unsigned int i=0; i<Boards.size(); i++) Boards[i]->Send(Value);
} 

/*
// Set Domino mode
void FAD::cmd_dmode() {
  if (Match(Param[1],"continuous")) SetDOMINOMode(1);
  else if (Match(Param[1],"single")) SetDOMINOMode(0);
  else PrintUsage();
} 

// Set Domino readout mode
void FAD::cmd_rmode() {
  if (Match(Param[1],"first")) SetDOMINOReadMode(0);
  else if (Match(Param[1],"stop")) SetDOMINOReadMode(1);
  else PrintUsage();
} 

// Set Domino wave mode
void FAD::cmd_wmode() {
  if (Match(Param[1],"run")) SetDOMINOWaveMode(1);
  else if (Match(Param[1],"stop")) SetDOMINOWaveMode(0);
  else PrintUsage();
} 
*/

//
// Start data run
// 
void FAD::cmd_take() {

  time_t Time = time(NULL);
  struct tm *T = localtime(&Time);
  char Filename[500];

  // Set number of requested events
  NumEventsRequested = atoi(Parameter[1].c_str());
  NumEvents = 0;

  //  Open file with rwx right for owner and group, never overwrite file
  snprintf(Filename, sizeof(Filename),"%s/%d%02d%02dT%02d%02d%02d.raw", Parameter[2].c_str(), T->tm_year+1900, T->tm_mon+1, T->tm_mday, T->tm_hour, T->tm_min, T->tm_sec);

  Datafile = open(Filename,O_WRONLY|O_CREAT|O_EXCL, S_IRUSR|S_IWUSR|S_IRGRP|S_IWGRP);
  if(Datafile == -1) {
    PrintMessage("Error: Could not open file \"%s\" (%s)\n", Filename, strerror(errno));
    return;
  }

  // Start run
  Mode = datarun;
  PrintMessage("Starting run with %d events, filename '%s'\n", NumEventsRequested, Filename);
}

//
// Amplitude calibration
//
void FAD::cmd_acalib() {

  int Count;
  FILE *File;
  vector<string> Items;

  // Invalidate calibration?
  if (Parameter.size() == 2 && Match(Parameter[1], "invalidate")) {
        for (unsigned int i=0; i<Boards.size(); i++) Boards[i]->ACalibTime = -1;
        return;
  }

  // Read calibration data from file?
  //if (Parameter.size() == 2 && !ConvertToInt(Parameter[1], &NumCalibEvents)) {
  if (Parameter.size() == 2 && !ConvertToInt(Parameter[1], &NumEventsRequested)) {
    // Open file
        if ((File = fopen(Parameter[1].c_str(), "r")) == NULL) {
          PrintMessage("Error opening file '%s'\n", Parameter[1].c_str());
          return;
        } 
        PrintMessage("Reading amplitude calibration information from file '%s'\n", Parameter[1].c_str());

        // Read file into buffer and close file
        string Buffer;
    while (feof(File)==0 && ferror(File)==0) Buffer.push_back((char) fgetc(File));
        if (Buffer.size() > 0) Buffer = Buffer.substr(0, Buffer.size()-1);
        if (fclose(File) != 0) PrintMessage("Could not close file '%s'\n", Parameter[1].c_str());

        // Search for calibration data for boards
        vector<string> Result = Tokenize(Buffer, "\n");

        for (unsigned int Brd=0; Brd<Boards.size(); Brd++) {
          for (unsigned int Line=0; Line<Result.size(); Line++) {
            if (Result[Line].find(Boards[Brd]->Name) == string::npos) continue;

                PrintMessage("Found calibration data for board '%s'\n", Boards[Brd]->Name);
                Items = Tokenize(Result[Line]);
                
                // Check if correct number of items
                if (Items.size() != NChips*NChannels*NBins*3 + 3) {
                  PrintMessage("Error, data format invalid\n", Parameter[1].c_str());
                  return;
                }

                // Extract data
                Boards[Brd]->ACalibTemp = atof(Items[1].c_str());
                Boards[Brd]->ACalibTime = atoi(Items[2].c_str());

                Count = 3;
                for (unsigned int i=0; i<NChips; i++) {
                  for (unsigned int j=0; j<NChannels; j++) {
                        for (unsigned int k=0; k<NBins; k++) {
                          Boards[Brd]->Baseline[i][j][k] = atoi(Items[Count++].c_str());
                          Boards[Brd]->Gain[i][j][k] = atof(Items[Count++].c_str());
                          Boards[Brd]->SecondaryBaseline[i][j][k] = atof(Items[Count++].c_str());
                        }
                  }
                }
          }
        } // Loop over boards

        return;
  } // Reading calibration from file

  // Set number of events required for calibration
  if (Parameter.size()==1 || !ConvertToInt(Parameter[1], &NumEventsRequested) || NumEventsRequested<=0) {
        NumEventsRequested = DEFAULT_NUM_CALIB_EVENTS;
  }

  // Start ca;ibration by setting mode
  Mode = acalib;
}


//
// Print status
//
void FAD::cmd_status() {

  // ==== Print board overview ====
  if (Parameter.size() == 1) {

        // Count active board
        unsigned int Count = 0, Error = 0;
        for (unsigned int i=0; i<Boards.size(); i++) {
          if (Boards[i]->Active) Count++;
          if (Boards[i]->CommError) Error++;
        }         

        PrintMessage(" Number of FAD boards: %d    Boards with communication error: %d   Active boards: ", Boards.size(), Error);

        // Print list of active boards
        if (Count == 0) PrintMessage("none\n");
        else if (Count == Boards.size()) PrintMessage("all\n");
        else for (unsigned int i=0; i<Boards.size(); i++) {
          if (Boards[i]->Active) PrintMessage(" %d", i);
        }

        // Current mode
        if (Mode == idle) PrintMessage("Current mode is IDLE\n");
        else if (Mode == acalib) PrintMessage("Current mode is ACALIB (3x%d events)\n", NumEventsRequested);
        else if (Mode == datarun) PrintMessage("Current mode is DATARUN (%d events requested, %d events taken)\n", NumEventsRequested, NumEvents);

        return;
  }    

  // ==== Print details for given range ====
  struct Range R = {0, Boards.size()};

  if (!ConvertToRange(Parameter[1], R)) {
        PrintMessage("Error, out of range.\n");
        return;
  }

  for (int i=0; i<(int) Boards.size(); i++) {
        if (i<R.Min || i > R.Max) continue;

        struct FADBoard::BoardStatus S = Boards[i]->GetStatus();

        PrintMessage("Board #%d - %s (%sactive)    Communication %s\n", i, Boards[i]->Name, Boards[i]->Active ? "":"in", Boards[i]->CommError ? "ERROR":"OK");
        PrintMessage("Board ID %d               Firmware revision %d\n", S.BoardID, S.FirmwareRevision);
        PrintMessage("DAC %d %d %d %d   %d %d %d %d\n", S.DAC[0], S.DAC[1], S.DAC[2], S.DAC[3], S.DAC[4], S.DAC[5], S.DAC[6], S.DAC[7] );
        PrintMessage("Temperature %.2f %.2f %.2f %.2f", S.Temp[0], S.Temp[1], S.Temp[2], S.Temp[3]);

        for (unsigned int i=0; i<NChips*NChannels; i++) {
          if (i%NChannels == 0) PrintMessage("\nROI %2d-%2d: ", i, i+NChannels-1);
          PrintMessage("%4d ", S.ROI[i/NChannels][i%NChannels]);
        }
        PrintMessage("\n");

        /*PrintMessage("Serial %d, firmware %d\n"
                    " Actual temperature:   %1.1lf C\n"
                    " Calibration temp.:    %1.1lf C\n"
                    GetBoard(i)->GetBoardSerialNumber(),
                    GetBoard(i)->GetFirmwareVersion(),
                    ACalibTemp[i]);


        if (GetBoard(i)->GetStatusReg() & BIT_RUNNING)
          PrintMessage("   Domino wave running\n");

        if (GetBoard(i)->GetCtrlReg() & BIT_DMODE)
          PrintMessage("   DMODE circular\n");
        else
          PrintMessage("   DMODE single shot\n");
        if (GetBoard(i)->GetCtrlReg() & BIT_ACAL_EN)
          PrintMessage("   ACAL enabled\n");
        PrintMessage(" Trigger bus:          0x%08X\n", GetBoard(i)->GetTriggerBus());
        else PrintMessage(" Domino wave stopped\n");
      }
    }*/
  } // for()
}


//
// Adress FAD boards
//
void FAD::cmd_board() {
  
  struct Range R = {0, Boards.size()};
  int Mode = 0;
  
  // Check if given boards should be enabled or disabled
  if (Parameter[1].size() >= 1) {
    if (Parameter[1][0] == '+') Mode = 1;
    if (Parameter[1][0] == '-') Mode = -1;
  }
  if (Mode != 0) Parameter[1][0] = ' ';

  // Evaluate given range
  if (!ConvertToRange(Parameter[1], R)) {
        PrintMessage("Error, out of range.\n");
        return;
  }
  
  // Enable or disable boards
  for (int i=0; i<(int) Boards.size(); i++) {
        if (Mode == 0) Boards[i]->Active = false;
        if (i >= R.Min && i <= R.Max) {
          if (Mode != -1) Boards[i]->Active = true;
          else Boards[i]->Active = false;
        }
  }  
} 

//
// Set DIM event update delay
//
void FAD::cmd_update() {

  double Delay;
  
  if (Parameter.size()==2 && ConvertToDouble(Parameter[1], &Delay) && Delay>0) EventUpdateDelay = Delay;
  else PrintUsage();
}

//
// Print help
//
void FAD::cmd_help() {

  char *Buffer;

  for(unsigned int i=0; i<sizeof(CommandList)/sizeof(CL_Struct); i++) {
    if (asprintf(&Buffer, "%s %s", CommandList[i].Name, CommandList[i].Parameters) == -1) {
          PrintMessage("Error printing help, asprintf() failed\n");
          break;
        }
    else {
        if (strlen(Buffer) < 25) PrintMessage("%-25s%s\n", Buffer, CommandList[i].Help);
        else PrintMessage("%s\n%-25s%s\n", Buffer, "", CommandList[i].Help);
        }
        free(Buffer);
  }
  PrintMessage(".<command>                  Execute shell command\n\n"
   "Items in <> are mandatory, in [] optional, | indicates mutual exclusive.\n"
   "Strings containing spaces have to be enclosed in \"double quotes\".\n"
   "Ranges can be given as 'all', a single number or in the form 'a-b'.\n"); 
}

//
// Cancel current operation
//
void FAD::cmd_stop() {

  static char Stop[] = "stop";

  if (Mode == idle) {
        PrintMessage("Nothing to stop\n");
        return;
  }
  
  if (Mode == acalib) Mode = idle;
  
  if (Mode == datarun) {  
        // Inform event thread to stop run in case datarun active
        if (write(Pipe[1], Stop, strlen(Stop)+1) == -1) {
          Message(ERROR, "write() to Pipe[1] failed in FAD::cmd_cancel() (%s)", strerror(errno));
        }
  }
  
  PrintMessage("Requested stopping of current operation\n");
}

//
// Exit programm
// SIGTERM sets ExitRequest flag, and also makes readline() return (if command from DimCommand thread)
//
void FAD::cmd_exit() {

  pthread_kill(MainThread, SIGTERM);
}


// -----------------------------
// *****  Other functions  *****
// -----------------------------

//
// Save amplitude calibration data to file
//
void FAD::SaveAmplitudeCalibration() {

  PrintMessage("Amplitude calibration of all active boards finished, original ROI and DAC set\n");
  
  // Write calibration data to file
  time_t Time = time(NULL);
  struct tm *TimeInfo;
  char Buffer[200];

  // Generate filename
  TimeInfo = localtime(&Time);
  if (strftime(Buffer, sizeof(Buffer), "/FADcalib_%y-%m-%jT%X.txt", TimeInfo) == 0) {
        PrintMessage("Could not generate calibration data file name, strftime() failed\n");
        return;
  }
  string Filename = string(getenv("HOME"))+Buffer;

  FILE *File = fopen(Filename.c_str(), "w");
  if (File == NULL) {
        PrintMessage("Could not open calibration data file '%s'\n", Filename.c_str());
        return;
  }
  
  // Fix: Should actually contain serial number!
  for (unsigned int Brd=0; Brd<Boards.size(); Brd++) {
        fprintf(File, "\n%s: %f %d ", Boards[Brd]->Name, Boards[Brd]->ACalibTemp, (int) Boards[Brd]->ACalibTime);
        for (unsigned int i=0; i<NChips; i++) {
          for (unsigned int j=0; j<NChannels; j++) {
                for (unsigned int k=0; k<NBins; k++) {
                  fprintf(File, "%d %lf %lf ", Boards[Brd]->Baseline[i][j][k], Boards[Brd]->Gain[i][j][k], Boards[Brd]->SecondaryBaseline[i][j][k]);
                }
          }
        }
  }

  // Close file 
  if (fclose(File) != 0) {
    PrintMessage("Could not close calibration file '%s'\n", Filename.c_str());
  }
  
  PrintMessage("Wrote amplitude calibration information to file '%s'\n", Filename.c_str());
}

//
// Event thread (publishes/writes M0 format)
//
void FAD::EventThread() {

  struct timeval Time, RunStart;
  struct timeval LastUpdate; 
  struct FADBoard::BoardStatus S;
  vector<unsigned long> EventNumbers(Boards.size());
  vector<bool> AcalibDone(Boards.size());
  double Temp;
  string IDString;
  char Buffer[100];
  int Ret;
  unsigned long long FileSize = 0;

  gettimeofday(&LastUpdate, NULL);
  RunStart = LastUpdate; // only to avoid 'uninitialized' warning from compiler
  
  // Create DIM event data service
  int EventSize = sizeof(RunHeader)+ Boards.size()*sizeof(BoardStructure)+sizeof(EventHeader) + Boards.size()*(NChips*NChannels*NBins*sizeof(short) + NChips*sizeof(int));
  char *EventData = new char [EventSize]; 
  DimService *EventService = new DimService (SERVER_NAME"/EventData", (char *) "C", NULL, 0);

  memset(EventData, 0, EventSize);

  // Calculate pointers to EventData array
  RunHeader *RHeader = (RunHeader *) EventData;
  BoardStructure **BStruct = new BoardStructure * [Boards.size()];
  for (unsigned int i=0; i<Boards.size(); i++) BStruct[i] = ((BoardStructure *) (RHeader + 1)) + i;
  EventHeader *EHeader = (EventHeader *) ((char *) (RHeader + 1) + Boards.size()*sizeof(BoardStructure));
  int *TriggerCell = (int *) (EHeader + 1);
  short *Data = (short *) (TriggerCell + NChips*Boards.size());

  // M0 RunHeader
  RHeader->DataFormat = DATA_FORMAT;
  RHeader->RunHeaderSize = sizeof(RunHeader);
  RHeader->EventHeaderSize = sizeof(EventHeader);
  RHeader->BoardStructureSize = sizeof(BoardStructure);
  RHeader->SoftwareRevision = 0xFFFF;   // Update
  RHeader->Identification = 0;

  RHeader->Type = 0;                            // Run type: 0=data, 1=pedestal, 3=test

  RHeader->RunNumber = -1;
  RHeader->FileNumber = 0;
  snprintf(RHeader->Description, sizeof(RHeader->Description), "FADctrl");       

  RHeader->NBoards = Boards.size();
  RHeader->NChips = NChips;
  RHeader->NChannels = NChannels;
  RHeader->Samples = NBins;                     // Always full pipeline
  RHeader->Offset = 0;
  RHeader->NBytes = sizeof(short);

  // M0 EventHeader
  EHeader->EventSize = Boards.size()*(NChips*NChannels*NBins*sizeof(short) + NChips*sizeof(int));

  // Update loop
  while (!ExitRequest) {
    // Wait for data from TCP/IP reading threads
    if ((Ret=read(Pipe[0], Buffer, sizeof(Buffer))) == -1) Message(FATAL, "read() from Pipe[0] failed in FAD::EventThread() (%s)", strerror(errno));
        IDString = string(Buffer, Ret);
        
        // If amplitude calibration mode, check if board finished procedure
        if (Mode == acalib) {
          bool Done = true;
          for (unsigned int i=0; i<Boards.size(); i++) {
                if (IDString.find(string("ACALIBDONE")+Boards[i]->Name) != string::npos) AcalibDone[i] = true;
                if (!AcalibDone[i]) Done = false;
          }
          // Amplitude calibration finished?
          if (Done) {
            SaveAmplitudeCalibration();
                Mode = idle;
          }
        }
        else for (unsigned int i=0; i<Boards.size(); i++) AcalibDone[i] = false;

        // Update run and event header with current time
        gettimeofday(&Time, NULL);

        RHeader->MagicNum = MAGICNUM_CLOSED;
        RHeader->EndSecond = Time.tv_sec;                       
        RHeader->EndMicrosecond = Time.tv_usec;         

        EHeader->Second = Time.tv_sec;
        EHeader->Microsecond = Time.tv_usec;

        // Close data file if requested or requested number of events reached
        if((IDString.find("stop")!=string::npos || NumEvents==NumEventsRequested) && Mode==datarun) {

          // Update run header  
          RHeader->Events = NumEvents;
          RHeader->StartSecond = RunStart.tv_sec;
          RHeader->StartMicrosecond = RunStart.tv_usec;         

          if (lseek(Datafile, 0, SEEK_SET) == -1) {
            PrintMessage("Error: Could not rewind file to write updated run header (%s)\n", strerror(errno));
          }
          else if (write(Datafile, RHeader, sizeof(RunHeader)) != sizeof(RunHeader)) {
                PrintMessage("Error: Could not write updated run header (%s)\n", strerror(errno));
          }

          // Close data file and terminate run
          if(close(Datafile) == -1) PrintMessage("Error: Could not close data file (%s)\n", strerror(errno));
          else PrintMessage("Data file closed (size %.1f MByte).\n", FileSize/1024.0/1024);

          Datafile = -1;
          Mode = idle;    
        }

        // These values might have changed while close file
        RHeader->StartSecond = Time.tv_sec;
        RHeader->StartMicrosecond = Time.tv_usec;               
    RHeader->Events = 1;

        // Check all boards that have new data
        for (unsigned int Brd=0; Brd<Boards.size(); Brd++) {
          // Identify board
          if (IDString.find(string("EVENT")+Boards[Brd]->Name) == string::npos) continue;

          // Fill M0 BoardStructure             
          S = Boards[Brd]->GetStatus();
          BStruct[Brd]->SerialNo = S.BoardID;
          BStruct[Brd]->NomFreq = 2;
          BStruct[Brd]->BoardTemp = 0;        
          for (unsigned int i=0; i<NTemp; i++) BStruct[Brd]->BoardTemp += S.Temp[i]/NTemp;
          BStruct[Brd]->ScaleFactor = 1/2.048;     

          // Update event header with ID and Type of current board
          EHeader->EventNumber = S.TriggerID;
          EHeader->TriggerType = S.TriggerType;

          // Register event number for data writing below
          EventNumbers[Brd] = S.TriggerID;

          // Write trigger cells
          for(unsigned int i=0; i<NChips; i++) TriggerCell[Brd*NChips+i] = (int) S.TriggerCell[i];

          // Write channel data (12 bit signed twis complement with out-of-range-bit and leading zeroes)
          int Count = 0;
          memset(Data, 0, Boards.size()*NChips*NChannels*NBins*sizeof(short));

          Boards[Brd]->Lock();
          for (unsigned int Chip=0; Chip<NChips; Chip++) for (unsigned int Chan=0; Chan<NChannels; Chan++) {
                for (int i=0; i<S.ROI[Chip][Chan]; i++) {
                  if (Boards[Brd]->ACalibTime == -1) Data[Count++] = Boards[Brd]->Data[Chip][Chan][i];
                  else {
                    Temp = (Boards[Brd]->Data[Chip][Chan][i] - Boards[Brd]->Baseline[Chip][Chan][(i+S.TriggerCell[Chip])%NBins]);
                        Temp *= Boards[Brd]->Gain[Chip][Chan][0]/Boards[Brd]->Gain[Chip][Chan][(i+S.TriggerCell[Chip])%NBins];
                        //Temp -= Boards[Brd]->SecondaryBaseline[Chip][Chan][i];
                        Data[Count++] = (short) Temp;
                  }
                }
                Count += NBins - S.ROI[Chip][Chan];
          }

          // Inform TCP/IP thread that data has been processed    
          Boards[Brd]->Continue = true;
          Boards[Brd]->Unlock();

          if ((Ret = pthread_cond_signal(&Boards[Brd]->CondVar)) != 0) {
                Message(FATAL, "pthread_cond_signal() failed (%s)", strerror(Ret));
          }
        } // Loop over boards

        // Check if DIM service should be updated
        if ((Time.tv_sec-LastUpdate.tv_sec)*1e6 + Time.tv_usec-LastUpdate.tv_usec > EventUpdateDelay*1e6) {
          gettimeofday(&LastUpdate, NULL);
          EventService->updateService(EventData, EventSize);
        }
        
        // ===== Data writing ===
        
        if (Mode != datarun) continue;
        
        // Check if all event numbers are the same
        bool Same = true;
        for (unsigned int i=0; i<Boards.size(); i++) {
          if (Boards[i]->Active && EventNumbers[i] != EventNumbers[0]) Same = false;
        }
        if (!Same) continue;

        // Write also run header if this is the first event
        int Offset;     
        if (NumEvents == 0) {
          RHeader->MagicNum = MAGICNUM_OPEN;
          RunStart = Time;
          Offset = 0;
          FileSize = 0;
        }
        else Offset = sizeof(RunHeader) + Boards.size()*sizeof(BoardStructure);
        
        // Write data to file
        if(write(Datafile, EventData+Offset, EventSize-Offset) != (ssize_t) EventSize-Offset) {
          PrintMessage("Error: Could not write all data to file, terminating run (%s)\n", strerror(errno));

          // Close file if error
          if (close(Datafile) == -1) PrintMessage("Error: Could not close data file (%s)\n", strerror(errno));
          Datafile = -1;
          Mode = idle;
          continue;
        }
        
        NumEvents++;
        FileSize += EventSize-Offset;
  }

  // Clean up
  delete[] BStruct;
  delete EventService;
  delete[] EventData;
}

// Launch event thread inside class
void FAD::LaunchEventThread(class FAD *m) {

  m->EventThread();
}


/*
// Set DOMINO mode 
void FAD::SetDOMINOMode(int mode) {
 
  for (int i=FirstBoard; i<=LastBoard; i++) {
    GetBoard(i)->SetDominoMode(mode==1 ? 1:0);
    PrintMessage("Domino mode of board %d switched to %s.\n",i,mode==1 ? "continuous":"single shot");
  } 
}

// Set DOMINO readout mode 
void FAD::SetDOMINOReadMode(int mode) {

  for (int i=FirstBoard; i<=LastBoard; i++) {
    GetBoard(i)->SetReadoutMode(mode);
    PrintMessage("Start readout of board %d from %s.\n",i,mode==0 ? "first bin":"stop position");
  } 
}

// Set DOMINO wave mode 
void FAD::SetDOMINOWaveMode(int mode) {

  for (int i=FirstBoard; i<=LastBoard; i++) {
    GetBoard(i)->SetDominoActive(mode);
    PrintMessage("Domino wave of board %d is %s during readout\n",i,mode==1 ? "running":"stopped");
  } 
}

*/


//
// Print usage text for command
//
void FAD::PrintUsage() {

  for(unsigned int i=0; i<sizeof(CommandList)/sizeof(CL_Struct); i++) {
    if (Match(Parameter[0], CommandList[i].Name)) {
          PrintMessage("Usage: %s %s\n", CommandList[i].Name, CommandList[i].Parameters);
        }
  }
}

//
// Print message to console
//
void FAD::PrintMessage(const char *Format, ...) {

  static char Error[] = "vasprintf() failed in PrintMessage()";
  char *Text;

  // Evaluate arguments
  va_list ArgumentPointer;
  va_start(ArgumentPointer, Format);
  if (vasprintf(&Text, Format, ArgumentPointer) == -1) Text = Error;
  va_end(ArgumentPointer);
  
  // Print to console
  printf("%s", Text);
  fflush(stdout);
  if (strlen(Text)>0 && Text[strlen(Text)-1]=='\n') rl_on_new_line(); // New prompt

  // Send to DIM text service
  ConsoleOut->updateService(Text); 

  // Free old text
  if (ConsoleText != Error) free(ConsoleText);
  ConsoleText = Text; 
}

//
// Check if two strings match (min 1 character must match)
//
bool FAD::Match(string str, const char *cmd) {

  return strncasecmp(str.c_str(),cmd,strlen(str.c_str())==0 ? 1:strlen(str.c_str())) ? false:true;
}

//
// Conversion function from string to double, int or range
//
// Return false if conversion did not stop on whitespace or EOL character
bool FAD::ConvertToDouble(string String, double *Result) {

  char *EndPointer;
  
  *Result = strtod(String.c_str(), &EndPointer);
  if(!isspace(*EndPointer) && *EndPointer!='\0') return false;
  return true;
}

bool FAD::ConvertToInt(string String, int *Result) {

  char *EndPointer;
  
  *Result = (int) strtol(String.c_str(), &EndPointer, 0);
  if(!isspace(*EndPointer) && *EndPointer!='\0') return false;
  return true;
}

bool FAD::ConvertToRange(string String, struct FAD::Range &R) {

  int N, M;

  // Full range
  if (Match(String, "all")) return true;

  // Single number
  if (ConvertToInt(String, &N)) {
        if (N>= R.Min && N<=R.Max) {
          R.Max = R.Min = N;
          return true;
        }
        return false;
  }
  
  // Range a-b
  vector<string> V = EvidenceServer::Tokenize(String, "-");
  if (V.size()==2 && ConvertToInt(V[0], &N) && ConvertToInt(V[1], &M) && N>=R.Min && M<=R.Max) {
        R.Min = N;
        R.Max = M;
        return true;
  }
  
  return false;
}