Air Quality Index (AQI)
The aqi sensor platform allows you to compute an Air Quality Index from
PM2.5 and PM10 particulate matter sensor readings. This sensor works with
any PM sensor source, such as PMSX003 Particulate Matter Sensor,
The Grove - Laser PM2.5 Sensor (HM3301), SDS011 Particulate Matter Sensor,
or SPS30 Particulate Matter Sensor.
ℹ️ Note
This platform replaces the deprecated
aqioption previously available in the HM3301 component. The standalone platform is more flexible as it works with any PM sensor.
Two calculation types are supported:
- AQI: US EPA Air Quality Index (0-500 scale)
- CAQI: European Common Air Quality Index (0-100+ scale)
# Example configuration entry
sensor:
- platform: pmsx003
type: PMSX003
pm_2_5:
id: pm25_sensor
name: "PM2.5"
pm_10_0:
id: pm10_sensor
name: "PM10"
- platform: aqi
name: "Air Quality Index"
pm_2_5: pm25_sensor
pm_10_0: pm10_sensor
calculation_type: AQIConfiguration variables
pm_2_5 (Required, ID of a Sensor Component): The sensor providing PM2.5 concentration readings in µg/m³.
pm_10_0 (Required, ID of a Sensor Component): The sensor providing PM10 concentration readings in µg/m³.
calculation_type (Required, enum): The AQI calculation standard to use. Must be one of:
AQI: US EPA Air Quality Index. Returns values from 0-500, where higher values indicate worse air quality. Based on the EPA Technical Assistance Document.CAQI: European Common Air Quality Index. Returns values from 0 upward, where higher values indicate worse air quality. Typically 0-25 is very low, 25-50 is low, 50-75 is medium, 75-100 is high, and >100 is very high.
All other options from Sensor.
Example with CAQI
sensor:
- platform: hm3301
pm_2_5:
id: pm25
name: "PM2.5"
pm_10_0:
id: pm10
name: "PM10"
- platform: aqi
name: "European Air Quality Index"
pm_2_5: pm25
pm_10_0: pm10
calculation_type: CAQI