+<?xml version="1.0" encoding="utf-8" ?>
<!doctype html public "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta name=robots content="index,follow">
</head>
<body>
+<div id=title>
+<p></p>
<p>
</p>
</p>
-<h1 class=title align=center><br><br>Deluge T2 - Programming Manual</h1>
+<h1 class=title>Deluge T2 - Programming Manual</h1>
<p></p>
<div align=center>
Chieh-Jan Mike Liang<br>
-Razvan Musaloiu-E.<p>June 1, 2007</p>
+Razvan Musaloiu-E.<p>July 13, 2007</p>
</div>
<p></p>
<p>
<a href="http://www.cs.berkeley.edu/~jwhui/research/deluge/">http://www.cs.berkeley.edu/~jwhui/research/deluge/</a>.</p>
<p>
Deluge T2 is an effort to port Deluge 2.0 from TinyOS 1 to TinyOS 2.
-Since the code from Deluge 2.0 is reused as much as possible, the
-behavior and the usage of Deluge T2 should be similar to Deluge 2.0.
-Having said that, it would be helpful to read the Deluge 2.0 manual and
-related documentations.</p>
+Although the code from Deluge 2.0 is reused as much as possible, the
+behavior and the usage of Deluge T2 are not entirely identical to Deluge
+2.0. Having said that, it would still be helpful to read the Deluge 2.0
+manual and related documentations.</p>
<p>
Deluge T2 is still in experimental phase. One current limitation is
platform support. Deluge T2 has been developed on Tmote Sky (<i>telosb</i>)
them are the following:</p>
<p>
</p>
-<pre class=verbatim> % cd $TOSROOT
+<pre class=verbatim> % cd $TOSROOT/tools
% ./Bootstrap
...
% ./configure
TinyOS 2 CVS tree and Python 2.4 with pySerial support are recommended
for running Deluge T2.</p>
<p>
-To start the example, we first compile TOSBoot provided in <code class=verbatim>tinyos-2.x/tos/lib/TOSBoot</code>.
+To start the example, we first compile tosboot provided in <code class=verbatim>tinyos-2.x/tos/lib/tosboot</code>.
For example,
</p>
<pre class=verbatim> % make telosb
</p>
<a name="node_sec_4.1"></a>
<h2>4.1 Setting Up the Motes</h2>
-<p>We first install both TOSBoot and a program that runs Deluge T2. For
+<p>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 <code class=verbatim>tinyos-2.x/apps/tests/deluge/GoldenImage</code>, and it does
nothing except initializing Deluge T2. This step can be done by
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 <a href="#node_sec_3">3</a>.
+need to compile
tosboot as shown in section <a href="#node_sec_3">3</a>.
Deluge T2 makes sure the mote ID remain persistent over image
reprogramming. You can test the installation by interacting with the
mote through <code class=verbatim>tos-deluge</code>.</p>
first test on the base station by issuing the reboot command. For
example,
</p>
-<pre class=verbatim> % tos-deluge /dev/ttyUSB0 telosb -r 1
+<pre class=verbatim> % tos-deluge /dev/ttyUSB0 telosb -b 1
</pre><p>
After a few moments, the mote will begin quickly flashing the LEDs to
signify the reprogramming process.</p>
<pre class=verbatim> % tos-deluge /dev/ttyUSB0 telosb -d 1
</pre><p>
This command instructs the base station to notify the whole network of
-the availablility of a new program image. This notification is currently
+the availability of a new program image. This notification is currently
done via TinyOS dissemination service, and it triggers all motes in the
-network to get the new program image. Upon receiving the complete image
-over-the-air, each node automatically reboots and reprograms itself.</p>
+network to get the new program image. After all motes receive the image
+over-the-air, you can instruct the base station to disseminate the
+command to reprogram in the network. For example,
+</p>
+<pre class=verbatim> % tos-deluge /dev/ttyUSB0 telosb -r 1
+</pre><p></p>
<p>
</p>
<a name="node_sec_5"></a>
<p></p>
<p>
Different from Deluge 2.0, Deluge T2 toolchain is written in Python.
-However, as demonstrated in the previous section, the usage is very
-similar.</p>
+However, as demonstrated in the previous section, the usage is similar.</p>
<p>
</p>
<a name="node_sec_5.1"></a>
<p>
</p>
<a name="node_sec_5.3"></a>
-<h2>5.3 -r -reboot</h2>
+<h2>5.3 -b -reprogram_bs</h2>
<p>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.</p>
+it reboots the mote. This command is applicable only to the base station
+mote.</p>
<p>
</p>
<a name="node_sec_5.4"></a>
<h2>5.4 -d -dissemination</h2>
-<p>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.</p>
+<p>This command instructs the base station mote to disseminate an image to
+the network. This image is specified by the volume ID.</p>
<p>
</p>
<a name="node_sec_5.5"></a>
-<h2>5.5 -e -erase</h2>
-<p>This command erases a flash volume on the directly connected mote.</p>
+<h2>5.5 -r -reprogram</h2>
+<p>This command instructs the base station mote to disseminate the
+command to reprogram in the network. This command does not reprogram the
+base station mote. The image is specified by the volume ID.</p>
<p>
</p>
<a name="node_sec_5.6"></a>
-<h2>5.6 -s -reset</h2>
+<h2>5.6 -e -erase</h2>
+<p>This command erases a flash volume on the base station mote.</p>
+<p>
+</p>
+<a name="node_sec_5.7"></a>
+<h2>5.7 -s -reset</h2>
<p>This command resets versioning information of a specific image on the
-directly connected mote.</p>
+base station mote.</p>
<p>
</p>
-<div align=right class=colophon>
-<i>Last modified: Friday, June 1st, 2007<br>
-HTML conversion by <a href="http://www.ccs.neu.edu/~dorai/tex2page/tex2page-doc.html">TeX2page 2004-09-11</a></i>
+<p></p>
+<div align=right class=colophon>Last modified: Friday, July 13th, 2007 1:48:23pm<br><div align=right class=advertisement>HTML conversion by <a href="http://www.ccs.neu.edu/~dorai/tex2page/tex2page-doc.html">TeX2page 20050501</a></div></div>
</div>
</body>
</html>
projects / tinyos-2.x.git / blobdiff