otsdaq  3.03.00
ARTDAQTableBase.h
1 #ifndef _ots_ARTDAQTableBase_h_
2 #define _ots_ARTDAQTableBase_h_
3 
4 #include "otsdaq/ConfigurationInterface/ConfigurationManager.h"
5 #include "otsdaq/ConfigurationInterface/ConfigurationManagerRW.h"
6 #include "otsdaq/TableCore/TableBase.h"
7 
9 #define OUT out << tabStr << commentStr
10 #define PUSHTAB tabStr += "\t"
11 #define POPTAB tabStr.resize(tabStr.size() - 1)
12 #define PUSHCOMMENT commentStr += "# "
13 #define POPCOMMENT commentStr.resize(commentStr.size() - 2)
14 
15 namespace ots
16 {
17 // clang-format off
18 class ARTDAQTableBase : virtual public TableBase
19 {
20  public:
22  ARTDAQTableBase(std::string tableName, std::string* accumulatedExceptions = 0);
23 
24  virtual ~ARTDAQTableBase(void);
25 
26  static const std::string ARTDAQ_FCL_PATH;
27  static const std::string ARTDAQ_CONFIG_LAYOUTS_PATH;
28  static const bool ARTDAQ_DONOTWRITE_FCL;
29  static const std::string ARTDAQ_SUPERVISOR_CLASS, ARTDAQ_SUPERVISOR_TABLE;
30  static const std::string ARTDAQ_READER_TABLE, ARTDAQ_BUILDER_TABLE, ARTDAQ_LOGGER_TABLE, ARTDAQ_DISPATCHER_TABLE, ARTDAQ_MONITOR_TABLE, ARTDAQ_ROUTER_TABLE;
31  static const std::string ARTDAQ_SUBSYSTEM_TABLE, ARTDAQ_DAQ_TABLE, ARTDAQ_DAQ_PARAMETER_TABLE, ARTDAQ_ART_TABLE;
32  static const std::string ARTDAQ_TYPE_TABLE_HOSTNAME, ARTDAQ_TYPE_TABLE_ALLOWED_PROCESSORS, ARTDAQ_TYPE_TABLE_SUBSYSTEM_LINK, ARTDAQ_TYPE_TABLE_SUBSYSTEM_LINK_UID;
33 
34  enum class ARTDAQAppType
35  {
36  BoardReader,
37  EventBuilder,
38  DataLogger,
39  Dispatcher,
40  Monitor,
41  RoutingManager
42  };
43 
44  enum
45  {
46  DEFAULT_MAX_FRAGMENT_SIZE = 1048576,
47  DEFAULT_ROUTING_TIMEOUT_MS = 1000,
48  DEFAULT_ROUTING_RETRY_COUNT = 5,
49  };
50 
51  static const int NULL_SUBSYSTEM_DESTINATION;
52  static const std::string NULL_SUBSYSTEM_DESTINATION_LABEL;
53 
54  struct ProcessInfo
55  {
56  std::string label;
57  std::string hostname;
58  int subsystem;
59  int port;
60  bool status;
61  std::string allowed_processors;
62 
63  ProcessInfo(std::string l, std::string h, std::string procs, int s, ARTDAQAppType /*t*/, bool onOff, int p = -1)
64  : label(l), hostname(h), subsystem(s), port(p), status(onOff), allowed_processors(procs) {}
65  };
66 
68  {
69  int id;
70  std::string label;
71 
72  std::set<int> sources;
74 
75  bool eventMode;
76  bool hasRoutingManager;
77  std::string routingManagerHost;
78 
79  SubsystemInfo() : sources(), destination(0),eventMode(false), hasRoutingManager(false), routingManagerHost("") {}
80  };
81 
82  struct ARTDAQInfo
83  {
84  std::map<int /*subsystem ID*/, ARTDAQTableBase::SubsystemInfo> subsystems;
85  std::map<ARTDAQAppType, std::list<ProcessInfo>> processes;
86  };
87 
88  static const std::string& getTypeString (ARTDAQAppType type);
89  static std::string getFHICLFilename (ARTDAQAppType type, const std::string& name);
90  static std::string getFlatFHICLFilename (ARTDAQAppType type, const std::string& name);
91  static void flattenFHICL (ARTDAQAppType type, const std::string& name, std::string* returnFcl = nullptr);
92 
93  static void insertParameters (std::ostream& out,
94  std::string& tabStr,
95  std::string& commentStr,
96  const std::string& parentPath,
97  ConfigurationTree parameterLink,
98  const std::string& parameterPreamble,
99  bool onlyInsertAtTableParameters = false,
100  bool includeAtTableParameters = false);
101  static std::string insertModuleType (std::ostream& out, std::string& tabStr, std::string& commentStr, const std::string& parentPath, ConfigurationTree moduleTypeNode);
102  static void insertMetricsBlock (std::ostream& out, std::string& tabStr, std::string& commentStr, const std::string& parentPath, ConfigurationTree daqNode);
103  static void insertArtProcessBlock (std::ostream& out, std::string& tabStr, std::string& commentStr, const std::string& parentPath, ConfigurationTree art,
104  ConfigurationTree subsystemLink = ConfigurationTree(),
105  size_t routingTimeoutMs = DEFAULT_ROUTING_TIMEOUT_MS,
106  size_t routingRetryCount = DEFAULT_ROUTING_RETRY_COUNT );
107 
108  static void outputBoardReaderFHICL (const ConfigurationTree& boardReaderNode,
109  size_t maxFragmentSizeBytes = DEFAULT_MAX_FRAGMENT_SIZE,
110  size_t routingTimeoutMs = DEFAULT_ROUTING_TIMEOUT_MS,
111  size_t routingRetryCount = DEFAULT_ROUTING_RETRY_COUNT);
112 
113  static void outputDataReceiverFHICL (const ConfigurationTree& receiverNode,
114  ARTDAQAppType appType,
115  size_t maxFragmentSizeBytes = DEFAULT_MAX_FRAGMENT_SIZE,
116  size_t routingTimeoutMs = DEFAULT_ROUTING_TIMEOUT_MS,
117  size_t routingRetryCount = DEFAULT_ROUTING_RETRY_COUNT,
118  std::string* returnFcl = nullptr);
119 
120  static void outputRoutingManagerFHICL (const ConfigurationTree& routingManagerNode,
121  size_t routingTimeoutMs = DEFAULT_ROUTING_TIMEOUT_MS,
122  size_t routingRetryCount = DEFAULT_ROUTING_RETRY_COUNT);
123 
124  static void outputOnlineMonitorFHICL (const ConfigurationTree& onlineMonitorNode);
125 
126  static bool isARTDAQEnabled (const ConfigurationManager* cfgMgr);
127  static const ARTDAQInfo& extractARTDAQInfo (ConfigurationTree artdaqSupervisorNode,
128  bool getStatusFalseNodes = false,
129  bool doWriteFHiCL = false,
130  size_t maxFragmentSizeBytes = DEFAULT_MAX_FRAGMENT_SIZE,
131  size_t routingTimeoutMs = DEFAULT_ROUTING_TIMEOUT_MS,
132  size_t routingRetryCount = DEFAULT_ROUTING_RETRY_COUNT,
133  ProgressBar* progressBar = 0);
134 
135  static const ARTDAQInfo& getARTDAQSystem (ConfigurationManagerRW* cfgMgr,
136  std::map<std::string /*type*/,
137  std::map<std::string /*record*/,
138  std::vector<std::string /*property*/>>>& nodeTypeToObjectMap,
139  std::map<std::string /*subsystemName*/,
140  std::string /*destinationSubsystemName*/>& subsystemObjectMap,
141  std::vector<std::string /*property*/>& artdaqSupervisoInfo);
142 
144  const std::map<std::string /*type*/,
145  std::map<std::string /*record*/,
146  std::vector<std::string /*property*/>>>& nodeTypeToObjectMap,
147  const std::map<std::string /*subsystemName*/,
148  std::string /*destinationSubsystemName*/>& subsystemObjectMap);
149 
150  private:
151  static int getSubsytemId (ConfigurationTree subsystemNode);
152  static void extractRoutingManagersInfo (ConfigurationTree artdaqSupervisorNode, bool getStatusFalseNodes, bool doWriteFHiCL, size_t routingTimeoutMs, size_t routingRetryCount);
153  static void extractBoardReadersInfo (ConfigurationTree artdaqSupervisorNode, bool getStatusFalseNodes, bool doWriteFHiCL, size_t maxFragmentSizeBytes, size_t routingTimeoutMs, size_t routingRetryCount);
154  static void extractEventBuildersInfo (ConfigurationTree artdaqSupervisorNode, bool getStatusFalseNodes, bool doWriteFHiCL, size_t maxFragmentSizeBytes);
155  static void extractDataLoggersInfo (ConfigurationTree artdaqSupervisorNode, bool getStatusFalseNodes, bool doWriteFHiCL, size_t maxFragmentSizeBytes);
156  static void extractDispatchersInfo (ConfigurationTree artdaqSupervisorNode, bool getStatusFalseNodes, bool doWriteFHiCL, size_t maxFragmentSizeBytes);
157  static void addCommentWhitespace (std::ostream& os, size_t lineLength);
158 
159  static ARTDAQInfo info_;
160 
161  public:
162  static struct ProcessTypes
163  {
164  std::string const READER = "reader";
165  std::string const BUILDER = "builder";
166  std::string const LOGGER = "logger";
167  std::string const DISPATCHER = "dispatcher";
168  std::string const MONITOR = "monitor";
169  std::string const ROUTER = "router";
170 
171  ProcessTypes()
172  : mapToType_({
173  std::make_pair(READER, ARTDAQTableBase::ARTDAQAppType::BoardReader),
174  std::make_pair(BUILDER, ARTDAQTableBase::ARTDAQAppType::EventBuilder),
175  std::make_pair(LOGGER, ARTDAQTableBase::ARTDAQAppType::DataLogger),
176  std::make_pair(DISPATCHER, ARTDAQTableBase::ARTDAQAppType::Dispatcher),
177  std::make_pair(MONITOR, ARTDAQTableBase::ARTDAQAppType::Monitor),
178  std::make_pair(ROUTER, ARTDAQTableBase::ARTDAQAppType::RoutingManager)})
179  , mapToTable_({
180  std::make_pair(READER, ARTDAQTableBase::ARTDAQ_READER_TABLE),
181  std::make_pair(BUILDER, ARTDAQTableBase::ARTDAQ_BUILDER_TABLE),
182  std::make_pair(LOGGER, ARTDAQTableBase::ARTDAQ_LOGGER_TABLE),
183  std::make_pair(DISPATCHER, ARTDAQTableBase::ARTDAQ_DISPATCHER_TABLE),
184  std::make_pair(MONITOR, ARTDAQTableBase::ARTDAQ_MONITOR_TABLE),
185  std::make_pair(ROUTER, ARTDAQTableBase::ARTDAQ_ROUTER_TABLE)})
186  , mapToGroupIDAppend_({
187  std::make_pair(READER, "BoardReaders"),
188  std::make_pair(BUILDER, "EventBuilders"),
189  std::make_pair(LOGGER, "DataLoggers"),
190  std::make_pair(DISPATCHER, "Dispatchers"),
191  std::make_pair(MONITOR, "Monitors"),
192  std::make_pair(ROUTER, "RoutingManagers")})
193  , mapToLinkGroupIDColumn_({
194  std::make_pair(READER, ARTDAQTableBase::colARTDAQSupervisor_.colLinkToBoardReadersGroupID_),
195  std::make_pair(BUILDER, ARTDAQTableBase::colARTDAQSupervisor_.colLinkToEventBuildersGroupID_),
196  std::make_pair(LOGGER, ARTDAQTableBase::colARTDAQSupervisor_.colLinkToDataLoggersGroupID_),
197  std::make_pair(DISPATCHER, ARTDAQTableBase::colARTDAQSupervisor_.colLinkToDispatchersGroupID_),
198  std::make_pair(ROUTER, ARTDAQTableBase::colARTDAQSupervisor_.colLinkToRoutingManagersGroupID_)})
199  , mapToGroupIDColumn_({
200  std::make_pair(READER, "BoardReaderGroupID"),
201  std::make_pair(BUILDER, "EventBuilderGroupID"),
202  std::make_pair(LOGGER, "DataLoggerGroupID"),
203  std::make_pair(DISPATCHER, "DispatcherGroupID"),
204  std::make_pair(MONITOR, "MonitorGroupID"),
205  std::make_pair(ROUTER, "RoutingManagerGroupID")})
206  {}
207 
208  const std::map<std::string /*processType*/, ARTDAQTableBase::ARTDAQAppType> mapToType_;
209  const std::map<std::string /*processType*/, std::string /*typeTable*/> mapToTable_, mapToGroupIDAppend_, mapToLinkGroupIDColumn_, mapToGroupIDColumn_;
210  } processTypes_;
211 
213  static struct ColARTDAQSupervisor
214  {
215  std::string const colDAQInterfaceDebugLevel_ = "DAQInterfaceDebugLevel";
216  std::string const colDAQSetupScript_ = "DAQSetupScript";
217 
218  std::string const colLinkToBoardReaders_ = "BoardReadersLink";
219  std::string const colLinkToBoardReadersGroupID_ = "BoardReadersLinkGroupID";
220  std::string const colLinkToEventBuilders_ = "EventBuildersLink";
221  std::string const colLinkToEventBuildersGroupID_ = "EventBuildersLinkGroupID";
222  std::string const colLinkToDataLoggers_ = "DataLoggersLink";
223  std::string const colLinkToDataLoggersGroupID_ = "DataLoggersLinkGroupID";
224  std::string const colLinkToDispatchers_ = "DispatchersLink";
225  std::string const colLinkToDispatchersGroupID_ = "DispatchersLinkGroupID";
226  std::string const colLinkToRoutingManagers_ = "RoutingManagersLink";
227  std::string const colLinkToRoutingManagersGroupID_ = "RoutingManagersLinkGroupID";
228  } colARTDAQSupervisor_;
229 
231  static struct ColARTDAQSubsystem
232  {
233  std::string const colLinkToDestination_ = "SubsystemDestinationLink";
234  std::string const colLinkToDestinationUID_ = "SubsystemDestinationUID";
235  } colARTDAQSubsystem_;
236 
238  static struct ColARTDAQReader
239  {
240  std::string const colDaqFragmentIDs_ = "daqFragmentIDs";
241  std::string const colLinkToDaqParameters_ = "daqParametersLink";
242  std::string const colLinkToDaqParametersGroupID_ = "daqParametersLinkGroupID";
243  } colARTDAQReader_;
244 
246  static struct ColARTDAQNotReader
247  {
248  std::string const colLinkToDaq_ = "daqLink";
249  std::string const colLinkToDaqUID_ = "daqLinkUID";
250  std::string const colLinkToArt_ = "artLink";
251  std::string const colLinkToArtUID_ = "artLinkUID";
252  } colARTDAQNotReader_;
253 
255  static struct ColARTDAQDaq
256  {
257  std::string const colLinkToDaqParameters_ = "daqParametersLink";
258  std::string const colLinkToDaqParametersGroupID_ = "daqParametersLinkGroupID";
259  } colARTDAQDaq_;
260 
262  static struct ColARTDAQDaqParameter
263  {
264  std::string const colDaqParameterKey_ = "daqParameterKey";
265  std::string const colDaqParameterValue_ = "daqParameterValue";
266  std::string const colDaqParameterGroupID_ = "daqParameterGroupID";
267  } colARTDAQDaqParameter_;
268 
270  static struct ColARTDAQArt
271  {
272  std::string const colProcessName_ = "ProcessName";
273  } colARTDAQArt_;
274 };
275 // clang-format on
276 } // namespace ots
277 
278 #endif
<virtual so future plugins can inherit from multiple table base classes
static void outputDataReceiverFHICL(const ConfigurationTree &receiverNode, ARTDAQAppType appType, size_t maxFragmentSizeBytes=DEFAULT_MAX_FRAGMENT_SIZE, size_t routingTimeoutMs=DEFAULT_ROUTING_TIMEOUT_MS, size_t routingRetryCount=DEFAULT_ROUTING_RETRY_COUNT, std::string *returnFcl=nullptr)
static void insertArtProcessBlock(std::ostream &out, std::string &tabStr, std::string &commentStr, const std::string &parentPath, ConfigurationTree art, ConfigurationTree subsystemLink=ConfigurationTree(), size_t routingTimeoutMs=DEFAULT_ROUTING_TIMEOUT_MS, size_t routingRetryCount=DEFAULT_ROUTING_RETRY_COUNT)
static const std::string ARTDAQ_FCL_PATH
Tree-path rule is, if the last link in the path is a group link with a specified group ID,...
static std::string insertModuleType(std::ostream &out, std::string &tabStr, std::string &commentStr, const std::string &parentPath, ConfigurationTree moduleTypeNode)
static bool isARTDAQEnabled(const ConfigurationManager *cfgMgr)
isARTDAQEnabled
static void insertParameters(std::ostream &out, std::string &tabStr, std::string &commentStr, const std::string &parentPath, ConfigurationTree parameterLink, const std::string &parameterPreamble, bool onlyInsertAtTableParameters=false, bool includeAtTableParameters=false)
static void setAndActivateARTDAQSystem(ConfigurationManagerRW *cfgMgr, const std::map< std::string, std::map< std::string, std::vector< std::string >>> &nodeTypeToObjectMap, const std::map< std::string, std::string > &subsystemObjectMap)
static struct ots::ARTDAQTableBase::ProcessTypes processTypes_
Note!!!! processTypes_ must be instantiate after the static artdaq table names (to construct map in c...
static void outputOnlineMonitorFHICL(const ConfigurationTree &onlineMonitorNode)
static const ARTDAQInfo & getARTDAQSystem(ConfigurationManagerRW *cfgMgr, std::map< std::string, std::map< std::string, std::vector< std::string >>> &nodeTypeToObjectMap, std::map< std::string, std::string > &subsystemObjectMap, std::vector< std::string > &artdaqSupervisoInfo)
static void insertMetricsBlock(std::ostream &out, std::string &tabStr, std::string &commentStr, const std::string &parentPath, ConfigurationTree daqNode)
insertMetricsBlock
ARTDAQ DAQ Parameter Column names.
ARTDAQ Builder/Logger/Dispatcher Column names.
ARTDAQ Reader Column names.
ARTDAQ Subsystem Column names.
ARTDAQ Supervisor Column names.
bool eventMode
Whether art sends events or Fragments.
int destination
destination subsystem id, 0 := no destination
std::set< int > sources
by subsystem id