

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
8LM2596S-5.0
TO-263-5-40℃~+125℃@(TJ) 1 150kHz 3A 4.5V~40V 5V 5mA Buck Buck Built-in Fixed No TO-263-5 DC-DC Converters ROHSTexas InstrumentsDC-DC ConvertersTPS62933DRL
SOT-583-40℃~+150℃@(TJ) 1 12uA 2.2MHz 3.8V~30V 3A 800mV~22V Adjustable Buck Buck Built-in Yes SOT-583 DC-DC Converters ROHSTexas InstrumentsDC-DC ConvertersSK6812SIDE-A
SMD-4P,4x1.6mm-40℃~+85℃ 0.6mA 1.6mm 120° 160mcd~320mcd 1kHz 2000V 240mcd~450mcd 2mm 3.7V~5.5V 460nm~470nm 4mm 520nm~535nm 620nm~625nm 697.5mcd~1162.5mcd 800Kbit/s Built-in power-on reset circuit Translucent Frosted Lens SMD-4P,4x1.6mm RGB LEDs(Built-in IC) ROHSOPSCO OptoelectronicsRGB LEDs(Built-In IC)1812L075/33DR
1812-40℃~+85℃ 1.55mm 1.5A 110mΩ 200ms 20A 3.41mm 33V 4.73mm 400mΩ 750mA 800mW 1812 Resettable Fuses ROHSLittelfuseResettable Fuses220UF 10V 5*7
插件,5x7mm1000hrs@105℃ 10V 220uF 2mm 5mm 7mm 插件,5x7mm Aluminum Electrolytic Capacitors - Leaded ROHSLCSCAluminum Electrolytic Capacitors - LeadedAO3401A
SOT-231 P-Channel 14nC@10V 30V 47mΩ@10V、60mΩ@4.5V、85mΩ@2.5V 4A 55pF 645pF 80pF 900mV SOT-23 MOSFETs ROHSAlpha & Omega SemiconductorMOSFETsSMBJ24A
DO-214AA(SMB)-55℃~+150℃ 15.4A 24V 26.7V 38.9V 5uA 600W TVS Unidirectional DO-214AA(SMB) ESD and Surge Protection (TVS/ESD) ROHSGOODWORKESD And Surge Protection (TVS/ESD)SS14
SMA(DO-214AC)-55℃~+150℃ 1A 25A 300uA@40V 40V 550mV@1A Independent SMA(DO-214AC) Schottky Diodes ROHSMDDSchottky Diodes
README
README.mdOAS — 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.
https://github.com/user-attachments/assets/d60150c3-3ed5-4fff-b437-b9b54c48e413
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 inCLAUDE.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:
- Measurement quality. Sensor choices favour accuracy and long-term stability over price.
- 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
| Function | Component | Interface |
|---|---|---|
| MCU | ESP32-C6-DevKitM-1-N4 (EAN 5904422385651) | 2× USB-C on module |
| Air quality combo | Sensirion SEN66-SIN-T | I²C (JST GH 6-pin cable) |
| Presence | HiLink HLK-LD2410C | UART @ 256000 baud |
| Visual indicator | 7× SK6812-SIDE side-emit ring (Ø26 mm base pitch, 8 slots with D13 vacated for J1) | 1-wire WS281x on GPIO 8 |
| Power input | 24 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
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).
cd hardware/kicad
python build.pybuild.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-clionPATH pip install mypy pytest cairosvg pygerbergit submodule update --init(kicad-skip, InteractiveHtmlBom, jlcparts, and other tools underhardware/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
- AirGradient ONE (open-source inspiration): https://github.com/airgradienthq/arduino
- Sensirion SEN66 product page: https://sensirion.com/products/catalog/SEN66
- HiLink LD2410 documentation: https://www.hlktech.net
- ESPHome documentation: https://esphome.io
- JLCPCB component library: https://jlcpcb.com/parts
Parts
64| Qty | Value | Footprint | References |
|---|---|---|---|
| 8 | 100nF | Capacitor_SMD:C_0603_1608Metric | C7, C10, C11, C13, C14, C15, C16, C17 |
| 7 | 100nF | Capacitor_SMD:C_0402_1005Metric | C20, C21, C23, C24, C25, C26, C27 |
| 7 | SK6812-SIDE | oas:SK6812-SIDE | D11, D12, D14, D15, D16, D17, D18 |
| 4 | ZipTieHole_3mm_NPTH | oas:ZipTieHole_3mm_NPTH | ZT1, ZT2, ZT3, ZT4 |
| 3 | MountingHole_3.8mm_M3_NPTH | oas:MountingHole_3.8mm_M3 | H1, H2, H3 |
| 2 | 100uF/50V | Capacitor_THT:CP_Radial_D8.0mm_P3.50mm | C1, C3 |
| 2 | 10uF | Capacitor_SMD:C_0805_2012Metric | C5, C9 |
| 2 | 4.7k | Resistor_SMD:R_0603_1608Metric | R5, R6 |
| 1 | 100k | Resistor_SMD:R_0603_1608Metric | R2 |
| 1 | 100k 1% | Resistor_SMD:R_0603_1608Metric | R1 |
| 1 | 10V Zener 200mW | Diode_SMD:D_SOD-323 | D3 |
| 1 | 10k | Resistor_SMD:R_0603_1608Metric | R7 |
| 1 | 10nF Y2 | Capacitor_SMD:C_0805_2012Metric | C2 |
| 1 | 1812L075/33DR | oas:Fuse_1812L_4532Metric | F1 |
| 1 | 1k | Resistor_SMD:R_0603_1608Metric | R4 |
| 1 | 1x5 P2.54mm header (HLK-LD2410C) | Connector_PinHeader_2.54mm:PinHeader_1x05_P2.54mm_Vertical | J4 |
| 1 | 2.2uH | Inductor_SMD:L_Cenker_CKCS5040 | L2 |
| 1 | 220uF/10V | Capacitor_THT:CP_Radial_D6.3mm_P2.50mm | C4 |
| 1 | 22uF | Capacitor_SMD:C_0805_2012Metric | C6 |
| 1 | 30.9k | Resistor_SMD:R_0603_1608Metric | R3 |
| 1 | 33uH | Inductor_SMD:L_Cenker_CKCS5040 | L1 |
| 1 | 47nF | Capacitor_SMD:C_0603_1608Metric | C8 |
| 1 | AO3401A | Package_TO_SOT_SMD:SOT-23 | Q1 |
| 1 | ESP32 row A (pins 1..15, antenna-side row) | Connector_PinSocket_2.54mm:PinSocket_1x15_P2.54mm_Vertical | J5 |
| 1 | ESP32 row B (pins 16..30, USB-side row) | Connector_PinSocket_2.54mm:PinSocket_1x15_P2.54mm_Vertical | J6 |
| 1 | JST SM04B-SRSS-TB (Qwiic / Stemma QT) | Connector_JST:JST_SH_SM04B-SRSS-TB_1x04-1MP_P1.00mm_Horizontal | J9 |
| 1 | JST SM06B-GHS-TB (SEN66 connector) | Connector_JST:JST_GH_SM06B-GHS-TB_1x06-1MP_P1.25mm_Horizontal | J3 |
| 1 | LD2410_Mechanical_Reference | oas:LD2410_Mechanical_Reference | LDR1 |
| 1 | LM2596S-5.0 | oas:TO-263-5_LM2596 | U1 |
| 1 | Native-USB recovery (DNP) | Connector_PinHeader_2.54mm:PinHeader_1x06_P2.54mm_Vertical | J10 |
| 1 | Phoenix_MSTBA_2,5/3-G-5,08 (24V input) | Connector_Phoenix_MSTB:PhoenixContact_MSTBA_2,5_3-G-5,08_1x03_P5.08mm_Horizontal | J1 |
| 1 | SEN66_Mechanical_Reference | oas:SEN66_Mechanical_Reference | SENS1 |
| 1 | SMBJ24A | Diode_SMD:D_SMB | D1 |
| 1 | SS14 | Diode_SMD:D_SMA | D2 |
| 1 | TPS62933 | Package_TO_SOT_SMD:SOT-583-8 | U2 |
| 1 | UART/Boot Recovery (DNP) | Connector_PinHeader_2.54mm:PinHeader_1x06_P2.54mm_Vertical | J2 |
| 1 | oas:ESP32-C6-DevKitM-1_Reference | oas:ESP32-C6-DevKitM-1_Reference | MOD1 |
Similar boards
- 4 layers100 × 90 mm

- 2 layers210 × 145 mm

- 2 layers98.5 × 16 mm

- 2 layers320 × 136 mm

- 4 layers115 × 59 mm

- 4 layers170 × 101 mm

- 2 layers66.7 × 121 mm

- 2 layers75.9 × 42 mm

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