SystemC 10 Combined Events

wait()

The following forms of wait() are supported.

  1. wait(): wait on events in sensitivity list (SystemC 1.0).
    • Need to add a sensitivity list sensitive << e1 << e2; in the module constructor (eg. SC_CTOR)
  2. wait(e1): wait on event e1.
  3. wait(e1 | e2 | e3): wait on events e1, e2, or e3.
  4. wait(e1 & e2 & e3): wait on events e1, e2, and e3.
  5. wait(200, SC_NS): wait for 200 ns.
  6. wait(200, SC_NS, e1): wait on event e1, timeout after 200 ns.
  7. wait(200, SC_NS, e1 | e2 | e3): wait on events e1, e2, or e3, timeout after 200 ns.
  8. wait(200, SC_NS, e1 & e2 & e3): wait on events e1, e2, and e3, timeout after 200 ns.
  9. wait(sc_time(200, SC_NS)): wait for 200 ns.
  10. wait(sc_time(200, SC_NS), e1): wait on event e1, timeout after 200 ns.
  11. wait(sc_time(200, SC_NS), e1 | e2 | e3): wait on events e1, e2, or e3, timeout after 200 ns.
  12. wait(sc_time(200, SC_NS), e1 & e2 & e3 ): wait on events e1, e2, and e3, timeout after 200 ns.
  13. wait(200): wait for 200 clock cycles, SC_CTHREAD only (SystemC 1.0)
  14. wait(0, SC_NS): wait one delta cycle.
  15. wait(SC_ZERO_TIME): wait one delta cycle.

Note: a mixture of “|” operators and “&” operators is not supported in SystemC 2.0

Code



1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76



// Learn with Examples, 2020, MIT license
#include <systemc>
using namespace sc_core;

SC_MODULE(COMBINED) {
  sc_event e1, e2, e3, e4, e5, e6, e7, e8, e9, e10; // declare multiple events
  SC_CTOR(COMBINED) {
    SC_THREAD(trigger); // reigster trigger
    SC_THREAD(catcher_0); // register catchers
    SC_THREAD(catcher_1);
    SC_THREAD(catcher_2and3);
    SC_THREAD(catcher_4or5);
    SC_THREAD(catcher_timeout_or_6);
    SC_THREAD(catcher_timeout_or_7or8);
    SC_THREAD(catcher_timeout_or_9and10);
  }
  void trigger(void) {
    e1.notify(1, SC_SEC);  // e1 fires at 1s
    e2.notify(2, SC_SEC);  // ...
    e3.notify(3, SC_SEC);
    e4.notify(4, SC_SEC);
    e5.notify(5, SC_SEC);
    e6.notify(6, SC_SEC);
    e7.notify(7, SC_SEC);
    e8.notify(8, SC_SEC);
    e9.notify(9, SC_SEC);
    e10.notify(10, SC_SEC); // e10 fires at 10s
  }
  void catcher_0(void) {
    wait(2, SC_SEC); // timer triggered
    std::cout << sc_time_stamp() << ": 2sec timeout" << std::endl;
  }
  void catcher_1(void) {
    wait(e1); // e1 triggered
    std::cout << sc_time_stamp() << ": catch e1" << std::endl;
  }
  void catcher_2and3(void) {
    wait(e2 & e3); // e2 and e3
    std::cout << sc_time_stamp() << ": catch e2 and e3" << std::endl;
  }
  void catcher_4or5(void) {
    wait(e4 | e5); // e4 or e5
    std::cout << sc_time_stamp() << ": catch e4 or e5" << std::endl;
  }
  void catcher_timeout_or_6(void) {
    wait(sc_time(5, SC_SEC), e6); // timer or e6
    std::cout << sc_time_stamp() << ": 5sec timeout or catch e6"<< std::endl;
  }
  void catcher_timeout_or_7or8(void) {
    wait(sc_time(20, SC_SEC), e7 | e8); // timer or (e7 or e8)
    std::cout << sc_time_stamp() << ": 20sec timeout or catch e7 or e8" << std::endl;
  }
  void catcher_timeout_or_9and10(void) {
    wait(sc_time(20, SC_SEC), e9 & e10); // timer or (e9 and e10)
    std::cout << sc_time_stamp() << ": 20sec timeout or catch (e9 and e10)" << std::endl;
  }
};

int sc_main(int, char*[]) {
  COMBINED combined("combined");
  sc_start();
  return 0;
}

// Result

1 s: catch e1
2 s: 2sec timeout
3 s: catch e2 and e3
4 s: catch e4 or e5
// timeout comes first
5 s: 5sec timeout or catch e6
// e7 comes first
7 s: 20sec timeout or catch e7 or e8
// (e9 and e10) comes first
10 s: 20sec timeout or catch (e9 and e10)

Reference

Notes Mentioning This Note

SystemC Tutorials
SystemC Tutorials

Table of Contents
Share on: