trd2d/ReadoutConfig.h

Go to the documentation of this file.

/* Copyright (C) 2023-2025 GSI Helmholtzzentrum fuer Schwerionenforschung, Darmstadt
   SPDX-License-Identifier: GPL-3.0-only
   Authors: Volker Friese, Dominik Smith [committer], Alex Bercuci */
 
#pragma once
 
#include "UnpackMS.h"
#include "yaml/Property.h"
#include "yaml/Yaml.h"
 
#include <map>
#include <sstream>
#include <utility>
#include <vector>
 
namespace cbm::algo::trd2d
{
 
 
  class ReadoutConfig {
 
   public:
    struct CompMapping {
      uint16_t moduleId;
      uint8_t fiberId;
 
      CBM_YAML_FORMAT(YAML::Flow);
      CBM_YAML_PROPERTIES(yaml::Property(&CompMapping::moduleId, "moduleId", "Module ID"),
                     yaml::Property(&CompMapping::fiberId, "fiberId", "Optical Fibre ID"));
    };
 
    struct ChanMapping {
      int32_t padAddress;   
      bool maskFlag;        
      uint8_t tOffset;      
      uint16_t lThreshold;  
 
      CBM_YAML_FORMAT(YAML::Flow);
      CBM_YAML_PROPERTIES(
        yaml::Property(&ChanMapping::padAddress, "address", "Pad address"),
        yaml::Property(&ChanMapping::maskFlag, "mask", "Channel masking flag"),
        yaml::Property(&ChanMapping::tOffset, "toff", "Channel wise time offset"),
        yaml::Property(&ChanMapping::lThreshold, "thres", "SW masking by threshold"));
    };
 
    ReadoutConfig();
 
 
    ~ReadoutConfig();
 
 
    std::vector<uint16_t> GetEquipmentIds();
 
 
    size_t GetNumAsics(uint16_t equipmentId);
 
 
    std::vector<uint8_t> GetAsicList(uint16_t equipmentId);
 
 
    size_t GetNumChans(uint16_t equipmentId, uint16_t asicId);
 
 
    CompMapping CompMap(uint16_t equipId);
 
 
    ChanMapping ChanMap(uint16_t equipId, uint16_t asic, uint16_t chan);
 
 
    std::string PrintReadoutMap();
 
    void InitComponentMap(const std::map<uint32_t, std::vector<uint16_t>>& map);
 
    void InitChannelMap(
      const std::map<size_t, std::map<size_t, std::map<size_t, std::tuple<int32_t, bool, uint8_t, uint16_t>>>>&
        channelMap);
 
    int64_t GetSystemTimeOffset() { return fSystemTimeOffset; };
 
    void SetSystemTimeOffset(int64_t offsetNs) { fSystemTimeOffset = offsetNs; };
 
   private:
    // --- System time offset
    int64_t fSystemTimeOffset = 0;
 
    // --- TRD2D readout map
    // --- Map index: (equipment), map value: (module id, crob id)
    std::map<uint16_t, CompMapping> fReadoutMap = {};  
 
    // --- TRD2D channel map
    // --- Map index: (equipment, asic, chan), map value: (pad address, mask flag, daq offset)
    std::map<uint16_t, std::map<uint8_t, std::vector<ChanMapping>>> fChannelMap = {};  
 
    CBM_YAML_PROPERTIES(
      yaml::Property(&ReadoutConfig::fSystemTimeOffset, "timeOffset", "System time offset for TRD2D"),
      yaml::Property(&ReadoutConfig::fReadoutMap, "readoutMap", "Maps equipment to module and Optical fibre Id", YAML::Hex),
      yaml::Property(&ReadoutConfig::fChannelMap, "channelMap",
                                    "Maps equipment, ASIC and channel to pad address, mask flag and DAQ offset",
                                    YAML::Hex));
  };
 
}  // namespace cbm::algo::trd2d
 
CBM_YAML_EXTERN_DECL(cbm::algo::trd2d::ReadoutConfig);