[OBSOLETE] Original Xiaomi Aqara Smart Wireless Switch (Aqara Button)

Does the button supports hold events? But hold in a way that an event is send after x configured seconds before releasing the button.

The newer Aqara Button model WXG12LM does indeed support hold in its hardware. But the time cannot be changed. The hold event is always sent after the button has been held for 400 milliseconds.

In the device handler, that is sent as button 1 held. Then, when the button is released after being held, another custom event is sent: lastReleasedCoRE, which can be used for a WebCoRE piston.

Hey @veeceeoh

Thanks for answer. Have you already added the code into your device handler:

or some other one ?

In this one all the code refering to hold action is commented out.

Sorry, that’s not my device handler.

The updated Aqara Button DTH which supports the new WXG12LM model is part of the bspranger/Xiaomi GitHub repository.

Please see this SmartThings forum thread for discussion of the bspranger collection of Xiaomi device handlers, and my announcement of the updated Aqara Button DTH is here.


I’ve done some google searches, but found nothing definite.

Does anyone know if the xiaomi mijia (round) switches work well with any of the current DTHs?

I already have a number of the more rounded door sensors working with the a4refillpad dth, but I don’t want to go out and buy several of these to find they don’t work.

Additional question: do they also support double-click? and hold?



For almost all Xiaomi devices, the newest DTHs are available from the GitHub/bspranger repository. Here is the SmartThings Community Forum thread for the discussion about this collection of DTHs:

I would also recommend switching to the Door/Window sensor DTH from the bspranger collection because the battery reporting does not work correctly with the a4refillpad DTH…

Unfortunately, due to the way certain Zigbee messages are parsed by SmartThings, the multi-click functionality of the round Xiaomi button is not supported. The hold function is supported, however. For detailed information about the latest version of the round Xiaomi button DTH, see my post here.

I have the square Aqara button and I’m using version 1.3 of Terk’s DH. I was using it to control my outside downlights however it appears that after one day, the button doesn’t work. I can manually press ‘Push’ on the app which seems to work however physically pressing the button doesn’t do anything at all. ‘My Devices’ shows the button as being ‘Active’.

any suggestions?

Usually I have to add Xiaomi devices once leave them connected for over an hour and they stop responding like you are seeing then remove it from the system and re-add them, they usually stay connected after that.

The button I have doesn’t respond to a physical button push anymore however it does respond when I ‘press’ it in the app. Does that still mean it’s dropped off as such? Or is there something else going on? That’s the second time it’s done this now. And it’s the second time my motion sensor has dropped off.

I’ve also changed my WiFi channel of the router to be as far away as possible from my Zigbee channel.

It sounds like they are both disconnected from ST. Xiaomi devices don’t conform strictly to the standards so ST will likely never support them on their own and I wouldn’t expect them to be as reliable as all the other zigbee devices although maybe try replacing your battery.

I just managed to pair the WXKG11LM type button - but it only shows up as “thing” and “unknown” so it does not work. I have used this DH: https://github.com/bspranger/Xiaomi. Is there another DH to use or does anyone know what could be wrong? Thanks for any advice

Try the DH at the top of this page, you’d want to unpair and repair it or just assign it via the IDE.

There is a new revision of the WXKG11LM Aqara Button, and I have published a new beta device handler which adds support for it. You may have one of the new WXKG11LM buttons, so you should try this beta DH.

The download link is different from the current release version. Please see my post here for more information and the beta DH download link:

1 Like

Thank you. But still no luck here. Shows up as thing. But I have ordered the “12” version and hope that will work better. Also the button states it have will make it very flexible and the cost is low.

Did you try logging into the IDE and change the device type of the newly paired device to use the custom device handler?

Super! Working now - thanks a lot!

1 Like

Cannot get it to work then you post 4 gearbest links. Really?

[ANNOUNCEMENT] All Xiaomi / Aqara wireless button users

Hub Firmware 25.26 has been released for SmartThings v2 & v3 Hubs

The new firmware includes changes that “break” some functionality in the previous device handlers, but also allows for much improved functionality.

In order to fix the issues and add improved functionality, I have updated all Xiaomi / Aqara Button device handlers (DTHs). All SmartThings v2 & v3 Hub users are encouraged update to the newest DTHs immediately.

Please see this post for all details and links to the updated DTHs.

The code of these updated and improved device handlers is open source and free.
But if it has helped you, a coffee / beer donation is always very much appreciated!
PayPal: 37544ab59e07a5c90719f07501453cae3ed7b043 Venmo: @KeithPG


Uhmm got it to add the button as a thing, battery is showing, got the automation set up with smart light, everything works from the classic app but nothing happens if i press the button :frowning: no change of status in the app, nothing… am i missing something? my smartthings samsung button works like a charm


Xiaomi devices are close to conforming to the zigbee standards that they connect and work after a bit of playing but aren’t strictly following the standard so there are some issues with them. I’ve always added mine then an hour later the device would drop and I would reset it and join it again and they would then stay connected. The best way to see what the issue is is to check the logs of the device when you push the button to see if the logs even reflect the push if not then reset the button and rejoin it or if it had been working for weeks or more and suddenly stopped then just try replacing the battery.