From f3dcc81d96fe27901abcfc81704abdab5c85f6ae Mon Sep 17 00:00:00 2001 From: razvanm Date: Sat, 28 Jun 2008 00:49:48 +0000 Subject: [PATCH] Improve some of READMEs from the Deluge T2 test applications. --- apps/tests/deluge/Blink/README.txt | 33 ++++++++++------------ apps/tests/deluge/GoldenImage/README.txt | 2 +- apps/tests/deluge/SerialBlink/Makefile | 3 ++ apps/tests/deluge/SerialBlink/README.txt | 35 +++++++++++++++++------- 4 files changed, 44 insertions(+), 29 deletions(-) diff --git a/apps/tests/deluge/Blink/README.txt b/apps/tests/deluge/Blink/README.txt index 2f91200c..3e0a0169 100644 --- a/apps/tests/deluge/Blink/README.txt +++ b/apps/tests/deluge/Blink/README.txt @@ -9,36 +9,33 @@ Description: This application serves two purposes. First, it contains two test cases for Deluge T2: testing base station functionality and network-wide reprogramming. Second, it is a sample application referenced in the -Deluge T2 manual to illustrate some of the basics in reprogramming. +Deluge T2 wiki page to illustrate some of the basics in reprogramming. These are done with the two burn scripts in the directory. The "burn" script performs the following tasks (on the basestation only): - 1) Compile and load the program normally. - 2) Compile another version of blink that blinks differently. - 3) Upload the new blink to flash volume 0. + 1) Compile and load the program normally. After this step the mote + will blink led 0. + 2) Compile another version of blink that blinks led 2. + 3) Upload the new blink to flash volume 1. 4) Instruct the mote to reprogram with the new blink. +If all the steps are executed properly the mote end up blinking the +led 2. + The "burn-net" script performs the following tasks: 1) Compile and load the program normally on multiple motes. The last mote is designated to be the basestation. - 2) Compile another version of blink that blinks differently. - 3) Upload the new blink to flash volume 0 on the base station. - 4) Instruct the base station to disseminate the new blink. - 5) Instruct the base station to reprogram the network with the new - image. + 2) Compile another version of blink that blinks led 2. + 3) Upload the new blink to flash volume 1 on the base station. + 4) Give the command to base station to disseminate-and-reprogram. To help testing, "burn-net" script describes what the user should expect -in each step. - -Alternatively, 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. For example, - - tos-deluge /dev/ttyUSB0 telosb -dr 1 +in each step. At the end of all the steps the base station should +blink led 0 and all the rest of the motes should blink led 2. For a more detailed discussion on Deluge T2, please refer to the Deluge -T2 manual. +T2 wiki page. Prerequisites: @@ -46,4 +43,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/ diff --git a/apps/tests/deluge/GoldenImage/README.txt b/apps/tests/deluge/GoldenImage/README.txt index b3e140ea..6b2a7f64 100644 --- a/apps/tests/deluge/GoldenImage/README.txt +++ b/apps/tests/deluge/GoldenImage/README.txt @@ -20,4 +20,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/ diff --git a/apps/tests/deluge/SerialBlink/Makefile b/apps/tests/deluge/SerialBlink/Makefile index 319a5d83..5aad1f19 100644 --- a/apps/tests/deluge/SerialBlink/Makefile +++ b/apps/tests/deluge/SerialBlink/Makefile @@ -1,4 +1,7 @@ COMPONENT=BlinkAppC BOOTLOADER=tosboot +#CFLAGS += -DDELUGE_BASESTATION +#CFLAGS += -DDELUGE_LIGHT_BASESTATION + include $(MAKERULES) diff --git a/apps/tests/deluge/SerialBlink/README.txt b/apps/tests/deluge/SerialBlink/README.txt index aaa5d250..5e5a0e31 100644 --- a/apps/tests/deluge/SerialBlink/README.txt +++ b/apps/tests/deluge/SerialBlink/README.txt @@ -6,17 +6,32 @@ Razvan Musaloiu-E. 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/ -- 2.39.2