Insteon Hub Binding

Documentation of the Insteon Hub binding bundle

Note: This binding will only be available in openHAB version 1.4.0 or higher!

Introduction

For installation of the binding, please see Wiki page Bindings.

Configuring the binding

If you only have one Insteon Hub, configure the following values in the openhab.cfg file (in the folder '${openhab_home}/configurations').

################################ Insteon Hub Binding #########################################

insteonhub:host=10.0.0.2

Items Configuration

All item configurations require a device property to be defined. This device property is 3-bytes and is defined in hex notation (example: 12.AB.34). An easy way to find a device's ID is by using the Insteon app.

In addition to the device, a bindingType property needs to be defined. Valid types are "dimmer", "switch", "input_ubyte", and "input_percent". The following sections define these types in greater detail.

dimmer bindingType

The dimmer bindingType supports Dimmer and Rollershutter item types.

Example for Dimmer: Dimmer Dim1 "Kitchen Lights" { insteonhub = "device=12.AB.34, bindingType=dimmer" }

Example for Rollershutter: Rollershutter RS1 "My Rollershutter" { insteonhub = "device=11.AA.11, bindingType=dimmer" }

switch bindingType

Example: Switch Sw1 "Basement Lights" { insteonhub = "device=22.BB.22, bindingType=switch" }

input_ubyte bindingType

Insteon reports analog device values as a number from 0 to 255. input_ubyte reports this value of the associated device as a Number to the openhab bus. This bindingType is read-only.

Example: Number Num1 "Depth Sensor" { insteonhub = "device=22.BB.22, bindingType=input_ubyte" }

input_percent bindingType

Insteon reports analog device values as a number from 0 to 255. input_percent scales this number to a range of 0 to 100 and reports this value as a number on the openhab bus. This bindingType is read-only.

Example: Number Num1 "Depth Sensor" { insteonhub = "device=22.BB.22, bindingType=input_percent" }

Multiple Hubs

If you need to support multiple Insteon Hubs, you can optionally configure them in the openhab.cfg file with unique IDs

################################ Insteon Hub Binding #########################################

insteonhub:FIRST_HUB.host=10.0.0.2
insteonhub:HUB_2.host=10.0.0.3

When configuring for multiple hubs, you will need to specify the hub ID in the item configurations. Here is an example:

Dimmer Dim1 "Kitchen Lights" { insteonhub = "device=12.AB.34, bindingType=dimmer, hubid=FIRST_HUB" }