

Macroboard
DIY Macro keyboard with pedal support based on Arduino Micro
- Size
- 89 × 99 mm
- Copper layers
- 2
- Thickness
- 1.6 mm
- Parts
- 88
- Nets
- 39
- Pads
- 239
- Tracks, vias
- 321, 35
- Pours
- 2
- Routed
- Yes
- KiCad
- KiCad 9.0 (file 20241229)
- Created
- 18 May 2025
- Updated
- 19 May 2025
Overview
Macroboard is an open-source printed circuit board by lufixSch, from the lufixSch/macroboard repository on GitHub, published under the GPL-3.0 licence. It is a 2-layer board of 89 × 99 mm with 88 parts on 39 nets, routed with 321 tracks and 35 vias.
It is built around the ATMEGA32U4-AU. Its parts include 32 resistors, 16 capacitors, 16 switches and 1 IC. It belongs with the keyboards and input and audio and music boards and the AVR (ATmega, ATtiny) boards of this library.
Main components
1README
README.mdMacroboard
DIY Macro keyboard with pedal support based on Arduino Micro.
This project contains the build files and firmware for an plug and play macro keyboard. It doesn't require any third party software on your PC instead it makes use of the F13 - F24 keys which are usually unused. The (optional) mode switch allows a secondary layer of macro keys (F1 - F12). In addition the board has a port for a sustain pedal from a E-Piano with automatic polarity detection. The design includes a separate mode switch for the pedal as well as a manual polarity switch to allow more exceptional use cases like push to mute in games where only push to talk is supported.
Circuit
Contains the PCB design for the board based around an Arduino Micro development board.
Not all switches/keys need to be populated. You can omit Special Key, Mode Switch and Special Switch 1/2 based on your needs and disable the corresponding features in the firmware.
Firmware
Contains the Arduino sketch which should be flashed onto the Arduino Micro. The firmware relies on the Arduino Keyboard library and can be configured using macros in the settings.h.
Case
Contains the FreeCAD as well as STL files for a simple printable enclosure for the Macroboard.
Parts
88| Qty | Value | Footprint | References |
|---|---|---|---|
| 16 | 10k | Resistor_SMD:R_0805_2012Metric_Pad1.20x1.40mm_HandSolder | R1, R2, R4, R6, R17, R18, R20, R22, R24, R26, R28, R30, R32, R34, R36, R38 |
| 16 | 10u | Capacitor_SMD:C_0805_2012Metric_Pad1.18x1.45mm_HandSolder | C1, C2, C3, C4, C5, C6, C7, C8, C9, C10, C11, C12, C13, C14, C15, C16 |
| 16 | 1k | Resistor_SMD:R_0805_2012Metric_Pad1.20x1.40mm_HandSolder | R3, R5, R7, R16, R19, R21, R23, R25, R27, R29, R31, R33, R35, R37, R39, RC1 |
| 16 | Jumper_2_Open | Jumper:SolderJumper-2_P1.3mm_Open_RoundedPad1.0x1.5mm | JP1, JP2, JP3, JP4, JP5, JP6, JP7, JP8, JP9, JP10, JP11, JP12, JP13, JP14, JP15, JP16 |
| 13 | CherryMX | CherryMX_KailhSocket:CherryMX_1.00u_KailhSocket | SW1, SW2, SW3, SW4, SW5, SW6, SW7, SW8, SW9, SW10, SW11, SW12, SW14 |
| 6 | MountingHole | MountingHole:MountingHole_2.1mm | H1, H2, H3, H4, H5, H6 |
| 2 | SW_SPDT | Button_Switch_THT:SW_Slide_SPDT_Angled_CK_OS102011MA1Q | SW15, SW16 |
| 1 | ATmega32U4-A | custom:Arduino Pro Micro | U1 |
| 1 | SW_Push | custom:AUX Jack 6.3mm External | SW13 |
| 1 | SW_Push | Button_Switch_THT:SW_PUSH_6mm | RESET1 |
Questions
How big is the Macroboard PCB?
It measures 89 × 99 mm and has 2 copper layers, 1.6 mm thick.
What parts does the Macroboard use?
88 parts, built around the ATMEGA32U4-AU. 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 lufixSch/macroboard repository on GitHub, at the commit this page was made from: the board is circuit/macroboard.kicad_pcb and its schematic circuit/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 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).
Similar boards
- 2 layers243.2 × 106 mm

- 2 layers228.4 × 85 mm

LeChiffre
tominabox1/Le-Chiffre-Keyboard
Great thanks goes to Jake at P3D for really making the case amazing and open sourcing his work. Check him out at P3Dstore.com
105 parts183GPL-3.0 - 2 layers228.6 × 76.8 mm

Schwann Rev0.5b
The-Royal/The_Royal_Open-Source-Projects
A Master Repository For All things Royal Made
127 parts159MIT - 2 layers30 × 65 mm

Keyboard mcu
dpapavas/lagrange-keyboard
A configurable, handwired, ergonomic keyboard
26 parts137AGPL-3.0 - 2 layers88.4 × 80 mm

LHS Controller PCB
dmcke5/ZenDeck
This is the second revision of my Mini PC based handheld Gaming PC! It is designed for a Beelink SER 5 Mini PC but could be adapted to other systems by changing the mounting brackets and outlet plate.
76 parts133CERN-OHL-S-2.0 - 2 layers259.5 × 89.1 mm

- 2 layers99.1 × 99.1 mm

Power supply panelized
thebiguno/microcontroller-projects
A home for a bunch of microcontroller projects which don't warrant their own repos.
223 parts75 - 2 layers323.9 × 95.1 mm

UnSplit
swiftrax/UnSplit
Ergo 40% mechanical keyboard with all components on the top with diodes arranged in an array
110 parts68GPL-2.0