AirGradient DIY and HomeAssistant

[ahilangopal]

I don’t have pro board. I am using the AirGradient PCB (Basic) and connected GY-SGP41 which I got from AliExpress.

[odinb (Odin)]

Did you check this page: SGP40 Volatile Organic Compound Sensor and SGP41 VOC and NOx Sensor — ESPHome
That is what I used as a template for mine.

All it needs, which is also stated, is the I2C-bus to be setup.
Something like this should suffice:

# Define I2C bus
i2c:
  sda: D2
  scl: D1

# https://sensirion.com/products/catalog/SGP41/
sensor:
  - platform: sgp4x
    voc:
      id: VOC
      name: "VOC Index"
    nox:
      id: NOx
      name: "NOx Index"
    compensation:
      humidity_source: humidity
      temperature_source: temp


# Optional example configuration entry without compensation:
sensor:
  - platform: sgp4x
    voc:
      id: VOC
      name: "VOC Index"
    nox:
      id: NOx
      name: "NOx Index"

[ex-nerd (Chris)]

I thought I’d post here that there has been a bunch of discussion and updates on the AirGradient forum for the new Open Air / Outdoor model: Outdoor Monitor ESPHome Configuration - #18 by MallocArray - Software integrations - Open AirGradient

A few of us have also been updating the configs on the DIY Pro model. It seems that @ajfriesen’s github repository has become the semi-official location for the latest configs: GitHub - ajfriesen/ESPHome-AirGradient: ESPHome config for AirGradient Air Quality Sensor

[ThaNerd (Turbo Tronix)]

Anyone has a nice lovelace yaml to share? I just got this on my hassio setup so will start working on the GUI

[dalves (David)]

Thanks for posting that config. I also have an Airgradient DIY Pro that I’m trying to set up. Do I just need to use the ESPHome integration with that YAML file, or do I also need to flash different firmware onto the device?

[odinb (Odin)]

You just use the yaml in ESPHome, and flash it from there (Chrome or Edge needed, since they are the only browsers that allow this type of insecure access to HW-devices)! Initial flash has to happen using the binary file that ESPHome produces, and flash via USB. After this, you can do OTA-updates over the Wifi!

[vladimir_korobov (Vladi)]

Hello

I am very interested in air quality sensor using ESPHome. Need help with following:

1. What is the most updated config that works with HA? Is there any official github repository?
2. Unfortunately, I do not have time and tools to assemble the kit. Is it ok to order this one: DIY Shop
3. I see another product in their site - AirGradient ONE (8PSL) RESET Accredited Air Quality Monitor: DIY Shop What is the difference?
4. There is something scary:
   - 12 months premium monitoring on the RESET Accredited AirGradient data platform with Premium API. After 12 months USD 2.50 / month

Thanks in advance

[MallocArray]

There is work on a list of user submitted configurations, but there are several around. I’m actively working on one to closely match what the Arduino based config from AirGradient has, plus the ability to send readings to HA.

Here is another user’s to get you started:
ESPHome-AirGradient/air-gradient-pro-diy.yaml at main · ajfriesen/ESPHome-AirGradient (github.com)

The pre-soldered kit should be mostly plug and play.
The RESET one I don’t know anything about, but since you are looking to send data to HA, it shouldn’t be applicable to you
Same with their dashboard hosting cost that in included for 12 months. I don’t think they have really started charging anyone so far, but if you are sending to your own HA instance using ESPHome, then you have nothing to worry about.

You can also check out the AirGradient forums, where there has been various discussion about ESPHome configs you could search for:
Open AirGradient - Open source air quality monitoring

[vladimir_korobov (Vladi)]

Hello
I place Airgradient right next to Vindstyrka and was monitoring particles concentrations. It looks like Airgardient reading are much more “noisier” Any idea why?