ESPHome config for AirGradient Air Quality Sensor

The AirGradient DIY Air Quality Sensor can be found here: https://www.airgradient.com/diy/

This repository will provide you the ESPHome config to run this with Home Assistant.

• You need to have Home Assistant running

Klick here:

Follow the ESPHome font docs

You can also hardcode them in the air-gradient.yaml but I would recommend to split these

You can either create a separate secrets.yaml with your secrets in this file like so:

# WIFI
wifi_ssid: ""
wifi_password: ""

# OTA
ota_password: ""

#AP
fallback_ssid_password: ""

or you can just include your Home Assistant secrets.yaml: How do I use my Home Assistant secrets.yaml?

You can either plug it in the device running Home Assistant or your laptop/PC.

ESPHome will ask you for a name and your WiFi credentials. You can put in anything you want right now. We will change that anyway in the later steps.

Now you just need to copy thte content of the air-gradient.yaml into the editor

This will take a minute or two. ESPHome will compile the binary for your AirGradients ESP8266.

In the notification panel should be an new device available to set up. Your new AirGradient Sensor.

If not you can add the device via the esphome integreation:

Now it is your turn to do something silly or usefull with the air quality sensor.

Open an issue when you have any questions.

If this did help you:

• Follow my work on my blog: www.ajfriesen.com
• Subscribe to my E-Mail or RSS and do not miss an anything
• you can tip me on