Changes between Version 4 and Version 5 of Soclib Cc/And Modelsim

Timestamp:

Mar 26, 2010, 5:03:37 PM (16 years ago)

Author:

Nicolas Pouillon

Comment:

--

Soclib Cc/And Modelsim

@@ -67 +67 @@
         max_processes = 1,
         # No cflags are needed, sccom forces them
-        cflags = [],
+        cflags = ['-m32'],
         # Special features, it has a -link invocation needed at end...
         libs = ['-link'],
@@ -118 +118 @@
 Now we configured soclib-cc, we can compile a complete SystemC system.
 
-Example to come
+Let's have an example system with two basic components communicating through a fifo.
+
+[[Image(cosim-pf1.png,nolink)]]
+
+We'll use
+ * SoCLib SystemC Fifo Ports,
+ * a VHDL `fifo_gen` component,
+ * a VHDL-SystemC `fifo_gen_wrapper` wrapper,
+ * a SystemC `fifo_wrapper` hosting a pure-C++.
+
+This basic system has to be modeled as the following tree:
+
+[[Image(cosim-pf2.png,nolink)]]
+
+It contains:
+ `fifo_gen`::
+  The VHDL component writing to the Fifo
+ `fifo_gen_wrapper`::
+  The VHDL/SystemC wrapper to export `fifo_gen` to the SystemC world
+ `fifo_reader`::
+  A SystemC component reading from the fifo
+ `topcell`::
+  A SystemC component implementing the topcell
+ `system_driver`::
+  A SystemC component controlling `reset` and `clock` signals
+
+In order to simulate this system we need to:
+ * Reset the work directory, to make sure,
+{{{
+ $ rm -rf work transcript modelsim.ini fifo_gen_wrapper/fifo_gen.h  vsim.wlf
+}}}
+ * Initialize modelsim `work` directory,
+{{{
+ $ vlib work
+ $ vmap work work
+}}}
+ * Compile the VHDL module with vcom.
+{{{
+ $ vcom fifo_gen/fifo_gen.vhd
+}}}
+ * Generate the SystemC wrapper of the `fifo_gen` VHDL module with `scgenmod`
+{{{
+ $ scgenmod -sc_uint -bool fifo_gen > fifo_gen_wrapper/fifo_gen.h
+}}}
+ * Compile the SystemC system driver with soclib-cc, all dependancies are pulled with it.
+   `.sd` metadata are needed (even for the VHDL/SystemC wrapper), see in tarball.
+{{{
+ $ soclib-cc -1 caba:system_driver -t sccom -v -o sccom-link.o
+}}}
+ * Open modelsim with the platform
+{{{
+ $ vsim -novopt -sclib work system_driver
+}}}
+
+See the attached tarball for the complete example