Skip to the content
2 layers288.8 × 121.8 mmPcb test, the printed circuit board in 3D

Just a custom build for a small keyboard im working on

Size
288.8 × 121.8 mm
Copper layers
2
Thickness
1.6 mm
Parts
162
Nets
123
Pads
710
Tracks, vias
1,141, 113
Pours
2
Routed
Yes
KiCad
KiCad 10.0 (file 20260206)
Created
5 Oct 2026
Updated
5 Oct 2026

Overview

Pcb test is an open-source printed circuit board by Krodity, from the Krodity/Krodity-60P-Build repository on GitHub, published under the MIT licence. It is a 2-layer board of 288.8 × 121.8 mm with 162 parts on 123 nets, routed with 1,141 tracks and 113 vias.

It is built around the AP2112K-3.3, AT32F405CCT7 and USBLC6-2SC6, with the 1N4148W among its other parts. Its parts include 61 diodes, 60 switches, 11 capacitors, 4 resistors and 3 ICs. It belongs with the keyboards and input boards of this library.

Main components

4

README

README.md

pcb-test: 60% hotswap keyboard

A 61-key ANSI 60% PCB with Kailh MX hotswap sockets, PCB-mount (5-pin) switch holes, and an on-board Artery AT32F405 with USB High-Speed at 8000 Hz polling, running QMK. Everything to order it is in order/.

Board288.75 x 121.75 mm, 2-layer, 1.6 mm, black solder mask, white silkscreen. Key grid plus a 25 mm MCU strip along the top
SwitchesCherry MX compatible. 5-pin holes (3-pin switches fit too), Kailh CPG151101S11 hotswap sockets on the back, shown as 3D models and back silkscreen outlines. The footprint matches the kiswitch library's Kailh MX land pattern exactly
StabilizersPCB-mount (screw-in) holes on Backspace 2u, Enter 2.25u, LShift 2.25u, RShift 2.75u, Space 6.25u
Diodes61 x 1N4148W (SOD-123) on the back, COL2ROW (anode on the switch side)
Matrix5 rows x 14 columns. COL0-13 -> PA15 PB3 PB4 PB5 PB6 PB7 PB8 PB9 PC13 PC14 PC15 PA0 PA1 PA2, ROW0-4 -> PA3-PA7 (generator/mcu.py)
MCUAT32F405CCT7 (LQFP48, Cortex-M4F 216 MHz, OTGHS with on-chip PHY), 12 MHz crystal, AP2112K 3.3 V LDO, USBLC6-2SC6 ESD, USB-C (HRO TYPE-C-31-M-12) out the left edge, BOOT + RESET buttons, SWD pads. Datasheet in docs/; every requirement used is cited in generator/mcu.py. USB D+/D- are hand-routed (locked); GND pour on both layers under the strip
Mounting13 x M2 holes with copper rings: 6 between keys (H1-H6), 7 in the MCU strip (H7-H13) that screw the case lid on from underneath
Checks100% routed, DRC clean, ERC clean, schematic <-> PCB parity clean, physical sanity checks pass, routed matrix verified against the QMK pin list, firmware compiles (see Verification)

Renders are in renders/ (top, bottom, angled).

Exact measurements of every key, hole, pin and edge are in MEASUREMENTS.md (regenerate with python3 generator/measure.py).

Layout reminder: this is not a GH60-case-compatible board. The MCU strip makes it taller than a standard 60% PCB, so it needs a custom or 3D-printed case.

Parts (BOM)

  • 61 x MX-style switches (3- or 5-pin)
  • 61 x Kailh MX hotswap sockets (CPG151101S11)
  • 61 x 1N4148W diodes, SOD-123 (JLC C81598, assembled by JLC)
  • the MCU circuit: 22 parts, all JLC-assembled; list with LCSC numbers in order/1-pcb/pcb-test-bom.csv
  • 4 x PCB-mount stabilizers: 3 x 2u + 1 x 6.25u (the 2.25u/2.75u keys use 2u stabs)
  • M2 screws: 6 x M2x6 + 7 x M2x12 socket head for the case in case/ (see case/README.md)
  • a switch plate (recommended with hotswap so sockets don't take the typing load)

Firmware (QMK, 8 kHz)

firmware/qmk/pcb_test/ is a QMK keyboard definition, generated by generator/gen_firmware.py. It builds with Keychron's QMK fork (github.com/Keychron/qmk_firmware, branch 2025q3), which has the AT32F405 port and High-Speed report-interval support. A checkout lives at ~/Projects/qmk-keychron/src, with its Python environment at ~/Projects/qmk-keychron/venv. build.py compiles it and copies the result to firmware/pcb_test_default.bin.

  • 8000 Hz: the keyboard endpoint runs High-Speed with bInterval 1 (every 125 µs microframe), and USB_REPORT_INTERVAL_ENABLE with the default interval 0 sends a report on every one. Debounce is sym_eager_pk, so a press goes out on the first scan that sees it.
  • Flash: hold BOOT, tap RESET (ROM USB bootloader), then dfu-util -a 0 -d 2e3c:df11 -s 0x08000000:leave -D firmware/pcb_test_default.bin. After that, Fn+B, or hold Esc while plugging in.
  • Fn layer (hold Fn, the key right of RAlt): Esc -> `/~, 1..= -> F1..F12, Backspace -> Delete, I/J/K/L -> arrows, U/O -> Home/End, Y/H -> PgUp/PgDn, P -> PrintScreen, M , . -> mute / vol- / vol+, B -> bootloader.

The earlier Raspberry Pi Pico + KMK version (board, firmware, simulator) is kept in backup-pico-1790773329/.

Regenerating

Everything is generated from generator/layout.py. After changing it:

bash
python3 generator/build.py

This does the placement, autoroutes with Freerouting (retrying until DRC is clean), pours GND under the MCU strip, writes the schematic, regenerates the QMK definition, runs ERC and DRC, the checks below, the JLC files (jlc/) and a firmware compile. It overwrites the board and schematic, so close them in KiCad first (or use File > Revert afterwards). Needs Java and ~/.local/opt/freerouting/freerouting-2.4.1.jar.

Files:

  • generator/layout.py: the key layout, matrix assignment, and symbol UUIDs
  • generator/footprints.py: writes keyboard.pretty/ (MX hotswap footprints)
  • generator/gen_board.py: places everything and assigns nets
  • generator/gen_schematic.py: the matching schematic (same UUIDs and net names)
  • generator/mcu.py: the AT32F405 circuit: parts, LCSC numbers, placement, nets, pin assignment, hand-routed USB pair
  • generator/gen_firmware.py: the QMK keyboard definition
  • generator/gen_jlc.py: jlc/ BOM + CPL + Gerber zip
  • generator/build.py: all of the above plus routing and checks

Known warnings, all expected:

  • DRC flags silk_edge_clearance twice: J1's outline silk crosses the board edge, because the receptacle deliberately overhangs it by 1.3 mm. The fab clips it.

Verification

python3 generator/build.py runs all of this automatically. Each check can also run on its own:

  • generator/verify_matrix.py follows the routed copper for every key in keyboard.json: switch column pad, diode (anode on the switch, cathode on the row), and the U1 pads those nets reach. It turns the pads into port names with the datasheet pinout, and checks them against the firmware's matrix_pins.
  • generator/sanity_check.py covers things DRC doesn't:
    • the diode cathode band is on the row side;
    • no hole cuts into a neighbouring socket;
    • stabilizer screw heads (Ø5) and M2 standoffs (Ø5.5) clear every switch, socket and diode;
    • vias under the USB-C shell are tented;
    • the hotswap footprint equals the kiswitch reference;
    • every socket has its 3D model;
    • Gerbers and drill files export.
  • kicad-cli pcb drc --schematic-parity / kicad-cli sch erc are the standard KiCad checks.

Renders: kicad-cli pcb render --use-board-stackup-colors --side top -o renders/pcb-top.png pcb-test.kicad_pcb (without --use-board-stackup-colors the CLI draws the board green).

Before ordering

  • Print the board 1:1 on paper (File > Print, 100%) and set real switches and sockets on it to check the fit.
  • Freerouting's output is valid but not pretty. Tidy the traces by hand if you care.
  • Choose black solder mask and white silkscreen when you order, to match the renders. The colour sits in the board stackup, but fabs take it from the order form, not from the Gerbers.
  • The hotswap footprint was generated here and cross-checked against the kiswitch library (pads 2.55 x 2.5 mm at (-7.085, -2.54) / (5.842, -5.08), 3.05 mm pin holes, 4.0 mm centre, 1.75 mm pegs). A 1:1 paper print with a real socket is still the cheapest final check.
  • Socket 3D model and outline shape: kiswitch (MIT / CC-BY-SA 4.0), see keyboard.3dshapes/ATTRIBUTION.txt.

Parts

162
QtyValueFootprintReferences
611N4148WDiode_SMD:D_SOD-123D1, D2, D10, D11, D12, D13, D14, D15, D16, D17, D18, D19, D20, D21, D22, D23 +45
13M2MountingHole:MountingHole_2.2mm_M2_PadH1, H2, H3, H4, H5, H6, H7, H8, H9, H10, H11, H12, H13
5100nFCapacitor_SMD:C_0603_1608MetricC3, C4, C5, C7, C9
21uFCapacitor_SMD:C_0603_1608MetricC8, C11
230pFCapacitor_SMD:C_0603_1608MetricC1, C2
25.1kResistor_SMD:R_0603_1608MetricR2, R3
1'keyboard:MX_Hotswap_1.00uSW40
1,keyboard:MX_Hotswap_1.00uSW50
1-keyboard:MX_Hotswap_1.00uSW12
1.keyboard:MX_Hotswap_1.00uSW51
1/keyboard:MX_Hotswap_1.00uSW52
10keyboard:MX_Hotswap_1.00uSW11
11keyboard:MX_Hotswap_1.00uSW2
110uFCapacitor_SMD:C_0603_1608MetricC10
112MHzCrystal:Crystal_SMD_3225-4Pin_3.2x2.5mmY1
112k 1%Resistor_SMD:R_0603_1608MetricR1
12keyboard:MX_Hotswap_1.00uSW3
13keyboard:MX_Hotswap_1.00uSW4
13.3kResistor_SMD:R_0603_1608MetricR4
13V3TestPoint:TestPoint_Pad_D1.5mmTP4
14keyboard:MX_Hotswap_1.00uSW5
14.7uFCapacitor_SMD:C_0603_1608MetricC6
15keyboard:MX_Hotswap_1.00uSW6
16keyboard:MX_Hotswap_1.00uSW7
17keyboard:MX_Hotswap_1.00uSW8
18keyboard:MX_Hotswap_1.00uSW9
19keyboard:MX_Hotswap_1.00uSW10
1;keyboard:MX_Hotswap_1.00uSW39
1=keyboard:MX_Hotswap_1.00uSW13
1Akeyboard:MX_Hotswap_1.00uSW30
1AP2112K-3.3Package_TO_SOT_SMD:SOT-23-5U2
1AT32F405CCT7Package_QFP:LQFP-48_7x7mm_P0.5mmU1
1Bkeyboard:MX_Hotswap_1.00uSW47
1BOOTButton_Switch_SMD:SW_Push_1P1T_XKB_TS-1187AS1
1Bkspkeyboard:MX_Hotswap_2.00uSW14
1Ckeyboard:MX_Hotswap_1.00uSW45
1Capskeyboard:MX_Hotswap_1.75uSW29
1Dkeyboard:MX_Hotswap_1.00uSW32
1Ekeyboard:MX_Hotswap_1.00uSW18
1Enterkeyboard:MX_Hotswap_2.25uSW41
1Esckeyboard:MX_Hotswap_1.00uSW1
1Fkeyboard:MX_Hotswap_1.00uSW33
1Fnkeyboard:MX_Hotswap_1.25uSW59
1Gkeyboard:MX_Hotswap_1.00uSW34
1GNDTestPoint:TestPoint_Pad_D1.5mmTP5
1Hkeyboard:MX_Hotswap_1.00uSW35
1Ikeyboard:MX_Hotswap_1.00uSW23
1Jkeyboard:MX_Hotswap_1.00uSW36
1Kkeyboard:MX_Hotswap_1.00uSW37
1Lkeyboard:MX_Hotswap_1.00uSW38
1LAltkeyboard:MX_Hotswap_1.25uSW56
1LCtrlkeyboard:MX_Hotswap_1.25uSW54
1LShiftkeyboard:MX_Hotswap_2.25uSW42
1LWinkeyboard:MX_Hotswap_1.25uSW55
1Mkeyboard:MX_Hotswap_1.00uSW49
1Menukeyboard:MX_Hotswap_1.25uSW60
1Nkeyboard:MX_Hotswap_1.00uSW48
1NRSTTestPoint:TestPoint_Pad_D1.5mmTP3
1Okeyboard:MX_Hotswap_1.00uSW24
1Pkeyboard:MX_Hotswap_1.00uSW25
1Qkeyboard:MX_Hotswap_1.00uSW16
1Rkeyboard:MX_Hotswap_1.00uSW19
1RAltkeyboard:MX_Hotswap_1.25uSW58
1RCtrlkeyboard:MX_Hotswap_1.25uSW61
1RESETButton_Switch_SMD:SW_Push_1P1T_XKB_TS-1187AS2
1RShiftkeyboard:MX_Hotswap_2.75uSW53
1Skeyboard:MX_Hotswap_1.00uSW31
1SWCLKTestPoint:TestPoint_Pad_D1.5mmTP2
1SWDIOTestPoint:TestPoint_Pad_D1.5mmTP1
1Spacekeyboard:MX_Hotswap_6.25uSW57
1Tkeyboard:MX_Hotswap_1.00uSW20
1Tabkeyboard:MX_Hotswap_1.50uSW15
1Ukeyboard:MX_Hotswap_1.00uSW22
1USB-CConnector_USB:USB_C_Receptacle_HRO_TYPE-C-31-M-12J1
1USBLC6-2SC6Package_TO_SOT_SMD:SOT-23-6U3
1Vkeyboard:MX_Hotswap_1.00uSW46
1Wkeyboard:MX_Hotswap_1.00uSW17
1Xkeyboard:MX_Hotswap_1.00uSW44
1Ykeyboard:MX_Hotswap_1.00uSW21
1Zkeyboard:MX_Hotswap_1.00uSW43

The 159 most common of 162 parts.

Similar boards

  • 2 layers303.8 × 94.2 mm65HE PCB, the printed circuit board in 3D

    65HE PCB

    ZoharGalili/65HE_PCB

    a 65% hall effect keyboard pcb

    206 parts1
  • 4 layers112 × 75 mmKvm board, the printed circuit board in 3D

    Kvm board

    FuNK3Y/picoKVM

    A network KVM that can switch inputs of smart monitors

    95 parts6
  • 2 layers180.5 × 133.5 mmNrsk right, the printed circuit board in 3D

    Nrsk right

    0x0c/spltnrskb

    KLE レイアウト(kle/left.json、kle/right.json)から生成した、左右分割・有線接続のキーボード基板です。 KiCad 10 のプロジェクト(回路図と配線済み基板)、製造用ガーバー、BOM、QMK ファームウェア設定を含みます。筐体のデータ(アクリルのレーザーカット用 DXF/SVG と 3D プリント用 STL)も入っています。

    135 parts1
  • 4 layers70.9 × 75 mmFlagshep Audio Player V1, the printed circuit board in 3D

    Flagshep Audio Player V1

    HYLDAIC/Flagshep-V1_Audio-Player

    A high fidelity semi-portable audio player student project with provided PCB files, 3D files and Code

    77 parts1CERN-OHL-P-2.0
  • 2 layers42 × 32 mmRAMS - PCB, the printed circuit board in 3D

    RAMS - PCB

    JanClyde05/Road-Accident-Monitoring-System

    This directory contains the planning, specification, and initial KiCad project for RAMS Wearable PCB Revision C. Do not fabricate from this directory yet -- manual schematic wiring and DRC verification are still needed.

    68 parts1
  • 2 layers345 × 121.5 mmDeskFighter, the printed circuit board in 3D

    DeskFighter

    Swonkie/DeskFighter

    Design and production files for DeskFighter keyboard

    213 parts1CERN-OHL-S-2.0
  • 4 layers81 × 113.2 mmAuralab Workstation Vishal, the printed circuit board in 3D

    Auralab Workstation Vishal

    Vishalbabu-09/Auralab_Workstation

    Advanced 4-layer PCB design featuring split-plane noise isolation (AGND/DGND) and asynchronous dual-core processing. Implements a handheld multi-tool oscilloscope, current tracker, and symmetrical DC power supply.

    81 parts1
  • 4 layers55 × 55 mmDrone PCB FC, the printed circuit board in 3D

    Drone PCB FC

    Ethansuttor/drone_PCB

    An 80×80 mm STM32F405 flight controller for a 4S freestyle quad, running Betaflight off a custom target I wrote.

    90 parts

Questions

How big is the Pcb test PCB?

It measures 288.8 × 121.8 mm and has 2 copper layers, 1.6 mm thick.

What parts does the Pcb test use?

162 parts, built around the AP2112K-3.3, AT32F405CCT7, USBLC6-2SC6 and 1N4148W. 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 Pcb test KiCad files?

From the Krodity/Krodity-60P-Build repository on GitHub, at the commit this page was made from: the board is pcb-test.kicad_pcb. PCBKit opens the board in the browser, with nothing to install.

Can I use the Pcb test 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).