Questions about H2 Wall Switches

Developer Hub
, , , ,
1

I’ve got some questions about H2 wall switch (and curtain control) series. Let’s take the European 1 Channel version (WS-K07E) as an example.

  1. What chip does the switch use internally?
  2. Is there a way to flash an own firmware, ideally ESPHome?
  3. With the stock firmware and in Thread/Matter mode, can the relay be switched like this: upper button single press switches the relay on, lower button single press switches the relay off? – note: I’d like to avoid toggle buttons.
  4. Does point 3 also apply when there is no Thread connectivity, so is this basic function processed locally?
  5. Can the single press action also be decoupled from the relay, such that a Matter controller would decide wether to switch the relay or not?
  6. Which of these additional event types can be detected via Matter for the upper button: double press, triple press, long hold, long release
  7. Which of these additional event types can be detected via Matter for the lower button: double press, triple press, long hold, long release
  8. Does the stock firmware support proper device info and firmware updates via Thread Matter, to be usable with Home Assistant?
  9. Does the device with the stock firmware act as a Thread Router, routing packets for (Sleepy) End Devices which might not be able to reach the Border Router on its own?
2

@Heavenly You’ve raised some great detailed questions about the Aqara H2 Wall Switch (WS-K07E). Let’s go through them one by one based on the available information:

Question 3: With stock firmware in Thread/Matter mode, can the upper button single press switch the relay on and the lower button single press switch it off (avoiding toggle)?

The Aqara H2 series supports customizing button actions. You can decouple or lock the relay to turn buttons into wireless triggers, and expand functions with single, double, or long presses to trigger specific actions (like on/off for the relay). To enable multi-press modes, open the Aqara Home app, select the switch > … > custom press mode, and switch to multi-function mode. While the exact “upper on/lower off” configuration isn’t explicitly detailed, this customization flexibility suggests it may be achievable through app settings.

Question 5: Can single press actions be decoupled from the relay, letting a Matter controller decide to switch the relay?

Yes. The H2 switch supports decoupling the relay from button presses, turning buttons into wireless triggers. This allows a Matter controller to handle relay switching logic.

Questions 6 & 7: Which additional event types (double press, triple press, long hold, long release) can be detected via Matter for the upper/lower buttons?

The switch supports single-press, double-press, and long-press modes when set to multi-function mode (configured via the app: switch > … > custom press mode > multi-function mode). Triple press and long release are not mentioned in the current information.

Questions 1, 2, 4, 8, 9:

For questions about the internal chip, firmware flashing (e.g., ESPHome), local processing without Thread connectivity, Home Assistant compatibility (device info/firmware updates via Thread Matter), and Thread Router capability, the current reference information does not cover these details. You seem to be seeking technical specifications and advanced functionality details. You can contact customer support for assistance.

Contact the Aqara Home App Customer Service Team (Profile> Help & Feedback > Customer Service) or scan the QR code:

400×400 9.45 KB

This will be more efficient. If you do not have an Aqara Home account, “Please click here” to create a ticket.