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

Description:

This package contains an implementation of Directed Diffusion (DD) modified
from the version of TinyDB in TinyOS 1.1.0. 

The three directories in this package: 

DirectedDiffusionApp/
DirectedDiffusion/
DirectedDiffusionRoute/

are modfied from 

$TOSROOT/apps/TinyDBApp/
$TOSROOT/tos/lib/TinyDB/
$TOSROOT/tos/lib/Route/

respectively. 

The implementation includes several core components of Directed Diffusion:
the interest and data caching, periodical interest refreshing, gradient set-up 
and maintenance, initial exploratory source data with low rates, multi-path 
routing, path reinforcement and negative reinforcement.  
It is developed for the performance evaluation of our Bisque benchmark 
for in-network sensor query processing systems.

More information about Bisque can be found at our project web site
http://www.cs.ust.hk/bisque/.

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

Usage:

To compile this implementation of Directed Diffusion, the latest strenuously 
tested release of TinyOS (1.1.0) is required.
1. Copy the directory DirectedDiffusionApp/ to $TOSROOT/apps/.
2. Copy the two directories DirectedDiffusion/ and DirectedDiffusionRoute/ to 
   $TOSROOT/tos/lib/.
3. Enter $TOSROOT/apps/DirectedDiffusionApp/ and type "make <platform>".

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

Notes:

1. This implementation of Directed Diffusion cannot be compiled with "make 
pc" and run on TOSSIM.

2. We have not tried this implementation of Directed Diffusion on the latest 
TinyOS CVS snapshot releases (1.1.13) and not sure whether it can be compiled
and run correctly on it.

3. To use this implementation of Directed Diffusion with our VMNet wireless
sensor network emulator, please refer to the README file in the VMNet package.

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

Contact:

Please contact Wenwei Xue (wwxue@cs.ust.hk) for any questions/comments about 
this implementation of Directed Diffusion.

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