CTPPSPixelFramePosition

Macros

Line Code
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105
/****************************************************************************
 *
 * 
 * Authors: 
 *  F.Ferro ferro@ge.infn.it
 *
 ****************************************************************************/

#ifndef CondFormats_PPSObjects_CTPPSPixelFramePosition
#define CondFormats_PPSObjects_CTPPSPixelFramePosition

#include <iostream>
#include <string>

#include "CondFormats/Serialization/interface/Serializable.h"

/**
 * Uniquely identifies the DAQ channel through which a ROC frame has been received.
 * 
 * The internal representation has the following structure:
 * \verbatim
 * |                                     32 bits raw position                                                                      |
 * | 11 bits  |   12 bits |  1  bit          |      6 bits                        |  2bits     |
 * |  empty   |  FED ID  |    FMC   0-1  |   fiber index      0-12          | ROC 0-2 |
 * \endverbatim
 *
 **/
class CTPPSPixelFramePosition {
public:
  static const unsigned int offsetROC = 0, maskROC = 0x3;
  static const unsigned int offsetChannelIdx = 2, maskChannelIdx = 0x3F;
  static const unsigned int offsetFMCId = 8, maskFMCId = 0x1;
  static const unsigned int offsetFEDId = 9, maskFEDId = 0xFFF;

  /// the preferred constructor
  CTPPSPixelFramePosition(unsigned short FEDId, unsigned short FMCId, unsigned short ChannelIdx, unsigned short ROC)
      : rawPosition(ROC << offsetROC | ChannelIdx << offsetChannelIdx | FMCId << FMCId | FEDId << offsetFEDId) {}

  /// don't use this constructor unless you have a good reason
  CTPPSPixelFramePosition(unsigned int pos = 0) : rawPosition(pos) {}

  ~CTPPSPixelFramePosition() {}

  /// recomended getters and setters

  unsigned short getFEDId() const { return (rawPosition >> offsetFEDId) & maskFEDId; }

  void setFEDId(unsigned short v) {
    v &= maskFEDId;
    rawPosition &= 0xFFFFFFFF - (maskFEDId << offsetFEDId);
    rawPosition |= (v << offsetFEDId);
  }

  unsigned short getChannelIdx() const { return (rawPosition >> offsetChannelIdx) & maskChannelIdx; }

  void setChannelIdx(unsigned short v) {
    v &= maskChannelIdx;
    rawPosition &= 0xFFFFFFFF - (maskChannelIdx << offsetChannelIdx);
    rawPosition |= (v << offsetChannelIdx);
  }

  unsigned short getROC() const { return (rawPosition >> offsetROC) & maskROC; }

  void setROC(unsigned short v) {
    v &= maskROC;
    rawPosition &= 0xFFFFFFFF - (maskROC << offsetROC);
    rawPosition |= (v << offsetROC);
  }

  unsigned short getFMCId() const { return (rawPosition >> offsetFMCId) & maskFMCId; }

  void setFMCId(unsigned short v) {
    v &= maskFMCId;
    rawPosition &= 0xFFFFFFFF - (maskFMCId << offsetFMCId);
    rawPosition |= (v << offsetFMCId);
  }

  unsigned int getRawPosition() const { return rawPosition; }

  bool operator<(const CTPPSPixelFramePosition &pos) const { return (rawPosition < pos.rawPosition); }

  bool operator==(const CTPPSPixelFramePosition &pos) const { return (rawPosition == pos.rawPosition); }

  /// Condensed representation of the DAQ channel.
  /// prints 5-digit hex number,
  friend std::ostream &operator<<(std::ostream &s, const CTPPSPixelFramePosition &fp);

  /// prints XML formatted DAQ channel to stdout
  void printXML();

  /// Sets attribute with XML name 'attribute' and value 'value'.
  /// Also turns on attribute presents bit in the flag parameter
  /// returns 0 if the attribute is known, non-zero value else
  unsigned char setXMLAttribute(const std::string &attribute, const std::string &value, unsigned char &flag);

  /// returns true if all attributes have been set
  static bool checkXMLAttributeFlag(unsigned char flag) { return (flag == 0xF); }

protected:
  unsigned int rawPosition;

  COND_SERIALIZABLE;
};

#endif