Changes between Version 1 and Version 2 of Component/Virtual Coprocessor Wrapper

Timestamp:

Jan 14, 2013, 6:14:17 PM (11 years ago)

Author:

meunier

Comment:

--

Component/Virtual Coprocessor Wrapper

@@ -69 +69 @@
 = Component usage =
 
-== Object ==
+The virtual Coprocessor Wrapper is primarily intended to be used with Dsx-vm (to be released soon?), but it can also be used "by hand". In the following is an example of a dummy ''adder'' task, which makes a vectorial 32-bit addition of size 8 (i.e. there are 16 words in input and 8 words in output). 3 files must be created:
+ * `my_adder_copro.sd`
+ * `my_adder_copro.h`
+ * `my_adder_copro.cpp`
+
+The file `my_adder_copro.sd` must contain the following:
 
 {{{
-soclib::common::ProcessWrapper *process;
+#!python
+#-*- python -*-
+
+Module('caba:my_adder_copro',
+       classname = 'dsx::caba::MyAdderCopro',
+       header_files = [
+               "my_adder_copro.h",
+
+       ],
+       interface_files = [
+       ],
+       implementation_files = [
+               "my_adder_copro.cpp",
+
+       ],
+       ports = [
+       ],
+       uses = [
+           Uses('caba:virtual_copro_wrapper'),
+       ],
+       instance_parameters = [
+       ],
+       tmpl_parameters = [
+       ],
+       extensions = [
+       ],
+)
 }}}
 
-== Instanciation ==
+The file `my_adder_copro.h` must be as following:
+
+{{{
+#!cpp
+
+#ifndef _ADDER_COPRO_H
+#define _ADDER_COPRO_H
+
+#include <systemc>
+
+#include "virtual_copro_wrapper.h"
+
+namespace dsx { namespace caba {
+
+class MyAdderCopro
+    : public dsx::caba::VirtualCoprocessorWrapper
+{
 
 
-{{{
-    soclib::common::ProcessWrapper(
-        const std::string &cmd,
-        const std::vector<std::string> &argv );
+public:
+    ~MyAdderCopro();
+    MyAdderCopro(sc_core::sc_module_name insname);
+
+private:
+    void * task_func(); // Task code
+
+};
+
+}}
+#endif /* _ADDER_COPRO_H */
 }}}
 
- cmd::
-   The command to launch, it will be looked for in $PATH
- argv::
-   The argv in a standart unix style. argv[0] should look like cmd.
-
-== Usage ==
+Finally, the file `my_adder_copro.cpp` must contain the task code. We declare here two "input fifos" (`input0` and `input1`) and one "output fifo" (`output`) in the constructor.
 
 {{{
-    std::vector<std::string> argv;
-    argv.push_back("date");
-    argv.push_back("+%s");
-    soclib::common::ProcessWrapper process("date", argv);
+#!cpp
 
-    char buffer[128];
-    process.read( buffer, 128 );
-    std::cout << "Date is " << buffer << " seconds since EPOCH" << std::endl;
+#include "my_adder_copro.h"
+
+namespace dsx { namespace caba {
+
+
+#define tmpl(...) __VA_ARGS__ MyAdderCopro
+
+tmpl(/**/)::~MyAdderCopro()
+{
+}
+
+tmpl(/**/)::MyAdderCopro(sc_core::sc_module_name insname)
+            dsx::caba::VirtualCoprocessorWrapper(insname, stringArray("output", NULL), intArray(1, 8), stringArray("input0", "input1", NULL), intArray(2, 8, 8))
+{
+}
+
+tmpl(void *)::task_func() {
+   srl_mwmr_t input = SRL_GET_MWMR(input);
+   srl_mwmr_t output = SRL_GET_MWMR(output);
+
+   uint32_t in0[8];
+   uint32_t in1[8];
+   uint32_t out[8];
+
+   while (true) {
+      srl_mwmr_read(input0, &in0, 1); // Read 8 words from input0, i.e. 1 item since the fifo is 8-word wide
+      srl_mwmr_read(input1, &in1, 1); // Read 8 words from input1
+      for (int32_t i = 0; i < 8; i++) {
+         out[i] = in0[i] + in1[i];
+      }
+      srl_mwmr_write(output, &out, 1); // Write 8 words to output
+   }
+}
+
+}}
 }}}
 
+
+À compléter...
+