A custom macropad designed as a submission for the 2025 Summer of Code by GitHub. Based on the AOI3 PCB tutorial with modifications for practical use.
- 15 Programmable Keys
- XIAO RP2040 Microcontroller
- Highly Customizable
- Easy Dissassembly
For some reason Fusion 360 was bugging out while rendering the colors so enjoy the light mode experience
I engineered the top so that it slots in without any screws, making it easily detachable, I made sure that theres a tight tolerance so that it doesn't fall apart when you pick it up. There are 15 Keys that you can customize in the firmware.
Fusion 360 Renderer thingy, everything stacks (Couldn't find a proper stl for the switches and springs but those go under the top case)
Default view, only two outer pieces, cool!
I used KiCad to create the PCB assembly, used their built-in image converter to add the graphic.
I utilized the QMK firmware to handle key inputs. Use the USB C port to flash the .bin file to change layout (Better editor coming soon™)
A key changing tool like AutoHotKey is recommended, if you would like to change the keybinds yourself you can use QMK Configurator
This is the current key layout (DDR Reference), F13 through F24 are configured so that it doesn't interfere with any users' existing setup.
| Item | Quantity / Notes |
|---|---|
| Cherry MX Switches | 15 |
| DSA Keycaps | 15 |
| XIAO RP2040-DIP | 1 |
| SK6812MINI LEDs | 2 |
| Soldering Iron | 1 |
| Case | 1 (3D Printed or Laser Cut – laser cut preferred) |
| Generic Diodes (SMD D_SOD-123) | 15 |
| Assembly Time | Approx. 2 hours 30 minutes |
- PCB Design & Layout: KiCAD
- 3D Modeling: Fusion 360
- AI03 Wiki – General information and guides on PCB design
- Hack Club PCB Starter Guide – A beginner-friendly tutorial which this project is based on