Comet Visu

Documentation of the CometVisu Backend

Introduction

This adds a backend for the web based visualization CometVisu (http://www.cometvisu.org). The CometVisu is a highly customizable visualization, that runs in any browser. Despite the existing browser based UI´s in openHAB, the CometVisu does not read the sitemaps. The layout is defined with an XML-based configuration file.

This is just a short overview, more details will be added soon!

Requirements

• openHAB 1.4 or greater
  Note: The latest version can be downloaded from here
• CometVisu 0.8.0 or greater (https://sourceforge.net/projects/openautomation/files/CometVisu/).
  It might be usefull to work with the latest SVN version of CometVisu as well.
  On a Raspberry Pi, the installation of the SVN version works like this:
  

1. Installation of subversion on the RasPi:
   sudo apt-get update
sudo apt-get install subversion
   
2. Download of the CometVisu SVN
   Assumptions: openHAB is installed in the directory openHAB, CometVisu is located in webapps/cometVISU
   cd openHAB/webapps
svn co svn://svn.code.sf.net/p/openautomation/code/CometVisu/trunk/src cometVISU
   
3. For an update later on you just need to do this
   cd openHAB/webapps
svn update cometVISU
   Note: This information ist taken from here. As long as the PHP runtime is not available (see Known Problems), the chmod described there is not required.

Installation

• Copy the addon org.openhab.io.cv*.jar to the openHAB addon folder
• Then just extract the "release" folder (the one which contains the index.html file) of the downloaded CometVisu archive in openHAB´s webapps folder and rename it to, e.g. cometVISU.

Configuration

This is a first small sample implementation. Actually only the items below are implemented:

• number
• switch
• contact
• dimmer

Please feel free to add more items.

Some basic examples:

• ColorItem (will be supported in the next CometVisu-Release 0.8.2) => ` Color
  ITEM_NAME

`

Please note: You have to add the colorchooser plugin in the meta>plugins section of you config

Known problems

Some parts of the CometVisu need a PHP runtime. As this is not included in Jetty, the following parts do not work:

• Editor
• Configuration check
• Configuration upgrade (only needed if you upgrade your CometVisu to a new release)

Currently the only workaround is to build, edit and maintain your CometVisu configuration manually with an XML editor of your choice.

403 error

If you get an 403 - Access Denied error, when you try to open the cometVISU in your browser you have not copied the correct release folder into the webapps/cometVISU/ folder. Please check if there is a subfolder with the exact name "release/", which contains an index.html file and copy the content of this folder in your webapps/cometVISU/ folder.

Screenshots

will be available soon, meanwhile some screenshots can be found here:

• http://knx-user-forum.de/cometvisu/26139-allgemeine-frage-wie-sieht-eure-cv-startseite-aus.html

Links

• German CometVisu Support Forum: http://knx-user-forum.de/cometvisu/
• Some documentation about CometVisu: http://www.cometvisu.org