Skip to the content
2 layers85.7 × 114.3 mmMacropadMK, the printed circuit board in 3D

MacropadMK is a 12-key macropad built around the Waveshare ESP32-S3-Zero. The board combines a diode-isolated 4 × 3 keyboard matrix, three USB-C power-entry options, and two general-purpose JST-SH connections in a…

Size
85.7 × 114.3 mm
Copper layers
2
Thickness
1.6 mm
Parts
72
Nets
64
Pads
310
Tracks, vias
392, 47
Pours
2
Routed
Yes
KiCad
KiCad 10.0 (file 20260206)
Created
1 Aug 2026
Updated
19 Aug 2026

Overview

MacropadMK is an open-source printed circuit board by ThomasLindenberger37, from the ThomasLindenberger37/MacropadMK repository on GitHub, published under the MIT licence. It is a 2-layer board of 85.7 × 114.3 mm with 72 parts on 64 nets, routed with 392 tracks and 47 vias.

It is built around the 1N4148W, WS2812B and BPW85. Its parts include 20 resistors, 19 diodes, 12 switches, 7 connectors and 4 capacitors. It belongs with the keyboards and input boards of this library.

Main components

3

README

README.md

MacropadMK

MacropadMK is a 12-key macropad built around the Waveshare ESP32-S3-Zero. The board combines a diode-isolated 4 × 3 keyboard matrix, three USB-C power-entry options, and two general-purpose JST-SH connections in a compact design.

The PCB is intended for an accessible prototyping workflow: order bare boards, assemble and validate the first units by hand, then reuse the same LCSC-aware bill of materials for a later JLCPCB assembly run.

Design overview

  • Controller: ESP32-S3-Zero
  • Keyboard: 12 switches arranged as 4 rows × 3 columns
  • Isolation: one diode per switch
  • Matrix direction: COL2ROW
  • Supply rails: BOARD_5V, 3V3, and GND
  • USB-C inputs: the controller connector plus two alternative PCB connectors
  • Expansion: two identically pinned 3-position JST-SH connectors

Keyboard matrix

The switches form a 4-row by 3-column matrix. ROW1 through ROW4 are scanned one at a time by driving the selected row low. COL1 through COL3 are inputs, each held high by an external 10 kΩ pull-up resistor to 3V3.

Each key is an independent branch:

text
COLx -> switch -> diode anode -> diode cathode -> ROWx

The diode orientation is COL2ROW: the cathode, identified by the stripe on the physical diode, points toward the row line. When a selected row is low and a key on that row is pressed, its column input is pulled low through the switch and diode.

Signal groupQuantityScan roleExternal bias
ROW1–ROW44Driven low individuallyNone
COL1–COL33Digital inputs10 kΩ to 3V3 per column

USB-C power architecture

The ESP32-S3-Zero already has its own USB-C connector. The PCB provides two additional connector positions as alternative 5 V inputs:

  • Horizontal/right-angle: HRO TYPE-C-31-M-12
  • Vertical/axial: MC-110LD-L124, USB 2.0, 16 pins, with THT mounting tabs
  • Vertical connector LCSC/JLCPCB part number: C3039282

The additional connectors are currently used only for power. They are still full USB 2.0 connector parts so that the same components and footprints can be reused in future designs with USB data support.

Each additional receptacle follows these connection rules:

  • Tie all VBUS pins of that receptacle together.
  • Connect all GND pins to board ground.
  • Connect CC1 to GND through its own 5.1 kΩ resistor.
  • Connect CC2 separately to GND through its own 5.1 kΩ resistor.
  • Connect the connector shield to GND.
  • Leave D+, D-, SBU1, and SBU2 unconnected and mark them as no-connect.

Each alternative receptacle feeds the common BOARD_5V rail through a separate solder bridge. BOARD_5V connects to the ESP32-S3-Zero 5 V pin. An optional resettable fuse rated for approximately 1 A can be fitted ahead of the shared rail.

Place 10 µF bulk capacitance and 100 nF decoupling close to the 5 V input. Route VBUS with approximately 0.8–1.0 mm wide traces; 0.25 mm traces are not recommended for a 1 A supply path.

Power-source warning: The board does not provide input OR-ing or reverse- current isolation. Only one USB power source may be connected at a time unless suitable input decoupling and source isolation are added.

Additional connectors

The board provides two identically pinned 3-position JST-SH connectors with a 1.0 mm pitch.

  • KiCad symbol: Connector_Generic:Conn_01x03
  • KiCad footprint: Connector_JST:JST_SH_SM03B-SRSS-TB_1x03-1MP_P1.00mm_Horizontal
PinSignal
1GND
23V3
3Signal

Sourcing and assembly strategy

Components should use LCSC C part numbers wherever practical. The same part numbers can be used both for loose component orders from LCSC and for JLCPCB assembly BOM matching.

The intended manufacturing sequence is:

  1. Order unassembled prototype PCBs.
  2. Hand-assemble and electrically validate the first boards.
  3. Resolve ERC/DRC findings and confirm footprints, polarity, and connector mechanics.
  4. Reuse the validated BOM for a later JLCPCB assembly order.

Project assets

Download the schematic as PDF.

MacropadMK schematic

MacropadMK 3D board view

Some connector or encoder models may be absent from the rendered 3D preview if their STEP files are not available locally. This does not affect the Gerber or drill exports, but mechanical fit must still be checked before ordering.

Fabrication and documentation exports

The repository contains its KiBot automation directly under scripts/. Docker is required; the scripts use the KiCad 10 KiBot image configured in scripts/project.config.yaml.

Generate the schematic PDF/SVG and the 3D preview:

bash
./scripts/assets.sh

Generate Gerbers, drill files, BOM, placement data, the manufacturer ZIP, and STEP models:

bash
./scripts/fabrication.sh

Generated manufacturing files are written to Fabrication/. The validated manufacturer archive is Fabrication/MacropadMK-Gerber_Pack.zip.

The relevant configuration files are:

  • scripts/project.config.yaml — project name, KiCad image, PCB thickness, and mechanical-hole settings
  • scripts/kibot/config.kibot.yaml — manufacturing outputs and production layers
  • scripts/kibot/kibot_assets.kibot.yaml — documentation PDF, SVG, and 3D render outputs

Always run KiCad ERC and DRC and review the generated Gerbers before submitting an order. Successful file generation does not imply that the electrical or mechanical design is production-ready.

Automated fabrication build

The GitHub Actions fabrication workflow generates manufacturing artifacts when changes are pushed to the repository:

Generate Fabrication Files

Parts

72
QtyValueFootprintReferences
1210kResistor_SMD:R_0603_1608MetricR10, R11, R12, R13, R14, R15, R23, R24, R25, R26, R27, R28
111N4148WDiode_SMD:D_SOD-123D3, D4, D5, D6, D7, D8, D9, D10, D11, D12, D13
11SW_PushKeyswitch_Cherry_MX:SW_Cherry_MX_PCB_1.00uSW1, SW2, SW3, SW4, SW5, SW6, SW7, SW8, SW9, SW10, SW11
8WS2812BLED_SMD:LED_WS2812B_PLCC4_5.0x5.0mm_P3.2mmD1, D2, D14, D15, D16, D17, D18, D19
5MountingHoleMountingHole:MountingHole_3.2mm_M3H1, H2, H3, H4, H5
45k1Resistor_SMD:R_0603_1608MetricR18, R19, R20, R21
32k2Resistor_SMD:R_0603_1608MetricR9, R16, R17
3Conn_01x03_PinConnector_JST:JST_SH_BM03B-SRSS-TB_1x03-1MP_P1.00mm_VerticalJ3, J6, J7
2100nCapacitor_SMD:C_0805_2012MetricC1, C4
210uCapacitor_SMD:C_0805_2012MetricC2, C3
2FuseFuse:Fuse_0805_2012MetricF1, F2
2Qwiic_VerticalConnector_JST:JST_SH_BM04B-SRSS-TB_1x04-1MP_P1.00mm_VerticalJ4, J5
1100kResistor_SMD:R_0603_1608MetricR29
1BPW85LED_SMD:LED_0603_1608MetricQ1
1OLED_SSD1306_0.96in_128x64_I2CSSD1306_OLED:OLED_SSD1306_0.96in_128x64_I2CDS1
1RotaryEncoder_Switch_MPRotary_Encoder:RotaryEncoder_Alps_EC11E-Switch_Vertical_H20mmSW13
1USB_C_Receptacle_USB2.0_16P_AXIALConnector_USB:USB_C_Receptacle_JAE_DX07S024WJ3R400J2
1USB_C_Receptacle_USB2.0_16P_FLATConnector_USB:USB_C_Receptacle_HRO_TYPE-C-31-M-12J1
1~MacropadMK_Custom_Footprints:ESP32-S3-ZeroU1

Similar boards

  • 2 layers101.5 × 64 mmNervous sys, the printed circuit board in 3D

    Nervous sys

    NERVOUS-System-Project/SNN-Breadboard

    KiCad schematic and PCB layout design of controller for Nervous-Systems

    56 parts
  • 4 layers99 × 53.3 mmPSLab, the printed circuit board in 3D

    PSLab

    fossasia/pslab-hardware

    PSLab Hardware Design and Schematics https://pslab.io

    199 parts1.7kApache-2.0
  • 2 layers285.5 × 95 mmReviung46 ver1 1, the printed circuit board in 3D

    Reviung46 ver1 1

    gtips/reviung

    The REVIUNG41 is 41-key column staggered keyboard.

    119 parts517MIT
  • 2 layers309.9 × 119.8 mmCockpit, the printed circuit board in 3D

    Cockpit

    ozkan/Cockpit-Keyboard

    A hot swap system column staggered mechanical keyboard, running QMK Firmware on Pro Micro controllers.

    144 parts43MIT
  • 2 layers233.7 × 91.5 mmSkywatch, the printed circuit board in 3D

    Skywatch

    ozkan/skywatch

    35% ergonomic ortholinear keyboard, powered by RP2040, along with OLED and hotswap sockets support

    133 parts41MIT
  • 2 layers148.6 × 192.2 mmBadge, the printed circuit board in 3D

    Badge

    NuttyShell/NuttyBadge

    NuttyBadge: A NuttyShell crafted multi-tool. Opensourced Hardawre and Software

    169 parts31GPL-3.0
  • 2 layers247.7 × 127 mmEuclid36, the printed circuit board in 3D

    Euclid36

    sadekbaroudi/euclid36

    At the time of creation, using Kicad 5.1.9 - This may not work with future versions

    130 parts24
  • 2 layers356.4 × 105.3 mmAvlo44, the printed circuit board in 3D

    Avlo44

    johnplanow/avlokbd

    Avlo44 is a 6x3+4 column-staggered, split, unibody keyboard.

    112 parts20MIT

Questions

How big is the MacropadMK PCB?

It measures 85.7 × 114.3 mm and has 2 copper layers, 1.6 mm thick.

What parts does the MacropadMK use?

72 parts, built around the 1N4148W, WS2812B and BPW85. 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 MacropadMK KiCad files?

From the ThomasLindenberger37/MacropadMK repository on GitHub, at the commit this page was made from: the board is MacropadMK.kicad_pcb and its schematic MacropadMK.kicad_sch. PCBKit opens the board in the browser, with nothing to install.

Can I use the MacropadMK design in my own project?

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