Skip to the content
2 layers50 × 50 mmAir monitor, the printed circuit board in 3D

A USB-powered desk air quality monitor. One board, one USB-C port, no app to install.

Size
50 × 50 mm
Copper layers
2
Thickness
1.6 mm
Parts
29
Nets
42
Pads
144
Tracks, vias
164, 8
Pours
2
Routed
Yes
KiCad
KiCad 10.0 (file 20260206)
Created
14 Aug 2026
Updated
17 Sep 2026

Overview

Air monitor is an open-source printed circuit board by harrisoncrettol, from the harrisoncrettol/HC-Air-Monitor repository on GitHub. It is a 2-layer board of 50 × 50 mm with 29 parts on 42 nets, routed with 164 tracks and 8 vias.

It is built around the ESP32-C3-MINI-1, BME688 and AP2112K-3.3, with the 1N4148W among its other parts. Its parts include 8 resistors, 7 capacitors, 3 ICs, 3 diodes and 1 connector. It belongs with the ESP32 and RISC-V boards of this library.

Main components

4

README

README.md

HC Air Monitor

A USB-powered desk air quality monitor. One board, one USB-C port, no app to install.

Plugged into a charger it glows green, yellow or red. Plugged into a laptop, a web page shows live temperature, humidity, pressure and VOC. The USB dashboard needs no Wi-Fi, account, or cloud. An optional iPhone app connects over Bluetooth and can save history with Google sign-in and Firebase.

Status: built and working. Two assembled boards, enclosure printed and fitted.

board


Why

v1 was my senior design project: an ESP32-C3 dev board, a BME680, a PM2.5 sensor and a LiPo stack on a custom PCB. It worked, but it was pre-made boards stacked on top of each other.

v2 keeps roughly the same sensing and changes everything else.

v1v2
IntegrationDev board + breakoutsModule + bare ICs, one board
AssemblyHand-solderedStencil, paste, hot plate
PowerLiPo + charger + boostUSB-C only
InterfaceiOS app + FirebaseWeb page, no backend
Size100 × 100 × 55 mm55 × 55 × 18 mm

Hardware

50 × 50 mm, 2 layer, 23 components, about $19 each.

PartRole
ESP32-C3-MINI-1-N4XMCU with native USB, so no serial bridge chip
BME688Temperature, humidity, pressure, VOC. I²C at 0x76
AP2112K-3.35 V to 3.3 V
GCT USB4105-GF-AUSB-C
IN-PI554FCH ×2Addressable RGB LEDs
B3F-1000Boot button, recovery only

Plus a 1N4148W to drop the LED rail and 16 passives.

No battery, no charger, no boost converter, no PM2.5, no wifi. Every part you don't have is a part that can't go wrong.


Firmware

ESP-IDF v5.5, C. Samples once a second, prints one line of JSON over USB, drives the LEDs from the same data, and accepts JSON commands back.

The sensor and the LEDs each sit behind a small interface with two implementations, real and mock. The whole thing runs on a bare ESP32-C3 with no sensor attached, which is how it was written while the boards were in the post.

text
cd firmware
idf.py set-target esp32c3
idf.py -p /dev/cu.usbmodemXXXX flash monitor

set-target is required on a fresh clone. sdkconfig is generated and gitignored.

The VOC number is not calibrated ppb. The sensor reports gas resistance, and the firmware compares it against a slowly-learned baseline for the room. It re-learns if you move the device.


Web dashboard

Static page, talks to the board over USB with the Web Serial API. No backend, nothing stored.

text
cd web
python3 -m http.server 8000

Then http://localhost:8000 in Chrome.

Two catches. Web Serial needs localhost or https, so opening the file directly does nothing. And only one program can hold the serial port, so close any serial monitor first.

Chrome, Edge, Opera and Firefox 151+. No Safari, no mobile.

The copy in web/ is the reference version. The one on my site has diverged and is the one I maintain.


iPhone app (development)

One firmware streams the same sensor readings over USB and Bluetooth. The native SwiftUI app has Instrument, History, and Device tabs, with persistent LED mode, fixed color (including white), and brightness controls. Live readings work without an account. Optional Google sign-in saves valid, post-warm-up minute summaries to your own Firebase project.

Start with the iPhone setup and testing guide. It covers flashing, Xcode signing, Firebase setup, and a physical-device test checklist. The Bluetooth protocol documents the transport and commands. Builds and automated tests are verified; board/phone pairing and cloud sign-in still need hardware and project setup.


Enclosure

Two printed parts, both flat on the bed, no supports. Rather than modelling it in CAD, enclosure-generator.html reads the real component positions exported from KiCad and generates STLs from sliders. Open it in a browser.

Assembly is four M3 × 16 screws from underneath, through the board, into bosses in the lid.


Repo

text
KiCad/          schematic and PCB
fabrication/    gerbers, ready to upload
firmware/       ESP-IDF project
web/            USB dashboard
ios/            SwiftUI Bluetooth app
firebase/       private history rules and emulator tests
scripts/        firmware build and Firebase configuration helpers

To order boards, upload fabrication/gerbers.zip. You don't need KiCad.

Settings I used: 2 layer, 1.6 mm FR-4, HASL lead, 1 oz copper, green mask, white silk, plus a stencil (unframed, 100 × 100 mm, top only).


If you build one

The BME688 goes on rotated 180° from the silkscreen. Put the package dot at the bottom right, not matched to the triangle. Line it up the obvious way and SDA lands on a ground pad: dead I²C bus, clean ERC and DRC, and no way to see it because the pads are underneath. This took two days to diagnose. Both sensors survived the rework.

CSB to 3.3 V, SDO to GND. CSB floating means the chip boots in SPI mode and I²C finds nothing. SDO floating means a random address.

5.1 kΩ on each USB-C CC line, two separate resistors, never tied together. Without them a host won't supply power and the board is simply dead.

Don't wash the board. No-clean flux, leave it. The BME688's gas sensor is chemically sensitive. Clean tweezers, never fingers, no silicone on the bench. After reflow it needs 24 hours at 25 °C and 80 % humidity or the humidity reading is permanently offset.

Leaded paste. The ESP32 module is its own PCB with parts already soldered using lead-free solder that melts at 217 °C. Reflow at 245 °C and you melt its internal joints while its components hang upside down.


More

License

MIT. The vendored Bosch driver in firmware/components/bme68x/ is BSD-3-Clause.

Parts

29
QtyValueFootprintReferences
410uFCapacitor_SMD:C_0805_2012MetricC3, C4, C5, C6
3100nFCapacitor_SMD:C_0805_2012MetricC1, C2, C7
310kResistor_SMD:R_0805_2012MetricR3, R4, R5
24.7kResistor_SMD:R_0805_2012MetricR7, R8
25.1kResistor_SMD:R_0805_2012MetricR1, R2
2Inolux_IN-PI554FCHLED_SMD:LED_Inolux_IN-PI554FCH_PLCC4_5.0x5.0mm_P3.2mmD1, D2
11N4148WDiode_SMD:D_SOD-123D3
1330Resistor_SMD:R_0805_2012MetricR6
1AP2112K-3.3Package_TO_SOT_SMD:SOT-23-5U2
1BME688Package_LGA:Bosch_LGA-8_3x3mm_P0.8mm_ClockwisePinNumberingU1
1ESP32-C3-MINI-1PCM_Espressif:ESP32-C3-MINI-1U3
1LOGOair-monitor:frontlogoG***
1LOGOair-monitor:backlogoG***
1SW_PushButton_Switch_THT:SW_PUSH_6mmSW1
1USB_C_Receptacle_USB2.0_16PConnector_USB:USB_C_Receptacle_GCT_USB4105-xx-A_16P_TopMnt_HorizontalJ1

The 25 most common of 29 parts.

Similar boards

  • 4 layers39 × 99 mmRoamer, the printed circuit board in 3D

    Roamer

    ezzatisawesome/roamer

    105 parts
  • 4 layers74 × 41.2 mmStm32-netnode, the printed circuit board in 3D

    Stm32-netnode

    vincerodriguez/stm32-netnode

    stm32f407-based network node to report temperature in apartment

    84 parts
  • 2 layers54.4 × 140 mmPov badge, the printed circuit board in 3D

    Pov badge

    bornhack/badge2024

    BornHack Badge 2024

    63 parts3CC-BY-SA-4.0
  • 4 layers75 × 70 mmSmall Pendant, the printed circuit board in 3D

    Small Pendant

    mjhaahr/RGB-LED-Pendant

    Small RGB LED Pendant using 1010 (1.0x1.0mm) WS2812B LEDs powered by an ESP32-C3 Mini with a BNO055 IMU

    260 parts2MIT
  • 2 layers33.5 × 22 mmEmonWiFi, the printed circuit board in 3D

    EmonWiFi

    openenergymonitor/emonWiFi

    This small adapter allows OpenEnergyMonitor products to be used with a WiFi connection. The module is fully supported by ESPHome and is compatible with many endpoints, for example emonCMS, Home Assistant, and MQTT.

    18 parts1CC-BY-SA-4.0
  • 2 layers100 × 60 mmDigital card, the printed circuit board in 3D

    Digital card

    AhmedMKAlzoubi/Digital-B-Card

    An ESP32-C3 based digital business card / badge with an e-paper display and NFC tap-to-share, designed as a custom PCB in a compact card/badge form factor.

    66 parts

Questions

How big is the Air monitor PCB?

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

What parts does the Air monitor use?

29 parts, built around the ESP32-C3-MINI-1, BME688, AP2112K-3.3 and 1N4148W. 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 Air monitor KiCad files?

From the harrisoncrettol/HC-Air-Monitor repository on GitHub, at the commit this page was made from: the board is KiCad/air-monitor/air-monitor.kicad_pcb and its schematic KiCad/air-monitor/air-monitor.kicad_sch. PCBKit opens the board in the browser, with nothing to install.

Can I use the Air monitor design in my own project?

Its repository states no licence, so its author keeps all rights: ask harrisoncrettol before reusing the design.