Skip to the content
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.

Size
59.4 × 71.6 mm
Copper layers
2
Thickness
1.6 mm
Parts
58
Nets
114
Pads
312
Tracks, vias
132, 39
Pours
1
Routed
Yes
KiCad
KiCad 9.0 (file 20241229)
Created
2 Jul 2025
Updated
29 Aug 2026

Overview

Macro devboard quarq 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 of 59.4 × 71.6 mm with 58 parts on 114 nets, routed with 132 tracks and 39 vias.

It is built around the USBLC6-2SC6, 1N4148WT and 12402012E212A, with the 2450AT14A0100001T, ECS-320-8-37B-CKY-TR and PEC12R-4225F-S0024 among its other parts. Its parts include 19 capacitors, 10 diodes, 8 switches, 7 resistors and 3 inductors. It belongs with the microcontroller boards boards and the nRF52 and nRF5x boards of this library.

Main components

6

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

58
QtyValueFootprintReferences
7100nFCapacitor_SMD:C_0201_0603Metric_Pad0.64x0.40mm_HandSolderC17, C19, C20, C21, C22, C30, C32
71N4148WTDiode_SMD:D_SOD-323FD2, D3, D4, D5, D6, D7, D8
6MX_SW_HSkeyswitches:Kailh_socket_MXSW1, SW2, SW6, SW7, SW8, SW9
3100Resistor_SMD:R_0805_2012Metric_Pad1.20x1.40mm_HandSolderR6, R7, R11
3DNFCapacitor_SMD:C_0201_0603Metric_Pad0.64x0.40mm_HandSolderC25, C26, C31
3LEDLED_SMD:LED_0603_1608Metric_Pad1.05x0.95mm_HandSolderD9, D10, D12
21uFCapacitor_SMD:C_0201_0603Metric_Pad0.64x0.40mm_HandSolderC16, C27
222Resistor_SMD:R_0805_2012Metric_Pad1.20x1.40mm_HandSolderR4, R5
25.1kResistor_SMD:R_0805_2012Metric_Pad1.20x1.40mm_HandSolderR1, R2
28pFCapacitor_SMD:C_0201_0603Metric_Pad0.64x0.40mm_HandSolderC33, C34
2SolderJumper_2_OpenJumper:SolderJumper-2_P1.3mm_Open_RoundedPad1.0x1.5mmJP10, JP11
10.5pFCapacitor_SMD:C_0201_0603Metric_Pad0.64x0.40mm_HandSolderC24
10.6pFCapacitor_SMD:C_0402_1005Metric_Pad0.74x0.62mm_HandSolderZ3
10.8pFCapacitor_SMD:C_0201_0603Metric_Pad0.64x0.40mm_HandSolderC23
110uHInductor_SMD:L_0603_1608Metric_Pad1.05x0.95mm_HandSolderL2
112402012E212A12402012E212A:AMPHENOL_12402012E212AJ1
115nHInductor_SMD:L_0402_1005Metric_Pad0.77x0.64mm_HandSolderL1
12450AT14A0100001TAMCA31_2R450G_S1F_T3:XDCR_AMCA31-2R450G-S1F-T3E1
14.7nHInductor_SMD:L_0201_0603Metric_Pad0.64x0.40mm_HandSolderL3
14.7uFCapacitor_SMD:C_0402_1005Metric_Pad0.74x0.62mm_HandSolderC18
147nFCapacitor_SMD:C_0201_0603Metric_Pad0.64x0.40mm_HandSolderC28
17.5nHInductor_SMD:L_0402_1005Metric_Pad0.77x0.64mm_HandSolderZ1
1820pFCapacitor_SMD:C_0201_0603Metric_Pad0.64x0.40mm_HandSolderC29
1Conn_02x13_Counter_ClockwiseConnector_PinHeader_2.54mm:PinHeader_2x13_P2.54mm_VerticalJ3
1DNFCapacitor_SMD:C_0402_1005Metric_Pad0.74x0.62mm_HandSolderZ2
1ECS-320-8-37B-CKY-TRECS_320_8_37B_CKY_TR:XTAL_ECS-160-9-37-CKM-TRY3
1PEC12R-4225F-S0024PEC12R_4225F_S0024:XDCR_PEC12R-4225F-S0024S1
1RSTButton_Switch_SMD:SW_Tactile_SPST_NO_Straight_CK_PTS636Sx25SMTRLFSSW4
1USBLC6-2SC6Package_TO_SOT_SMD:SOT-23-6_HandsolderingU3
1nRF52840Package_DFN_QFN:Nordic_AQFN-73-1EP_7x7mm_P0.5mmU1

More from YingK8/ESP32-BLE-Macro-Pad

4
  • 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 layersMacro devboard, the printed circuit board in 3D

    Macro devboard

    YingK8/ESP32-BLE-Macro-Pad

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

    50 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 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

How big is the Macro devboard quarq PCB?

It measures 59.4 × 71.6 mm and has 2 copper layers, 1.6 mm thick.

What parts does the Macro devboard quarq use?

58 parts, built around the USBLC6-2SC6, 1N4148WT, 12402012E212A and 2450AT14A0100001T. 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 quarq 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 quarq.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 quarq design in my own project?

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