Central topic for questions/discussing the official AirGradient App. You can use this topic to ask questions and share your experiences with the devices from AirGradient.
This app is developed by @Doekse in collaboration with AirGradient. For support use the e-mail link on the Homey App Store page. Support Contact »
The AirGradient app for Homey was initially developed by @gslender in collaboration with the AirGradient team, and for that a thousand times thanks! I recently took over and have spent the last little bit building on top of what was already there. I had a couple of goals in mind:
Those goals have grown into the upcoming version 2.0.0 of the app (in test soon™), with a few extras along the way!
Homey Cloud support means you can connect both indoor and outdoor monitors using an API token from your AirGradient dashboard. Homey Pro users can continue to connect their monitors locally.
A big part of this update is making the readings easier to understand. Knowing your CO₂ or particulate matter reading is useful, but having a clear indication of what that value means makes it much easier to do something with it. The app now adds levels for CO₂, particulate matter, VOCs and NOx, which you can also use in your Flows.
I’ve used published scientific research, established air quality frameworks and sensor manufacturer guidance as the basis for these levels and calculations. That includes the EPA’s air quality index framework, Sensirion’s guidance for VOC and NOx indexes, and Environment Canada’s humidex guidance. The app currently uses the older EPA PM2.5 breakpoints to align with the AirGradient scale used in this implementation.
Where there is no official threshold, such as for PM1, the app uses a documented estimate informed by research, including this study of PM1 in indoor and outdoor air. The levels are practical indicators: VOC and NOx indexes, for example, show changes relative to the sensor’s recent baseline.
For indoor monitors, I’ve added GO IAQS, the Global Open Indoor Air Quality Score. The app uses the Starter version, which combines PM2.5 and CO₂ into a score from 0 to 10, with 10 being the best. It gives you three clear categories: good, moderate and unhealthy.
The score follows AirGradient’s published algorithm and is driven by whichever of the two readings scores worse. That means a good CO₂ reading won’t hide a high particle reading, or the other way around. You can use changes in the score or category in Flows, and enable notifications that tell you whether PM2.5, CO₂ or both are behind an unhealthy score.
For outdoor monitors, the app adds US AQI based on PM2.5, along with a Breezy dashboard widget to keep an eye on it. There are also new measurements for dew point, absolute humidity and humidex, giving you a bit more context around temperature and humidity.
For locally connected indoor monitors, you can now adjust the display and LED bar brightness and change the LED bar mode, including through Flows. Handy if you want the monitor to dim when you go to bed! There are also options to test the LED bar and request CO₂ calibration.
Another addition I’d love people to test is the experimental sunlight correction algorithm for outdoor monitors. Direct sunlight can heat up the enclosure and make the reported temperature higher than the surrounding air. This algorithm looks at how the temperature changes over time and estimates a correction for that extra heat.
You can enable it in the outdoor monitor’s settings under Direct sunlight compensation (Experimental). The AirGradient team is also testing it, and I’d be interested to hear how it behaves with your setup, especially if you have another thermometer in the shade to compare it with. It’s still experimental, so feedback will help improve it.
One thing to keep in mind if you already use the app: the old indoor and outdoor drivers are being deprecated. The old drivers will still keep working, but for the new features you’ll need to remove and add that device again via the new drivers. The app will show a notice if your monitor still uses one of them.
Thanks again to @gslender and the AirGradient team for everything that was already there. I’m looking forward to hearing what you’ll think and how the update works with your monitors!
So, You’re a developer too now @Doekse? 
20 apps and counting 
If my girlfriend asks where I am by the way, you haven’t seen me and know nothing…
