RUInfo.h

Go to the documentation of this file.

// Copyright 2019-2020 CERN and copyright holders of ALICE O2.
// See https://alice-o2.web.cern.ch/copyright for details of the copyright holders.
// All rights not expressly granted are reserved.
//
// This software is distributed under the terms of the GNU General Public
// License v3 (GPL Version 3), copied verbatim in the file "COPYING".
//
// In applying this license CERN does not waive the privileges and immunities
// granted to it by virtue of its status as an Intergovernmental Organization
// or submit itself to any jurisdiction.
 
#ifndef ALICEO2_RUINFO_H
#define ALICEO2_RUINFO_H
 
// \file RUInfo.h
// \brief Transient structures for ITS and MFT HW -> SW mapping
 
#include <Rtypes.h>
#include <cstdint>
#include <string>
 
namespace o2
{
namespace itsmft
{
 
struct RUInfo {
  const std::uint16_t DUMMY16 = 0xffff;
  const std::uint8_t DUMMY8 = 0xff;
  uint16_t idSW = DUMMY16;         // software ID
  uint16_t idHW = DUMMY16;         // hardware ID
  uint16_t firstChipIDSW = 0xffff; // SW ID of the 1st chip of the module served by this RU
  uint8_t layer = DUMMY8;          // layer
  uint8_t ruType = DUMMY8;         // RU type (=subbarel)
  uint8_t nCables = DUMMY8;        // by how many cables it is served
};
 
struct ChipOnRUInfo {
  const std::uint8_t DUMMY8 = 0xff;
  std::uint8_t id = DUMMY8;             // chip ID within the stave (RU)
  std::uint8_t moduleSW = DUMMY8;       // sequential ID of the chip's module on stave
  std::uint8_t moduleHW = DUMMY8;       // HW ID of the chip's module on stave
  std::uint8_t chipOnModuleSW = DUMMY8; // sequential ID of the chip on the module
  std::uint8_t chipOnModuleHW = DUMMY8; // sequential ID of the chip on the module
  std::uint8_t cableSW = DUMMY8;        // order in which data of the cable is queried at decoding (to have chips SW IDs sorted)
  std::uint8_t cableHW = DUMMY8;        // cable HW ID
  std::uint8_t cableHWPos = DUMMY8;     // position of the bit of this cable in the activeLanes
  std::uint8_t chipOnCable = DUMMY8;    // chip within the cable (0 = master)
 
  std::string asString() const;
  void print() const;
};
 
struct ChipInfo {
  const std::uint16_t DUMMY16 = 0xffff;
  const std::uint8_t DUMMY8 = 0xff;
  const ChipOnRUInfo* chOnRU = nullptr; // pointer on chip detailed info within the stave
 
  std::uint16_t user = DUMMY16; // reserved for the user ?
  std::uint16_t id = DUMMY16;
  std::uint16_t ru = DUMMY16;     // RU sequential id
  std::uint16_t ruType = DUMMY16; // RU (or subBarrel) type
 
  std::string asString() const;
  void print() const;
};
} // namespace itsmft
} // namespace o2
 
#endif