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.

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

AirGradient Open Air Outdoor Air Quality Monitor Build Instructions

Professional and highly accurate outdoor air quality monitor built measuring PM1, PM2.5, PM10, temperature and humidity with dual Plantower PM5003T sensors for enhanced accuracy.

Build Instructions Purchase Kit

AirGradient DIY PRO Air Quality Sensor Build Instructions

Professional and highly accurate air quality monitor built measuring PM2.5, CO2, Temperature and Humidity. Board allows a lot of extensability for other sensors e.g. TVOC or Barometric Pressure.

Build Instructions Pre-soldered Version Purchase Kit

AirGradient DIY BASIC Air Quality Sensor Build Instructions

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

Build Instructions Purchase Kit
How to connect the DIY Sensor to the AirGradient Dashboard

Connecting the DIY sensor to the AirGradient Dashboard is a two step process. First you need to connect the sensor to your WiFi network and then you need to add it to the AirGradient dashboard.

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
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
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 (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 (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 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 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 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 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 continously 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 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