dataFormats.h

Go to the documentation of this file.

/* dataFormats.h - definition of MINOS DAQ data formats */

/* 
 * Tim Nicholls, Real Time Systems Group
 * Geoff Pearce, Particle Physics Dept.
 * CLRC Rutherford Appleton Laboratory
 */ 

/*
 * Current CVS Tag:
 * $Header: /cvs/minoscvs/rep1/minossoft/OnlineUtil/dataFormats.h,v 1.5 2004/11/29 20:55:31 rhatcher Exp $
 */

/* 
 * Modification History : DO NOT EDIT - MAINTAINED BY CVS 
 * $Log: dataFormats.h,v $
 * Revision 1.5  2004/11/29 20:55:31  rhatcher
 * resync with online CVS repository as of 2004-11-18
 *
 * Revision 1.14  2004/11/17 22:41:14  gfp
 * Extended ROP time frame header now the default
 *
 * Revision 1.13  2004/04/28 21:15:27  gfp
 * Add generic raw digit (mdRawDigit)
 *
 * Revision 1.12  2004/04/12 15:02:03  gfp
 * Add extended ROP header for tests. Hidden behind USE_EXTENDED_ROP_HEADER until rolled out
 *
 * Revision 1.11  2003/08/26 13:06:28  gfp
 * Extend MBRP header and rename as TP header
 *
 * Revision 1.10  2002/06/10 07:44:44  gfp
 * Move data masks & macros to mdRawDataMasks
 *
 * Revision 1.9  2002/02/05 20:45:31  gfp
 * Remove MAX_NUMBER_CRATES
 *
 * Revision 1.8  2001/10/04 16:23:08  gfp
 * Include macros for Caen TDC
 *
 * Revision 1.7  2001/09/05 16:42:31  gfp
 * ADC Mask 14 bits, Add TOF VMM, Add Rop# mask, Drop mdTofHeader
 *
 * Revision 1.6  2001/06/28 13:06:44  tcn
 * Added TOF readout block header definition
 *
 * Revision 1.5  2001/06/11 16:20:11  gfp
 * Add (un)packing masks and macros
 *
 * Revision 1.4  2001/05/14 07:52:28  gfp
 *  conform BRP header to md name space
 *
 * Revision 1.3  2001/05/03 13:05:25  gjc
 * Merged in Master BRP header from Geoff's version
 *
 * Revision 1.2  2001/05/01 13:21:59  tcn
 * Added more VARC masks etc
 *
 * Revision 1.1  2001/04/06 11:56:03  tcn
 * First commit of dataFormats.h
 *
 *
 */ 

#ifndef _DATAFORMATS_H
#define _DATAFORMATS_H
#ifdef __cplusplus 
extern "C" { 
#endif /* __cplusplus */

/* includes */

/* defines */

/* =========================================
 * Number of long words in a readout element
 * =========================================
 */

#define RDOUT_SIZE_LONG 2

/* ==========
 * Raw digit.
 * ==========
 */

typedef struct mdRawDigit_t {

  long upper;    /* High order 32 bits : containing address, etc*/
  long lower;    /* Low order 32 bits  : containing timestamp, etc*/ 

} mdRawDigit;



/* ==============================================================
 * Standard timestamp used in MINOS DAQ - this is the same as the
 * the POSIX timespec, namely number of seconds and nanoseconds
 * relative to the UNIX Epoch : 00:00 1st Jan 1970.
 * ==============================================================
 */

typedef struct mdTimeStamp_t {

    long sec;    /* Seconds part of timestamp */
    long nsec;   /* Nanoseconds part of timestamp */

} mdTimeStamp;


/* =============================
 * ROP (crate) time frame header
 * =============================
 */

typedef struct mdTimeFrameHdr_t {

    long        frameLenBytes;  /* number of bytes in frame */
    long        headerLenBytes; /* number of bytes in header section */
    long        numDataBlocks;  /* number of data blocks in frame */
    long        frameNumber;    /* time frame number */
    long        ropNumber;      /* source ROP (crate) number */
    mdTimeStamp timeStamp;      /* time stamp of start of frame */
    long        checksum;       /* checksum calculated on time frame */

    /*
     * A list of data block sizes (bytes) follows, numDataBlocks long
     * If overlaps are enabled, the overlap block is the first block.
     * The last block is 'other data'.
     * Additional padding words are appended to the header as required
     * to ensure that the time frame ends on a 64bit word boundary.
     */

} mdTimeFrameHdr;


/* =====================================
 * Trigger Farm (Full) Time Frame Header
 * =====================================
 */

typedef struct mdTpTimeFrameHeader_t {

  long frameLenBytes;
  long headerLenBytes;
  long timeFrameNumber;
  long runNumber;
  long subRunNumber;
  long timeFramesDropped;
  long liBufferId;
  long opBufferId;
  long trgProcessingTime;
  long lipProcessingTime;

} mdTpTimeFrameHeader;


/* global variable declarations*/   

/* function prototype declarations */

#ifdef __cplusplus 
} 
#endif /* __cplusplus */ 

#endif /* _DATAFORMATS_H */

---