Merge TinyOS 2.1.1 into master.

[tinyos-2.x.git] / apps / tosthreads / apps / TestCollection / README

diff --git a/apps/tosthreads/apps/TestCollection/README b/apps/tosthreads/apps/TestCollection/README
index 319f2a9470bf6dd5f7efdd7d92f0f8be04beca83..509e4d6cfd7283586dd1223f2a6f5c395581863e 100644 (file)
--- a/apps/tosthreads/apps/TestCollection/README
+++ b/apps/tosthreads/apps/TestCollection/README
@@ -12,22 +12,22 @@ subdirectory. The sampling rate starts at 4Hz, but can be changed from the Java
 application.
 
 You can install TestCollection on a mote via the following command:
 application.
 
 You can install TestCollection on a mote via the following command:

-  make <platform> cthreads install
-  
-Valid platforms are currently: tmote, telosb, mica2, and micaz 
+  make <platform> threads install
+
+Valid platforms are currently: tmote, telosb, mica2, micaz, iris, and epic

 
 At least two motes must be used by this application, with one of them installed
 as a base station.  Base station motes can be created by installing them with
 
 At least two motes must be used by this application, with one of them installed
 as a base station.  Base station motes can be created by installing them with

-NODE_ID % 500 == 0. 
+NODE_ID % 500 == 0.

   i.e. make <platform> threads install.0
        make <platform> threads install.500
        make <platform> threads install.1000
   i.e. make <platform> threads install.0
        make <platform> threads install.500
        make <platform> threads install.1000

-  
+

 All other nodes can be installed with arbitrary NODE_IDs.
   make <platform> threads install.123
 
 Successful running of this application is verified by all NON-base station motes
 All other nodes can be installed with arbitrary NODE_IDs.
   make <platform> threads install.123
 
 Successful running of this application is verified by all NON-base station motes

-periodically flashing LED0 upon sending a message, and the base station mote,
+periodically flashing LED1 upon sending a message, and the base station mote,

 flashing LED2 upon successful reception of a message.  Additionally, correct
 operation should be verified by running the java tool described in the following
 section.
 flashing LED2 upon successful reception of a message.  Additionally, correct
 operation should be verified by running the java tool described in the following
 section.


@@ -39,11 +39,16 @@ MultihopOscilloscope demo via a serial forwarder. To run it, change to the
 TestCollection/java subdirectory and type:
 
   make
 TestCollection/java subdirectory and type:
 
   make

-  java net.tinyos.sf.SerialForwarder -comm serial@<serial port>:<mote>
-  # e.g., java net.tinyps.sf.SerialForwarder -comm serial@/dev/ttyUSB0:mica2
-  # or java net.tinyps.sf.SerialForwarder -comm serial@COM2:telosb
+  java net.tinyos.sf.SerialForwarder -comm serial@<serial port>:<baud_rate>
+  # e.g., java net.tinyos.sf.SerialForwarder -comm serial@/dev/ttyUSB0:mica2
+  # or java net.tinyos.sf.SerialForwarder -comm serial@COM2:telosb

   ./run
 
   ./run
 

+NOTE::  The baud rate 57600 must be used telos based motes, as its configuration
+has been changed to work with this baud rate when compiled for TOSThreads. I.e.
+DO NOT just substitute 'telosb' or 'tmote' for <baud_rate> above.  Explicitly
+set it to 57600.
+

 The controls at the bottom of the screen allow you to zoom in or out the X
 axis, change the range of the Y axis, and clear all received data. You can
 change the color used to display a mote by clicking on its color in the
 The controls at the bottom of the screen allow you to zoom in or out the X
 axis, change the range of the Y axis, and clear all received data. You can
 change the color used to display a mote by clicking on its color in the


@@ -51,7 +56,7 @@ mote table.
 
 Notes:
 
 
 Notes:
 

-By default, the Makefile for TestCollection is setup to run CTP as the 
+By default, the Makefile for TestCollection is setup to run CTP as the

 underlying collection protocol.  The makefile can be modified to work with
 MultihopLQI by changing the appropriate include directories.
 
 underlying collection protocol.  The makefile can be modified to work with
 MultihopLQI by changing the appropriate include directories.