[DRIVER] Fibaro RGBW Controller 2 (Zooz Zen31 RGBW Dimmer)

jbondc · February 12, 2025, 5:05pm

This driver makes several improvements to the Zen31 driver by @jtp10181.

I wrote it to deal with the various uses cases I have for these devices and improve reliability.

Most importantly, it allows you to choose how child devices are created or you can select 'None' for no child device:

Each child device is created as a dimmer, you can only set the color on the main device.

Full list of improvements:

Added Preference to create "Child Devices": either for 'white' or 'color' (rgb) device.
Using the Configure command will re-create child devices based on 'Child Devices' preference (if changed).
When using an 'Set Effect' or 'Set Scene', the previous RGBW color and dimmer level will be restored once effects are disabled.
Added option to "Child Devices" preference as 'color channels' (1 child device for each color). This is useful in more advanced scenarios where you can use each channel/color as an independent switch or dimmer.
Added flash capability.
Removed 'Quick Refresh' preference and enabled by default.
Driver will immediately request an update from device even if setlevel or on/off isn't complete due to the 'ramp rate' / dimming duration. Very fast response time.
When Input Type (IN1...IN4) is set to 'Analog', this driver will create child devices allowing you to read voltage from inputs (using 'Configure' command)

You can grab the code from github:
Fibaro RGBW Controller 2

Will work on adding to HPM.

bballe · June 11, 2025, 6:04am

Just wanted to say thank you for this! I was struggling to get the Zen31 driver working right for my use case for several days. I stumbled across your driver and got it working exactly how I needed almost immediately.

jbondc · June 12, 2025, 11:03am

thanks! happy to hear its working well for you

marcisak.jozef · June 17, 2025, 6:32pm

Hello @jbondc . First of all, thank you for this driver. But I have one problem. I don't see the parameters setting anywhere. Don't you know where the problem might be?

jbondc · June 21, 2025, 1:13am

Should be under preferences unless you selected the option to "hide parameters"

davethomaspilot · June 23, 2025, 3:27pm

Can you detail what I need to do if I have devices installed with the old driver? E.G., should I first delete all the child devices? Will I need to do a z-wave disassociation first?

davethomaspilot · June 23, 2025, 3:48pm

Maybe I should not have, but I deleted the child devices then changed the driver referenced by the parent device.

Then I did the configure.

But, I see no child devices.

davethomaspilot · June 23, 2025, 3:54pm

Forgot that creating child devices was optional.

Can you explain how it works with and without child devices (I've only used the previous driver from jtp with child devices).

davethomaspilot · June 23, 2025, 5:40pm

So, on my RGB LEDS, I chose to use an RGB child device--but, I'm thinking, why?

On the RGBW LEDS, I added children for both RGB and W. I guess that's necessary for independent control of the the white versus RGB LEDs.

I'll play some to figure it out. What I really want is match the soft white color of surrounding lighting (most of the time), but with the ability to show off by turning the colors to something else. But, then easily go back to the "color matched" soft white.

jbondc · June 24, 2025, 1:54pm

Screenshots would help. All that's needed is to hit the configure button and it will created appropriate child based on what you selected in "Create child devices". I often use "None" if all I want is RGBW control of one LED. You can choose "None" as a way to remove all child devices.

jbondc · June 24, 2025, 7:17pm

In this case, I would choose "None" and use a single/main device.

To give an example/practical use for 4 child devices:

In my home I have a single RGBW device in the basement that where the red channel controls a fireplace white LED, the blue channel controls a white LED in our entrance closet and white channel controls a bookshelf LED... So I have a single device that controls three different LED strips in different locations. The fourth is actually used to open/close a 12v valve...

With 2 child devices, I use the same approach generally to control 2 child devices in different locations.

When I have multiple child devices I never use setColor on the main RGBW device and build all rules to use the child devices.

Sometimes I will on/off the main RGBW device to turn everything off quickly.

J

davethomaspilot · June 24, 2025, 11:41pm

That helps a lot.

If I choose none, I will have controls to set R, G, B, and W? I was thinking the separate child devices were required for RGB versus White with dimmer...

I will try and see.

Thank you!

davethomaspilot · June 26, 2025, 11:54am

Love it!

Thank you.

marcisak.jozef · June 27, 2025, 9:19pm

regardless of the state of this preset, I don't see any parameter settings

user4440 · July 30, 2025, 4:12pm

Hi jbondc,
Just what I needed as well although also having the issue with viewing parameters.
Second issue is the device doesn't show up in apps --> for example adding as a basic button controller.
Tim

user4440 · July 31, 2025, 3:51pm

Hi, Hopefully you can help here as I am having a similar issue and also getting an error if I try to configure after changing the driver to your new driver. here are steps I took

Existing device is Zooz zen 31 using default driver.
Removed all "in Use by" connections.
Pasted your driver from github into new driver code
In existing device selected new driver as type.
After hitting save and waiting a minute selected configure to ensure changes were in device.
Sync Status says 1 Change pending.
Checked log and shows this message
dev:262025-07-31 10:37:10.955 AM
error
java.lang.NullPointerException: Cannot set property 'red' on null object on line 1469 (method configure)

Also "State Variables" don't seem to reflect current state but rather default state. Not sure if that is typical or not?

I also have the issue where parameters are not showing. They were showing with original driver but now nothing shows.?

I am positive this is going to be exactly what I need for my system but need to get past these challenges.

jbondc · August 1, 2025, 1:54am

Thanks for the feedback.

You can try to uncomment the "reconfigure" command which will re-initialize the state.

github.com

jbondc/monami/blob/f906a00599c09c3b0f1d5afec0a0230ee0a33755/hubitat/drivers/fibaro-RGBW-442.groovy#L98


      
          		// https://forum.fibaro.com/topic/55538-user-defined-programs-fgrgbw441m-with-hc3/
          		// 
          		command "setEffectByName", [ [name:"Select Effect*", type: "ENUM", constraints: EFFECT_NAMES] ]
          
          		command "setParameter",[[name:"parameterNumber*",type:"NUMBER", description:"Parameter Number"],
          			[name:"value*",type:"NUMBER", description:"Parameter Value"],
          			[name:"size",type:"NUMBER", description:"Parameter Size"]]
          
          
          		// DEBUGGING
          		// command "reconfigure"
          		// command "test"
          		// command "debugShowVars"
          
          		attribute "white", "string"
          		attribute "syncStatus", "string"
          
          		fingerprint mfr:"010f", prod:"0902", deviceId:"4000", inClusters:"0x5E,0x55,0x98,0x9F,0x56,0x22,0x6C", deviceJoinName:"FIBARO RGBW Controller 2"
          	}
          
          	preferences {

Currently on vacation but will try to address the issues in the upcoming weeks. There's a couple of tests and improvements left to do before I publish the driver.

user4440 · August 1, 2025, 10:43pm

Great. Thanks. Will try that. No rush on other stuff. Enjoy vacation but BTW, you may also want to enable the following capabilities to be able to use the inputs effectively with button controllers etc...
|||capability PushableButton|
|||capability HoldableButton|
|||capability ReleasableButton|
|||capability DoubleTapableButton|