add a systemc subfolder and 1by2 binary to decimal decoder example, remove some unecessary files, edit readme

Author: Muriukidavid

Makefile

@@ -1,6 +1,6 @@
 CXX = g++
 
-all:calc tempcalc clock
+all:calc tempcalc clock hello
 clock:clock.cc
 	@echo 'Building file: $(@F)'
 	$(CXX) $< -o $@
@@ -10,11 +10,10 @@ calc:calc.cc
 tempcalc:tempcalc.cc
 	@echo 'Building file: $(@F)'
 	$(CXX) $< -o $@
-hello:hello.cc
-	@echo 'building file: $(@F)'
-	$(CXX) -I/usr/local/systemc-2.3.0/include -O0 -g3 -Wall -c hello.cc
-	$(CXX) -L/usr/local/systemc-2.3.0/lib-linux64 -o "hello" hello.o -lsystemc
+systemc:
+	cd systemc; $(MAKE) 
 cleanclock:
 	rm -f clock.o clock
 clean:
 	rm -f *.out *.o calc tempcalc clock
+.PHONY: systemc

README

@@ -1 +1 @@
-These are c++ examples I use while teaching basics of systemC 
+These are c++ examples I use while teaching basics of systemC. they include use of classes, templates and features like inheritance. I have included a basic decoder example and some examples found in systemc books as a start. I intend to grow these into a set of systemc starting point examples showing how different features of the library may be used. Feel free to fork, add examples and contribute back.

module.h

@@ -0,0 +1,15 @@
+
+all: hello decoder
+
+hello:hello.cc
+	@echo 'building file: $(@F)'
+	$(CXX) -I/usr/local/systemc-2.3.0/include -O0 -g3 -Wall -c hello.cc
+	$(CXX) -L/usr/local/systemc-2.3.0/lib-linux64 -o "hello" hello.o -lsystemc
+	./hello
+decoder:decoder.cc
+	@echo 'building file $(@F)'
+	$(CXX) -I/usr/local/systemc-2.3.0/include -O0 -g3 -Wall -c decoder.cc
+	$(CXX) -L/usr/local/systemc-2.3.0/lib-linux64 -o "decoder" decoder.o -lsystemc
+	./decoder
+	gtkwave timing_diagram.vcd
+.PHONY: decoder

systemc/Makefile

@@ -0,0 +1,39 @@
+#include"decoder.h"
+#include"driver.h"
+#include"monitor.h"
+#include<systemc>
+
+int sc_main(int argc, char *argv[]){
+//some signals for interconnections
+sc_signal<bool> in, out1, out2;
+//module instances
+decoder dec("decoder_instance");
+driver dr("driver");
+monitor mn("monitor");
+//interconnections b2in modules
+dr.d_a(in);
+dec.a(in);
+mn.m_a(in);
+
+dec.b(out1);
+mn.m_b(out1);
+
+dec.c(out2);
+mn.m_c(out2);
+
+//create a trace file with nanosecond resolution
+sc_trace_file *tf;
+tf = sc_create_vcd_trace_file("timing_diagram");
+tf->set_time_unit(1, SC_NS);
+//trace the signals interconnecting modules
+sc_trace(tf, in, "binary_input"); // signals to be traced
+sc_trace(tf, out1, "input_is_zero");
+sc_trace(tf, out2, "input_is_one");
+
+//run a simulation for 20 systemc nano-seconds
+if( !sc_pending_activity() )
+sc_start(25,SC_NS);
+//close the trace file
+sc_close_vcd_trace_file(tf);
+return 0;
+}

systemc/decoder.cc

@@ -0,0 +1,22 @@
+#include<systemc.h>
+
+SC_MODULE(decoder){
+//input and output ports
+sc_in<bool> a;
+sc_out<bool> b,c;
+//constructor: where the processes are bound to simulation kernel
+SC_CTOR(decoder){
+	SC_METHOD(decode);
+	sensitive<<a;
+	//dont_initialize();
+}
+
+~decoder(){
+//delete stuff :P
+}
+
+void decode(void){
+	b=(a==0)?1:0;
+	c=(a==1)?1:0;
+}
+};

systemc/decoder.h

@@ -0,0 +1,23 @@
+#ifndef DRIVER_H_
+#define DRIVER_H_
+
+#include<systemc>
+
+SC_MODULE(driver){
+sc_out<bool> d_a;
+
+SC_CTOR(driver){
+	SC_THREAD(drive);
+}
+
+void drive(void){
+	while(1){
+		d_a=0;
+		wait(5,SC_NS);
+		d_a=1;
+		wait(5,SC_NS);
+	}
+}
+};
+
+#endif

systemc/driver.h

@@ -8,7 +8,7 @@ SC_CTOR(test){
 //	sensitive<<a;
 }
 void testing(void){
-	SC_REPORT_INFO(SC_INFO,"Hello SystemC World!");
+	SC_REPORT_INFO(1,"Hello SystemC World!");
 }
 ~test(){
 //delete stuff

hello.cc systemc/hello.cc

@@ -0,0 +1,23 @@
+#ifndef MONITOR_H_
+#define MONITOR_H_
+
+#include<iostream>
+#include<systemc>
+
+using namespace std;
+
+SC_MODULE(monitor){
+sc_in<bool> m_a, m_b,m_c;
+
+SC_CTOR(monitor){
+	SC_METHOD(monita);
+	sensitive<<m_b<<m_c;
+	dont_initialize();
+}
+
+void monita(void){
+cout<<"at "<<sc_time_stamp()<<" input is: "<<m_a<<" outputs are: "<<m_b<<" and "<<m_c<<endl;
+}
+};
+
+#endif

hello.h systemc/hello.h

@@ -0,0 +1,49 @@
+$date
+     Nov 21, 2014       00:10:23
+$end
+
+$version
+              SystemC 2.3.0_pub_rev_20111121-OSCI --- Oct 29 2014 22:58:28
+$end
+
+$timescale
+     1 ns
+$end
+
+$scope module SystemC $end
+$var wire    1  aaa  binary_input       $end
+$var wire    1  aab  input_is_zero       $end
+$var wire    1  aac  input_is_one       $end
+$upscope $end
+$enddefinitions  $end
+
+$comment
+All initial values are dumped below at time 0 sec = 0 timescale units.
+$end
+
+$dumpvars
+0aaa
+1aab
+0aac
+$end
+
+#5
+1aaa
+0aab
+1aac
+
+#10
+0aaa
+1aab
+0aac
+
+#15
+1aaa
+0aab
+1aac
+
+#20
+0aaa
+1aab
+0aac
+