Xiaomi Aqara Zigbee Switch DTH--help needed

[simic (Andy Chan)]

You have to pair it using catchall method.

[OBSOLETE] Xiaomi Zigbee Outlet (Steps to Pair any Xiaomi Zigbee device!)

Device Handler for the cheap xiaomi zigbee plug. Since it does not pair automatically with SmartThings, you’ll have to add this device manually by using its Zigbee Id and Network Id. You can get Network Id from ST Hub. For Zigbee Id, you can get it from Xiaomi Hub/Gateway (there could be other way to figure out the Device Id). For less than 10~15$ usd, you’ll get a Zigbee Outlet and a temperature sensor. Edit : You do not need a Zigbee Device ID for it to work. Here’s the step Press Add a Thing in ST App Hold the button in the outlet for a few seconds In IDE, you will get something like catchall: 0104 0000 01 01 0100 00 B46D 00 04 115F 0A 01 01FF4231641000032814983900000000953900000000 Add a New Device using IDE Fill in the Device Network ID, you can find it from the catchall log. it …

Look for the 7th group of numbers in the catchall logs. You can get the catchalls under hub, List events in the IDE.

[cohizzle86]

Hi guys

I have been reading the forum for a while now, still this is my first post

So I got two of these 2 button aqara switches and managed to add them to ST by using catchall method. As DH, i am using the one from @aarick - brilliant work mate!
Just to make sure i understand exactly what @simic was mentioning - when you say ST is filtering the backend messages, are these the messages you are talking about?
Button events

• left button: 1002
• right button: 2002
• both buttons: 3002

from here: https://github.com/dresden-elektronik/deconz-rest-plugin/commit/e395207899d4f6c653a25328bf5419073ea850a9

thanks

[veeceeoh (Keith G)]

@cohizzle86

when you say ST is filtering the backend messages, are these the messages you are talking about?

Yes, those 3 different button push events are sent with 3 different endpoint tag values, but the SmartThings ZigBee event parser strips out the endpoint values, so the device handler only sees that a button was pushed.

The only time a device handler has a chance to work around this limitation is if the data sent by the ZigBee device isn’t recognized as a normal event, and gets forwarded to the device handler as a “read attr - raw:” message that includes the full string of bytes that the device sent. In that case, if you know what those byte values refer to, then you can code the device handler to do things with that information.

A lot of other Xiaomi devices send events that are forwarded by ST as “read attr - raw:” data, but this particular switch does not, unfortunately.

[marcofrax (Marco)]

Here the solution:

[OBSOLETE] Device Handler for Aqara Wired Wall Switch

** This DTH is no longer supported ** Pls refer to Device Handler for Aqara 2 Gang Wired Wall Switch no Neutral for the latest supported version. This is DTH for 86x86 Aqara Wired wall switch. It comes in 4 variants. Single Gang Neutral Required Dual Gang Neutral Required Single Gang Neutral NOT required Dual Gang Neutral NOT required Just to avoid confusion, this is what it looks like: [20170425155940_31926][20170425155940_65216][20170425155940_73071]

[aarick]

I don’t think this helps with the wireless version.

[lmosenko]

Xiaomi is bringing smart home products with Google Assistant to the US

[enevis85 (K B)]

Hi.

i have done everything like you all said but still i can’t added this switch

[veeceeoh (Keith G)]

@enevis85

i have done everything like you all said but still i can’t added this switch

The information in this thread is quite outdated. There are newer device handlers, but it depends on which device you are trying to use.

Can you share the model of switch or button you have?

[enevis85 (K B)]

WXKG02LM

This effectively renders the 2 button version useless. Only the single button version can be used with ST platform, until they change their backend to return more info to the device handler.

Use 2 button

[veeceeoh (Keith G)]

@enevis85

Only the single button version can be used with ST platform, until they change their backend to return more info to the device handler.

Not true.

I recently released updated device handlers (DTH) for all the of the Xiaomi / Aqara buttons, including the WXKG02LM and WXKG03LM Aqara Wireless Wall Switches. I have the 2016 revision of model WXKG02LM and it’s working just fine now.

Please see this post for more information and the link to the DTH.

[AnubizDK (Kenneth Eriksen)]

@veeceeoh

Not true.

It’s true that it’s not true…
I have 02LM running with the new DH and it works great…!!

[enevis85 (K B)]

Still nothing.

Could you tell me exactly what i should to do.
Thanks.

[veeceeoh (Keith G)]

@enevis85

Still nothing.

Could you tell me exactly what i should to do.

I can help, but first I need to know some more information.

Just to be 100% sure, are you using this:

and it does not connect to the electric wires in your wall?

If yes, then have you successfully paired it to your SmartThings Hub so it appears in the SmartThings “classic” mobile app, like this example where I named my WXKG02LM as “Aqara Button”:

If you have not successfully paired your Aqara WXKG02LM, then I need to know what kind of SmartThings Hub you are using and if you are using the older SmartThings “classic” mobile app.

[enevis85 (K B)]

Hi.
I can’t paring, how to do this?
Step by step, from beginning
SmartThings Hub V3, latest one. I have both smartthings apps

[veeceeoh (Keith G)]

@enevis85

SmartThings Hub V3, latest one. I have both smartthings apps

Do not use the new SmartThings Samsung Connect mobile app for pairing Xiaomi / Aqara devices. You will need to use the SmartThings “classic” mobile app for pairing, and also to interact with them.

You said you have the Aqara Wireless Smart Wall Switch model WXKG02LM. There are actually two versions of that model: A 2016 revision and a 2018 revision. Looking at the button itself here is no way to know which revision you have until you have successfully paired it to SmartThings.

Here are the instructions on how to pair the Aqara model WXKG02LM:

1. Start “Add a Thing” in the SmartThings (classic) mobile app.
   

   

2. Hold one of the two buttons until you see the LEDs blink at the bottom, and then immediately release the switch. For the 2016 revision you will need to hold about 5 seconds, but for the 2018 revision up to 15-20 seconds. Just only hold until the LEDs blink.

3. There will be a pause, and the LED(s) will flash again. If you see one flash, then the SmartThings hub has recognized the switch. If you see 3 consecutive quick flashes, pairing was unsuccessful so go back to step #2.

4. It may take a few seconds after the hub recognizes the WXKG02LM for it to appear in the SmartThings mobile app. Then it can be renamed, and you’re done!

I can make a video if you still have trouble with pairing.

[jburke3298]

Wondering if I can piggyback on this. I’m trying to install the same switch (02lm), 2018 version, and it’s only adding as a “thing.” I’m using the March 2019 updated DTH from bspranger. Any advice as to why this isn’t adding as an aqara button?

And, just to confirm, still no two-button functionality, right?

[enevis85 (K B)]

All working properly, two things what i done wrong:

1 . on back of the switch is 2016 but installed as a 2018, thats mean longer press and hold
2 . right code , wersion with two- buttons.

thank you for your help

[enevis85 (K B)]

Hi.

Use this code to create or replacement , two-button wersion.

delete switch from devices and pair again, shoulde be ok.

[veeceeoh (Keith G)]

@enevis85

Use this code to create or replacement , two-button wersion.

That is not the correct DTH code for the battery-powered Aqara Wireless Smart Wall Switch model WXKG02LM. You gave the link to the DTH for the small Aqara Button (models WXKG11LM/ WXKG12LM). I would appreciate it if you could remove that link from your post because it will confuse people.

I will copy the part of announcement post that I linked to with information on the new Aqara Wireless Smart Light Switch DTH here:

~ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ ~

[RELEASE] Aqara Wireless Smart Light Switch DTH v0.9.2

For 2016 & 2018 revisions of the 1-button WXKG03LM and 2-button WXKG02LM

This new device handler (DTH) was split off from the “old” Aqara Button DTH in order to best support the two revisions of the one and two-button Aqara Wireless Smart Light Switches. The code has been written so that this device handler can be used with any firmware version, but for users with hub running on Hub Firmware 25.26 or higher, all three actions of the older 2016 revision two-button model WXKG02LM are now recognized: left, right, and both button(s) pushed.

All users of Aqara Wireless Smart Switches are highly encouraged to start using this DTH immediately! You may discover you have more button actions available to make use of in Smart App automations than with the old DTH.

The new Aqara Wireless Light Switch DTH code can be found here.

If you were are already using the old Aqara Button DTH with a paired Aqara Wireless Light Switch, you will need to change to this new DTH. Log into your hub’s Groovy IDE, go to the “My Devices” tab, click on the name of your Aqara Wireless Light Switch in the “Display Name” column, scroll all the way down and click the “Edit” button. Click the pop-up list next to "Type: ", select “Xiaomi Aqara Wireless Switch”, and then click the “Update” button. IMPORTANT: After updating to the new DTH, open the preference settings for your button in the SmartThings “Classic” Mobile App and then press “Save”. This will check your button model and set up the correct number of buttons available for automations.

For instructions on how to check which revision of Aqara Wireless Light Switch you have, please see this post.

Model WXKG03LM (1-button) Function Chart

Action	2016 revision	2018 revision
Single press	button 1 pushed	button 1 pushed
Hold *		button 1 held
Double-click		button 2 pushed

Model WXKG02LM (2-button) Function Chart

Action	Side	2016 rev (old FW) *	2016 rev (new FW)	2018 revision
Single press	Left	button 1 pushed	button 1 pushed	button 1 pushed
Single press	Right	button 1 pushed	button 2 pushed	button 2 pushed
Single press	Both	button 1 pushed	button 3 pushed	button 3 pushed
Hold **	Right			button 1 held
Hold **	Right			button 2 held
Hold **	Right			button 3 held
Double-click	Left			button 4 pushed
Double-click	Right			button 5 pushed
Double-click	Both			button 6 pushed

* Note about 2016 revision of 2-button model WXKG02LM : For users with SmartThings Firmware 24.x or lower, all three button actions (left/right/both pressed) pass on the same button pressed message to the DTH, so there’s no way to tell which button(s) were pressed, and so only button 1 pushed events are generated. With Firmware 25.21 or higher, the three different button actions are recognized.

** Notes about the hold function : Both of the 2018 revision of the two models send a “held” message when the button(s) have been held for 400 milliseconds. This timing is hardware-based and cannot be changed, but if the button(s) are held for more than 10-15 seconds the device will go into pairing mode, so be careful! No button release message is sent by any of the Aqara Wireless Light Switches.

Detailed Change List

version 1.4.1b

• Initial release

version 1.4.2

• changed device definition name to get GitHub Integration working correctly

This new improved device handler code is open source and free .
But if it has helped you, a coffee / beer donation is always very much appreciated!
PayPal: Venmo: @KeithPG

~ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ ~

@jburke3298

I’m trying to install the same switch (02lm), 2018 version, and it’s only adding as a “thing.” I’m using the March 2019 updated DTH from bspranger. Any advice as to why this isn’t adding as an aqara button?

That new DTH for models WXKG02LM & WXKG03LM linked above is from me, actually. Because bspranger has switched to a different home automation hub solution, I am maintaining and updating the collection of Xiaomi / Aqara DTHs in his GitHub repository.

Anyhow, my advice is to start over by pairing the WXKG02LM again, and if it still appears as a thing, manually change to the correct driver (the one above) and stop worrying about it.

The way the hub matches a DTH to the device being paired is this:

The DTH code contains a line called a “fingerprint” which includes some data about the basic capability set and the ZigBee model ID. In the case of the WXKG02LM, the ZigBee model ID is different between the 2016 and 2018 revisions. If you actually have the 2018 revision, then the ZigBee model ID is lumi.remote.b286acn01. For detailed information on how to check the revision of a Aqara Wireless Light Switch see this post.

With Xiaomi / Aqara devices, I have personally experienced and read about cases where the ZigBee model ID wasn’t correctly transmitted and the match to the fingerprint in the correct DTH failed. That doesn’t mean the device isn’t working, however.

What I highly recommend doing is removing the switch from your hub and then pair it again, and if it gets added as a “Thing”, immediately change the assigned DTH.

If you need instructions on how to assign a different DTH to a device, please see this post by the very helpful SmartThings community member @JDRoberts:

[OBSOLETE] FAQ: An Overview of Using Custom Code in SmartThings (SmartThings Classic, Groovy Code)

The process for steps DTH five and six has changed slightly since this was written and I can no longer edit the first post. DTH5a) Select “My Devices.” This will show the list of your devices. DTH5b) click on the display name of the device that you want to assign to your new device type handler. This will open up its details page. DTH5c) click on the “edit” button at the bottom left of the details page. [image] Now you can complete DTH6) and edit the device details so that it uses your new device type handler. [image]

For models WXKG02LM & WXKG03LM the name of the DTH you want to assign is “Xiaomi Aqara Wireless Switch”:

@jburke3298

And, just to confirm, still no two-button functionality, right?

If you are using a SmartThings v2 o v3 hub with Hub Firmware 25.26 or higher, then two-button functionality is now working great for both the 2016 and 2018 revisions of model WXKG02LM.

If you have any troubles getting it working, please let me know. It would be much better to ask in the bsbranger

[jburke3298]

Wow thank you so much. And I stand corrected- thanks for updating all those helpful DTH. I will give this a shot as soon as I get home from work. I’m thrilled about the possibility of full functionality. I was so bummed going through threads after buying this switch that it wasn’t going to work for the purposes I’d hoped. I’ll let you know if I have any issues.

As an aside, thanks to you and all the other helpful members in this forum for letting me leach off of your knowledge. Very thankful for all the cool stuff members’ knowledge has helped me integrate into my smart home.