4 layers99 × 53.3 mm
PSLab
fossasia/pslab-hardware
PSLab Hardware Design and Schematics https://pslab.io
199 parts1.7kApache-2.0
2 layers68.5 × 88.5 mm
HackPad1
jeshu-collab/HackPadHackPad1 is a custom 9-key macropad built using the Seeed XIAO RP2040. It includes a rotary encoder, a 128x32 OLED display, and per-key RGB lighting.
- Size
- 68.5 × 88.5 mm
- Copper layers
- 2
- Thickness
- 1.6 mm
- Parts
- 26
- Nets
- 27
- Pads
- 104
- Tracks, vias
- 215, 7
- Pours
- 1
- Routed
- Yes
- KiCad
- KiCad 8.0 (file 20240108)
- Created
- 28 Jun 2026
- Updated
- 19 Jul 2026
Overview
HackPad1 is an open-source printed circuit board by jeshu-collab, from the jeshu-collab/HackPad repository on GitHub. It is a 2-layer board of 68.5 × 88.5 mm with 26 parts on 27 nets, routed with 215 tracks and 7 vias.
It is built around the WS2812B. Its parts include 13 diodes, 10 switches, 1 IC and 1 connector. It belongs with the lEDs and displays boards of this library.
Main components
1README
README.mdHackPad1
HackPad1 is a custom 9-key macropad built using the Seeed XIAO RP2040. It includes a rotary encoder, a 128x32 OLED display, and per-key RGB lighting. The firmware is written using KMK, making it easy to customize key mappings and add new features.
This project was designed from scratch, including the PCB, enclosure, and firmware.
Features
- 9-key mechanical macropad (3x3 layout)
- EC11 rotary encoder for volume control
- 128x32 OLED display
- Per-key RGB using SK6812MINI-E LEDs
- Powered by Seeed XIAO RP2040
- KMK firmware for easy customization
- Custom 2-piece 3D printed enclosure
CAD Model
The enclosure is designed as a two-piece case.
- Top Shell: Holds the switches and has the outer frame.
- Bottom Plate: Closes the enclosure and supports the PCB.
Overall View
Case Assembly
PCB
The PCB was designed in KiCad. It includes the switch matrix, rotary encoder, OLED display connections, RGB LEDs, and the XIAO RP2040.
Schematic
PCB Layout
Firmware
The firmware is based on KMK.
Current functionality:
- Rotary encoder controls system volume.
- Pressing the encoder mutes/unmutes the audio.
- The 9 keys are currently mapped as number keys (1–9).
- OLED displays a startup message.
Key mappings can be easily changed by editing main.py.
Bill of Materials (BOM)
| Component | Quantity |
|---|---|
| Cherry MX Switches | 9 |
| Keycaps | 9 |
| 1N4148 Diodes | 9 |
| SK6812MINI-E RGB LEDs | 9 |
| 0.91" 128x32 OLED Display | 1 |
| EC11 Rotary Encoder | 1 |
| Seeed XIAO RP2040 | 1 |
| 3D Printed Enclosure | 1 Set |
| M3 Screws (update after final assembly) | As Required |
Future Improvements
- Add multiple layers and shortcuts
- OLED status indicators
- RGB lighting effects
- VIA/Vial-style configuration (if supported)
- Improve case design after testing the first prototype
Acknowledgements
This project was built as part of the Hack Club HackPad initiative.
Special thanks to the Hack Club community for the resources and guidance throughout the build.
Parts
26| Qty | Value | Footprint | References |
|---|---|---|---|
| 9 | SW_Push | Button_Switch_Keyboard:SW_Cherry_MX_1.00u_PCB | SW1, SW2, SW3, SW4, SW5, SW6, SW7, SW8, SW9 |
| 6 | D | Diode_THT:D_DO-35_SOD27_P10.16mm_Horizontal | D4, D5, D6, D7, D8, D9 |
| 4 | WS2812B | Keyboard_Parts:MX_SK6812MINI-E | D10, D11, D12, D13 |
| 3 | D | Diode_THT:D_DO-35_SOD27_P7.62mm_Horizontal | D1, D2, D3 |
| 1 | clipboard:f94af434-1fa3-4cc6-adfb-df3f992dc55a | ||
| 1 | Conn_01x04_Pin | Connector_PinSocket_2.54mm:PinSocket_1x04_P2.54mm_Vertical | J1 |
| 1 | MOUDLE-SEEEDUINO-XIAO | footprints:XIAO-Generic-Hybrid-14P-2.54-21X17.8MM | U1 |
| 1 | RotaryEncoder | Rotary_Encoder:RotaryEncoder_Alps_EC11E-Switch_Vertical_H20mm | SW10 |
Questions
How big is the HackPad1 PCB?
It measures 68.5 × 88.5 mm and has 2 copper layers, 1.6 mm thick.
What parts does the HackPad1 use?
26 parts, built around the WS2812B. 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 HackPad1 KiCad files?
From the jeshu-collab/HackPad repository on GitHub, at the commit this page was made from: the board is PCB/HackPad1.kicad_pcb and its schematic PCB/HackPad1.kicad_sch. PCBKit opens the board in the browser, with nothing to install.
Can I use the HackPad1 design in my own project?
Its repository states no licence, so its author keeps all rights: ask jeshu-collab before reusing the design.
Similar boards
- 2 layers26 × 30 mm
Microcontroller
FrameworkComputer/ExpansionCards
Reference designs and documentation to create Expansion Cards for the Framework Laptop
34 parts1.1kCC-BY-4.0 - 4 layers82.6 × 82.5 mm
- 2 layers95.3 × 161.9 mm
- 2 layers42.8 × 28.8 mm
MM Skirt
PrintersForAnts/Micron
If you want to purchase full kits there are 3 available (Kits are slowly updating to R1 hardware just make sure to double check the included hardware in your kit and if you have any questions reach out in the discord)
11 parts741GPL-3.0 - 2 layers149.6 × 127.1 mm
- 2 layers285.5 × 95 mm
- 2 layers177.7 × 144.5 mm
