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 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.

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