The Raw TLU class Class for data from DAQ PC for TLU(Trigger Logic Unit) It is supposed to be used only in the DESY beam test. More...

#include <RawTLUFormat.h>

Inheritance diagram for RawTLUFormat:

Public Types
enum	{ POS_NWORDS = 0 , POS_HDR_NWORDS = 1 , POS_NUMEVE_NUMNODES = 2 , POS_RUN_NO = 3 , POS_EVE_NO = 4 , POS_NA_1 = 5 , POS_NODE_ID = 6 , POS_NA_2 = 7 , POS_TLU_EVENTTAG = 8 , POS_NA_3 = 9 , POS_TLU_TIME_1 = 10 , POS_TLU_TIME_2 = 11 , POS_RSVD_1 = 12 , POS_MAGIC_1 = 13 }

enum	{ SIZE_TLU_PACKET = 14 }

enum	{ TLU_MAGIC_TRAILER = 0x7FFF0000 }

enum	{ POS_NWORDS = 0 , POS_NODE_ID = 6 }

enum	{ POS_FTSW_ID_OLD = 5 , TEMP_POS_NWORDS_HEADER = 1 , OLD_FTSW_NWORDS_HEADER = 6 }

Public Member Functions
	RawTLUFormat ()
	Default constructor.

virtual	~RawTLUFormat ()
	Destructor.

int	GetNwordsHeader (int n)
	Get the size of the header.

unsigned int	GetNodeID (int n)
	Get Node ID.

unsigned int	GetEveNo (int n)
	Get Event #.

unsigned int	GetMagicTrailer (int n)
	Get Magic Trailer #.

int	GetRunNo (int n)
	Get Run #.

unsigned int	GetTLUEventTag (int n)
	Get TLU event tag.

void	CheckData (int n, unsigned int prev_evenum, unsigned int *cur_evenum)
	check data contents

virtual void	SetBuffer (int *bufin, int nwords, int delete_flag, int num_events, int num_nodes)
	set buffer ( delete_flag : m_buffer is freeed( = 0 )/ not freeed( = 1 ) in Destructer )

virtual int	TotalBufNwords ()
	Get total length of m_buffer.

virtual int	GetBufferPos (int n)
	get position of data block in word

virtual int *	GetBuffer (int n)
	get nth buffer pointer

virtual int *	GetWholeBuffer ()
	get pointer to buffer(m_buffer)

virtual int	GetNumEntries ()
	get # of data blocks = (# of nodes)*(# of events)

virtual int	GetNumNodes ()
	get # of data sources(e.g. # of COPPER boards) in m_buffer

virtual int	GetNumEvents ()
	get # of events in m_buffer

virtual int	GetPreAllocFlag ()
	get malloc_flag

virtual int	GetBlockNwords (int n)
	get size of a data block

virtual int	CheckFTSWID (int n)
	get FTSW ID to check whether this data block is FTSW data or not

virtual int	CheckTLUID (int n)
	get FTSW ID to check whether this data block is FTSW data or not

virtual void	CopyBlock (int n, int *buf_to)
	Copy one datablock to buffer.

virtual void	PrintData (int *buf, int nwords)
	print data

Protected Attributes
int	m_nwords
	number of words of buffer

int	m_num_nodes
	number of nodes in this object

int	m_num_events
	number of events in this object

int *	m_buffer
	Buffer.

int	m_use_prealloc_buf
	not recorded

Detailed Description

The Raw TLU class Class for data from DAQ PC for TLU(Trigger Logic Unit) It is supposed to be used only in the DESY beam test.

Definition at line 25 of file RawTLUFormat.h.

Member Enumeration Documentation

◆ anonymous enum

anonymous enum

inherited

Definition at line 75 of file RawDataBlockFormat.h.

         {
      POS_NWORDS = 0,
      POS_NODE_ID = 6
    };

◆ anonymous enum

anonymous enum

inherited

Definition at line 80 of file RawDataBlockFormat.h.

         {
      // Tentatively needed to distinguish new and old FTSW format, which will be changed in Nov. 2013
      POS_FTSW_ID_OLD = 5,
      TEMP_POS_NWORDS_HEADER = 1,
      OLD_FTSW_NWORDS_HEADER = 6
    };

◆ anonymous enum

anonymous enum

Definition at line 58 of file RawTLUFormat.h.

         {
      POS_NWORDS = 0,
      POS_HDR_NWORDS = 1,
      POS_NUMEVE_NUMNODES = 2,
      POS_RUN_NO = 3,
      POS_EVE_NO = 4,
      POS_NA_1 = 5,
      POS_NODE_ID = 6,
      POS_NA_2 = 7,
      POS_TLU_EVENTTAG = 8,
      POS_NA_3 = 9,
      POS_TLU_TIME_1 = 10,
      POS_TLU_TIME_2 = 11,
      POS_RSVD_1 = 12,
      POS_MAGIC_1 = 13
    };

◆ anonymous enum

anonymous enum

Definition at line 75 of file RawTLUFormat.h.

         {
      SIZE_TLU_PACKET = 14
    };

◆ anonymous enum

anonymous enum

Definition at line 79 of file RawTLUFormat.h.

         {
      TLU_MAGIC_TRAILER = 0x7FFF0000
    };

Constructor & Destructor Documentation

◆ RawTLUFormat()

RawTLUFormat ( )

Default constructor.

Definition at line 13 of file RawTLUFormat.cc.

14{

15}

◆ ~RawTLUFormat()

~RawTLUFormat ( )

virtual

Destructor.

Definition at line 17 of file RawTLUFormat.cc.

18{

19}

Member Function Documentation

◆ CheckData()

void CheckData	(	int	n,
		unsigned int	prev_evenum,
		unsigned int *	cur_evenum
	)

check data contents

Definition at line 60 of file RawTLUFormat.cc.

{
  int err_flag = 0;
  char err_buf[500];
  *cur_evenum = GetEveNo(n);
 
#ifndef NO_DATA_CHECK
  if (prev_evenum != 0xFFFFFFFF && *cur_evenum != 0) {
    if ((unsigned int)(prev_evenum + 1) != *cur_evenum) {
      sprintf(err_buf, "Event # jump : i %d prev 0x%x cur 0x%x : Exiting...\n %s %s %d\n",
              n, prev_evenum, *cur_evenum, __FILE__, __PRETTY_FUNCTION__, __LINE__);
      err_flag = 1;
    }
  }
#endif
 
  if (GetEveNo(n) != GetTLUEventTag(n)) {
    sprintf(err_buf, "invalid TLU event tag : blodk %d header eve # %u TLU tag %u. Exiting...\n %s %s %d\n",
            n, GetEveNo(n), GetTLUEventTag(n), __FILE__, __PRETTY_FUNCTION__, __LINE__);
    err_flag = 1;
  }
 
 
  if (GetBlockNwords(n) != SIZE_TLU_PACKET) {
    sprintf(err_buf, "invalid TLU packet length : block %d nwords %d must be %d : Exiting...\n %s %s %d\n",
            n, GetBlockNwords(n), SIZE_TLU_PACKET, __FILE__, __PRETTY_FUNCTION__, __LINE__);
    err_flag = 1;
  }
 
  if (GetMagicTrailer(n) != TLU_MAGIC_TRAILER) {
    sprintf(err_buf, "invalid magic word : block %d magic word 0x%x must be 0x%x : Exiting...\n %s %s %d\n",
            n, GetMagicTrailer(n), TLU_MAGIC_TRAILER, __FILE__, __PRETTY_FUNCTION__, __LINE__);
    err_flag = 1;
  }
 
  if (err_flag == 1) {
    printf("[DEBUG] ========== dump a data block : block # %d==========\n", n);
    printf("[DEBUG] ");
    for (int k = 0 ; k < GetBlockNwords(n); k++) {
      printf("0x%.8x ", (GetBuffer(n))[k]);
      if (k % 10 == 9) printf("\n[DEBUG] ");
    }
    fflush(stderr);
    B2FATAL(err_buf);
  }
 
  return;
}

◆ CheckFTSWID()

int CheckFTSWID ( int n )

virtualinherited

get FTSW ID to check whether this data block is FTSW data or not

Definition at line 73 of file RawDataBlockFormat.cc.

{
  int pos = POS_NODE_ID;
  if (m_buffer[ GetBufferPos(n) + TEMP_POS_NWORDS_HEADER ] == OLD_FTSW_NWORDS_HEADER) {
    pos =  POS_FTSW_ID_OLD;
  }
 
  if ((m_buffer[ GetBufferPos(n) + pos ] & 0xffffff00) == 0x54544400) {     // "TTD" + format version ( 0x20=DESY, 0x31=2018/7/11)
    return 1;
  } else {
    return 0;
  }
}

◆ CheckTLUID()

int CheckTLUID ( int n )

virtualinherited

get FTSW ID to check whether this data block is FTSW data or not

Definition at line 88 of file RawDataBlockFormat.cc.

{
  int pos = POS_NODE_ID;
  if (m_buffer[ GetBufferPos(n) + TEMP_POS_NWORDS_HEADER ] == OLD_FTSW_NWORDS_HEADER) {
    pos =  POS_FTSW_ID_OLD;
  }
  if (m_buffer[ GetBufferPos(n) + pos ] == 0x544c5520) { // "TLU "
    return 1;
  } else {
    return 0;
  }
}

◆ CopyBlock()

void CopyBlock	(	int	n,
		int *	buf_to
	)

virtualinherited

Copy one datablock to buffer.

Definition at line 173 of file RawDataBlockFormat.cc.

{
  memcpy(buf_to, GetBuffer(n), GetBlockNwords(n) * sizeof(int));
  return;
}

◆ GetBlockNwords()

int GetBlockNwords ( int n )

virtualinherited

get size of a data block

Definition at line 107 of file RawDataBlockFormat.cc.

{
  int size;
  if (n == (m_num_events * m_num_nodes) - 1) {
    size =  m_nwords - GetBufferPos(n);
  } else {
    size = GetBufferPos(n + 1) - GetBufferPos(n);
  }
  return size;
}

◆ GetBuffer()

int * GetBuffer ( int n )

virtualinherited

get nth buffer pointer

Definition at line 124 of file RawDataBlockFormat.cc.

{
  int pos_nwords = GetBufferPos(n);
  return &(m_buffer[ pos_nwords ]);
}

◆ GetBufferPos()

int GetBufferPos ( int n )

virtualinherited

get position of data block in word

Definition at line 30 of file RawDataBlockFormat.cc.

{
  if (m_buffer == NULL || m_nwords <= 0) {
    char err_buf[500];
    sprintf(err_buf, "[FATAL] RawPacket buffer(%p) is not available or length(%d) is not set.\n %s %s %d\n",
            m_buffer, m_nwords, __FILE__, __PRETTY_FUNCTION__, __LINE__);
    printf("%s", err_buf); fflush(stdout);
    B2FATAL(err_buf);
  }
 
  if (n >= (m_num_events * m_num_nodes)) {
    char err_buf[500];
    sprintf(err_buf, "[FATAL] Invalid COPPER block No. (%d : max %d ) is specified. Exiting... \n %s %s %d\n",
            n, (m_num_events * m_num_nodes), __FILE__, __PRETTY_FUNCTION__, __LINE__);
    printf("%s", err_buf); fflush(stdout);
    B2FATAL(err_buf);
  }
 
  int pos_nwords = 0;
  for (int i = 1; i <= n ; i++) {
    if (m_buffer[ pos_nwords ] <= 0) {
      char err_buf[500];
      sprintf(err_buf,
              "[FATAL] ERROR_EVENT : length of this data block is strange ( %d words ). Maybe data is corrupted or RawHeader info has not been filled yet. Exiting...",
              m_buffer[ pos_nwords ]);
      printf("%s", err_buf);
      B2FATAL(err_buf);
    } else {
      pos_nwords +=      m_buffer[ pos_nwords ];
    }
    if (pos_nwords >= m_nwords) {
      char err_buf[500];
      sprintf(err_buf, "[FATAL] ERROR_EVENT : value of pos_nwords(%d) is larger than m_nwords(%d). Exiting...\n %s %s %d\n",
              pos_nwords, m_nwords, __FILE__, __PRETTY_FUNCTION__, __LINE__);
      printf("%s", err_buf); fflush(stdout);
      B2FATAL(err_buf); // to reduce multiple error messages
    }
  }
  return pos_nwords;
 
}

◆ GetEveNo()

unsigned int GetEveNo ( int n )

Get Event #.

Definition at line 37 of file RawTLUFormat.cc.

{
  return m_buffer[  GetBufferPos(n) + POS_EVE_NO ];
}

◆ GetMagicTrailer()

unsigned int GetMagicTrailer ( int n )

Get Magic Trailer #.

Definition at line 49 of file RawTLUFormat.cc.

{
  return m_buffer[  GetBufferPos(n) + POS_MAGIC_1 ];
}

◆ GetNodeID()

unsigned int GetNodeID ( int n )

Get Node ID.

Definition at line 32 of file RawTLUFormat.cc.

{
  return (unsigned int)(m_buffer[ GetBufferPos(n) +  POS_NODE_ID ]);
}

◆ GetNumEntries()

virtual int GetNumEntries ( )

inlinevirtualinherited

get # of data blocks = (# of nodes)*(# of events)

Definition at line 49 of file RawDataBlockFormat.h.

49{ return m_num_events * m_num_nodes; }

◆ GetNumEvents()

virtual int GetNumEvents ( )

inlinevirtualinherited

get # of events in m_buffer

Definition at line 55 of file RawDataBlockFormat.h.

55{ return m_num_events; }

◆ GetNumNodes()

virtual int GetNumNodes ( )

inlinevirtualinherited

get # of data sources(e.g. # of COPPER boards) in m_buffer

Definition at line 52 of file RawDataBlockFormat.h.

52{ return m_num_nodes; }

◆ GetNwordsHeader()

int GetNwordsHeader ( int n )

Get the size of the header.

Definition at line 26 of file RawTLUFormat.cc.

{
  return  m_buffer[ GetBufferPos(n) +  POS_HDR_NWORDS ];
}

◆ GetPreAllocFlag()

virtual int GetPreAllocFlag ( )

inlinevirtualinherited

get malloc_flag

Definition at line 58 of file RawDataBlockFormat.h.

58{ return m_use_prealloc_buf; }

Belle2::RawDataBlockFormat::m_use_prealloc_buf

int m_use_prealloc_buf

not recorded

Definition: RawDataBlockFormat.h:102

◆ GetRunNo()

int GetRunNo ( int n )

Get Run #.

Definition at line 43 of file RawTLUFormat.cc.

{
  return m_buffer[  GetBufferPos(n) + POS_RUN_NO ];
}

◆ GetTLUEventTag()

unsigned int GetTLUEventTag ( int n )

Get TLU event tag.

Definition at line 54 of file RawTLUFormat.cc.

{
  return m_buffer[  GetBufferPos(n) + POS_TLU_EVENTTAG ];
}

◆ GetWholeBuffer()

int * GetWholeBuffer ( )

virtualinherited

get pointer to buffer(m_buffer)

Definition at line 119 of file RawDataBlockFormat.cc.

{
  return m_buffer;
}

◆ PrintData()

void PrintData	(	int *	buf,
		int	nwords
	)

virtualinherited

print data

Definition at line 161 of file RawDataBlockFormat.cc.

{
  printf("[DEBUG] ");
  for (int i = 0; i < nwords; i++) {
    printf("%.8x ", buf[ i ]);
    if (i % 10 == 9) printf("\n[DEBUG] ");
  }
  printf("\n[DEBUG] ");
  printf("\n");
  return;
}

◆ SetBuffer()

void SetBuffer	(	int *	bufin,
		int	nwords,
		int	delete_flag,
		int	num_events,
		int	num_nodes
	)

virtualinherited

set buffer ( delete_flag : m_buffer is freeed( = 0 )/ not freeed( = 1 ) in Destructer )

Definition at line 131 of file RawDataBlockFormat.cc.

{
 
  if (bufin == NULL) {
    char err_buf[500];
    sprintf(err_buf, "[DEBUG] bufin is NULL. Exting...\n");
    printf("%s", err_buf); fflush(stdout);
    B2FATAL(err_buf);
  }
 
  if (!m_use_prealloc_buf && m_buffer != NULL) delete[] m_buffer;
 
  if (delete_flag == 0) {
    m_use_prealloc_buf = true;
  } else {
    m_use_prealloc_buf = false;
  }
 
  m_nwords = nwords;
  m_buffer = bufin;
 
  m_num_nodes = num_nodes;
  m_num_events = num_events;
 
  return;
 
}

◆ TotalBufNwords()

int TotalBufNwords ( )

virtualinherited

Get total length of m_buffer.

Definition at line 101 of file RawDataBlockFormat.cc.

{
  return m_nwords;
}

Member Data Documentation

◆ m_buffer

int* m_buffer

protectedinherited

Buffer.

Definition at line 98 of file RawDataBlockFormat.h.

◆ m_num_events

int m_num_events

protectedinherited

number of events in this object

Definition at line 95 of file RawDataBlockFormat.h.

◆ m_num_nodes

int m_num_nodes

protectedinherited

number of nodes in this object

Definition at line 92 of file RawDataBlockFormat.h.

◆ m_nwords

int m_nwords

protectedinherited

number of words of buffer

Definition at line 89 of file RawDataBlockFormat.h.

◆ m_use_prealloc_buf

int m_use_prealloc_buf

protectedinherited

not recorded

flag for deleting m_buffer in destructer( 0:delete, 1: not delete) When using pre-allocated buffer, the buffer should be reused and not deleted in the destructer

Definition at line 102 of file RawDataBlockFormat.h.

The documentation for this class was generated from the following files:

rawdata/dataobjects/include/RawTLUFormat.h
rawdata/dataobjects/src/RawTLUFormat.cc

Public Types

Public Member Functions

Protected Attributes

Detailed Description

Member Enumeration Documentation

◆ anonymous enum

◆ anonymous enum

◆ anonymous enum

◆ anonymous enum

◆ anonymous enum

Constructor & Destructor Documentation

◆ RawTLUFormat()

◆ ~RawTLUFormat()

Member Function Documentation

◆ CheckData()

◆ CheckFTSWID()

◆ CheckTLUID()

◆ CopyBlock()

◆ GetBlockNwords()

◆ GetBuffer()

◆ GetBufferPos()

◆ GetEveNo()

◆ GetMagicTrailer()

◆ GetNodeID()

◆ GetNumEntries()

◆ GetNumEvents()

◆ GetNumNodes()

◆ GetNwordsHeader()

◆ GetPreAllocFlag()

◆ GetRunNo()

◆ GetTLUEventTag()

◆ GetWholeBuffer()

◆ PrintData()

◆ SetBuffer()

◆ TotalBufNwords()

Member Data Documentation

◆ m_buffer

◆ m_num_events

◆ m_num_nodes

◆ m_nwords

◆ m_use_prealloc_buf