WXKG12LM
ActiveAqara Wireless Mini Switch (with Gyroscope / Advanced)
Aqara original wireless mini switch — square design.
Common Applications
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.
Research Notes
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.
28 sources
- Aqara Wireless Mini Switch with Gyroscope WXKG12LM Zigbee compatibility — zigbee.blakadder.com
- Aqara WXKG12LM control via MQTT | Zigbee2MQTT — zigbee2mqtt.io
- WXKG12LM - Aqara Wireless Mini Switch - Home Assistant Community — community.home-assistant.io
- Aqara WXKG12LM Wireless Smart Switch APP Remote Control / Doorbell — hitmint.com
- Aqara Smart Wireless Switch Key Built In Gyro Multi-functional — grandado.com
- xiaomi_aqara_wireless_mini_switch.groovy - GitHub (Hubitat driver) — github.com
- $10 Xiaomi Aqara Wireless Button - SmartThings Community — community.smartthings.com
- Aqara Buttons All-In-One [Zigbee2MQTT] Blueprint — gist.github.com
- Aqara Wireless Switch WXKG12LM (via Zigbee2MQTT device trigger) — community.home-assistant.io
- Aqara WXKG12LM Wireless Mini Switch (Advanced) | bol — bol.com
- Aqara Button - CloudFree — cloudfree.shop
- Aqara 無線開關 (升級版) - 3C博士 — dr3c.net
- ZigBee2Mqtt - Xiaomi WXKG12LM Wireless Switch blueprint — community.home-assistant.io
- Aqara WXKG12LM Homebridge/HomeKit integration | homebridge-z2m — z2m.dev
- Exploring Xiaomi Aqara WXKG12LM: A Comprehensive Guide — forum.aqara.com
- Aqara Wireless Mini Switch (WXKG12LM) : r/homeassistant — reddit.com
- Very useful! Aqara WXKG12LM. Single press: on/off, double... r/homeassistant — reddit.com
- [Deprecated] Xiaomi / Aqara ZigBee device drivers - page 2 — community.hubitat.com
- [Deprecated] Xiaomi / Aqara ZigBee device drivers - page 7 (WXKG12LM support added) — community.hubitat.com
- [Deprecated] Xiaomi / Aqara ZigBee device drivers - page 46 (400ms hold timing) — community.hubitat.com
- [Deprecated] Xiaomi / Aqara ZigBee device drivers - page 15 (shake=button 2) — community.hubitat.com
- [RELEASE] Xiaomi Aqara Mijia Sensors and Switches Driver — community.hubitat.com
- [DEPRECATED] Xiaomi Drivers with Health Status and Zigbee2MQTT — community.hubitat.com
- Add support for Xiaomi Button Switch model WXKG12LM — community.home-assistant.io
- WXKG12LM - ControllerX — xaviml.github.io
- All off button assignment missing and orphaned actions (deCONZ) — forum.phoscon.de
- Aqara WXKG12LM Wireless Intelligent Multifunction Switch - Amazon.de — amazon.de
- My favorite setup with Aqara Wireless Mini Switch (WXKG12LM, 4 actions including shake) — reddit.com
Openness & Hackability
Excellent Zigbee2MQTT/ZHA support. Works without Aqara Hub. Full multi-click events in Home Assistant.
Specifications
|
Actions
|
double hold release shake single
|
|
Available from
|
Aliexpress.com Banggood.com Amazon.de Cloudfree.shop
|
|
Battery Life
Expected battery life under normal use. BLE buttons typically last 1-2 years on a coin cell.
|
2 years
|
|
Battery Type
The battery used. CR2032 = common coin cell, easy to replace. AAA = higher capacity. USB-C = rechargeable.
|
CR2032
|
|
Color
Button/actuator color. Green = start/go, Red = stop/emergency, Yellow = caution, Blue = reset (per IEC 60204-1).
|
White
|
|
Smart Home Integrations
Compatible smart home platforms and voice assistants.
|
Aqara Home, Xiaomi Home, HomeKit, Home Assistant
|
|
Protocol
The wireless communication standard. BLE = short range, phone direct. Zigbee = mesh network, needs hub. Z-Wave = mesh, needs hub. WiFi = direct, higher power.
|
Zigbee 3.0
|
|
Works with
|
ZHA
|
|
Zigbee id
|
lumi.sensor_switch.aq3
|
|
Zigbee model
|
lumi.sensor_switch.aq3
|
Installation Quick Reference
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.
Dimensions
Troubleshooting
Not responding to input
Check wiring continuity with a multimeter. Verify the contact block is properly seated. Inspect terminals for loose connections.
Where to Buy
Price range
$34.69 — $85.67
across 2 sellers in US dollars
Quick Specs
- 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
What People Are Saying
“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”
Learn More
Data Sources
Specifications and product data sourced from the following references.
Blakadder: Aqara Wireless Mini Switch with Gyroscope WXKG12LM
https://zigbee.blakadder.com/Aqara_WXKG12LM.html