Spyglass

A modular and extensible visualization framework for wireless sensor networks.

Contents

Compatibility

Spyglass only requires Java 6 in order to be successfully run. All libraries needed are contained in the projects sources. So generally speaking, it should run on every well-established OS.

However, there's an issue with Mac OS X. As Spyglass is written using SWT (http://www.eclipse.org/swt/) and Java 6, at the time of writing this, it can currently not be run on Mac OS X. Since there's only a 64-bit implementation of Java 6 for Mac OS X and SWT is still based on 32-bit based Carbon UI-Framework it simply won't run. There's an implementation of SWT for Cocoa going on which will be shipped with Eclipse 3.5 (expected for May 2009 or later).

Get the sources

The Spyglass project is hosted on SourceForge.net (http://sourceforge.net/projects/itm-spyglass).
You can check out it's sources with a Subversion client from https://itm-spyglass.svn.sourceforge.net/svnroot/itm-spyglass.

Compiling

After checking out the sources there are some OS-specific project properties that must be set in order to get Spyglass up and running.

Adding libraries to the build path

The folder lib contains all libraries that are needed to get Spyglass up and running. Make sure the following libraries are contained in your projects build path:

Running

Once the project is set up and compiling there are several ways to run Spyglass:
  1. For Eclipse:
    Eclipse launch configurations are part of the project checkout and are located in the projects root folder and have the file name ending .launch. After checking out you should find the run configurations in the well known Run/Debug dialogs of Eclipse.
    If you can't find them it can mean, that the .launch file contains other project paths than your checked out project. In this case, simply open the .launch file and search/replace the the projects' paths corresponding to the name of your checkout folder in the workspace. This should do it.

    1. Stand-Alone
      Use the configuration file Spyglass Stand-Alone.launch. This will start the stand-alone version of Spyglass by calling {@see de.uniluebeck.itm.spyglass.SpyglassApp}.

    2. As an iShell plugin
      Use the launch configuration files iShell Linux.launch or iShell Windows.launch. This will start Spyglass as a plugin for iShell.

  2. As Ant build script:
    The Ant build script defines targets for Linux and Windows, for stand-alone version and for the iShell plugin. The resulting .jar file is executable (by running java -jar filename.jar). It contains all libraries needed to run if JRE 6 is present.
    If startup fails with an java.lang.OutOfMemoryError exception try to enlarge the VMs heap space by adding -Xmx128m (128 Megs usually do it) to the shell command.

    1. Stand-Alone
      Simply run ant standalone-win32 or ant standalone-linux to create a jar file that can afterwards be run by java -jar spyglass-win32-standalone.jar or java -jar spyglass-linux-standalone.jar.

    2. As an iShell plugin
      Simply run ant ishell-win32 or ant ishell-linux to create a jar file that can afterwards be run by java -jar ishell-win32-spyglass.jar or java -jar ishell-linux-spyglass.jar.


This introduction was written by Daniel Bimschas (daniel@bimschas.com). Feel free to contact me regarding questions or errors in this document.