Supporting test suite for the newest CC2420 stack. Includes a low power version...

[tinyos-2.x.git] / apps / tests / cc2420 / TestPacketLink / README.txt

diff --git a/apps/tests/cc2420/TestPacketLink/README.txt b/apps/tests/cc2420/TestPacketLink/README.txt
new file mode 100644 (file)
index 0000000..51ab853
--- /dev/null
+++ b/apps/tests/cc2420/TestPacketLink/README.txt
@@ -0,0 +1,29 @@
+
+Test the effectiveness of the PacketLink layer
+
+INSTALL
+  Transmitter == 1, 2, 3, 4, or 5 (up to MAX_TRANSMITTERS)
+  Receiver == 0, plugged into the computer
+
+EXPECTATIONS
+   Transmitter (ID not 0) -
+     led1 toggling on every successfully delivered message
+     led0 toggling on every unsuccessfully delivered message (and stay on
+       until the next dropped packet)
+   
+   Receiver (ID 0) -
+     Leds represent the binary count of sets of messages that were dropped.
+     Ideally, if the transmitter and receiver are in range of each other, 
+     the receiver's LEDs should never turn on.  You can pull the receiver
+     out of range for up to two seconds before the transmission will fail.
+     If you aren't convinced the receiver is doing anything because its 
+     leds aren't flashing, just turn it off and watch the transmitter's
+     reaction.
+
+
+Java Application Usage:
+  Linux: java TestPacketLink.class [-comm <packetsource>]
+  Windows: java TestPacketLink [-comm <packetsource>]
+
+  If not specified, the <packetsource> defaults to sf@localhost:9001 or
+  to your MOTECOM environment variable (if defined).