QuickApp - Air Quality Sensor

[SmartHomeEddy 881]

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 881]

If you have any trouble, just let me know

[SmartHomeEddy 881]

I use the DHT22 temperature and humidity sensor in my air quality sensor setup. 
 

The DHT22 sensor is originally an Indoor sensor. For outdoor use it appears to be rather sensitive to water condensation after 100% rel.Humidity that keep it for very long time (sometimes forever) at 99.9% value. Also it appears to be sensitive to high UV light, which tends to cause the sensor to crash until hard power-loss restarted. Better experiences have been made with a BME280 or SHT3x sensor. So if you use a DHT22, consider to replace it with a BME280 instead. BTW The BME280 sensor also measures air pressure and costs less than 2 euro. 

 

So next version of this QuickApp will support the BME280 temperature, humidity and air pressure sensor (next to the PM2.5 and PM10 sensor). 

Please login or register to see this image.

/monthly_2020_10/DEBO_BME280_01.jpg.f05658d820734ffcf961626b84d40be3.jpg" />

 

 

Edited October 5, 2020 by SmartHomeEddy

[SmartHomeEddy 881]

A new version of the Air Quality Sensor Quickapp is available with support for the BME280 sensor which next to temperature and humidity also supports air pressure. The BME280 sensor also is more reliable than the DHT22. (The DHT22 sensor is still supported in the QuickApp)

 

 

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

Please login or register to see this attachment.

 

Please login or register to see this image.

/monthly_2020_10/air-quality-sensor-2.png.68dba26bb473e9405362b4d50e32eaea.png" />

 

 

You don't have an Air Quality Sensor? Assemble on for less than 50 euro without soldering, just common sense, see: 

Please login or register to see this link.

 

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.

 

 

You don't have an Air Quality Sensor and you don't want to assemble one? Use the Sensor Community QuickApp to use the PM2.5 and PM10 measurements of someone else-his Air Quality Sensor, see: 

 

Edited September 1, 2021 by SmartHomeEddy

[Dann 4]

Hi SmartHomeEddy,

 

Great work and thanks for sharing-it with the community.

I have a beginner question :  is it possible to have the main Air Quality Sensor as a Generic Device instead of Multilevel Sensor ?

As Multilevel Sensor is showing "0" all the times and this do not bring any additional info.

As Generic Device at least we can allocate-it a nice icon that will be visualise in full size.

 

Looking forward to hear you,

 

With BR

Dan

 

[SmartHomeEddy 881]

Good idea @Dann The “Generic Device” doesn’t support manually change of the icon, so I changed it to the generic device and added a QuickApp Variable where you can fill in the icon number. The icon picture can be added via an other device. 
 

A preview:
 

Please login or register to see this image.

/monthly_2020_10/image.png.3b5c8a970f8b3e9b747617da0ac197b5.png" />

 

It could also be a “Weather Device” ( but also no manually icon change). I was thinking about an icon for every quality level, I will see...
 

The functionality will be available in next update, first some testing if it all works fine. 
 

 

 

Edited October 19, 2020 by SmartHomeEddy

[Dann 4]

Thanks SmarHomeEddy,

 

Looking forward to download the up-dated version once tested.

 

With BR

Dan

 

[SmartHomeEddy 881]

The new release of the QuickApp Air Quality Sensor is available. 

 

Changes version 0.5: 

• 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

 

Please login or register to see this attachment.

 

Please login or register to see this attachment.

 

 

Edited October 23, 2020 by SmartHomeEddy

[SmartHomeEddy 881]

A new version is available with a Child Device for Absolute Humidity and a "Refresh" button

 

Absolute humidity is the measure of water vapor (moisture) in the air, regardless of temperature. It is expressed as grams of moisture per cubic meter of air (g/m3) 

 

The Absolute Humidity is very handy if you want to compare humidity levels inside and outside. Because of the difference in temperature inside and outside, you can't compare relative humidity levels, you need the Absolute Humidity for that purpose. 

 

Please login or register to see this attachment.

 

Please login or register to see this attachment.

 

 

[Rafal100 2]

Is it possible to buy this as a ready to use kit?

Edited January 25, 2021 by Rafal100

[SmartHomeEddy 881]

@Rafal100 Not that I know. Although somewhere there must be someone who want to earn a buck in assembling these sensors. Also in Poland there are a lot of these sensors live. 

 

Please login or register to see this image.

/monthly_2021_01/image.png.760867fec59f36599da67667094ab9b0.png" />

 

But it is very easy to assemble a sensor yourself. Just connect the right ports with some wire, put the software on the device and you're off. I have made several for my house. If you want to, I can help you long-distance. You can find a step-by-step list here: 

Please login or register to see this link.

 

 

If you really are not up to assembling the sensor, you can also use the other QuickApp to use a sensor in your neighborhood. If one of your neighbors has one, you can use the readings of that sensor.  Look here to locate one in your neighborhood: 

Please login or register to see this link.

 

 

This is the QuickApp to use a sensor not your own: 

(With very soon a big update with also Temperature, Humidity, Absolute Humidity and Air pressure) 

 

[Rafal_ll 6]

6 godzin temu, Rafal100 napisał:

Czy można to kupić jako gotowy do użycia zestaw?

 Dasz radę

Zajrzyj tutaj instrukcja krok po kroku i zestaw części.

Please login or register to see this link.

[SmartHomeEddy 881]

That is a great offer @Rafal_ll. Less than 50 euro is great for a complete kit. If you order it separately on AliExpress, it will cost less, but then you still have to buy the pipe and a piece of tube. And delivery will take longer. 
 

Please login or register to see this attachment.

 

Just do it, you only have to put the wires on the right connector  

 

 

[Rafal_ll 6]

 

All OK . it worked
Thanks for sharing the QA 

 

 

 

 

I don't understand something. Please, what am I doing wrong.
How to set it up

 

 

Please login or register to see this attachment.

Please login or register to see this attachment.

Edited January 26, 2021 by Rafal_ll

[SmartHomeEddy 881]

Yes, the IP address does the job, for the rest the default should be ok . 

[Rafal100 2]

Thanks guys for recommendation, I bought the sensor I will try to play with it next week and configure with HC3 

[Rafal_ll 6]

W dniu 26.01.2021 o 18:39, SmartHomeEddy napisał:

Tak, adres IP załatwi sprawę, dla reszty domyślny adres powinien być w porządku. 

If the IP is not enough. It hung up and I can't reconnect. HC3 reset did not give anything, the sensor  reset, I changed IP, Refreshed, etc.

[SmartHomeEddy 881]

You could test it in your browser, with ip address and path. If I look at the picture in your case:

 

192.168.1.109/data.json

 

It should give a response like this:

Please login or register to see this code.

 

[Rafal_ll 6]

Please login or register to see this code.

Edited January 30, 2021 by Rafal_ll

[SmartHomeEddy 881]

1 hour ago, Rafal_ll said:

value_type":"PMS_P0","value":"17.25"},{"value_type":"PMS_P1","value":"35.00"},{"value_type":"PMS_P2","value":"29.00"}

yes, this is the issue. try it with the other sensor to see if it works. 
 

I think I can change the quickapp to support the Plantower What are the 3 values? PM1.0 PM2.5 PM10 ?

 

Edited January 30, 2021 by SmartHomeEddy

[Rafal_ll 6]

With SDS011 sensor works
You did your job well.
It was my combinations that disabled QA

 

Today I will replace the sensor and check it will work.

 

 

{"software_version": "NRZ-2020-133", "age":"143", "sensordatavalues":[{"value_type":"PMS_P0","value":"7.25"},{"value_type":"PMS_P1","value":"16.75"},{"value_type":"PMS_P2","value":"15.00"},{"value_type":"BME280_temperature","value":"25.32"},{"value_type":"BME280_pressure","value":"99718.44"},{"value_type":"BME280_humidity","value":"34.79"},{"value_type":"samples","value":"5062203"},{"value_type":"min_micro","value":"28"},{"value_type":"max_micro","value":"8816"},{"value_type":"interval","value":"145000"},{"value_type":"signal","value":"-61"}]}

 

 

{"value_type":"PMS_P0","value":"7.25"}      this    PM-1
{"value_type":"PMS_P2","value":"15.00"}     this   PM-2.5
{"value_type":"PMS_P1","value":"16.75"}      this   PM-10

Edited January 31, 2021 by Rafal_ll