Macro keypad

johnppilli·macro-keypad·hardware/macro-keypad.kicad_pcb

About the Macro keypad PCB

Macro keypad is an open source RP2040/RP2350 PCB design by johnppilli, published on GitHub. It is a 2-layer board measuring 80 × 90 mm, with 66 components from 18 distinct parts.

Its main chip is the RP2040, from the RP2040/RP2350 family. Other key parts include the W25Q16JVSS and AP2112K-3.3. By type, the board carries 27 capacitors, 18 diodes, 12 switches, 3 ICs, 3 resistors and 2 connectors.

It belongs with the keyboards designs in this gallery.

From the project

Custom USB-C mechanical macro keypad - KiCad PCB design around an RP2040

A 3×3 hot-swap USB-C macro keypad built around an RP2040, with per-key RGB and a rotary encoder. Designed in KiCad from schematic through fabrication.

Bare 2-layer board from JLCPCB, before assembly.

- RP2040 (QFN-56) with a 12 MHz crystal and a W25Q16JV 2 MB QSPI flash - USB-C receptacle for power and data, with 5.1 kΩ CC pulldowns - AP2112K-3.3 LDO dropping USB 5 V to the 3.3 V rail - 3×3 key matrix on Kailh MX hot-swap sockets, one SOD-123 diode per key so simultaneous presses don't ghost - 9× WS2812B addressable RGB, daisy-chained as one data line for per-key backlight - EC11 rotary…

Macro keypad, from the project README — From the project README

Main components on the Macro keypad

RP2040 W25Q16JVSS AP2112K-3.3

Macro keypad bill of materials (BOM)

66 components, 18 distinct parts — part numbers from the project's BOM.

Qty	Part	Footprint	Refs
1	RP2040	QFN-56-1EP_7x7mm_P0.4mm_EP3.2x3.2mm	U1
1	W25Q16JVSS	SOIC-8_5.3x5.3mm_P1.27mm	U2
1	AP2112K-3.3	SOT-23-5	U3
1	CRYSTAL_GND24 Crystal_GND24	Crystal_SMD_3225-4Pin_3.2x2.5mm	Y1
1	USB_C_RECEPTACLE_USB2.0_14P USB_C_Receptacle_USB2.0_14P	USB_C_Receptacle_GCT_USB4085	J1
1	CONN_01X04 Conn_01x04	PinHeader_1x04_P2.54mm_Vertical	J2
2	SW_Push	SW_PUSH_6mm	SW1, SW2
9	SW_Push	Kailh_socket_MX_optional	SW3, SW4, SW5, SW6, SW7, SW8, SW9, SW10 +1
1	RotaryEncoder_Switch	RotaryEncoder_Alps_EC11E-Switch_Vertical_H20mm	SW12
9	D	D_SOD-123	D1, D2, D3, D4, D5, D6, D7, D8 +1
9	WS2812B	LED_SK6812MINI_PLCC4_3.5x3.5mm_P1.75mm	D10, D11, D12, D13, D14, D15, D16, D17 +1
2	10UF 10uF	C_0603_1608Metric	C1, C2
19	100NF 100nF	C_0603_1608Metric	C3, C4, C5, C6, C8, C9, C10, C11 +11
1	1UF 1uF	C_0603_1608Metric	C7
2	15PF 15pF	C_0603_1608Metric	C13, C14
3	10NF 10nF	C_0603_1608Metric	C16, C17, C18
2	5.1K 5.1k	R_0603_1608Metric	R1, R2
1	1k	R_0603_1608Metric	R3

Macro keypad design files

The KiCad project lives in the johnppilli/macro-keypad repository on GitHub; these links point at the commit this page was built from.

Layouthardware/macro-keypad.kicad_pcb
Schematichardware/macro-keypad.kicad_sch
BOMdocs/bom.csv

Macro keypad: common questions

What microcontroller does the Macro keypad use?

The Macro keypad is built around the RP2040, from the RP2040/RP2350 family.

How big is the Macro keypad PCB?

The Macro keypad measures 80 × 90 mm, has 2 copper layers and is 1.6 mm thick.

How many components are on the Macro keypad?

66 components, from 18 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 Macro keypad design files?

From the johnppilli/macro-keypad 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 Macro keypad design in my own project?

The repository has no license, so all rights stay with johnppilli. Use it as a reference, and ask the author before reusing the design.

Can I test firmware for the Macro keypad without the hardware?

Yes. HardLabs builds a simulation of the board from its netlist and BOM, so you can run and debug RP2040/RP2350 firmware against it before you order a PCB.