]> oss.titaniummirror.com Git - tinyos-2.x.git/blobdiff - apps/tests/tkn154/TestAssociate/README.txt
renaming directories to lower cases
[tinyos-2.x.git] / apps / tests / tkn154 / TestAssociate / README.txt
diff --git a/apps/tests/tkn154/TestAssociate/README.txt b/apps/tests/tkn154/TestAssociate/README.txt
new file mode 100644 (file)
index 0000000..eefdf41
--- /dev/null
@@ -0,0 +1,48 @@
+README for TestAssociate
+Author/Contact: tinyos-help@millennium.berkeley.edu
+
+Description:
+
+In this application one node takes the role of a PAN coordinator in a
+beacon-enabled 802.15.4 PAN; it transmits periodic beacons and waits for
+devices to request association to its PAN. Whenever a device tries to
+associate, the PAN coordinator allows association and assigns to the device a
+unique short address (starting from zero, incremented for every device
+requesting association). 
+
+A second node acts as a device; it first scans the pre-defined channel for
+beacons from the coordinator and once it finds a beacon it tries to associate
+to the PAN and synchronize to and track all future beacons. A short time after
+association the device then disassociates from the PAN. 
+
+The third LED (Telos: blue) is toggled whenever the coordinator has transmitted
+a beacon or whenever a device has received a beacon. On the coordinator the
+second LED (Telos: green) is switched on whenever an association request was
+successful and it is switched off, whenever a disassociation request was
+received. On a device the second LED is switched on while the device is
+associated to the PAN, i.e. it is switched off after disassociation. The first
+LED (Telos: red) is used for debugging, it denotes an error in the protocol
+stack and should never be on.
+
+Tools: NONE
+
+Usage: 
+
+1. Install the coordinator:
+
+    $ cd coordinator; make telosb install
+
+2. Install one (or more) devices:
+
+    $ cd device; make telosb install
+
+You can change some of the configuration parameters in app_profile.h
+
+Known bugs/limitations:
+
+- Currently this application only works on TelosB nodes
+- The MAC timing is not standard compliant, because TelosB lacks a
+  clock with sufficient precision/accuracy
+
+$Id$o
+