sc_main.cc (13077:0037323cb4dd) sc_main.cc (13081:fd1b50840830)
1/*
2 * Copyright 2018 Google, Inc.
3 *
4 * Redistribution and use in source and binary forms, with or without
5 * modification, are permitted provided that the following conditions are
6 * met: redistributions of source code must retain the above copyright
7 * notice, this list of conditions and the following disclaimer;
8 * redistributions in binary form must reproduce the above copyright
9 * notice, this list of conditions and the following disclaimer in the
10 * documentation and/or other materials provided with the distribution;
11 * neither the name of the copyright holders nor the names of its
12 * contributors may be used to endorse or promote products derived from
13 * this software without specific prior written permission.
14 *
15 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
16 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
17 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
18 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
19 * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
20 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
21 * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
22 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
23 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
24 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
25 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
26 *
27 * Authors: Gabe Black
28 */
29
30#include <cstring>
1/*
2 * Copyright 2018 Google, Inc.
3 *
4 * Redistribution and use in source and binary forms, with or without
5 * modification, are permitted provided that the following conditions are
6 * met: redistributions of source code must retain the above copyright
7 * notice, this list of conditions and the following disclaimer;
8 * redistributions in binary form must reproduce the above copyright
9 * notice, this list of conditions and the following disclaimer in the
10 * documentation and/or other materials provided with the distribution;
11 * neither the name of the copyright holders nor the names of its
12 * contributors may be used to endorse or promote products derived from
13 * this software without specific prior written permission.
14 *
15 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
16 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
17 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
18 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
19 * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
20 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
21 * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
22 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
23 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
24 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
25 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
26 *
27 * Authors: Gabe Black
28 */
29
30#include <cstring>
31#include <string>
31
32#include "base/fiber.hh"
33#include "base/logging.hh"
34#include "base/types.hh"
35#include "sim/core.hh"
36#include "sim/eventq.hh"
37#include "sim/init.hh"
38#include "systemc/core/kernel.hh"
39#include "systemc/core/python.hh"
40#include "systemc/core/scheduler.hh"
41#include "systemc/ext/core/sc_main.hh"
42#include "systemc/ext/utils/sc_report_handler.hh"
43
44// A weak symbol to detect if sc_main has been defined, and if so where it is.
45[[gnu::weak]] int sc_main(int argc, char *argv[]);
46
47namespace sc_core
48{
49
50namespace
51{
52
53bool scMainCalled = false;
54
55int _argc = 0;
56char **_argv = NULL;
57
58class ScMainFiber : public Fiber
59{
32
33#include "base/fiber.hh"
34#include "base/logging.hh"
35#include "base/types.hh"
36#include "sim/core.hh"
37#include "sim/eventq.hh"
38#include "sim/init.hh"
39#include "systemc/core/kernel.hh"
40#include "systemc/core/python.hh"
41#include "systemc/core/scheduler.hh"
42#include "systemc/ext/core/sc_main.hh"
43#include "systemc/ext/utils/sc_report_handler.hh"
44
45// A weak symbol to detect if sc_main has been defined, and if so where it is.
46[[gnu::weak]] int sc_main(int argc, char *argv[]);
47
48namespace sc_core
49{
50
51namespace
52{
53
54bool scMainCalled = false;
55
56int _argc = 0;
57char **_argv = NULL;
58
59class ScMainFiber : public Fiber
60{
61 public:
62 std::string resultStr;
63 int resultInt;
64
65 ScMainFiber() : resultInt(1) {}
66
60 void
61 main()
62 {
63 if (::sc_main) {
67 void
68 main()
69 {
70 if (::sc_main) {
64 ::sc_main(_argc, _argv);
65 // Make sure no systemc events/notifications are scheduled
66 // after sc_main returns.
71 try {
72 resultInt = ::sc_main(_argc, _argv);
73 if (resultInt)
74 resultStr = "sc_main returned non-zero";
75 else
76 resultStr = "sc_main finished";
77 // Make sure no systemc events/notifications are scheduled
78 // after sc_main returns.
79 } catch (const sc_report &r) {
80 // There was an exception nobody caught.
81 resultStr = r.what();
82 }
67 ::sc_gem5::Kernel::scMainFinished(true);
68 ::sc_gem5::scheduler.clear();
69 } else {
70 // If python tries to call sc_main but no sc_main was defined...
71 fatal("sc_main called but not defined.\n");
72 }
73 }
74};
75
76ScMainFiber scMainFiber;
77
78// This wrapper adapts the python version of sc_main to the c++ version.
79void
80sc_main(pybind11::args args)
81{
82 panic_if(scMainCalled, "sc_main called more than once.");
83
84 _argc = args.size();
85 _argv = new char *[_argc];
86
87 // Initialize all the _argvs to NULL so we can delete [] them
88 // unconditionally.
89 for (int idx = 0; idx < _argc; idx++)
90 _argv[idx] = NULL;
91
92 // Attempt to convert all the arguments to strings. If that fails, clean
93 // up after ourselves. Also don't count this as a call to sc_main since
94 // we never got to the c++ version of that function.
95 try {
96 for (int idx = 0; idx < _argc; idx++) {
97 std::string arg = args[idx].cast<std::string>();
98 _argv[idx] = new char[arg.length() + 1];
99 strcpy(_argv[idx], arg.c_str());
100 }
101 } catch (...) {
102 // If that didn't work for some reason (probably a conversion error)
103 // blow away _argv and _argc and pass on the exception.
104 for (int idx = 0; idx < _argc; idx++)
105 delete [] _argv[idx];
106 delete [] _argv;
107 _argc = 0;
108 throw;
109 }
110
111 // At this point we're going to call the c++ sc_main, so we can't try
112 // again later.
113 scMainCalled = true;
114
115 scMainFiber.run();
116}
117
83 ::sc_gem5::Kernel::scMainFinished(true);
84 ::sc_gem5::scheduler.clear();
85 } else {
86 // If python tries to call sc_main but no sc_main was defined...
87 fatal("sc_main called but not defined.\n");
88 }
89 }
90};
91
92ScMainFiber scMainFiber;
93
94// This wrapper adapts the python version of sc_main to the c++ version.
95void
96sc_main(pybind11::args args)
97{
98 panic_if(scMainCalled, "sc_main called more than once.");
99
100 _argc = args.size();
101 _argv = new char *[_argc];
102
103 // Initialize all the _argvs to NULL so we can delete [] them
104 // unconditionally.
105 for (int idx = 0; idx < _argc; idx++)
106 _argv[idx] = NULL;
107
108 // Attempt to convert all the arguments to strings. If that fails, clean
109 // up after ourselves. Also don't count this as a call to sc_main since
110 // we never got to the c++ version of that function.
111 try {
112 for (int idx = 0; idx < _argc; idx++) {
113 std::string arg = args[idx].cast<std::string>();
114 _argv[idx] = new char[arg.length() + 1];
115 strcpy(_argv[idx], arg.c_str());
116 }
117 } catch (...) {
118 // If that didn't work for some reason (probably a conversion error)
119 // blow away _argv and _argc and pass on the exception.
120 for (int idx = 0; idx < _argc; idx++)
121 delete [] _argv[idx];
122 delete [] _argv;
123 _argc = 0;
124 throw;
125 }
126
127 // At this point we're going to call the c++ sc_main, so we can't try
128 // again later.
129 scMainCalled = true;
130
131 scMainFiber.run();
132}
133
134int
135sc_main_result_code()
136{
137 return scMainFiber.resultInt;
138}
139
140std::string
141sc_main_result_str()
142{
143 return scMainFiber.resultStr;
144}
145
118// Make our sc_main wrapper available in the internal _m5 python module under
119// the systemc submodule.
120
121struct InstallScMain : public ::sc_gem5::PythonInitFunc
122{
123 void
124 run(pybind11::module &systemc) override
125 {
126 systemc.def("sc_main", &sc_main);
146// Make our sc_main wrapper available in the internal _m5 python module under
147// the systemc submodule.
148
149struct InstallScMain : public ::sc_gem5::PythonInitFunc
150{
151 void
152 run(pybind11::module &systemc) override
153 {
154 systemc.def("sc_main", &sc_main);
155 systemc.def("sc_main_result_code", &sc_main_result_code);
156 systemc.def("sc_main_result_str", &sc_main_result_str);
127 }
128} installScMain;
129
130sc_stop_mode _stop_mode = SC_STOP_FINISH_DELTA;
131
132} // anonymous namespace
133
134int
135sc_argc()
136{
137 return _argc;
138}
139
140const char *const *
141sc_argv()
142{
143 return _argv;
144}
145
146void
147sc_start()
148{
149 Tick now = ::sc_gem5::scheduler.getCurTick();
150 sc_start(sc_time::from_value(MaxTick - now), SC_EXIT_ON_STARVATION);
151}
152
153void
154sc_pause()
155{
156 if (::sc_gem5::Kernel::status() == SC_RUNNING)
157 ::sc_gem5::scheduler.schedulePause();
158}
159
160void
161sc_start(const sc_time &time, sc_starvation_policy p)
162{
163 if (time.value() == 0) {
164 ::sc_gem5::scheduler.oneCycle();
165 } else {
166 Tick now = ::sc_gem5::scheduler.getCurTick();
167 ::sc_gem5::scheduler.start(now + time.value(), p == SC_RUN_TO_TIME);
168 }
169}
170
171void
172sc_set_stop_mode(sc_stop_mode mode)
173{
174 if (sc_is_running()) {
175 SC_REPORT_ERROR("attempt to set sc_stop mode "
176 "after start will be ignored", "");
177 return;
178 }
179 _stop_mode = mode;
180}
181
182sc_stop_mode
183sc_get_stop_mode()
184{
185 return _stop_mode;
186}
187
188void
189sc_stop()
190{
191 if (::sc_gem5::Kernel::status() == SC_STOPPED)
192 return;
193
194 if (sc_is_running()) {
195 bool finish_delta = (_stop_mode == SC_STOP_FINISH_DELTA);
196 ::sc_gem5::scheduler.scheduleStop(finish_delta);
197 } else {
198 ::sc_gem5::Kernel::stop();
199 }
200}
201
202const sc_time &
203sc_time_stamp()
204{
205 static sc_time tstamp;
206 Tick tick = ::sc_gem5::scheduler.getCurTick();
207 //XXX We're assuming the systemc time resolution is in ps.
208 tstamp = sc_time::from_value(tick / SimClock::Int::ps);
209 return tstamp;
210}
211
212sc_dt::uint64
213sc_delta_count()
214{
215 return sc_gem5::scheduler.numCycles();
216}
217
218bool
219sc_is_running()
220{
221 return sc_get_status() & (SC_RUNNING | SC_PAUSED);
222}
223
224bool
225sc_pending_activity_at_current_time()
226{
227 return ::sc_gem5::scheduler.pendingCurr();
228}
229
230bool
231sc_pending_activity_at_future_time()
232{
233 return ::sc_gem5::scheduler.pendingFuture();
234}
235
236bool
237sc_pending_activity()
238{
239 return sc_pending_activity_at_current_time() ||
240 sc_pending_activity_at_future_time();
241}
242
243sc_time
244sc_time_to_pending_activity()
245{
246 return sc_time::from_value(::sc_gem5::scheduler.timeToPending());
247}
248
249sc_status
250sc_get_status()
251{
252 return ::sc_gem5::kernel ? ::sc_gem5::kernel->status() : SC_ELABORATION;
253}
254
255std::ostream &
256operator << (std::ostream &os, sc_status s)
257{
258 switch (s) {
259 case SC_ELABORATION:
260 os << "SC_ELABORATION";
261 break;
262 case SC_BEFORE_END_OF_ELABORATION:
263 os << "SC_BEFORE_END_OF_ELABORATION";
264 break;
265 case SC_END_OF_ELABORATION:
266 os << "SC_END_OF_ELABORATION";
267 break;
268 case SC_START_OF_SIMULATION:
269 os << "SC_START_OF_SIMULATION";
270 break;
271 case SC_RUNNING:
272 os << "SC_RUNNING";
273 break;
274 case SC_PAUSED:
275 os << "SC_PAUSED";
276 break;
277 case SC_STOPPED:
278 os << "SC_STOPPED";
279 break;
280 case SC_END_OF_SIMULATION:
281 os << "SC_END_OF_SIMULATION";
282 break;
283
284 // Nonstandard
285 case SC_END_OF_INITIALIZATION:
286 os << "SC_END_OF_INITIALIZATION";
287 break;
288 case SC_END_OF_UPDATE:
289 os << "SC_END_OF_UPDATE";
290 break;
291 case SC_BEFORE_TIMESTEP:
292 os << "SC_BEFORE_TIMESTEP";
293 break;
294
295 default:
296 if (s & SC_STATUS_ANY) {
297 const char *prefix = "(";
298 for (sc_status m = (sc_status)0x1;
299 m < SC_STATUS_ANY; m = (sc_status)(m << 1)) {
300 if (m & s) {
301 os << prefix;
302 prefix = "|";
303 os << m;
304 }
305 }
306 os << ")";
307 } else {
308 ccprintf(os, "%#x", s);
309 }
310 }
311
312 return os;
313}
314
315} // namespace sc_core
157 }
158} installScMain;
159
160sc_stop_mode _stop_mode = SC_STOP_FINISH_DELTA;
161
162} // anonymous namespace
163
164int
165sc_argc()
166{
167 return _argc;
168}
169
170const char *const *
171sc_argv()
172{
173 return _argv;
174}
175
176void
177sc_start()
178{
179 Tick now = ::sc_gem5::scheduler.getCurTick();
180 sc_start(sc_time::from_value(MaxTick - now), SC_EXIT_ON_STARVATION);
181}
182
183void
184sc_pause()
185{
186 if (::sc_gem5::Kernel::status() == SC_RUNNING)
187 ::sc_gem5::scheduler.schedulePause();
188}
189
190void
191sc_start(const sc_time &time, sc_starvation_policy p)
192{
193 if (time.value() == 0) {
194 ::sc_gem5::scheduler.oneCycle();
195 } else {
196 Tick now = ::sc_gem5::scheduler.getCurTick();
197 ::sc_gem5::scheduler.start(now + time.value(), p == SC_RUN_TO_TIME);
198 }
199}
200
201void
202sc_set_stop_mode(sc_stop_mode mode)
203{
204 if (sc_is_running()) {
205 SC_REPORT_ERROR("attempt to set sc_stop mode "
206 "after start will be ignored", "");
207 return;
208 }
209 _stop_mode = mode;
210}
211
212sc_stop_mode
213sc_get_stop_mode()
214{
215 return _stop_mode;
216}
217
218void
219sc_stop()
220{
221 if (::sc_gem5::Kernel::status() == SC_STOPPED)
222 return;
223
224 if (sc_is_running()) {
225 bool finish_delta = (_stop_mode == SC_STOP_FINISH_DELTA);
226 ::sc_gem5::scheduler.scheduleStop(finish_delta);
227 } else {
228 ::sc_gem5::Kernel::stop();
229 }
230}
231
232const sc_time &
233sc_time_stamp()
234{
235 static sc_time tstamp;
236 Tick tick = ::sc_gem5::scheduler.getCurTick();
237 //XXX We're assuming the systemc time resolution is in ps.
238 tstamp = sc_time::from_value(tick / SimClock::Int::ps);
239 return tstamp;
240}
241
242sc_dt::uint64
243sc_delta_count()
244{
245 return sc_gem5::scheduler.numCycles();
246}
247
248bool
249sc_is_running()
250{
251 return sc_get_status() & (SC_RUNNING | SC_PAUSED);
252}
253
254bool
255sc_pending_activity_at_current_time()
256{
257 return ::sc_gem5::scheduler.pendingCurr();
258}
259
260bool
261sc_pending_activity_at_future_time()
262{
263 return ::sc_gem5::scheduler.pendingFuture();
264}
265
266bool
267sc_pending_activity()
268{
269 return sc_pending_activity_at_current_time() ||
270 sc_pending_activity_at_future_time();
271}
272
273sc_time
274sc_time_to_pending_activity()
275{
276 return sc_time::from_value(::sc_gem5::scheduler.timeToPending());
277}
278
279sc_status
280sc_get_status()
281{
282 return ::sc_gem5::kernel ? ::sc_gem5::kernel->status() : SC_ELABORATION;
283}
284
285std::ostream &
286operator << (std::ostream &os, sc_status s)
287{
288 switch (s) {
289 case SC_ELABORATION:
290 os << "SC_ELABORATION";
291 break;
292 case SC_BEFORE_END_OF_ELABORATION:
293 os << "SC_BEFORE_END_OF_ELABORATION";
294 break;
295 case SC_END_OF_ELABORATION:
296 os << "SC_END_OF_ELABORATION";
297 break;
298 case SC_START_OF_SIMULATION:
299 os << "SC_START_OF_SIMULATION";
300 break;
301 case SC_RUNNING:
302 os << "SC_RUNNING";
303 break;
304 case SC_PAUSED:
305 os << "SC_PAUSED";
306 break;
307 case SC_STOPPED:
308 os << "SC_STOPPED";
309 break;
310 case SC_END_OF_SIMULATION:
311 os << "SC_END_OF_SIMULATION";
312 break;
313
314 // Nonstandard
315 case SC_END_OF_INITIALIZATION:
316 os << "SC_END_OF_INITIALIZATION";
317 break;
318 case SC_END_OF_UPDATE:
319 os << "SC_END_OF_UPDATE";
320 break;
321 case SC_BEFORE_TIMESTEP:
322 os << "SC_BEFORE_TIMESTEP";
323 break;
324
325 default:
326 if (s & SC_STATUS_ANY) {
327 const char *prefix = "(";
328 for (sc_status m = (sc_status)0x1;
329 m < SC_STATUS_ANY; m = (sc_status)(m << 1)) {
330 if (m & s) {
331 os << prefix;
332 prefix = "|";
333 os << m;
334 }
335 }
336 os << ")";
337 } else {
338 ccprintf(os, "%#x", s);
339 }
340 }
341
342 return os;
343}
344
345} // namespace sc_core