Changes between Initial Version and Version 1 of DsxvmApplication

Timestamp:

Oct 22, 2012, 11:19:41 AM (12 years ago)

Author:

karaoui

Comment:

--

DsxvmApplication

@@ +1 @@
+= Application =
+
+To create an application for DSX-VM we need to:
+* write the code of different task and describe the task in a python file
+* describe the TCG (task and communication graph) of the application
+
+
+== Task writing ==
+
+To define a task you need to write down a least two files:
+ - a *.c file containing the code of the task : the task is writed using the [https://www-asim.lip6.fr/trac/dsx/wiki/DsxvmSRL_API "SRL API"]
+   - example :
+{{{
+/* those two first header must be declared */
+#include <srl.h> // same for all task and contain the definition of the SRL API functions
+#include "hello_proto.h" // containing specific definition for the task
+
+FUNC(hello_func)
+{
+    while(1)
+    {
+        srl_log_printf(NONE, "Hello world\n");
+    }
+}
+
+}}}
+
+ - a *.tsk file containing a python description (metadata) of the the task. The task is described by using TaskModel python class:
+{{{
+TaskModel( name, ports, impls, uses)
+}}}
+       - name : a string, describing the name of the application
+       - ports : a dictionary, describing the ports of communication and their names. Different port exist: 
+         - !MwmrInput : a mwmr input port
+         - !MwmrOutput : a mwmr output port
+         - !BarrierPort : a barrier port
+         - !LockPort : a lock port
+         - !MemspacePort : a memspace port
+       - impls : a list, describing the available implementations supported by the task
+         - swtask
+       - uses : a list of string, describing the used resources by the task (example: 'tty')
+
+
+== TCG ==
+
+The application is described by a TCG (task an communication graph).
+The TCG describe the flow of the application. It describe 
+* the interconnection 
+* the mean of communication (generally mwmr channel)
+beetween task.
+
+Example : This is a TCG of an application, with three task communicating through mwmrs channels.
+[[Image()]]