[Release] Xiaomi / Aqara ZigBee device drivers



The temperature & humidity sensor very reliably reports changes in temperature & humidity. When there is no change in either, the reporting interval is around 1 hour (or longer).

You will need to have a Xiaomi Aqara compatible zigbee mesh for these sensors to work reliably. I invested in several Tradfri plugs.


Well there are a few logistical problems to add to that:

  • How do you solve the WAF problem? I've never been very good at engineering solutions for that, mainly because it's not really an engineering problem :slight_smile:
  • Related to the above, but also for insurance purposes: How do you get in-wall power to these without violating building codes? Fortunately, my state is still NEC 2011 based, so I don't need to be an electrician to do low voltage (this is an absurd requirement in the 2018 NEC) but still, I haven't found a good method of using (for example) USB power over long distances. I haven't yet found an in-wall DC 24v transformer that I can combine with an in-wall 24vDC to 5vDC step down on the other end so that only the end of the USB port protrudes from the wall (sending 5v the whole way is just asking for a bad voltage drop) I'm also seriously lacking in knowledge when it comes to the electrical. I just don't know how all of that is supposed to work, beyond that I'm using cl2 wiring. I've found some components like these, but no mention of whether they're UL listed.


Ikea is just down the street from me, so I think I'm going to pick a few up. Anyways, how about pressure changes?


Pressure changes are reported, but I don't know if a change in pressure triggers a report.


So far this is the best price I've seen without ordering from China:

Main reason I like Amazon is it's so easy to return stuff that sucks, is broken, etc. I've had way too much difficulty when ordering stuff from China. For me to do that, it has to be so cheap that it's not even worth trying to return (and even then, sometimes it will piss me off anyways, like this time I ordered something for $5, it didn't work at all, and they only offered me a $5 off of $70 coupon instead of a refund. What assholes. Good thing my credit card allows chargebacks.)


While the important thing to understand about the Aqara Motion Sensor's lux reports is they only happen when motion is detected, it is equally important to know that the lux report message is received by the hub some milliseconds before the motion detected message.

This sometimes results in the motion detected event occuring before the lux value event (due to the timing of separate instances of the driver code running for each message received). So, it's possible that an automation triggered by motion detected will be making decisions based on the previous lux value (since the new lux value event may not have occurred quite yet.) So it's best to insert some kind of short delay before the automation / rule evaluates whether action should be taken / not taken based on the lux value.

First off, the Aqara Temp-Humidity Sensor is designed to report Atmospheric Pressure in an open-air environment. So it may or may not work well as a sensor for measuring air pressure of an HVAC system. I have read of one person using it that way, @brianspranger, but I can't seem to find his post on the ST forums about it at the moment.

Otherwise, as far as frequency of pressure (and temperature and humidity) reports goes, I'll repeat what I've stated in this post:

Here is the best documentation I have found, located in the GitHub repository of the parent company Lumi United Technology's:

When the temperature and humidity sensor detects temperature changes over 0.5 degrees or more than 6% humidity change, a report will be sent. The atmospheric pressure value will be sent along with the temperature or humidity report. The Temperature and humidity sensor also reports the current temperature, humidity, and atmospheric pressure values during each heartbeat.

Note: when they say "temperature changes over 0.5 degrees" they are talking about changes in degrees Celcius.

Despite what Lumi states above, in my experience, the reports are not as consistent as would be expected. I have seen the sensor wait to report on temperature changes in excess of +/- 5° C. Also, temperature changes seem to have priority over humidity changes. So the sensor seems to sometimes wait for a +/- 5°C temperature change before sending a report, even though humidity has changed more than +/-6%.

However, changes in pressure values alone do not result in a temp/humidity/pressure report being sent. The pressure value report just "rides along" for reports sent when either the temperature or humidity has changed past the above mentioned thresholds.



That is a very good price. Just keep in mind that private seller sale policy will be what Amazon refers to in a dispute. I got screwed by a private seller offering, that was fulfilled by Amazon. Their listing looked like I was getting three motion sensors. What I received was three motion sensor stands.

Amazon sided with the seller. First time that happened to me. I’m more cautious about private sellers on Amazon now.


Was that a prime order? In my experience, Amazon policy always takes precedence over the seller's rules if it's fulfilled by Amazon. This one is fulfilled by Amazon as well, so returns won't even cost anything if it's crap. Two day shipping on this as well (just ordered it an hour ago, guaranteed Monday delivery date.)


Not prime. I argued. Lost


Nah, no losing, it's actually good info and I've experienced the same on Amazon. Any purchase I'm uncertain about, I stick to prime for that reason.

Anyways what I've been reading so far tells me that indeed these are a poor choice for HVAC filters. Nonetheless, people seem to be using them for bathroom fans with decent results. I was thinking about going with Iris v3s on ebay, but meh, at this price I'd only be saving a dollar each tops, I think I'd rather have the safety net amazon provides over saving four dollars, and I already bought 10 iris v2's at $5 a pop, so I already have their supposedly very good motion sensing capabilities (haven't deployed them yet.) And who knows, maybe I'll find a use for atmospheric pressure later on?

Anyways, anybody have any suggestions for what I might do for an HVAC filter replacement sensor that won't break the bank? I've already got my ecobee telling me when 300 hours have passed, but between my cheap costco air purifiers and xiaomi knockoff roomba, I've got the dust and dander situation so well under control that I think 300 hours may be too often, and at the same time, Phoenix dust storms are too unpredictable, so I'm looking for a more accurate way of determining this. So far, measuring pressure seems to be the best way, but I haven't yet found an ideal solution that would also allow me to integrate with hubitat.


This driver is super cool, thanks for doing it.

It looks like this sensor also reports 3 Axis but the driver doesn't advertise that as a capability?


Having used a few Xiaomi products for over a month, my contact sensors have 'dropped' off. They stay connected for ~50 mins and then disappear. Shame as they worked flawlessly for a month.


Are your zigbee repeaters Xiaomi compatible? Do you have a mix of Xiaomi-compatible and incompatible zigbee repeaters?


sorry so which are the better ones, the round ones or the square with rounded edges ?


The square with the rounded edges are newer. Even newer ones that are zigbee 3.0 compliant are anticipated to be released soon. They were supposed to be out in August.


I am itching for the "-T" models to be commercially available.

Even if they are 2x the cost of the old ones (which I expect they will be) I'll buy a batch as soon as available for testing.


I didn't have repeaters in place. It was a small setup with the sensors connected directly to the hub. Do you think it could be signal issues? Not much has changed in the last month in terms of devices etc.




Okay thanks, I'll get a repeater and see!


A ball-park recommendation is one powered repeater for every 6 battery-powered devices. Also, there are specific repeaters that work with Xiaomi sensors. The Ikea Tradfri Outlet is one of them, and relatively inexpensive at $9.99