SST  13.1.0
Structural Simulation Toolkit
coreTest_Component.h
1 // Copyright 2009-2023 NTESS. Under the terms
2 // of Contract DE-NA0003525 with NTESS, the U.S.
3 // Government retains certain rights in this software.
4 //
5 // Copyright (c) 2009-2023, NTESS
6 // All rights reserved.
7 //
8 // This file is part of the SST software package. For license
9 // information, see the LICENSE file in the top level directory of the
10 // distribution.
11 
12 #ifndef SST_CORE_CORETEST_COMPONENT_H
13 #define SST_CORE_CORETEST_COMPONENT_H
14 
15 #include "sst/core/component.h"
16 #include "sst/core/link.h"
17 #include "sst/core/rng/marsaglia.h"
18 
19 namespace SST {
20 namespace CoreTestComponent {
21 
22 // These first two classes are just base classes to test ELI
23 // inheritance. The definition of the ELI items are spread through 2
24 // component base classes to make sure they get inherited in the
25 // actual component that can be instanced.
27 {
28 public:
29  SST_ELI_REGISTER_COMPONENT_BASE(SST::CoreTestComponent::coreTestComponentBase)
30 
31  SST_ELI_DOCUMENT_PARAMS(
32  { "workPerCycle", "Count of busy work to do during a clock tick.", NULL}
33  )
34 
35  SST_ELI_DOCUMENT_STATISTICS(
36  { "N", "events sent on N link", "counts", 1 }
37  )
38 
39  SST_ELI_DOCUMENT_PORTS(
40  {"Nlink", "Link to the coreTestComponent to the North", { "coreTestComponent.coreTestComponentEvent", "" } }
41  )
42 
43  SST_ELI_DOCUMENT_ATTRIBUTES(
44  { "test_element", "true" }
45  )
46 
47  coreTestComponentBase(ComponentId_t id) : SST::Component(id) {}
49 };
50 
52 {
53 public:
54  SST_ELI_REGISTER_COMPONENT_DERIVED_BASE(
56 
57  SST_ELI_DOCUMENT_PARAMS(
58  { "commFreq", "Approximate frequency of sending an event during a clock tick.", NULL},
59  )
60 
61  SST_ELI_DOCUMENT_STATISTICS(
62  { "S", "events sent on S link", "counts", 1 }
63  )
64 
65  SST_ELI_DOCUMENT_PORTS(
66  {"Slink", "Link to the coreTestComponent to the South", { "coreTestComponent.coreTestComponentEvent", "" } }
67  )
68 
69  coreTestComponentBase2(ComponentId_t id) : coreTestComponentBase(id) {}
71 };
72 
74 {
75 public:
76  // REGISTER THIS COMPONENT INTO THE ELEMENT LIBRARY
77  SST_ELI_REGISTER_COMPONENT(
79  "coreTestElement",
80  "coreTestComponent",
81  SST_ELI_ELEMENT_VERSION(1,0,0),
82  "CoreTest Test Component",
83  COMPONENT_CATEGORY_PROCESSOR
84  )
85 
86  SST_ELI_DOCUMENT_PARAMS(
87  { "commSize", "Size of communication to send.", "16"}
88  )
89 
90  SST_ELI_DOCUMENT_STATISTICS(
91  { "E", "events sent on E link", "counts", 1 },
92  { "W", "events sent on W link", "counts", 1 }
93  )
94 
95  SST_ELI_DOCUMENT_PORTS(
96  {"Elink", "Link to the coreTestComponent to the East", { "coreTestComponent.coreTestComponentEvent", "" } },
97  {"Wlink", "Link to the coreTestComponent to the West", { "coreTestComponent.coreTestComponentEvent", "" } }
98  )
99 
100  // Optional since there is nothing to document
101  SST_ELI_DOCUMENT_SUBCOMPONENT_SLOTS(
102  )
103 
104  coreTestComponent(SST::ComponentId_t id, SST::Params& params);
106 
107  void setup() {}
108  void finish() { printf("Component Finished.\n"); }
109 
110 private:
111  coreTestComponent(); // for serialization only
112  coreTestComponent(const coreTestComponent&); // do not implement
113  void operator=(const coreTestComponent&); // do not implement
114 
115  void handleEvent(SST::Event* ev);
116  virtual bool clockTic(SST::Cycle_t);
117 
118  int workPerCycle;
119  int commFreq;
120  int commSize;
121  int neighbor;
122 
124  SST::Link* N;
125  SST::Link* S;
126  SST::Link* E;
127  SST::Link* W;
132 };
133 
134 } // namespace CoreTestComponent
135 } // namespace SST
136 
137 #endif // SST_CORE_CORETEST_COMPONENT_H
Main component object for the simulation.
Definition: component.h:31
Definition: coreTest_Component.h:52
Definition: coreTest_Component.h:27
Definition: coreTest_Component.h:74
void setup()
Called after all components have been constructed and initialization has completed,...
Definition: coreTest_Component.h:107
void finish()
Called after complete phase, but before objects are destroyed.
Definition: coreTest_Component.h:108
Base class for Events - Items sent across links to communicate between components.
Definition: event.h:35
Parameter store.
Definition: params.h:56
Implements a random number generator using the Marsaglia method.
Definition: marsaglia.h:41