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

[TedTolboom]

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.

Links:

• Aqara & Xiaomi-mi Zigbee app Athom apps
• Aqara & Xiaomi-mi app Github repository

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:

• @kasteleman
• @baskiers
• @robinbolscher ;

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

[TedTolboom]

Changelog:

v 0.8.0

• Add support for Aqara Smart EU plug (SP-EUC01) (onoff, measure_power, meter_power)
• Xiaomi Smart plug (EU) (ZNCZ04LM)] (onoff, measure_power, meter_power)
• Xiaomi Light Sensor (GZCGQ01LM) (measure_luminance, measure_batery)
• Add humidity and pressure offset settings for the Aqara Temperature and Humidity Sensor (WSDCGQ11LM) and Temperature/Humidity Sensor (WSDCGQ01LM)
• Add reverse contact alarm logic for Aqara Door and Window Sensor (MCCGQ11LM) and Door/Window sensor (MCCGQ01LM)

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

• Add support for the Aqara Tunable LED Bulb (ZNLDP12LM)

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

[TedTolboom]

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

[Spirre]

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

[TedTolboom]

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…

[Marcel_Visser]

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…

[TedTolboom]

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…

[vaderag]

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

[Marcel_Visser]

Awesome! Thanks a lot.

[Eternity]

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

[TedTolboom]

@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

[vaderag]

Fab, thanks

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

[Eternity]

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

[Kevin_Vijver]

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.

[vaderag]

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

[Eternity]

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

[TedTolboom]

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.

@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

[Tim_Messerschmidt]

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

[Marcel_Visser]

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

[Marcel_Visser]

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