Indoor Air Quality Sensor Component

Hello :blush:

Schematic is simplest. There are only 4 wires:

Current version of code:

Note: I have more than one sensor block connected to this ESP32. So the code is a bit redundant.


Just a heads up, In your install instructions for HACs you miss out adding your repository into HACs itself.
Need to add a line saying to copy and paste the GIT url into the settings page on HACs as an integration.

(I’m a newbie with custom components so had to work this out)

Oh, sorry. I was hoping that ludeus would quickly add this component to the repository, but I didn’t take into account that the format of the repository has changed since the last my component was added. And the addition is stuck …

In the near future we’ll fix everything and this remark will not be needed :slight_smile:

No problem! :slight_smile: I hope I can build a couple of sensors to give it a try in the coming weeks.
I imagine the minimum requirement to get it working is Temp & Humidity?

Edit- Ignore me, I saw your post above listed the- CJMCU-8128. I got confused because the image shows the BME280. I’ve just ordered the required sensor.

New version of sensor published.

New sources available:

  • Ultrafine particles (PM0.3, PM0.5, PM1.0, PM2.5, PM5, PM10)
  • Nitrogen Dioxide (NO2)
  • Carbon Monoxide (CO)
  • Formaldehyde (HCHO; CH2O)

Using latest version, “State update” is executed only once at startup, no updates after that.

Please, make a new issue here:

The sensor tries to save computer resources as much as possible. Sensor values are recalculated only when the values of the source sensors change. In addition, each source has ranges of values that do not change the index. So index changes can occur irregularly.

To check the operation of the sensor, you can enable the mode of displaying debugging information in the logs:

# Example configuration.yaml entry
    custom_components.iaquk: debug

Thank you for drawing my attention to this situation. You were right - there was a stupid bug. Fixed.


Thank you so much!

@Limych Do you know any sensor/hardware for measure the following?

  • Carbon Monoxide (CO)
  • Nitrogen Dioxide (NO2)
  • Formaldehyde (HCHO; CH2O)

For Formaldehyde I’ve just received JQ300 from AliExpress:

But there a no HA integration now. Just starting to make it.

1 Like

IAQ UK component v1.3.0 has been published


i don´t get it to work:

    username: ****
    password: ****
      humidity: sensor.jq300_humidity
      co2: sensor.jq300_eco2
      tvoc: sensor.jq300_tvoc
      hcho: sensor.jq300_hcho
      pm: sensor.jq300_pm25
     - iaq_level

The sensor is online but the iaquk does not sent the data:

Log file is clear.
Any idea, help or sugestions?


Indoor Air Quality Sensor Component v1.3.5 has been published.

Please update your IAQUK sensor component to the latest version. When the system starts, the logs will contain more detailed information why it does not work.

Most likely you have errors in the names of the source sensors.
Are you sure your JQ-300 is registered in the cloud as “jq300”? For only in this case the jq300 integration component will create such sensor names.

@Limych How is the calculation by: temperature, humidity and CO2.
Let’s say the temperature is 25*C, humidity 37% and CO2 650ppm. I get an index of 39.
But as for me it is the most comfortable temperature, humidity.
And how does it take into account the current season and whether there are people in the room or not?

All calculations are based on the official index table:

25°С = 1 point (Inadequate)
37% = 4 points (Good)
650 ppm = 4 points (Good)
then the sum (9 points) is approximated for the entire range (1-65), since not all sensors are represented.

Hmmm, I see, that is, since my comfort temperature does not match the IAQ UK, I need to exclude the temperature from the sensor, and then it will work well for me, because now it shows the same thing and it is always bad.
Do I understand this correctly? Or can I make adjustments in it to understand that it’s fine, but tailored to my individual needs?

The sensor only calculates an estimate of the air quality according to a predetermined system. How you use this estimate is up to you.

1 Like