Merge TinyOS 2.1.1 into master.

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

diff --git a/apps/tosthreads/capps/TestCollection/README b/apps/tosthreads/capps/TestCollection/README
index 63cd279db724d767187f3c5930692bf16abc33ba..1eb94411164309b44d89ed82f43aa37dfb4b1b9a 100644 (file)
--- a/apps/tosthreads/capps/TestCollection/README
+++ b/apps/tosthreads/capps/TestCollection/README
@@ -14,7 +14,7 @@ application.
 You can install TestCollection on a mote via the following command:
   make <platform> cthreads install
 
 You can install TestCollection on a mote via the following command:
   make <platform> cthreads install
 

-Valid platforms are currently: tmote, telosb, mica2, micaz and iris
+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


@@ -24,7 +24,7 @@ NODE_ID % 500 == 0.
        make <platform> cthreads install.1000
 
 All other nodes can be installed with arbitrary NODE_IDs.
        make <platform> cthreads install.1000
 
 All other nodes can be installed with arbitrary NODE_IDs.

-  make <platform> threads install.123
+  make <platform> cthreads 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,
 
 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,


@@ -34,14 +34,13 @@ section.
 
 Tools:
 
 
 Tools:
 

-The Java application displays readings it receives from motes running the
-MultihopOscilloscope demo via a serial forwarder. To run it, change to the
-TestCollection/java subdirectory and type:
+The Java application displays readings it receives from motes via a
+serial forwarder. To run it, change to the java subdirectory and type:

 
   make
   java net.tinyos.sf.SerialForwarder -comm serial@<serial port>:<baud_rate>
 
   make
   java net.tinyos.sf.SerialForwarder -comm serial@<serial port>:<baud_rate>

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

   ./run
 
 NOTE::  The baud rate 57600 must be used telos based motes, as its configuration
   ./run
 
 NOTE::  The baud rate 57600 must be used telos based motes, as its configuration


@@ -59,10 +58,10 @@ Notes:
   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.
 

+  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.
+

 Known bugs/limitations:
 Known bugs/limitations:

-  Warnings are issued about fan out on the 'Snoop.receive' and 'Receive.receive'
-  events.  These warnings are harmless and are the result of providing a C based
-  API in which all events for receiving and snooping must be handled even if not
-  used by a particular application.  The warnings occur because the underlying
-  CTP or MultihopLQI stacks wire up to particular AM ids, which are also wired
-  into the C API for handling message reception.
+  None