Improve some of READMEs from the Deluge T2 test applications.

[tinyos-2.x.git] / apps / tests / deluge / SerialBlink / README.txt

diff --git a/apps/tests/deluge/SerialBlink/README.txt b/apps/tests/deluge/SerialBlink/README.txt
index aaa5d250bacd7907c1b750945e3fceea411f8e3f..5e5a0e31ec78c1b83269eb6703530ee82feacaea 100644 (file)
--- a/apps/tests/deluge/SerialBlink/README.txt
+++ b/apps/tests/deluge/SerialBlink/README.txt
@@ -6,17 +6,32 @@ Razvan Musaloiu-E. <razvanm@cs.jhu.edu>
 
 Description:
 
-This is a sample application for Deluge T2. The program blinks and sends 
-a serial msg every second.
+This is a sample application for Deluge T2. The program blinks and
+sends a serial message every second. On a testbed equipped with a
+serial back-channel the following test can be run:
+   1) Compile and burn the program on all the motes on the
+      testbed. The serial messages send by the motes is one-byte value
+      of 0.
+   2) Compile and burn a base station. This can be done by adding
+      CFLAGS=-DDELUGE_BASESTATION to the make command. For telosb this
+      will look like this:
+          CFLAGS=-DDELUGE_BASESTATION make telosb
+   3) Compile a different version of SerialBlink by adding
+      CFLAGS=-DBLINK_REVERSE to the make command. For telosb this
+      will look like this:
+          CFLAGS=-DBLINK_REVERSE make telosb
+   4) Upload the new SerialBlink to the base station. For a telosb
+      connected to /dev/ttyUSB0 this can be accomplish using this
+      command:
+                  tos-deluge /dev/ttyUSB0 telosb -i 1 build/telosb/tos_image.xml
+   5) Give the command to disseminate-and-reboot:
+                  tos-deluge /dev/ttyUSB0 telosb -dr 1
+
+As the motes get and reprogram with the new image they will start
+sending on the serial a one-byte value of 2.
 
-You can reprogram the whole network (non-basestation motes) by first 
-uploading the image to the base station. Then, tell the base station to 
-disseminate the image. Example:
-
-   tos-deluge /dev/ttyUSB0 telosb -dr 1
-   
 For a more detailed discussion on Deluge T2, please refer to the Deluge 
-T2 manual.
+T2 wiki page.
 
 Prerequisites:
 
@@ -24,4 +39,4 @@ Python 2.4 with pySerial
 
 References:
 
-The Deluge T2 manual is available under $TOS_DIR/doc/html/.
+The Deluge T2 wiki page from http://docs.tinyos.net/