Homey Community Forum

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

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.
large

Links:

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)

Device icon Brand Name Device modelID Product Code (EAN) Zigbee productId Driver ID Device capabilities Subdevices Deprecated
Sensors
Aqara Aqara TVOC Air Quality Monitor AAQS-S01, VOCKQJK11LM 6970504214644, 192784000595 lumi.airmonitor.acn01 airmonitor.acn01 measure_battery, measure_temperature, measure_humidity, measure_VOC, measure_AirQualityLevel, alarm_VOC, alarm_battery No
Aqara Aqara Vibration Sensor DJT11LM 6970504210592 lumi.vibration.aq1 vibration.aq1 measure_tilt, measure_tilt.relative, measure_vibration, alarm_vibration, alarm_tilt, alarm_drop, alarm_battery, measure_battery No
Aqara Aqara Door and Window Sensor MCCGQ11LM 6970504210073, 192784000083 lumi.sensor_magnet.aq2 sensor_magnet.aq2 alarm_contact, alarm_battery, measure_battery No
Aqara Cube MFKZQ01LM 6970504210615, 6974176874412, 192784000045 lumi.sensor_cube, lumi.sensor_cube.aqgl01 cube measure_battery, cube_state_motion, cube_state_face, cube_measure_rotation, alarm_battery No
Aqara Aqara Motion Sensor RTCGQ11LM 6970504210066, 192784000090 lumi.sensor_motion.aq2 sensor_motion.aq2 alarm_motion, measure_luminance, alarm_battery, measure_battery No
Aqara Aqara Water sensor SJCGQ11LM 6970504210258, 6970504210608 lumi.sensor_wleak.aq1 sensor_wleak.aq1 alarm_water, alarm_battery, measure_battery No
Aqara Aqara H1 Wireless Switch Double WRS-R02 6970504215023 lumi.remote.b28ac1 remote.b28ac1 measure_battery, alarm_battery No
Aqara Aqara Temperature and Humidity Sensor WSDCGQ11LM 6970504210097, 192784000106 lumi.weather weather measure_battery, measure_temperature, measure_pressure, measure_humidity, alarm_battery No
Aqara Wireless switch WXKG01LM 6970244522795 lumi.sensor_switch sensor_switch measure_battery, alarm_battery No
Aqara Aqara Wireless Remote Switch Double WXKG02LM 6970504210042 lumi.sensor_86sw2Un, lumi.sensor_86sw2 sensor_86sw2Un measure_battery, alarm_battery No
Aqara Aqara Wireless Switch Double (2018) WXKG02LM 6970504211452, 192784000076 lumi.remote.b286acn01 remote.b286acn01 measure_battery, alarm_battery No
Aqara Aqara Wireless Remote Switch Single WXKG03LM 6970504211445 lumi.sensor_86sw1lu, lumi.sensor_86sw1 sensor_86sw1lu measure_battery, alarm_battery No
Aqara Aqara Wireless Switch Single (2018) WXKG03LM 6970504211445, 192784000069 lumi.remote.b186acn01 remote.b186acn01 measure_battery, alarm_battery No
Aqara Aqara D1 Wireless Switch Single WXKG06LM 6970504211445 lumi.remote.b186acn02 remote.b186acn02 measure_battery, alarm_battery No
Aqara Aqara D1 Wireless Switch Double WXKG07LM 6970504211452 lumi.remote.b286acn02 remote.b286acn02 measure_battery, alarm_battery No
Aqara Aqara Wireless switch WXKG11LM 6970504210080 lumi.sensor_switch.aq2 sensor_switch.aq2 alarm_battery, measure_battery No
Aqara Aqara Wireless Mini Switch (2018) WXKG11LM 6970504210080, 192784000052 lumi.remote.b1acn01 remote.b1acn01 alarm_battery, measure_battery No
Aqara Aqara Wireless switch (Gyro) WXKG12LM 6970504210301 lumi.sensor_switch.aq3, lumi.sensor_swit sensor_switch.aq3 alarm_battery, measure_battery No
Aqara Opple Aqara - Opple Switch - 2 button WXCJKG11LM 6970504211964 lumi.remote.b286opcn01 remote.b286opcn01 measure_battery, alarm_battery No
Aqara Opple Aqara - Opple Switch - 4 button WXCJKG12LM 6970504211971 lumi.remote.b486opcn01 remote.b486opcn01 measure_battery, alarm_battery No
Aqara Opple Aqara - Opple Switch - 6 button WXCJKG13LM 6970504211988 lumi.remote.b686opcn01 remote.b686opcn01 measure_battery, alarm_battery No
Xiaomi Xiaomi Light Sensor GZCGQ01LM 6934177710865 lumi.sen_ill.mgl01 sen_ill.mgl01 measure_luminance, alarm_battery, measure_battery No
Xiaomi Xiaomi Door and window sensor MCCGQ01LM 6970244522771 lumi.sensor_magnet sensor_magnet alarm_contact, alarm_battery, measure_battery No
Xiaomi Xiaomi Occupancy sensor RTCGQ01LM 6970244522788 lumi.sensor_motion sensor_motion alarm_motion, measure_battery, alarm_battery No
Xiaomi Xiaomi Temperature and humidity sensor WSDCGQ01LM 6970244522801 lumi.sens, lumi.sensor_ht sens measure_temperature, measure_humidity, measure_battery, alarm_battery No
Xiaomi Honeywell Xiaomi Honeywell natural gas detector JTQJ-BF-01LM/BW 6953046000074 lumi.sensor_natgas sensor_natgas alarm_gas, measure_gas_density No
Xiaomi Honeywell Xiaomi Honeywell smoke detector JTYJ-GD-01LM/BW 6953046000074 lumi.sensor_smoke sensor_smoke alarm_smoke, alarm_battery, measure_battery No
Built-in or plug-in socket switches
Aqara Aqara Double Relay - L1 LLKZMK11LM 6970504210714 lumi.relay.c2acn01 relay.c2acn01.2 onoff, measure_power Yes (1)
Aqara Aqara Double Relay LLKZMK11LM 6970504210714 lumi.relay.c2acn01 relay.c2acn01 onoff, onoff.1, measure_power No Yes*
Aqara Aqara Smart Socket QBCZ11LM 6970504210110 lumi.ctrl_86plug, lumi.ctrl_86plug.aq1 ctrl_86plug.aq1 onoff, measure_power, meter_power No
Aqara Aqara Wall Switch Double (L) - Left QBKG03LM 6970504210028 lumi.ctrl_neutral2 ctrl_neutral2.2 onoff Yes (1)
Aqara Aqara Wall Switch Double (L) QBKG03LM 6970504210028 lumi.ctrl_neutral2 ctrl_neutral2 onoff, onoff.1 No Yes*
Aqara Aqara Wall Switch Single (L) QBKG04LM 6970504210011 lumi.ctrl_neutral1 ctrl_neutral1 onoff No
Aqara Aqara Wall Switch Single (LN) QBKG11LM 6970504210110 lumi.ctrl_ln1, lumi.ctrl_ln1.aq1 ctrl_ln1.aq1 onoff, measure_power, meter_power No
Aqara Aqara Wall Switch Double (LN) - Left QBKG12LM 6970504210134 lumi.ctrl_ln2, lumi.ctrl_ln2.aq1 ctrl_ln2.aq1.2 onoff, measure_power, meter_power Yes (1)
Aqara Aqara Wall Switch Double (LN) QBKG12LM 6970504210134 lumi.ctrl_ln2, lumi.ctrl_ln2.aq1 ctrl_ln2.aq1 onoff, onoff.1, measure_power, meter_power No Yes*
Aqara Aqara D1 Wall Switch Single (L) QBKG21LM 6970504211643 lumi.switch.b1lacn02 switch.b1lacn02 onoff No
Aqara Aqara D1 Wall Switch Double (L) - Left QBKG22LM 6970504211650 lumi.switch.b2lacn02 switch.b2lacn02 onoff Yes (1)
Aqara Aqara D1 Wall Switch Single (LN) QBKG23LM 6970504211667 lumi.switch.b1nacn02 switch.b1nacn02 onoff, measure_power, meter_power No
Aqara Aqara D1 Wall Switch Double (LN) - Left QBKG24LM 6970504211674 lumi.switch.b2nacn02 switch.b2nacn02 onoff, measure_power, meter_power Yes (1)
Aqara Aqara D1 Wall Switch Tripple (L) - Left QBKG25LM 6970504211827 lumi.switch.l3acn3 switch.l3acn3 onoff Yes (2)
Aqara Aqara D1 Wall Switch Tripple (LN) - Left QBKG26LM 6970504211858 lumi.switch.n3acn3 switch.n3acn3 onoff, measure_power, meter_power Yes (2)
Aqara Aqara Smart plug (EU) SP-EUC01 6970504210646 lumi.plug.maeu01 plug.maeu01 onoff, measure_power, meter_power No
Aqara Single Switch Module T1 (With Neutral) SSM-U01 6970504213296 lumi.switch.n0agl1 switch.n0agl1 onoff, measure_power, meter_power No
Aqara Single Switch Module T1 (No Neutral) SSM-U02 6970504213302 lumi.switch.l0agl1 switch.l0agl1 onoff No
Aqara Aqara H1 Wall Switch Single (No Neutral) WS-EUK01 6970504214774 lumi.switch.l1aeu1 switch.l1aeu1 onoff No
Aqara Aqara H1 Wall Switch Double (No Neutral) WS-EUK02 6970504214781 lumi.switch.l2aeu1 switch.l2aeu1 onoff Yes (1)
Aqara Aqara H1 Wall Switch Single (With Neutral) WS-EUK03 6970504214798 lumi.switch.n1aeu1 switch.n1aeu1 onoff, measure_power, meter_power No
Aqara Aqara H1 Wall Switch Double (With Neutral) WS-EUK04 6970504214804 lumi.switch.n2aeu1 switch.n2aeu1 onoff, measure_power, meter_power Yes (1)
Xiaomi Smart socket plug ZNCZ02LM 6970244522818 lumi.plug plug onoff, measure_power, measure_voltage, meter_power No
Xiaomi Xiaomi Smart plug (EU) ZNCZ04LM 6934177706493 lumi.plug.mmeu01 plug.mmeu01 onoff, measure_power, meter_power No
Curtain controllers
Aqara Aqara Curtain Controller ZNCLDJ11LM 6970504210165 lumi.curtain curtain onoff, windowcoverings_set, windowcoverings_state No
Aqara Aqara B1 Curtain Controller ZNCLDJ12LM 6970504211452, 6970504211292 lumi.curtain.hagl04 curtain.hagl04 windowcoverings_closed, windowcoverings_set, windowcoverings_state, measure_battery, button.calibrate No
Lights
Aqara Aqara LED Bulb ZNLDP12LM 6970504211032 lumi.light.aqcn02 light.aqcn02 onoff, dim, light_temperature No
  • Deprecated device drivers will still continue to function but are replaced by a new driver with extended capabilities. Re-inclusion of the device is required to benefit from these new capabilities

Acknowledgements:

This app and driver development has been supported by:

Feedback:

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.

Contributions

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

8 Likes

Changelog:

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
3 Likes

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

Hi,
How is the support for Aqara Water sensor going?

5 Likes

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…

Hello!

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…

Yep…
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…

4 Likes

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

Awesome! Thanks a lot.

@vaderag
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:
Ophanging%202

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.homey.app/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…

https://www.gearbest.com/smart-home-controls/pp_009661787808.html?wid=1433363

@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…