Skip to the content
PCBKitNew board
2 layers80 × 84 mmMacropad v1, the printed circuit board in 3D

A 4-key macropad with a rotary encoder and OLED display, built around the Seeed XIAO RP2040.

Size
80 × 84 mm
Copper layers
2
Thickness
1.6 mm
Parts
7
Nets
14
Pads
45
Tracks, vias
82, 8
Routed
Yes
KiCad
KiCad 9.0 (file 20241229)
Created
20 Sep 2026
Updated
13 Oct 2026

Overview

Macropad v1 is an open-source printed circuit board by deshnaarun, from the deshnaarun/Macropad repository on GitHub, published under the MIT licence. It is a 2-layer board of 80 × 84 mm with 7 parts on 14 nets, routed with 82 tracks and 8 vias.

Its parts include 5 switches and 1 IC. It belongs with the keyboards and input boards of this library.

README

README.md

Macropad v1

A 4-key macropad with a rotary encoder and OLED display, built around the Seeed XIAO RP2040.

Features

  • 4 Cherry MX-style mechanical switches
  • Rotary encoder with push-button (volume up/down + mute by default)
  • 0.96" 128x64 SSD1306 OLED display showing a pixel-art cat that reacts to typing speed (sleeps when idle, walks at normal pace, runs when typed quickly)
  • Custom 3D-printed two-part case (base + lid)

Repo structure

  • cad/ — Complete assembled 3D model of the case + PCB (STEP)
  • pcb/ — KiCad schematic and PCB design source files
  • firmware/ — QMK firmware source (keymap, config, OLED animation)
  • production/ — Ready-to-manufacture/flash files: Gerbers, individual case part STEPs, and compiled firmware.uf2

Hardware

PartPin (XIAO D-label)GPIO
Switch 1D10GP3
Switch 2D9GP4
Switch 3D8GP2
Switch 4D3GP29
Encoder AD2GP28
Encoder BD6GP0
Encoder pushD7GP1
OLED SDAD4GP6
OLED SCLD5GP7

Firmware

Built with QMK. To flash: put the board in bootloader mode (double-tap reset on the XIAO) and drag production/firmware.uf2 onto the RPI-RP2 drive that appears.

License

MIT — see LICENSE.

Parts

7
QtyValueFootprintReferences
4SW_PushButton_Switch_Keyboard:SW_Cherry_MX_1.00u_PCBSW1, SW2, SW3, SW5
1MOUDLE-SEEEDUINO-XIAOfootprints:XIAO-Generic-Hybrid-14P-2.54-21X17.8MMU1
1RotaryEncoder_SwitchRotary_Encoder:RotaryEncoder_Alps_EC11E-Switch_Vertical_H20mmSW4
1SSD1306SSD1306:128x64OLEDBrd1

Questions

How big is the Macropad v1 PCB?

It measures 80 × 84 mm and has 2 copper layers, 1.6 mm thick.

What parts does the Macropad v1 use?

7 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 v1 KiCad files?

From the deshnaarun/Macropad repository on GitHub, at the commit this page was made from: the board is pcb/Macropad_v1.kicad_pcb and its schematic pcb/Macropad_v1.kicad_sch. PCBKit opens the board in the browser, with nothing to install.

Can I use the Macropad v1 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).

Similar boards

  • 2 layersEncoder, the printed circuit board in 3D

    Encoder

    byrantech/laptop

    anyon_e, a highly integrated, high end, open source laptop. Attempt the impossible.

    7 parts4.3kMIT
  • 2 layers40 × 20 mmSensor smd, the printed circuit board in 3D

    Sensor smd

    scottbez1/splitflap

    DIY split-flap display

    7 parts4.2k
  • 2 layers19.8 × 30 mmZ limit, the printed circuit board in 3D

    Z limit

    opulo-inc/lumenpnp

    The LumenPnP is an open source pick and place machine.

    7 parts3.7k
  • 2 layers35.6 × 58.2 mmDisplay Carrier, the printed circuit board in 3D

    Display Carrier

    AxxAxx/AxxSolder

    STM32 Based soldering station for JBC cartridges, 9-24 VDC and USB-PD power

    7 parts1.7kGPL-3.0
  • 2 layers20.3 × 16.3 mmMap MPX, the printed circuit board in 3D

    Map MPX

    rusefi/rusefi

    rusefi - GPL internal combustion engine control unit

    7 parts1.2k
  • 2 layers26 × 44 mmCompact carrier board, the printed circuit board in 3D

    Compact carrier board

    jamro/tiny-engineer

    A small desktop robot that brings an AI coding assistant to life, physically acting out when it reads files, thinks, writes code, and finishes work.

    7 parts1.1k
  • 2 layers26.4 × 53.8 mmAtari pickup, the printed circuit board in 3D

    Atari pickup

    hoglet67/RGBtoHDMI

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

    7 parts1kGPL-3.0
  • 2 layersRj45 breakout, the printed circuit board in 3D

    Rj45 breakout

    rene-dev/stmbl

    AC Servo Driver for STM32F4

    7 parts990GPL-3.0