Overview
Supported devices
Brand | Model | Type | Fingerprint
---------------------------------------------------------------------------------------------
Xiaomi/Mijia | MCCGQ01LM | Contact Sensor | LUMI/lumi.sensor_magnet
Xiaomi/Mijia | RTCGQ01LM | Motion sensor | LUMI/lumi.sensor_motion
Aqara | MCCGQ11LM | Contact Sensor | LUMI/lumi.sensor_magnet.aq2
Aqara | RTCGQ11LM | Motion and Illuminance sensor | LUMI/lumi.sensor_motion.aq2
Aqara | RTCGQ14LM | Motion and Illuminance sensor P1 | LUMI/lumi.motion.ac02
Aqara | RTCGQ13LM | High Precision Motion Sensor | LUMI/lumi.motion.agl04
Aqara | RTCZCGQ11LM | Presence Detector FP1 | aqara/lumi.motion.ac01
Aqara | DJT11LM | Vibration Sensor | LUMI/lumi.vibration.aq1
Aqara | DJT12LM | Vibration Sensor T1 | LUMI/lumi.vibration.agl01
Tuya | QWS-001 | LCD Temperature and Humidity Sensor | _TZE200_bq5c8xfe/TS0601
Tuya | CX-0726 | LCD Temperature and Humidity Sensor | _TZE200_qoy0ekbd/TS0601
Tuya | | Temperature and Humidity Sensor | TUYATEC-yg5dcbfu/RH3052
Tuya | | Temperature and Humidity Sensor | TUYATEC-v3uxbuxy/RH3052
Tuya | | Temperature and Humidity Sensor | TUYATEC-gqhxixyk/RH3052
Tuya | | Temperature and Humidity Sensor | _TZ3000_fllyghyj/TS0201
Invitation
Please install
Zigbee Sensors Edge Driver [YG] from the following channel
Signal Strength
The devices, created by this driver will show Signal strength (LQI/RSSI) in detailed view.
Link Quality Indication (LQI) is a cumulative value used in multi-hop networks to assess the cost of a link.
Received Signal Strength (RSSI) is a measure of incoherent (raw) RF power in a channel.
The LQI will be shown as reported by the hub, without any transformation (i.e. will have 0-255 range).
Good values for strong network are above 150.
Similarly, RSSI values are not transformed.
RSSI value above -60 dbm (i.e -59 and higher) indicates a strong network.
For values below -70 dbm adding Zigbee repeaters should be considered.
Please refer to Microchip’s article for more details.
Battery voltage
Some devices report the battery voltage, instead of remaining battery (in %).
Whether supported by the device, Battery voltage measurement will be shown in the detailed view.
Pairing Xiaomi devices
Xiaomi sensors might have an issue paring.
Since those are sleepy devices, it is somethines required to wake them up during pairing.
- Put the hub into paring mode
- Long press a button on device until is starts blinking
- Release the button, wait for the device to stop blinking
- Short press button with the same time interval to prevent device going into sleeping mode
Note the led, press button only if the led is off.
It may take several attempts to successfully pair them.
Notes on Battery reporting
Aqara sensors reports battery once in a hour or so.
It is normal that you see battery 0% for up to 2 hours after pairing.
If the problem persists, please collect logs for at least 2 hours and provide them either in this post or as DM.
Notes on configuring sleepy devices
Sleeping devices need to be waken up during configuration. Otherwise, the configuration message might not be processed by the device and in most cases “Network error” would be shown.
To configure the device, press pairing button with 1 second or so interval immideately before and during configuration changes.
Notes on connectivity issues
Zigbee is a mesh network, devices connect to each other. Only some devices are connected directly to the hub. The devices that can recieve mesages from other devices and fowrward them further are called routers. More routers usually means stronger network.
Battery powered devices are always end devices (or sleepy devices), they do not forward messages.
Mesh network is constantly (but slowly) changing. That means the path from specific device to the hub (and back to the device) might change over the time. Even if you pair device near to hub, it is not guaranteed that the device would be connected directly to it. Further, even if the device was connected to the hub, after a while it can reconnect through diferent routers/repeaters, even though the hub seems to be closer.
There are multiple reasons for disconnected devices:
-
compatibility (some devices are using proprietary messages that are not recognized by routers or are just not fully compliant)
-
signal streangth (too far from repeaters or interference with other wireless networks, like WiFi)
-
loaded network (the number of messages exceed the throughtput of the network)
To help to troubleshoot connectivity issues, most, if not all devices have signal strength capability (see Signal Strength above)
Sleepy (battery powered) devices usually have weaker radio. If the signal strength is low, they might not work well, even if you have perfectly working modules/switches nearby.
Xiaomi/Aqara connectivity issues
Xiaomi/Aqara devices, especially sensors might be working in sticky parent mode. This means, they are not using automatic zigbee rerouting. Therefore, it is highly refommended to pair Aqara devices after all routers are in place and connected and to do it in the exact device location.
Notes on adding devices requests
If you want your device to be added to this driver, please provide
-
A fingerprint (model/manufacture) or at least the exact vendor name and model number (like Xiaomi MCCGQ01LM). This is absolutly a must. It is not sufficient to provide only a device picture. There are devices that look very much alike, but work quite different.
-
A link to product description (could be vendor’s site or even ebay/aliexpress, etc listing). This is needed to understand what capabilities are supported
-
If you have a link to DTH, it could also help
Please also be prepared to provide logs from CLI.
Devices
Contact Sensors
Please note, Aqara E1 MCCGQ14LM (lumi.magnet.acn001) sensor is not supported.
| Name | Mijia Door & Window Sensor | Aqara Door & Window Sensor |
|---|---|---|
| Model | MCCGQ01LM | MCCGQ11LM |
| Image | ||
| Capabilities |
|
The same as for MCCGQ01LM |
| Battery | CR1632 | CR1632 |
In addition to contact sensor status and battery, the detailed view will show original (unmodified) battery voltage readings, received from the device and signal strength.
The driver allows to change icon for your contact sensor.
The supported icons are:
- contact sensor (this is the default)
- switch
- lock
- door bell
- refrigerator
Motion Sensors
| Name | Mijia Human Body Sensor | Aqara Motion and Illuminance Sensor |
|---|---|---|
| Model | RTCGQ01LM | RTCGQ11LM |
| Image | ||
| Capabilities |
|
|
| Settings |
|
|
| Battery | CR2450 | CR2450 |
| Dimensions | 30×30×33 mm | |
| Notes |
|
| Name | Aqara Motion and Illuminance Sensor P1 (MS-S02) | Aqara High Precision Motion Sensor |
|---|---|---|
| Model | RTCGQ14LM | RTCGQ13LM |
| Image | ||
| Capabilities |
|
|
| Settings |
|
|
| Battery | CR2450 | CR2450 |
| Dimensions | 33.1×33.1×41.6 mm | 74×74 ×43.3mm |
| Notes |
|
|
Usually, sleepy motion detectors are not checking motion constantly. Instead, they check motion, report if it was detected and go to sleep. If the motion is no longer detected, they do not report anything, they just go to sleep.
To clear motion, the driver schedules a timer, once motion is detected. It will fire after “no motion interval", unless another motion is detected during this period. This setting is also sometimes called cool down period.
Motion sensors have configurable (in settings) no motion interval.
After motion is detected, the sensor will go back to no motion after specified period of time,
unless a new motion is detected.
In addition, some devices, like RTCGQ14LM and RTCGQ13LM support configurable Detection interval. This is the time period the device waits before retrying to detect motion. This setting is configured on device itself. The minimal value depends on sensor’s firmware. The driver allows 0-255, but the device might reject the setting.
Presence Detectors
| Name | Aqara Presence Detector FP1 |
|---|---|
| Model | RTCZCGQ11LM |
| Image | |
| Capabilities |
|
| Not supported by driver |
|
| Notes |
|
Please also see
Vibration Sensors
| Name | Aqara Vibration Sensor | Aqara Vibration Sensor T1 |
|---|---|---|
| Model | DJT11LM | DJT12LM |
| Image | ||
| Capabilities |
|
|
| Not supported by driver |
|
|
| Battery | CR2032 | CR2032 |
| Dimensions | 36x36x9 mm | 36×36×9 mm ? |
| Notes |
Temperature and Humidity Sensor
(Since v1.2)
| Tuya LCD Temperature and Humidity Sensor QWS-001 | Tuya LCD Temperature and Humidity Sensor CX-0726 | Tuya Temperature and Humidity Sensor RH3052 |
 |
Supported capabilities:
- temperatureMeasurement
- relativeHumidityMeasurement
- battery
- signalStrength
Notes:
- Temperature and Humidity Sensors allow changing profiles to select how the device is shown in dashboard. This option is available in settings.
The supported options are- Temperature
- Humidity
- Multitile - the device will occupy 4 tiles and show all available info
- QWS-001 and CX-0726 are using Tuya proprietary cluster EF00
- RH3052 models are using standard reporting
Change log
v1.8.14
- Add support for Mijia Motion sensor RTCGQ01LM
- Add support for Vibration Sensor T1 DJT12LM
- Add support for Tuya Temperature and Humidity Sensor
- TUYATEC-gqhxixyk/RH3052
- _TZ3000_fllyghyj/TS0201
v1.8.0
- Add support for Aqara Vibration Sensor DJT11LM
- Rename “Presence Detection Sensitivity” to “Sensor Detection Sensitivity” for
- Aqara High Precision Motion Sensor RTCGQ13LM
- Aqara Motion and Illuminance sensor P1 RTCGQ14LM
- Aqara Presence Detector FP1 RTCZCGQ11LM
Thanks to @montyfert for testing
v1.7.0
- Add support for Aqara High Precision Motion Sensor RTCGQ13LM
- Allow user to set signal strength update interval in setting for the following profiles:
- Aqara Motion P1
- Aqara High Precision Motion Sensor RTCGQ13LM
- Aqara Presence Detector FP1 RTCZCGQ11LM
- Aqara Contact Sensors
v1.6.2
Add support for Aqara Motion and Illuminance Sensor P1 (MS-S02)
v1.5.7
Add support for Aqara Presence Detector FP1
v1.4.3 2022-06-08T20:45:12.934280663
Fix an issue with Tuya sensosrs that ocasionally show zero values.
While Tuya sensors use proprietary messages to report the the attributes, some of them might also report incorrect (zero) values under standard clusters.
The fix ignores standard attribute reporting for devices that use proprietary messaging.
v1.4.1 2022-05-28T21:49:26.426404501Z
Allow changing dashboard tile for Tuya Temperature Humidity sensor
User can select
- Temperature
- Humidity
- Multitile
v1.4 2022-05-27T19:20:47.838285380Z
Add support for Tuya Temperature Humidity sensor
- TUYATEC-yg5dcbfu/RH3052
- TUYATEC-v3uxbuxy/RH3052
v1.3 2022-05-16T21:16:58.594953
- Add support for Tuya Temperature Humidity sensor CX-0726
v1.2 2022-03-05T12:344:17.571490Z
- Add support for Tuya Temperature Humidity sensor QWS-001
v1.1 2021-12-10T20:01:20.394087
- Add support for Aqara Motion and Luminance sensor RTCGQ11LM
- Remove fingerprint for MCCGQ14LM contact sensor ( see Supporting new E1 Aqara devices for details)
Cheers,
Yakov
