# Heatit Z-wave app (v2.7.1) **URL:** \ **Category:** Apps\ **Tags:** app, z-wave\ **Created:** [August 23, 2018, 6:28am UTC](https://community.homey.app/t/heatit-z-wave-app-v2-7-1/166 "2018-08-23T06:28:34Z")\ **Posts on this page:** 1\ **Showing post:** 3
**Author:** ![TedTolboom](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/tedtolboom/32/12081_2.png) [@TedTolboom](https://community.homey.app/u/TedTolboom)\ **Post date:** [August 23, 2018, 6:29am UTC](https://community.homey.app/t/heatit-z-wave-app-v2-7-1/166/3 "2018-08-23T06:29:11Z")
## Frequently Asked Questions: > ## Create link between the Heatit Z-TRM2fx thermostat and a (Z-Water) relay device: > > There are 2 options to link the Heatit Z-TRM2fx to one of the Z-Water relays: > > - Using flows, with additional logic, within Homey: the easiest to setup and possible to link to any device (independent of protocol), but will add a minor delay (will not matter in most setups) > - via direct associations between the Heatit Z-TRM2fx and the Z-Water relays: direct communication between the two devices on the same network, without involvement of Homey > > How to setup: > > ### Option A. Using flows within Homey > > Create the following 2 flows (basic setup): > > 1. Create the first flow to switch **on** the relay when the Z-TRM2fx goes into active state > **WHEN..** “Thermostat turned on” (Z-TRM2fx thermostat) > ![IMG_1D42159E3C03-1](https://us1.discourse-cdn.com/flex025/uploads/athom/original/2X/1/1956d5153e4672f847044e9074f800c0a846cfff.jpeg) > **THEN..** “Turn on” (Z-Water Relay x) > ![IMG_2F2B1D78D24A-1](https://us1.discourse-cdn.com/flex025/uploads/athom/original/2X/7/77887bf6b71b138750b6954deaccdf25c1e1eff8.jpeg) > 2. Create the second flow to switch **off** the relay when the Z-TRM2fx goes into idle state > **WHEN..** “Thermostat turned off” (Z-TRM2fx thermostat) **THEN..** “Turn off” (Z-Water Relay x) > > By using the logic of Homey’s flows, you can easily expand the flows with adding additional conditions to only turn on the heater when someone is at home. > In that case, you could: > > 1. Create the first flow to switch **on** the relay when the Z-TRM2fx goes into active state > **WHEN..** “Thermostat turned on” (Z-TRM2fx thermostat) > _ **AND..** “Someone is at home” (invert the “Nobody is at home” of Presence"_ > ![IMG_F3E403EA1A35-1](https://us1.discourse-cdn.com/flex025/uploads/athom/original/2X/c/c13672ac48f43bd05bb4e2c213407f41ad27d4b9.jpeg) > **THEN..** “Turn on” (Z-Water Relay x) > 2. Create a third flow: > **WHEN..** “The first person came home” > ![IMG_F3E34A058850-1](https://us1.discourse-cdn.com/flex025/uploads/athom/original/2X/5/5922a93a9511dc1e6ec173490049ab0c5a51a86e.jpeg) > **AND..** “Themostat is on” (Z-TRM2fx thermostat) > ![IMG_1A258652C274-1](https://us1.discourse-cdn.com/flex025/uploads/athom/original/2X/e/e51d70f8aaff10fdc168c36298de67c1414818c3.jpeg) > **THEN..** “Turn on” (Z-Water Relay x) > > You’re all set. Relay 8 of the Z-Water should now switch on when the Z-TRM2fx thermostat changes to the active state, and switch off when the thermostat goes into idle state. > > **Notes:** > > - “Z-Water Relay x” can in this example be any device Homey is able to control: Z-wave / Zigbee / 433Mhz / Wifi > - Adding additional logic is only possible by using Homey’s flows. This is not possible with Direct associations > > ### Option B. Direct association (Z-wave) > > Direct associations are commands send from one Z-wave device to another based on predefined Command Classes. > > **For correct setup:** > > - both devices need to be in the same Z-wave network (share the same controller) **and** need to have the same security state (secured / non-secured). > - Considering the S2 security issues with the Z-TRM2fx and the Z-Water, it is highly recommended to re-include both devices non-securely based on the BETA branch of the Heatit app (\> 2.3.0 release). > > To setup the right association between both devices > > 1. Lookup the `Device ID` of the Z-water regulator by going to device settings \> Advanced settings \> Z-wave Device Information \> Device ID. In this example I will assume `Device ID` is `128` > 2. The individual relays can be controlled by sending a command to the corresponding endpoint of the Z-water regulators `Device ID`. So relay 1 corresponds to endpoint `128.1`, relay 2 corresponds to `128.2`, so relay x corresponds to `128.x` > 3. To setup the correct direct association, go to the device settings of the Z-TRM2fx thermostat you’d like to control that specific relay: Z-TRM2fx thermostat \> device settings \> Advanced settings \> Associations \> Group 4 > 4. Add the desired endpoint to Group 4. You should not remove the 1 which is already present; so if you want to add relay 1 of the Z-water device with Device ID `128`, update the content of Group 4 to `1,128.1` (no space in between). > ![IMG_F1AE04D123DC-1](https://us1.discourse-cdn.com/flex025/uploads/athom/original/2X/9/98623a00b5eb0a89c05c0117a176a8e31c99cd22.jpeg) > 5. Press \ ![IMG_D6131F2DF865-1](https://us1.discourse-cdn.com/flex025/uploads/athom/original/2X/4/4ce9840c63e9ceac280a80b402d093ea9772a86f.jpeg) > 6. Press ✔ at the top right of the screen (next to the **Advanced settings** title) to save the associations > > You’re all set. Relay 1 of the Z-Water should not switch on when the Z-TRM2fx thermostat changes to the active state, and switch off when the thermostat goes into idle state. > [@TedTolboom](#): > > ## How to re-include the Z-TRM2fx non-secure to Homey > > Note: similar approach can be followed for the Z-Water and Z-relay > > - Install v2.3.0 BETA version of the app > - Move Homey to close proximity of the thermostat (Homey does not support inclusion of the network) and wait sufficient time before Homey finished starting up all apps (~ 30 minutes. > - If multiple thermostats need to be re-included, connect Homey to a powerfull enough powerbank and move it around. > > - Remove the thermostat from Homey, by going to ‘device settings’ \> ‘Remove device’ and follow the instructions (mind updated step 5): > > > 1. Press the Center (confirm) button for 10 seconds. The display will show OFF. > > 2. Press Right(down) button 5 times till you see Con in the display. > > 3. Now start to remove the device from Homey. > > 4. Start exclusion mode by pressing Center(confirm) button for approximately 2 seconds. The inclusion / exclusion icon will appear in the display. > > 5. Confirmation will show EcL in the display. > > When Err(error) appears, check if the thermostat has been removed from Homey. If so, reset the thermostat according to the instructions of the manual. Otherwise repeat the exclusion. > > - After removal from Homey, manually reset the thermostat by pressing the right 2 buttons of the thermostat for 20 second, during the last few seconds `res` will be shown in the display. > - Set Homey in inclusion mode by _ **only** _ using the following method `Add device > Heatit > Z-TRM2fx` , the specific Z-TRM2fx inclusion instructions should be shown > - _Don’t use the generic option_ `Add device > Homey > Z-wave` , _since it will not overrule the default secure inclusion!_ > > - Re-include the thermostat to Homey by following the inclusion instructions (mind the addition in step 5): > > > 1. press the Center (confirm) button for 10 seconds. The display will show OFF. > > 2. Press Right(down) button 5 times till you see Con in the display. > > 3. Now start add a device to Homey. > > 4. Start inclusion mode by pressing Center(confirm) button for approximately 2 seconds. The inclusion / exclusion icon will appear in the display. > > 5. Confirmation will show `Inc` in the display. > > If `Err` (error) is shown on the thermostat display, inclusion might still be successfull; check the functioning of the newly added device. > ## How do I add other devices to the association groups of the Heat-it Z-push button devices > > According to the manual: > > > Set association by operating primary controller/gateway to send association command to the remote control: > > When set association from primary controller/gateway, the remote control shall be activated first, if it is not activated, you should activate it manually. > > The primary controller/gateway sends association command to the remote control using “Command Class ASSOCIATION” or “Command Class Multi Channel Association” > > It all comes down to timing of the actions… Since the device will only be awake (able to receive new settings) for 5 seconds. > Otherwise the changed settings should be communicated with the next wake-up, which could take up to 28800 seconds (wake-up interval). > > Follow the next steps to create a direct association between Z-push button and another device in Homey’s network: > **in Z-wave developer tools:** > > 1. Open the Z-wave developer tools at: [Homey Developer Tools](https://developer.athom.com/tools/zwave) > 2. Enable logging and filter on `Node[151]: Marked as o` where 151 is the node ID of the Z-push button device > 3. Press and hold the ‘I’ and ‘O’ of group 2 (upper rockers) for 3 seconds; you now should see a ‘_Node[151]: Marked as online_’ log followed by a ‘_Node[151]: Marked as offline_’ log 5 seconds later > 4. Look-up the Node ID of to be associated device, visible in the Nodes overview on the same page, in this example 221 (a Fibaro Dimmer-2) > > **in the Homey app:** > > 1. Open the device settings of the Z-push button device, go to Advanced settings > 2. In the Advanced settings, go to the associations section and check which button group you want to add the Fibaro Dimmer-2 to. Upper rockers = Group 2 > 3. Add the node ID of the Fibaro Dimmer-2 (221) to the the desired group, in this example add 221 to Group 2 > ![IMG_2028](https://us1.discourse-cdn.com/flex025/uploads/athom/original/2X/d/d1947593dd57e6010993959b5a6c9d624c228610.jpeg) > 4. press ‘\< Advanced settings’ to go back to the Advanced settings > ![IMG_2029](https://us1.discourse-cdn.com/flex025/uploads/athom/original/2X/9/9c3cdc07b853b69a7bb28140ab93ef9af399a071.jpeg) > 5. **Here comes the tricky part;** keep an eye on the filtered Z-wave log and press and hold the ‘I’ and ‘O’ of group 2 (upper rockers) for 3 seconds to wake-up the Z-push button. > 6. Once you see the ‘_Node[151]: Marked as online_’ in the Z-wave log of the developers tools, press the check mark at the top right side of the Advanced settings to save the settings to the device > 7. if the timing is right, you should see the green banner: ‘_Settings were saved_’ > ![IMG_2032](https://us1.discourse-cdn.com/flex025/uploads/athom/original/2X/9/9ef0b628759309dfecd859ba403ab886e42cfb65.jpeg) > And you should be able to control the dimmer-2 from the Z-push button device > > **in Z-wave developer tools:** > > 1. in the (unfiltered) Z-wave log, you can verify that the command was send successfully: > ‘_Node[151]: sendData to COMMAND\_CLASS\_MULTI\_CHANNEL\_ASSOCIATION, params 0x0102dd_’ > Here: the ‘params’ can be devided into: _01_ = SET, _02_ = Group 2, _dd_ = 0xdd = 221 --- _[View the full topic](https://community.homey.app/t/heatit-z-wave-app-v2-7-1/166)._