How To: Use the Z-Wave Association Tool | Hubitat

How To: Use the Z-Wave Association Tool | Hubitat

Overview


Note: With Z-Wave, the security level for devices that are going to speak with each other via associations need to match. If you have a C-7 hub this means you need to include all of the participating devices at the highest security level that all devices support. If you are going to associate a dimmer or switch with a bulb, you must include them all at either S0 or non-secure in order for them to talk together. This is because the highest level of security that the bulbs support is S0.


The Z-Wave Association Tool is an App that was created to allow our customers to easily create device-to-device “associations” with Inovelli devices and other compatible Z-Wave devices. The tool requires special code to be present in the driver so it will only work with Inovelli devices. Anyone is free to add the code to other drivers though if they would like.

The purpose of a direct association is to have one z-wave device speak directly to another to create something like a “virtual 3-way” between two switches, or have a dimmer be able to directly dim up & down bulbs in real time. The communication is usually much faster than if it were to go through your hub and the hub is not required for the association to work after it is setup. For example, the hub could even be completely shut down and the 3-way or the communication with the bulbs would still work.

Code
The most up-to-date code for the app can be found here. It consists of 2 pieces of code that need to be installed in the “Apps Code” section of Hubitat. One is a parent app and one is a child.

Parent App

Child App


Terminology

Source Device:
This is typically going to be the device that does not have the “load” (or light) attached to it. It is the device that you want to use to control the other device. Generally an Inovelli Switch or Dimmer.

Destination Device:
This is the device that you want to be controlled. If it is in a virtual 3-way, it is the switch or dimmer that has a “load” (light) attached to it. Technically, you can put multiple devices in this group which may be the case if you are trying to control multiple bulbs.

Group
An “association group” is a z-wave concept that lets you define a “group” of devices that are controlled from a “master” device. The groups can have different capabilities, but our devices use these particular groups:
  1. Group 2: Used to send ON / OFF commands to the devices in this group.
  2. Group 4: Used to DIM UP / DIM DOWN devices in this group.
So, when you create an association from a switch to another, you simply need to create an association for group 2. When you create an association for a dimmer device, you configure an association for BOTH groups 2 & 4.

Step By Step Setup

Now that this is defined, below is a simple step by step on how to create an association for ON / OFF.
First, we open the Z-Wave Association Tool app from the “Apps” section of your Hubitat Hub.

image

Next, click on “Create New Association”
image

Then, click the “capability” drop down and choose “Switch / Dimmer / Bulb”. Next, select the source device. Use the terminology above to decide which device you want to be the source. It is the device that you want to use to control the other(s).

image


image

For the destination device, choose “Switch / Dimmer / Bulb” and select your device(s) as needed. Also, use the terminology to determine which devices to choose here. They are typically going to be the devices that you "want to control.

image

Lastly, select the group that you want to use in this association. Group 2 to control ON / OFF or Group 4 to control DIM UP / DIM DOWN.

image

Note: When using a dimmer you are likely going to want to control BOTH ON / OFF & DIMMING. You will need to go through the process shown above again and create a second association for the other group (Group 4).

In the end it would look something like this:

image

That should be it. After a few seconds the app will configure the associations on the “Source” device and you should be able to start enjoying the benefit of direct Z-Wave associations!
    • Related Articles

    • How To: Use the Z-Wave Association Tool | SmartThings

      Overview The Z-Wave Association Tool is a SmartApp that was created to allow our customers to easily create device-to-device “associations” with Inovelli devices and other compatible Z-Wave devices. The tool requires special code to be present in the ...
    • How To: Update Device Firmware (Z-Wave)

      This article is intended for users that are using a separate "Z-Stick" (Z-Wave Controller) than what they have installed in their "hub". This is sometimes necessary if your hub doesn't directly support Z-Wave OTA. For example, SmartThings. There are ...
    • Installation & Setup | LZW31-SN | Dimmer - Red Series (Gen 2) | Hubitat

      This article will walk you through how to setup your Inovelli Dimmer Switch (Red Series) from an in-wall installation to pairing it to your Hubitat Elevation Hub. For more advanced features such as Parameter Configuration, Device Handler ...
    • How To: Hubitat Firmware Upgrade Tool

      Introduction Updating your firmware for Inovelli Devices has never been easier when using Hubitat.  In this article, we will talk you through how to use this tool.   Things you will need Z-Wave Firmware Updater Tool URL ...
    • Installation & Setup | LZW60 | 4-1 Multi-Sensor | Hubitat

      This article will walk you through how to setup your Inovelli 4-1 Multi-Sensor from a physical installation to pairing it to your Hubitat Elevation Hub. For more advanced features such as Parameter Configuration, and Device Handler Installation ...