Skip to the content
2 layers37.4 × 54.6 mmAirAware, the printed circuit board in 3D

AirAware is a portable air quality monitor built with an ESP32-C3 and PMS5003 to measure particulate matter and support hands-on air quality education.

Size
37.4 × 54.6 mm
Copper layers
2
Thickness
1.6 mm
Parts
16
Nets
22
Pads
57
Tracks, vias
169, 29
Pours
1
Routed
Yes
KiCad
KiCad 9.0 (file 20241229)
Created
14 Oct 2026
Updated
14 Oct 2026

Overview

AirAware is an open-source printed circuit board by evanloi, from the evanloi/air-aware repository on GitHub, published under the MIT licence. It is a 2-layer board of 37.4 × 54.6 mm with 16 parts on 22 nets, routed with 169 tracks and 29 vias.

It is built around the PMS5003. Its parts include 5 capacitors, 3 resistors, 3 connectors, 1 IC and 1 switch. It belongs with the sensors and measurement boards and the ESP32 and RISC-V boards of this library.

Main components

1

README

README.md

AirAware

AirAware is a portable particulate matter monitor designed to make air quality visible and understandable. The device measures airborne particles using a Plantower PMS5003 sensor and displays the results through a simple interface powered by an ESP32-C3.

The project combines PCB design, embedded programming, environmental sensing, and classroom education.

Project started: July 2026

Overview

AirAware was built around a simple question:

What does the air around us actually contain?

Most people cannot see changes in particulate matter concentration as they happen. AirAware provides a portable way to measure those changes and display them in a format that is easy to understand.

The current device measures particulate matter and displays:

  • Particle count
  • PM2.5 concentration
  • A visual air-quality indicator

The interface uses a simple facial indicator to help younger students interpret changes in particle concentration without needing to understand every measurement immediately.

Hardware

The current AirAware device uses:

  • ESP32-C3 SuperMini
  • Plantower PMS5003 particulate matter sensor
  • 2.0-inch 320 × 240 ST7789 display
  • 3.7 V lithium-polymer battery
  • Pololu S13V15F5 5 V boost regulator
  • Custom 2-layer PCB

How It Works

The PMS5003 pulls air through its sensing chamber and measures suspended particulate matter.

The sensor sends measurement data to the ESP32-C3 through UART.

The ESP32-C3 processes the sensor readings and updates the ST7789 display with the current particle measurements and visual indicator.

Basic data flow:

PMS5003 ↓ UART communication ↓ ESP32-C3 ↓ Data processing ↓ ST7789 display

Display

The interface was designed to stay simple enough for classroom use.

The main screen emphasizes particle count while also showing PM2.5 concentration.

A facial indicator changes based on the measured particle level:

🙂 Lower particle concentration

😐 Moderate particle concentration

☹ Higher particle concentration

The device also includes a startup screen while the PMS5003 completes its initial warm-up period.

Educational Use

AirAware was designed as both an engineering project and an educational tool.

Students use the devices in small groups to:

  • Observe real-time particulate matter measurements
  • Compare measurements from different environments
  • Test how activities affect airborne particles
  • Record experimental data
  • Calculate averages
  • Compare results between groups
  • Discuss possible sources of particulate matter

The goal is to connect environmental science with measurements students collect themselves.

firmware

Contains the code running on the ESP32-C3.

hardware/kicad

Contains the editable KiCad project files:

  • Schematic
  • PCB layout
  • KiCad project

hardware/production

Contains files used to manufacture the PCB, including Gerber and drill files.

Parts

16
QtyValueFootprintReferences
3100nFCapacitor_SMD:C_0805_2012Metric_Pad1.18x1.45mm_HandSolderC1, C3, C5
2100kResistor_SMD:R_0805_2012Metric_Pad1.20x1.40mm_HandSolderR1, R2
110kResistor_SMD:R_0805_2012Metric_Pad1.20x1.40mm_HandSolderR3
110uF 10VCapacitor_SMD:C_1206_3216Metric_Pad1.33x1.80mm_HandSolderC4
1220uF 10VCapacitor_THT:CP_Radial_D5.0mm_P2.00mmC2
1ESP32-C3_SUPERMINI_THESP32-C3_SUPERMINI_TH:MODULE_ESP32-C3_SUPERMINI_THU1
1GND TESTTestPoint:TestPoint_Loop_D2.50mm_Drill1.0mmTP1
1LiPo BatteryConnector_JST:JST_PH_B2B-PH-K_1x02_P2.00mm_VerticalJ1
1MountingHoleMountingHole:MountingHole_2.2mm_M2H2
1PMS5003Connector_Molex:Molex_PicoBlade_53048-0810_1x08_P1.25mm_HorizontalJ2
1POWERButton_Switch_THT:SW_CW_GPTS203211BSW1
1Pololu S13V15F5Connector_PinHeader_2.54mm:PinHeader_1x03_P2.54mm_VerticalM1
1SKU 17344Connector_JST:JST_PH_S8B-PH-K_1x08_P2.00mm_HorizontalJ3

Similar boards

  • 2 layers65 × 64 mmPms5003, the printed circuit board in 3D

    Pms5003

    ayoy/kicad-projects

    34 parts2
  • 4 layers74 × 56 mmAtmos, the printed circuit board in 3D

    Atmos

    HearnChristian/atmos-sense

    ESP32-based atmospheric sensing node: BME280 environmental sensing and AS3935 lightning detection over I2C, designed for drone integration. KiCad hardware plus firmware.

    73 parts1MIT
  • 2 layers85.5 × 79 mmHl project1, the printed circuit board in 3D

    Hl project1

    CarterJack-VA/hackclub-halflife

    12 partsUnlicense
  • 2 layers45 × 30 mmAqm sensor, the printed circuit board in 3D

    Aqm sensor

    cehbz/aqm-sensor

    ESP32-C3 air quality monitor sensor board (KiCad 9 + ESP-IDF)

    19 parts
  • 2 layers56 × 58 mmWeather station, the printed circuit board in 3D

    Weather station

    Dhruv2212-star/weather-station

    A Complete working model of a small but usefull weather station made at home with custom PCB and Casings to give it a unique look!

    22 parts
  • 2 layers60 × 90 mmPluggable, the printed circuit board in 3D

    Pluggable

    hannesweisbach/sensorbox

    26 parts
  • 2 layers38.6 × 26.7 mmCanary, the printed circuit board in 3D

    Canary

    JpTan/Canary

    A sensor network of compact indoor air quality monitors

    12 partsGPL-3.0
  • 2 layers75 × 90 mmWeather station, the printed circuit board in 3D

    Weather station

    maxr777/weather-station

    Reads temperature, humidity, and pressure via a BME280 over I2C, monitors air quality with a PMS5003 over UART, and displays everything on an SH1106 OLED. A few diagnostic LEDs signal hardware faults on startup.

    20 parts

Questions

How big is the AirAware PCB?

It measures 37.4 × 54.6 mm and has 2 copper layers, 1.6 mm thick.

What parts does the AirAware use?

16 parts, built around the PMS5003. 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 AirAware KiCad files?

From the evanloi/air-aware repository on GitHub, at the commit this page was made from: the board is hardware/kicad/AirAware.kicad_pcb.kicad_pcb and its schematic hardware/kicad/AirAware.kicad_sch.kicad_sch. PCBKit opens the board in the browser, with nothing to install.

Can I use the AirAware design in my own project?

Its repository publishes it under the MIT licence: you may reuse it on that licence's terms (keep the author's notice, and for a copyleft licence share your changes alike).