AirGradient ONE is a desktop indoor air quality monitor built around an ESP32-C3 module. It measures particulate matter (Plantower PMS5003), CO₂ (Senseair S8), temperature and humidity (SHT4x), and VOC (SGP41), with…
Ag diy pro is an open-source printed circuit board by Open-Air-Foundation, from the Open-Air-Foundation/pcb-one repository on GitHub, published under the CC-BY-SA-4.0 licence. It is a 2-layer board of 124.1 × 112 mm with 65 parts on 54 nets, routed with 588 tracks and 145 vias.
It is built around the ESP32-C3-MINI-1-N4, TPL5010EVM and LM1117-3.3, with the 918-418K2022Y40000 among its other parts. Its parts include 18 capacitors, 10 resistors, 7 connectors, 4 ICs and 1 fuse. It belongs with the lEDs and displays boards and the ESP32 and RISC-V boards of this library.
KiCad hardware design files for the AirGradient ONE, a mains-powered indoor air quality monitor.
Overview
AirGradient ONE is a desktop indoor air quality monitor built around an ESP32-C3 module. It measures
particulate matter (Plantower PMS5003), CO₂ (Senseair S8), temperature and humidity (SHT4x), and
VOC (SGP41), with readings shown on an I²C OLED display and an 11-segment RGB LED bar that gives an
at-a-glance air quality indication. The board is powered and flashed over USB-C, and exposes I²C,
general-purpose I/O and RS485/Modbus headers for expansion.
Sensors and the display are carried on pluggable modules rather than being reflowed onto the main
board — the main board provides the sockets, power rails, and the hardware watchdog around them.
This repository contains the complete electronics design: schematics, PCB layouts, component
libraries, and production outputs for both boards.
11 × WS2812B addressable RGB LEDs; mounts to the main board as the air quality indicator
Key components (main board)
Function
Part
Ref
MCU / Wi-Fi
ESP32-C3-MINI-1-N4
U6
Hardware watchdog
TPL5010
U2
3.3 V LDO
LM1117-3.3 (AMS1117-3.3 alternative)
U4
LED bar
11-dot WS2812B bar (see PCB/11-dot-led-bar/)
U5
USB-C connector
918-418K2022Y40000
USB1
Input fuse
1 A / 16 V, 1206
F1
Reset / Boot buttons
PTS525SM08SMTR2LFS
Reset1, Boot1
CO₂ sensor
Senseair S8
S*2
VOC sensor socket
BME680 module, 1×6 header
S*1
Temperature/humidity socket
SHT4x module, 1×4 header
SHT1
OLED display socket
I²C, 1×4 header
OLED1
PM sensor connector
PMS5003, 8-pin 1.25 mm
PM2
I²C expansion
3 × 1×4 header
I2C1–I2C3
GPIO expansion
8-pin 1.25 mm
IO1
RS485 / Modbus
4-pos screw terminal
RS1
Toolchain
KiCad 8 — the main board layout is in the KiCad 8 file format (20240108); schematics are in the
KiCad 7 format (20230121) and migrate on open. The 11-dot LED bar is still in the KiCad 7 layout
format (20221018).
Symbol and footprint libraries are bundled per project and referenced project-relative through each
board's fp-lib-table / sym-lib-table, so the projects open without extra library setup.
Gerbers and drill files were plotted from Pcbnew; the LED bar BOM and pick-and-place files were
exported from Eeschema/Pcbnew.
Repository structure
text
PCB/
├── airgradient-one-indoor/ # Main PCB
│ ├── ag-diy-pro.kicad_* # schematic, layout, project
│ ├── Libs/ # symbols, footprints, 3D models
│ └── production/
│ └── gerber/ # Gerbers, drill files, fabrication zip
└── 11-dot-led-bar/ # LED indicator PCB
├── leds_bar.kicad_* # schematic, layout, project
├── libs/ # symbols and footprints
├── doc/ # footprint and STEP model for board-to-board mounting
└── production/
├── Gerber/ # Gerbers, drill files, fabrication zip
└── BOM/ # BOM and pick-and-place positions
Both zips contain the copper, soldermask, silkscreen, paste and edge-cut layers plus PTH/NPTH drill
files, in the format accepted by JLCPCB and most other fabricators.
BOM & sourcing
The 11-dot LED bar has a grouped BOM (production/BOM/BOM.xls and production/BOM/leds_bar.csv)
and pick-and-place positions (production/BOM/leds_bar-all-pos.csv) for assembly.
The main board BOM is not currently exported to this repository — component values and designators
can be read from ag-diy-pro.kicad_sch.
Versioning & releases
The main board schematic is at revision 9. Hardware revisions are tagged on this repository; per-version
release notes and the matching production file set are published on the GitHub Releases page.
You are free to use, modify, and manufacture these designs, including commercially, provided you credit
AirGradient and share derivative designs under the same license.
The Open Air main board carries the monitor's ESP32-C3 MCU, USB-C power input with a 3.3 V LDO, a TPL5010 hardware watchdog, status LEDs and a push button, and the Molex connectors the plug-in sensor modules attach to.
It measures 124.1 × 112 mm and has 2 copper layers, 1.6 mm thick.
What parts does the Ag diy pro use?
65 parts, built around the ESP32-C3-MINI-1-N4, TPL5010EVM, LM1117-3.3 and 918-418K2022Y40000. The full list of its parts is on this page, with links to each part's symbol and footprint where PCBKit's library has them.
Where can I download the Ag diy pro KiCad files?
From the Open-Air-Foundation/pcb-one repository on GitHub, at the commit this page was made from: the board is PCB/airgradient-one-main/ag-diy-pro.kicad_pcb and its schematic PCB/airgradient-one-main/ag-diy-pro.kicad_sch. PCBKit opens the board in the browser, with nothing to install.
Can I use the Ag diy pro design in my own project?
Its repository publishes it under the CC-BY-SA-4.0 licence: you may reuse it on that licence's terms (keep the author's notice, and for a copyleft licence share your changes alike).