Skip to the content
2 layersSensor node, the printed circuit board in 3D

Sensor node

conol-ai/cohdl21

Collaborative Hardware Description Language

Copper layers
2
Thickness
1.6 mm
Parts
14
Nets
14
Pads
116
Tracks, vias
0, 0
Routed
Not yet
KiCad
KiCad 10.0 (file 20260206)
Created
10 Mar 2026
Updated
8 Nov 2026

Overview

Sensor node is an open-source printed circuit board by conol-ai, from the conol-ai/cohdl repository on GitHub, published under the MIT licence. It is a 2-layer board with 14 parts on 14 nets.

It is built around the ESP32-S3-WROOM-1-N8. Its parts include 5 capacitors, 4 resistors, 2 ICs, 1 diode and 1 connector. It belongs with the home automation and IoT and sensors and measurement boards and the ESP32 boards of this library.

Main components

1

README

docs/demo/README.md

MVP demo evidence

The acceptance test from the MVP Definition (docs/design/09-mvp-definition.md): from a one-paragraph natural-language spec — "An ESP32-S3-based sensor node: USB-C power/data, one MEMS microphone, one status LED, a 3.3V LDO regulator, standard decoupling" — an LLM (no fine-tuning, prompted only with the language reference) writes .cohdl source; the compiler grades it; diagnostics are fed back verbatim; the loop lands on a clean design that emits a real KiCad netlist + BOM.

Reproduce with python3 harness/repair_loop.py (see the harness README header for backends).

Runs (2026-07-13)

RunModelReferenceAttemptsCaught & repaired
1claude-opus-4-8full2E202 ×2 (unresolved name), D003 warning
2claude-opus-4-8full1— clean first try
3claude-opus-4-8full1— clean first try
4claude-opus-4-8full, reworded spec1— clean first try
5claude-opus-4-8lean (no design notes)1— clean first try
6claude-opus-4-8lean, detailed spec2E202 (unresolved name)
7claude-haiku-4-5lean1— clean first try
8claude-opus-4-8lean, +custom tantalum device1— clean first try (wrote device + impl mapping + part correctly)
9claude-haiku-4-5lean, +custom tantalum device2E701 — unresolved required pin, repaired

The proof transcript

transcript-flagship-haiku-e701.md is the run the MVP's non-negotiable clause asks for. On attempt 1 the model left the ESP32-S3's chip-enable pin unwired, and the type checker — not DRC — caught it as a compile error naming the exact line:

text
error[E701]: required pin `SensorNode::esp32.EN` is unresolved: add it to a `net` or explicitly mark it `nc`
 --> src/main.cohdl:20:5
   |
20 |     inst esp32: ESP32_S3_WROOM_1_N8
   |     ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  :: std/soc.cohdl:13:9
   |
13 |         required EN: 3 [input]
   |         ---------------------- `EN` is declared `required` on device `ESP32_S3_WROOM_1` here

This is the exact mistake class (a forgotten wire) that v1 shipped silently and that RFC-002 moved into the type system. The diagnostic was fed back verbatim; attempt 2 wired EN through a 10k pull-up and landed clean — sensor-node.net and sensor-node-bom.csv are its emitted artifacts.

Two supplementary transcripts:

  • transcript-opus-e202.md — a resolution-error catch + repair cycle (the model invented a v1-style bare net reference, which the MVP grammar deliberately dropped).
  • transcript-opus-custom-device.md — the expressiveness half of the thesis: asked for a part the std library doesn't have, the model declared a polarized tantalum device, the explicit impl TwoTerminal pin mapping (A: Anode, B: Cathode), impl Capacitor + impl Polarized, and a part binding — all first try, all checked at the impl statements.

A note on difficulty: 6 of 9 runs were clean on the first attempt. The type system's catches fire exactly when the model errs — with a complete language reference in context, frontier models err rarely, which is the AI-generatability half of the design working as intended (Constitution priority #2). The failed attempts are what the compiler-as-oracle is for.

KiCad checkpoint — executed

The import was driven through real KiCad (pcbnew 10.0.4, its own engine, via tools/kicad_checkpoint.py — the same work File → Import Netlist performs):

  • All 14 footprints resolved from KiCad's official libraries, every netlist pin matched a real footprint pad, designators verified unique.
  • The resulting board is committed as sensor-node.kicad_pcb (open it directly in pcbnew — footprints placed, pad nets assigned, connectivity drawn), with a rendered sensor-node-board.pdf showing the components and net connectivity: USB-C → CC pulldowns, VBUS → LDO → 3.3V rail → decoupling bank + tantalum, ESP32 → I2S mic, EN pull-up, LED chain.

The checkpoint caught a real netlist-fidelity bug, exactly as intended: the std USB-C device used combined pad names (A1B12, S1) that don't exist on KiCad's official HRO footprint (separate A1…B12 pads, shield SH). The std device was corrected against the real footprint and everything regenerated.

To confirm by eye: open sensor-node.kicad_pcb in KiCad (or just the PDF), and cross-check sensor-node-bom.csv — every line item carries a real MPN.

Parts

14
QtyValueFootprintReferences
3100nFC_0402_1005MetricC1, C2, C3
25.1kohmR_0402_1005MetricR2, R3
1100uFCP_EIA-3216-18_Kemet-AC5
110kohmR_0402_1005MetricR4
110uFC_0603_1608MetricC4
11kohmR_0402_1005MetricR1
1AP2112K_3V3SOT-23-5U2
1ChipLEDLED_0603_1608MetricD1
1ESP32_S3_WROOM_1ESP32-S3-WROOM-1U1
1ICS43434InvenSense_ICS-43434-6_3.5x2.65mmMK1
1USB_C_Receptacle_2_0USB_C_Receptacle_HRO_TYPE-C-31-M-12J1

Similar boards

  • 2 layers85 × 115 mmOSO BOOK B1, the printed circuit board in 3D

    OSO BOOK B1

    joeycastillo/The-Open-Book

    For details on how to build, test and use Open Book, I've made documentation available here.

    76 parts8.1kCC-BY-SA-4.0
  • 2 layers299 × 82.5 mmPixelWave, the printed circuit board in 3D

    PixelWave

    hackclub/OnBoard

    💡 Join 1,000 teenagers and make your first PCB with a $100 grant!

    663 parts915
  • 4 layers56.5 × 99.8 mmBitaxeGamma, the printed circuit board in 3D

    BitaxeGamma

    bitaxeorg/bitaxeGamma

    Bitaxe based on the BM1370 from the S21 Pro

    147 parts432CERN-OHL-S-2.0
  • 2 layers129.5 × 50.8 mmLilka, the printed circuit board in 3D

    Lilka

    lilka-dev/lilka

    Схема та документація ігрової консолі Lilka

    39 parts234GPL-2.0
  • 4 layers84.5 × 129.5 mmBitaxeHex, the printed circuit board in 3D

    BitaxeHex

    bitaxeorg/ultraHex

    multi-ASIC Bitcoin miner

    369 parts190CERN-OHL-S-2.0
  • 2 layers110 × 115 mmEsp32 keyboard v0.1, the printed circuit board in 3D

    Esp32 keyboard v0.1

    hhuysqt/esp32s3-keyboard

    USB/BLE keyboard driver based on ESP32S3-WROOM-1

    230 parts168GPL-3.0
  • 2 layers35.1 × 36.6 mmBinNanoFOC, the printed circuit board in 3D

    BinNanoFOC

    katbinaris/nanofoc_devkit

    Compact All-In-One BLDC Controler featuiring ESP32-S3, TMC6300 and Magalpha sensors. Small 35x35mm footprint.

    76 parts146
  • 2 layers148 × 81 mmCommunicator pcb, the printed circuit board in 3D

    Communicator pcb

    Hack-a-Day/2025-Communicator_Badge

    The 2025 Hackaday Supercon RF Communicator Badge

    58 parts107MIT

Questions

What parts does the Sensor node use?

14 parts, built around the ESP32-S3-WROOM-1-N8. 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 Sensor node KiCad files?

From the conol-ai/cohdl repository on GitHub, at the commit this page was made from: the board is docs/demo/sensor-node.kicad_pcb. PCBKit opens the board in the browser, with nothing to install.

Can I use the Sensor node 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).