Skip to the content
2 layers124.1 × 112 mmAg diy pro, the printed circuit board in 3D

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…

Size
124.1 × 112 mm
Copper layers
2
Thickness
1.6 mm
Parts
65
Nets
54
Pads
240
Tracks, vias
588, 145
Pours
2
Routed
Yes
KiCad
KiCad 8.0 (file 20240108)
Created
4 Sep 2026
Updated
4 Sep 2026

Overview

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.

Main components

4

README

README.md

AirGradient ONE Indoor — Hardware

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.

Boards in this repository

BoardDirectoryKiCad projectSizeLayersDescription
Main boardPCB/airgradient-one-indoor/ag-diy-pro (rev 9)124.1 × 112.0 mm2 (1.6 mm)ESP32-C3, USB-C power, watchdog, sensor/display sockets, expansion headers
11-dot LED barPCB/11-dot-led-bar/leds_bar100.0 × 12.0 mm2 (0.8 mm)11 × WS2812B addressable RGB LEDs; mounts to the main board as the air quality indicator

Key components (main board)

FunctionPartRef
MCU / Wi-FiESP32-C3-MINI-1-N4U6
Hardware watchdogTPL5010U2
3.3 V LDOLM1117-3.3 (AMS1117-3.3 alternative)U4
LED bar11-dot WS2812B bar (see PCB/11-dot-led-bar/)U5
USB-C connector918-418K2022Y40000USB1
Input fuse1 A / 16 V, 1206F1
Reset / Boot buttonsPTS525SM08SMTR2LFSReset1, Boot1
CO₂ sensorSenseair S8S*2
VOC sensor socketBME680 module, 1×6 headerS*1
Temperature/humidity socketSHT4x module, 1×4 headerSHT1
OLED display socketI²C, 1×4 headerOLED1
PM sensor connectorPMS5003, 8-pin 1.25 mmPM2
I²C expansion3 × 1×4 headerI2C1–I2C3
GPIO expansion8-pin 1.25 mmIO1
RS485 / Modbus4-pos screw terminalRS1

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

Fabrication

Each board ships a ready-to-order Gerber set:

BoardProduction filesStackup
Main boardPCB/airgradient-one-indoor/production/gerber/ag-diy-pro.zip2-layer, 1.6 mm
11-dot LED barPCB/11-dot-led-bar/production/Gerber/gerber_ledbar.zip2-layer, 0.8 mm

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.

License

This is open-source hardware. The design files in this repository are licensed under the Creative Commons Attribution-ShareAlike 4.0 International (CC BY-SA 4.0) license — see LICENSE.

You are free to use, modify, and manufacture these designs, including commercially, provided you credit AirGradient and share derivative designs under the same license.

Maintainers

AirGradient hardware team.

Parts

65
QtyValueFootprintReferences
120.1ufCapacitor_SMD:C_0603_1608MetricC2, C3, C4, C6, C8, C10, C12, C13, C14, C15, C17, C18
7Conn_01x04Connector_PinSocket_2.54mm:PinSocket_1x04_P2.54mm_VerticalCon1, Con2, I2C1, I2C2, I2C3, OLED1, SHT1
510KResistor_SMD:R_0603_1608MetricR9, R10, R11, R12, R13
20.01ufCapacitor_SMD:C_0603_1608MetricC1, C9
2100KResistor_SMD:R_0603_1608MetricR4, R8
222uf / 10VCapacitor_SMD:C_0603_1608MetricC11, C16
25.1KResistor_SMD:R_0603_1608MetricR6, R7
2Conn_01x08_MountingPinConnector_Molex:Molex_PicoBlade_53261-0871_1x08-1MP_P1.25mm_HorizontalIO1, PM2
2SW_Push_DualAG-PRO-Library:PTS525SM08SMTR2LFSBoot1, Reset1
110uf / 25VCapacitor_SMD:C_0603_1608MetricC7
11A 16VFuse:Fuse_1206_3216MetricF1
11ufCapacitor_SMD:C_0603_1608MetricC5
151KResistor_SMD:R_0603_1608MetricR5
1918-418K2022Y40000AG-PRO-Library:918-418K2022Y40000USB1
1BMEConnector_PinSocket_2.54mm:PinSocket_1x06_P2.54mm_VerticalS*1
1Co2-S8AG-PRO-Library:Co2-S8S*2
1ESP32-C3-MINI-1-N4AG-PRO-Library:XCVR_ESP32-C3-MINI-1-N4U6
1LM1117-3.3Package_TO_SOT_SMD:SOT-223-3_TabPin2U4
1LOGOAG-PRO-Library:LogoG***
1Screw_Terminal_01x04AG-PRO-Library:Modbus_2.5_CONNRS1
1TPL5010Package_TO_SOT_SMD:SOT-23-6U2
1~AG-PRO-Library:11Dots_LedBarU5

The 49 most common of 65 parts.

Similar boards

  • 2 layers57 × 44 mmOpenair main, the printed circuit board in 3D

    Openair main

    Open-Air-Foundation/pcb-openair-main

    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.

    38 parts1CC-BY-SA-4.0
  • 2 layers45 × 15 mmUsbc jstxh mini, the printed circuit board in 3D

    Usbc jstxh mini

    veroxzik/usb-boards

    A collection of USB boards.

    6 parts2MIT
  • 4 layers85 × 85 mmEPS, the printed circuit board in 3D

    EPS

    rgw3d/1KCubeSat_Hardware

    Hardware design files for my $1000 CubeSat.

    657 parts158GPL-3.0
  • 2 layersSuntastic, the printed circuit board in 3D

    Suntastic

    snorkman88/suntastic

    An ultra low-power management board for IoT devices

    120 parts13Apache-2.0
  • 2 layers57 × 57 mmMold detect, the printed circuit board in 3D

    Mold detect

    christopher-besch/mold_detect

    Warn residents of mold-friendly atmosphere and log opened windows.

    46 parts4MIT
  • 2 layers17.8 × 25.4 mmHardware watchdog, the printed circuit board in 3D

    Hardware watchdog

    rmingon/hardware-watchdog

    PCB Hardware watchdog based on TPL5010

    14 parts2
  • 4 layers80 × 80 mmEPS, the printed circuit board in 3D

    EPS

    4111Spyglass/Hardware_CSAT

    243 parts1
  • 2 layers49 × 38 mmMailboxSensorProcessor, the printed circuit board in 3D

    MailboxSensorProcessor

    kevinkessler/MailSensors-PCB

    PCB for the MailSensor Lora project

    24 parts

Questions

How big is the Ag diy pro PCB?

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