add instructions to use the matlab file, contains some evaluation of FTSP

diff --git a/apps/tests/TestFtsp/README.MATLAB.txt b/apps/tests/TestFtsp/README.MATLAB.txt
new file mode 100644 (file)
index 0000000..0535549
--- /dev/null
+++ b/apps/tests/TestFtsp/README.MATLAB.txt
@@ -0,0 +1,46 @@
+FtspDataAnalyzer.m\r
+\r
+-------------------------------------------------------------------------------\r
+Author/Contact:\r
+---------------\r
+ Brano Kusy: branislav.kusy@gmail.com\r
+\r
+-------------------------------------------------------------------------------\r
+DESCRIPTION:\r
+------------\r
+\r
+FtspDataAnalyzer.m works with data logs collected by FtspDataLogger.java and\r
+calculates the maximum and average timesync error over time.\r
+\r
+-------------------------------------------------------------------------------\r
+STEP BY STEP GUIDE TO RUN OUR TEST SCENARIO:\r
+--------------------------------------------\r
+1. program and start motes as described in ./README.txt\r
+2. start SerialForwarder and FtspDataLogger.java as described in ./README.txt\r
+3. 'current_time.report' file (where current_time is a number) is created in ./\r
+   this file is updated with data in the real time\r
+4. let the experiment run for some time\r
+5. start matlab and enter (assuming your current_time was 1206126224593)\r
+    FTSPDataAnalyzer('1206126224593.report')\r
+    this will plot the mean absolute timesync error, global time, and number of\r
+    synced motes; this can be done while experiment is running\r
+6. Matlab also creates data.out file which contains data in the following format\r
+    #seqNum mean_abs_error global_time num_synced_motes\r
+    mean_abs_error is calculated as mean absolute deviation from the mean (mad)\r
+\r
+Simulating multi-hop:\r
+1. define TIMESYNC_DEBUG in the Makefile\r
+2. recompile and upload TestFTSP app to n motes with special NODE_IDs:\r
+     using 'make micaz reinstall.0xAB', nodes 0xAB and 0xCD can communicate\r
+     iff 2D grid coordinates (A,B) and (C,D) are neighbors in a 2D grid\r
+ \r
+-------------------------------------------------------------------------------\r
+EVALUATION:\r
+--------------------------------------------\r
+ - deployment setup: 11 nodes in a 5x3 grid using simulated multi-hop (4 points\r
+   were vacant as we only used 11 nodes). the max number of hops was 5.\r
+ - parameters: sync period 10sec, polling period 3 sec\r
+ - experiment length: 100 minutes\r
+ - results (1 jiffy is ~30.5 us)\r
+    1.53 jiffy avg error (~50us)\r
+    3.5 jiffy max error (~100us)
\ No newline at end of file