[OBSOLETE] Z-Wave Tweaker

Lol. Well that was unfortunate. I tried setting up the association the other way too and that didn’t work. So I excluded both switches and added them back. I tried to do the association the exact same as I did before and it didn’t work. I set up the mirror for now. I will try again in the morning.

1 Like

I recently retired and decided I was going to modernize my Condo by adding some smart switches for the Lighting and possibly move on from there. I decided to use a SmartThings Hub and ended up selecting Eaton Switches. It stated out pretty well, I installed 3 of the Eaton RF9640 Z-Wave Plus Wireless Universal Dimmer switches and everything went well. Then I moved on to a three way switch and started installing the RF9601 Z-Wave Plus Wireless Switch along with the RF9617 Z-Wave Plus Accessory Switch. After about 3 days of playing around with wiring and the Hub for these two switches I finally discovered through some research that I need to associate the RF9617 Switch with the RF9601 Switch and the Samsung Hub would not associate the two switches. Further research lead me to this community. I have no experience writing code but would like to use Z-Wave Tweaker. Next, I hate to admit, but don’t know how to set up / install the Z-Wave Tweaker. I have read through the instructions and don’t understand how I get the Z-Wave Tweaker installed.

Start with the following FAQ and see if it helps. It will explain the basic concepts and Terminology.

The Tweaker is a custom DTH which you are going to install and then temporarIly use for your accessory switch, just long enough to get the settings right and saved in the switch itself. Then you will go back to using the regular DTH for the accessory switch. But start by reading the FAQ, it will explain, among other things, what a DTH is. :sunglasses:

Thank You for responding. Again, i am novice and will ask dumb questions. I have been reading and my first question is do I copy all 2713 lines of code and paste into the Device Handler?

I think I have gotten to the point where I need to set the Scan Ranges, Association Groups etc for the RF9617 Accessory. Are these settings available somewhere? I am not sure what the settings should be?

See the following thread, it discusses the same combination of devices that you have:

Z-Wave RF associations

The GUI is not showing up so I can scan. Just to confirm, is the Z-Wave-tweaker.groovy the only code I copy and paste under Device Handlers?
Also, I do not have the classic app

FYI - the classic app no longer works even if you had it. Mine just loads a support page and shows info on the new app.

Not sure how the developer is going to handle the new app but it would be nice if there was an update to support the new version.

Can anyone please confirm that I have copied the correct code to my Device Handler?

I really appreciate the help that many of you have given a inexperienced newbie. Maybe I am doing something wrong, but I can’t get the GUI to show up. I have done my best to follow all the steps. Really don’t know if this appropriate, but is there anyone that is available to call and help me identify what I am missing. Hoping that it would be quicker, to talk vs writing text back and forth. If so, let me know and I will share my phone number.

I can’t help with the code due to my vision issues, but why don’t you try posting in the link I already gave you:

The author of that thread has the same devices you have and was successfully using the Z wave tweaker with them last week. You could at least ask if they had to have the classic app to make it work.

Michael, I have the same Eaton 9601 and 9617 Switches that you mentioned in your note. I have a Samsung SmartThings Hub (1), am using the SmartThings app (2), have pasted the groovy code (3) into the Device Handler (4) and then edited and added Z Wave-Tweaker to the Hall Light (9617 Accessory Switch) (5). I have went through this process numerous times along with excluding the switches and adding them back to the Hub. However, I can’t seem to get the Tweaker GUI to load. I feel like I am going in circles and missing something really simple. Any help / recommendations you can provide would be appreciated.

(1) Hub

(2)App Screen 1: App Screen 2




This is what I see when I go my Mobile SmartThings App.

Mobile Device Tweaker

Tagging @jkp @caldude

1 Like

That’s all you will see with the tweaker - it has no working UI in detail view in Newapp - only settings.

What you’re probably looking for is while in the details view - right where you already are - under the three dot menu on the top right, then ‘settings’ like this:

Typically you will associate the target device ID you want to control with Association Group 2 on the device that will be the controller.


Yes, that is what I see. Once I add the target device and the Association Group 2, what is next? I am a newbie with a total of 5 days experience and would like to understand the other settings and how to update, when necessary. Do you have some material you could share that would educate me? Also, if there are two or three target devices, do I need to input anything other than each of the device network ID’s under the Asdociation Group Members? For example my device ID’S are 15 and 14 for the accessory switches with the universal switch ID being 13. How would I type this in under the Association Group Members?

When you find a link to github, there will normally be a code file there, which is the groovy file that you copied into your own account, and a read.me file, which will have the instructions for how to use that code.

In this case:

When you follow the instructions there for setting associations, it tells you that you can list multiple group members, separated by a “,“. These are your multiple targets.

Then in step four, it says:

Tap Done . The change will now be synced with the device, when complete, the Sync tile should turn green.
In the IDE, you should see the old members and the new members displayed:

There are also some troubleshooting steps if you need them.

But basically if you just open the read.me for the tweaker, read the instructions there, and follow them, you should be all set. :sunglasses:

1 Like

Thanks Again, you have been so very helpful. Because I am using the new SmartThings App the Main Screen that I see does not have the same appearance that is in codersaur’s initial post. The view I see is the same as the view that Nathan Curtis had attached in his response to me.

I went back and re-read a previous post from Michael Chance Jr. that you had referenced in one your notes to me. He had been using the same Eaton Switches and his situation was very similar to mine. In one of his responses, he discussed how he got his switches working in the note below.

So I got my stuff to work. @JDRoberts, thank you for all your explanations. I just had to read through a few of your posts to get it figured out.

@And238 I have the same switches as you and this is what I did.

  1. excluded them both from my hub and added them back

  2. find device ID of 9601 (in my case 2a)

  3. change device handler of 9617 to tweaker

  4. change group to 2

  5. add my device ID of 2a to group members (note, I just added the ID for the 9601 switch and not the 9617 switch)

  6. save

  7. change handler of 9617 back to “Z-Wave Device”

  8. rejoice loudly as my switches now work

One additional note: If the accessory is off and the master is on, I have to press the accessory twice. I am not sure if this can be corrected. I think what is happening is that the master is not updating the accessory with its status. Does anyone know how to change this?

Is this the approach I should take to get my identical Eaton switches to work?


You use the tweaker to associate a target, or multiple targets, to a single trigger. The association is saved in the firmware of the trigger device.

If you want to associate that same target device with two different trigger Devices in a four-way set up, you will need to use the tweaker twice, once for each trigger device.

Let’s back up a step and maybe it will make it easier to understand. All that Z wave direct association does is give a trigger device permission to talk directly to a target device without telling the hub about it. Literally that’s all there is to it.

The target device doesn’t even have to know that the command is coming from the trigger instead of the hub. Since it’s coming over the network, the target device is going to accept it.

But direct association gives the trigger permission to send a command straight to the target without going through the hub. That’s why direct association will work even if the hub itself is off-line.

So, knowing that, what is the tweaker for?

When working with associations, the tweaker lets us tell the trigger device Which targets it has permission to talk directly to. Those targets are all considered to be one “group“ If the trigger is going to send them the same message at the same time.

It is possible for a trigger to have multiple association groups, but those are usually sensors where they will, for example, send a tamper alert to one target device and a movement detected alert to a different target device.

If you had a light switch that was designed by the manufacturer to use double tap and triple tap differently, it might use two different association groups for that. But most of the time a zwave plus device will use association group one for some special “lifeline“ communications with the hub and association group two for its usual targets. The user manual for the trigger device should tell you what association groups to use for what purposes.

Example 1: One Trigger, Multiple Targets

So let’s say I have a Z wave switch at the top of the stairs which is the trigger. I want it to send a basic Z wave command (“basic” has a specific meaning in this context) to zwave switch in the living room, a zwave switch in the entryway, and a Z wave switch in the dining room. These are the three areas at the base of the stairs. Each is on a different circuit. But I want to be able to Press one switch at the top of the stairs, my trigger switch, and have all three switches at the bottom of the stairs, my Group of targets, all come on at the same time. Or All go off at the same time.

Let’s say the network IDs are as follows: the entryway is device 003, The living room is device 007, and the dining room is device 01A.

So I am going to use the tweaker to tell the trigger device to put devices 003, 007, and 01A into its group 2. That’s it, that’s all there is to it. A single trigger is directly associated with one or more targets.

Example 2: One Target, Multiple Triggers

If you want to have multiple triggers for the same target, you just use the tweaker separately for each trigger device.

So now suppose that the living room from example 1 is a big room and it has both the original master switch, device 007, and another accessory switch over on the far wall, which happens to be device 008.

OK, I need to tell that other accessory switch, device 008, that it has permission to talk directly to the living room master switch, device 007, without going through the hub.

So I’m going to use the tweaker again, starting from the beginning. I will use the IDE to switch the DTH for device 008 to be the tweaker.

I will go into the app and go to the details page for device 008 and I will add device 007 to its group 2 to create the direct association that will be saved in the firmware for device 008.

Now when you physically turn on the accessory switch in the living room, device 008, the master switch in the living room, device 007, will also turn on and the light fixture will turn on.

I hope that makes things clearer. Just remember that direct associations are stored in the trigger device itself and tell it which other devices it has permission to send commands directly to without going through the hub. That’s really all there is to it. :sunglasses:

1 Like

Sorry I am not available for a call - but I’ll still help as I can. But I don’t think it’ll be necessary.

What you’re seeing is a difference in the old Smartthings app (we lovingly refer to as ‘Classic’ and the new Smartthings app (I not so lovingly refer to as NewApp) As a newbie you jumped in right in the middle of a transition between platforms (Yay fun!)

Classic allowed full customization of the UI. You can tell Classic apart from New by the big blue/green blocky headers and gray on white icons. Newapp will ultimately allow these customizations - but it’s simply not there yet. So the customizations that make that ‘main’ page show up - just simply are not possible yet. At the rate SmartThings is progressing, with those features my best guess (I don’t have insider knowledge, just 25 years in IT and most of those in enterprise commercial product support) to UI customization parity is sometime late this year - but there’s other technical considerations as well I won’t bore you with…

For your purposes - assume the UI you’re seeing there (with the blue box at the top) is Classic UI and will NOT be available to you anytime soon. When you see someone ask ‘Has this been updated for Newapp?’ or ‘When will this work with NewApp?’ This is exactly what they’re asking…

But, the settings section still works for the Tweaker - and for some cases is the only way to access these settings unless a developer has written a custom device handler that exposes them. That’s why Tweaker still exists - albeit in it’s limited form.

Your approach in the earlier post is sound - and should be all you need, and once you have your switch setup - you shouldn’t have to worry about the Tweaker anymore unless you need to edit the config later (replace a switch, etc.) And reading some of JD’s posts and the offshoots I don’t thin you’ll be able to do much with the doubletap on the remote switch to wake it up…

All of that to say - Honestly - I wouldn’t go down the rabbit hole for this - its an advanced configuration that not many people at all have to do - you just happened to run into it on your first project. I’ve been using ST for over 5 years and only ever needed it a half dozen times. It’s great for what it does - but it does need updates - and those are waiting on features the ST dev team hasn’t provided yet. There’s much better things to go down the rabbit hole on. :slight_smile:

Once those features and abilities to deliver the custom buttons, etc. exist - I have no doubt someone will perform the edits and bring the tweaker UI into newapp…