Aqara wall switch - Trying to setup on / off functionality AND changing scenes

Hello,

I have one of these Aqara wall switches

I’ve set this up in HA with ZHA, and it appears like this:

This lists lots of triggers:

One of the switches is wired to a physical light. The other switch is configured to turn on and off some smart bulbs. This works great.

What I’d like to do, though, is:

  • Press button to turn on / off bulb
  • Double press / hold (just some other action) the same button to change scene

From what I can tell, this isn’t possible, as any press will either turn the switch on or off.

Is there some way of achieving what I’d like?

Thanks!

I think you need to set it to decoupled mode, but in your screen shot I don’t see that setting anywhere.

You might want to unpair it and re-pair it again as the Unknown values seem to indicate that it didn’t have a successful interview. AFAIK, all of the Aqara rockers support decoupled mode.

From having a look, the suggestion is decoupled mode is only in zigbee2mqtt.

I’m running ZHA.

I was afraid of that. I was looking through Blakadder to see if there was a way to flip that from ZHA. The best I can figure would be to send a command to the cluster directly (or use the manage clusters interface, BUT… it will kill the ability to toggle on and off the physical light that is connected to the switch.

Might also be able to do it with a custom quirk, but I’m not sure if that would be of use to you or not.

Sorry I couldn’t be more help here.

Found it in ZHA. I now have the physical light switch set to coupled, and the other one set to decoupled. The physical lights still work fine.

Is the decoupled stuff the key to doing double presses and the like?

2 Likes

Nicely done! Yeah. basically what you should get now in the logbook is what action the switch performed (on the decoupled paddle) when you do things like single click, double click, etc. Then, you can write automations to capture those events.

1 Like

Amazing. Thank you for your help.

1 Like

Since these are switches, not buttons, I’m not sure you’re going to get very far.

How did you get on?

I was hoping you might be able to help me, I’m a noob (1 week old HA). I’m planning on trying to do something similar and i’m on ZHA. What i want to do is go from this.

To something like this.

Can you explain in very simple terms what i steps i would need to do to get this working in ZHA.

Any help, suggestions very much appreciated.

Hello. Yep. Everything worked fine as soon as I got decoupled mode working.

In terms of getting things working per your diagram:

  1. Install the switches and wire correctly
  2. Add switches to HA via ZHA. By default, they’ll probably be in “coupled” mode
  3. To set decoupled mode in ZHA, you need to select the switch and select “manage zigbee device”:

That brings up this menu:

  1. From here, you can set decoupled mode by selecting one of the *OppleSwitchCluster* entries. There should be one for each “button / gang” on the light switch.

  2. You need to find the correct one for the button you want and then select it’s operation mode and give it the value seen here:
    226e47d2f3c33274f46ddb5bf20fd2c768506cb7_2_585x499

  3. Then you would create your automations. Whichever light switch you want defines the WHEN bit:

  4. …and then you select your light bulbs and give them whatever action you want:

2 Likes

Thank you so much, i feel a lot more confident in buying the switches now.

Hello everyone,

I recently installed Aqara H1 EU switches with a neutral wire (model WS-EUK02) and integrated them into my Home Assistant Green setup running version 2025.1.4 using the ZHA (Zigbee Home Automation) integration. Initially, everything seemed to work fine as the switches were able to toggle the relay on and off without any issues.

Following a guide, I attempted to switch them to “decoupled” mode by:

  1. Selecting the switch in ZHA and choosing “Manage Zigbee Device”.
  2. Looking for the OppleSwitchCluster entries corresponding to each button/gang on the switch.
  3. Trying to set the operation_mode attribute as specified.

However, I’m encountering an issue:

  • Missing OppleSwitchCluster Entry: I cannot find any entries named OppleSwitchCluster in the device settings.
  • No operation_mode Attribute: After searching through all available entries, the operation_mode attribute is nowhere to be found.

I have double-checked all possible entries and ensured that the switches are correctly wired and added to ZHA. Has anyone else experienced this issue? Is there a possibility that an update in Home Assistant or the ZHA integration has changed the configuration process for these switches?

Have you seen this for the H1 EU? Seems to work for others if you select the Type: in cluster

Ok, that’s really strange. I saw your response, @ShadowFist, but it didn’t resolve my issue. I tried several things, including removing and re-adding the Zigbee coordinator (I’m using a Sonoff dongle). At one point, I noticed something curious—I have four Awara H1 switches: two single rockers and two double rockers. I observed that two of them actually have the OppleSwitchCluster cluster type, while the other two do not. That’s really weird, I thought. I also noticed that the device cards and signatures look different, as shown in the attached screenshot.

What actually worked was removing and re-adding the Zigbee coordinator, which erased the network data, removing all devices initially loaded with coordinator, and then putting all these switches into pairing mode WITHOUT opening the “+ADD DEVICE” submenu. The switch devices started appearing in the Devices section one by one, and they are all properly configured now—all have the OppleSwitchCluster cluster type and other properties. When I tried adding these devices via the “+ADD DEVICE” submenu, they were not properly initialized and were missing the OppleSwitchCluster cluster type. So it’s super weird, but I eventually got it working.

1 Like

Having the same issue,when you said, removing the zigbee coordinator do you mean ZHA? I feel too far into ZHA to remove it, lol. 27 Devices but I dont remember whats paired to what, lol.

Either way, thanks for this post

When I mentioned “removing Zigbee coordinator,” I meant deleting a device from the Zigbee device list integration—for instance, my Sonoff dongle. I’m not referring to physically taking it out; simply remove the device in the Zigbee Home Automation submenu and then add it back.

However, I’m still unsure if this step is truly necessary, or if just removing the switches from Zigbee Home Automation devices menu, resetting them physically, putting them into pairing mode, and waiting for them to reconnect on their own is sufficient. I did both things somewhat simultaneously, so it’s hard to be completely certain :stuck_out_tongue:

Hope that will help somehow :slight_smile: