Documentation & Build Instructions

Build your own accurate air quality monitor with the build instructions below. You can either source the components yourself or get a ready-to-build kit from our online shop.

You can use it with the AirGradient data platform or connect it to other platforms like Home Assistant or HomeKit. More information on our Integrations Page.

We’ve pledged 1% of sales to the preservation and restoration of the natural environment.

AirGradient ONE Indoor Air Quality Monitor Build Instructions

Professional and highly accurate air quality monitor built measuring PM1, PM2.5, PM10, CO2, TVOCs, NOX, temperature and humidity. Board allows a lot of extensibility for other sensors e.g. barometric pressure.

Build Instructions Purchase Kit

AirGradient Open Air Outdoor Air Quality Monitor Build Instructions

Professional and highly accurate outdoor air quality monitor built measuring PM1, PM2.5, PM10, CO2, TVOCs, NOX, temperature and humidity. Fully weatherproof enclosure.

Build Instructions Purchase Kit

AirGradient DIY BASIC Air Quality Sensor Build Instructions

Smaller and more compact air quality monitor built measuring PM1, PM2.5, PM10, CO2, Temperature and Humidity.

Build Instructions Purchase Kit
How to connect the Monitors to the AirGradient Dashboard

Connecting the monitor to the AirGradient Dashboard is a two-step process. You need to connect your monitor to the WiFi network and register it on the dashboard.

Read More
AirGradient DIY Pro Kit Built Instructions

These instructions are for the people who ordered our first batch of the new DIY kit with the professional enclsosure. The instruction assume that you have already built a normal AirGradient DIY kit and thus primarily focus on the differences to the default DIY Kit.

Read More
AirGradient DIY Display

When we launched our indoor classroom monitoring with our professional sensors, one of the first feature request from teachers was to have a small display that would show the indoor and outdoor air quality.

Read More
Reading Temperature and Humidity from Plantower PMS5003T

We use the PMS5003T version for our outdoor monitor Open Air which includes an integrated temperature and humidity sensor. If you use the Arduino Sketch from the AirGradient Arduino library you need to patch the PMS library to get these values.

Read More
Install the Arduino Software for the ESP32-C3

For the new AirGradient monitors we use the ESP32-C3-MINI microcontroller. This tutorial explains you how to set up the Arduino IDE for this microprocessor in order to flash the software.

Read More
Install the Arduino Software and D1 Mini

For all the AirGradient for Education build instructions we use very similar components and the same microcontroller, the Wemos D1 Mini.

Read More
The AirGradient DIY Sensor Enclosure

Just a quick shoutout that we have 3D printer files to print your own enclosure. It fits the DIY PCB perfectly and consists of a top and bottom part that snap together.

Read More
TVOC on the AirGradient DIY Sensor

IMPORTANT We do no longer recommend to use the SGP30 on the AirGradient board as the removal of the pull up reisitors is difficult and some people still experienced issues.

Read More
AirGradient Open Air Outdoor Air Quality Monitor Technical Documentation (PCB Version 1.1)

Introduction These are the technical documentations for the AirGradient Open Air outdoor monitor for PCB version 1.1. If you have a different version please find your correct build instructions in this overview.

Read More
Certified Firmware for AirGradient ONE Model I-9PSL

Please note This is the AirGradient certified firmware blob which is closed source and has fewer features than the open-source firmware available here.

Read More
Factory Flashing

Open Air (O-1PP) OTA Version Your browser doesn't support this. Please use Chrome or Edge on Mac or PC.

Read More
Firmwares

Combined Firmwares New firmware version that runs on both the AirGradieny ONE I-9PSL and the Open Air O-1PST models. Version 3.

Read More
Local Server Documentation

Local Server API From firmware version 3.0.10 onwards, the AirGradient ONE and Open Air monitors have below API available. Discovery The monitors run with mDNS.

Read More
Online Debug

This page helps in reading out data directly from the AirGradient monitor. For good error analysis, please log at least 3 minutes of data.

Read More
The AirGradient DIY Air Quality Sensor (Basic Version PCB Version < 3.0)

Please note that this is a legacy instruction for people having the DIY BASIC PCB labelled with “PCB v2”. The version number is written on your PCB.

Read More
The AirGradient DIY Air Quality Sensor (Basic Version PCB Version 3.0)

Please note that these are the instruction for the DIY BASIC PCB Version 3.0 that mounts the S8 CO2 sensor differently.

Read More
The AirGradient DIY Air Quality Sensor (Basic Version PCB Version 4.0+)

Please note that these are the instruction for the DIY BASIC PCB Version 4.0 that now uses a smaller cross-over cable for the PM sensor.

Read More
The AirGradient DIY Air Quality Sensor (Pro Presoldered-Version, PCB Version < 3.7)

Introduction These build instructions cover the pre-soldered version of the AirGradient Pro monitor kit for PCB version 3.6 and lower. If you have a different version please find your correct build instructions in this overview.

Read More
The AirGradient DIY Air Quality Sensor (Pro Presoldered-Version, PCB Version 3.7)

Introduction These build instructions cover the pre-soldered version of the AirGradient Pro monitor kit for PCB version 3.7. If you have a different version please find your correct build instructions in this overview.

Read More
The AirGradient DIY Air Quality Sensor (Pro Presoldered-Version, PCB Version 4.2)

Introduction These build instructions cover the pre-soldered version of the AirGradient Pro monitor kit for PCB version 4.2. If you have a different version please find your correct build instructions in this overview.

Read More
The AirGradient DIY Air Quality Sensor (Pro Version PCB Version < 3.7)

Please note that these are the instruction for the DIY PRO PCB Version 3.6 and lower. If you have a different version please find your correct build instructions in this overview.

Read More
The AirGradient DIY Air Quality Sensor (Pro Version PCB Version 3.7)

Please note that these are the instruction for the DIY PRO PCB Version 3.7 that has an improved PCB. If you have a different version please find your correct build instructions in this overview.

Read More
The AirGradient DIY Air Quality Sensor (Pro Version PCB Version 4.2)

Please note that these are the instruction for the DIY PRO PCB Version 4.2 that has an improved PCB. If you have a different version please find your correct build instructions in this overview.

Read More
The AirGradient DIY CO2 Traffic Light

As part of the AirGradient for Education series, this instruction teaches how to build an accurate CO2 traffic light that can be connected easily to data platforms.

Read More
The AirGradient DIY Outdoor Air Quality Monitor

Introduction These build instructions cover the ESP8266 based version of the AirGradient Open Air Outdoor monitor PCB version 0.4. If you have bought the kit from our shop with the ESP32-C3 based chip and PCB version > 1.

Read More
The AirGradient DIY Outdoor Pilot Program

Introduction These instructions are for our small beta tester group and contains a special firmware for testing purposes. This firmware only works for people in this pilot program.

Read More
The AirGradient Instructions Overview

We are continuously updating our open hardware / open source air quality monitor kits and as a results have different versions of the built instructions.

Read More
The AirGradient ONE Air Quality Sensor (Presoldered-Version, PCB Version 9)

Introduction These build instructions cover the pre-soldered version of the AirGradient ONE monitor kit for PCB version 9. It is the successor of the DIY Pro series and combines the best features of the DIY and (formerly closed source) AirGradient ONE series.

Read More
The AirGradient Open Air Outdoor Air Quality Monitor (O-1PST Kit, PCB Version 1.3)

Introduction These build instructions are for the AirGradient Open Air Outdoor monitor model O-1PST. If you have a different version, e.

Read More
The AirGradient Open Air Outdoor Air Quality Monitor (Presoldered-Version, PCB Version 1.1)

Introduction These build instructions cover the pre-soldered version of the AirGradient Open Air Outdoor monitor kit for PCB version 1.1. If you have a different version please find your correct build instructions in this overview.

Read More
The reFlash

Flashing Follow the procedure: reFlash Firmware AG1 Your browser doesn't support this. Please use Chrome or Edge on Mac or PC.

Read More