===============================================================================

Description:

This package includes the files modified from TinyDB in TinyOS 1.1.15 to support 
our linear regression-based in-network contour mapping.

This package works on Telos Rev B motes (telosb).

The original TinyDB and TinyOS are available at www.tinyos.net.

The directories in this package: 

apps/TinyDBApp
tos/lib/TinyDB
tos/lib/Route
tos/lib/Attributes
tos/interface
tools/java/net/tinyos/tinydb

are modified from 

$TOSROOT/apps/TinyDBApp
$TOSROOT/tos/lib/TinyDB
$TOSROOT/tos/lib/Route
$TOSROOT/tos/lib/Attributes
$TOSROOT/tos/interface
$TOSROOT/tools/java/net/tinyos/tinydb

More information about this project can be found at:
http://www.cs.ust.hk/aorta/. 

===============================================================================

Usage:

1. Download and install TinyOS 1.1.15 (or later) from http://www.tinyos.net. 
   Note that TinyOS 1.1.0 does not support Telos motes.
2. Download and install tmote-tools-2.0.2-rpms.zip from http://www.moteiv.com. 
   These rpms are required to compile and install programs on Telos motes.
3. Replace directories in this package with correponding ones under $TOSROOT. 
   Remember to backup the original directories for future recovery.
4. Go to $TOSROOT/apps/TinyDBApp and run "make telosb". Make sure the 
   compilation is successful. If not, check whether your TinyOS installation 
   is correct. Run "make telosb reintall.x bsl,x" to install the complied 
   binary code on motes.
5. Go to $TOSROOT/tools/java/ and run "make". Change the COM port specified in
   "tinydb.conf" to be the one by which the root (Mote 0)is connected to your
   computer. Run "java net.tinyos.tinydb.TinyDBMain" to start the TinyDB GUI.
   Inject the default query in the Text Panel into the mote network. The total 
   number of regions in the final contour map output by the root is diplayed
   in the result frame, while overall information about the map is displayed in 
   stdout. If the injection of the query is failed, stop the query first and 
   before resending the query.

===============================================================================

Claim:

This is not an original work but only a modified version, and the current 
version is quite prelimenary and lack of robust testing. We disclaim of any 
copyrights and responsiblities in this package.

===============================================================================

Contact:

Please contact Wenwei Xue (wwxue@cs.ust.hk) for any questions.

===============================================================================
