M100 Matter bridge: multi-press events not forwarded for wired switches (H2 EU)

Summary

The Aqara Hub M100 Matter bridge does not forward multi-press events (double click, long press) for wired switches like the H2 EU, while it works correctly for wireless switches like the H1.

Setup

  • Hub: Aqara Hub M100 (latest firmware)
  • Wired switch: Aqara Light Switch H2 EU (ZNQBKG44LM), 4-button 2-channel, connected via Zigbee to M100
  • Wireless switch: Aqara Wireless Remote Switch H1 (WRS-R02), connected via Zigbee to M100
  • Smart home platform: Home Assistant 2026.2.1 (via Matter integration)
  • Both switches have multi-function mode enabled in Aqara Home app

Problem

H1 (wireless) H2 (wired)
Matter event types multi_press_1, multi_press_2, long_press, long_release initial_press only
Double click in Aqara Home logs :white_check_mark: Detected :white_check_mark: Detected
Double click forwarded via Matter :white_check_mark: Yes :x: No

The H2 double-click is correctly detected by M100 (visible in Aqara Home app device logs), but it is not forwarded through the Matter bridge to Home Assistant. Only initial_press events are exposed.

Steps to reproduce

  1. Connect H2 EU to M100 via Zigbee
  2. Enable multi-function mode on H2 in Aqara Home app
  3. Add M100 to Home Assistant via Matter
  4. Check event entities for H2 in HA → only initial_press available
  5. Double-click H2 lower button → Aqara Home shows “double click” in logs, but HA receives nothing

What I’ve tried

  • Removing H2 from M100 and re-pairing (with multi-function already enabled before pairing)
  • Running matter/interview_node in Home Assistant to refresh capabilities
  • Restarting Matter Server add-on
  • Factory resetting and re-adding the H2

None of these resolved the issue.

Expected behavior

H2 should expose the same multi-press event types through Matter as H1 does (multi_press_1, multi_press_2, long_press, long_release), since both devices are connected to M100 via Zigbee and both have multi-function mode enabled.

Request

Could you please add multi-press event support for wired switches (H2) in the M100 Matter bridge firmware? The capability is already implemented for wireless switches (H1), so it seems like this is a matter of enabling it for wired switches as well.

Thank you!

4 Likes

I have notice the same with H2 dimmer switch EU. It supports single press, double press, long press in Aqara automations, but those actions are not exposed via Matter (tested with Apple Home).

2 Likes

Yes, I think this actions are only available under zigbee! I hope they can immigrate them under Matter too

1 Like

How exactly did you determine that?

a) Have you checked in (“Settings” ->) “Developer tools” → “Current entity states”?

b) Or have you looked at the Matter raw data in “Settings” → “Apps” (formerly add-ons) → “Matter Server” → “Log”

If you have set the logs to “Details,” you must restart the add-on or app and then switch to the “Log” tab. Wait a moment until there is no more activity in the logs, then double-click the H2 button to view the raw data in the log. Can you show us the data here?

1 Like

I see in your screenshots that you have a shutter switch, and maybe the issue is only present in case of H2 switch (2 or 4 channel) and H2 dimmer switch?

That’s how a H2 dimmer switch’s programmable button looks in my Apple Home („Jednokrotne naciśnięcie” means „Single press”). Firmware version 1620, connected via Zigbee, exposed by M3 via Matter

However, this is how the battery powered wireless switch is exposed. There are programmable actions for single press, double press, and long press for left („przycisk 1”) and right button („przycisk 2”), it’s also exposed by the same M3

1 Like

I would still be interested in the raw data. As far as I understand, option a) in Home Assistant and what you can see in the screenshots only shows the Matter ‘Feature Flag’, which basically shows what the device is capable of. With option b), you can see in Home Assistant which events are actually being sent.

I’m just curious, but perhaps only one of the two is missing, or maybe both. It might help the developers fix the problem more quickly if they know in advance where it lies.

1 Like


yes I have checked it and still the same thing - only single press

2 Likes

As I said, I’m curious to see what happens when you press the button. I would be interested in the raw data sent via Matter, as described in option b). Of course, if you’d rather not, I completely understand.

@JohnD Here’s the raw Matter diagnostics data you asked for (option b).

I pulled the full Matter diagnostics from Home Assistant via WebSocket API (matter/node_diagnostics). Here’s what I found:

1. GenericSwitch Cluster FeatureMap (option a - capabilities)

Node 25 (M100 bridge), H2 wired switch endpoints (35-38):

Attribute Value
FeatureMap 2 (binary: 00000010) — only MSR (MomentarySwitchRelease)
NumberOfPositions 2
MultiPressMax not declared

Node 25 (M100 bridge), H1 wireless switch endpoints (43-44, 49-50):

Attribute Value
FeatureMap 30 (binary: 00011110) — MSR + MSL + MSM + AS
NumberOfPositions 2
MultiPressMax 2

So both the capability declaration (FeatureMap) and the events are different. The M100 firmware simply does not declare multi-press/long-press capabilities for wired switch (H2) endpoints.

2. Raw Matter Events (option b - actual events sent)

H2 (wired) — endpoints 35-38, only InitialPress ever sent:

Node 25 EP 36: InitialPress (event_id=1) data={'newPosition': 1}
Node 25 EP 35: InitialPress (event_id=1) data={'newPosition': 1}
Node 25 EP 35: InitialPress (event_id=1) data={'newPosition': 1}
Node 25 EP 35: InitialPress (event_id=1) data={'newPosition': 1}

No ShortRelease, no MultiPressOngoing, no MultiPressComplete. Just bare InitialPress.

H1 (wireless) — endpoints 49-50, full event sequence for single press:

Node 25 EP 49: InitialPress (event_id=1) data={'newPosition': 1}
Node 25 EP 49: ShortRelease (event_id=3) data={'previousPosition': 1}
Node 25 EP 49: MultiPressComplete (event_id=6) data={'previousPosition': 1, 'totalNumberOfPressesCounted': 1}

H1 (wireless) — double press:

Node 25 EP 50: MultiPressOngoing (event_id=5) data={'newPosition': 1, 'currentNumberOfPressesCounted': 2}
Node 25 EP 50: MultiPressComplete (event_id=6) data={'previousPosition': 1, 'totalNumberOfPressesCounted': 2}

Conclusion

Both parts are missing for wired switches:

  1. FeatureMap doesn’t declare MSM/MSL (multi-press/long-press capability)
  2. Events are not sent (only bare InitialPress, no release or multi-press events)

The M100 internally detects double-click on H2 (visible in Aqara Home app logs), but the Matter bridge firmware does not translate these Zigbee events into Matter GenericSwitch events for wired endpoints.

3 Likes