Skip to the content
2 layers102.9 × 45.7 mmMacroboard, the printed circuit board in 3D

A custom 6-key keyboard with rotary encoder, 3D-printed case with integrated plate mounting, and VIA firmware.

Size
102.9 × 45.7 mm
Copper layers
2
Thickness
1.6 mm
Parts
35
Nets
31
Pads
176
Tracks, vias
169, 22
Pours
165
Routed
Yes
KiCad
KiCad 9.0 (file 20241229)
Created
5 May 2026
Updated
16 May 2026

Overview

Macroboard is an open-source printed circuit board by johnnyou1873, from the johnnyou1873/Workshops-Macropad repository on GitHub. It is a 2-layer board of 102.9 × 45.7 mm with 35 parts on 31 nets, routed with 169 tracks and 22 vias.

It is built around the BSS138. Its parts include 13 diodes, 6 capacitors, 2 resistors, 1 IC and 1 transistor. It belongs with the keyboards and input boards and the RP2040 boards of this library.

Main components

1

README

README.md

Workshops-Macropad

A custom 6-key keyboard with rotary encoder, 3D-printed case with integrated plate mounting, and VIA firmware.

Bill of Materials

Required

  • 1x Seeed Studio XIAO RP2040
  • 6x MX hotswap sockets
  • 7x 1N4148 small signal diodes
  • 1x EC11 rotary encoder with push button
  • 4x M3x12 screws (support M3x8 - M3x14) (or the 3D printable pegs/rivets)

Optional for RGB

  • 6x SK-6812 MINI-E reverse-mount RGB LEDs
  • 6x 100n 0805 decoupling capacitors
  • 2x 10k 0805 pull-up resistors
  • 1x BSS138 N-channel MOSFET

Optional for GPIO

  • 4x 2.54mm pitch male right-angle pin headers

Assembly Instructions (Basic)

  1. 3D print the top case, bottom case, and knob. If not using screws, print the pegs/rivets. For the best results, print the top case and bottom case with 100% infill.
  2. Solder the hotswap sockets and diodes, taking note of the polarity. These components belong on the side with the "mini macropad" text.
  3. Solder the microcontroller, using pin headers to align the pads but not soldering the pin headers.
  4. Solder the rotary encoder on the opposite side of the board as the rest of the components.
  5. Press and hold the BOOT button on the microcontroller. Then, while still holding the button, plug in the microcontroller to a computer. The microcontroller should appear as a virtual USB storage device.
  6. Upload the .uf2 firmware file to the microcontroller. The virtual USB storage device should disconnect once flashed.
  7. Unplug and replug the USB cable.
  8. Test that the keys work by inserting switches into the hotswap sockets and depressing them. The keys should type the numbers 1-6 by default.
  9. Test that the rotary encoder works by rotating it and pressing it. The encoder should control volume when rotated and type the number 7 when pressed.
  10. Unplug the USB cable.
  11. Insert the completed PCB into the bottom case, slotting in the USB conector first.
  12. Place the top case on top of the bottom case.
  13. Secure the bottom case to the top case with the M3x12 screws or the printable pegs/rivets.
  14. Insert the switches into the top case. The switches should securely slot into the hotswap sockets.
  15. Attach the keycaps and knob to the key switches and rotary encoder.
  16. Connect the USB cable.
  17. Open the VIA app.
  18. Go to the "Settings" tab and enable "Show Design tab".
  19. Go to the "Design" tab and upload the .json file.
  20. Go to the "Configure" tab. After authorizing the device, the macropad is now configurable!

Notes

On MacOS, plugging in the macropad for the first time after programming may trigger a message about keyboard layout. Because the macropad has a nonstandard layout, this message can be ignored. The keyboard should work with the configuration set with VIA.

RGB is implemented on the PCB but has not been tested.

To leverage the GPIO pins fully, custom firmware is needed.

Parts

35
QtyValueFootprintReferences
71N4148Library:D_DO-35_SOD27_P7.62mm_Horizontal_HybridD1, D2, D3, D4, D5, D6, D7
6100nCapacitor_SMD:C_0805_2012Metric_Pad1.18x1.45mm_HandSolderC1, C2, C3, C4, C5, C6
6MX_SK6812MINI-EPCM_marbastlib-mx:LED_MX_6028RLED1, LED2, LED3, LED4, LED5, LED6
6MX_SW_HSPCM_marbastlib-mx:SW_MX_HS_CPG151101S11_1uMX1, MX2, MX3, MX4, MX5, MX6
4MountingHole_M3MountingHole:MountingHole_3.2mm_M3_PadH1, H2, H3, H4
210kResistor_SMD:R_0805_2012Metric_Pad1.20x1.40mm_HandSolderR1, R2
1BSS138Package_TO_SOT_SMD:SOT-23_HandsolderingQ1
1PINHD_1x4_MaleConnector_PinHeader_2.54mm:PinHeader_1x04_P2.54mm_HorizontalJ1
1RotaryEncoder_Switch_MPPCM_marbastlib-various:ROT_Alps_EC11E-SwitchSW7
1Seeeduino Xiao rp2040PCM_marbastlib-xp-promicroish:Xiao_rp2040_ACHU1

Similar boards

  • 4 layers36 × 50.2 mmRacer, the printed circuit board in 3D

    Racer

    StuckAtPrototype/Racer

    These are structured into their own files. I could have used submodules, but decided against it.

    83 parts3.8kApache-2.0
  • 4 layers95 × 95 mmCube motherboard, the printed circuit board in 3D

    Cube motherboard

    willem-pennings/balancing-cube

    A cube that balances itself in a corner or edge using reaction wheels

    52 parts1.1kGPL-3.0
  • 2 layers54.6 × 70.9 mmBeagleLogic Cape, the printed circuit board in 3D

    BeagleLogic Cape

    abhishek-kakkar/BeagleLogic

    A Software Suite that implements a logic analyzer with the PRU on the BeagleBone / BeagleBone Black.

    22 parts479GPL-3.0
  • 2 layers44.2 × 29.3 mmI2c tiny usb, the printed circuit board in 3D

    I2c tiny usb

    harbaum/I2C-Tiny-USB

    Cheap and simple I²C to USB interface

    27 parts454
  • 2 layers21.6 × 52.3 mmPs2 pico hat, the printed circuit board in 3D

    Ps2 pico hat

    No0ne/ps2x2pico

    USB keyboard/mouse to PS/2 interface converter using a Raspberry Pi Pico

    17 parts399MIT
  • 2 layers45 × 45 mmAirCube, the printed circuit board in 3D

    AirCube

    StuckAtPrototype/AirCube

    Works standalone out of the box. Pairs with Home Assistant in minutes. Other platforms are supported through community-contributed extensions.

    61 parts379Apache-2.0
  • 4 layers74 × 104 mmBeepy, the printed circuit board in 3D

    Beepy

    sqfmi/beepy-hardware

    Beepy Hardware

    160 parts348MIT

Questions

How big is the Macroboard PCB?

It measures 102.9 × 45.7 mm and has 2 copper layers, 1.6 mm thick.

What parts does the Macroboard use?

35 parts, built around the BSS138. 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 Macroboard KiCad files?

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

Can I use the Macroboard design in my own project?

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