Skip to the content
2 layers57.1 × 68.2 mmHackpad-2.0, the printed circuit board in 3D

New and improved macropad with 6 switches, 1 rotary encoder and a 0.91 inch oled screen

Size
57.1 × 68.2 mm
Copper layers
2
Thickness
1.6 mm
Parts
20
Nets
25
Pads
85
Tracks, vias
169, 14
Routed
Yes
KiCad
KiCad 9.0 (file 20241229)
Created
17 Apr 2026
Updated
18 Apr 2026

Overview

Hackpad-2.0 is an open-source printed circuit board by NoelGjonej, from the NoelGjonej/Hackpad-2.0 repository on GitHub. It is a 2-layer board of 57.1 × 68.2 mm with 20 parts on 25 nets, routed with 169 tracks and 14 vias.

It is built around the SK6812. Its parts include 11 diodes, 7 switches, 1 IC and 1 connector. It belongs with the keyboards and input boards of this library.

Main components

1

README

README.md

PCB Design

image

Case Design

image

XIAO Macropad — KMK Firmware

Seeeduino XIAO · 6 Keys · EC11E Rotary Encoder · SSD1306 128x32 OLED


Why KMK instead of QMK?

KMK runs on CircuitPython — there is no compiling, no toolchain, no flashing. You just copy files onto the XIAO like a USB drive. Much easier for the XIAO.


Key Layout

text
[ PREV  ] [ PLAY  ] [ NEXT  ]
[ COPY  ] [ PASTE ] [ SNIP  ]
                              Encoder CW  → Volume Up
                              Encoder CCW → Volume Down
                              Encoder Click → Mute / Unmute
KeyAction
Top-left⏮ Previous Track
Top-mid▶ Play / Pause
Top-right⏭ Next Track
Bot-leftCtrl+C — Copy
Bot-midCtrl+V — Paste
Bot-rightWin+Shift+S — Snipping Tool
Encoder CW🔊 Volume Up
Encoder CCW🔉 Volume Down
Encoder click🔇 Mute / Unmute toggle

Wiring

Key Matrix (2 rows × 3 cols, COL2ROW diodes)

text
         COL0(D0)   COL1(D1)   COL2(D2)
ROW0(D3)   PREV       PLAY       NEXT
ROW1(D4)   COPY       PASTE      SNIP

Add a 1N4148 diode per switch — cathode (black band) toward the ROW pin.

EC11E Encoder

EC11E pinXIAO pinFunction
CLK (A)D7Rotation A
DT (B)D8Rotation B
SWD6Click = Mute
GNDGNDGround

Add 10kΩ pull-up resistors on CLK and DT to 3.3V if you get jitter.

SSD1306 OLED (I2C, 128×32)

OLED pinXIAO pin
SDAD9 (SDA)
SCLD10 (SCL)
VCC3.3V
GNDGND

Default I2C address is 0x3C. If your OLED doesn't appear, try 0x3D in code.py.


Setup Instructions

Step 1 — Install CircuitPython on the XIAO

  1. Download the CircuitPython UF2 for Seeeduino XIAO from: https://circuitpython.org/board/seeeduino_xiao/ (download the latest stable .uf2 file)

  2. Double-tap the RST pin on the XIAO — a drive called XIAO-BOOT appears on your PC.

  3. Drag and drop the .uf2 file onto that drive. The XIAO reboots and a new drive called CIRCUITPY appears.

Step 2 — Install CircuitPython libraries

Download the CircuitPython Library Bundle from: https://circuitpython.org/libraries

Unzip it. From the lib/ folder inside, copy these folders/files into the lib/ folder on your CIRCUITPY drive:

text
adafruit_displayio_ssd1306.mpy
adafruit_display_text/
adafruit_imageload/
kmk/                          ← get this from https://github.com/KMKfw/kmk_firmware

To get KMK, download the zip from https://github.com/KMKfw/kmk_firmware and copy the kmk/ folder onto CIRCUITPY/lib/.

Step 3 — Copy your code

Copy these two files from this folder onto the root of CIRCUITPY:

text
boot.py   → CIRCUITPY/boot.py
code.py   → CIRCUITPY/code.py

Your CIRCUITPY drive should look like:

text
CIRCUITPY/
├── boot.py
├── code.py
└── lib/
    ├── kmk/
    ├── adafruit_displayio_ssd1306.mpy
    ├── adafruit_display_text/
    └── adafruit_imageload/

Step 4 — Done

The XIAO reboots automatically when you save files. Your macropad is ready. No compiling, no flashing tools needed.


Making changes

To change a key, open code.py in any text editor, edit the keyboard.keymap list, and save. The XIAO reboots and picks up the change in a few seconds.

Common keycodes:

python
KC.LCTL(KC.Z)     # Ctrl+Z  (undo)
KC.LCTL(KC.S)     # Ctrl+S  (save)
KC.LGUI(KC.L)     # Win+L   (lock screen)
KC.PSCR           # Print Screen
KC.TAB, KC.ESC, KC.ENT, KC.BSPC
KC.F1 ... KC.F12

Troubleshooting

ProblemFix
CIRCUITPY drive doesn't appearDouble-tap RST faster (within ~500ms)
Keys not workingCheck diode direction — cathode (black band) toward row pin
Encoder jitteryAdd 10kΩ pull-ups on CLK and DT to 3.3V
OLED blankCheck SDA/SCL wiring; try changing 0x3C to 0x3D in code.py
Error on bootConnect to XIAO via serial (PuTTY / Thonny) to read the error message

Reading error messages (very useful for debugging)

Install Thonny (free Python IDE): https://thonny.org Connect to the XIAO's serial port — it shows any Python errors live, which makes debugging very easy.


Parts

20
QtyValueFootprintReferences
7DDiode_THT:D_DO-35_SOD27_P7.62mm_HorizontalD1, D2, D3, D4, D5, D6, D7
6SW_PushButton_Switch_Keyboard:SW_Cherry_MX_1.00u_PCBSW1, SW2, SW3, SW4, SW5, SW6
4SK6812LED_SMD:LED_SK6812_PLCC4_5.0x5.0mm_P3.2mmD8, D9, D10, D11
1Conn_01x04_PinConnector_PinSocket_2.54mm:PinSocket_1x04_P2.54mm_VerticalJ1
1MOUDLE-SEEEDUINO-XIAOfootprints:XIAO-Generic-Hybrid-14P-2.54-21X17.8MMU1
1RotaryEncoder_SwitchRotary_Encoder:RotaryEncoder_Alps_EC11E-Switch_Vertical_H20mmSW14

Similar boards

  • 2 layers299 × 82.5 mmPixelWave, the printed circuit board in 3D

    PixelWave

    hackclub/OnBoard

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

    663 parts915
  • 4 layers95 × 95 mmOpenmicro, the printed circuit board in 3D

    Openmicro

    conol-ai/openmicrokbd

    Open-source recreation of OpenAI's Codex Micro macropad — PCB written in CoHDL, an AI-native hardware description language. Rust firmware (embassy) + companion app (makepad). MIT licensed. https://openmicrokbd.org

    88 parts154MIT
  • 2 layers312.5 × 122.3 mmSHEGO75-V5, the printed circuit board in 3D

    SHEGO75-V5

    Charading/Shego75HE

    My endgame 75% hall effect keyboard

    392 parts75
  • 2 layers140.1 × 121.8 mmTH LEDS, the printed circuit board in 3D

    TH LEDS

    DraftShift/Tophat

    StealthChanger now has an official website!

    89 parts64GPL-3.0
  • 2 layers187.9 × 127.2 mmDya panelized, the printed circuit board in 3D

    Dya panelized

    cormoran/dya-dash-keyboard

    DYA Dash portable wireless split keyboard with 25mm trackball

    269 parts57CC-BY-4.0
  • 2 layers145 × 145 mmNeofighter, the printed circuit board in 3D

    Neofighter

    w4ilun/neofighter

    A MIDI controller using arcade buttons with RGB lighting effects

    111 parts51
  • 2 layers176 × 189.6 mm8x8, the printed circuit board in 3D

    8x8

    miliar/saiboard

    An open-source, wooden electronic Go board that integrates with KataGo.

    222 parts48GPL-3.0
  • 6 layers128 × 128 mmEmberone, the printed circuit board in 3D

    Emberone

    256foundation/emberone00-pcb

    KiCAD design files for the emberOne/00 hashboard

    395 parts45CERN-OHL-S-2.0

Questions

How big is the Hackpad-2.0 PCB?

It measures 57.1 × 68.2 mm and has 2 copper layers, 1.6 mm thick.

What parts does the Hackpad-2.0 use?

20 parts, built around the SK6812. 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 Hackpad-2.0 KiCad files?

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

Can I use the Hackpad-2.0 design in my own project?

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