Hi everyone,
I'm trying to get a Sonoff MINI-ZBDIM working with a one way momentary (spring return) wall switch in Home Assistant using ZHA.
Setup
Home Assistant
ZHA
Sonoff MINI-ZBDIM
Nabu Casa ZBT-2
Single momentary push button (spring return)
Push button connected between L and S1
What works
The dimmer itself works perfectly from Home Assistant:
ON/OFF works
Dimming up/down works
So the load, dimmer, Zigbee communication and HA integration all seem to be functioning correctly.
Switch mode testing
The MINI-ZBDIM appears to have three switch modes which are changed by pressing the button on the dimmer three times.
Mode 1
Behaves like a standard latching rocker switch.
Since I'm using a momentary switch:
Press and hold = light turns OFF
Release = light turns ON again
This behavior is expected for a rocker-switch mode.
Mode 2 and Mode 3
I cannot identify any difference between these two modes.
With the push button connected to S1:
Short press → nothing happens
Double press → nothing happens
Triple press → nothing happens
Hold button → brightness increases
Release button → brightness remains at current level
Hold again → brightness increases again
It never changes direction and never dims down
It never turns the light OFF
Additional test
I moved the exact same wire from S1 to S2 without changing switch mode.
Result:
Holding the button now dims down
Short presses still do nothing
So it appears that:
S1 only dims up
S2 only dims down
Question
Has anyone successfully used a MINI-ZBDIM with a single momentary switch in ZHA?
Is there a hidden configuration parameter (trigger mode, external switch mode, manufacturer cluster, etc.) that ZHA does not expose?
At the moment it feels like the dimmer detects the button input, but only interprets it as "brightness up" on S1 and "brightness down" on S2.
Any help would be greatly appreciated.
Thanks!
Hi,
Same thing happens to me.
I tried making a jumper between S1 and S2, now in one mode it turns on and off with a single touch. But this way it doesn't adjust the brightness.
In the ZHA configuration there is no option to set the wall switch.
I used the quirk from PR #4745 and can confirm that it loads correctly on Home Assistant 2026.6.4 with ZHA 1.4.1.
Initially I got:
TypeError: got multiple values for keyword argument 'manufacturer'
when trying to change External Trigger Mode.
After creating a custom quirk based on the PR version and adjusting the manufacturer/manufacturer_code handling, the quirk loaded correctly and I was able to select Pulse, Edge, Double pulse and Triple pulse without errors.
My MINI-ZBDIM is now working with a momentary switch.
Thanks to the original authors of the quirk for making this possible.
Just for sake of having an answer recorded, since I hit the same issue.
Regarding the quirk from PR #4745, I followed the discussion in the PR, and eventually located a similar quirk script from the Sonoff guys at this page (MINI-ZBDIM-SONOFF Help Center). Scroll down to “If you wish to get full functionality in ZHA, please merge this script into HA”. The script is a quirk, so you have to put it in your quirks folder. (And restart.)
It looks like MINI-ZBDIM support is almost in (maybe now actually in?) mainline ZHA. But I’m running about a year-old version, and I don’t want to risk an upgrade right now. So you may not actually need even step 1. But because my HASS/ZHA is quite old, the script needed modifying to load correctly. That was a simple matter of deleting all lines with “manufacturer_code=None,”.
I suspect the main reason for your actual issue (it not dimming/brightening on press-and-hold) was the need for a firmware update. Out of the box, my ZBDIMs didn’t do that, but after the update, they did. Again my older version of ZHA didn’t integrate the current ZB OTA firmware folders, so I had to patch in that too. See Orange-GT3’s post in this discussion Home Assistant ZHA OTA update guide 2026 - #2 by Orange-GT3.