AirGradient ONE Indoor Air Quality Monitor Build Instructions

Professional and highly accurate air quality monitor built measuring PM2.5, 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 ONE Installation Instructions

The AirGradient ONE comes with multiple mounting and cable-management options, making it a flexible air quality monitor that can be mounted on a wall or sat on a desk (using the included feet).

Read More

AirGradient Open Air Installation Instructions

The AirGradient Open Air comes with a mounting bracket on the back of the device designed to allow flexibility during the mounting process. Whether you want a permanent or temporary installation, you can set up the Open Air how you want.

Read More

The AirGradient Builds 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. The version you are having is written on the PCBs. Please check with the table below and then click on the link to the built instruction that applies to your kit.

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. Then download the data and send them to the AirGradient support team together with a detailed error description.

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. Please follow these steps to patch the PMS library.

Read More

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. To do so, the easiest way is to use our onboarding wizard:

Read More

Embedding Air Quality Displays on Public Screens & Websites

Easily set up and embed air quality data displays on public screens or websites with AirGradient’s customizable widgets.

Read More

Understanding the LED Indicators on Your AirGradient ONE

The AirGradient ONE features 11 LEDs that provide crucial information about air quality and device status. This guide explains how to interpret the LED signals, including pollutant concentration levels and monitor status indicators.

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. Instead of having that information directly on the monitor, they wanted to have it as a separate display and able to e.g. put it on their desk.

Read More

The AirGradient DIY BASIC Sensor Enclosure

Just a quick shout out that we have 3D printer files to print your own enclosure.

Read More

AirGradient Models

Here we want to give an overview of current and out-of-production AirGradient monitor models.

Read More

Correction Algorithms

The accuracy of an air quality monitor is impacted by a variety of internal and external factors, for example:

Read More

Data Ownership and Sharing

We strongly recommend that you fully understand data ownership terms before buying an air quality monitor, as some of them can be extremely restrictive.

Read More

Enhance the Accuracy of the PMS Sensors

Newer batches of the Plantower PMS5003 sensors that -although working completely correctly and within their specs- can be made more accurate in lower concentration ranges. Below instructions explain how to identify these sensor modules, and apply the correction factors if you like to get the most accuracy out of the modules.

Read More

IT Security Policy for Deployment of AirGradient Monitors

This policy outlines the security considerations and procedures for deploying AirGradient air quality monitors (specifically models like the AirGradient ONE (I-9PSL) and AirGradient Open Air (O-1PST)) within school or enterprise networks.

Read More

Somerville Indoor Air Quality Monitor

Learn how to set up and use the AirGradient air quality monitor.

Read More

Firmwares

AirGradient ONE (I-9PSL) and Open Air (O-1PST) Firmware Versions

Please note that these firmware versions do not support the D1 mini (ESP8266) based models DIY Pro or Basic kit but we currently work on an update that will bring as many as possible of the new features to the D1 mini.

Read More

Factory Flashing

Firmware image for flashing of new boards in the factory.

Read More

Special Firmware Versions

Below are custom firmwares for very specific applications and not for general use.

Read More

Old Build Instructions

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

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 old versions of the AirGradient build instructions the Wemos D1 Mini microcontroller was used. This tutorial explains you how to set up the Arduino IDE for this microprocessor in order to flash the software.

Read More

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

These are the technical documentations for the AirGradient Open Air outdoor monitor for PCB version 1.1.

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’.

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. The version number is written on your PCB.

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)

These build instructions cover the pre-soldered version of the AirGradient Pro monitor kit for PCB version 3.6 and lower.

Read More

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

These build instructions cover the pre-soldered version of the AirGradient Pro monitor kit for PCB version 3.7.

Read More

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

These build instructions cover the pre-soldered version of the AirGradient Pro monitor kit for PCB version 4.2.

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.

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.

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.

Read More

The AirGradient DIY Outdoor Air Quality Monitor

These build instructions cover the ESP8266 based version of the AirGradient Open Air Outdoor monitor PCB version 0.4.

Read More

The AirGradient DIY Outdoor Pilot Program

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 Open Air Outdoor Air Quality Monitor (O-1PST Kit, PCB Version 1.3)

These build instructions are for the AirGradient Open Air Outdoor monitor model O-1PST.

Read More

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

These build instructions cover the pre-soldered version of the AirGradient Open Air Outdoor monitor kit for PCB version 1.1.

Read More

Your are being redirected to AirGradient Dashboard...