SYNCCHARTS INSTALLATION

January 21, 2005: NEW capability (beta version): running under Cygwin. Use dedicated installation commands.

Preliminary installation

This part is to be done once for all.It is mandatory for all my software distributions.

All the applications are installed in subdirectories of the same directory, for instance $HOME/tools. In what follows this directory is denoted by <appl_dir>

1. Create the directory (<appl_dir>) in which applications will be installed.
2. Set the environment variable SOFTDIR to <appl_dir>.
3. Add $SOFTDIR/bin to your PATH environment variable.

SOFTDIR is a pivot for all applications. Be sure this variable is correctly initialized prior to any further installations.

Since applications rely on Tcl/Tk, you should have a wish installed on your system (Tcl/Tk 8.3 or better)

Other Installations

Tcl/Tk, Esterel v2.91, ... are not provided. Take them at their own sites.

Installation of SyncCharts

If you have an old version installed, remove it by a recursive remove.

Machine independent part

>cd $SOFTDIR

download the "Machine Independent Code Distribution"

>gunzip -c sc.tgz | tar xvfp -

Check your directories:

• bin
• tcl
• SYNCCHARTS
  • EXAMPLES
  • bin
  • SOURCES
    • TCL/XBM
    • TCL/DEMO
    • MKDIST

The above hierarchy should have been created and populated. Be sure that a symbolic link, called syncCharts is present in the bin directory. This symbolic link points to $SOFTDIR/SYNCCHARTS/MKDIST/syncCharts, a Tcl file.

Platform dependent code

>cd SYNCCHARTS

download the file and unpack it

>gunzip -c scparXXX.tgz | tar xvfp -

This command create a directory (Linux2.2 or Linux2.4 or Cygwin) that contains binary code for parsing.

Note that scparlX.tgz is a file that contains executable code for parsers running under linux, on a pentium, and compiled with g++ version 2.8 or better. Other systems are older versions, no longer maintained.

Possible parser directories:

• Linux2.2 for linux2.2 kernels
• Linux2.4 for linux2.4 and linux2.6 kernels
• Cygwin for cygwin (experimental distribution)

Caveats: when compiling a syncChart into an Esterel program, you might get a strange message "Parsing error : `;;;.` ...", an then a lot of error messages. This is due to the absence of a shared library named libstdc++-libc6.1-2.so.3. In this case, find the nearest library in the /usr/lib directory and make a symbolic link between libstdc++-libc6.1-2.so.3 and the found library.

Documentation

Always in the SYNCCHARTS directory, download and unpack the documentation

>gunzip -c doc.tgz | tar xvfp -

This command create the doc directory.

Experiment

>cd EXAMPLES

>syncCharts

for Cygwin: >syncCharts -- -c

Enjoy!

That's All Folks!