Keeb4x4
TheRealBluesun·keeb4x4
About the Keeb4x4 PCB
Keeb4x4 is an open source STM32 PCB design by TheRealBluesun, published on GitHub under the CERN-OHL-P-2.0 license. It is a 4-layer board measuring 100 × 142.5 mm, with 119 components from 36 distinct parts.
Its main chip is the STM32G431CBT6, from the STM32 family. Other key parts include the USBLC6-2SC6, AP2112K-3.3, 74AHCT1G125, 74HC154 and W25Q128JVSIQ. By type, the board carries 29 capacitors, 19 switches, 17 resistors, 16 LEDs, 16 diodes and 15 connectors.
It belongs with the keyboards, displays & leds and usb & debug tools designs in this gallery.
From the project
4x4 macropad: STM32G431, per-key RGB, ScreenKey display keycaps, encoder. KiCad + Rust/Embassy firmware, USB bootloader, host CLI, printable base.
A 4×4 macropad: STM32G431, 16 MX-style keys with per-key SK6812 RGB, up to 12 Waveshare 0.85" ScreenKey display keycaps, an EC11 rotary encoder, and a USB-C connection that streams key/encoder events to the host as JSON. Firmware is Rust/Embassy, with a resident USB bootloader so you never need a debug probe after the first flash.
Requires rustup. Toolchains and targets are pinned per project and install automatically.

Main components on the Keeb4x4
Keeb4x4 bill of materials (BOM)
119 components, 36 distinct parts — part numbers from the project's BOM.
| Qty | Part | Footprint | Refs |
|---|---|---|---|
| 1 | STM32G431CBT6 | LQFP-48_7x7mm_P0.5mm | U1 |
| 1 | USBLC6-2SC6 | SOT-23-6 | U2 |
| 1 | AP2112K-3.3 | SOT-23-5 | U3 |
| 1 | 74AHCT1G125 | SOT-23-5 | U4 |
| 1 | 74HC154 | SOIC-24W_7.5x15.4mm_P1.27mm | U5 |
| 1 | W25Q128JVSIQ | SOIC-8_5.3x5.3mm_P1.27mm | U6 |
| 1 | AO3400A | SOT-23 | Q1 |
| 1 | USB_C_16P | USB_C_Receptacle_HRO_TYPE-C-31-M-12 | J1 |
| 1 | OLED_SSD1306 | PinHeader_1x04_P2.54mm_Vertical | J2 |
| 1 | SWD | PinHeader_1x05_P2.54mm_Vertical | J3 |
| 1 | C88360 ScreenKey1 | Hirose_FH12-12S-0.5SH_1x12-1MP_P0.50mm_Horizontal | J4 |
| 1 | C88360 ScreenKey2 | Hirose_FH12-12S-0.5SH_1x12-1MP_P0.50mm_Horizontal | J5 |
| 1 | C88360 ScreenKey3 | Hirose_FH12-12S-0.5SH_1x12-1MP_P0.50mm_Horizontal | J6 |
| 1 | C88360 ScreenKey4 | Hirose_FH12-12S-0.5SH_1x12-1MP_P0.50mm_Horizontal | J7 |
| 1 | C88360 ScreenKey5 | Hirose_FH12-12S-0.5SH_1x12-1MP_P0.50mm_Horizontal | J8 |
| 1 | C88360 ScreenKey6 | Hirose_FH12-12S-0.5SH_1x12-1MP_P0.50mm_Horizontal | J9 |
| 1 | C88360 ScreenKey7 | Hirose_FH12-12S-0.5SH_1x12-1MP_P0.50mm_Horizontal | J10 |
| 1 | C88360 ScreenKey8 | Hirose_FH12-12S-0.5SH_1x12-1MP_P0.50mm_Horizontal | J11 |
| 1 | C88360 ScreenKey9 | Hirose_FH12-12S-0.5SH_1x12-1MP_P0.50mm_Horizontal | J12 |
| 1 | C88360 ScreenKey10 | Hirose_FH12-12S-0.5SH_1x12-1MP_P0.50mm_Horizontal | J13 |
Show 16 more
| Qty | Part | Footprint | Refs |
|---|---|---|---|
| 1 | C88360 ScreenKey11 | Hirose_FH12-12S-0.5SH_1x12-1MP_P0.50mm_Horizontal | J14 |
| 1 | C88360 ScreenKey12 | Hirose_FH12-12S-0.5SH_1x12-1MP_P0.50mm_Horizontal | J15 |
| 16 | SW_Push | SW_Cherry_MX_1.00u_PCB | SW1, SW2, SW3, SW4, SW5, SW6, SW7, SW8 +8 |
| 1 | EC11 | RotaryEncoder_Alps_EC11E-Switch_Vertical_H20mm | SW17 |
| 1 | C231329 BOOT | SW_SPST_B3U-1000P | SW18 |
| 1 | C231329 RESET | SW_SPST_B3U-1000P | SW19 |
| 16 | SK6812MINI-E | LED_SK6812MINI-E_3.2x2.8mm_P1.5mm_ReverseMount | LED1, LED2, LED3, LED4, LED5, LED6, LED7, LED8 +8 |
| 16 | 1N4148W | D_SOD-123 | D1, D2, D3, D4, D5, D6, D7, D8 +8 |
| 24 | 100NF 100nF | C_0603_1608Metric | C1, C2, C3, C6, C7, C8, C9, C10 +16 |
| 1 | 4.7UF 4.7uF | C_0603_1608Metric | C4 |
| 3 | 1UF 1uF | C_0603_1608Metric | C5, C25, C26 |
| 1 | 10UF 10uF | C_0805_2012Metric | C27 |
| 2 | 5.1K 5.1k | R_0603_1608Metric | R1, R2 |
| 1 | 10K 10k | R_0603_1608Metric | R3 |
| 2 | 4.7K 4.7k | R_0603_1608Metric | R4, R5 |
| 12 | 100 | R_0603_1608Metric | R6, R7, R8, R9, R10, R11, R12, R13 +4 |
Keeb4x4 design files
The KiCad project lives in the TheRealBluesun/keeb4x4 repository on GitHub; these links point at the commit this page was built from.
- Layoutkeeb4x4.kicad_pcb
- Schematickeeb4x4.kicad_sch
- BOMfab/keeb4x4_bom.csv
Keeb4x4: common questions
What microcontroller does the Keeb4x4 use?
The Keeb4x4 is built around the STM32G431CBT6, from the STM32 family.
How big is the Keeb4x4 PCB?
The Keeb4x4 measures 100 × 142.5 mm, has 4 copper layers and is 1.6 mm thick.
How many components are on the Keeb4x4?
119 components, from 36 distinct parts, with part numbers taken from the project's own BOM. The full bill of materials is listed on this page.
Where can I download the Keeb4x4 design files?
From the TheRealBluesun/keeb4x4 repository on GitHub, which has the KiCad layout, the schematic and the BOM; the links under Design files point to each one.
Can I use the Keeb4x4 design in my own project?
Yes, under the terms of its CERN-OHL-P-2.0 license, which TheRealBluesun chose for the repository.
Can I test firmware for the Keeb4x4 without the hardware?
Yes. HardLabs builds a simulation of the board from its netlist and BOM, so you can run and debug STM32 firmware against it before you order a PCB.
Similar boards
STM32
LumenPnP Motherboard
opulo-inc
149 × 95 mm296 parts4LCC-BY-SA-4.03.7kSTM32
Type g
google
169 × 30 mm24 parts2LApache-2.02.9kSTM32
Type a
google
150 × 30 mm14 parts2LApache-2.02.9kSTM32
Base
google
52.3 × 52.3 mm36 parts2LApache-2.02.9kSTM32
Main panel
google
234 × 84 mm26 parts4LApache-2.02.9kSTM32
Type c
google
188 × 30 mm17 parts2LApache-2.02.9k