Homey Community Forum

Aqara & Xiaomi Smart Home - Zigbee App (v1.3.5)

Aqara & Xiaomi Smart home (Zigbee)

This app adds support for the Smart Home devices made by Aqara & ! Xiaomi Smart Home Devices working on the Zigbee protocol.


Supported devices

Please see the Aqara & Xiaomi-mi Zigbee app Athom apps in the app store for the actual list of supported devices, including the available flow cards (click on the device picture)

Installation note: the Xiaomi (non Aqara) range of devices need to be manually kept awake during in the inclusion; keep pressing the button once every 5 seconds until inclusion has finshed.


This app and driver development has been supported by:


Any requests please post them in the Xiaomi / Aqara Zigbee topic on the Athom Community forum or contact me on Slack
Please report issues at the issues section on Github otherwise in the above mentioned topic.

If possible, please report issues at the issues section on Github otherwise in the above mentioned topic.


If you appreciate this app, contribute to future development by making a paypal contribution



v 0.8.0

v 0.7.1

  • Fix issue with Aqara Cube trigger cards not showing argument fields

v 0.7.0

  • Add support for the Aqara B1 Curtain Controller (Zigbee) (ZNCLDJ12LM) (open, close, idle, setpoint (100% = open, 0% = closed), measure_batery)
  • Update app branding since more Aqara (then Xiaomi-Mi) devices are supported
  • Update of app to become compatible with new app store
  • Made app compatible with Homey SW > 3.0.0 (removing Homey Sw 1.x mobile definition)
  • Re-structured the app using .homeycompose
  • Update Homey meshdriver to v1.3.21

v 0.6.2

  • Fix issues where the lifeline temperature sensor reporting
  • Update Homey meshdriver to v1.3.9

v 0.6.1

  • Fix issue showing flow card conditions and triggers for Aqara Relay device
  • Fix issues where the lifeline reportParser is causing a crash of the app
  • Update Homey meshdriver to v1.3.7

v 0.6.0

  • Add support for Aqara Double Relay (LLKZMK11LM)
  • Add insights logging for Aqara Vibration sensor (all alarms and tilt angle) and Cube (rotation angle)
  • Prepare app and drivers for ‘Energy’ (Homey 3.0.0)
  • Update Homey meshdriver to v1.3.6

v 0.5.5

  • Fix issue that prevented to include some devices ending in status.invalid_setting_type

v 0.5.4

  • Add German language support, thanks to the contribution of Sebastian Spoerer
  • Update Homey meshdriver to v1.2.32

v 0.5.3

v 0.5.2

  • Fix issue where motion alarm would be cancelled before the finalizing the motion alarm reset duration

v 0.5.1

  • Fix issues where incorrect data is reported by the Xiaom and Aqara Temperature and Humidity Sensors #125

v 0.5.0

  • Enabled Xiaomi lifeline reporting (device dependent interval), adding the following functions:
    • Battery reporting (measurement + alarm) enabled for multiple devices (see device - capability overview)
    • Additional state / capability reporting (e.g. curtain position for Aqara Curtain controller or onoff state for the Aqara wall switch )
    • Updated App dependency updated to Homey SW >= 1.5.13
  • Updated app to fully utilize Homey SW v2.0.0 options:
    • Fix issue where custom icons are not shown
    • Add brandColor definition to match Xiaomi brand
  • Added measure_power , meter_power and measure_voltage capabilities to the Aqara Wall Switch Single (LN) and Aqara Wall Switch Double (LN) . Note: Re-inclusion is required to add these capabilities
  • Added fixed polling interval (10 minutes) for meter_power and measure_voltage capabilities for Aqara Smart socket plug , Aqara Smart Socket , Aqara Wall Switch Single (LN) and Aqara Wall Switch Double (LN)
  • Cleaned up device driver logging (moved some logging to the debug-logging mode)
  • Updated readme device overview to show added capabilities and link towards the device info at the official Aqara site
  • Update Homey meshdriver to v1.2.30

Check regarding mesh issues:

  • Do the / all devices still work as they intend to work? If so, simply ignore the routing tables.
  • When going to the Zigbee tools section, please check that the ‘Current Command’ (bottom row of the system information) shows ‘generateMap’.
    • if not, force refresh the page, until it does show ‘generateMap’
    • if it does, wait for 2-3 minutes and the routes should start showing

How is the support for Aqara Water sensor going?


Hi @Spirre,
Support for the Aqara water sensor, as well as the smoke and natural gas sensor, is depending on the implementation of the Zigbee IAS (Intruder Alarm System zone) cluster within Homey.

This cluster is currently not supported and is likely to be included with or after the Zigbee core re-write (post v2.0 action). See also https://github.com/athombv/homey/issues/2005

We’ll have to be patient…


Are there any plans to add support for the xiaomi mi jia aqara trillingen/shock sensor? They are on sale for only €11,- and I think you can do really cool things with it like using it as a door/window sensor, put it on the washing machine to check when it’s ready etc…

just received the Aqara vibration sensor and started to reverse engineer the communication with this device…

So far, I see that the device sends events triggers (vibration / tilt / drop detected) and tilt angle (non-signed)…

From the Xiaomi Mi app:

Tilt angle is not shown, but is reported in the original app…

Vibration strength is also reported but I still need to figure out how the value / curve is determined…


Question about the curtain controller - does this allow part opening etc, and if so how does that represent in homey?

Awesome! Thanks a lot.

Yes, opening and closing is presented as a slider with percentage in Homey. It can be set to any percentage. Similar to a dimmer.

1 Like

@vaderag The curtain controller can be operated with a sider providing a setpoint similar to the dim level of a dimmer (0% = closed, 100% = opened). In addition, you can give an open / close / hold command.

© screenshot @Eternity

An offcourse you can also pull the curtain gently to open or stop

1 Like

Fab, thanks

Is there any difference between the ‘original’ with zigbee vs 2018?

Curtain rail mounting variations

Size of the rail segments
Some suppliers ship in 50 cm chunks, others in sizes up to 250 cm. Less connections make the rail smoother to operate (and less noisy). The parcel is more visible in the post so you might get taxed.

Connecting rail segments
To connect the separate segments, I have found two variations. One is a blind connection: a metal connectors slides in the rail and that is fixated with 4 crews to the rail. Can’t show a picture, as the are blind mounted :slight_smile:
Advantage: not visible once mounted
Disadvantage: the segmets are not 100% connected, I stil have a 1 mm gap

The other way is a visible connector one the outside of the rail, with also a ‘spring’ metal connector on the inside of the rail.

As I am planning the conseal the rail I have no problem with the exterior connector.
Advantage: stronger connector
Disadvantage: visible if curtains are opened

Hanging the rails
The rails can be wall and ceiling mounted. I myself have no experience with wall mounting them, but brackets can be ordered (albeit a bit expensive imho).
Ceiling mounting is done via metal clips that attachs to the rail. I have found two variations:
Clips that are screwed and visible on both sides of the rail:

And a clip that connects to the rail and is only partially visible:

Mounting the controller
This can be done on either side of the rail. As a consequence the status open/closed will be mirrored. A future App update might/will support a mirroring feature.

I would like to integrate the: Xiaomi Universal IR Remote Controller https://www.gearbest.com/smart-home/pp_229556.html .

Is there any possibility to support this device? I would like to automatically start devices like tv and dolby units where there is no possibility of receiving IR signals through homey directly.

Thanks for that info - really useful!
Out of interest, did the different connectors just come from different suppliers or is there some way to choose?

Also, how do you plan to conceal them?!

Thanks :slight_smile:

Unfortunately I had no influence on the type of connectors. I ordered my first rail, and it came ‘as is’. Later I ordered via the shop that offers longer length rails, and those (two separate orders) arrived with other connectors and ceiling mounts.

I bet stuff can be found and ordered separately. I ordered extra curtain ‘runners’ separately from another shop.

My rails will (eventually…) be hiding in a coving (koof in Dutch).

@Kevin_Vijver this app focusses on the Zigbee based Xiaomi / Aqara devices.
The Xiaomi Universal IR Remote Controller is a WiFi based device.

You could check if Xiaomi Mi Home app developer is able to add support for this device: https://community.athom.com/t/118

Alternative would be to use a BroadLink RM mini 3: https://www.gearbest.com/living-appliances/pp_357329.html?wid=1433363 which is supported by the Broadlink app: https://apps.athom.com/app/com.broadlink

1 Like

Wil the Aqara Smart Motion Sensor International Edition be supported? or perhaps it is already supported…


@Tim_Messerschmidt the developer is busy to get these sensors working as you can read a few posts back…

@TedTolboom is it interesting for me to buy the xiaomi gateway in order to update my sensors to the newest firmware? Or are there no updates availible for these devices…