Skip to the content
2 layersMacropad, the printed circuit board in 3D

A custom-built, programmable 16-key mechanical macropad powered by an RP2040 microcontroller. Designed to streamline custom PC building operations by automating hardware-level system-testing workflows, replacing…

Copper layers
2
Thickness
1.6 mm
Parts
33
Nets
47
Pads
152
Tracks, vias
140, 0
Routed
Yes
KiCad
KiCad 10.0 (file 20260206)
Created
21 Sep 2026
Updated
21 Sep 2026

Overview

Macropad is an open-source printed circuit board by elijahbaez, from the elijahbaez/16-key-macropad repository on GitHub. It is a 2-layer board with 33 parts on 47 nets, routed with 140 tracks and 0 vias.

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

README

README.md

⌨️ Custom 16-Key Mechanical Macropad

C++ QMK KiCad RP2040

A custom-built, programmable 16-key mechanical macropad powered by an RP2040 microcontroller. Designed to streamline custom PC building operations by automating hardware-level system-testing workflows, replacing repetitive manual data entry with a dedicated hardware interface.

KiCad PCB Routing Design

✨ Features

  • Anti-Ghosting Matrix: Features a custom 4x4 switch matrix with a 1N4148 diode array to completely eliminate key ghosting.
  • Isolated 2-Layer Routing: Routed using 2-layer traces in KiCad, deliberately isolating horizontal rows on the bottom copper layer (blue) and vertical columns on the top copper layer (red) for optimal signal integrity.
  • Hardware Automation: Programmed with 3 dedicated macro layers in C++ utilizing QMK's process_record_user state machine.
  • Workflow Integration: Automates redundant PC system-testing workflows (launching hardware telemetry/sensors, automated network ping tests, and instant task manager overrides).

🗂️ Project Structure & Configuration

Repository Layout

  • /macropad — Contains the KiCad hardware schematic, PCB layout (.kicad_pcb), and footprint files.
  • /firmware — Contains the C++ QMK environment, hardware configurations (info.json), and the macro logic (keymap.c).

C++ Macro Implementation

C++ Firmware Logic


📋 Technical Notes on QMK Implementation

The macropad utilizes a COL2ROW diode direction configuration mapped directly to the RP2040's GPIO pins. The macro implementation leverages QMK's SEND_STRING functionality combined with SS_DELAY to account for OS-level execution latency when automating command-prompt-based benchmarking tools.

The hardware matrix prevents electrical shorts by keeping column/row polling strictly on independent planes (Front Copper and Back Copper).

Parts

33
QtyValueFootprintReferences
16DDiode_THT:D_DO-35_SOD27_P7.62mm_HorizontalD1, D2, D3, D4, D5, D6, D7, D8, D9, D10, D11, D12, D13, D14, D15, D16
16SW_PushButton_Switch_Keyboard:SW_Cherry_MX_1.00u_PCBSW1, SW2, SW3, SW4, SW5, SW6, SW7, SW8, SW9, SW10, SW11, SW12, SW13, SW14, SW15, SW16
1RaspberryPi_PicoModule:RaspberryPi_Pico_Common_THTA1

Similar boards

  • 2 layers65 × 30 mmRgb to hdmi, the printed circuit board in 3D

    Rgb to hdmi

    hoglet67/RGBtoHDMI

    Bare-metal Raspberry Pi project that provides pixel-perfect sampling of Retro Computer RGB/YUV video and conversion to HDMI

    33 parts1kGPL-3.0
  • 2 layers127 × 96 mmAmiga gfxcard, the printed circuit board in 3D

    Amiga gfxcard

    mntmn/amiga2000-gfxcard

    MNT VA2000, an Open Source Amiga 2/3/4000 Graphics Card (Zorro II/III), written in Verilog

    33 parts1k
  • 2 layers92.7 × 58.4 mmHacky holidays, the printed circuit board in 3D

    Hacky holidays

    hackclub/OnBoard

    💡 Join 1,000 teenagers and make your first PCB with a $100 grant!

    33 parts915
  • 2 layers240 × 120 mmQuiver PDB 01, the printed circuit board in 3D

    Quiver PDB 01

    Arrow-air/project-quiver

    Project Quiver documentation, designs, and project artifacts.

    33 parts617CERN-OHL-S-2.0
  • 2 layers75 × 26 mmDIY detector, the printed circuit board in 3D

    DIY detector

    ozel/DIY_particle_detector

    A mobile low-cost spectrometer for measuring radioactivity and the energy of ionising radiation like alpha particles and electrons

    33 parts558BSD-2-Clause
  • 2 layers100 × 50 mmPixelix, the printed circuit board in 3D

    Pixelix

    BlueAndi/Pixelix

    Full RGB LED matrix, based on an ESP32 and WS2812B LEDs or emulated LEDs on TFT.

    33 parts447MIT
  • 2 layers65 × 30 mmCanHat, the printed circuit board in 3D

    CanHat

    bondus/KlipperToolboard

    A 3D printer tool head controller board

    33 parts373GPL-3.0

Questions

What parts does the Macropad use?

33 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 Macropad KiCad files?

From the elijahbaez/16-key-macropad repository on GitHub, at the commit this page was made from: the board is macropad/macropad.kicad_pcb and its schematic macropad/macropad.kicad_sch. PCBKit opens the board in the browser, with nothing to install.

Can I use the Macropad design in my own project?

Its repository states no licence, so its author keeps all rights: ask elijahbaez before reusing the design.