[Tinyos-2-commits] CVS: tinyos-2.x/doc/html install-tinyos.html,
1.1.2.8, 1.1.2.9 overview.html, 1.1.2.12, 1.1.2.13 tep113.html,
1.1.2.9, 1.1.2.10 upgrade-tinyos.html, 1.1.2.8, 1.1.2.9
Phil Levis
scipio at users.sourceforge.net
Mon Nov 6 00:18:52 PST 2006
Update of /cvsroot/tinyos/tinyos-2.x/doc/html
In directory sc8-pr-cvs10.sourceforge.net:/tmp/cvs-serv3484/html
Modified Files:
Tag: tinyos-2_0_devel-BRANCH
install-tinyos.html overview.html tep113.html
upgrade-tinyos.html
Log Message:
Updates.
Index: install-tinyos.html
===================================================================
RCS file: /cvsroot/tinyos/tinyos-2.x/doc/html/install-tinyos.html,v
retrieving revision 1.1.2.8
retrieving revision 1.1.2.9
diff -C2 -d -r1.1.2.8 -r1.1.2.9
*** install-tinyos.html 12 Sep 2006 23:07:53 -0000 1.1.2.8
--- install-tinyos.html 6 Nov 2006 08:18:50 -0000 1.1.2.9
***************
*** 1,381 ****
!
! <!DOCTYPE doctype PUBLIC "-//w3c//dtd html 4.0 transitional//en">
! <html>
! <head>
! <title>Installing TinyOS 2.0</title>
! <link href="../stylesheets/tutorial.css" rel="stylesheet" type="text/css">
! </head>
! <body>
!
! <div class="title">Installing TinyOS 2.0</div>
! <div class="subtitle">Last updated 12 June 2006</div>
!
! <p>If you already have a 1.x tree, you are better off following the <i>upgrade</i>
! instructions at <a href="upgrade-tinyos.html">upgrade-tinyos.html</a>.
!
! <p>Currently, the TinyOS Core Working Group supports TinyOS on two platforms: Cygwin (Windows)
! and Linux. There have been some <A HREF="">successful efforts</A> to getting TinyOS environments working
! on Mac OSX, but OSX is not supported by the Core WG.</p>
!
! <p>Installing a TinyOS enviromnent has four basic steps; Windows requires an extra step,
! installing Cygwin, which is a UNIX-like environment. The steps are:</p>
!
! <ol>
! <li><b>Installing a Java 1.5 (Java 5) JDK.</b> Java is the most common way of interacting
! with mote base stations or gateways that are plugged into a PC or laptop.</li>
! <li><b><font color=red>Windows only.</font> Install Cygwin.</b> This gives you a shell
! and many UNIX tools which the TinyOS environment uses, such as perl and shell
! scripts.</li>
! <li><b>Installing native compilers.</b> 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.</li>
! <li><b>Installing the nesC compiler.</b> 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.</li>
! <li><b>Installing the TinyOS source tree.</b> If you want to compile and
! install TinyOS programs, you need the code.</li>
! <li><b>Installing the Graphviz visualization tool.</b> The TinyOS
! environment includes <tt>nesdoc</tt>, 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. <A HREF="http://www.graphviz.org">Graphviz</A>
! is an open source tool
! that nesdoc uses to draw the diagrams.</li>
! </ol>
!
! <h1>Step 1: Install Java 1.5 JDK</h1>
!
! <b>Windows</b><br>
! Download and install Sun's 1.5 JDK from <a href="http://java.sun.com">http://java.sun.com</a>.
!
! <p>
! <b>Linux</b><br>
! Download and install IBM's 1.5 JDK from <a href="http://www-128.ibm.com/developerworks/java/jdk/">http://www-128.ibm.com/developerworks/java/jdk/</a>.
!
! <h1>Step 2: Install Cygwin</h1>
!
! <font color=red> This step is required for Windows installations only. If you are installing
! on Linux, skip to step 3.</font>
!
! <p>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.
!
! <p>
! <ol>
! <li> Download the confirmed-compatible cygwin packages from the tinyos web site <a href="http://www.tinyos.net/dist-1.2.0/tools/windows/cygwin-1.2a.tgz">here</a>.
! <p>
! <li> In a cygwin shell, unzip the above package into some directory. In these instructions the directory is /cygdrive/c/newcygpkgs.
! <pre>
! $ cd /cygdrive/c/newcygpkgs
! $ tar zxvf cygwin-1.2a.tgz
! </pre>
! This unzips the packages.
! <p>
! <li> In Windows Explorer, navigate to /cygdrive/c/newcygpkgs and click on the file setup.exe. Setup.exe is the setup program distributed by Cygnus Solutions.
! <p>
! <li> Follow these steps when the Cygwin Setup windows appears:
! <ol>
! </ol>
! <li> Opt to disable the virus scanner (it will be enabled when you're finished).
! <p>
! <li> Opt to Install from Local Directory.
! <p>
! <li> Specify the Root directory to be where your <i>current</i> cygwin installation is. This would be the directory that directories like 'opt' and 'usr' are in. For example, mine is rooted at c:\tinyos\cygwin, so I enter that.
! <p>
! <li> Select to Install for All Users
! <p>
! <li> Select the Unix file type (very important!)
! <p>
! <li> For the Local Packages Directory, specify where you unzipped the cygwin packages tarfile. For example, I would specify c:\newcygpkgs. (The setup.exe program will probably select the right default directory.)
! <p>
! <li> The next window will allow you to select packages to install. You should see that most of the packages have an X-ed box next to them; these are the packages that are to be installed.
! <p>
! <li> Click install. Some notes:
! <ul>
! <li> 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.
! <li> 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.
! </ul>
! </ol>
! </ol>
!
! <h1>Step 3: Install native compilers </h1>
!
! 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 <i>rpmname</i>'.
! (We have xscale
! compiler tools online at
! <a href="http://www.tinyos.net/dist-1.2.0/tools/">http://www.tinyos.net/dist-1.2.0/tools/</a>
! but they have not yet been extensively tested by a large community.)
!
! <!----- AVR external tools -------->
! </p><p><b><em>Atmel AVR Tools</em></b>
! <table border="0">
! <tbody><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>avr-binutils<font color="red">†</font></td>
! <td><a href="http://www.tinyos.net/dist-2.0.0/tools/windows/avr-binutils-2.15tinyos-3.cygwin.i386.rpm">avr-binutils-2.15tinyos-3.cygwin.i386.rpm</a></td>
! <td><a href="http://www.tinyos.net/dist-2.0.0/tools/linux/avr-binutils-2.15tinyos-3.i386.rpm">avr-binutils-2.15tinyos-3.i386.rpm</a></td>
! </tr>
!
! <tr>
! <td bgcolor="#dddddd">avr-gcc</td>
! <td bgcolor="#dddddd"><a href="http://www.tinyos.net/dist-2.0.0/tools/windows/avr-gcc-3.4.3-1.cygwin.i386.rpm">avr-gcc-3.4.3-1.cygwin.i386.rpm </a></td>
! <td bgcolor="#dddddd"><a href="http://www.tinyos.net/dist-2.0.0/tools/linux/avr-gcc-3.4.3-1.i386.rpm">avr-gcc-3.4.3-1.i386.rpm</a></td>
! </tr>
!
! <tr>
! <td>avr-libc</td>
! <td><a href="http://www.tinyos.net/dist-2.0.0/tools/windows/avr-libc-1.2.3-1.cygwin.i386.rpm">avr-libc-1.2.3-1.cygwin.i386.rpm</a></td>
! <td><a href="http://www.tinyos.net/dist-2.0.0/tools/linux/avr-libc-1.2.3-1.i386.rpm">avr-libc-1.2.3-1.i386.rpm</a></td>
! </tr>
!
! <tr>
! <td bgcolor="#dddddd">avarice</td>
! <td bgcolor="#dddddd"><a href="http://www.tinyos.net/dist-2.0.0/tools/windows/avarice-2.4-1.cygwin.i386.rpm">avarice-2.4-1.cygwin.i386.rpm</a></td>
! <td bgcolor="#dddddd"><a href="http://www.tinyos.net/dist-2.0.0/tools/linux/avarice-2.4-1.i386.rpm">avarice-2.4-1.i386.rpm</a></td>
! </tr>
!
! <tr>
! <td>insight (avr-gdb)</td>
! <td><a href="http://www.tinyos.net/dist-1.2.0/tools/windows/avr-insight-6.3-1.cygwin.i386.rpm">avr-insight-6.3-1.cygwin.i386.rpm</a></td>
! <td><a href="http://www.tinyos.net/dist-2.0.0/tools/linux/avr-insight-6.3-1.i386.rpm">avr-insight-6.3-1.i386.rpm</a></td>
! </tr>
!
! </tbody></table>
! <i><font color="red">†</font>If you receive an rpm error that indicates that you have a newer version already installed, try <code>rpm -Uvh --force</code></i>
!
! <!----- MSP external tools -------->
! </p><p><b><em>TI MSP430 Tools</em></b>
! <table border="0">
! <tbody><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>base</td>
! <td><a href="http://www.tinyos.net/dist-2.0.0/tools/windows/msp430tools-base-0.1-20050607.cygwin.i386.rpm">msp430tools-base-0.1-20050607.cygwin.i386.rpm</a></td>
! <td><a href="http://www.tinyos.net/dist-2.0.0/tools/linux/msp430tools-base-0.1-20050607.i386.rpm">msp430tools-base-0.1-20050607.i386.rpm</a></td>
! </tr>
!
! <tr>
! <td bgcolor="#dddddd">python tools</td>
! <td bgcolor="#dddddd"><a href="http://www.tinyos.net/dist-2.0.0/tools/windows/msp430tools-python-tools-1.0-1.cygwin.noarch.rpm">msp430tools-python-tools-1.0-1.cygwin.noarch.rpm</a></td>
! <td bgcolor="#dddddd"><a href="http://www.tinyos.net/dist-2.0.0/tools/linux/msp430tools-python-tools-1.0-1.noarch.rpm">msp430tools-python-tools-1.0-1.noarch.rpm</a></td>
! </tr>
!
!
! <tr>
! <td>binutils</td>
! <td><a href="http://www.tinyos.net/dist-2.0.0/tools/windows/msp430tools-binutils-2.16-20050607.cygwin.i386.rpm"> msp430tools-binutils-2.16-20050607.cygwin.i386.rpm</a></td>
! <td><a href="http://www.tinyos.net/dist-2.0.0/tools/linux/msp430tools-binutils-2.16-20050607.i386.rpm">msp430tools-binutils-2.16-20050607.i386.rpm</a></td>
! </tr>
!
! <tr>
! <td bgcolor="#dddddd">gcc</td>
! <td bgcolor="#dddddd"><a href="http://www.tinyos.net/dist-2.0.0/tools/windows/msp430tools-gcc-3.2.3-20050607.cygwin.i386.rpm">msp430tools-gcc-3.2.3-20050607.cygwin.i386.rpm</a></td>
! <td bgcolor="#dddddd"><a href="http://www.tinyos.net/dist-2.0.0/tools/linux/msp430tools-gcc-3.2.3-20050607.i386.rpm">msp430tools-gcc-3.2.3-20050607.i386.rpm</a></td>
! </tr>
!
! <tr>
! <td>libc</td>
! <td><a href="http://www.tinyos.net/dist-2.0.0/tools/windows/msp430tools-libc-20050308cvs-20050608.cygwin.i386.rpm">msp430tools-libc-20050308cvs-20050608.cygwin.i386.rpm</a></td>
! <td><a href="http://www.tinyos.net/dist-2.0.0/tools/linux/msp430tools-libc-20050308cvs-20050608.i386.rpm">msp430tools-libc-20050308cvs-20050608.i386.rpm</a></td>
! </tr>
!
! <tr>
! <td bgcolor="#dddddd">jtag</td>
! <td bgcolor="#dddddd"><a href="http://www.tinyos.net/dist-2.0.0/tools/windows/"></a>Not yet available</td>
! <td bgcolor="#dddddd"><a href="http://www.tinyos.net/dist-2.0.0/tools/linux/msp430tools-jtag-lib-20031101cvs-20050610.i386.rpm">msp430tools-jtag-lib-20031101cvs-20050610.i386.rpm</a></td>
! </tr>
!
! <tr>
! <td>gdb</td>
! <!-- <td><a href="http://www.tinyos.net/dist-2.0.0/tools/windows/msp430tools-gdb-6.0-20050609.cygwin.i386.rpm">msp430tools-gdb-6.0-20050609.cygwin.i386.rpm</a></td> -->
! <td><a href="http://www.tinyos.net/dist-2.0.0/tools/windows/"></a>Not yet available</td>
! <td><a href="http://www.tinyos.net/dist-2.0.0/tools/linux/msp430tools-gdb-6.0-20050609.i386.rpm">msp430tools-gdb-6.0-20050609.i386.rpm</a></td>
! </tr>
!
! </tbody></table>
!
! <h1>Step 4: Install TinyOS toolchain</h1>
!
! 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.
! Try installing it and if it does not work (e.g., you
! get strange errors when you try to execute it), this may be 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 <code>--ignoreos</code> option.
!
! <!----- tinyos-2.x/tinyos rpms -------->
! </p><p><b><em>TinyOS-specific Tools</em></b>
! <table border="0">
! <tbody><tr>
! <td bgcolor="#dddddd"><b>Tool</b></td>
! <td bgcolor="#dddddd"><b>Recommended Windows/Cygwin</b></td>
! <td bgcolor="#dddddd"><b>Other Windows/Cygwin</b></td>
! <td bgcolor="#dddddd"><b>Linux</b></td>
! <td bgcolor="#dddddd"><b>Command</b></td>
! </tr>
!
! <tr>
! <td>NesC</td>
! <td><a href="http://csl.stanford.edu/~pal/tinyos/nesc-1.2.7b-1.cygwin.i386.rpm">nesc-1.2.7b-1.cygwin.i386.rpm</a></td>
! <td><a href="http://www.tinyos.net/dist-1.2.0/tinyos/windows/nesc-1.2.7a-1.cygwin.i386.rpm">nesc-1.2.7a-1.cygwin.i386.rpm</a></td>
! <td><a href="http://www.tinyos.net/dist-1.2.0/tinyos/linux/nesc-1.2.7a-1.i386.rpm">nesc-1.2.7a-1.i386.rpm </a></td>
! <td><a href=""></a><code>rpm -Uvh</code><br>
! <code>rpm -Uvh --ignoreos</code> (if Cygwin complains)</td>
! </tr>
!
! <tr>
! <td bgcolor="#dddddd">tinyos-tools</td>
! <td bgcolor="#dddddd"><a href="http://www.tinyos.net/dist-2.0.0/tinyos/windows/tinyos-tools-1.2.2-1.cygwin.i386.rpm">tinyos-tools-1.2.2-1.cygwin.i386.rpm</a></td>
! <td bgcolor="#dddddd"><a href="http://www.tinyos.net/dist-2.0.0/tinyos/windows/tinyos-tools-1.2.2-1.cygwin.i386.rpm">tinyos-tools-1.2.2-1.cygwin.i386.rpm</a></td>
! <td bgcolor="#dddddd"><a href="http://www.tinyos.net/dist-2.0.0/tinyos/linux/tinyos-tools-1.2.2-1.i386.rpm">tinyos-tools-1.2.2-1.i386.rpm</a></td>
! <td bgcolor="#dddddd"><a href=""></a><code>rpm -ivh --force</code> (1.x tree)<br><code>rpm -Uvh</code> (no 1.x tree)<br></td>
! </tr>
!
! </tbody></table>
!
! <h1>Step 5: Install the TinyOS 2.x source tree </h1>
!
! 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>'.
! 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
! <i>rpmname</i>'.
!
! <ul>
! <li> Install tinyos-2.x
! <p>
! <!----- TinyOS -------->
!
!
! </p><p><b><em>TinyOS 2.x</em></b>
! <table border="0">
! <tbody><tr>
! <td bgcolor="#dddddd"><b></b></td>
! <td bgcolor="#dddddd"><b>Windows/Cygwin</b></td>
! <td bgcolor="#dddddd"><b>Linux</b></td>
! </tr>
!
! <tr>
! <td>TinyOS</td>
! <td><a href="http://www.tinyos.net/dist-2.0.0/tinyos/windows/tinyos-2.0.0beta2-3.cygwin.noarch.rpm">tinyos-2.0.0beta2-3.cygwin.noarch.rpm</a></td>
! <td><a href="http://www.tinyos.net/dist-2.0.0/tinyos/linux/tinyos-2.0.0beta2-3.noarch.rpm">tinyos-2.0.0beta2-3.noarch.rpm</a></td>
! </tr>
!
! </tbody></table>
! </p></li><li> Configure your environment
! <p>
! 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.
! </p><p>
! 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:
! </p><pre>export CLASSPATH=`cygpath -w $TOSROOT/support/sdk/java/tinyos.jar`
! export CLASSPATH="$CLASSPATH;."
! </pre>
!
! <p><b><em>TinyOS 2.x</em></b>
! <table border="0">
! <tbody><tr>
! <td bgcolor="#dddddd"><b>Environment Variable</b></td>
! <td bgcolor="#dddddd"><b>Windows</b></td>
! <td bgcolor="#dddddd"><b>Linux</b></td>
! </tr>
!
! <tr>
! <td>TOSROOT</td>
! <td>/opt/tinyos-2.x</td>
! <td>same as in Cygwin</td>
! <td>
!
! </td></tr><tr>
! <td bgcolor="#dddddd">TOSDIR</td>
! <td bgcolor="#dddddd">$TOSROOT/tos</td>
! <td bgcolor="#dddddd">same as in Cygwin</td>
! <td>
!
! </td></tr><tr>
! <td>CLASSPATH</td>
! <td>C:\tinyos\cygwin\opt\tinyos-2.x\support\sdk\java\tinyos.jar;.</td>
! <td>$TOSROOT/support/sdk/java/tinyos.jar:.</td>
! <td>
!
! </td></tr><tr>
! <td bgcolor="#dddddd">MAKERULES</td>
! <td bgcolor="#dddddd">$TOSROOT/support/make/Makerules</td>
! <td bgcolor="#dddddd">same as in Cygwin</td>
! <td>
!
! </td></tr><tr>
! <td>PATH<font color="red">†</font></td>
! <td>/opt/msp430/bin:$PATH</td>
! <td>same as in Cygwin</td>
! <td>
!
! </td></tr></tbody></table>
!
! <i><font color="red">†</font>Only necessary if you're using the MSP430 platform/tools.</i>
!
! </p><p>
! In addition to the above environment variables, do the following on Linux machines:
! </p><ol>
! <li> Change the ownership on your /opt/tinyos-2.x files: <code>chown -R <your uid> /opt/tinyos-2.x
! </code></li><li> 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: <code>chmod 666 /dev/<devicename><code>
! <!--
! <li> Add any users who will be using TinyOS to the uucp, lp, and lock
! groups: </li>
! -->
! </code></code></li></ol>
!
! </li></ul>
!
! <h1>Step 6: Installing Graphviz</h1>
!
! <p>Go to <A HREF="http://www.graphviz.org/Download..php">download page</A> of the Graphviz project
! and download the appropriate RPM. You only need the basic graphviz RPM (<tt>graphviz-</tt>);
! 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,</p>
!
! <pre>uname -a</pre>
!
! <p>might give you some useful information. Install the rpm with <tt>rpm -i </tt> <i>rpm-name</i>.
! In the case of Windows, there is a simple install program, so you don't need to deal with RPMs.</p>
!
! </body>
! </html>
--- 1,382 ----
!
! <!DOCTYPE doctype PUBLIC "-//w3c//dtd html 4.0 transitional//en">
! <html>
! <head>
! <title>Installing TinyOS 2.0</title>
! <link href="../stylesheets/tutorial.css" rel="stylesheet" type="text/css">
! </head>
! <body>
!
! <div class="title">Installing TinyOS 2.0</div>
! <div class="subtitle">Last updated 5 November 2006</div>
!
! <p>If you already have a 1.x tree or an existing 2.x tree, you are better off
! following the <i>upgrade</i> instructions at
! <a href="upgrade-tinyos.html">upgrade-tinyos.html</a>.</p>
!
! <p>Currently, the TinyOS Core Working Group supports TinyOS on two platforms: Cygwin (Windows)
! and Linux. There have been some <A HREF="">successful efforts</A> to getting TinyOS environments working
! on Mac OSX, but OSX is not supported by the Core WG.</p>
!
! <p>Installing a TinyOS enviromnent has five basic steps; Windows requires an extra step,
! installing Cygwin, which is a UNIX-like environment. The steps are:</p>
!
! <ol>
! <li><b>Installing a Java 1.5 (Java 5) JDK.</b> Java is the most common way of interacting
! with mote base stations or gateways that are plugged into a PC or laptop.</li>
! <li><b><font color=red>Windows only.</font> Install Cygwin.</b> This gives you a shell
! and many UNIX tools which the TinyOS environment uses, such as perl and shell
! scripts.</li>
! <li><b>Installing native compilers.</b> 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.</li>
! <li><b>Installing the nesC compiler.</b> 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.</li>
! <li><b>Installing the TinyOS source tree.</b> If you want to compile and
! install TinyOS programs, you need the code.</li>
! <li><b>Installing the Graphviz visualization tool.</b> The TinyOS
! environment includes <tt>nesdoc</tt>, 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. <A HREF="http://www.graphviz.org">Graphviz</A>
! is an open source tool
! that nesdoc uses to draw the diagrams.</li>
! </ol>
!
! <h1>Step 1: Install Java 1.5 JDK</h1>
!
! <b>Windows</b><br>
! Download and install Sun's 1.5 JDK from <a href="http://java.sun.com">http://java.sun.com</a>.
!
! <p>
! <b>Linux</b><br>
! Download and install IBM's 1.5 JDK from <a href="http://www-128.ibm.com/developerworks/java/jdk/">http://www-128.ibm.com/developerworks/java/jdk/</a>.
!
! <h1>Step 2: Install Cygwin</h1>
!
! <font color=red> This step is required for Windows installations only. If you are installing
! on Linux, skip to step 3.</font>
!
! <p>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.
!
! <p>
! <ol>
! <li> Download the confirmed-compatible cygwin packages from the tinyos web site <a href="http://www.tinyos.net/dist-1.2.0/tools/windows/cygwin-1.2a.tgz">here</a>.
! <p>
! <li> In a cygwin shell, unzip the above package into some directory. In these instructions the directory is /cygdrive/c/newcygpkgs.
! <pre>
! $ cd /cygdrive/c/newcygpkgs
! $ tar zxvf cygwin-1.2a.tgz
! </pre>
! This unzips the packages.
! <p>
! <li> In Windows Explorer, navigate to /cygdrive/c/newcygpkgs and click on the file setup.exe. Setup.exe is the setup program distributed by Cygnus Solutions.
! <p>
! <li> Follow these steps when the Cygwin Setup windows appears:
! <ol>
! </ol>
! <li> Opt to disable the virus scanner (it will be enabled when you're finished).
! <p>
! <li> Opt to Install from Local Directory.
! <p>
! <li> Specify the Root directory to be where your <i>current</i> cygwin installation is. This would be the directory that directories like 'opt' and 'usr' are in. For example, mine is rooted at c:\tinyos\cygwin, so I enter that.
! <p>
! <li> Select to Install for All Users
! <p>
! <li> Select the Unix file type (very important!)
! <p>
! <li> For the Local Packages Directory, specify where you unzipped the cygwin packages tarfile. For example, I would specify c:\newcygpkgs. (The setup.exe program will probably select the right default directory.)
! <p>
! <li> The next window will allow you to select packages to install. You should see that most of the packages have an X-ed box next to them; these are the packages that are to be installed.
! <p>
! <li> Click install. Some notes:
! <ul>
! <li> 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.
! <li> 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.
! </ul>
! </ol>
! </ol>
!
! <h1>Step 3: Install native compilers </h1>
!
! 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 <i>rpmname</i>'.
! (We have xscale
! compiler tools online at
! <a href="http://www.tinyos.net/dist-1.2.0/tools/">http://www.tinyos.net/dist-1.2.0/tools/</a>
! but they have not yet been extensively tested by a large community.)
!
! <!----- AVR external tools -------->
! </p><p><b><em>Atmel AVR Tools</em></b>
! <table border="0">
! <tbody><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>avr-binutils<font color="red">†</font></td>
! <td><a href="http://www.tinyos.net/dist-2.0.0/tools/windows/avr-binutils-2.15tinyos-3.cygwin.i386.rpm">avr-binutils-2.15tinyos-3.cygwin.i386.rpm</a></td>
! <td><a href="http://www.tinyos.net/dist-2.0.0/tools/linux/avr-binutils-2.15tinyos-3.i386.rpm">avr-binutils-2.15tinyos-3.i386.rpm</a></td>
! </tr>
!
! <tr>
! <td bgcolor="#dddddd">avr-gcc</td>
! <td bgcolor="#dddddd"><a href="http://www.tinyos.net/dist-2.0.0/tools/windows/avr-gcc-3.4.3-1.cygwin.i386.rpm">avr-gcc-3.4.3-1.cygwin.i386.rpm </a></td>
! <td bgcolor="#dddddd"><a href="http://www.tinyos.net/dist-2.0.0/tools/linux/avr-gcc-3.4.3-1.i386.rpm">avr-gcc-3.4.3-1.i386.rpm</a></td>
! </tr>
!
! <tr>
! <td>avr-libc</td>
! <td><a href="http://www.tinyos.net/dist-2.0.0/tools/windows/avr-libc-1.2.3-1.cygwin.i386.rpm">avr-libc-1.2.3-1.cygwin.i386.rpm</a></td>
! <td><a href="http://www.tinyos.net/dist-2.0.0/tools/linux/avr-libc-1.2.3-1.i386.rpm">avr-libc-1.2.3-1.i386.rpm</a></td>
! </tr>
!
! <tr>
! <td bgcolor="#dddddd">avarice</td>
! <td bgcolor="#dddddd"><a href="http://www.tinyos.net/dist-2.0.0/tools/windows/avarice-2.4-1.cygwin.i386.rpm">avarice-2.4-1.cygwin.i386.rpm</a></td>
! <td bgcolor="#dddddd"><a href="http://www.tinyos.net/dist-2.0.0/tools/linux/avarice-2.4-1.i386.rpm">avarice-2.4-1.i386.rpm</a></td>
! </tr>
!
! <tr>
! <td>insight (avr-gdb)</td>
! <td><a href="http://www.tinyos.net/dist-1.2.0/tools/windows/avr-insight-6.3-1.cygwin.i386.rpm">avr-insight-6.3-1.cygwin.i386.rpm</a></td>
! <td><a href="http://www.tinyos.net/dist-2.0.0/tools/linux/avr-insight-6.3-1.i386.rpm">avr-insight-6.3-1.i386.rpm</a></td>
! </tr>
!
! </tbody></table>
! <i><font color="red">†</font>If you receive an rpm error that indicates that you have a newer version already installed, try <code>rpm -Uvh --force</code></i>
!
! <!----- MSP external tools -------->
! </p><p><b><em>TI MSP430 Tools</em></b>
! <table border="0">
! <tbody><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>base</td>
! <td><a href="http://www.tinyos.net/dist-2.0.0/tools/windows/msp430tools-base-0.1-20050607.cygwin.i386.rpm">msp430tools-base-0.1-20050607.cygwin.i386.rpm</a></td>
! <td><a href="http://www.tinyos.net/dist-2.0.0/tools/linux/msp430tools-base-0.1-20050607.i386.rpm">msp430tools-base-0.1-20050607.i386.rpm</a></td>
! </tr>
!
! <tr>
! <td bgcolor="#dddddd">python tools</td>
! <td bgcolor="#dddddd"><a href="http://www.tinyos.net/dist-2.0.0/tools/windows/msp430tools-python-tools-1.0-1.cygwin.noarch.rpm">msp430tools-python-tools-1.0-1.cygwin.noarch.rpm</a></td>
! <td bgcolor="#dddddd"><a href="http://www.tinyos.net/dist-2.0.0/tools/linux/msp430tools-python-tools-1.0-1.noarch.rpm">msp430tools-python-tools-1.0-1.noarch.rpm</a></td>
! </tr>
!
!
! <tr>
! <td>binutils</td>
! <td><a href="http://www.tinyos.net/dist-2.0.0/tools/windows/msp430tools-binutils-2.16-20050607.cygwin.i386.rpm"> msp430tools-binutils-2.16-20050607.cygwin.i386.rpm</a></td>
! <td><a href="http://www.tinyos.net/dist-2.0.0/tools/linux/msp430tools-binutils-2.16-20050607.i386.rpm">msp430tools-binutils-2.16-20050607.i386.rpm</a></td>
! </tr>
!
! <tr>
! <td bgcolor="#dddddd">gcc</td>
! <td bgcolor="#dddddd"><a href="http://www.tinyos.net/dist-2.0.0/tools/windows/msp430tools-gcc-3.2.3-20050607.cygwin.i386.rpm">msp430tools-gcc-3.2.3-20050607.cygwin.i386.rpm</a></td>
! <td bgcolor="#dddddd"><a href="http://www.tinyos.net/dist-2.0.0/tools/linux/msp430tools-gcc-3.2.3-20050607.i386.rpm">msp430tools-gcc-3.2.3-20050607.i386.rpm</a></td>
! </tr>
!
! <tr>
! <td>libc</td>
! <td><a href="http://www.tinyos.net/dist-2.0.0/tools/windows/msp430tools-libc-20050308cvs-20050608.cygwin.i386.rpm">msp430tools-libc-20050308cvs-20050608.cygwin.i386.rpm</a></td>
! <td><a href="http://www.tinyos.net/dist-2.0.0/tools/linux/msp430tools-libc-20050308cvs-20050608.i386.rpm">msp430tools-libc-20050308cvs-20050608.i386.rpm</a></td>
! </tr>
!
! <tr>
! <td bgcolor="#dddddd">jtag</td>
! <td bgcolor="#dddddd"><a href="http://www.tinyos.net/dist-2.0.0/tools/windows/"></a>Not yet available</td>
! <td bgcolor="#dddddd"><a href="http://www.tinyos.net/dist-2.0.0/tools/linux/msp430tools-jtag-lib-20031101cvs-20050610.i386.rpm">msp430tools-jtag-lib-20031101cvs-20050610.i386.rpm</a></td>
! </tr>
!
! <tr>
! <td>gdb</td>
! <!-- <td><a href="http://www.tinyos.net/dist-2.0.0/tools/windows/msp430tools-gdb-6.0-20050609.cygwin.i386.rpm">msp430tools-gdb-6.0-20050609.cygwin.i386.rpm</a></td> -->
! <td><a href="http://www.tinyos.net/dist-2.0.0/tools/windows/"></a>Not yet available</td>
! <td><a href="http://www.tinyos.net/dist-2.0.0/tools/linux/msp430tools-gdb-6.0-20050609.i386.rpm">msp430tools-gdb-6.0-20050609.i386.rpm</a></td>
! </tr>
!
! </tbody></table>
!
! <h1>Step 4: Install TinyOS toolchain</h1>
!
! 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.
! Try installing it and if it does not work (e.g., you
! get strange errors when you try to execute it), this may be 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 <code>--ignoreos</code> option.
!
! <!----- tinyos-2.x/tinyos rpms -------->
! </p><p><b><em>TinyOS-specific Tools</em></b>
! <table border="0">
! <tbody><tr>
! <td bgcolor="#dddddd"><b>Tool</b></td>
! <td bgcolor="#dddddd"><b>Recommended Windows/Cygwin</b></td>
! <td bgcolor="#dddddd"><b>Other Windows/Cygwin</b></td>
! <td bgcolor="#dddddd"><b>Linux</b></td>
! <td bgcolor="#dddddd"><b>Command</b></td>
! </tr>
!
! <tr>
! <td>NesC</td>
! <td><a href="http://csl.stanford.edu/~pal/tinyos/nesc-1.2.7b-1.cygwin.i386.rpm">nesc-1.2.7b-1.cygwin.i386.rpm</a></td>
! <td><a href="http://www.tinyos.net/dist-1.2.0/tinyos/windows/nesc-1.2.7a-1.cygwin.i386.rpm">nesc-1.2.7a-1.cygwin.i386.rpm</a></td>
! <td><a href="http://www.tinyos.net/dist-1.2.0/tinyos/linux/nesc-1.2.7a-1.i386.rpm">nesc-1.2.7a-1.i386.rpm </a></td>
! <td><a href=""></a><code>rpm -Uvh</code><br>
! <code>rpm -Uvh --ignoreos</code> (if Cygwin complains)</td>
! </tr>
!
! <tr>
! <td bgcolor="#dddddd">tinyos-tools</td>
! <td bgcolor="#dddddd"><a href="http://www.tinyos.net/dist-2.0.0/tinyos/windows/tinyos-tools-1.2.3-1.cygwin.i386.rpm">tinyos-tools-1.2.3-1.cygwin.i386.rpm</a></td>
! <td bgcolor="#dddddd"><a href="http://www.tinyos.net/dist-2.0.0/tinyos/windows/tinyos-tools-1.2.3-1.cygwin.i386.rpm">tinyos-tools-1.2.3-1.cygwin.i386.rpm</a></td>
! <td bgcolor="#dddddd"><a href="http://www.tinyos.net/dist-2.0.0/tinyos/linux/tinyos-tools-1.2.3-1.i386.rpm">tinyos-tools-1.2.3-1.i386.rpm</a></td>
! <td bgcolor="#dddddd"><a href=""></a><code>rpm -ivh --force</code> (1.x tree)<br><code>rpm -Uvh</code> (no 1.x tree)<br></td>
! </tr>
!
! </tbody></table>
!
! <h1>Step 5: Install the TinyOS 2.x source tree </h1>
!
! 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>'.
! 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
! <i>rpmname</i>'.
!
! <ul>
! <li> Install tinyos-2.x
! <p>
! <!----- TinyOS -------->
!
!
! </p><p><b><em>TinyOS 2.x</em></b>
! <table border="0">
! <tbody><tr>
! <td bgcolor="#dddddd"><b></b></td>
! <td bgcolor="#dddddd"><b>Windows/Cygwin</b></td>
! <td bgcolor="#dddddd"><b>Linux</b></td>
! </tr>
!
! <tr>
! <td>TinyOS</td>
! <td><a href="http://www.tinyos.net/dist-2.0.0/tinyos/windows/tinyos-2.0.0-1.cygwin.noarch.rpm">tinyos-2.0.0-1.cygwin.noarch.rpm</a></td>
! <td><a href="http://www.tinyos.net/dist-2.0.0/tinyos/linux/tinyos-2.0.0-1.noarch.rpm">tinyos-2.0.0-1.noarch.rpm</a></td>
! </tr>
!
! </tbody></table>
! </p></li><li> Configure your environment
! <p>
! 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.
! </p><p>
! 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:
! </p><pre>export CLASSPATH=`cygpath -w $TOSROOT/support/sdk/java/tinyos.jar`
! export CLASSPATH="$CLASSPATH;."
! </pre>
!
! <p><b><em>TinyOS 2.x</em></b>
! <table border="0">
! <tbody><tr>
! <td bgcolor="#dddddd"><b>Environment Variable</b></td>
! <td bgcolor="#dddddd"><b>Windows</b></td>
! <td bgcolor="#dddddd"><b>Linux</b></td>
! </tr>
!
! <tr>
! <td>TOSROOT</td>
! <td>/opt/tinyos-2.x</td>
! <td>same as in Cygwin</td>
! <td>
!
! </td></tr><tr>
! <td bgcolor="#dddddd">TOSDIR</td>
! <td bgcolor="#dddddd">$TOSROOT/tos</td>
! <td bgcolor="#dddddd">same as in Cygwin</td>
! <td>
!
! </td></tr><tr>
! <td>CLASSPATH</td>
! <td>C:\tinyos\cygwin\opt\tinyos-2.x\support\sdk\java\tinyos.jar;.</td>
! <td>$TOSROOT/support/sdk/java/tinyos.jar:.</td>
! <td>
!
! </td></tr><tr>
! <td bgcolor="#dddddd">MAKERULES</td>
! <td bgcolor="#dddddd">$TOSROOT/support/make/Makerules</td>
! <td bgcolor="#dddddd">same as in Cygwin</td>
! <td>
!
! </td></tr><tr>
! <td>PATH<font color="red">†</font></td>
! <td>/opt/msp430/bin:$PATH</td>
! <td>same as in Cygwin</td>
! <td>
!
! </td></tr></tbody></table>
!
! <i><font color="red">†</font>Only necessary if you're using the MSP430 platform/tools.</i>
!
! </p><p>
! In addition to the above environment variables, do the following on Linux machines:
! </p><ol>
! <li> Change the ownership on your /opt/tinyos-2.x files: <code>chown -R <your uid> /opt/tinyos-2.x
! </code></li><li> 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: <code>chmod 666 /dev/<devicename><code>
! <!--
! <li> Add any users who will be using TinyOS to the uucp, lp, and lock
! groups: </li>
! -->
! </code></code></li></ol>
!
! </li></ul>
!
! <h1>Step 6: Installing Graphviz</h1>
!
! <p>Go to <A HREF="http://www.graphviz.org/Download..php">download page</A> of the Graphviz project
! and download the appropriate RPM. You only need the basic graphviz RPM (<tt>graphviz-</tt>);
! 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,</p>
!
! <pre>uname -a</pre>
!
! <p>might give you some useful information. Install the rpm with <tt>rpm -i </tt> <i>rpm-name</i>.
! In the case of Windows, there is a simple install program, so you don't need to deal with RPMs.</p>
!
! </body>
! </html>
Index: overview.html
===================================================================
RCS file: /cvsroot/tinyos/tinyos-2.x/doc/html/overview.html,v
retrieving revision 1.1.2.12
retrieving revision 1.1.2.13
diff -C2 -d -r1.1.2.12 -r1.1.2.13
*** overview.html 5 Nov 2006 18:09:52 -0000 1.1.2.12
--- overview.html 6 Nov 2006 08:18:50 -0000 1.1.2.13
***************
*** 7,11 ****
<title>TinyOS 2.0 Overview</title>
<meta name="author" content="Philip Levis" />
! <meta name="date" content="Feb 8 2006" />
<style type="text/css">
--- 7,11 ----
<title>TinyOS 2.0 Overview</title>
<meta name="author" content="Philip Levis" />
! <meta name="date" content="Oct 30 2006" />
<style type="text/css">
***************
*** 293,297 ****
<td>Philip Levis</td></tr>
<tr><th class="docinfo-name">Date:</th>
! <td>Feb 8 2006</td></tr>
</tbody>
</table>
--- 293,297 ----
<td>Philip Levis</td></tr>
<tr><th class="docinfo-name">Date:</th>
! <td>Oct 30 2006</td></tr>
</tbody>
</table>
***************
*** 362,366 ****
a full active message communication layer.</p>
<p>The HAA is described in TEP 2: Hardware Abstraction Architecture[<a class="reference" href="#tep2">TEP2</a>].</p>
! <p>Currently (as of the 2.0 beta2 release in July 2006), TinyOS 2.0 supports
the following platforms:</p>
<blockquote>
--- 362,366 ----
a full active message communication layer.</p>
<p>The HAA is described in TEP 2: Hardware Abstraction Architecture[<a class="reference" href="#tep2">TEP2</a>].</p>
! <p>Currently (as of the 2.0 release in November 2006), TinyOS 2.0 supports
the following platforms:</p>
<blockquote>
***************
*** 376,380 ****
</ul>
</blockquote>
! <p>The btnode3 platform is not included in the beta2 RPM.</p>
</div>
<div class="section">
--- 376,380 ----
</ul>
</blockquote>
! <p>The btnode3 platform is not included in the RPM.</p>
</div>
<div class="section">
Index: tep113.html
===================================================================
RCS file: /cvsroot/tinyos/tinyos-2.x/doc/html/tep113.html,v
retrieving revision 1.1.2.9
retrieving revision 1.1.2.10
diff -C2 -d -r1.1.2.9 -r1.1.2.10
*** tep113.html 25 Oct 2006 00:47:56 -0000 1.1.2.9
--- tep113.html 6 Nov 2006 08:18:50 -0000 1.1.2.10
***************
*** 692,696 ****
<colgroup><col class="label" /><col /></colgroup>
<tbody valign="top">
! <tr><td class="label"><a name="tep2">[TEP2]</a></td><td>TEP 2: Hardware Abstraction Architecture. <a class="reference" href="http://cvs.sourceforge.net/viewcvs.py/tinyos/tinyos-1.x/beta/teps/txt/tep2.txt?view=markup">http://cvs.sourceforge.net/viewcvs.py/tinyos/tinyos-1.x/beta/teps/txt/tep2.txt?view=markup</a></td></tr>
</tbody>
</table>
--- 692,696 ----
<colgroup><col class="label" /><col /></colgroup>
<tbody valign="top">
! <tr><td class="label"><a name="tep2">[TEP2]</a></td><td>TEP 2: Hardware Abstraction Architecture. tinyos-2.x/doc/txt/tep2.txt</td></tr>
</tbody>
</table>
***************
*** 698,702 ****
<colgroup><col class="label" /><col /></colgroup>
<tbody valign="top">
! <tr><td class="label"><a name="tep111">[TEP111]</a></td><td>TEP 111: message_t. <a class="reference" href="http://cvs.sourceforge.net/viewcvs.py/tinyos/tinyos-1.x/beta/teps/txt/tep111.txt?view=markup">http://cvs.sourceforge.net/viewcvs.py/tinyos/tinyos-1.x/beta/teps/txt/tep111.txt?view=markup</a></td></tr>
</tbody>
</table>
--- 698,702 ----
<colgroup><col class="label" /><col /></colgroup>
<tbody valign="top">
! <tr><td class="label"><a name="tep111">[TEP111]</a></td><td>TEP 111: message_t. tinyos-2.x/doc/txt/tep111.txt</td></tr>
</tbody>
</table>
***************
*** 704,708 ****
<colgroup><col class="label" /><col /></colgroup>
<tbody valign="top">
! <tr><td class="label"><a name="tep116">[TEP116]</a></td><td>TEP 116: Packet Protocols. <a class="reference" href="http://cvs.sourceforge.net/viewcvs.py/tinyos/tinyos-1.x/beta/teps/txt/tep116.txt?view=markup">http://cvs.sourceforge.net/viewcvs.py/tinyos/tinyos-1.x/beta/teps/txt/tep116.txt?view=markup</a></td></tr>
</tbody>
</table>
--- 704,708 ----
<colgroup><col class="label" /><col /></colgroup>
<tbody valign="top">
! <tr><td class="label"><a name="tep116">[TEP116]</a></td><td>TEP 116: Packet Protocols. tinyos-2.x/doc/txt/tep116.txt</td></tr>
</tbody>
</table>
Index: upgrade-tinyos.html
===================================================================
RCS file: /cvsroot/tinyos/tinyos-2.x/doc/html/upgrade-tinyos.html,v
retrieving revision 1.1.2.8
retrieving revision 1.1.2.9
diff -C2 -d -r1.1.2.8 -r1.1.2.9
*** upgrade-tinyos.html 12 Sep 2006 23:07:53 -0000 1.1.2.8
--- upgrade-tinyos.html 6 Nov 2006 08:18:50 -0000 1.1.2.9
***************
*** 1,19 ****
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
! <html><head><style type="text/css">
! <!--
!
! BODY { font-size: 10pt; font-family: Arial, Helvetica, sans-serif; }
! TD { font-size: 10pt; font-family: Arial, Helvetica, sans-serif; }
! P { font-size: 10pt; font-family: Arial, Helvetica, sans-serif; }
! P.headline { font-size = 14pt; font-weight=bold; }
! -->
! </style></head><body>
<p>
- <table border="0" cellpadding="0" cellspacing="0" width="100%">
- <tbody><tr><td bgcolor="#eeeeee"><font face="verdana, arial, helvetica, sans-serif" size="3"><b>Upgrading from TinyOS 1.x to TinyOS 2.x</b></font></td>
- </tr></tbody></table>
- </p><p>
This document describes how to upgrade your TinyOS 1.x environment to
a TinyOS 2.x environment. This requires that you not only install the
--- 1,14 ----
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
! <html>
! <head>
! <title>Installing TinyOS 2.0</title>
! <link href="../stylesheets/tutorial.css" rel="stylesheet" type="text/css">
! </head>
! <body>
! <div class="title">Upgrading from TinyOS 1.x to TinyOS 2.x</div>
! <div class="subtitle">Last updated 5 November 2006</div>
<p>
This document describes how to upgrade your TinyOS 1.x environment to
a TinyOS 2.x environment. This requires that you not only install the
***************
*** 38,44 ****
</li></ol>
! <hr>
!
! <a name="external-tools"><h3> 1. Upgrade your external tools. </h3></a>
The 1.2 toolset uses the same Java JDK and ATT Graphviz versions, so
those do not need to be upgraded. What does need to be upgraded are
--- 33,37 ----
</li></ol>
! <a name="external-tools"><h1> Step 1: Upgrade your external tools. </h1></a>
The 1.2 toolset uses the same Java JDK and ATT Graphviz versions, so
those do not need to be upgraded. What does need to be upgraded are
***************
*** 150,155 ****
</tbody></table>
! </p><hr>
! <a name="tinyos-tools"><h3> 2. Upgrade your TInyOS-specific tools. </h3></a>
The TinyOS-specific tools are the NesC compiler and a set of tools
--- 143,148 ----
</tbody></table>
! </p>
! <a name="tinyos-tools"><h1> Step 2: Upgrade your TinyOS-specific tools. </h1></a>
The TinyOS-specific tools are the NesC compiler and a set of tools
***************
*** 194,200 ****
<tr>
<td bgcolor="#dddddd">tinyos-tools</td>
! <td bgcolor="#dddddd"><a href="http://www.tinyos.net/dist-2.0.0/tinyos/windows/tinyos-tools-1.2.2-1.cygwin.i386.rpm">tinyos-tools-1.2.2-1.cygwin.i386.rpm</a></td>
! <td bgcolor="#dddddd"><a href="http://www.tinyos.net/dist-2.0.0/tinyos/windows/tinyos-tools-1.2.2-1.cygwin.i386.rpm">tinyos-tools-1.2.2-1.cygwin.i386.rpm</a></td>
! <td bgcolor="#dddddd"><a href="http://www.tinyos.net/dist-2.0.0/tinyos/linux/tinyos-tools-1.2.2-1.i386.rpm">tinyos-tools-1.2.2-1.i386.rpm</a></td>
<td bgcolor="#dddddd"><a href=""></a><code>rpm -ivh --force</code> (1.x tree)<br><code>rpm -Uvh</code> (no 1.x tree)<br></td>
</tr>
--- 187,193 ----
<tr>
<td bgcolor="#dddddd">tinyos-tools</td>
! <td bgcolor="#dddddd"><a href="http://www.tinyos.net/dist-2.0.0/tinyos/windows/tinyos-tools-1.2.3-1.cygwin.i386.rpm">tinyos-tools-1.2.2-1.cygwin.i386.rpm</a></td>
! <td bgcolor="#dddddd"><a href="http://www.tinyos.net/dist-2.0.0/tinyos/windows/tinyos-tools-1.2.3-1.cygwin.i386.rpm">tinyos-tools-1.2.2-1.cygwin.i386.rpm</a></td>
! <td bgcolor="#dddddd"><a href="http://www.tinyos.net/dist-2.0.0/tinyos/linux/tinyos-tools-1.2.3-1.i386.rpm">tinyos-tools-1.2.2-1.i386.rpm</a></td>
<td bgcolor="#dddddd"><a href=""></a><code>rpm -ivh --force</code> (1.x tree)<br><code>rpm -Uvh</code> (no 1.x tree)<br></td>
</tr>
***************
*** 202,207 ****
</tbody></table>
! </p><hr>
! <a name="tinyos2"><h3> 3. Install the TinyOS 2.x source tree. </h3></a>
Now that the tools are installed, you need only install the tinyos 2.x
--- 195,200 ----
</tbody></table>
! </p>
! <a name="tinyos2"><h1> Step 3: Install the TinyOS 2.x source tree. </h1></a>
Now that the tools are installed, you need only install the tinyos 2.x
***************
*** 212,220 ****
<p>
<!----- TinyOS -------->
! To preserve your old tinyos-1.x tree, we strongly recommend that you use
the install (<code>-i</code>) rpm argument when installing the tinyos-2.x rpm rather
than the upgrade (<code>-U</code>) argument. The difference is that the <code>-U</code> will
first remove the tinyos-1.x tree while <code>-i</code> will not remove previously installed
! files. Said another way, we recommend using <code>rpm -ivh</code>.
</p><p><b><em>TinyOS 2.x</em></b>
--- 205,223 ----
<p>
<!----- TinyOS -------->
!
! <p>If you have an existing 1.x tree, we strongly recommend that you use
the install (<code>-i</code>) rpm argument when installing the tinyos-2.x rpm rather
than the upgrade (<code>-U</code>) argument. The difference is that the <code>-U</code> will
first remove the tinyos-1.x tree while <code>-i</code> will not remove previously installed
! files. Said another way, we recommend using <code>rpm -ivh</code>.</p>
!
! <p>If you have an existing 2.x tree which you want to keep unchanged, then
! you will need to move it to make space for the new one. For example, if you
! have an existing tree in <tt>/opt/tinyos-2.x/</tt>, then you can move it
! to <tt>/opt/tinyos-2.x-old</tt>. Once you have moved it, we recommend
! performing a forced installation of the 2.0 tree.</p>
!
! <p>If you have an existing 2.x tree which you do not care about, then we
! recommend removing it before installing the new one with a forced install.</p>
</p><p><b><em>TinyOS 2.x</em></b>
***************
*** 224,233 ****
<td bgcolor="#dddddd"><b>Windows/Cygwin</b></td>
<td bgcolor="#dddddd"><b>Linux</b></td>
</tr>
<tr>
<td>TinyOS</td>
! <td><a href="http://www.tinyos.net/dist-2.0.0/tinyos/windows/tinyos-2.0.0beta2-3.cygwin.noarch.rpm">tinyos-2.0.0beta2-3.cygwin.noarch.rpm</a></td>
! <td><a href="http://www.tinyos.net/dist-2.0.0/tinyos/linux/tinyos-2.0.0beta2-3.noarch.rpm">tinyos-2.0.0beta2-3.noarch.rpm</a></td>
</tr>
--- 227,241 ----
<td bgcolor="#dddddd"><b>Windows/Cygwin</b></td>
<td bgcolor="#dddddd"><b>Linux</b></td>
+ <td bgcolor="#dddddd"><b>Command</b></td>
</tr>
<tr>
<td>TinyOS</td>
! <td><a href="http://www.tinyos.net/dist-2.0.0/tinyos/windows/tinyos-2.0.0-1.cygwin.noarch.rpm">tinyos-2.0.0-1.cygwin.noarch.rpm</a></td>
! <td><a href="http://www.tinyos.net/dist-2.0.0/tinyos/linux/tinyos-2.0.0-1.noarch.rpm">tinyos-2.0.0-1.noarch.rpm</a></td>
! <td><tt>rpm -Uvh</tt> (to upgrade)<br>
! <tt>rpm -ivh</tt> (to install)<br>
! <tt>rpm -ivh --force</tt> (to force install)<br>
! </td>
</tr>
***************
*** 310,315 ****
</li></ul>
! <hr>
! <a name="tinyos1"><h3>Switching back to a TinyOS 1.x tree</h3></a>
Since the tools are backwardly compatible, you need only change
your environment variables to point to the 1.x settings. Assuming
--- 318,322 ----
</li></ul>
! <a name="tinyos1"><h1>Switching back to a TinyOS 1.x tree</h1></a>
Since the tools are backwardly compatible, you need only change
your environment variables to point to the 1.x settings. Assuming
***************
*** 349,351 ****
</td></tr></tbody></table>
! </p></body></html>
--- 356,362 ----
</td></tr></tbody></table>
! </p>
!
! <p>Switching between the two should require switching only these environment
! variables.</p>
! </body></html>
More information about the Tinyos-2-commits
mailing list