Chapter 6 Example 6: algorithm, architecture, adequation, and code generation

From the principal window, choose File / Save as and save your sixth application under a new folder of your tutorial folder (e.g. my_example6) with the name example6.

6.1 The main algorithm

Create the main algorithm algo (cf. figure 6.1) using the library int for the operations In<1> (input), cste2<{2}> (cst), add<1> (Arit_add), mul<1> (Arit_mul), visuadd<1>, and visumul<1> (output). For the operation conv, create a function definition conv, create a reference to this definition, and give it a duration. Create the dependences between the references. Set it as main.

Figure 6.1: Main algorithm of the Example 6

Warning: it is necessary that the sensor “in” should be distributed onto the processor “root”, i.e. on the local machine, in order that it operates properly.

6.2 The main architecture

To define and constraint the main architecture:

include the library u,
from the principal window, choose Architecture / Edit Architecture Definition and open the architecture biProc,
define it as main,
create the operation groups og1 and og2 then create the absolute constraints on the operators: og1 on root, og2 on P1. Attach references to operation groups: In, add, and visumul → og1, mul, and visuadd → og2.

6.3 The adequation and the code generation

To perform the adequation and to generate the code:

before performing the code generation, you have to perform the adequation. Set the possibly missing durations, then from the principal window: Adequation / Launch Adequation;
from the principal window: Code / Generate Executive(s). It generates for each operator of the main architecture the code in a file (files root.m4 and P1.m4) and an architecture description (file example6.m4). These files are generated in the same folder as the application. The files generated for each processor may be viewed: Code / Display Executive(s);
the macros corresponding to the operations, included in the libraries of SynDEx, are already defined under the folder macros (files int.m4x, U.m4x, and TCP.m4x);

in the same folder as the SynDEx application of the Example 6, create a new file example6.m4x in which you define the macro corresponding to the operation conv which is the only one not defined in the library, and the number of iterations. The file looks like:

    
      dnl (c)INRIA 2001-2009
      dnl SynDEx v7 executive macros specific to application tutorial/example6/example6
      divert(-1)

      define(‘NOTRACEDEF’)
      define(‘NBITERATIONS’,3)
      define(‘BINPWD’, ‘pwd’)
      define(‘RSHELL’, ‘ssh’)

      define(‘conv’,‘ifelse(
      MGC,‘INIT’,‘dnl’,
      MGC,‘LOOP’,‘$2[0] = $1[0] + 1;’,
      MGC,‘END’,‘dnl’)’)

      divert
      divert(-1)
      divert‘’dnl—————- end of file ——————

create a new file example6.m4m, in which you set for each operator, except the main operator, the name of a workstation corresponding to this operator. The file looks like:
```
    
      dnl (c)INRIA 2001-2009
      define(‘P1_hostname_’, HOSTNAME)dnl
    
  
```
where HOSTNAME is the name of the remote workstation, as indicated in the Readme file under
syndex/examples/tutorial/example6;
Warning: the characters ‘ and ’ are different.
Warning: if you increase the number of processors in your architecture, you must add other define statements with the corresponding “processor name”, “remote worksation name” association.

create a new file root.m4x for the main operator including the file example6.m4m:

    
      dnl (c)INRIA 2001-2009
      include(example6.m4m)

create a new file GNUmakefile which allows the compilation and the substitution of the macros from the code generation by the executable code. The file looks like:

    
      # (c)INRIA 2001-2009
      A  = example6
      M4 = m4

      export SynDEx_Path = SYNDEXPATH
      export Algo_Macros_Path = $(SynDEx_Path)/macros/algo_libraries
      export Archi_Macros_Path = $(SynDEx_Path)/macros/archi_libraries
      export M4PATH = $(Algo_Macros_Path):$(Archi_Macros_Path)

      CFLAGS = -DDEBUG
      VPATH = $(M4PATH)

      .PHONY: all clean
      all : $(A).mk $(A).run
      clean ::
      $(RM) $(A).mk

      $(A).mk : $(A).m4 syndex.m4m U.m4m $(A).m4m
      $(M4) $< >$@

      root.libs =
      P1.libs =

      include $(A).mk

where SYNDEXPATH is the absolute path of the SynDEx distribution.
Warning: in the previous makefile the statements $(RM) $(A).mk and $(M4) $< >$@ must begin with a tab character.
The folder of the Example 6 must contain the following files:

example6.m4
example6.m4m
example6.m4x
example6.sdc
example6.sdx
GNUmakefile
p1.m4
root.m4
root.m4x

To launch the execution, type the command make in the folder of the Example 6. To delete the file created during the compilation, type the command gmake clean.

From the principal window, choose File / Close. In the dialog window, click on the Save button.