Skip to the content
2 layers89.2 × 103.5 mmOas, the printed circuit board in 3D

OAS — Open Ambient Sensor: DIY multi-sensor indoor environmental monitor (CO2, PM, VOC/NOx, temperature/humidity, mmWave presence) on ESP32-C6 with ESPHome / Home Assistant integration

Size
89.2 × 103.5 mm
Copper layers
2
Thickness
1.6 mm
Parts
64
Nets
45
Pads
188
Tracks, vias
373, 37
Pours
3
Routed
Yes
KiCad
KiCad 10.0 (file 20260206)
Created
11 May 2026
Updated
28 Sep 2026

Overview

Oas is an open-source printed circuit board by hubertciebiada, from the hubertciebiada/open-ambient-sensor repository on GitHub, published under the GPL-3.0 licence. It is a 2-layer board of 89.2 × 103.5 mm with 64 parts on 45 nets, routed with 373 tracks and 37 vias.

It is built around the LM2596S-5.0, TPS62933DRL and SK6812SIDE-A, with the 1812L075/33DR, 220UF 10V 5*7 and AO3401A among its other parts. Its parts include 23 capacitors, 10 diodes, 8 connectors, 7 resistors and 2 ICs. It belongs with the home automation and IoT and sensors and measurement boards and the ESP32 and RISC-V boards of this library.

Main components

8

README

README.md

OAS — Open Ambient Sensor

DIY multi-sensor environmental monitor for indoor spaces.
Measures air quality and presence; mounts on a standard wall-recessed electrical box; runs ESPHome and integrates natively with Home Assistant.

License: GPLv3 Status: v0.54 built and validated Release MCU: ESP32-C6 Framework: ESPHome

https://github.com/user-attachments/assets/d60150c3-3ed5-4fff-b437-b9b54c48e413

OAS mounted on a wall in the dark: the AQI ring glows green through the perforated AK-N-94 cover OAS v0.54 PCB after SMT assembly, THT parts hand-soldered, daughterboards not yet fitted


Status

v0.54 — manufactured, bench-validated and in use. Boards of this revision were fabricated and SMT-assembled at JLCPCB, brought up on the bench with a repeatable per-unit check, and run in a multi-unit deployment as the sensor input for Home Assistant HVAC automations. Working on the delivered hardware: the 24 V power chain, the Sensirion SEN66 (CO₂ / PM / VOC / NOx / T / RH, with Sensirion's STAR temperature compensation running inside the module), the HLK-LD2410C presence radar including stillness detection, the LED ring, Wi-Fi / OTA / native Home Assistant API, the Bluetooth proxy and the on-device web dashboard. The firmware reports project_version: v0.54, matching the version printed on the silkscreen. The design is fully script-generated and verified: build.py 35/35 stages PASS, DRC 0 violations / 0 unconnected, JLCPCB DFM 0 Danger on both the bare-board and assembly checks. The production files for this revision are attached to the GitHub release. See CLAUDE.md for the design rationale, hard constraints and the lessons learned along the way.


Can I build one today?

Yes — this revision has been built and works. What to know before ordering:

  • The production files are in the repo. hardware/output/jlcpcb/ holds the gerber + drill bundle, the BOM and the CPL files for JLCPCB SMT assembly (also attached to the GitHub release); they are regenerated and verified by the 35-stage pipeline on every build. Follow the ordering workflow in CLAUDE.md — in particular the pre-payment Assembly Order cross-check, which has caught wrong-part substitutions more than once.
  • Seven components are hand-soldered after assembly — the 24 V terminal block, the two ESP32-C6-DevKitM-1 socket headers, the LD2410C header and the three THT capacitors — and the SEN66 is attached with its JST GH lead and zip ties. Flashing and Home Assistant onboarding are documented in firmware/README.md.
  • Cost positioning. OAS deliberately sits above bargain-DIY BOM cost: a calibrated Sensirion SEN66 combo sensor, an mmWave radar with stillness detection, and a commercial-grade injection-moulded enclosure are all premium choices made on purpose — see Design philosophy. If lowest possible cost is your priority, other open-source projects optimise for that instead.

Known limitations (findings on the built units):

  • The LED ring effect is weaker than designed. For the SEN66 to read correctly inside the enclosure, an air duct has to guide room air from the perforated cover to the sensor inlet, and that duct sits in front of part of the ring. The duct is not part of this repository yet.
  • Detecting a sleeping person relies on the presence timeout, not on the radar's still-target thresholds — see the notes in firmware/esphome/packages/presence.yaml.
  • v0.51 prototype boards need the pin overrides in firmware/esphome/HARDWARE-COMPAT-v0.51.md; v0.54 boards run the firmware defaults.

A consolidated step-by-step build guide is not written yet; open work is tracked in the TODO list in CLAUDE.md.


What it measures

  • Air quality — CO₂, PM1 / PM2.5 / PM4 / PM10, VOC index, NOx index, temperature, relative humidity (Sensirion SEN66)
  • Occupancy / presence — mmWave radar with stillness detection (HiLink HLK-LD2410C)

Additional features

  • 7× SK6812-SIDE RGB AQI ring with breathing effect (7 LEDs on an 8-slot ring; D13 vacated for the J1 24 V terminal); colour reflects an aggregated air-quality index
  • Bluetooth proxy — extends BLE range across the deployment for Home Assistant BLE integrations
  • Qwiic / STEMMA QT expansion port — future sensors without a PCB respin

Design philosophy

The open-source DIY space offers many indoor-air-quality projects. Most optimise aggressively for cost. OAS holds two priorities non-negotiable, even when the trade-off is a higher per-unit BOM than the cheapest alternatives:

  1. Measurement quality. Sensor choices favour accuracy and long-term stability over price.
  2. Aesthetic acceptability. The device is meant to live in inhabited rooms; a commercial-grade injection-moulded enclosure replaces the typical 3D-printed box.

Both compromises (cheap-but-inaccurate, accurate-but-ugly) are rejected. See CLAUDE.md for the full rationale and the hard constraints any change must clear.


Hardware overview

FunctionComponentInterface
MCUESP32-C6-DevKitM-1-N4 (EAN 5904422385651)2× USB-C on module
Air quality comboSensirion SEN66-SIN-TI²C (JST GH 6-pin cable)
PresenceHiLink HLK-LD2410CUART @ 256000 baud
Visual indicator7× SK6812-SIDE side-emit ring (Ø26 mm base pitch, 8 slots with D13 vacated for J1)1-wire WS281x on GPIO 8
Power input24 V DC terminal block + TVS + PTC + reverse-polarity P-FET—

Enclosure: SZOMK AK-N-94 (Ø128 mm perforated white ABS). PCB is a Ø120 mm D-shape with a flat chord along the bottom edge. Mounts on a standard wall-recessed electrical box (60 mm screw pitch).

Authoritative module metadata (EAN, MPN, datasheet URLs, derived dimensions) lives in hardware/kicad/boardgen/_project.py::EXTERNAL_MODULES. Pinout is in boardgen/_project.py::GPIO_ASSIGNMENTS. Full design rationale and hard constraints: CLAUDE.md.


Repository layout

text
open-ambient-sensor/
├── README.md                       # this file
├── CLAUDE.md                       # design rationale, hard constraints, working conventions
├── GPLv3-LICENSE.md
├── .gitignore
├── media/                          # promo video (oas-promo.mp4) + README photos (oas-*.webp)
├── firmware/
│   ├── README.md                   # flashing + Home Assistant integration
│   ├── esphome/
│   │   ├── oas.yaml                # top-level ESPHome config
│   │   ├── packages/               # core / leds / air-quality / presence / bt-proxy
│   │   └── examples/               # anonymized per-device override examples
│   ├── tools/                      # bringup_check.py — repeatable per-unit bench check
│   └── secrets.yaml.example
└── hardware/
    ├── kicad/
    │   ├── build.py                # THE single entrypoint — emits sources + runs the 35-stage pipeline
    │   ├── boardgen/               # source of truth — generators for every .kicad_* file
    │   ├── pipeline/               # 35 verification/export stages (generic / oas / jlcpcb)
    │   ├── tests/                  # unit-test suite (pytest; run by stage 16 of build.py)
    │   ├── tools/                  # manual-trigger scripts (route extract, DFM upload, jlcparts cache)
    │   ├── oas_routes.py           # routing snapshot (replayed onto the generated PCB)
    │   ├── lcsc_mapping.py         # SMD BOM — LCSC SKU source of truth
    │   └── oas.kicad_*             # generated KiCad project files (derived artefacts — never hand-edit)

Rebuilding the design from source

The KiCad project is fully script-generated. The .kicad_pcb / .kicad_sch / .kicad_pro / library files are derived artefacts — never hand-edit them; the next build overwrites every edit. The source of truth lives in hardware/kicad/boardgen/ (Python generators), lcsc_mapping.py (SMD BOM), and oas_routes.py (routing snapshot).

sh
cd hardware/kicad
python build.py

build.py is the only top-level entrypoint. It regenerates every KiCad source file bit-identically (deterministic v5 UUIDs — an unchanged tree produces an empty git diff) and then runs the full 35-stage verification pipeline: DRC, ERC, determinism self-check, analytical DC / ampacity / boot-strap / thermal / I²C-rise-time checks, ngspice SPICE simulations (buck soft-start, IEC 61000-4-5 surge, reverse polarity), unit tests, renders, and the vendor export stages that produce the JLCPCB deliverables. Any stage failure aborts the build.

Requirements:

  • Python 3.11+
  • KiCad 10 with kicad-cli on PATH
  • pip install mypy pytest cairosvg pygerber
  • git submodule update --init (kicad-skip, InteractiveHtmlBom, jlcparts, and other tools under hardware/kicad/third_party/)
  • One-time jlcparts offline cache for the LCSC part-verification stage: python hardware/kicad/tools/setup_jlcparts_cache.py (~2 GiB download, expands to a local SQLite cache)

ngspice and the vendor SPICE models are downloaded automatically into a gitignored .tmp/ directory on first run. Individual pipeline stages are independently runnable for debugging (e.g. python pipeline/generic/03_drc.py), but a committable state always comes from a full build.py pass.


Contributing

Contributions are welcome once the design stabilises. Any change must clear both design pillars (measurement quality, aesthetic acceptability) and the hard constraints listed in CLAUDE.md.

This is a public repository — see the public-repository rules for the anonymisation and third-party-IP requirements that apply to every committed file.


License

GNU General Public License v3.0 — see GPLv3-LICENSE.md.


References

Parts

64
QtyValueFootprintReferences
8100nFCapacitor_SMD:C_0603_1608MetricC7, C10, C11, C13, C14, C15, C16, C17
7100nFCapacitor_SMD:C_0402_1005MetricC20, C21, C23, C24, C25, C26, C27
7SK6812-SIDEoas:SK6812-SIDED11, D12, D14, D15, D16, D17, D18
4ZipTieHole_3mm_NPTHoas:ZipTieHole_3mm_NPTHZT1, ZT2, ZT3, ZT4
3MountingHole_3.8mm_M3_NPTHoas:MountingHole_3.8mm_M3H1, H2, H3
2100uF/50VCapacitor_THT:CP_Radial_D8.0mm_P3.50mmC1, C3
210uFCapacitor_SMD:C_0805_2012MetricC5, C9
24.7kResistor_SMD:R_0603_1608MetricR5, R6
1100kResistor_SMD:R_0603_1608MetricR2
1100k 1%Resistor_SMD:R_0603_1608MetricR1
110V Zener 200mWDiode_SMD:D_SOD-323D3
110kResistor_SMD:R_0603_1608MetricR7
110nF Y2Capacitor_SMD:C_0805_2012MetricC2
11812L075/33DRoas:Fuse_1812L_4532MetricF1
11kResistor_SMD:R_0603_1608MetricR4
11x5 P2.54mm header (HLK-LD2410C)Connector_PinHeader_2.54mm:PinHeader_1x05_P2.54mm_VerticalJ4
12.2uHInductor_SMD:L_Cenker_CKCS5040L2
1220uF/10VCapacitor_THT:CP_Radial_D6.3mm_P2.50mmC4
122uFCapacitor_SMD:C_0805_2012MetricC6
130.9kResistor_SMD:R_0603_1608MetricR3
133uHInductor_SMD:L_Cenker_CKCS5040L1
147nFCapacitor_SMD:C_0603_1608MetricC8
1AO3401APackage_TO_SOT_SMD:SOT-23Q1
1ESP32 row A (pins 1..15, antenna-side row)Connector_PinSocket_2.54mm:PinSocket_1x15_P2.54mm_VerticalJ5
1ESP32 row B (pins 16..30, USB-side row)Connector_PinSocket_2.54mm:PinSocket_1x15_P2.54mm_VerticalJ6
1JST SM04B-SRSS-TB (Qwiic / Stemma QT)Connector_JST:JST_SH_SM04B-SRSS-TB_1x04-1MP_P1.00mm_HorizontalJ9
1JST SM06B-GHS-TB (SEN66 connector)Connector_JST:JST_GH_SM06B-GHS-TB_1x06-1MP_P1.25mm_HorizontalJ3
1LD2410_Mechanical_Referenceoas:LD2410_Mechanical_ReferenceLDR1
1LM2596S-5.0oas:TO-263-5_LM2596U1
1Native-USB recovery (DNP)Connector_PinHeader_2.54mm:PinHeader_1x06_P2.54mm_VerticalJ10
1Phoenix_MSTBA_2,5/3-G-5,08 (24V input)Connector_Phoenix_MSTB:PhoenixContact_MSTBA_2,5_3-G-5,08_1x03_P5.08mm_HorizontalJ1
1SEN66_Mechanical_Referenceoas:SEN66_Mechanical_ReferenceSENS1
1SMBJ24ADiode_SMD:D_SMBD1
1SS14Diode_SMD:D_SMAD2
1TPS62933Package_TO_SOT_SMD:SOT-583-8U2
1UART/Boot Recovery (DNP)Connector_PinHeader_2.54mm:PinHeader_1x06_P2.54mm_VerticalJ2
1oas:ESP32-C6-DevKitM-1_Referenceoas:ESP32-C6-DevKitM-1_ReferenceMOD1

Similar boards

  • 4 layers100 × 90 mmControl board, the printed circuit board in 3D

    Control board

    EERNINUO/ArbWave30

    ArbWave30 – 30MHz 任意波形发生器 | FPGA + 高速DAC | SCPI 可控

    149 parts53GPL-3.0
  • 2 layers210 × 145 mmPh verzion-01, the printed circuit board in 3D

    Ph verzion-01

    tomas-fly/davkovanie-ph-PCB

    104 parts
  • 2 layers98.5 × 16 mmPCB design Course, the printed circuit board in 3D

    PCB design Course

    AvishkaVishwa/12V-to-5V-DC-Conveter

    12 parts1
  • 2 layers320 × 136 mmGov tracker Panel, the printed circuit board in 3D

    Gov tracker Panel

    lectrotel/Gov_tracker_PCB

    Govenor tracker PCB

    689 parts
  • 4 layers170 × 101 mmFreeDSP G, the printed circuit board in 3D

    FreeDSP G

    freeDSP/FreeDSP-G

    ADAU1467 DSP Board for Electric Guitar Players

    377 parts7CC0-1.0
  • 2 layers66.7 × 121 mmBsidesDSM26, the printed circuit board in 3D

    BsidesDSM26

    wrickert/UntitledElectronics

    99 parts8
  • 2 layers75.9 × 42 mmDecoder esp32 rev1, the printed circuit board in 3D

    Decoder esp32 rev1

    jelgerlemmens/ToyTrainESP32

    ESP32-C3 WiFi DCC decoder firmware and KiCad PCB design

    53 parts

Questions

How big is the Oas PCB?

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

What parts does the Oas use?

64 parts, built around the LM2596S-5.0, TPS62933DRL, SK6812SIDE-A and 1812L075/33DR. 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 Oas KiCad files?

From the hubertciebiada/open-ambient-sensor repository on GitHub, at the commit this page was made from: the board is hardware/kicad/oas.kicad_pcb and its schematic hardware/kicad/io.kicad_sch. PCBKit opens the board in the browser, with nothing to install.

Can I use the Oas design in my own project?

Its repository publishes it under the GPL-3.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).