QuickApp - Air Quality Sensor

[SmartHomeEddy 814]

This QuickApp reads the PM1, PM2.5, PM4, PM10, Temperature, Humidity and Air Pressure (and calculated absolute Humidity) values directly from a sensor. With this sensor you can measure air quality yourself. This QuickApp will send notifications when PM2.5 or PM10 readings reach a breakpoint. 

 

The Air Quality sensor is a DIY setup for less than 50 euro. It is very easy to assemble and ready to make kits are available, see also

Please login or register to see this link.

 for more info. 
 

You can order seperate items from for example AliExpress for the lowest prices, or order a complete set from: 

Please login or register to see this link.

 or

Please login or register to see this link.

 

 

Please login or register to see this attachment.

 

The Air Quality Sensor has a WiFi interface and Application Programming Interface (API). This QuickApp uses the API to get the measurements available to the Fibaro Homecenter. 

 

Changes version 1.2 (11th April 2021)

• Added support (child devices) for PM1 and PM4 levels (Plantower and Sensirion sensors)
• Added support for BMP280 sensor

 

Changes version 1.1 (31th Januari 2021)

• Added support for Plantower Air Quality Sensor (for now without PM1.0)
• Added Airpressuretext to log of Child Device Airpressure
• Added Quickapp variable for debug level (1=some, 2=few, 3=all). Recommended default value is 1.
• Removed QuickApp Variable bme280Sensor (no need for that anymore, works without it)
• Removed QuickApp Variable path (is now fixed)

 

Changes version 1.0 (23rd January 2021)

• Added Child Device for Absolute Humidity
• Added "Refresh" button

 

Changes version 0.5 (23rd October)

• With the new firmware and API function, solved a small bug in presenting WiFi dBm
• Changed humidity and air pressure values to zero decimals
• Added air pressure unit text "hPa"
• Changed the master device to "Generic Device" 
• Added QuickApp Variable for user defined icon master device
• Solved a bug preventing creation of QuickApp Variable bme280Sensor

 

Changes version 0.4 (17th October 2020)

• Added support for BME280 sensor (temperature, humidity and air pressure)
• Added QuickApp Variable bme280Sensor (true or false) to indicate the presence of a BME280 sensor otherwise a DHT22 sensor is assumed
• Reduced the amount of labels, now only one label
• Removed the firmware version from the log under the icon

 

Changes version 0.3

• Error message instead of debug message in case of an error
• Changed method of adding QuickApp variables, so they can be edited
• Added network error to log (under icon)

 

Changes version 0.2

• Changed label6 from "age" to time of the measurement
• Added automatic creation of child devices for Temperature, Humidity, PM2.5 and PM10 (with great help from @jgab from forum.fibaro.com)
• Added the value (Temperature, Humidity, PM2.5 and PM10) to the child devices, This can be used in, for instance, extra scenes and shows in the mobile app and dashboard. 
• Added a short text of the air quality (GOOD, SATISFACTORY, etc.) to the icons in the dashboard (with great help of @petergebruers and @10der from forum.fibaro.com)
• Added the trend (up, down, equal) to the sort text of the air quality

 

My configuration of the DIY air quality sensor:

• Nova SDS011 air quality sensor
• NodeMCU ESP8266 V2 opensource WiFi board
• BME280 temperature, humidity and air pressure sensor

 

See how to simply assemble the air quality sensor yourself: 

Please login or register to see this link.

See for general informatie about the Air Quality Sensor: 

Please login or register to see this link.

See for a map of measurements:

Please login or register to see this link.

See for CVS files:

Please login or register to see this link.

See for sources: 

Please login or register to see this link.

 

QuickApp variables (mandatory, they will be automatically added with the default values):

• IPaddress = IP address of your sensor
• Path = Path behind the IP address, normally /data.json
• Interval = Number in seconds, the sensor normally is updated every 145 seconds
• UserID = User id to notify of PM2.5 / PM10 breakpoints
• bme280Sensor = Use of BME280 temperature, humidity and air pressure sensor, true or false 

 

 

Please login or register to see this attachment.

 

PM2.5 breakpoints

0 - 30        GOOD (Minimal)

31 - 60      SATISFACTORY (Minor breathing discomfort to sensitive people)

61 - 90      MODERATELY POLLUTED Breathing discomfort to asthma patients, elderly and children

91 - 120    POOR (Breathing discomfort to all)

121 - 250  VERY POOR (Respiratory illness on prolonged exposure)

250+         SEVERE (Health impact even on light physical work. Serious impact on people with heart/lung disease)

 

PM10 breakpoints

0 - 50        GOOD (Minimal)

51 - 100    SATISFACTORY (Minor breathing discomport to sensitive people)

101 - 250  MODERATELY POLLUTED Breathing discomfoort to asthma patients, elderly and children

251 - 350  POOR (Breathing discomfort to all)

351 - 430  VERY POOR (Respiratory illness on prolonged exposure)

430+         SEVERE (Health impact even on light physical work. Serious impact on people with heart/lung disease)

 

 

Please login or register to see this attachment.

 

 

 

 

Download the QuickApp here (download the file and un-zip):

Please login or register to see this link.

 

Or Fibaro Marketplace: 

Please login or register to see this link.

 

How to install: 

1. Open the Configuration Interface
2. Go to Settings > Devices
3. Click  +
4. Choose Other Device
5. Choose Upload File
6. Choose file from your computer with .fqa

 

 

 

 

 

Edited October 19, 2021 by SmartHomeEddy

[SmartHomeEddy 814]

I added support for Plantower Air Quality Sensor (for now without PM1.0). I send you a PM for a small test. 

 

Thanks for testing.

 

 

Edited January 31, 2021 by SmartHomeEddy

[SmartHomeEddy 814]

A new version of the Air Quality Sensor is available. 

Changes version 1.1 (31th Januari 2021)

• Added support for Plantower Air Quality Sensor (for now without PM1.0)
• Added Airpressuretext to log of Child Device Airpressure
• Added Quickapp variable for debug level (1=some, 2=few, 3=all). Recommended default value is 1.
• Removed QuickApp Variable bme280Sensor (no need for that anymore, works without it)
• Removed QuickApp Variable path (is now fixed)

 

 

Edited January 31, 2021 by SmartHomeEddy

[Rafal100 2]

I successfully installed your app and works amazing. However I'm struggling how to hide or change the icon for "Jakosc powietrza". Are you able to help me? I'm also not able to change the icons for PM2.5, PM10...

Please login or register to see this attachment.

Edited February 1, 2021 by Rafal100

[SmartHomeEddy 814]

The icons for Absolute Humidity, PM2.5 and PM10 should be possible to change with the normal user interface. You can select an icon, but you I think you need to be logged in locally, not remote.  
 

Please login or register to see this attachment.

 

For the Jakosc powietrza device you need to get the ID of an existing icon on your HC3. Just use the normal user interface to add an icon with for example the PM2.5 device. Give a right mouse click on the icon, select the link and see in your browser the number of the icon, for example 1052. Add that number in the quickapp variable "icon". 
 

Please login or register to see this attachment.

 

Please login or register to see this image.

/monthly_2021_02/F4D86E65-3865-4786-8F25-788D4F006B6D.jpeg.9c2bd177fe819f3f0c26630eb1446ed7.jpeg" />

Edited February 1, 2021 by SmartHomeEddy

[Rafal100 2]

2 godziny temu, SmartHomeEddy napisał:

The icons for Absolute Humidity, PM2.5 and PM10 should be possible to change with the normal user interface. You can select an icon, but you I think you need to be logged in locally, not remote.  
 

Please login or register to see this attachment.

 

For the Jakosc powietrza device you need to get the ID of an existing icon on your HC3. Just use the normal user interface to add an icon with for example the PM2.5 device. Give a right mouse click on the icon, select the link and see in your browser the number of the icon, for example 1052. Add that number in the quickapp variable "icon". 
 

Please login or register to see this attachment.

 

Please login or register to see this link.

 Thanks! 

[Rafal100 2]

Another issue noticed. I'm getting a different values in QuickApp and in sensor interface. I tried to refresh in the same time but the value are still different. The funny thing is that I also integrated the sensor with aqi.eco and also I'm getting different values.

 

In mobile application I'm also getting 2 different Temperature values: -2,6 and -3,4, I have no idea why. Your QuickApp is the only device assigned to "Podworko" section.

 

Please login or register to see this attachment.

Please login or register to see this attachment.

Edited February 2, 2021 by Rafal100

[SmartHomeEddy 814]

In de "mother" device of the quickapp, you can see the date/time of the measurement. That is the actual date/time of the measurement of the sensor (not a systemdate of the refresh moment of the quickapp itself). That date/time is the same as the "age" value in the Sensor app (in your example 6 seconds ago). 

 

The air quality sensor updates by default every 145 seconds. The quickapp default update is every 146 seconds. With these values you get a new measurement every time the quickapp refreshes. But you can also be a bit behind of the sensor data. If you get the data from the sensor and the sensor get its data 1 second later, you get a difference in the two apps and it wil take 145 second (146 - 1) for the quickapp to get the new values. 

 

You could increase the quickapp refresh time (interval) for example to 70 seconds, or even to 10 seconds. With that interval of 10 seconds you can only be 10 or 9 seconds behind the measurement of the sensor. 

[SmartHomeEddy 814]

Soon to come in your HC3, also support of PM1 and PM4 air quality levels for Plantower and Senserion sensors
 

Please login or register to see this attachment.

[SmartHomeEddy 814]

A new version of the QuickApp is available with support (child devices) for PM1 and PM4 levels (Plantower and Sensirion sensors) and BMP280 sensor. 

 

Please login or register to see this attachment.

 

Please login or register to see this attachment.

[SmartHomeEddy 814]

A new version of this popular QuickApp is in the making.
 

Two Quickapps will be combined in one. That way you can simply choose if you want to monitor your own local sensor or someone else sensor in your neighborhood from the sensor.community cloud.

 

Some new function will be implemented, new child devices will be added and translation for English, Polish, French and Dutch will be available. 

[SmartHomeEddy 814]

There had been an update of the (airrohr) firmware of the Sensor Community Air Quality Sensor: NRX-2024-135. 

 

(The QuickApp still works fine)