From 1275ad8c5c9368b541e7eeccfeb6bf20352e6330 Mon Sep 17 00:00:00 2001
From: razvanm May 25, 2007 June 1, 2007
@@ -45,14 +45,37 @@ Having said that, it would be helpful to read the Deluge 2.0 manual and
related documentations.
Deluge T2 is still in experimental phase. One current limitation is
-platform support. Deluge T2 has been developed and tested on Tmote Sky
-(telosb) only. In addition, Deluge T2 comes with 2 flash volumes by
+platform support. Deluge T2 has been developed on Tmote Sky (telosb)
+and MicaZ only. In addition, Deluge T2 comes with 2 flash volumes by
default. However, more volumes can be added, if necessary. There are
-also minor details that will be improved in future releases.
-Razvan Musaloiu-E.
-
Deluge T2 requires a few Python scripts that not yet included in the
+official tinyos-tools
RPM package. On the CVS, the scripts are
+located in tinyos-2.x/tools/tinyos/misc
. The steps to install
+them are the following:
+
+% cd $TOSROOT + % ./Bootstrap + ... + % ./configure + ... + % cd tinyos/misc + % make ; make install + ... ++
+By default, the files will be installed in /usr/local/bin
. If
+desired, the --prefix
parameter from configure
can be
+used to indicate a different path.
+
+ +
This section introduces the basics of reprogramming with an example. In
@@ -68,7 +91,7 @@ For example,
Then, we run the burn
script provided in tinyos-2.x/apps/tests/deluge/Blink
.
For example,
% ./burn /dev/ttyUSB0 +% ./burn /dev/ttyUSB0 telosbThis
-burn
script programs the directly-connected mote with one version of Blink. Then, it injects and reprograms the mote with another @@ -76,7 +99,7 @@ version of Blink. At this point, you can try to retrieve program image versioning information. The script to interface with the mote is provided intinyos-2.x/tools/tinyos/misc
. For example,% tos-deluge /dev/ttyUSB0 -p 0 +% tos-deluge /dev/ttyUSB0 telosb -p 0You should see something similar to the output below.
@@ -99,11 +122,11 @@ You should see something similar to the output below.The usage of
+any arguments, and it will be discussed in section 5.tos-deluge
is available by running the script without -any arguments, and it will be discussed in section 4.- -
3 Reprogramming a Network
+ +4 Reprogramming a Network
This section illustrates the procedure to reprogram a network. @@ -111,8 +134,8 @@ Specifically, we will see how program images are injected and how versioning information is retrieved.
- -
3.1 Setting Up the Motes
+ +4.1 Setting Up the Motes
We first install both TOSBoot and a program that runs Deluge T2. For simplicity, we use the golden image as the program. The golden image is provided in
tinyos-2.x/apps/tests/deluge/GoldenImage
, and it does @@ -126,14 +149,14 @@ act as a base station, which requires an additional component to accept user commands from the serial port. Normally, only one mote in the network needs to be the base station, and other motes are reprogrammed over-the-air. If error occurs when running the command above, you might -need to compile TOSBoot as shown in section 2. +need to compile TOSBoot as shown in section 3. Deluge T2 makes sure the mote ID remain persistent over image reprogramming. You can test the installation by interacting with the mote throughtos-deluge
.- -
3.2 Preparing Your Application
+ +4.2 Preparing Your Application
In most cases, the only two files you need to modify are the top-level wiring file and the Makefile. You need to make sure
DelugeC
component is included. In addition, the Makefile should have the @@ -148,12 +171,12 @@ example,
- -
Before a program image is disseminated in the network, we need to first inject it to the base station. For example,
-% tos-deluge /dev/ttyUSB0 -i 1 apps/Blink/build/telosb/tos_image.xml +% tos-deluge /dev/ttyUSB0 telosb -i 1 apps/Blink/build/telosb/tos_image.xmlYou should see something similar to the output below.
@@ -184,13 +207,13 @@ You should see something similar to the output below.
- -
After you decide which program image you want to reprogram, you can first test on the base station by issuing the reboot command. For example,
-% tos-deluge /dev/ttyUSB0 -r 1 +% tos-deluge /dev/ttyUSB0 telosb -r 1After a few moments, the mote will begin quickly flashing the LEDs to signify the reprogramming process.
@@ -198,7 +221,7 @@ signify the reprogramming process. Now, you can have the base station disseminate a program image to the rest of the network. For example, -% tos-deluge /dev/ttyUSB0 -d 1 +% tos-deluge /dev/ttyUSB0 telosb -d 1This command instructs the base station to notify the whole network of the availablility of a new program image. This notification is currently @@ -207,8 +230,8 @@ network to get the new program image. Upon receiving the complete image over-the-air, each node automatically reboots and reprograms itself.
- -
4 Deluge T2 Python Toolchain
+ +5 Deluge T2 Python Toolchain
Different from Deluge 2.0, Deluge T2 toolchain is written in Python. @@ -216,49 +239,49 @@ However, as demonstrated in the previous section, the usage is very similar.
- -
4.1 -p -ping
+ +5.1 -p -ping
This command is useful for checking the status of program images on a mote. It provides information such as program name, compile time, size of the image, and so on.
- -
4.2 -i -inject
+ +5.2 -i -inject
This command creates a program image from the supplied
tos_image.xml
file, and it injects the image into specified volume on the mote. All versioning information is kept on the mote, so no state is stored on the PC.- -
4.3 -r -reboot
+ +5.3 -r -reboot
This command sets up the mote to reprogram itself after reboot, and then it reboots the mote. This command is applicable only to the directly connected mote.
- -
4.4 -d -dissemination
+ +5.4 -d -dissemination
This command instructs the directly connected mote to disseminate an image to the network. This image is specified by the volume ID. Upon successfully receiving an image, motes in the network automatically reprogram themselves.
- -
4.5 -e -erase
+ +5.5 -e -erase
This command erases a flash volume on the directly connected mote.
- -
4.6 -s -reset
+ +5.6 -s -reset
This command resets versioning information of a specific image on the directly connected mote.
-Last modified: Friday, May 25th, 2007
+Last modified: Friday, June 1st, 2007
HTML conversion by TeX2page 2004-09-11