VMNet Quick Start Guide

System Requirement

• Hardware: Intel Pentium (or compatible) processor (200 MHz or higher), more than 128MB RAM and 1GB disk space.
• Operating system: Linux (kernel 2.4.20 or higher) with Xwindow.
• Atemu-required libraries:
  • GTK2 : GLIB (version 2.2.0 or higher) and GTK+ (version 2.0.0 or higher)
  • libxml2 (version 2.0.0 or higher)
  • libelf (version 0.8.5 or higher)
  • avr-gcc (version 3.3 or higher)
• Application-required libraries: TinyOS 1.0.0 (including TinyDB). Note, TinyOS installation on Windows will automatically install avr-gcc.

Compilation and Installation

1. Decompress the VMNet package. The decompressed files will be placed into a directory named "VMNet" by default.
2. Run "configure" in this directory.
3. Run "make" in this directory. The executable file "VMN" will be generated in this directory. VMNet is ready for use.
4. For the use of TinyDB with VMNet, take the following steps:
   • Follow the TinyDB manual to install TinyOS/TinyDB.
   • Enter the directory "tinyos-1.x/tools/java/net/tinyos" and back up the two java files "packet/Packetizer.java" and "tinydb/TinyDBMain.java".
   • Decompress the MTinyDBGUI package and copy the two subdirectories "packet" and "tinydb" into the "tinyos-1.x/tools/java/net/tinyos" directory.
   • Enter the "tinyos-1.x/tools/java/net/tinyos/tinydb" subdirectory and run "make clean" followed by "make -f MakePC".
   • Enter the directory "tinyos-1.x/tools/java" and run "make clean" followed by "make". The modified TinyDB GUI is ready to be used with VMNet.

Running VMNet

1. Generate a .xrun file manually or using the tool in the directory "VMNet/tools/deployer". There are sample .xrun files in the directory "VMNet/run".
2. Run "VMN run/sample.xrun" in the directory VMNet, suppose the file "sample.xrun" in the subdirectory "run" specifies the configuration of a VMN and the application binary code for real sensor nodes are placed as specified in the file "sample.xrun". The VMN is running from now.
3. In the directory "tinyos-1.x/tools/java", run "java net.tinyos.tinydb.TinyDBMain -vmnet" to start the modified TinyDB GUI client.
4. Post queries and commands through the TinyDB GUI, and VMNet will return query results and the name of the log file. The logging option can be turned off by commenting off the line "#define POWER_CONSUMPTION_MEASURE" in the file "VMNet/EM/atmega128.h" and recomiling the code.
5. Use the tools in "VMNet/tools/PowerAnalyzer" and "VMNet/tools/StatisticSum" to analyze the log files and to obtain performance statistics.