
KwartzLab SensorBoard Rev3-Panel
kwartzlab/Environmental-Sensor
The source for the environmental sensors used at Kwartzlab

A USB-powered desk air quality monitor. One board, one USB-C port, no app to install.
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.
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.

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.
| v1 | v2 | |
|---|---|---|
| Integration | Dev board + breakouts | Module + bare ICs, one board |
| Assembly | Hand-soldered | Stencil, paste, hot plate |
| Power | LiPo + charger + boost | USB-C only |
| Interface | iOS app + Firebase | Web page, no backend |
| Size | 100 × 100 × 55 mm | 55 × 55 × 18 mm |
50 × 50 mm, 2 layer, 23 components, about $19 each.
| Part | Role |
|---|---|
| ESP32-C3-MINI-1-N4X | MCU with native USB, so no serial bridge chip |
| BME688 | Temperature, humidity, pressure, VOC. I²C at 0x76 |
| AP2112K-3.3 | 5 V to 3.3 V |
| GCT USB4105-GF-A | USB-C |
| IN-PI554FCH ×2 | Addressable RGB LEDs |
| B3F-1000 | Boot 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.
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.
cd firmware
idf.py set-target esp32c3
idf.py -p /dev/cu.usbmodemXXXX flash monitorset-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.
Static page, talks to the board over USB with the Web Serial API. No backend, nothing stored.
cd web
python3 -m http.server 8000Then 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.
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.
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.
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 helpersTo 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).
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.
MIT. The vendored Bosch driver in firmware/components/bme68x/ is BSD-3-Clause.
| Qty | Value | Footprint | References |
|---|---|---|---|
| 4 | 10uF | Capacitor_SMD:C_0805_2012Metric | C3, C4, C5, C6 |
| 3 | 100nF | Capacitor_SMD:C_0805_2012Metric | C1, C2, C7 |
| 3 | 10k | Resistor_SMD:R_0805_2012Metric | R3, R4, R5 |
| 2 | 4.7k | Resistor_SMD:R_0805_2012Metric | R7, R8 |
| 2 | 5.1k | Resistor_SMD:R_0805_2012Metric | R1, R2 |
| 2 | Inolux_IN-PI554FCH | LED_SMD:LED_Inolux_IN-PI554FCH_PLCC4_5.0x5.0mm_P3.2mm | D1, D2 |
| 1 | 1N4148W | Diode_SMD:D_SOD-123 | D3 |
| 1 | 330 | Resistor_SMD:R_0805_2012Metric | R6 |
| 1 | AP2112K-3.3 | Package_TO_SOT_SMD:SOT-23-5 | U2 |
| 1 | BME688 | Package_LGA:Bosch_LGA-8_3x3mm_P0.8mm_ClockwisePinNumbering | U1 |
| 1 | ESP32-C3-MINI-1 | PCM_Espressif:ESP32-C3-MINI-1 | U3 |
| 1 | LOGO | air-monitor:frontlogo | G*** |
| 1 | LOGO | air-monitor:backlogo | G*** |
| 1 | SW_Push | Button_Switch_THT:SW_PUSH_6mm | SW1 |
| 1 | USB_C_Receptacle_USB2.0_16P | Connector_USB:USB_C_Receptacle_GCT_USB4105-xx-A_16P_TopMnt_Horizontal | J1 |
The 25 most common of 29 parts.

kwartzlab/Environmental-Sensor
The source for the environmental sensors used at Kwartzlab



vincerodriguez/stm32-netnode
stm32f407-based network node to report temperature in apartment


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

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.

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.
It measures 50 × 50 mm and has 2 copper layers, 1.6 mm thick.
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.
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.
Its repository states no licence, so its author keeps all rights: ask harrisoncrettol before reusing the design.