There are two installation options for Maté: use a packaged release, or work directly from CVS sources. In either case, to use Maté, you first need to install TinyOS: the TinyOS website has instructions. Once you've installed TinyOS (we recommend using the "latest CVS snapshot release," rather than version 1.1), you can then install Maté. Once you have installed the necessary software and code, you can get started with the Maté tutorials.

Hardware Requirements

We currently support Maté on the following platforms:

• mica
• mica2
• mica2dot
• micaZ
• TOSSIM
• telos (revA and revB)

Installing a Packaged Release

To use Maté, you first need to install TinyOS: the TinyOS webite has instructions. Maté requires TinyOS 1.1.9 or later (we recommend using the "latest CVS snapshot release). If you already have installed TinyOS >=1.1.9, you can skip this step.

We release Maté as a self-contained package:

• mate-asvm-2.2.2Apr2005-1.noarch.rpm

If you have an older, non-RPM, version of Maté installed, you need to remove its files before installing 2.2.2. We could have made the RPM do so automatically, but thought that deleting files off your drive was a recipe for your inadvertently losing work. To tell if you have a previous version, go to

tinyos-1.x/tos/lib

and look for a directory named VM. If there is one, delete it by typing

rm -Rf VM

Go to tinyos-1.x/tools/java/net/tinyos and do the same with the script directory. If you do not have a previous version, then you can just install the RPM.

2.2.1 is the latest version. If you want an earlier version, the full list can be found here. Download the package and install it by typing this at the command line:

The --replacefiles is needed to put a new version of the Maté manual in tinyos-1.x/docs. It will not change any other files. If you run into problems, you can mail the tinyos-help list. If

You can also download the Maté and TinyScript manuals.

The full set of prior Maté RPMs can be found here.

Installing from CVS

You can also use Maté directly from the TinyOS CVS repository. Source in CVS can have improved features over the latest release, but may also include minor bugs which we have not yet ironed out. The Maté source code exists in two directories:

1. tinyos-1.x/tools/java/net/tinyos/script
2. tinyos-1.x/tos/lib/VM

Recent versions of TinyoS (1.1.4 and after) include an improved TinyOS build system in tools/make, which the telos and micaZ platforms require. The new build system requires version 3.80 of the make utility.

However, for a particular set of TinyOS releases, (v1.1.4, 1.1.5, 1.1.6, and 1.1.7) make has several bugs, which Maté's Makefiles can trigger. To use Maté with the new build system, you have to upgrade to TinyOS 1.1.8 or later, patch make 3.8 yourself, or download a patched version. If you do not have a patched version of make, then when you try to compile a Maté program you'll see the error that says make "ran out of virtual memory."

If you are running Linux, you can download a patched executable. Be sure to back up your current version of make before installing it. For example:

$ mv /usr/bin/make /usr/bin/make-old
$ mv make-patched /usr/bin/make

Try compiling a TinyOS application: if make fails due to something like a linkage error, then you should restore your old version and build from source.

To build from source, download make-3.80patched.tar.gz. Make a backup copy of your current version of make:

$ cp /usr/bin/make /usr/bin/make-old

Expand the make 3.80 archive, run configure, and build it with your existing copy of make::

$ tar xfz make-3.80patched.tar.gz
$ ./configure --prefix=/usr
$ make-old
$ make-old install

This will install the new, patched version of make in /usr/bin. If it causes problems, you can always restore your older version.

Future TinyOS releases will include a patched version of make.