Installation and Dependencies

This page describes the library and tool dependencies to run OpenVisualizer, and provides download instructions for the installation package.

For generic installation instructions, please follow one of the following "Getting Started" tutorials:

Dependencies

Package	Role	Installation Notes
Python	implementation language	Using v2.7. v3.x not supported.
PySerial	serial to mote	Using v2.6.
PyDispatcher	event framework	Using v2.0.3. Historically, we have included PyDispatcher in the OpenVisualizer repository itself. However, as of November 2013, we are transitioning the develop branch to require separate installation of PyDispatcher, as we require installation of the other modules listed in this table. So, if in doubt, install this module.
PyWin32 Python Extensions for Windows	tunnel dependency (Windows only)	Using Build 218. Be sure to review README.txt at the download site to retrieve the proper version.
SCons	tool execution	Using v2.3.
TAP for Windows	IPv6 tunnel driver (Windows only *)	Using v9.9.2. When selecting components, include TAP Utilities as well as the adapter itself. The TUN interface on Windows requires some configuration. Follow our tun/tap for Windows tutorial, specifically the Install tun page and the Configure tun page (perform Computer B steps).
Bottle web framework	UI library (only for web UI)	Using v0.11.6, with Python's WSGI reference web server. Using the built-in template mechanism. Uses several JavaScript/CSS libraries: jQuery v1.10.2, jQueryUI v1.1.0, SlickGrid v2.2 (from this commit), and PocketGrid v1.1.
FTDI USB/Serial driver	serial to mote (e.g. TelosB)
Silicon Labs CP2102 UART-to-USB bridge	serial to mote (e.g. GINA)	For Windows, download CP210x VCP Windows driver. Use the default options. If successful, Windows shows two new programs (Control Panel > Programs > Programs and Features): Silicon Laboratories CP320x USB to UART Bridge (Driver Removal) Silicon Laboratories CP320x VCP Drivers for Windows XP/2003 Server/Vista/7
pytest	unit test tool (unit test only)	Using v2.3.5.

* On Linux, TUN/TAP already is included with the operating system, and OpenVisualizer configures it on the fly. See our TUN/TAP in Linux page for more information.

The --trace option provides internal memory profiling of OpenVisualizer itself, and requires yappi.

Download

Package	Role	Installation Notes
openwsn-sw	OpenVisualizer software	Download zip or clone with Git. Typically, we use the develop branch as our common development base.
openwsn-fw	Firmware header files required by openwsn-sw	Download zip or clone with Git. Must install in a sibling directory to openwsn-sw. So, if software is in `C:\develop\openwsn-sw`, then firmware must be in `C:\develop\openwsn-fw`.