Aqara · Wireless Mini Switch Seria

WXKG12LM

Aktywny

Aqara Wireless Mini Switch (with Gyroscope / Advanced)

Aqara Wireless Mini Switch Seria Introduced circa 2018
Aqara WXKG12LM — Aqara Wireless Mini Switch (with Gyroscope / Advanced)

Aqara original wireless mini switch — square design.

Typowe Zastosowania

The original Aqara button — square design with single press, double press, and long press. Works with Aqara Hub, Xiaomi Gateway, and Home Assistant via Zigbee2MQTT. Smaller and thinner than SONOFF SNZB-01.

Notatki Badawcze

1. Overview

The Aqara WXKG12LM is a compact Zigbee wireless button, officially marketed as the Wireless Mini Switch with Gyroscope (also sold as "Wireless Mini Switch Advanced" or "Wireless Switch Upgraded Version" in Chinese markets as "无线开关升级版"). It is the gyroscope-equipped successor to the WXKG11LM (plain Wireless Mini Switch), and sits within Aqara's WXKG family alongside the WXKG13LM (T1 refresh). The WXKG12LM is a Xiaomi ecosystem product manufactured by Lumi United (绿米联创, Shenzhen) under the Aqara sub-brand, and pairs with Mi Home, the Aqara app, or third-party Zigbee coordinators. Its Zigbee device model IDs are lumi.sensor_switch.aq3 and lumi.sensor_swit.

2. User Sentiment

Users consistently praise the WXKG12LM's versatility — the shake gesture is highlighted as a creative differentiator enabling "skip track," scene activation, and security arm/disarm without pressing. A common complaint is integration via the native Aqara Gateway, which only exposes On/Off and battery level rather than granular button events; the recommended workaround is Zigbee2MQTT or ZHA, or Matter for newer firmware. The accidental-shake problem is noted by at least one user who placed the button on a couch and found shake triggered unexpectedly. No significant hardware reliability complaints were found. On Hubitat forums the device was praised as a solid addition to the Aqara button lineup (~2019).

3. Real-World Applications

The WXKG12LM is used predominantly in residential smart home setups: single-press for light on/off, double-press for brightness adjustment, long-press for scene activation, and shake for music skip or security arming. It is also advertised and used as a wireless doorbell trigger. The compact 45mm square form factor and peel-and-stick mounting make it popular as a bedside controller, couch-side remote, and kitchen scene switcher. Cross-platform blueprint libraries (Zigbee2MQTT, ZHA, deCONZ, Hubitat, ControllerX) indicate widespread DIY smart home adoption.

4. Technical Specifications

  • Type: Zigbee wireless push-button switch with built-in gyroscope/accelerometer
  • Model number: WXKG12LM
  • Zigbee Model IDs: lumi.sensor_switch.aq3 / lumi.sensor_swit
  • Protocol: Zigbee (Zigbee HA 1.2 / compatible with Zigbee 3.0 coordinators)
  • Actions: Single press, double press, long hold (hardware-timed at 400ms threshold), release, shake (gyroscope-triggered)
  • NOT supported: Triple press, quadruple press (present on WXKG11LM but removed on WXKG12LM)
  • Battery: CR2032 coin cell
  • Dimensions: 45 × 45 × 12mm
  • Operating temperature: -10°C to 60°C
  • Operating humidity: 0–95%
  • Certifications: CE, ROHS, CCC
  • Standard: Q/QLML004-2015
  • Integrations: Zigbee2MQTT, ZHA, deCONZ, Hubitat, HOOBS/HomeBridge (HomeKit via bridge), ioBroker, Domoticz, SmartThings, ControllerX
  • Hub requirement: Requires Zigbee hub/coordinator; does NOT support first-generation Aqara gateway

5. Ordering & Compatibility

The WXKG12LM is available from Aqara.com (official), Amazon.de (~$15–18 USD equivalent), AliExpress, Banggood, CloudFree.shop, and Bol.com (Netherlands). Chinese pricing has been seen at ~25–60 CNY on JD.com. It is compatible with the Aqara Hub M1S, M2, and other Zigbee-capable Aqara gateways (not Gen 1), as well as any Zigbee coordinator running Zigbee2MQTT or ZHA. HomeKit support is achieved via Aqara hub (with Mi Home/Aqara app) or via Homebridge + homebridge-z2m. Related WXKG models: WXKG11LM (no gyroscope, 4 events including triple/quad tap), WXKG13LM (T1, newer refresh). The WXKG12LM is sometimes listed as "AK012" by some integrations.

6. Known Issues

The primary integration issue is that the Aqara Gateway native integration exposes only On/Off and battery level — full action events (single/double/hold/shake) require Zigbee2MQTT, ZHA, deCONZ, or Matter. Accidental shake triggering is a real concern when the button is placed on soft surfaces (couch, bed). Early deCONZ (v2.05.74) and early ZHA had pairing stability issues with WXKG12LM (~2018–2019 era, largely resolved). Some units were reported to lack the group cluster, causing incomplete action mapping in deCONZ. The deprecated "click" event in Zigbee2MQTT (vs the newer "action" attribute) can confuse automation setups but is configurable.


Źródło
  1. Aqara Wireless Mini Switch with Gyroscope WXKG12LM Zigbee compatibility — zigbee.blakadder.com
  2. Aqara WXKG12LM control via MQTT | Zigbee2MQTT — zigbee2mqtt.io
  3. WXKG12LM - Aqara Wireless Mini Switch - Home Assistant Community — community.home-assistant.io
  4. Aqara WXKG12LM Wireless Smart Switch APP Remote Control / Doorbell — hitmint.com
  5. Aqara Smart Wireless Switch Key Built In Gyro Multi-functional — grandado.com
  6. xiaomi_aqara_wireless_mini_switch.groovy - GitHub (Hubitat driver) — github.com
  7. $10 Xiaomi Aqara Wireless Button - SmartThings Community — community.smartthings.com
  8. Aqara Buttons All-In-One [Zigbee2MQTT] Blueprint — gist.github.com
  9. Aqara Wireless Switch WXKG12LM (via Zigbee2MQTT device trigger) — community.home-assistant.io
  10. Aqara WXKG12LM Wireless Mini Switch (Advanced) | bol — bol.com
  11. Aqara Button - CloudFree — cloudfree.shop
  12. Aqara 無線開關 (升級版) - 3C博士 — dr3c.net
  13. ZigBee2Mqtt - Xiaomi WXKG12LM Wireless Switch blueprint — community.home-assistant.io
  14. Aqara WXKG12LM Homebridge/HomeKit integration | homebridge-z2m — z2m.dev
  15. Exploring Xiaomi Aqara WXKG12LM: A Comprehensive Guide — forum.aqara.com
  16. Aqara Wireless Mini Switch (WXKG12LM) : r/homeassistant — reddit.com
  17. Very useful! Aqara WXKG12LM. Single press: on/off, double... r/homeassistant — reddit.com
  18. [Deprecated] Xiaomi / Aqara ZigBee device drivers - page 2 — community.hubitat.com
  19. [Deprecated] Xiaomi / Aqara ZigBee device drivers - page 7 (WXKG12LM support added) — community.hubitat.com
  20. [Deprecated] Xiaomi / Aqara ZigBee device drivers - page 46 (400ms hold timing) — community.hubitat.com
  21. [Deprecated] Xiaomi / Aqara ZigBee device drivers - page 15 (shake=button 2) — community.hubitat.com
  22. [RELEASE] Xiaomi Aqara Mijia Sensors and Switches Driver — community.hubitat.com
  23. [DEPRECATED] Xiaomi Drivers with Health Status and Zigbee2MQTT — community.hubitat.com
  24. Add support for Xiaomi Button Switch model WXKG12LM — community.home-assistant.io
  25. WXKG12LM - ControllerX — xaviml.github.io
  26. All off button assignment missing and orphaned actions (deCONZ) — forum.phoscon.de
  27. Aqara WXKG12LM Wireless Intelligent Multifunction Switch - Amazon.de — amazon.de
  28. My favorite setup with Aqara Wireless Mini Switch (WXKG12LM, 4 actions including shake) — reddit.com

Otwartość i Modyfikowalność

Kompatybilny z Zigbee2MQTT

Excellent Zigbee2MQTT/ZHA support. Works without Aqara Hub. Full multi-click events in Home Assistant.

Specyfikacje

Actions
double hold release shake single
Available from
Aliexpress.com Banggood.com Amazon.de Cloudfree.shop
Battery Life
2 years
Battery Type
CR2032
Color
White
Smart Home Integrations
Aqara Home, Xiaomi Home, HomeKit, Home Assistant
Protocol
Zigbee 3.0
Works with
ZHA
Zigbee id
lumi.sensor_switch.aq3
Zigbee model
lumi.sensor_switch.aq3

Skrócona Instrukcja Montażu

Setup: Pair with your hub or phone via Zigbee 3.0. Most smart buttons support single press, double press, and long press for three different actions.

Battery: Uses CR2032 battery. Expected life: 2 years. Low battery notification via the app.

Wymiary

Rozwiązywanie Problemów

Not responding to input

Check wiring continuity with a multimeter. Verify the contact block is properly seated. Inspect terminals for loose connections.

Zdjęcia i Rysunki

Zdjęcia: zigbee.blakadder.com

Gdzie Kupić

Przedział cenowy

$34.69 — $85.67

across 2 sellers in US dollars

Skrócone Specyfikacje

Actions
double hold release shake single
Available from
Aliexpress.com Banggood.com Amazon.de Cloudfree.shop
Battery Life
2 years
Battery Type
CR2032
Color
White

Co Mówią Użytkownicy

•

“The original Aqara button — square design with single press, double press, and long press. Works with Aqara Hub, Xiaomi Gateway, and Home Assistant via Zigbee2MQTT. Smaller and thinner than SONOFF SNZ”

Reddit r/homeassistant 21 głosy za Zobacz wątek →

Źródła Danych

Specyfikacje i dane produktowe pochodzą z poniższych źródeł.

Blakadder: Aqara Wireless Mini Switch with Gyroscope WXKG12LM

https://zigbee.blakadder.com/Aqara_WXKG12LM.html

Źródło