Skip to the content
2 layers330 × 130.8 mmErgo k33b, the printed circuit board in 3D

56-key split/unified ortholinear keyboard with an integrated trackpad

Size
330 × 130.8 mm
Copper layers
2
Thickness
1.6 mm
Parts
132
Nets
79
Pads
801
Tracks, vias
1,101, 13
Routed
Yes
KiCad
KiCad 10.0 (file 20260206)
Created
2 Jun 2026
Updated
10 Jun 2026

Overview

Ergo k33b is an open-source printed circuit board by acornejo, from the acornejo/ergo-k33b repository on GitHub, published under the MIT licence. It is a 2-layer board of 330 × 130.8 mm with 132 parts on 79 nets, routed with 1,101 tracks and 13 vias.

Its parts include 56 diodes and 56 switches. It belongs with the keyboards and input boards of this library.

README

README.md

ergo-k33b

A 56-key split/unified ortholinear keyboard with an integrated trackpad, designed in Ergogen and routed manually in KiCad.

Overview

The ergo-k33b is a custom keyboard PCB featuring a symmetric 6×4 column-staggered matrix on each half, palm modifier keys, a 3-key thumb cluster per side, and an optional 65mm×50mm Azoteq TPS65 trackpad mounted in the center of the board.

The board uses a single unified PCB that mirrors the left and right halves — no split cable required.

Images

PCB — Top

PCB Top

PCB — Bottom

PCB Bottom

Front Plate

Front Plate

Back Plate

Back Plate

Case

Case

Key Layout

  • Total keys: 56 (10 palm keys + 6 thumb keys + 40 matrix keys)
  • Matrix: 6 columns × 4 rows per side, with column stagger:
    • Outer/pinky columns: +0/+2.5 mm stagger
    • Ring column: +5 mm stagger
    • Middle column: +2.5 mm stagger
    • Index column: −2.5 mm stagger
    • Inner column: −5 mm stagger
  • Thumb cluster: 3 keys per side, splayed outward from the inner-bottom matrix position
  • Palm keys: 1 key per side below the outer column, intended for modifier keys
  • Switch type: Cherry MX (5-pin), with optional hotswap socket support

Hardware

ComponentPartNotes
MCUNice!Nano (nRF52840 SuperMini)Mounted on the back, centered between halves
DisplayNice!ViewOptional; SPI via P1/P2/P3
TrackpadAzoteq TPS65 (65mm × 50mm)Optional; I²C via P4/P5, ready signal P0
SwitchesCherry MX 5-pinHotswap and solder options
DiodesSOD-123 (SMD) + THTBoth footprints populated; one per key
Battery connectorMolex Pico EZmate 1×2Also exposes BAT_P / GND solder pads as an alternative
Trackpad connectorMolex Pico EZmate 1×5Also exposes RST / RDY / GND / VCC / SCL / SDA solder pads as an alternative
Power switchSMD side-mountOn the back of the board
Reset buttonSMD side-mountOn the back of the board

Connector choice

Both the battery and trackpad use Molex Pico EZmate connectors rather than the more common JST-PH standard. Pico EZmate has a lower profile (1.48 mm mated height vs. 3.0 mm for JST-PH), which keeps the overall board assembly thinner. Each connector also has corresponding solder pad footprints on the PCB, so you can wire the battery or trackpad directly without a connector if preferred.

PCB Design

The PCB was designed using Ergogen v4.2 to generate the board outline, key positions, and component footprints from ergogen/config.yaml. Routing was done manually in KiCad. The freerouting scripts in this repo are provided for experimentation only.

Three PCBs are generated from the Ergogen config:

PCBDescription
main_boardThe keyboard PCB with all switches, diodes, MCU, and connectors
frontplateSwitch plate with key cutouts and screw holes
backplateBottom cover plate with screw holes

A bottom_case 3D model (STL) is also generated from the Ergogen outlines using OpenJSCAD.

Pinout (nRF52840 SuperMini)

PinFunction
P21Column: outer
P20Column: pinky
P19Column: ring
P18Column: middle
P15Column: index
P14Column: inner
P10Row: bottom
P8Row: home
P16Row: top
P7Row: num
P9Row: thumb cluster
P13Row: palm keys
P0Trackpad RDY
P4Trackpad SCL (I²C)
P5Trackpad SDA (I²C)
P6Trackpad RST
P1Nice!View CS
P2Nice!View MOSI
P3Nice!View SCK

Repository Structure

text
ergogen/
  config.yaml       # Full Ergogen board definition
output/
  pcbs/             # Generated KiCad PCB files
  cases/            # Generated OpenJSCAD and STL files
  outlines/         # Generated outline DXFs
  gerbers/          # Fabrication outputs
scripts/
  boards.kibot.yaml # KiBot config for main board exports
  default.kibot.yaml# KiBot config for plate exports
  export_dsn.py     # Export KiCad PCB to Specctra DSN
  import_ses.py     # Import Specctra SES back to KiCad
  freerouting.rules # Freerouting design rules
main_board.kicad_pcb # Hand-routed main board (source of truth)
build.sh            # Docker-based build script (KiBot + Freerouting)
images/             # Board renders

Building

Prerequisites

  • Node.js (for Ergogen and OpenJSCAD CLI)
  • Docker (for KiBot and Freerouting via containers)

Generate PCB and case files from Ergogen

bash
npm install
npm run build

This runs Ergogen to regenerate all PCBs, outlines, and case STL files under output/.

Export Gerbers and run autorouting

bash
./build.sh

This uses Docker to:

  1. Run KiBot to export Gerbers for plates and boards
  2. Export the board to Specctra DSN format
  3. Autoroute with Freerouting (25 passes)
  4. Import the routed SES back to KiCad and re-export Gerbers

Note: The hand-routed main_board.kicad_pcb at the repo root is the production board. The autorouted output is for experimentation only.

Clean generated output

bash
npm run clean

Firmware

The Nice!Nano runs ZMK Firmware. Create a ZMK config repo with a shield definition matching the matrix pinout above.

License

See LICENSE.

Parts

132
QtyValueFootprintReferences
56ceoloide:diode_tht_sod123D1, D2, D10, D11, D12, D13, D14, D15, D16, D17, D18, D19, D20, D21, D22, D23 +40
28custom_lib:switch_mx2S29, S30, S31, S32, S33, S34, S35, S36, S37, S38, S39, S40, S41, S42, S43, S44 +12
28ceoloide:switch_mxS1, S2, S10, S11, S12, S13, S14, S15, S16, S17, S18, S19, S20, S21, S22, S23 +12
12ceoloide:mounting_hole_npthMH1, MH2, MH3, MH4, MH5, MH6, MH7, MH8, MH9, MH10, MH11, MH12
2padsBAT_PADS1, TPAD_PADS1
1ceoloide:power_switch_smd_sidePWR1
1ceoloide:reset_switch_smd_sideRST1
1Connector_Molex:Molex_Pico-EZmate_78171-0002_1x02-1MP_P1.20mm_VerticalBAT1
1ceoloide:display_nice_viewDISP1
1Connector_Molex:Molex_Pico-EZmate_78171-0005_1x05-1MP_P1.20mm_VerticalTPAD
1ceoloide:mcu_supermini_nrf52840MCU1

Similar boards

  • 2 layers89 × 100 mmHub16, the printed circuit board in 3D

    Hub16

    joshajohnson/Hub16

    A macro pad with 16 keys, two rotary encoders, a four port USB hub, and plenty of LEDs!

    132 parts388
  • 2 layers36.5 × 56 mmFoc driver, the printed circuit board in 3D

    Foc driver

    sirojudinMunir/sf-motion

    Open-source Motion Control Platform

    132 parts135MIT
  • 2 layers306.1 × 130.2 mm8-Bit CPU 32k, the printed circuit board in 3D

    8-Bit CPU 32k

    slu4coder/Minimal-64-Home-Computer

    Legacy: Full TTL-only home computer with VGA and PS/2 and twice the processing power of a Commodore 64

    132 parts94
  • 2 layers65 × 45 mmBetaBoard, the printed circuit board in 3D

    BetaBoard

    timbk/BetaBoard

    A simple and low cost particle detector for teaching

    132 parts85BSD-2-Clause
  • 2 layers152.4 × 104.7 mmJiran classic, the printed circuit board in 3D

    Jiran classic

    Ladniy/jiran

    Ergo Split Keyboard

    132 parts67
  • 2 layers100 × 100 mmGuitarPico, the printed circuit board in 3D

    GuitarPico

    profdc9/GuitarPico

    A guitar effects processor based on the Raspberry Pi Pico

    132 parts49
  • 2 layers38.8 × 60.7 mm4bp ZIFF MD9, the printed circuit board in 3D

    4bp ZIFF MD9

    RIP-Felix/MEGA-AV-main

    Timeline of events: ACE9921 & Villahed94 developed the original Mega Amp 1.0. Inception for a mod board that combines the Mega Amp with an RGB video amplifier was Bob from RetroRGB's idea.

    132 parts49
  • 2 layers101 × 107 mmSk730-cv sequencer, the printed circuit board in 3D

    Sk730-cv sequencer

    mirdej/synkie

    The Synkie is a modular open source analog video processor, developed by Michael Egger, Max Egger and Flo Kaufmann

    132 parts47

Questions

How big is the Ergo k33b PCB?

It measures 330 × 130.8 mm and has 2 copper layers, 1.6 mm thick.

What parts does the Ergo k33b use?

132 parts. 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 Ergo k33b KiCad files?

From the acornejo/ergo-k33b repository on GitHub, at the commit this page was made from: the board is main_board.kicad_pcb. PCBKit opens the board in the browser, with nothing to install.

Can I use the Ergo k33b 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).