Homey Community Forum

Xiaomi / Aqara Smart Home - Zigbee App (v0.5.3)



I just uploaded v0.4.2 to the app store; now waiting for Athom’s approval.

Changelog of this update:

So it will add support for the long awaited Aqara Vibration sensor… but it will also break some flows for the people that did not already update their flows

  • Removing the old, no longer working, (marked DEPRECATED) cards as announced as of release v 0.3.0
    So please update your flows to not use the DEPRECATED flow card triggers


On the new Aqara vibration sensor, implemented mobile interface:
25 46

Available flow card triggers (alarm turned off not shown):

Some additional remarks on this sensor…

  • All triggers being send by the device directly after the event occured, except for the vibration strength
  • The vibration strength is reported ~300 seconds after the first vibration event occured, and can be considered to be the maximum vibration amplitude in the past 300 seconds
  • Tilt-, Vibration-, Drop-alarm triggers originate out of the reported motion and are reset by Homey based on the duration as defined in the settings; the device does not provide an alarm trigger, nor a alarm reset (aka Homey special)
  • For the tilt data, I’m using the RAW force vector as provided by the device, not the directly reported angle. (aka Homey special). This enables a distinction in tilt direction (X, Y). I’ve added several additional features to the driver to
    • be able to be able to compare the tilt to it’s “reference position” and “previous position” (capability and trigger cards)
    • set the reference force vector upon next tilt report (settings > mark “Set tilt reference vector” > press save > tilt the sensor to it’s new reference position ie. roof window closed)):
    • determine if the angle provided is the absolute or singed value (settings)


  • Keep in mind that the tilt angles are determined based on a change of the force vector (as result of the gravitational force). A tilt will be reported when the orientation of the force vector will change. Rotating the sensor, while the sensor is lying flat on a table top, will not change the orientation of the force vector, therefore no change in tilt is reported
  • Due to a limitation of Homey’s Zigbee core, it is not possible to adjust the vibration sensor sensitivity. I’ll further explore options to still add this setting to the driver.
  • Battery capabilities have been implemented, but will not show any data, awating a fix in Homey’s Zigbee core

I’m curious on your experience with this sensor and use cases: please share them


Great work @TedTolboom :+1:
The Heimdall version that supports the Vibration Sensor is already approved, I’ll publish it when your new version is approved and published.


Always enjoying a good collaboration!
Thanks @DaneedeKruyff


I do use the Xiaomi Mi Zigbee app version V0.4.1 (V0.4.2 not available at Homeyapps?) and I’m happy.
I do use this app for example also for door/windowsensors and it is in the basic working fine.

There is only no battery information of the devices. It only show the green battery without value. If I’m right (I did read this somewhere) this option will be added in the near future.

Does somebody knows when this will happen?


@Canedje v0.4.2 is awaiting app store approval from Athom… expect it to be available in the app store on Monday / Tuesday latest…

You’re right, in the app store notes, the following comment is made:

  • Battery operated devices will not yet show the battery level ; this will be added in a future release (manufacturer specific ZigBee implementation)

I’m trying to get this change in Homey’s core available before the Zigbee re-write (2.1+).
Can’t make a strong promise yet…


Thanks Ted. I was not meaning pushing you.



Plugin v0.4.2 installed via cli.
Sometimes switch (QBKG03LM) control works well, but time to time plugin unable to turn it on or off.
Log: 2018-09-30 23 55 39
And after several attempts it starts working again.
Other xiaomi-zigbee-devices not affected at all. Working as expected.

I created issue on github, but it seemed necessarily to me to write here too.


I have some problems with curtain controller, maybe someone have suggestions?
When i try to open or close curtains sometimes they not reacting like expected and i get error message.

Curtain motor and homey are in the same room and the distance is about 1,5 m


I have the same error. @TedTolboom is aware of this ‘time out’ issue. In my case it does not effect flows, it only happens when I manually control the curtain controller with the slider.


@FantomNotaBene thanks for reporting.
v0.4.2 did not change anything in the implementation of the Aqara Smart Light Wall Switch (L) Double (QBKG03LM). Considering the error code (coming back from the Homey core), it points towards a mesh issue / disturbance. Let’s follow-up on the GitHub issue, to prevent parallel discussions.

Indeed a known issue, but I only have seen it when using the beta Homey app…
Can you check if it also occurs when using the old app / webinterface?


You right i don’t get error messages from old app and webinterface but the behavior is same. Sometimes it not reacting sometimes it likes that motor has own life
For example if i set manually curtains to 50% it closes and after few seconds goes back to open and then goes to my setpoint. I will upload video later


I am very curious how you were able to implement this.

In my testing with two different sensors, the accelerometer force values output have not been consistent enough to guarantee an accurately calculation of the sensors current resting tilt angle. Also, there is an imbalance in the two ends of the output range, particularly in the values I’ve seen for the X-axis.

Although I’m not a Homey user, I also just want to say how much I respect the great work you’ve been doing in creating compatibility for Xiaomi sensors on the platform!


I’m not sure yet if it will be possible, but want to see if I can use them to check the angle of my (open) skylights (dakramen).


And kantel/kiep windows!


I’d suggest, try it yourself… and report back :stuck_out_tongue_winking_eye:

v0.4.2 is available in the app store


I’m not able to pair my aqara vibration sensor in v0.4.2

The blue led of the sensor blinks 3x but nothing happend. I have tried this with the preview app and via my.athom.com.
I have restarted my homey, but this changed nothing. Am I the only one with pairing issues?


Hi @TedTolboom, just wondering if there are any news about the new smart switch (without vibration), is still showing as an unknown device.

Issue #90

Don´t stress about it, just checking :slight_smile:

Cheers :slight_smile:


nope. same here. perhaps i got too many aqara sensors. this is device 27 and 26 was also problematic. device 1 to 25 went smooth like butter…


Q&A time…

@Emile86 please check with a defined sequence… it could be that the first command gets blocked, creating a queue of commands that are still to be send…
if the first command is “released”, that the remaining queue is still send to the curtain controller

@veeceeoh thanks for the compliment… one day, you’ll buy a Homey :stuck_out_tongue_winking_eye:

The source code is available on GitHub for sharing knowledge. Which shows the calculation methods I used for the vibration sensors.

On the accuracy… I’m aware of the imbalance you mentioned on the other GitHub site, but looking at the usability options, I think most users will look at the relative tilt where absolute accuracy is not that relevant.

Perhaps with some calibration, it would be possible to increase the accuracy (further)…

@Wdl I always refer to the by Xiaomi provided inclusion instructions…
Can you try if the sensor will include when tripple clicking the button (instead of press and holding the button for 5 seconds)?

@Marius_Muresan “no pressure” :stuck_out_tongue_winking_eye:
Just received the involved sensor from @Mustang… and did some preliminary tests…
Also here different capabilities (1x, 2x click, hold and release) compared to the “other” Aqara Wireless Switch.

Goal is to have an update early next week that will add support for these same devices with different firmware and capabilities…