This class provides static methods to handle input fibre mappings: between MTP input connectors and minipods on the board, also for mapping of fanned out fibres to the quads on each FPGA. More...

#include <EfexDefs.h>

Collaboration diagram for EfexDefs:

Static Public Member Functions
static int	numFibresPerRibbon ()
static int	numRibbonsPerConnector ()
static int	numFibresPerConnector ()
static int	numInputConnectors ()
static int	numInputRibbons ()
static int	numInputFibres ()
static int	numInputChannels ()
static int	maxSuperCellsPerFibre ()
static int	num32BitWordsPerFibre ()
static int	numBitsPerSuperCell ()
static int	numOutputRibbons ()
static int	numOutputFibres ()
static int	nProcessorFpgas ()
static int	numInputFibresPerFpga ()
static int	numInputMgtsPerFpga ()
static int	numQuadsPerFpga ()
static int	numMgtsPerQuad ()
static int	nCaloReadoutStreams ()
static int	nTobReadoutStreams ()
static int	maxEtaBinsPerFpga ()
static int	numEtaBinsPerModule ()
static int	maxEtaBinsPerModule ()
static int	inputPlaybackDepth ()
static int	roSpyMemoryDepth ()
static int	connectorForMinipod (int minipod)
	Return MTP connector number (0-3) for a given minipod.
static int	connectorFirstFibre (int minipod)
	Return first fibre in the input MTP connector for a given minipod.
static unsigned int	globalEtaIndex (unsigned int efexLogicalID, unsigned int fpgaNumber, unsigned int etaWithinFpga)
	Return unsigned eta bin within eFEX system (used for calibration channels).
static int	globalEtaValue (unsigned int efexLogicalID, unsigned int fpgaNumber, unsigned int etaWithinFpga)
	Return signed eta bin within eFEX system (used for trigger menu API).

Detailed Description

This class provides static methods to handle input fibre mappings: between MTP input connectors and minipods on the board, also for mapping of fanned out fibres to the quads on each FPGA.

Todo: FIXME These initial mappings are surely wrong: SJH 07/07/21 tried to get it right

Definition at line 13 of file EfexDefs.h.

Member Function Documentation

◆ connectorFirstFibre()

int EfexDefs::connectorFirstFibre ( int minipod )

static

Return first fibre in the input MTP connector for a given minipod.

Parameters

minipod input ribbon (minipod) number (0-9 EM, 10-12 hadronic)

Returns: first fibre number (0,12,24,36)

Definition at line 51 of file EfexDefs.cxx.

{
  // Not all 12-fibre ribbons are used, so skip unused ones
  // to map onto minipods.
  int conn = EfexDefs::connectorForMinipod(minipod);
  // SJH 07/07/21 Updated in line with Gareth's mapping
  // which we believe is correct.  It's rather messier
  // than earlier assumptions
  // **CHECK!!**
  int numUnused = 0;
  int reverse = 1;
  if      (conn  < 0) { return -1; }
  else if (conn == 0) { numUnused = 0; reverse = 1;  }
  else if (conn == 1) { numUnused = 3; reverse = 1; } 
  else if (conn == 2) { numUnused = 2; reverse = -1; } 
  else if (conn == 3) { numUnused = 1; reverse = -1;  } 
  int rpc = EfexDefs::numRibbonsPerConnector();
  int ribbon = (5*rpc + minipod*reverse + numUnused) % rpc;
  // Deal with annoying hadronic case...
  if ( minipod == 12 )
    ribbon = 0;
  return ribbon * FexDefs::numFibresPerRibbon();
}

◆ connectorForMinipod()

int EfexDefs::connectorForMinipod ( int minipod )

static

Return MTP connector number (0-3) for a given minipod.

Parameters

minipod input ribbon (minipod) number (0-9 EM, 10-12 hadronic)

Returns: input connector number (0-3, -1 for invalid minipod)

Definition at line 28 of file EfexDefs.cxx.

{
  // Actual mapping has hadronic on connector 1 (of 0-3)
  // and the two minipod central region on connector 3.
  // **CHECK!!**  
  // SJH 07/07/21 Updated in line with Gareth's mapping
  // Hopefully Gareth's mapping is correct
  if      (minipod >=  0 && minipod <  4) { return  0; }  // E0-E3
  else if (minipod >=  4 && minipod <  6) { return  2; }  // E4-E5
  else if (minipod >=  6 && minipod < 10) { return  3; }  // E6-E9
  else if (minipod >= 10 && minipod < 13) { return  1; }  // H0-H2
  else                                    { return -1; }
}

◆ globalEtaIndex()

unsigned int EfexDefs::globalEtaIndex	(	unsigned int	efexLogicalID,
		unsigned int	fpgaNumber,
		unsigned int	etaWithinFpga )

static

Return unsigned eta bin within eFEX system (used for calibration channels).

Return first fibre in the input MTP connector for a given minipod.

Parameters

efexLogicalID	logical ID of eFEX within crate (0-11)
fpgaNumber	index of FPGA (0-3)
etaWithinFpga	eta bin within FPGA (0-4)

Returns: unsigned global eta bin in range 0-49 (where 0 is -2.5)

Definition at line 87 of file EfexDefs.cxx.

{
  unsigned int positionID = efexLogicalID % 3;   // eFEX C,B,A role
  unsigned int etaIndex = (16 * positionID) + (fpgaNumber * 4) + etaWithinFpga;
  etaIndex += (positionID != 0 || fpgaNumber != 0) ? 1 : 0;  // Adjustment for ends
  return etaIndex;
}

◆ globalEtaValue()

int EfexDefs::globalEtaValue	(	unsigned int	efexLogicalID,
		unsigned int	fpgaNumber,
		unsigned int	etaWithinFpga )

static

Return signed eta bin within eFEX system (used for trigger menu API).

Parameters

efexLogicalID	logical ID of eFEX within crate (0-11)
fpgaNumber	index of FPGA (0-3)
etaWithinFpga	eta bin within FPGA (0-4)

Returns: signed global eta bin in range -25 to +24

Definition at line 108 of file EfexDefs.cxx.

{
  return (int)EfexDefs::globalEtaIndex(efexLogicalID,fpgaNumber,etaWithinFpga) - 25;
}

◆ inputPlaybackDepth()

int EfexDefs::inputPlaybackDepth ( )

inlinestatic

Definition at line 50 of file EfexDefs.h.

50{ return FexDefs::inputPlaybackDepth(); }

FexDefs::inputPlaybackDepth

static int inputPlaybackDepth()

Definition FexDefs.h:22

◆ maxEtaBinsPerFpga()

int EfexDefs::maxEtaBinsPerFpga ( )

inlinestatic

Definition at line 45 of file EfexDefs.h.

45{ return 5; }

◆ maxEtaBinsPerModule()

int EfexDefs::maxEtaBinsPerModule ( )

inlinestatic

Definition at line 47 of file EfexDefs.h.

47{ return maxEtaBinsPerFpga() * nProcessorFpgas(); }

EfexDefs::nProcessorFpgas

static int nProcessorFpgas()

Definition EfexDefs.h:34

EfexDefs::maxEtaBinsPerFpga

static int maxEtaBinsPerFpga()

Definition EfexDefs.h:45

◆ maxSuperCellsPerFibre()

int EfexDefs::maxSuperCellsPerFibre ( )

inlinestatic

Definition at line 27 of file EfexDefs.h.

27{ return 20; }

◆ nCaloReadoutStreams()

int EfexDefs::nCaloReadoutStreams ( )

inlinestatic

Definition at line 40 of file EfexDefs.h.

40{ return 4; } // Sent separately

◆ nProcessorFpgas()

int EfexDefs::nProcessorFpgas ( )

inlinestatic

Definition at line 34 of file EfexDefs.h.

34{ return 4; }

◆ nTobReadoutStreams()

int EfexDefs::nTobReadoutStreams ( )

inlinestatic

Definition at line 41 of file EfexDefs.h.

41{ return 1; } // Merged in control FPGA

◆ num32BitWordsPerFibre()

int EfexDefs::num32BitWordsPerFibre ( )

inlinestatic

Definition at line 28 of file EfexDefs.h.

28{ return FexDefs::num32BitWordsPerFibre(); }

FexDefs::num32BitWordsPerFibre

static int num32BitWordsPerFibre()

Definition FexDefs.h:17

◆ numBitsPerSuperCell()

int EfexDefs::numBitsPerSuperCell ( )

inlinestatic

Definition at line 29 of file EfexDefs.h.

29{ return 10; } // TODO: CHECK THIS!!

◆ numEtaBinsPerModule()

int EfexDefs::numEtaBinsPerModule ( )

inlinestatic

Definition at line 46 of file EfexDefs.h.

46{ return 17; }

◆ numFibresPerConnector()

int EfexDefs::numFibresPerConnector ( )

inlinestatic

Definition at line 18 of file EfexDefs.h.

18{ return numFibresPerRibbon() * numRibbonsPerConnector(); }

EfexDefs::numFibresPerRibbon

static int numFibresPerRibbon()

Definition EfexDefs.h:16

◆ numFibresPerRibbon()

int EfexDefs::numFibresPerRibbon ( )

inlinestatic

Definition at line 16 of file EfexDefs.h.

16{ return FexDefs::numFibresPerRibbon(); }

◆ numInputChannels()

int EfexDefs::numInputChannels ( )

inlinestatic

Definition at line 25 of file EfexDefs.h.

25{ return numInputFibres(); }

EfexDefs::numInputFibres

static int numInputFibres()

Definition EfexDefs.h:23

◆ numInputConnectors()

int EfexDefs::numInputConnectors ( )

inlinestatic

Definition at line 21 of file EfexDefs.h.

21{ return 4; }

◆ numInputFibres()

int EfexDefs::numInputFibres ( )

inlinestatic

Definition at line 23 of file EfexDefs.h.

23{ return numInputRibbons() * numFibresPerRibbon(); }

EfexDefs::numInputRibbons

static int numInputRibbons()

Definition EfexDefs.h:22

◆ numInputFibresPerFpga()

int EfexDefs::numInputFibresPerFpga ( )

inlinestatic

Definition at line 35 of file EfexDefs.h.

35{ return 49; } // 40 EM + 9 Hadronic (total number actually in use)

◆ numInputMgtsPerFpga()

int EfexDefs::numInputMgtsPerFpga ( )

inlinestatic

Definition at line 36 of file EfexDefs.h.

36{ return 80; } // NB not all are used, but index is 0-79 for all FPGAs

◆ numInputRibbons()

int EfexDefs::numInputRibbons ( )

inlinestatic

Definition at line 22 of file EfexDefs.h.

22{ return numInputConnectors() * numRibbonsPerConnector(); }

EfexDefs::numInputConnectors

static int numInputConnectors()

Definition EfexDefs.h:21

◆ numMgtsPerQuad()

int EfexDefs::numMgtsPerQuad ( )

inlinestatic

Definition at line 38 of file EfexDefs.h.

38{return 4; }

◆ numOutputFibres()

int EfexDefs::numOutputFibres ( )

inlinestatic

Definition at line 32 of file EfexDefs.h.

32{ return numOutputRibbons() * numFibresPerRibbon(); }

EfexDefs::numOutputRibbons

static int numOutputRibbons()

Definition EfexDefs.h:31

◆ numOutputRibbons()

int EfexDefs::numOutputRibbons ( )

inlinestatic

Definition at line 31 of file EfexDefs.h.

31{ return 2; } // TODO: CHECK THIS!!

◆ numQuadsPerFpga()

int EfexDefs::numQuadsPerFpga ( )

inlinestatic

Definition at line 37 of file EfexDefs.h.

37{return 20; }

◆ numRibbonsPerConnector()

int EfexDefs::numRibbonsPerConnector ( )

inlinestatic

Definition at line 17 of file EfexDefs.h.

17{ return 4; }

◆ roSpyMemoryDepth()

int EfexDefs::roSpyMemoryDepth ( )

inlinestatic

Definition at line 51 of file EfexDefs.h.

51{ return 0x800; }

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

Static Public Member Functions

Detailed Description

Member Function Documentation

◆ connectorFirstFibre()

◆ connectorForMinipod()

◆ globalEtaIndex()

◆ globalEtaValue()

◆ inputPlaybackDepth()

◆ maxEtaBinsPerFpga()

◆ maxEtaBinsPerModule()

◆ maxSuperCellsPerFibre()

◆ nCaloReadoutStreams()

◆ nProcessorFpgas()

◆ nTobReadoutStreams()

◆ num32BitWordsPerFibre()

◆ numBitsPerSuperCell()

◆ numEtaBinsPerModule()

◆ numFibresPerConnector()

◆ numFibresPerRibbon()

◆ numInputChannels()

◆ numInputConnectors()

◆ numInputFibres()

◆ numInputFibresPerFpga()

◆ numInputMgtsPerFpga()

◆ numInputRibbons()

◆ numMgtsPerQuad()

◆ numOutputFibres()

◆ numOutputRibbons()

◆ numQuadsPerFpga()

◆ numRibbonsPerConnector()

◆ roSpyMemoryDepth()