Keyboard 80pct

Ergon80

An 80% mechanical keyboard PCB designed around the ESP32-S3, featuring low-profile Choc V2 switches, per-key RGB, an OLED display, and a USB hub.

Features

• MCU: ESP32-S3-WROOM-1 (dual-core, Wi-Fi, Bluetooth)
• USB Hub: USB2512B with 3x USB-C ports
• Switches: 80x Kailh Choc V2 low-profile (5.5mm travel)
• Lighting: 80x SK6812 Mini-E addressable RGB LEDs (reverse-mount on B.Cu)
• Display: SSD1306 0.91" OLED (128x32, I2C)
• RTC: DS3231SN precision real-time clock (I2C)
• Encoder: EC11E rotary encoder with push switch
• Mounting: 8x M2 mounting holes

Project Structure

ergon80/
├── generate_schematic.py     # Generates KiCad 10 schematic
├── generate_pcb.py           # Generates KiCad 10 PCB layout
├── keyboard-layout.json      # KLE layout definition (80% TKL)
├── keyboard_80pct.kicad_sch  # Generated schematic
├── keyboard_80pct.kicad_pcb  # Generated PCB layout
├── keyboard_80pct.kicad_pro  # KiCad project file
├── keyboard_80pct_BOM.csv    # Bill of materials with MPNs
├── fp-lib-table              # Footprint library table
├── keyboard_80pct.pretty/    # Custom footprints
│   ├── SW_Kailh_Choc_V2.kicad_mod
│   └── Module_DS3231.kicad_mod
└── jlcpcb_output/            # JLCPCB fabrication files (Gerbers, BOM, PnP)

Prerequisites

• KiCad 10 (for opening/editing the project)
• Python 3.13+ (for running the generators)

Usage

Generating the schematic and PCB

python3 generate_schematic.py
python3 generate_pcb.py

Opening in KiCad

Open keyboard_80pct.kicad_pro in KiCad 10 to view and edit the schematic or PCB layout.

Ordering PCBs

Pre-exported JLCPCB fabrication files are in jlcpcb_output/:

• Upload the Gerber files (*.gbr + *.drl) to JLCPCB
• Use keyboard_80pct_jlcpcb_bom.csv for the BOM
• Use keyboard_80pct_pos.csv for pick-and-place

Bill of Materials

License

CC BY-NC-SA 4.0 - This project is based on klepcbgen by Jeroen Bouwens.