Merge TinyOS 2.1.1 into master.

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

diff --git a/apps/tosthreads/apps/TestJoin/README b/apps/tosthreads/apps/TestJoin/README
new file mode 100644 (file)
index 0000000..2f45af0
--- /dev/null
+++ b/apps/tosthreads/apps/TestJoin/README
@@ -0,0 +1,32 @@
+README for TOSThreads TestJoin
+Author/Contact: tinyos-help@millennium.berkeley.edu
+Author: Kevin Klues <klueska@cs.stanford.edu>
+
+Description:
+
+TestJoin is a simple application used to test the basic functionality of
+the join() system call for waiting on a set of threads in a TOSThreads 
+based application.
+
+You can install TestJoin on a mote via the following command:
+  make <platform> threads install
+  
+Valid platforms are currently: tmote, telosb, iris, mica2, micaz, and epic
+
+Upon a successful burn, you should see all LEDs toggle in the following pattern,
+repeating every 8 seconds:
+
+0s: (110) LED0  ON, LED1  ON, LED2 OFF
+1s: (000) LED0 OFF, LED1 OFF, LED2 OFF
+2s: (010) LED0 OFF, LED1  ON, LED2 OFF
+3s: (000) LED0 OFF, LED1 OFF, LED2 OFF
+4s: (111) LED0  ON, LED1  ON, LED2 ON
+5s: (001) LED0 OFF, LED1 OFF, LED2 ON
+6s: (011) LED0 OFF, LED1  ON, LED2 ON
+7s: (001) LED0 OFF, LED1 OFF, LED2 ON
+
+Tools:
+  None.
+
+Known bugs/limitations:
+  None.