This page is part of archived documentation for openHAB 2.5. Go to the current stable version

# Insteon Hub Binding v1

DO NOT USE THIS BINDING. It is no longer supported, and has been replaced by the Insteon binding

# 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'). If you have multiple Insteon Hubs, please see the section below on configuring multiple hubs.

################################ 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", and "input_ubyte". 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. For input as a percentage from 0 to 100, use the dimmer bindingType.

Example:

Number Num1 "Depth Sensor" { insteonhub = "device=33.CC.33, bindingType=input_ubyte" }

# input_percent bindingType

To declare a sensor that is mapped to a read-only percent type, you can use the input_percent binding type.

Example:

Number Num1 "Some Analog Sensor" { insteonhub = "device=44.DD.44, bindingType=input_percent" }

# input_on_off bindingType

To declare a sensor that is mapped to a read-only On/Off type, the input_on_off binding type can be used.

Example:

Switch TheSwitch "Some Read-Only Switch" { insteonhub = "device=55.EE.55, bindingType=input_on_off" }

# input_open_closed bindingType

Used to declare a contact sensor. This is a read-only type that translates a device's state to Open/Closed events.

Example:

Contact FrontWindow "Front Window" { insteonhub = "device=66.FF.66, bindingType=input_open_closed" }

# 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" }