

MacroController
Custom nRF52840 productivity controller for digital artists — PCB, BLE/USB firmware, OLED, haptics, RGB, and enclosure CAD.
- Size
- 96 × 74 mm
- Copper layers
- 2
- Thickness
- 1.6 mm
- Parts
- 78
- Nets
- 97
- Pads
- 340
- Tracks, vias
- 460, 90
- Pours
- 17
- Routed
- Yes
- KiCad
- KiCad 9.0 (file 20241229)
- Created
- 11 Aug 2026
- Updated
- 13 Aug 2026
Overview
MacroController is an open-source printed circuit board by alex1klimovich, from the alex1klimovich/nrf52840-macro-controller repository on GitHub. It is a 2-layer board of 96 × 74 mm with 78 parts on 97 nets, routed with 460 tracks and 90 vias.
It is built around the MDBT50Q-1MV2, DRV2605LDGS and MT3608, with the TP4056-42-ESOP8, 1N4148WT and SK6812MINI-E among its other parts. Its parts include 19 diodes, 14 capacitors, 14 resistors, 13 switches and 4 ICs. It belongs with the radio and wireless and lEDs and displays boards and the nRF52 and nRF5x boards of this library.
Main components
12MDBT50Q-1MV2
SMD-61PSMD-61P Bluetooth Modules ROHSRAYTACBluetooth ModulesDRV2605LDGS
VSSOP-10-0.5mm-40℃~+85℃ 1 2V~5.2V 500uA I2C Yes VSSOP-10-0.5mm Brushed DC Motor Drivers ROHSTexas InstrumentsBrushed DC Motor DriversMT3608
SOT-23-6-40℃~+85℃ 1 1.2MHz 100uA、1.6mA 2A 2V~24V Adjustable Boost Boost Built-in No SOT-23-6 DC-DC Converters ROHS西安航天民芯DC-DC ConvertersTP4056-42-ESOP8
ESOP-8-40℃~+85℃ 1 1A 2uA 4.2V 4V~8V Charging IC Lithium Battery Support ESOP-8 Battery Management ROHSTOPPOWERBattery Management1N4148WT
SOD-523-55℃~+150℃ 1.25V@150mA 100V 150mA 150mW 1uA@75V 2A 4ns Independent SOD-523 Switching Diodes ROHShongjiachengSwitching DiodesSK6812MINI-E
SMD-40℃~+85℃ 0.6mA 1.78mm 120mcd~240mcd 120° 160mcd~320mcd 1kHz 2.8mm 2000V 3.2mm 3.7V~5.5V 460nm~470nm 515nm~525nm 620nm~625nm 800Kbit/s 815mcd~1275mcd Semi-transparent lens SMD RGB LEDs(Built-in IC) ROHSOPSCO OptoelectronicsRGB LEDs(Built-In IC)RC0402FR-07100KL
UncategorisedUnknown makerCL31A226KAHNNNE
120622uF 25V X5R ±10% 1206 Multilayer Ceramic Capacitors MLCC - SMD/SMT ROHSSamsung Electro-MechanicsMultilayer Ceramic Capacitors MLCC - SMD/SMTAC0402FR-075K1L
0402-55℃~+155℃ 5.1kΩ 50V 62.5mW Thick Film Resistor ±1% ±100ppm/℃ 0402 Chip Resistor - Surface Mount ROHSYAGEOChip Resistor - Surface MountRC0402JR-074K7L
UncategorisedUnknown maker1206L110/6V
1206UncategorisedYTLSS34
SMA(DO-214AC)-55℃~+125℃ 3A 40V 500uA@40V 550mV@3A Independent SMA(DO-214AC) Schottky Diodes ROHSMDDSchottky Diodes
README
README.mdnRF52840 Productivity Controller for Digital Artists
A custom wireless/wired productivity controller designed for digital artists who repeatedly use keyboard shortcuts, brush controls, tool switching, and other workflow actions.
I designed the PCB, wrote the firmware, brought up the first board, and modeled the enclosure. The current prototype combines an nRF52840 module, eight hot-swap mechanical keys, a rotary encoder, OLED interface, per-key RGB, haptic feedback, battery monitoring, and USB/Bluetooth HID.
The goal is to make frequently used creative controls accessible through a compact physical interface that can be customized for different applications and workflows.

Design goal
The controller was designed around the workflow of digital artists rather than as a generic macro pad.
Creative applications often require repeated keyboard shortcuts and parameter adjustments while the user's other hand remains focused on a mouse, stylus, or drawing tablet. The controller provides a compact set of tactile, programmable inputs intended to reduce those repetitive interactions.
The rotary encoder is suited to continuously adjusted parameters such as brush size, zoom, timeline position, or other application-specific controls. The mechanical keys can be assigned to frequently used tools, shortcuts, and multi-step actions.
Multiple profiles and three remembered Bluetooth hosts allow the same hardware to adapt to different applications and devices without rebuilding the firmware for each workflow.
Prototype user testing
The current prototype is being evaluated by an animation student at San José State University as an early real-world user.
Testing is focused on:
- Control placement and ergonomics
- Which actions are most useful on physical keys versus the rotary encoder
- Workflow interruption when moving between a keyboard, drawing tablet, and controller
- Profile and shortcut organization
- Enclosure size and physical accessibility
- Feedback from the OLED, RGB indicators, and haptics
Feedback from this testing is being used to guide revisions to the control layout, enclosure, and software configuration experience. This is an ongoing prototype rather than a finished commercial product; the purpose of the testing stage is to identify usability problems before another hardware revision.
What is in the prototype
- Product requirements translated into custom electronics, firmware behavior, and mechanical constraints
- A two-layer embedded system: custom hardware plus event-driven C++ firmware
- USB and BLE HID routing with three remembered Bluetooth slots
- A 2×4 key matrix, dual-role tap/hold actions, macros, media keys, mouse actions, and MIDI actions
- Profile and settings persistence in internal flash using JSON
- Rotary-encoder acceleration and multiple encoder modes per profile
- An SSD1306 interface for profiles, settings, pairing, and battery state
- DRV2605L haptics, eight addressable LEDs, LiPo charging, and VBUS sensing
- A browser-based serial configuration interface in
firmware/NRFMacroController/site.html
System architecture
flowchart LR
A["2×4 key matrix"] --> I["InputEngine"]
B["Encoder + side buttons"] --> I
I --> Q["RTOS event queue"]
Q --> S["StateManager"]
S --> F["LittleFS profiles + settings"]
Q --> O["OutputEngine"]
O --> U["USB HID"]
O --> L["BLE HID"]
O --> H["DRV2605L haptics"]
S --> D["OLED + RGB UI"]
C["Browser configurator"] <--> SHardware
The PCB is built around a Raytac MDBT50Q nRF52840 module and includes:
- Eight Kailh hot-swap switch sockets and SK6812-compatible LEDs
- EC11 rotary encoder and two side buttons
- USB-C, battery connector, charging and power circuitry, and test points
- OLED and haptic-driver connections on I²C
- Battery-level and VBUS-sense inputs for power-aware UI behavior

Current nRF52840 schematic
The schematic below is exported from the checked-in KiCad source. It shows the Raytac MDBT50Q nRF52840 module, USB interface, battery charging and protection, haptic driver, key matrix, RGB LEDs, OLED I²C interface, rotary encoder, and side buttons.
The original project directory retained an older ESP32_MCU-KEYBOARD_1.0 filename, but the current electrical design is the nRF52840 board shown above. The repository uses the clearer MacroController filenames for the editable KiCad sources.
Firmware
The firmware separates input scanning, persistent state, output routing, and UI work. Input events move through an RTOS queue, while the state manager owns profiles and settings and the output engine handles HID, BLE, and haptic behavior.
Implemented behavior includes:
- USB and Bluetooth keyboard, mouse, media, and MIDI actions
- Tap/hold layers and macros with up to eight steps
- Profile discovery and JSON persistence in internal flash
- Three Bluetooth device slots with pairing and bond management
- Encoder modes with pace-based acceleration
- OLED menus, profile carousel, pairing UI, and battery display
- Configurable RGB feedback, haptic strength, OS mode, and low-power behavior
Build
The checked-in firmware was compiled with Arduino CLI, Seeed nRF52 core 1.1.12, and the xiaonRF52840 target used by this project. The installed variant needs the low-frequency crystal selection supplied explicitly:
arduino-cli compile \
--fqbn Seeeduino:nrf52:xiaonRF52840 \
--build-property 'compiler.c.extra_flags=-DUSE_LFXO' \
--build-property 'compiler.cpp.extra_flags=-DUSE_LFXO' \
firmware/NRFMacroControllerVerified build: 223,536 bytes of flash (27%) and 21,572 bytes of RAM (9%).
Required Arduino libraries include Adafruit TinyUSB, Adafruit Bluefruit nRF52, Adafruit GFX, Adafruit SSD1306, Adafruit NeoPixel, Adafruit DRV2605, ArduinoJson, and RotaryEncoder.
PCB and manufacturing
The repository includes editable KiCad schematic and board sources as well as the fabrication package used for the prototype: Gerbers, BOM, and component placement data.
| Current nRF52840 top assembly | Current nRF52840 bottom assembly |
|---|---|
![]() | ![]() |
| Front copper and placement | Back copper and placement |
|---|---|
![]() | ![]() |
Before ordering another revision, KiCad ERC/DRC should be rerun and the generated manufacturing files reviewed against the selected component revisions. A historical DRC report was intentionally omitted because it predates the latest board edit and is not evidence of the current design state.
Mechanical design
The mechanical folder contains the Blender enclosure model and STEP assembly developed around the PCB, switches, encoder, display, and connector access. The photographed unit is an exposed functional prototype; the current enclosure CAD has not yet been integrated into the pictured test unit.

Hardware bring-up and debugging
The custom board did not initially produce the expected MCU response during bring-up. Debugging required revisiting both the programming assumptions and the boundary between the board design and its firmware/toolchain configuration.
The recovery process included:
- Checking the programming and firmware assumptions rather than treating the board as a known-good development kit.
- Using a Raspberry Pi Zero as a temporary programming/debugging tool for the custom hardware.
- Correcting the board/toolchain configuration used for the nRF52840 target.
- Verifying the physical-to-firmware pin mapping for the key matrix and peripherals.
- Bringing subsystems up incrementally before exercising the complete interface.
That process led to successful firmware execution on the custom board and informed the explicit pin map and build configuration now documented in the repository.
Engineering status
The photographed board is a functional exposed prototype. Input scanning, OLED UI, LEDs, haptics, USB/BLE routing, persistent profiles, and device switching are implemented in the published firmware.
Current work is focused on findings from digital-art workflow testing, enclosure integration, and a simpler configuration experience. I have not recorded a workflow video yet, so the repository shows the hardware, source, and verified build without presenting a staged demo as completed testing.

Repository map
| Path | Contents |
|---|---|
firmware/ | nRF52840 Arduino firmware and browser configurator |
hardware/kicad/ | KiCad schematic, PCB, local footprints, and board STEP export |
hardware/production/ | Fabrication Gerbers, BOM, and component placement file |
mechanical/ | Blender enclosure model and STEP assembly |
docs/images/ | Prototype photos, current nRF52840 schematic preview, PCB views, and enclosure CAD |
docs/schematics/ | Readable PDF export of the current nRF52840 schematic |
Use
This is a personal hardware project. No license is granted for commercial manufacture or redistribution.
Parts
78| Qty | Value | Footprint | References |
|---|---|---|---|
| 8 | 1N4148WT | Diode_SMD:D_SOD-323 | D4, D5, D6, D7, D8, D9, D10, D11 |
| 8 | Kailh Hotswap Switch | keyswitches.pretty-2.1:Kailh_socket_PG1350 | SW1, SW2, SW3, SW4, SW5, SW6, SW7, SW8 |
| 8 | SK6812MINI-E | PCM_marbastlib-various:LED_6028R | LED1, LED2, LED3, LED4, LED5, LED6, LED7, LED8 |
| 4 | 1uF | Capacitor_SMD:C_0402_1005Metric | C1, C7, C11, C20 |
| 4 | Hole_Pad | MountingHole:MountingHole_3.2mm_M3_DIN965_Pad | H1, H2, H3, H4 |
| 3 | 100nF | Capacitor_SMD:C_0402_1005Metric | C2, C6, C15 |
| 3 | 10K | Resistor_SMD:R_0805_2012Metric | R4, R5, R10 |
| 3 | 22uF | Capacitor_SMD:C_1206_3216Metric | C4, C8, C10 |
| 3 | 5K1 | Resistor_SMD:R_0805_2012Metric | R1, R2, R22 |
| 2 | 100k 1% | Resistor_SMD:R_1206_3216Metric | R11, R12 |
| 2 | 4K7 | Resistor_SMD:R_0805_2012Metric | R29, R30 |
| 2 | Polyfuse | Fuse:Fuse_1206_3216Metric | F1, F3 |
| 2 | SS34 | Diode_SMD:D_SOD-123 | D1, D3 |
| 2 | SW_Push | Button_Switch_THT:SW_PUSH_6mm_H4.3mm | SW12, SW13 |
| 2 | TestPoint | TestPoint:TestPoint_Pad_1.5x1.5mm | TP1, TP2 |
| 1 | 10nF | Capacitor_SMD:C_0402_1005Metric | C17 |
| 1 | 10uF | Capacitor_SMD:C_0603_1608Metric | C5 |
| 1 | 1K2 | Resistor_SMD:R_0805_2012Metric | R8 |
| 1 | 1M | Resistor_SMD:R_0805_2012Metric | R24 |
| 1 | 1nF | Capacitor_SMD:C_0603_1608Metric | C18 |
| 1 | 220R | Resistor_SMD:R_0805_2012Metric | R23 |
| 1 | 22uH 2A | Inductor_SMD:L_Sunlord_SWPA6045S | L2 |
| 1 | 33K | Resistor_SMD:R_0805_2012Metric | R21 |
| 1 | 4.7uF | Capacitor_SMD:C_0805_2012Metric | C3 |
| 1 | BLM21PG221 | Ferrite_SMD_AKL:Ferrite_0805_2012Metric | FB1 |
| 1 | Conn_01x02 | Connector_JST:JST_PH_B2B-PH-K_1x02_P2.00mm_Vertical | J5 |
| 1 | Conn_01x02_Pin | Connector_Wire:SolderWire-0.5sqmm_1x02_P4.6mm_D0.9mm_OD2.1mm | J2 |
| 1 | Conn_01x04_Pin | Connector_PinHeader_2.54mm:PinHeader_1x04_P2.54mm_Vertical | J3 |
| 1 | DRV2605LDGS | Package_SO:VSSOP-10_3x3mm_P0.5mm | U2 |
| 1 | EN | Button_Switch_SMD:SW_Push_SPST_NO_Alps_SKRK | SW10 |
| 1 | MDBT50Q-1MV2 | RF_Module:Raytac_MDBT50Q | U3 |
| 1 | MT3608 | Package_TO_SOT_SMD:SOT-23-6 | U16 |
| 1 | PESD5V0L4UG | Package_TO_SOT_SMD:SOT-353_SC-70-5 | D12 |
| 1 | RotaryEncoder_Switch | Keebio-Parts:RotaryEncoder_EC11 | SW11 |
| 1 | SW_SPDT | Button_Switch_THT:SW_Slide_SPDT_Angled_CK_OS102011MA1Q | SW9 |
| 1 | TP4056-42-ESOP8 | Package_SO:SOIC-8-1EP_3.9x4.9mm_P1.27mm_EP2.41x3.3mm_ThermalVias | U5 |
| 1 | USB_C_Receptacle_USB2.0_16P | Connector_USB:USB_C_Receptacle_G-Switch_GT-USB-7010ASV | J1 |
Similar boards
- 4 layers78 × 89 mm

- 2 layers135.3 × 78.4 mm

Mseq
MF-Room/mseq_pcb
KiCad 10 hardware design for MSeq embedded, the microcontroller implementation of the MSeq MIDI sequencer.
93 parts1CERN-OHL-S-2.0 - 4 layers62 × 49.8 mm

- 2 layers104 × 66 mm

Vallox rs485-controller
Miroeilola/vallox-rs485-controller
Replacement control panel for legacy Vallox SE ventilation units. Vallox DIGIT RS-485 protocol, bus-powered, ESP32, Home Assistant.
65 parts - 2 layers33 × 12.5 mm

- 4 layers52 × 74 mm

FRC Sensor CAN
barkinvar/sugerCANe
A compact interface for three NPN, PNP or logic sensors on an FRC robot. Each port has a removable 5 V / 12 V power jumper; input type is configured in software.
144 parts1 - 4 layers60 × 110 mm

Nucula v2
zeugmaster/nucula-board
Nucula Board: an ESP32-C3 hardware prototype with USB-C, PN7160 NFC, OLED and detachable keyboard. KiCad sources and manufacturing files.
138 parts1CERN-OHL-S-2.0 - 4 layers150 × 100 mm

Power profiler carrier
Guiimartinho/open-power-profiler
Open-source PPK2-class power profiler built on the Raspberry Pi Pico 2: 100 kSPS, 100 nA to 1 A auto-ranging, source meter and ampere meter modes, USB stream.
425 partsMIT
Questions
How big is the MacroController PCB?
It measures 96 × 74 mm and has 2 copper layers, 1.6 mm thick.
What parts does the MacroController use?
78 parts, built around the MDBT50Q-1MV2, DRV2605LDGS, MT3608 and TP4056-42-ESOP8. 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 MacroController KiCad files?
From the alex1klimovich/nrf52840-macro-controller repository on GitHub, at the commit this page was made from: the board is hardware/kicad/MacroController.kicad_pcb and its schematic hardware/kicad/MacroController.kicad_sch. PCBKit opens the board in the browser, with nothing to install.
Can I use the MacroController design in my own project?
Its repository states no licence, so its author keeps all rights: ask alex1klimovich before reusing the design.




