I am trying to integrate multiple Aqara H2 US dimmer switches into Home Assistant. I have reconfigured the firmware for Zigbee protocol and am able to pair with ZHA (Zigbee Home Assistant). Seems that the Home Assistant integration only supports “on/off” functions but not a slider or dimmer function. Does anyone know how this could be changed to add dimmer?
@mark136 It sounds like you’re encountering a limitation with the Zigbee protocol integration in Home Assistant. From the compatibility details, the Aqara Dimmer Switch H2 US supports Home Assistant integration primarily via the Matter protocol rather than Zigbee mode. In Zigbee mode (over Bridge), the supported platforms focus on ecosystems like HomeKit, Google, and Alexa, while Home Assistant is explicitly listed under Matter compatibility .
Since you’re currently using Zigbee with ZHA, the dimming function might not be fully exposed. You could try switching to Matter mode (ensure you have a Matter-compatible Thread border router, like Aqara Hub M3) and re-pairing the switch with Home Assistant via Matter. This may unlock the dimming slider functionality, as Matter is designed for broader smart home interoperability.
If the issue persists after trying Matter mode, feel free to Contact the Aqara Home App Customer Service Team (Profile> Help & Feedback > Customer Service) or scan the QR code:
This will be more efficient. If you do not have an Aqara Home account, “Please click here” to create a ticket. We apologize for any inconvenience caused.
2 Likes
This is great information to know. I was not aware of the Zigbee limitation, and recently installed my dimmer switch.
@432_38th_street Glad this info helped! It’s totally normal to run into protocol nuances when setting up smart devices—thanks for sharing your experience with the dimmer switch install. If you run into any other hiccups or have more tips to pass along, feel free to post here—I’m sure others (including me!) would love to hear it
1 Like
I finally got some additional help from Home Assistant GitHub. See below…
Aqara H2 US true dimmer support using Zigbee ZHA without Aqara hub
Took me a bunch of time figure out how to get Aqara H2 US interfaced to zha to work in “dimmer” mode vs just on/off switch. I needed to add a python quirk file to ZHA. Hopefully Aqara will provide this support out of the box at some point but I fear that they may just want to sell more hubs to people. In any case, I was happy to find this one on the HA GitHub site… Keep in mind you need to use the Aqara app to switch to the Zigbee device firmware first and then pair it with ZHA but install the quirk file below first.
This also took a little extra tuning to get device names properly aligned before it worked for me (with a little help from Gemini…)
1 Like