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

Previous: Adding Things - Simple

# Adding Things - Intermediate

This section will show an example of dealing with a binding where the bridge Thing cannot be automatically discovered.

Scenario: you have some Z-Wave devices, including a wall plug and a rollershutter module, and a Z-Wave controller stick connected to the computer running openHAB.

# Install the Binding

From Settings, go to Things, then click the blue "+" button.

We need to install the Z-Wave binding. Click "Install More Bindings".

install zwave

Find the Z-Wave binding, click on it, then click Install.

installing zwave

Wait for it to disappear from the list, then go back.

installed zwave

# Create the Bridge Thing

Click on the new option: Z-Wave Binding.

Click on Z-Wave Serial Controller to add the controller.

add zwave controller

We need to specify one required parameter, the serial port. In certain cases, depending on your system, you will be provided with a list of options for this setting.

zwave port config

Choose the correct port, alter the name and/or ID of the controller Thing, then click Add in the top-right corner.

# Discover Things

Once back on the Things screen, click on the "+" button then on Z-Wave Binding again. Click scan and all the devices already paired with the Zwave controller will be discovered and appear in the Inbox. To pair a new device, while on this screen, perform the procedure specific to the device to include it in your network. Go to the add-ons section of this site and search for for the device model in the search bar. The page should give you details on the inclusion procedure. Alternatively, look in the device's documentation from the vendor.

Once included, the device should appear in the Inbox and on the "Add a new Thing: zwave" page.

Approve it in the usual way. Repeat this procedure for every Zwave device.

Note: Battery powered devices will be discovered, but may remain as an "unknown" type until the device has woken up enough for the binding to discover what it is. On its own, this process can take days. To speed up the process activate the device several times until the Thing shows the correct device type.