Questions about using the Basic Z-Wave Tool

I'm waiting for Amazon to deliver a new Z-Wave device that I'm going to have to change quite a few parameters on and was looking at the Basic Z-Wave Tool app.

After loading the Basic Z-Wave Tool driver and saving the device, what is the correct procedure? I'm assuming you just put the parameter number, size, and value information into the correct fields hit the "Set Parameter" button, and then move on to the next parameter. And when done save the device, select the normal device driver, and save again?

I'm asking because I've played around with it with other devices and sometimes wondered if the parameters were changed because there doesn't seem to be any kind of confirmation and I haven't been able to get feedback from any of the other buttons.

More or less. You don't actually need to "Save Device" after using the Tool, just after switching drivers (e.g., to or from the Basic Z-Wave Tool; this button just saves any edits you make in that particular section, "Device Information").

The Tool doesn't give much information in the UI, but "Logs" will show you if the command was sent. If you're unsure about whether a parameter was actually set, use the "Get Configuration Report" command (ideally with a parameter number, otherwise it's going to iterate through every possibility) and check the logs for the output.

2 Likes

You can view the log to check what is happening.
You can also run the report from the device page after you have updated the driver to the basic z-wave tool and see the parameters value in the log.

1 Like

OK, thanks, I'll try that.

Thank you all for the clarification. The tool is pretty slick; however, I did run into one issue.

The device I am working with is the Zooz Zen17. Before installing and modifying anything, I carefully read the manual and noted all the parameters necessary to use the two relays to control two garage door openers and use the relay inputs to monitor two door sensors. At one point during the installation (after changing the relay inputs to sensors rather than triggers), you must exclude and then include the device for the sensor devices to appear as child devices, which I did. So far, so good.

I then reinstalled the Basic Z-Wave Tool Driver to double-check all the parameters and make any changes as not all parameters are accessible with the current driver. The problem is with setting parameters 6 and 9, which auto turn off the relays after a specific time. Parameters 15 and 17 sets that integer to a unit of time. After reapplying those changes, changing the device driver back to the Hubitat driver, those changes did not take, nor was there a button to save preferences before changing the drivers and saving the device.

I performed a workaround by creating a rule to turn off the relay one second after it is turned on to mimic a button press and release, but I would prefer to have the device perform that action. All in all, it makes for a straightforward garage door controller at an affordable price.

You don't need to "save" anything with the Basic Z-Wave Tool. Just running the "Set Configuration Parameter" command should be enough, and you can check success with "Get Configuration Report." If that didn't work, something is wrong--maybe the wrong parameter size. I'd verify number, size, and possible values with the manual (ideally the one that came with your device; sometimes firmware updates change things and there may be multiple versions floating around), though it sounds like you might already be doing that.

In this case, I'd skip the general advice of hitting "Configure" after you switch back to your regular Hubitat driver. Since it's closed-source, we don't know exactly what this does on their ZEN17 driver, but it's possible it could overwrite your custom parameter values with some set of defaults. You could also consider using a custom driver that exposes all of the parameters you want in the first place, which I'm kind of surprised Hubitat's doesn't, though sometimes they just give you the basics and Zooz has a custom driver they recommend for full features. Not sure about this particular device. I have one sitting in a box somewhere I could pull out and write one if needed. :slight_smile:

2 Likes