ZWave Product Database OH2

This page describes the XML product database used within HABmin for defining the Z-Wave devices. The database itself is not part of HABmin, but is linked into the Z-Wave binding to ensure that it is version controlled - errors in the database can cause problems with the device or binding operation. Modifications therefore need to be made to the database, and the binding recompiled.

Adding devices to the database

You are encouraged to add your devices to the database and submit a pull request. If you are not comfortable submitting a PR, then please generate the XML files and raise an issue, pasting the XML into the issue.

Database Structure

The database uses the standard ESH format - this document describes the customisation employed withing the ZWave binding to define ZWave devices.

Label Conventions

HTML Short first line

Thing Properties

defaultAssociationGroups

Channel Properties

Channels are defined as follows.

<properties>
<property name="endpoint">0</property>
<property name="commandClass">SWITCH_MULTILEVEL,BASIC</property>
<property name="commandClass:restoreLastValue">true</property>
</properties>

Property Name	Description
endpoint
commandClass	Defines the applicable ZWave command classes for this channel. It should be noted that multiple command classes can be defined if necessary, in which case they should be separated by a comma. Note that the order is important because the binding will use the first named class for sending any command. In the above example SWITCH_MULTILEVEL,BASIC means that messages from both the SWITCH_MULTILEVEL and BASIC command classes will be used to set the state, but when sending commands to the device, the SWITCH_MULTILEVEL class will be used.
commandClass:arg	Defines an argument to be passed into the command class converter. Arguments are defined below.

Command Classes

Command Class	Description
SWITCH_MULTILEVEL	Used to bind directly to a DIMMER. Options: invertPercent invertState

Configuration Parameters

Defaults should be usable defaults - not just what the manufacturer sets!