[OBSOLETE] Leviton Decora Z-Wave Plus Dimmers (DZ6HD & DZ1KD)

Thanks for reporting the issue @dtm2525. It turns out the device firmware respects the setting only when turning on from device itself. It doesn’t respect it when turning on from app, which I assume is the problem you are experiencing. I’ve just pushed an update to the DTH to explicitly tell the device to turn on to the preset level.


I think I just did the copy/paste route the first time I added your dh…so to get the updated version, I guess I just go and copy the updated code and replace the old?

I’ve added a few DH and smart apps now with GitHub, but still kind of confusing for me to figure out how sometimes. Is there an easier way than trying to figure out the name or author or whatever it is you’re asked for when adding a repo manually before adding a specific dh like this, or can the gh link you provide in your first post be used somehow to link it more efficiently?

A quick search returned this FAQ: Github Integration How to Add and Update from Repositories. Might be helpful as a general guide.

You’ll need 3 pieces of information to add a repository to your SmartThings IDE: owner, (repository) name, branch. When you see a link to a github file, it’s usually in the following structure:

I’ll also update my original post to make it more explicit. Hope this helps.

@jasonxh, thank you for writing this driver. I have a few of these switches around the house, and your code is so much more useful than the generic DTH!

I have a curious issue. I wonder if you have encountered any of it?
I have several DZ6HD, yet none are very stable. One day it’s switch 1 that shows offline in smartthings, the other day it’s switch 2, etc etc.
I often have 3-4 switches offline in smartthings, while the others work fine.
However the offline ones still work from Homebridge (which goes through smartthings by homebridge-smartthings npm !!).
This really makes me wonder if it’s some kind of graphical display status glitch in smartthings. The command actually works if ran (from homebridge for example). But from smartthings, the GUI interface is blocked (not shown), making it impossible to send the command even though it would work…

Is there anything you cam think of that could solve it? I’d be happy to dig into the code as well, but the likelihood of me finding a fix is a lot smaller haha

@cariacou This seems to point to some slight instability with your Z-Wave network or connectivity to SmartThings cloud. The DTH is currently setup to perform a health check every 32 minutes. If SmartThings (cloud) doesn’t hear back from the device in time, it’ll declare it unavailable.

On the one hand, I suggest you check your Z-Wave devices topology and the placement of your SmartThings hub to see if you can move the hub to a more central location or add a repeater. A Z-Wave network repair may help too. On the other hand, I’ve also read that the “Health Check” capability for 3rd party DTH is not mature and thus un-documented. So I’ve pushed an update to disable it for now. Feel free to give it a try.

Jason would you be able to add the dimmer arrows for the dimmer right on the button for turning on/off the light. The pic below is from a GE dimmer with a custom DH. Also big thanks for creating this DH it has been working well for me.

1 Like

Thanks for the suggestion. Added it to the latest version.

1 Like

Awesome thanks for adding it!

1 Like

@jasonxh, Leviton has a non-dimmer version as well, DZ15S (handles motor loads as well for ceiling fans).

How hard would it be to create a DTH for it based on your current one?
I created one for myself by stripping all the dimming functions, but I’m not too sure how to find the parameters such as “Load Type”

This is what I was able to pull from the device:
fingerprint mfr:“001D”, prod:“3401”, model:“0001”, deviceJoinName: “Leviton Decora Z-Wave Plus 15A Dimmer DZ15S”

Another question:
I really liked the slider you had previously to the up/down arrows. Would it be possible to have both?
The up/down arrows are very useful, however don’t give the precision of control that the slider did (1% steps). Not sure how to make that look nice, maybe a vertical scroll bar next to the arrows?

Thank you

The dimmer DH will work exactly the same for the switch with the exception of no dimming capability. I have both the switches and dimmers using the same DH and all functioning properly. I still can set all the additional options like load type and led settings.

The slider was removed by Smartthings, this was not part of the device handler. That actually is the original reason I was asking about the arrows. You can still click on the dimmed percentage to bring up the new dimmer option that Smartthings implemented. I also did notice it is only in 10% increments and not 1%, not sure if this is hard to change or possible.

1 Like

I would be concerned about using it that way. I could not find any official documents documenting the API commands to confirm the programming is the same.
I wouldn’t feel comfortable for example using a motor load (ceiling fan) while programming the switch for LED load type. I’m no electrician but I wouldn’t be surprised if that could create issues.
Using the DZ6HD DTH for a different device would bring you the same GUI interface, but nothing guarantees that setting the LED load type actually does that unfortunately.

I’d be happy to look into it and make the appropriate changes. @jasonxh, how did you find the load type settings? was there any documents you used?

The load type would need to be on the default setting for a motor load anyways, so I would not touch that.

You really should not need to change any settings anyways for a switch, even if load type is not change the switch will functioning properly on the default setting.

Edit: Either way if you or Jason want to add a second handler that would be greatly appreciated also.

Does anyone know how to adjust the companion switches? My companion switches don’t turn off the dimmer LED when the switch is turned off. This makes the main and companion switches different when they are in the same location.

@mjlewis you should be able to find documentation on the z-wave parameters in the device specifications. It’s included in the box, or you can search for its PDF version online. Let me know how it goes with adapting the dth to the switch. I can probably find sometime over the next week to look into it if needed.

@nellering this was a known issue when I started working on this dth. Unfortunately I don’t have an add-on switch to debug it. Not sure what events are triggered by the add-on switch, if any. Might be helpful if you collect and send me some live logging from the dimmer when you press on the add-on switch.

@mjlewis here’s the manual for DZ15S. It has only one configurable option “Locator LED Status”. Looks like it may be sufficiently different from the dimmer. Have you tried the stock generic z-wave switch? Any functional issues other than not being able to configure that option?

I pushed an update earlier today to make the level increment configurable. Cheers.


I am trying to use this device handler. When I try to configure any of the device parameters I get an error message that says “Please fill out all required fields”. I have tried leaving the fields I don’t care about empty and I have also tried filling in every single option and still get this message that won’t let me save them.

Anyone else have this issue?

The only required field is the in-app level increment. It should have been filled with 10 by default. Did you clear it out?

That is filled out and I even tried re-filling it out just in case. It doesn’t seem to matter what I do, it just will not save!

I guess I can try to fill out the information in IDE, just scared to break something…

EDIT: Interesting. I modified your device handler and changed the “levelIncrement” required to false and now it seems to work fine. I checked in IDE and it set the levelIncrement to 10, loadType to LED and presetLevel to 100 which is what I expected to see. Not sure why it was freaking out when it was set to required…

1 Like