Table of Contents

maxLevel	2

Running it

To start OpenVisualizer, use SCons on the command line:

Code Block
C:\develop\openwsn-sw\software\openvisualizer> scons rungui

Info
Must run

...

as Administrator under Windows, or as superuser on Linux ('sudo').

Prior to August 2013, OpenVisualizer was started via double click on openVisualizerGui.py, or via command line:

Code Block

language	text

C:\develop\openwsn-sw\software\openvisualizer\bin\openVisualizerGui> python openVisualizerGui.py

...

Installation

Package	Role	Installation Notes
Python	implementation language	Using v2.7. v3.x not supported yet.
PySerial	serial to mote	Using v2.6.
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).
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.
FTDI USB/Serial driver	serial to mote (TelosB mote only?)
Silicon Labs CP2102 UART-to-USB bridge	serial to mote (GINA mote only)	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

...

openVisualizerGui.py is the master module. It can be run in "real" or "simulator" mode. It lists all the connected nodes (real or emulated) through a serial port and, for each, spawns a different execution thread.
moteProbe.py contains the code which is executed by each thread. Whenever data is received from the mote, it is passed along to Parser.py.
Parser.py dispatch all the data it receives to respective parser module. In case a frame of Status/Error/ErrorCritical is received from the serial port, ParserInfoErrorCritical.py calls the corresponding display* function from moteState.py. In case it receives a request to send data from a mote (see Serial Format thread in this section), it asks the correct openSerial.py thread to answer accordingly.
moteState.py handles everything which is related to the graphical user interface. It is solely based on TkInter, the graphical interface which ships by default with Python. A single semaphore is used to arbitrate the access to the graphic elements.
openType.py lists the variables which need to be accessed by multiple modules, such as the handlers of the different threads.
StackDefines.py is used by ParserInfoErrorCritical.py to translate error and status code into human-readable text.