galsC Installation Instructions

galsC Installation Instructions

Last updated 25 April 2004

The galsC compiler is an extension of the nesC compiler. nesC is "an extension to the C programming language designed to embody the structuring concepts and execution model of TinyOS. TinyOS is an event-driven operating system designed for sensor network nodes that have very limited resources (e.g., 8K bytes of program memory, 512 bytes of RAM)." TinyOS, described at http://webs.cs.berkeley.edu/tos/, is used, for example, on the Berkeley MICA "motes," which are small wireless sensor nodes.

galsC programs are designed to run on the same platforms as nesC/TinyOS. However, galsC programs use the TinyGALS programming model, which replaces the TinyOS scheduler with a TinyGALS scheduler.

To install the galsC compiler and associated examples, you must first install TinyOS, then the galsC compiler. Choose one of the methods below to install each package. These instructions assume that you are either running linux or will be running Cygwin on Windows.

Install TinyOS (includes galsC examples).
- How to install the TinyOS rpms (TinyOS 1.1.x CVS Snapshots).
- How to install TinyOS from CVS.
Install the galsC compiler.

Run the example:

cd $TOSROOT/contrib/tinygals/apps/CntToLeds
make mica

How to install the TinyOS rpms (TinyOS 1.1.x CVS Snapshots)

To install a TinyOS 1.1.x snapshot, you must first have installed TinyOS 1.1.0. If you have not installed TinyOS 1.1.0, please see the TinyOS download page .
You need not install any previously released 1.1.x snapshots. That is, if you have 1.1.0 installed on your machine, you can jump right to installing 1.1.5 rather than installing 1.1.1... up to 1.1.5. Each 1.1.x CVS snapshot supercedes previous 1.1.x CVS snapshot releases.
If you already have TinyOS 1.1.0 installed, upgrade to TinyOS 1.1.x. Choose the appropriate directions for your operating system:
- If you are running Windows XP or Windows 2000:
  1. Save your previous work. We recommend making a tarball of your entire TinyOS-1.x directory and saving it someplace.
  2. Download the most recent 1.1.x rpm: tinyos-1.1.5Mar2004cvs-1.cygwin.noarch.rpm
  3. Install. As Administrator in a cygwin shell do:
```
rpm --force --ignoreos -Uvh tinyos-1.1.5Mar2004cvs-1.cygwin.noarch.rpm
                
```
    in the directory where you saved the rpm. This will take a while (the tinyos package installation includes compiling the java code). TinyOS is installed in /opt/tinyos-1.x.
  Check the documentation in /opt/tinyos-1.x/doc/index.html for more information.
- If you are running Linux (Redhat 9):
  1. Save your previous work. We recommend making a tarball of your entire tinyos-1.x directory and saving it someplace.
  2. Download the latest 1.1.x rpm tinyos-1.1.5Mar2004cvs-1.noarch.rpm
  3. Install. As root in linux install the 1.1.5 rpm with
    
    rpm -Uvh --prefix TINYOSDIR tinyos-1.1.5Mar2004cvs-1.noarch.rpm
    cd TINYOSDIR; chown -R USER.GROUP tinyos-1.x
    
    This will install TinyOS in TINYOSDIR/tinyos-1.x), for user USER (with group GROUP). Installing this rpm will take a while as the java code will be compiled.
    Note that this only allows one TinyOS source tree per machine, see the directions for using a CVS-based tree if you later need several distinct source trees.
Set the TOSROOT environment variable to the location of the TinyOS source tree; also set the TOSDIR environment variable.
- Under bash, type:
```
export TOSROOT=<TINYOSDIR>/tinyos-1.x
export TOSDIR=$TOSROOT/tos
            
```
- Under csh or tcsh, type:
```
setenv TOSROOT <TINYOSDIR>/tinyos-1.x
setenv TOSDIR $TOSROOT/tos
            
```
- Under Windows with Cygwin, you can permanently set environment variables from the System control panel. Right-click on My Computer and select Properties. Select the Advanced Tab and click on Environment Variables.
Download and install the galsC examples. Choose the appropriate directions for your operating system:
- If you are running Cygwin, download tinyos-contrib-1.1.2Apr2004cvs-1.cygwin.noarch.rpm
  If this is your first time installing, use:
```
rpm -ivh tinyos-contrib-1.1.2Apr2004cvs-1.cygwin.noarch.rpm
            
```
  Otherwise, upgrade using:
```
rpm -Uvh tinyos-contrib-1.1.2Apr2004cvs-1.cygwin.noarch.rpm
            
```
  This rpm was created using Cygwin DLL version 1.3.22.
- If you are running Linux (Redhat 9), download tinyos-contrib-1.1.2Apr2004cvs-1.noarch.rpm
  If this is your first time installing, do the following (use the same TINYOSDIR as above):
```
rpm -ivh --prefix <TINYOSDIR> tinyos-contrib-1.1.2Apr2004cvs-1.noarch.rpm
cd <TINYOSDIR>
chown -R <USER.GROUP> tinyos-1.x
            
```
  Otherwise, upgrade using:
```
rpm -Uvh --prefix <TINYOSDIR> tinyos-contrib-1.1.2Apr2004cvs-1.noarch.rpm
cd <TINYOSDIR>
chown -R <USER.GROUP> tinyos-1.x
            
```
(The directions above were modified from the original TinyOS CVS snapshot installation instructions).

How to install TinyOS from CVS

Install the AVR tools using the appropriate directions for your operating system:
- If you are running Windows XP or Windows 2000, you can either:
  - Download the TinyOS Installshield Wizard. Run the wizard, and choose "Custom" install. Install only the AVR tools. If you already have cygwin, do not choose the "cygwin" install option (it will overwrite and corrupt your current cygwin installation) or the "TinyOS" install option (you will install this later from CVS as a separate step). This will install all of the above rpms for you.
  - Or you can download the rpms separately from here. More convenient links are included here:
    and install them on the cygwin command line with
```
rpm --ignoreos -ivh *.rpm
```
    in the directory where you saved the files.
- If you are running Linux (Redhat 9), download the rpms from here. More convenient links are included here:
  and install them with
```
rpm -ivh *.rpm
```
  in the directory where you saved the files.
(The directions above were modified from the original TinyOS installation directions).
Make a directory into which to store the source code, for example:
```
    mkdir -p $HOME/galsc
        
```

Check out the TinyOS CVS repository:

cd $HOME/galsc
cvs -d:pserver:anonymous@cvs.sourceforge.net:/cvsroot/tinyos login
Hit Enter when prompted for a password
cvs -z3 -d:pserver:anonymous@cvs.sourceforge.net:/cvsroot/tinyos co tinyos-1.x

This will create a directory tinyos-1.x. For more information, see http://sourceforge.net/cvs/?group_id=28656.

Set the TOSROOT environment variable to the location of the TinyOS source tree; also set the TOSDIR environment variable.
- Under bash, type:
```
export TOSROOT=$HOME/galsc/tinyos-1.x
export TOSDIR=$TOSROOT/tos
            
```
- Under csh or tcsh, type:
```
setenv TOSROOT $HOME/galsc/tinyos-1.x
setenv TOSDIR $TOSROOT/tos
            
```
- Under Windows with Cygwin, you can permanently set environment variables from the System control panel. Right-click on My Computer and select Properties. Select the Advanced Tab and click on Environment Variables.

How to install the galsC rpm

Choose the appropriate directions for your system:

If you are using Cygwin:
1. Download galsc-0.1.0-1.cygwin.i386.rpm.
2. Install it:
```
rpm -ivh galsc-0.1.0-1.cygwin.i386.rpm
            
```
If you are using Linux (Redhat 9):
1. Download galsc-0.1.0-0.i386.rpm.
2. Install it:
```
rpm -ivh galsc-0.1.0-0.i386.rpm
            
```

The galsC installation should now be located in /usr/local/galsc.

How to install the galsC source distribution (.tar.gz) and build it

If you have not already done so, make a directory into which to store the source code, for example:
```
    mkdir -p $HOME/galsc
        
```

Download the galsC distribution and save it in $HOME/galsc. Install it:

cd $HOME/galsc
gunzip galsc-0.1.0.tar.gz
tar xvf galsc-0.1.0.tar

Run configure for galsC:

cd $HOME/galsc/galsc-0.1.0
./configure --prefix=$HOME/galsc

Install galsC:
```
make
make install
        
```
This will create directories in $HOME/galsc
Set the environment variable (GALSC) that points to the galsC installation.
- Under bash, type:
```
export GALSC=$HOME/galsc
            
```
- Under csh or tcsh, type:
```
setenv GALSC $HOME/galsc
            
```

How to install galsC from CVS and build it

You can also download the galsC source code and build it. It is based on the nesC compiler, which requires an impressive suite of tools.

Under Linux or Cygwin, you must have the following programs installed on your system:
- autoconf 2.50 or later
- bison
- emacs
- emacs-el
- gperf
- perl
- rpm
For help with how to install these in Cygwin, see The Cygwin FAQ. Note that most installations will not have gperf on them, at least, so you will likely need to install at least that.

Get the galsC CVS Tree, see http://sourceforge.net/cvs/?group_id=56288

cd $HOME/galsc
cvs -d:pserver:anonymous@cvs.sourceforge.net:/cvsroot/nescc login
Hit Enter when prompted for a password
cvs -z3 -d:pserver:anonymous@cvs.sourceforge.net:/cvsroot/nescc co -r galsc nesc

Boostrap galsC

cd $HOME/galsc/nesc
./Bootstrap

Run configure for galsC

./configure --prefix=$HOME/galsc

Install galsC
```
make
make install
        
```
This will create directories in $HOME/galsc
Set the environment variable (GALSC) that points to the galsC installation.
- Under bash, type:
```
export GALSC=$HOME/galsc
            
```
- Under csh or tcsh, type:
```
setenv GALSC $HOME/galsc
            
```
- Under Windows with Cygwin, you can permanently set environment variables from the System control panel. Right-click on My Computer and select Properties. Select the Advanced Tab and click on Environment Variables.