X-Git-Url: https://oss.titaniummirror.com/gitweb/?a=blobdiff_plain;f=doc%2Fhtml%2Fupgrade-tinyos.html;h=a6738b1aa83a24e6b1a68c1d6a9702c6944cdf4d;hb=4f057e14d46beedf64d643bebd06ca3e7e903d1f;hp=dec0395372ba37f5b99e4bc500676692b8004f37;hpb=74635b38a26aefd0732aa21aadad7ae6fbaef6b0;p=tinyos-2.x.git diff --git a/doc/html/upgrade-tinyos.html b/doc/html/upgrade-tinyos.html index dec03953..a6738b1a 100644 --- a/doc/html/upgrade-tinyos.html +++ b/doc/html/upgrade-tinyos.html @@ -1,14 +1,15 @@ - - + + +
-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 @@ -24,29 +25,33 @@ need to be reconfigured if you switch from TinyOS 2.x to TinyOS 1.x. The 1.2 toolset is backwards compatible with the 1.x TinyOS tree, so switching back and forth requires only a few variable changes. You can find those directions at the bottom of the page. -
+
+There are 3 steps to upgrading from 1.x to 2.x: -
+(Windows or Linux) with the rpm command 'rpm -Uvh rpm'. +
At this time, we have available compiler toolsets for Atmel AVR and TI MSP430 platforms. -
+
+
All of the tools are in the http://www.tinyos.net/dist-1.2.0/
and the http://www.tinyos.net/dist-2.0.0
distribution trees, but are linked below for convenience.
+
Atmel AVR Tools +Atmel AVR Tools
Tool | @@ -87,8 +92,8 @@ distribution trees, but are linked below for convenience.
rpm -Uvh --force
-
-TI MSP430 Tools +
+TI MSP430 ToolsTool | @@ -135,16 +140,15 @@ distribution trees, but are linked below for convenience.||
gdb | -Not yet available | msp430tools-gdb-6.0-20050609.i386.rpm |
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. Due to file conflicts between the new version
@@ -157,16 +161,18 @@ only installing a 2.x tree, you can use rpm -Uvh
.
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
+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).
-
-
+RPM. If you are using Cygwin and installing the nesC RPM +causes an error that the RPM was built for Cygwin, add the --ignoreos +option. +
- -TinyOS-specific Tools +TinyOS-specific Tools
Tool | @@ -179,31 +185,36 @@ RPM (1.2.7a).|||||||||
NesC | nesc-1.2.8a-1.cygwin.i386.rpm | -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) |
+ rpm -Uvh rpm -Uvh --ignoreos (if Cygwin complains) |
+|||
Tool | +Windows/Cygwin | +32-bit Linux | +64-bit Linux | +Command | |||||
tinyos-tools | -tinyos-tools-1.2.2-1.cygwin.i386.rpm | -tinyos-tools-1.2.2-1.cygwin.i386.rpm | -tinyos-tools-1.2.2-1.i386.rpm | -rpm -ivh --force (1.x tree)rpm -Uvh (no 1.x tree) |
+ 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) |
-
If you have an existing 1.x tree, we strongly recommend that you use
the install (-i
) rpm argument when installing the tinyos-2.x rpm rather
@@ -220,7 +231,7 @@ performing a forced installation of the 2.0 tree.
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.
-TinyOS 2.x +TinyOS 2.x
@@ -231,16 +242,17 @@ recommend removing it before installing the new one with a forced install. | ||||||
TinyOS | -tinyos-2.0.0-3.cygwin.noarch.rpm | -tinyos-2.0.0-3.noarch.rpm | -rpm -Uvh (to upgrade) - rpm -ivh (to install) - rpm -ivh --force (to force install) + | tinyos-2.0.2-2.cygwin.noarch.rpm | +tinyos-2.0.2-2.noarch.rpm | +rpm -Uvh (to upgrade) + rpm -ivh (to install) + rpm -ivh --force (to force install) |
In TinyOS 1.x, much of your environment was set by the rpm installation process by copying a tinyos.sh file into /etc/profile.d which was subsequently run anytime @@ -248,20 +260,23 @@ a shell was started. Because this was deemed unnecessarily invasive, the 2.x rpm does not do this. Rather, you need to set these variables yourself. Ideally, you'll put them in a shell script that will run when your shell starts, but you needn't put such a script under /etc/profile.d. -
+
+Please take note of the current settings since you'll need those if you want to work in your current 1.x tree sometime in the future. -
+
+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=`cygpath -w $TOSROOT/support/sdk/java/tinyos.jar` export CLASSPATH="$CLASSPATH;."-TinyOS 2.x +
TinyOS 2.x
Environment Variable | @@ -303,26 +318,47 @@ export CLASSPATH="$CLASSPATH;." †Only necessary if you're using the MSP430 platform/tools. -
Environment Variable | @@ -355,7 +391,6 @@ values:
Switching between the two should require switching only these environment variables.