Skip to the content
2 layersMacro devboard, the printed circuit board in 3D

A compact, programmable macropad with Bluetooth connectivity, featuring 6 mechanical keys and a rotary encoder for media control.

Copper layers
2
Thickness
1.6 mm
Parts
50
Nets
67
Pads
219
Tracks, vias
10, 0
Routed
Yes
KiCad
KiCad 9.0 (file 20241229)
Created
2 Jul 2025
Updated
29 Aug 2026

Overview

Macro devboard is an open-source printed circuit board by YingK8, from the YingK8/ESP32-BLE-Macro-Pad repository on GitHub. It is a 2-layer board with 50 parts on 67 nets, routed with 10 tracks and 0 vias.

It is built around the ATMEGA32U4-AU, 1N4148WT and 12402012E212A, with the ABM8-16.000MHZ-D1X-T and PEC12R-4225F-S0024 among its other parts. Its parts include 10 diodes, 8 switches, 7 resistors, 5 capacitors and 2 connectors. It belongs with the microcontroller boards boards and the AVR (ATmega, ATtiny) boards of this library.

Main components

5

README

README.md

ESP32 BLE HID Macropad

A compact, programmable macropad with Bluetooth connectivity, featuring 6 mechanical keys and a rotary encoder for media control.

Version ESP32 BLE

Features

  • 6-key mechanical switch matrix
  • Rotary encoder for volume/scroll control
  • Bluetooth HID (no drivers required)
  • Supports both keyboard and media controls
  • Customizable key mappings

Hardware

ComponentQuantity
ESP32 Dev Board1
Mechanical Keyswitches6
Rotary Encoder1
1N4148 Diodes6

Pinout

FunctionESP32 Pin
Row 1GPIO 5
Row 2GPIO 6
Col 1GPIO 4
Col 2GPIO 7
Col 3GPIO 8
Encoder AGPIO 9
Encoder BGPIO 10

Installation

  1. Wire components according to pinout table
  2. Install Arduino IDE with ESP32 support
  3. Install required libraries:
    • ESP32 BLE Arduino
    • RotaryEncoder
  4. Upload firmware to ESP32

Usage

  1. Power on the macropad
  2. Pair with "ESP32 Macropad" via Bluetooth
  3. Default layout:
    • Top row: Media controls
    • Bottom row: Programmable macros
    • Encoder: Volume control

Customization

Edit the keymap in the source code:

cpp
const uint8_t keys[ROWS][COLS] = {
  {MEDIA_PLAY, MEDIA_VOL_UP, MEDIA_VOL_DOWN},
  {KEY_F13, KEY_F14, KEY_F15}
};

## Pomodoro UI + Task Sync (macro-pad/)

- Display: ST7789 240x280 SPI. Set pins in `macro-pad/include/Config.h`.
- Controls: top-left key toggles pause/resume; encoder rotation moves selection; top-right key (encoder click in matrix) checks/unchecks a task.
- Task payload: newline-delimited titles terminated by `--END--`.

CLI helper (requires `pip install bleak`):

```bash
python3 macro-pad/tools/push_tasks.py "Write report" "Review PRs"

Parts

50
QtyValueFootprintReferences
71N4148WTDiode_SMD:D_SOD-323FD2, D3, D4, D5, D6, D7, D8
7SolderJumper_3_Bridged12Jumper:SolderJumper-3_P1.3mm_Bridged12_RoundedPad1.0x1.5mm_NumberLabelsJP1, JP2, JP3, JP4, JP5, JP6, JP7
7TestPointConnector_PinHeader_2.54mm:PinHeader_1x01_P2.54mm_VerticalTP1, TP2, TP3, TP4, TP5, TP6, TP7
6MX_SW_HSkeyswitches:Kailh_socket_MXSW1, SW2, SW6, SW7, SW8, SW9
3100Resistor_SMD:R_0805_2012Metric_Pad1.20x1.40mm_HandSolderR1, R2, R11
31uFCapacitor_SMD:C_0805_2012Metric_Pad1.18x1.45mm_HandSolderC9, C11, C12
3LEDLED_SMD:LED_0603_1608Metric_Pad1.05x0.95mm_HandSolderD1, D9, D11
218pFCapacitor_SMD:C_0805_2012Metric_Pad1.18x1.45mm_HandSolderC13, C14
222Resistor_SMD:R_0805_2012Metric_Pad1.20x1.40mm_HandSolderR4, R5
2SolderJumper_2_OpenJumper:SolderJumper-2_P1.3mm_Open_RoundedPad1.0x1.5mmJP8, JP9
110kResistor_SMD:R_0805_2012Metric_Pad1.20x1.40mm_HandSolderR12
112402012E212A12402012E212A:AMPHENOL_12402012E212AJ1
14.7kResistor_SMD:R_0805_2012Metric_Pad1.20x1.40mm_HandSolderR3
1ABM8-16.000MHz-D1X-TABM8_16_000MHZ_D1X_T:XTAL_ABM8-16.000MHz-D1X-TY2
1ATmega32U4-APackage_QFP:TQFP-44_10x10mm_P0.8mmU2
1Conn_02x13_Counter_ClockwiseConnector_PinHeader_2.54mm:PinHeader_2x13_P2.54mm_VerticalJ3
1PEC12R-4225F-S0024PEC12R_4225F_S0024:XDCR_PEC12R-4225F-S0024S1
1RSTButton_Switch_SMD:SW_Tactile_SPST_NO_Straight_CK_PTS636Sx25SMTRLFSSW3

More from YingK8/ESP32-BLE-Macro-Pad

4
  • 2 layers59.4 × 71.6 mmMacro devboard quarq, the printed circuit board in 3D

    Macro devboard quarq

    YingK8/ESP32-BLE-Macro-Pad

    A compact, programmable macropad with Bluetooth connectivity, featuring 6 mechanical keys and a rotary encoder for media control.

    58 parts
  • 4 layers65.6 × 57.2 mmMacro devboard ESP32, the printed circuit board in 3D

    Macro devboard ESP32

    YingK8/ESP32-BLE-Macro-Pad

    A compact, programmable macropad with Bluetooth connectivity, featuring 6 mechanical keys and a rotary encoder for media control.

    55 parts
  • 2 layersWith humiditier, the printed circuit board in 3D

    With humiditier

    YingK8/ESP32-BLE-Macro-Pad

    A compact, programmable macropad with Bluetooth connectivity, featuring 6 mechanical keys and a rotary encoder for media control.

    43 parts
  • 2 layers58 × 58 mmESP32-BLE Macro Pad, the printed circuit board in 3D

    ESP32-BLE Macro Pad

    YingK8/ESP32-BLE-Macro-Pad

    A compact, programmable macropad with Bluetooth connectivity, featuring 6 mechanical keys and a rotary encoder for media control.

    31 parts

Similar boards

  • 4 layers100 × 60 mmRoam, the printed circuit board in 3D

    Roam

    yaozong1/Roam_pcba

    192 parts
  • 4 layers133.4 × 44.3 mmSignalSnagger, the printed circuit board in 3D

    SignalSnagger

    OpenARDF/SignalSnagger

    80m Radio Orienteering Receiver

    207 parts6MIT
  • 2 layers100.1 × 121.4 mmPanel, the printed circuit board in 3D

    Panel

    da-penguin-guy/Proteus

    The Proteus is a modular collection of PCBs that will be used to develop the Virgil sound Protocol

    137 parts3
  • 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 layers77.5 × 50.8 mmSdb, the printed circuit board in 3D

    Sdb

    0x007E/sdb

    Switch Development Board

    68 parts
  • 2 layers76.2 × 34.3 mmBrentsController, the printed circuit board in 3D

    BrentsController

    ahkneipp/LightDriver

    Control system for a strip of WS2811 LEDs; Quick and dirty

    27 parts

Questions

What parts does the Macro devboard use?

50 parts, built around the ATMEGA32U4-AU, 1N4148WT, 12402012E212A and ABM8-16.000MHZ-D1X-T. 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 devboard KiCad files?

From the YingK8/ESP32-BLE-Macro-Pad repository on GitHub, at the commit this page was made from: the board is PCB/macro devboard.kicad_pcb and its schematic PCB/Untitled.kicad_sch. PCBKit opens the board in the browser, with nothing to install.

Can I use the Macro devboard design in my own project?

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