Merge TinyOS 2.1.1 into master.

[tinyos-2.x.git] / apps / tests / TestSimComm / README

diff --git a/apps/tests/TestSimComm/README b/apps/tests/TestSimComm/README
index 30e4d7a15435564ff5ea3dd2d828fe6189f3b938..dda666e2d3a0b1768934e9fea023e38ec761c300 100644 (file)
--- a/apps/tests/TestSimComm/README
+++ b/apps/tests/TestSimComm/README
@@ -1,4 +1,4 @@
-TestTimer, 5/22/07 
+TestSimComm, 5/22/07 
 
 This application tests the TOSSIM radio model by setting up a simple
 hidden terminal case. It checks whether packets collide correctly and
@@ -29,5 +29,35 @@ quality links (-60 dBm) to node 2, but the reverse links (2 to 1 and
 2 to 3) are much worse (-80 dBm). You should see packet deliveries
 like test-equal.py but few acknowledgements.
 
+The ./run script runs all the three tests and counts the number of
+ACKed and non-ACKed send packets. The output will look something
+like this:
+
+test-equal.log
+           ACK           NOACK   total
+         1 21197         19666   40863
+         3 21320         19543   40863
+test-asym.log
+           ACK           NOACK   total
+         1 4930          35923   40853
+         3 4983          35870   40853
+test-unequal.log
+           ACK           NOACK   total
+         1 27619         12966   40585
+         3 21040         19545   40585
+
+ACK is the number of acknowledged packets from that node to node 2;
+NOACK is the number of unacknowledged packets. Total is the sum.
+The output should show three things:
+
+  1) In test-equal, both node 1 and node 3 have very
+  similar delivery ratios, losing about half of their packets.
+
+  2) In test-asym, the number of ACKs is much less than in
+  test-equal because the reverse links are poor.
+
+  3) In test-unequal, node 1 has more acknowledged packets
+  than node 3, because it has a higher SNR link.
+
 Philip Levis