The latest version of TinyDB is always
available via anonymous CVS as a part of TinyOS. This documentation
refers to the version of TinyDB rooted at tinyos-1.x/ in the CVS
repository. Most of the source code resides in three directories:
- tinyos-1.x/apps/TestTinyDB
- tinyos-1.x/tos/lib/TinyDB
- tinyos-1.x/tools/java/net/tinyos/tinydb
A stable release of TinyDB is included
with the TinyOS 1.1 release, which is available from the TinyOS Website.
If you follow the installation instructions there, you should be able to
build and install both the Java and TinyOS components of TinyDB.
Requirements
TinyDB runs on Mica motes (available
from Crossbow Technologies). It requires a TinyOS distribution for the
nesC compiler, which is available with the TinyOS 1.1 Release.
In addition to the mote software, TinyDB provides a PC interface written
in Java. JDK 1.3 or later is required. Some features (such as
integration with Postgres) require additional features. For more
information, see the TinyDB documentation.
Installation
If you downloaded TinyDB from CVS or installed TinyOS 1.1, you
should have all of the nesC and java files you will need to build TinyDB.
To build the TinyDB software, make sure you have a working TinyOS
distribution -- because TinyDB is large and takes significant time to
compile, it's best to verify that you can build other TinyOS programs
first. A good starting point would be Tutorial 1, in
tinyos-1.x/doc/tutorial/lesson1.html .
To build TinyDB, first compile the mote binaries. In the
tinyos-1.x/apps/TinyDBApp/ directory, run make install.x to compile and
install the software on a mote (just as with other TinyOS applications.)
To build the java tools:
- Verify that your $CLASSPATH includes
the
JLex.jar, cup.jar and plot.jar files in the
tinyos-1.x/tools/java/jars directory. If they are not already
included (if you installed using the TinyOS 1.1 Installer, your
classpath has been automagically set), you can append these files to
your classpath using the javapath tool; under bash, type:
export CLASSPATH=`/path/to/tinyos/tinyos-1.x/tools/java/javapath`
under csh:
setenv CLASSPATH `/path/to/tinyos/tinyos-1.x/tools/java/javapath`
where /path/to/tinyos/ is the directory containing your TinyOS
source tree. The javapath tool prepends the jar files mentioned
above (along with several others) to your existing classpath.
cd tinyos-1.x/tools/java/net/tinyos/tinydb
- type '
make ' (this compilation may
take a long time, especially under Cygwin)
|