Difference between revisions of "Installing TinyOS 2.0.2"

From TinyOS Wiki
Jump to: navigation, search
m
 
(16 intermediate revisions by 5 users not shown)
Line 1: Line 1:
'''Installing TinyOS 2.0.2'''
 
 
 
 
<p>If you already have a 1.x tree or an existing 2.x tree, you can use the <i>upgrade</i> instructions at  
 
<p>If you already have a 1.x tree or an existing 2.x tree, you can use the <i>upgrade</i> instructions at  
 
[http://www.tinyos.net/tinyos-2.x/doc/html/upgrade-tinyos.html], with the added note that Cygwin should be upgraded to the latest version. In cygwin run "cygcheck -c"  and check the cygwin entry is 1.5.25-11 or later. As of Apr08, Cygwin is not supported on Windows Vista.
 
[http://www.tinyos.net/tinyos-2.x/doc/html/upgrade-tinyos.html], with the added note that Cygwin should be upgraded to the latest version. In cygwin run "cygcheck -c"  and check the cygwin entry is 1.5.25-11 or later. As of Apr08, Cygwin is not supported on Windows Vista.
Line 16: Line 13:
 
<h1>Two-step install on your host OS with Debian packages</h1>
 
<h1>Two-step install on your host OS with Debian packages</h1>
  
If you are running a version of Linux that supports Debian packages, then you may want to use the TinyOS package repository. There is a [http://www.tinyos.net/scoop/story/2007/8/15/234856/990 story on www.tinyos.net] that describes how to use it. If you do this, then you do not have to install the instructions here, except that you will need to check that your environment is set up correctly (the end of step 5 in the manual installation.
+
If you are running a version of Linux that supports Debian packages, then you may want to use the TinyOS package repository.
 +
 
 +
1) Remove any old tinyos repository from /etc/apt/sources.list and add the following:
 +
<br>  Supported distributions are (hardy, intrepid, jaunty, karmic)
 +
  deb http://hinrg.cs.jhu.edu/tinyos <distribution> main
 +
 
 +
2) Update your repository cache:
 +
  sudo apt-get update
 +
3) Run the following to install the latest release of tinyos and all its supported tools:
 +
  sudo apt-get install tinyos
 +
4) Add the following line to your <code>~/.bashrc</code> or <code>~/.profile</code> file in your home directory to set up the environment for TinyOS development at login
 +
  #Sourcing the tinyos environment variable setup script
 +
  source /opt/tinyos-2.0.2/tinyos.sh
 +
 
 +
If you typically run tinyos from CVS and only require the toolchain installation, you can install the <code>tinyos-required</code> package instead of the <code>tinyos</code> one to just pull these in.
 +
 
 +
Keep in mind had inconsistent success with running <code>apt-get <b>upgrade</b> tinyos</code>, so for now it's best to play it safe and remove any old tinyos packages before installing the new ones.  
 +
 
 +
Also you have used the TinyOS debian repository in the past, keep in mind that all of the tools have been updated for the upcoming TinyOS-2.1 release, but still work with all older versions of TinyOS as well. If you try updating in this way, and you see conflicts with some deprecated packages, send me an email (cire831@gmail.com), and I'll add them to the conflicts list so that they get removed when the updated tools are installed.  These conflicts should be OK so long as you remove any old packages; they are due to a change in the names of the updated packages installing into the same locations as the outdated ones.
  
 
<h1>Manual installation on your host OS with RPMs</h1>
 
<h1>Manual installation on your host OS with RPMs</h1>
Line 45: Line 60:
 
   install TinyOS programs, you need the code.</li>
 
   install TinyOS programs, you need the code.</li>
 
   <li><b>Installing the Graphviz visualization tool.</b> The TinyOS
 
   <li><b>Installing the Graphviz visualization tool.</b> The TinyOS
   environment includes <tt>nesdoc</tt>, a tool that automatically
+
   environment includes <tt>[[nesdoc]]</tt>, a tool that automatically
 
   generates HTML documentation from source code. Part of this process
 
   generates HTML documentation from source code. Part of this process
 
   involves drawing diagrams that show the relationships between
 
   involves drawing diagrams that show the relationships between
Line 61: Line 76:
 
<b>Linux</b>
 
<b>Linux</b>
 
Download and install IBM's 1.5 JDK from [http://www-128.ibm.com/developerworks/java/jdk/ http://www-128.ibm.com/developerworks/java/jdk/].
 
Download and install IBM's 1.5 JDK from [http://www-128.ibm.com/developerworks/java/jdk/ http://www-128.ibm.com/developerworks/java/jdk/].
 
</p>
 
  
 
<h2>Step 2: Install Cygwin</h2>
 
<h2>Step 2: Install Cygwin</h2>
Line 89: Line 102:
 
:# When it ask for ''"Select local Package directory"'' then select ''"c:/cygwin-files"'' (Note: this location depends on where you have unzip cygwin-files.zip, in step-1 above we have used c:/cygwin-files)
 
:# When it ask for ''"Select local Package directory"'' then select ''"c:/cygwin-files"'' (Note: this location depends on where you have unzip cygwin-files.zip, in step-1 above we have used c:/cygwin-files)
 
:# Complete the rest of installation process
 
:# Complete the rest of installation process
 +
</ol>
  
 
Some notes:
 
Some notes:
Line 101: Line 115:
 
</ul>
 
</ul>
  
==Step 3: Install native compilers ==
+
<h2>Step 3: Install native compilers </h2>
  
 
<p>Install the appropriate version of the following (Windows or Linux,
 
<p>Install the appropriate version of the following (Windows or Linux,
Line 109: Line 123:
 
computer and you're on a windows NT computer, bypass the erroneous
 
computer and you're on a windows NT computer, bypass the erroneous
 
error by using 'rpm -ivh --ignoreos <i>rpmname</i>'.
 
error by using 'rpm -ivh --ignoreos <i>rpmname</i>'.
(We have xscale
+
</p>
compiler tools online at
 
[http://www.tinyos.net/dist-1.2.0/tools/ http://www.tinyos.net/dist-1.2.0/tools/]
 
but they have not yet been extensively tested by a large community.)</p>
 
  
 
<b><em>Atmel AVR Tools</em></b>
 
<b><em>Atmel AVR Tools</em></b>
 
<table border="0">
 
<table border="0">
<tbody><tr>
+
<tr>
 
   <td bgcolor="#dddddd"><b>Tool</b></td>
 
   <td bgcolor="#dddddd"><b>Tool</b></td>
  
Line 156: Line 167:
 
</tr>
 
</tr>
  
</tbody></table>
+
</table>
 
<i><font color="red">&#8224;</font>If you receive an rpm error that indicates that you have a newer version already installed, try <code>rpm -Uvh --force</code></i>
 
<i><font color="red">&#8224;</font>If you receive an rpm error that indicates that you have a newer version already installed, try <code>rpm -Uvh --force</code></i>
 +
 +
 +
<p></p><b><em>PXA27x Tools (iMote2)</em></b>
 +
<table border="0">
 +
<tr>
 +
  <td bgcolor="#dddddd"><b>Tool</b></td>
 +
  <td bgcolor="#dddddd"><b>Windows/Cygwin</b></td>
 +
  <td bgcolor="#dddddd"><b>Linux</b></td>
 +
</tr>
 +
 +
<tr>
 +
  <td>xscale-elf-binutils</td>
 +
  <td>[http://sing.stanford.edu/intelmote2/tools/windows/xscale-elf-binutils-2.15-1.cygwin.i386.rpm xscale-elf-binutils-2.15tinyos-1.cygwin.i386.rpm]</td>
 +
  <td>[http://sing.stanford.edu/intelmote2/tools/linux/xscale-elf-binutils-2.15-2.i386.deb xscale-elf-binutils-2.15-2.i386.deb]</td>
 +
</tr>
 +
 +
<tr>
 +
  <td bgcolor="#dddddd">xscale-elf-gcc</td>
 +
  <td bgcolor="#dddddd">[http://sing.stanford.edu/intelmote2/tools/windows/xscale-elf-gcc-3.4.3-1.cygwin.i386.rpm xscale-elf-gcc-3.4.3-1.cygwin.i386.rpm]</td>
 +
 +
  <td bgcolor="#dddddd">[http://sing.stanford.edu/intelmote2/tools/linux/xscale-elf-gcc-3.4.3-2.i386.deb xscale-elf-gcc-3.4.3-2.i386.deb]</td>
 +
</tr>
 +
 +
<tr>
 +
  <td>xscale-elf-newlibc</td>
 +
  <td>[http://sing.stanford.edu/intelmote2/tools/windows/xscale-elf-newlib-1.11.0tinyos-1.cygwin.i386.rpm xscale-elf-newlib-1.11.0tinyos-1.cygwin.i386.rpm]</td>
 +
  <td>[http://sing.stanford.edu/intelmote2/tools/linux/xscale-elf-newlib-1.13.0-1.i386.deb xscale-elf-newlib-1.13.0-1.i386.deb]</td>
 +
</tr>
 +
 +
<tr>
 +
  <td>jtag</td>
 +
  <td>[http://sing.stanford.edu/intelmote2/tools/windows/jflashmm.tgz jflashmm.tgz]<font color="red">†</font></td>
 +
  <td>[http://docs.tinyos.net/index.php/OpenOCD_for_IMote2 OpenOCD toolchain]</td>
 +
</tr>
 +
</table>
 +
<i><font color="red">†</font>Copy jflashmm.tgz to /opt directory, untar it (tar xzf jflashmm.tgz), and make sure it's on your path (see Step 5).</i>
 +
  
 
<p></p><b><em>TI MSP430 Tools</em></b>
 
<p></p><b><em>TI MSP430 Tools</em></b>
 
<table border="0">
 
<table border="0">
<tbody><tr>
+
<tr>
 
   <td bgcolor="#dddddd"><b>Tool</b></td>
 
   <td bgcolor="#dddddd"><b>Tool</b></td>
 
   <td bgcolor="#dddddd"><b>Windows/Cygwin</b></td>
 
   <td bgcolor="#dddddd"><b>Windows/Cygwin</b></td>
Line 216: Line 264:
 
</tr>
 
</tr>
  
</tbody></table>
+
</table>
  
 
<h2>Step 4: Install TinyOS toolchain</h2>
 
<h2>Step 4: Install TinyOS toolchain</h2>
Line 245: Line 293:
 
<b><em>TinyOS-specific Tools</em></b>
 
<b><em>TinyOS-specific Tools</em></b>
 
<table border="0">
 
<table border="0">
<tbody><tr>
+
<tr>
 
   <td bgcolor="#dddddd"><b>Tool</b></td>
 
   <td bgcolor="#dddddd"><b>Tool</b></td>
 
   <td bgcolor="#dddddd"><b>Recommended Windows/Cygwin</b></td>
 
   <td bgcolor="#dddddd"><b>Recommended Windows/Cygwin</b></td>
Line 282: Line 330:
 
</tr>
 
</tr>
  
</tbody></table>
+
</table>
  
 
<h2>Step 5: Install the TinyOS 2.x source tree </h2>
 
<h2>Step 5: Install the TinyOS 2.x source tree </h2>
Line 289: Line 337:
 
source tree and then set your environment variables.
 
source tree and then set your environment variables.
 
Install the appropriate version of the following (Window or Linux)
 
Install the appropriate version of the following (Window or Linux)
with the rpm command 'rpm -ivh <i>rpm</i>'.  
+
with the rpm command 'rpm -ivh <i>rpm</i>'. (Please read the COMMENT below)
 
As with the previous rpms, if you get an error claiming that the rpm
 
As with the previous rpms, if you get an error claiming that the rpm
 
was build for an NT computer and you're on a windows NT computer,
 
was build for an NT computer and you're on a windows NT computer,
Line 303: Line 351:
 
<b><em>TinyOS 2.x</em></b>
 
<b><em>TinyOS 2.x</em></b>
 
<table border="0">
 
<table border="0">
<tbody><tr>
+
<tr>
 
   <td bgcolor="#dddddd"><b></b></td>
 
   <td bgcolor="#dddddd"><b></b></td>
 
   <td bgcolor="#dddddd"><b>Windows/Cygwin</b></td>
 
   <td bgcolor="#dddddd"><b>Windows/Cygwin</b></td>
Line 316: Line 364:
 
</tr>
 
</tr>
  
</tbody></table></li>
+
</table></li>
  
 
<li> Configure your environment
 
<li> Configure your environment
Line 339: Line 387:
 
<b><em>TinyOS 2.x</em></b>
 
<b><em>TinyOS 2.x</em></b>
 
<table border="0">
 
<table border="0">
<tbody><tr>
+
<tr>
 
   <td bgcolor="#dddddd"><b>Environment Variable</b></td>
 
   <td bgcolor="#dddddd"><b>Environment Variable</b></td>
 
   <td bgcolor="#dddddd"><b>Windows</b></td>
 
   <td bgcolor="#dddddd"><b>Windows</b></td>
Line 361: Line 409:
 
</td></tr><tr>
 
</td></tr><tr>
 
   <td>CLASSPATH</td>
 
   <td>CLASSPATH</td>
   <td>C:\tinyos\cygwin\opt\tinyos-2.x\support\sdk\java\tinyos.jar;.</td>
+
   <td>C:\cygwin\opt\tinyos-2.x\support\sdk\java\tinyos.jar;.</td>
 
   <td>$TOSROOT/support/sdk/java/tinyos.jar:.</td>
 
   <td>$TOSROOT/support/sdk/java/tinyos.jar:.</td>
  
Line 375: Line 423:
 
   <td>PATH<font color="red">&#8224;</font></td>
 
   <td>PATH<font color="red">&#8224;</font></td>
  
   <td>/opt/msp430/bin:$PATH</td>
+
   <td>/opt/msp430/bin:/opt/jflashmm:$PATH</td>
 
   <td>same as in Cygwin</td>
 
   <td>same as in Cygwin</td>
 
<td>
 
<td>
  
</td></tr></tbody></table>
+
</td></tr></table>
  
<i><font color="red">&#8224;</font>Only necessary if you're using the MSP430 platform/tools.</i>
+
<i><font color="red">&#8224;</font>Only necessary if you're using MSP430 or iMote2 platform/tools.</i>
  
 
<p>
 
<p>
Line 415: Line 463:
  
 
<p>If you do not do this, then timers will not work correctly.</p>
 
<p>If you do not do this, then timers will not work correctly.</p>
 +
 +
<p>&nbsp;</p>
 +
 +
<p>COMMENT: Install TinyOS-2.x from CVS in order to have a complete source tree.
 +
<ul> Start cygwin </ul>
 +
      cd /
 +
      mkdir opt #(if opt is not an existing folder)
 +
      export CVSROOT=/opt
 +
      cd opt&&cvs init
 +
      touch /home/$USER/.cvspass
 +
      cvs -d:pserver:anonymous@tinyos.cvs.sourceforge.net:/cvsroot/tinyos login
 +
      cvs -z3 -d:pserver:anonymous@tinyos.cvs.sourceforge.net:/cvsroot/tinyos co -P tinyos-2.x
 +
 +
This will take some time to download everything.
 +
Complete HOWTO can be find [http://www.mobnets.rwth-aachen.de/fileadmin/download/HOWTO_install_TinyOS2_on_Windows.pdf here]</p>
  
 
</li></ul>
 
</li></ul>

Latest revision as of 19:25, 6 May 2011

If you already have a 1.x tree or an existing 2.x tree, you can use the upgrade instructions at [1], with the added note that Cygwin should be upgraded to the latest version. In cygwin run "cygcheck -c" and check the cygwin entry is 1.5.25-11 or later. As of Apr08, Cygwin is not supported on Windows Vista.

There are two ways to do a clean install of TinyOS. The first way is to install a live CD that gives you a virtualized Linux with a complete TinyOS install. Note that since this is on a CD, you can't modify anything; you can, however, make a LiveUSB device to use as your TinyOS install. The second way is to install TinyOS on your host operating system. When installing on a host operating system, you can either use a debian package repository or manually instally with RPMs.

One-step Install with a Live CD

Download a Linux live CD that has a TinyOS installation on it. All you need to do is download the CD image, burn it onto a CD, and install from there. This saves you all of the complexities of installation, and it's the recommended way to install TinyOS. The link above has complete instructions. The live CD is provided by the Toilers group at the Colorado School of Mines.

Two-step install on your host OS with Debian packages

If you are running a version of Linux that supports Debian packages, then you may want to use the TinyOS package repository.

1) Remove any old tinyos repository from /etc/apt/sources.list and add the following:
Supported distributions are (hardy, intrepid, jaunty, karmic)

 deb http://hinrg.cs.jhu.edu/tinyos <distribution> main

2) Update your repository cache:

 sudo apt-get update

3) Run the following to install the latest release of tinyos and all its supported tools:

 sudo apt-get install tinyos

4) Add the following line to your ~/.bashrc or ~/.profile file in your home directory to set up the environment for TinyOS development at login

 #Sourcing the tinyos environment variable setup script
 source /opt/tinyos-2.0.2/tinyos.sh

If you typically run tinyos from CVS and only require the toolchain installation, you can install the tinyos-required package instead of the tinyos one to just pull these in.

Keep in mind had inconsistent success with running apt-get upgrade tinyos, so for now it's best to play it safe and remove any old tinyos packages before installing the new ones.

Also you have used the TinyOS debian repository in the past, keep in mind that all of the tools have been updated for the upcoming TinyOS-2.1 release, but still work with all older versions of TinyOS as well. If you try updating in this way, and you see conflicts with some deprecated packages, send me an email (cire831@gmail.com), and I'll add them to the conflicts list so that they get removed when the updated tools are installed. These conflicts should be OK so long as you remove any old packages; they are due to a change in the names of the updated packages installing into the same locations as the outdated ones.

Manual installation on your host OS with RPMs

Currently, the TinyOS Core Working Group supports TinyOS on two platforms: Cygwin (Windows) and Linux. There have been some successful efforts to getting TinyOS environments working on Mac OSX, but OSX is not supported by the Core WG.

Installing a TinyOS enviromnent has five basic steps; Windows requires an extra step, installing Cygwin, which is a UNIX-like environment. The steps are:

  1. Installing a Java 1.5 (Java 5) JDK. Java is the most common way of interacting with mote base stations or gateways that are plugged into a PC or laptop.
  2. Windows only. Install Cygwin. This gives you a shell and many UNIX tools which the TinyOS environment uses, such as perl and shell scripts.
  3. Installing native compilers. As you're compiling code for low-power microcontrollers, you need compilers that can generate the proper assembly code. If you using mica-family motes, you need the AVR toolchain; if you're using telos-family motes, you need the MSP430 toolchain.
  4. Installing the nesC compiler. TinyOS is written in nesC, a dialect of C with support for the TinyOS concurrency model and component-based programming. The nesC compiler is platform-independent: it passes its output to the native compilers, so that it can take advantage of all of the effort put into their optimizations.
  5. Installing the TinyOS source tree. If you want to compile and install TinyOS programs, you need the code.
  6. Installing the Graphviz visualization tool. The TinyOS environment includes nesdoc, a tool that automatically generates HTML documentation from source code. Part of this process involves drawing diagrams that show the relationships between different TinyOS components. Graphviz is an open source tool that nesdoc uses to draw the diagrams.

Step 1: Install Java 1.5 JDK

Windows Download and install Sun's 1.5 JDK from http://java.sun.com.

Linux Download and install IBM's 1.5 JDK from http://www-128.ibm.com/developerworks/java/jdk/.

Step 2: Install Cygwin

This step is required for Windows installations only. If you are installing on Linux, skip to step 3.

We have put online the cygwin packages that we've confirmed to be compatible with TinyOS. The instructions below use those packages. You can also upgrade your cygwin environment according to the instructions at www.cygwin.com and your environment will most likely work. A large number of TinyOS users, upgrade their cygwin packages at least monthly from cygnus. However, since we can't test what packages are compatible as they become available daily, we can't confirm that today's set will work.

    1. Download cygwin-files.zip and unzip it under some local folder say c:/cygwin-files
    2. Go to c:/cygwin-files and start the setup. Use following instructions.
    1. When it ask for "Choose A download source", then use "Install from Local Directory" option
    2. When it ask for "Select Root Install Director" then use following options.
      Root Directory: c:\cygwin (or some other directory without spaces in its name)
      Install for: All Users
      Default Text file type: Unix/Binary
    3. When it ask for "Select local Package directory" then select "c:/cygwin-files" (Note: this location depends on where you have unzip cygwin-files.zip, in step-1 above we have used c:/cygwin-files)
    4. Complete the rest of installation process

Some notes:

  • You might see a message explaining that you need to reboot because some files are in use. This most likely means that your cygwin DLL is loaded and in-use and, therefore, cannot be replaced. When you reboot, the new DLL will be loaded.

  • Related to the above warnings, if you see warnings about the cygwin1.dll not being found, don't worry. All will be well once you reboot and the right DLL is loaded.

Step 3: Install native compilers

Install the appropriate version of the following (Windows or Linux, avr or msp430 or both) with the rpm command 'rpm -ivh rpm>'. On windows, if you get an error claiming that the rpm was build for an NT computer and you're on a windows NT computer, bypass the erroneous error by using 'rpm -ivh --ignoreos rpmname'.

Atmel AVR Tools

Tool Windows/Cygwin Linux
avr-binutils avr-binutils-2.15tinyos-3.cygwin.i386.rpm avr-binutils-2.15tinyos-3.i386.rpm
avr-gcc avr-gcc-3.4.3-1.cygwin.i386.rpm avr-gcc-3.4.3-1.i386.rpm
avr-libc avr-libc-1.2.3-1.cygwin.i386.rpm avr-libc-1.2.3-1.i386.rpm
avarice avarice-2.4-1.cygwin.i386.rpm avarice-2.4-1.i386.rpm
insight (avr-gdb) avr-insight-6.3-1.cygwin.i386.rpm avr-insight-6.3-1.i386.rpm

If you receive an rpm error that indicates that you have a newer version already installed, try rpm -Uvh --force


PXA27x Tools (iMote2)

Tool Windows/Cygwin Linux
xscale-elf-binutils xscale-elf-binutils-2.15tinyos-1.cygwin.i386.rpm xscale-elf-binutils-2.15-2.i386.deb
xscale-elf-gcc xscale-elf-gcc-3.4.3-1.cygwin.i386.rpm xscale-elf-gcc-3.4.3-2.i386.deb
xscale-elf-newlibc xscale-elf-newlib-1.11.0tinyos-1.cygwin.i386.rpm xscale-elf-newlib-1.13.0-1.i386.deb
jtag jflashmm.tgz OpenOCD toolchain

Copy jflashmm.tgz to /opt directory, untar it (tar xzf jflashmm.tgz), and make sure it's on your path (see Step 5).


TI MSP430 Tools

Tool Windows/Cygwin Linux
base msp430tools-base-0.1-20050607.cygwin.i386.rpm msp430tools-base-0.1-20050607.i386.rpm
python tools msp430tools-python-tools-1.0-1.cygwin.noarch.rpm msp430tools-python-tools-1.0-1.noarch.rpm
binutils msp430tools-binutils-2.16-20050607.cygwin.i386.rpm msp430tools-binutils-2.16-20050607.i386.rpm
gcc msp430tools-gcc-3.2.3-20050607.cygwin.i386.rpm msp430tools-gcc-3.2.3-20050607.i386.rpm
libc msp430tools-libc-20050308cvs-20050608.cygwin.i386.rpm msp430tools-libc-20050308cvs-20050608.i386.rpm
jtag [2]Not yet available msp430tools-jtag-lib-20031101cvs-20050610.i386.rpm
gdb [3]Not yet available msp430tools-gdb-6.0-20050609.i386.rpm

Step 4: Install TinyOS toolchain

The TinyOS-specific tools are the NesC compiler and a set of tools developed in the tinyos-2.x/tools source code repository. They are also installed using rpms. If you using the Cygwin version recommended in these install instructions, you should install the "Recommended" Windows/Cygwin nesC RPM. If you get strange errors when you try to compile TinyOS programs, such as the error message "the procedure entry point basename could not be located in the dynamic link library cygwin1.dll", this is likely due to a Cygwin version incompatibility: try the "Other" Windows/Cygwin RPM (1.2.7a). If you are using Cygwin and installing the nesC RPM causes an error that the RPM was built for Cygwin, add the --ignoreos option.

Finally, there are two Linux versions of tinyos-tools, depending on whether you have a 32-bit or 64-bit machine. The first is the i386 RPM and the second is the i686 RPM. If you have a 64-bit Java VM, it is important that you install the i686 RPM or otherwise the Java support may not work properly.

TinyOS-specific Tools

Tool Recommended Windows/Cygwin Other Windows/Cygwin Linux Command
NesC nesc-1.2.8a-1.cygwin.i386.rpm nesc-1.2.8b-1.cygwin.i386.rpm> nesc-1.2.8a-1.i386.rpm rpm -Uvh
rpm -Uvh --ignoreos (if Cygwin complains)
Tool Windows/Cygwin 32-bit Linux 64-bit Linux Command
tinyos-tools tinyos-tools-1.2.4-2.cygwin.i386.rpm tinyos-tools-1.2.4-3.i386.rpm tinyos-tools-1.2.4-3.i686.rpm rpm -ivh --force (1.x tree)
rpm -Uvh (no 1.x tree)

Step 5: Install the TinyOS 2.x source tree

Now that the tools are installed, you need only install the tinyos 2.x source tree and then set your environment variables. Install the appropriate version of the following (Window or Linux) with the rpm command 'rpm -ivh rpm'. (Please read the COMMENT below) As with the previous rpms, if you get an error claiming that the rpm was build for an NT computer and you're on a windows NT computer, bypass the erroneous error by using 'rpm -ivh --ignoreos rpmname'.

  • Install tinyos-2.x

    TinyOS 2.x

    Windows/Cygwin Linux
    TinyOS tinyos-2.0.2-2.cygwin.noarch.rpm tinyos-2.0.2-2.noarch.rpm
  • Configure your environment

    Ideally, you'll put these environment variables in a shell script that will run when your shell starts, but you needn't put such a script under /etc/profile.d.

    The example settings below assume that the tinyos-2.x installation is in /opt/tinyos-2.x. Change the settings to be correct for where you've put your tinyos-2.x tree. Note that the windows CLASSPATH must be a windows-style path, not a cygwin path. You can generate a windows style path from a cygwin-style path using 'cygpath -w'. For example:

    export CLASSPATH=`cygpath -w $TOSROOT/support/sdk/java/tinyos.jar`
    export CLASSPATH="$CLASSPATH;."
    

    TinyOS 2.x

    Environment Variable Windows Linux
    TOSROOT /opt/tinyos-2.x same as in Cygwin
    TOSDIR $TOSROOT/tos same as in Cygwin
    CLASSPATH C:\cygwin\opt\tinyos-2.x\support\sdk\java\tinyos.jar;. $TOSROOT/support/sdk/java/tinyos.jar:.
    MAKERULES $TOSROOT/support/make/Makerules same as in Cygwin
    PATH /opt/msp430/bin:/opt/jflashmm:$PATH same as in Cygwin

    Only necessary if you're using MSP430 or iMote2 platform/tools.

    In addition to the above environment variables, do the following on Linux machines:

    1. Change the ownership on your /opt/tinyos-2.x files: chown -R <your uid> /opt/tinyos-2.x
    2. Change the permissions on any serial (/dev/ttyS<N>), usb (/dev/tts/usb<N>, /dev/ttyUSB<N>), or parallel (/dev/parport) devices you are going to use: chmod 666 /dev/<devicename>

  • Finally, if you have installed TinyOS 2.0.1, there is a bug in TOSSIM (which will be fixed in 2.0.2). The bug is in file tos/chips/atm128/sim/atm128_sim.h. Change these lines 22 and 23 from:

    #define _SFR_IO8(io_addr) _MMIO_BYTE((io_addr) + 0x20)
    #define _SFR_IO16(io_addr) _MMIO_WORD((io_addr) + 0x20)
    

    to

    #define _SFR_IO8(io_addr) _MMIO_BYTE((io_addr))
    #define _SFR_IO16(io_addr) _MMIO_WORD((io_addr))
    

    If you do not do this, then timers will not work correctly.

     

    COMMENT: Install TinyOS-2.x from CVS in order to have a complete source tree.

      Start cygwin
         cd /
         mkdir opt #(if opt is not an existing folder)
         export CVSROOT=/opt
         cd opt&&cvs init
         touch /home/$USER/.cvspass
         cvs -d:pserver:anonymous@tinyos.cvs.sourceforge.net:/cvsroot/tinyos login
         cvs -z3 -d:pserver:anonymous@tinyos.cvs.sourceforge.net:/cvsroot/tinyos co -P tinyos-2.x
    

    This will take some time to download everything.

    Complete HOWTO can be find here

Step 6: Installing Graphviz

Go to download page of the Graphviz project and download the appropriate RPM. You only need the basic graphviz RPM (graphviz-); you don't need all of the add-ons, such as -devel, -doc, -perl, etc. If you're not sure what version of Linux you're running,

uname -a

might give you some useful information. Install the rpm with rpm -i rpm-name. In the case of Windows, there is a simple install program, so you don't need to deal with RPMs.

you may need to download graphviz 1.1.0 here