Layouts

ESP32 Development Boards Collection (Atopile & KiCad 10)

[blocked] [blocked]

This repository contains production-ready, breadboard-compatible hardware designs for Espressif microcontroller development boards, architected using Atopile (code-defined electronics) and automated layout/routing with KiCad 10 and Freerouting:

1. pcb2: ESP32-WROOM-32E DevKit (CP2102/CH340 USB-to-UART bridge, auto-programming circuit, dual 19-pin DIP headers).
2. esp32c6: ESP32-S3 (N16R8) DevKit (Dual USB-C ports: Native USB OTG + Hardware UART via CH340C, Addressable SK6812MINI / WS2812B RGB LED on GPIO48, 16MB Flash, 8MB Octal PSRAM, dual 22-pin DIP headers, dedicated antenna keepout).

Both boards are designed to fit standard solderless breadboards (25.4 mm / 1.0" header row pitch) with 100% routed dual-layer copper and full manufacturing Gerber packages.

Hardware Comparison Matrix

1. ESP32-S3 (N16R8) DevKit (esp32c6)

Designed for advanced Edge AI, computer vision, and high-performance IoT applications requiring large RAM, dual USB-C ports, and addressable RGB lighting.

3D Photorealistic Views

Top View (F.Cu)	Bottom View (B.Cu)

Key Highlights

• Dual USB-C Architecture:
  • USB Port (J3): Native USB OTG, USB-Serial, and on-chip JTAG directly connected to GPIO19 (D-) and GPIO20 (D+).
  • UART Port (J4): Hardware serial console and automated bootloader flashing via on-board CH340C bridge.
• On-board SK6812MINI / WS2812B RGB LED: Addressable RGB NeoPixel connected to GPIO48 with dedicated bypass capacitor on B.Cu.
• RF Integrity: Clean antenna keepout zone ensuring zero copper beneath the PCB antenna.
• Low-Inductance Decoupling: Bottom-layer bulk ($10,\mu\text{F}$) and HF ($100,\text{nF}$) capacitors located directly under the MCU body.
• Fabrication: Complete Gerber package available in esp32c6/gerbers/.

2. ESP32-WROOM-32E DevKit (pcb2)

The classic workhorse ESP32 development board, complete with an onboard CP2102 bridge and automatic reset/boot sequencing for effortless programming via the Arduino IDE, ESP-IDF, or PlatformIO.

3D Photorealistic Views

Top View (F.Cu)	Bottom View (B.Cu)

Key Highlights

• Auto-Download Circuit: Dual NPN transistors (S8050) drive EN and IO0 through DTR and RTS signals.
• Compact Breadboard Layout: 28.0 mm board width allows dual pin headers to plug directly into breadboards while leaving free tie points.
• Fabrication: Complete Gerber package available in pcb2/gerbers/.

Repository Structure

├── docs/
│   ├── images/
│   │   ├── esp32c6_top.png
│   │   ├── esp32c6_bottom.png
│   │   ├── pcb2_top.png
│   │   └── pcb2_bottom.png
│   ├── esp32c6_design_guide.md
│   └── pcb2_design_guide.md
├── esp32c6/
│   ├── main.ato                  # Atopile schematic definition
│   ├── ato.yaml                  # Atopile project config
│   ├── layout.py                 # Automated KiCad placement & rule setup
│   ├── route.py                  # DSN export, Freerouting, SES import pipeline
│   ├── layouts/default/          # KiCad 10 board files & routing files
│   └── gerbers/                  # Production Gerbers, drill & pick-and-place files
├── pcb2/
│   ├── main.ato                  # Atopile schematic definition
│   ├── ato.yaml                  # Atopile project config
│   ├── layout.py                 # Automated KiCad placement & rule setup
│   ├── layouts/default/          # KiCad 10 board files & routing files
│   └── gerbers/                  # Production Gerbers, drill & pick-and-place files
└── README.md

How to Build & Reproduce

1. Prerequisites

• Python 3.10+ (with atopile: pip install atopile)
• KiCad 10.0 (with standalone python.exe and kicad-cli.exe)
• Java JRE 17+ (for running Freerouting)

2. Validate & Build Schematics

# Validate Atopile files
ato validate esp32c6/main.ato
ato validate pcb2/main.ato

# Compile to KiCad netlists & footprints
ato build esp32c6/main.ato
ato build pcb2/main.ato

3. Run Automated Placement & Routing

# ESP32-S3 Board
& "C:\Program Files\KiCad\10.0\bin\python.exe" esp32c6/layout.py --refresh
& "C:\Program Files\KiCad\10.0\bin\python.exe" esp32c6/route.py

# Check DRC violations
& "C:\Program Files\KiCad\10.0\bin\python.exe" esp32c6/drc_summary.py

4. Export Manufacturing Files

# Export Gerbers, NC Drills, and Positions
& "C:\Program Files\KiCad\10.0\bin\kicad-cli.exe" pcb export gerbers --layers F.Cu,B.Cu,F.SilkS,B.SilkS,F.Mask,B.Mask,Edge.Cuts,F.Paste,B.Paste -o esp32c6/gerbers esp32c6/layouts/default/default.kicad_pcb
& "C:\Program Files\KiCad\10.0\bin\kicad-cli.exe" pcb export drill --excellon-units mm --excellon-separate-th -o esp32c6/gerbers esp32c6/layouts/default/default.kicad_pcb
& "C:\Program Files\KiCad\10.0\bin\kicad-cli.exe" pcb export pos --format csv --units mm -o esp32c6/gerbers/positions.csv esp32c6/layouts/default/default.kicad_pcb

License

MIT License. Open hardware design — free to manufacture, modify, and distribute.