Skip to the content
2 layers148 × 64 mmMacro Pad 2 PCB, the printed circuit board in 3D

DIY custom macro keypad and Deej volume control board with RGB based on the Seeed Studio XIAO RP2040 and CircuitPython.

Size
148 × 64 mm
Copper layers
2
Thickness
1.6 mm
Parts
37
Nets
24
Pads
71
Tracks, vias
119, 15
Routed
Yes
KiCad
KiCad 7 (file 20221018)
Created
7 Jan 2023
Updated
26 Oct 2026

Overview

Macro Pad 2 PCB is an open-source printed circuit board by MichaelStickels, from the MichaelStickels/Macro_Pad_2.0 repository on GitHub, published under the GPL-3.0 licence. It is a 2-layer board of 148 × 64 mm with 37 parts on 24 nets, routed with 119 tracks and 15 vias.

It is built around the PTA4543-2015DPB103. Its parts include 10 connectors, 9 diodes, 7 resistors, 1 IC and 1 switch. It belongs with the keyboards and input and lEDs and displays boards of this library.

Main components

1

README

README.md

Macro Pad 2.0

DIY custom macro keypad and Deej volume control board with RGB based on the Seeed Studio XIAO RP2040 and CircuitPython.

Description

After really enjoying my first DIY macro keypad, I set out to create a second iteration of my own unique design that incorporated even more features. Mainly, I wanted to combine custom macro functionality with slide potentiometers for per-app volume control with Deej. This macro pad prioritizes looks rather than targeting the lowest cost or easiest assembly. The keyswitches are frame-mounted through the PCB so require hand wiring on the back, and the special side lit LED strip for the RGB is a bit spendy. But I am very happy with how it turned out, and it looks great on my desk.

Features

  • 9 fully programmable custom macro keys
  • 3 volume sliders for use with Deej
  • Fully customizable RGB and onboard button
  • Easily change settings with almost any text editor
  • USB C interface
  • Mechanical keyswitches
  • No driver needed
  • Open source

Built with

  • CircuitPython
  • Adafruit NeoPixel
  • Adafruit MatrixKeypad
  • Deej
  • Love

Photos

Some more photos of the project and the build process.

Building One Yourself

Here's what you'll need:
  1. Custom PCB from an online supplier
  2. 3D printed case
  3. All parts listed on the BOM below
  4. One USB-C cable
  5. Basic soldering tools

Custom PCB

PCB Gerber files are included in the release. Simply upload the whole .zip to the custom PCB manufacturer of your choice to order one for yourself (like JLPCB). This project only needs a very basic 2 layer PCB, I recommend white to show off the RGB. Make sure you choose the 'remove mark' or equivilent option to make sure they don't print an order number on the front fo your PCBs.

3D Printed Case

The case top uses translucent filament as a light pipe for the LEDs. At this revision, the design requires a multi-material printer. If you don't want to implement the RGB, you can print it all in one color on almost any printer. STL, 3MF, and F3D files are included for all parts.

Bill Of Materials

Here is a DigiKey cart with all electronic components ready to order.

QuantityItemDigiKey Link
1MacroPad PCB
1Seeed Studio XIAO RP20401597-102010428-ND
9Cherry MX Style KeyswitchesCH196-ND
9Keycaps1528-5662-ND
345mm 10k Slide PotentiometersPTA4553-2015CPB103-ND
16x6mm Tactile Push Button450-1650-ND
410kΩ ResistorsMFP-25BRD52-10K
91N4148 Diodes1N4148FS-ND
1Side Lit 5v RGB LED Strip1528-2499-ND
13D Printed Case
8M2.5 Screws
8M2.5 Heat-set Inserts
6M2 Screws (to mount pots)
Some small wire for hand soldering keyswitches

Assembly

Solder the RP2040, resistors, diodes, and button to the front of the board. 3D-printable bend guides are included to get clean consistent shapes on all the diodes and resistors.

Then install the keyswitches and pots, and flip it over to hand wire the back. The PCB features labeled pads on the back to connect the keyswitches, potentiometers, and RGB strip. Hand wiring these is a little tricky but results in a very clean look on the front.

Software

Once soldered up, install the CircuitPython bootloader onto the RP2040 using these instructions.

Then copy the entire contents of the firmware folder to the CIRCUITPYTHON drive. This includes the example configuration and the necessary external libraries.

Press the reset button or unplug and replug the RP2040 and your Macro Pad will be up and running!

For the volume sliders to work you will need to install and configure Deej using these instructions. My Deej config.yaml is included as an example.

Configure

The Macro Pad can be easily configured using any text editor, including Notepad.

To keep your file explorer tidy, the Macro Pad does not show up as a storage device by default. To access the drive, hold the 6x6mm pushbutton down while the board boots (either by pressing the reset button or while plugging in).

It will show up on your computer as a new storage drive named MACROPAD. To configure the Pad, edit conig.py in your favorite text editor. In config.py you can edit the macro for each of the 9 keyswitches as well as the RGB mode, color, and brightness. More detailed instructions are in the file.

Usage

WIP

Troubleshooting

WIP

Back matter

Acknowledgements

Inspiration from the following projects:

README adapted from TINY README

Huge shout-out to the Deej project, it's an awesome piece of software.

See also

To-do

  • Implement Deej serial sender in CircuitPython
  • Implement configuration file
  • Test and refine 3D printed enclosure
  • Implement configurable RGB
  • Implement push button to do... something?
  • Expand built-in RGB options
  • Revise case to work on single material printers
  • DIY dye sublimation keycaps
  • Create and publish Deej library for CircuitPython

License

This project is licensed under the GPL-3.0 License.

Support

Like what I do?
Buy Me A Coffee

Parts

37
QtyValueFootprintReferences
91N4148Diode_THT:D_DO-35_SOD27_P7.62mm_HorizontalD1, D2, D3, D4, D5, D6, D7, D8, D9
9MX-NoLEDSlide Potentiometer:Cherry CutoutMX1, MX2, MX3, MX4, MX5, MX6, MX7, MX8, MX9
9TestPointTestPoint:TestPoint_Pad_2.0x2.0mmJ2, J3, J4, J5, J6, J7, J8, J9, J10
410kResistor_THT:R_Axial_DIN0207_L6.3mm_D2.5mm_P10.16mm_HorizontalR1, R2, R3, R5
3PTA4543-2015DPB103Slide Potentiometer:Slide Pot CutoutR6, R7, R8
1Conn_02x06_Counter_ClockwiseConnector_PinHeader_2.54mm:PinHeader_2x06_P2.54mm_Vertical_SMDJ1
1MOUDLE-SEEEDUINO-XIAOSeeeduino XIAO KICAD:Seeeduino XIAO-MOUDLE14P-2.54-21X17.8MMU1
1SW_MEC_5Grandom-keyboard-parts:PushButton_6x6mm_TH_PrettySW1

More from MichaelStickels/Macro_Pad_2.0

2
  • 2 layers148 × 64 mmTop PCB, the printed circuit board in 3D

    Top PCB

    MichaelStickels/Macro_Pad_2.0

    DIY custom macro keypad and Deej volume control board with RGB based on the Seeed Studio XIAO RP2040 and CircuitPython.

    37 parts3GPL-3.0
  • 2 layers135 × 64 mmPCB Template, the printed circuit board in 3D

    PCB Template

    MichaelStickels/Macro_Pad_2.0

    DIY custom macro keypad and Deej volume control board with RGB based on the Seeed Studio XIAO RP2040 and CircuitPython.

    27 parts3GPL-3.0

Similar boards

  • 2 layers151.8 × 78.3 mmMinigeki, the printed circuit board in 3D

    Minigeki

    defvs/minigeki

    A portable implementation of an ONGEKI controller, with all necessary buttons, two macros, RGB LED support, USB-C.

    68 parts22GPL-3.0
  • 2 layers65 × 65 mmEsp butt, the printed circuit board in 3D

    Esp butt

    jsmnbom/esp-butt

    A physical controller for intimate devices. No phone. No app. Just knobs, sliders, and hundreds of compatible toys.

    18 parts1
  • 2 layers88 × 120 mmPocket synth, the printed circuit board in 3D

    Pocket synth

    ykstudio3695-boop/CHORDION

    オリジナルのポケットサイズシンセサイザーを開発するプロジェクト。

    95 parts1
  • 2 layers82 × 88.6 mmVSlideMPad, the printed circuit board in 3D

    VSlideMPad

    Arballio/VolumeSliderMacroPad

    15 partsMIT
  • 2 layers274.8 × 130.9 mmApex MUX, the printed circuit board in 3D

    Apex MUX

    ishantmahatopro/Apex-MUX

    A Blackmagic Design DaVinci Resolve Speed Editor with Slide Potentiometers, designed for budget video editors

    96 parts
  • 2 layers40 × 34 mmDD HIP9011, the printed circuit board in 3D

    DD HIP9011

    rusefi/rusefi

    rusefi - GPL internal combustion engine control unit

    37 parts1.2k
  • 2 layers53.9 × 23.2 mmAnalog, the printed circuit board in 3D

    Analog

    hoglet67/RGBtoHDMI

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

    37 parts1kGPL-3.0
  • 2 layers52 × 51.8 mmEsp32-homeassistant rf bridge, the printed circuit board in 3D

    Esp32-homeassistant rf bridge

    hackclub/OnBoard

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

    37 parts915

Questions

How big is the Macro Pad 2 PCB PCB?

It measures 148 × 64 mm and has 2 copper layers, 1.6 mm thick.

What parts does the Macro Pad 2 PCB use?

37 parts, built around the PTA4543-2015DPB103. 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 Macro Pad 2 PCB KiCad files?

From the MichaelStickels/Macro_Pad_2.0 repository on GitHub, at the commit this page was made from: the board is KiCad/MacroPad PCB/Macro Pad 2 PCB.kicad_pcb and its schematic KiCad/MacroPad PCB/Macro Pad 2 PCB.kicad_sch. PCBKit opens the board in the browser, with nothing to install.

Can I use the Macro Pad 2 PCB design in my own project?

Its repository publishes it under the GPL-3.0 licence: you may reuse it on that licence's terms (keep the author's notice, and for a copyleft licence share your changes alike).