GE/Jasco Z-Wave Plus Motion Dimmer Driver
This is a driver for the GE Motion Dimmer device. It differs from the in-box driver in that it exposes all of the device parameters, and uses a parent/child structure to put the dimmer and motion sensors in their own child devices.
It has been tested with a GE 26933 motion dimmer.
Example:
Features:
ON/OFF
Configuration of button inversion variable.
Configuration of motion and light parameters.
Light Off Time, Motion sensor on/off, Motion sensitivity, Light Sensing for light ON/OFF, Motion Reset time, Dimmer steps/duration, Switch Mode
Commands added for direct access to the following features:
Default Dimmer Level - Can use this in rules (via custom commands in RM, for example) to set the default dimmer level. May be useful for mode/time based lighting where you want the light to come on a different level than the level it was at when it was turned off.
Manual / Vacancy / Occupancy motion lighting modes. Can be used in rules (via custom commands in RM, for example) to put motion lighting in Manual mode at night for bedroom switches.
Uses the in-box Dimmer and Motion Sensor component drivers for the child devices - no need to install additional drivers for those.
NOTE 1: Switch Mode simply makes the physical buttons work like a switch. And note that in that mode the physical buttons DO NOT obey the Default Dimmer Level - ON always = 100% level.
1.2.4 (10/17/2020) - Added actuator capability so custom commands can be used in rule machine
1.2.5 (10/27/2020) - Fixed motion reset time parameter setting not working
1.3.0 (02/17/2021) - Removed erroneous duplicate event recording. Added new preference "Wait for device report before updating status.", Fixed a level report timing issue when setting level to 0%.
1.3.1 (02/17/2021) - Added blank selection option to commands to reduce confusion
1.3.2 (02/17/2021) - Forgot to add the "Wait for device report" to everything other than on/off/level
1.3.3 (03/31/2021) - Fixed small issue where on/off states weren't made in rare situations
1.3.4 (04/15/2021) - Fixed defaultDimmerLevel state not populating
1.3.5 (05/24/2021) - Fixed error when setting light timeout to disabled
Always great to see new driver contributions. Before I go and start messing up all my rules redoing everything could you help me understand the benefit of this driver vs one that uses them combined such as the one written by @jrfarrar over at [RELEASE] GE/Jasco 26933 Motion Dimmer Wall Switch Driver I understand that you did the parent/child method to split them out but trying to understand the benefit.
That's the funny part - there is really no benefit at all feature wise.
It makes each device a little cleaner in terms of what commands are shown. And it makes a device with a name that represents what it actually does (xxxx Motion Sensor, xxxx Dimmer). I also cleaned up a lot of the backend code.
But realistically other than that above there is no other "feature" benefit.
SO, when I change my current driver to this spiffed up one.
What will that do to all the rules, etc. that are were written for the CURRENT driver?
Thanks! It looks sweet!
(and I might have to study it to figure out the cool tricks--I have one of those new GE "Dual USB/Dual Controlled outlet" plug-in dimmers that isn't supported yet. I guess they're working on it eventually but, as you can see, they've had higher priorities lately.)
Depends on the rules. If they affect the stuff that moved to the child devices - setLevel, on/off mainly - the rules will need to be redone changing from the old device to the new child device.
For things like vacancy/manual/occupancy/setDefaultDimmerLevel you should be fine, as those are still on the parent device.
I think you should be able to leave the rule changes until after the driver change, as the rules will be pointing to the parent device which still exists.
The rules will be broken at that point, of course, and generate errors if they run as the commands won't exist any more. At least until you update them with the new devices.
Come on, hop on it! What do you think we're paying you for???
Oh. Wait. Darn, I guess we're not.
Bro--this is pretty cool! Thanks! It took a few rule changes, but it's cool to have all the settings available AND to have the functions split into devices so you can have more sensible names.
A few questions:
I guess you can't edit the "Device Name" field, only the "Device Label" in the children? Any idea why that is?
When does it load/refresh the "Current States" list on the parent?
I don't see any "refresh" button on the parent. Is that intentional?
I assume the "Device Watchdog" should point only to the parent?
When I point to the "Dimmer" child on the dashboard, the dashboard throws a big question mark icon up instead of a bulb--but it seems to be happy pointing to the parent. And, I can't turn it on/off regardless of where I point (but the child does adjust the dimmer). Recommendations? Or is it time to call the exterminator?
He has written a command line tool to create the manifest for you just in case you weren't aware.
A small little tool called Hubitat Package Manager Tools has been provided which assists in the creation of these files. On Windows simply run the hpm.exe --help to get help, and on MacOS and Linux run ./hpm --help