Skip to the content
4 layers65 × 100 mmMacropad, the printed circuit board in 3D

A wireless, 12-key Hall-effect macropad built around a custom PCB, an ESP32-C6 sender, an ESP32-S3 USB receiver, and a native macOS companion app.

Size
65 × 100 mm
Copper layers
4
Thickness
1.6 mm
Parts
165
Nets
126
Pads
576
Tracks, vias
321, 94
Pours
1
Routed
Yes
KiCad
KiCad 10.0 (file 20260206)
Created
25 Jul 2026
Updated
6 Nov 2026

Overview

Macropad is an open-source printed circuit board by mcskny, from the mcskny/wireless-he-macropad repository on GitHub, published under the GPL-3.0 licence. It is a 4-layer board of 65 × 100 mm with 165 parts on 126 nets, routed with 321 tracks and 94 vias.

It is built around the SN74AHCT1G125DCKR(LX), TCS40DLR,LF and MCP3202-CI/P, with the SN74HC165PWRG3, AP2112K-3.3 and CD74HC4067SM96 among its other parts. Its parts include 42 capacitors, 40 resistors, 35 ICs, 11 diodes and 3 transistors. It belongs with the keyboards and input boards and the ESP32 and RISC-V boards of this library.

Main components

12

README

Readme.md

Separate transport profiles (experimental): C6 0.1.6 and Studio 0.1.4 keep BLE and ESP-NOW layer settings separately, copying prior shared settings on first migration. Separate key assignments across mode switches were verified on the current hardware. Hall calibration remains shared.

6 November 2026: Studio supports configuring C6 lighting, selecting layers and writing supported per-layer HID assignments over encrypted BLE. Hardware checks confirmed lighting changes on two layers and an H assignment that survived a C6 restart. Three paired-slot names are locally editable aliases, not automatically retrieved host names. BLE sensor telemetry and automatic synchronization between C6 and S3 are not implemented; a solid lighting color also persisted across a restart with Studio closed. Other hosts need further testing.

Wireless HE Macropad

A wireless, 12-key Hall-effect macropad built around a custom PCB, an ESP32-C6 sender, an ESP32-S3 USB receiver, and a native macOS companion app.

The project explores analog key travel, configurable actuation, per-layer actions, responsive lighting, and power-conscious wireless operation. It is an active hardware and firmware prototype, not a finished commercial product.

ESP-IDF Platform Status License

At a glance

  • 12 analog Hall-effect keys, arranged in three columns and four rows.
  • A separate mechanical layer button, four layer indicator positions, and a rotary encoder in the design.
  • ESP32-C6 → ESP-NOW → ESP32-S3 → USB for the current wireless test system.
  • Direct C6-to-host BLE HID is integrated and keyboard output was confirmed on a Mac. Bond persistence and automatic reconnection still need a complete restart and mode-switch test.
  • A custom PCB with DRV5055 sensors, a 16-channel multiplexer, and an external 12-bit ADC.
  • Per-key lighting driven by a chain of 12 addressable LEDs.
  • Wireless HE Studio, a native macOS app with live telemetry, calibration, interactive 2D/3D views, layers, and lighting controls.

Gallery

Macropad enclosure render
Enclosure and layout
Macropad PCB design
Custom PCB
Wireless HE Studio layer and key configuration
Studio · layers and key assignments
Wireless HE Studio lighting and 3D preview
Studio · lighting and 3D preview

The enclosure and PCB images are renders; Studio screenshots illustrate the interface and may not show its latest revision.

How it works

Each key moves a magnet past a Hall sensor. The sensor's analog output is sampled and converted into a calibrated position, allowing the prototype to react to key travel rather than just an on/off switch.

text
12 × DRV5055 sensors → CD74HC4067 multiplexer → MCP3202 ADC
                                                    │
                                           ESP32-C6 macropad
                                                    │ ESP-NOW
                                                    ▼
Mac / computer ← USB HID + serial telemetry ← ESP32-S3 dongle
        │                                           ▲
        └──── Studio configuration and live lighting ┘

The repository contains both the current C6/S3 test bridge and separate, evolving product-firmware projects. They are not interchangeable builds and do not necessarily use the same pin assignments.

What works today

The following describes the test setup and the specific behavior observed, as of 5 November 2026. A successful test of one action does not mean every combination has been validated.

AreaObserved on the prototypeStill to do
SensingAll 12 channels appeared in Studio; individual calibration, channel mapping, and live key movement were checked.Long-run stability, cross-channel effects, physical travel measurement, and full calibration validation.
Wireless linkC6 → S3 → Mac telemetry works; Studio displays scan, submission, reception, and sequence-gap counters.Reduce active-mode gaps, measure latency and range, and add authenticated pairing/encryption.
Direct BLEC6 paired with a Mac and typed using a saved profile; Layer + KEY 0 switched transport and the transition effects were checked.Validate persisted bonding across reboot and transport changes, BLE disconnect release, other hosts, latency, and power.
USB keyboardLayer-specific keyboard actions and volume-down HID were tested on a Mac. A saved layer survived an S3 reconnect; output also worked with Studio closed.More host/shortcut tests, disconnect recovery, and NKRO. The current keyboard report is 6KRO.
Hall behaviorsRapid Trigger retriggering was tested with a partially released key. SOCD's last-pressed priority and return to the held key were also tested.Wider sensitivity, multi-key, and long-duration hardware tests; two-stage behavior needs a physical test.
LightingAll 12 LEDs lit. Live layer/effect synchronization, rainbow or snake color behavior, and virtual-key ripple triggering were checked. Sweep turn-off and ripple stopping were also checked physically.Validate the complete effect set and persistence; lighting configuration is currently sent live rather than stored permanently on the device.
Power policyIdle sensor scans and software-controlled MOSFET duty cycling were observed; the app displays commanded gate on-time.Measure rail voltage, startup/settling, backfeed, actual current, and battery life.
Mac appLive sensor values, 2D/3D views, layer controls, local profiles, and the device write path are available. Blender's move, rotate, and scale actions were tested.Complete and validate all target-app actions, accessibility, long-term performance, and hardware integration.
MechanicalA 3D model, PCB design, and enclosure renders exist.Manufacture and validate the plate, case fit, and final assembly.

Project progress map

The percentage in the graphic is a manually reviewed, equally weighted checklist estimate. Some items overlap; it is not a measurement of remaining work, reliability, or product readiness. See the compact progress grid for the item index.

Wireless HE Studio

Studio is a native SwiftUI / AppKit / SceneKit macOS application. Its current features include:

  • A live ADC graph, raw channel diagnostics, channel remapping, per-key calibration, and idle-noise measurements.
  • Interactive 2D and 3D views, key motion, and an exploded component view based on the project model.
  • Four layers with keyboard/media actions, traditional thresholds, Rapid Trigger, SOCD, and local profile storage.
  • Lighting previews and live control of effects such as static, breathing, wave, sweep, reactive, ripple, starlight, rainbow, and snake.
  • Live rate and power-policy telemetry, including commanded GPIO on-time rather than a measured power figure.
  • Turkish and English interface options, local backup, and sensor-session logs.

Studio includes 13 starter profiles covering creative applications and games. The 156 preset entries include direct mappings and suggested shortcuts that may need assignment in the target application; mapping and real application validation are distinct. The UI identifies these assignments. A mapped output does not prove the target application accepts it or that its shortcuts match the user's settings. Encoder actions and native analog gamepad output are not yet implemented end to end.

Studio writes supported actions for the selected layer to the S3. Calibration endpoints and supported Hall settings are included; local profile storage and device storage are distinct. Verify the target layer and assigned shortcuts before writing.

Sampling and power experiments

The current test policy scans at 100 Hz while idle, with a 1 kHz active target after detected movement. Idle radio updates are targeted at 10 Hz without Studio or 100 Hz while Studio is connected; active transmission targets 1 kHz. The observed values in Studio are measurements, not guarantees of those targets.

In one active test the C6 reported roughly 983 scans/s and 858 radio submissions/s. These are short observations under specific conditions; submissions, received packets, and end-to-end input latency are different measurements. Sequence gaps can arise in scheduling, radio transmission, buffering, or USB.

With the experimental MOSFET build, the idle test showed approximately 13% commanded gate on-time. Active-mode duty cycling with a 600 µs startup wait reduced a trial to about 620 scans/s, so that experiment was reverted: the current active mode keeps the analog rail commanded on. GPIO timing does not establish the actual rail voltage, energy savings, or battery life. No power-saving multiplier is claimed.

Hardware overview

ComponentRole
12 × DRV5055A4Analog Hall sensors
CD74HC406716-channel analog multiplexer
MCP320212-bit external ADC
XIAO ESP32-C6Current wireless sender test board
ESP32-S3USB receiver and HID test board
12 × SK6812MINIAddressable key lighting
Mechanical switchLayer button; current test wiring uses D7 to GND
Rotary encoder and four indicatorsDesigned controls; full hardware integration remains in progress

The test-bridge C6 wiring uses D0–D3 for multiplexer selection, D4 for ADC chip select, D8–D10 for SPI, D6/GPIO16 for LED data, D5/GPIO23 for the optional active-low analog power gate, and D7/GPIO17 for the layer button. Check the bridge documentation, the actual board, and the schematic before connecting or powering anything. These pins are not a promise about the separate product firmware.

Repository layout

PathContents
Hardware/Kicad/PCB and schematic source files
Firmware/macropad-sender/Developing C6 product firmware
Firmware/dongle-receiver/Developing S3 product firmware
Firmware/shared/Shared firmware modules and tests
examples/c6_s3_sensor_bridge/Current C6/S3 wireless prototype and HID bridge
examples/c6_ble_hid_lab/Isolated, buildable BLE HID transport experiment (separate from the integrated C6 build)
examples/macropad_12_idf/mac_app/Wireless HE Studio macOS app
examples/lighting_espnow_lab/Lighting engine and protocol experiments
examples/crossover_analog/Earlier CrossOver analog-controller experiment
Docs/Proje_Rehberi.mdDetailed Turkish technical guide
Docs/BLE_Tasarim.mdDirect BLE mode architecture and remaining validation (Turkish)
output/pdf/Wireless_HE_Proje_Rehberi.pdfConsolidated project guide (Turkish)
tools/progress.pyGenerates the Turkish project progress map

The earlier Assetto Corsa steering/throttle/brake experiment used a wired sensor platform and a CrossOver virtual-controller bridge. It does not demonstrate native analog gamepad output from the current S3 dongle.

Build and test

The prototype firmware has been built with the project's ESP-IDF 6.1 environment. The following examples build only; select the correct board, port, wiring, and configuration before flashing.

sh
# C6 BLE + ESP-NOW test configuration
cd examples/c6_s3_sensor_bridge/c6
idf.py -B build-ble -D SDKCONFIG=sdkconfig.ble build
sh
# S3 composite receiver — run from the repository root
cd examples/c6_s3_sensor_bridge/s3_composite
idf.py set-target esp32s3
idf.py build

The experimental MOSFET build uses a separate power configuration and requires the correct physical switching circuit; see the bridge README before using it. The standard build should not be assumed to have the same gate configuration as the test board.

For the macOS app, see the Studio README. The current local build script targets macOS 26 and expects a configured ESP-IDF Python environment; it is not yet a signed, notarized general distribution.

Known limitations

  • ESP-NOW uses broadcast frames without authenticated encryption; CRC and source MAC checks do not authenticate senders. BLE encrypts links with bonded Just Works pairing, which does not provide MITM authentication.
  • The S3 reports up to six ordinary keyboard keys at once; native analog gamepad output and physical encoder HID are unfinished.
  • Some preset actions require explicit shortcut setup in the target program. Encoder presets and game-mode previews must not be mistaken for completed hardware behavior.
  • The MOSFET status in Studio reports software commands. Actual sensor-rail behavior and power consumption still need electrical measurement.
  • Hardware, firmware, app, and documentation are evolving; verify the specific test configuration before relying on a feature.

Versioning and releases

C6 firmware, S3 firmware, and Studio use separate version numbers and GitHub releases. See release notes, versions, and the developer handoff. Published tags are immutable. Initial releases are pre-releases; the Studio source currently has machine-specific runtime paths, so a portable binary is not claimed.

License

The project is distributed under the GNU General Public License, version 3 (GPL-3.0-only), unless a file or third-party component specifies different terms. GPLv3 permits commercial use subject to its conditions, including source availability when applicable; no separate commercial permission is required.

Some files carry explicit MIT / MIT-only notices and remain available under those terms (MIT license text). Previously published MIT versions and rights granted under them are unaffected. Third-party components retain their own licenses.

Parts

165
QtyValueFootprintReferences
300.1uCapacitor_SMD:C_0603_1608Metric_Pad1.08x0.95mm_HandSolderC11, C20, C21, C22, C23, C24, C25, C26, C27, C28, C29, C30, C31, C36, C37, C38 +14
1447KResistor_SMD:R_0603_1608Metric_Pad0.98x0.95mm_HandSolderR7, R8, R9, R10, R11, R12, R13, R14, R15, R16, R17, R18, R25, R26
121.25Uafadfsfaf:switchsocketMX1, MX2, MX3, MX4, MX5, MX6, MX7, MX8, MX9, MX10, MX11, MX12
12DRV5055A4Package_TO_SOT_SMD:SOT-23_HandsolderingU15, U16, U17, U18, U19, U20, U21, U22, U23, U24, U25, U26
12SK6812MINILED_SMD:LED_SK6812MINI_PLCC4_3.5x3.5mm_P1.75mmNEO1, NEO2, NEO3, NEO4, NEO5, NEO6, NEO7, NEO8, NEO9, NEO10, NEO11, NEO12
12TCS40DLRPackage_TO_SOT_SMD:SOT-23_HandsolderingU2, U3, U4, U5, U6, U7, U8, U9, U10, U11, U12, U13
1110KResistor_SMD:R_0603_1608Metric_Pad0.98x0.95mm_HandSolderR6, R19, R20, R23, R24, R31, R32, R34, R39, R42, R43
6BAT54APackage_TO_SOT_SMD:SOT-23_HandsolderingD1, D2, D3, D4, D5, D6
5LEDLED_SMD:LED_0603_1608MetricD7, D8, D9, D10, D11
4270RResistor_SMD:R_0603_1608Metric_Pad0.98x0.95mm_HandSolderR40, R41, R44, R45
3100KResistor_SMD:R_0603_1608Metric_Pad0.98x0.95mm_HandSolderR30, R36, R38
2100RResistor_SMD:R_0603_1608Metric_Pad0.98x0.95mm_HandSolderR27, R37
210nCapacitor_SMD:C_0603_1608Metric_Pad1.08x0.95mm_HandSolderC9, C10
210uCapacitor_SMD:C_0805_2012Metric_Pad1.18x1.45mm_HandSolderC15, C16
22.2uCapacitor_SMD:C_0603_1608Metric_Pad1.08x0.95mm_HandSolderC12, C14
22.2uFCapacitor_SMD:C_0603_1608Metric_Pad1.08x0.95mm_HandSolderC32, C33
222uCapacitor_SMD:C_0603_1608Metric_Pad1.08x0.95mm_HandSolderC17, C18
25,1KResistor_SMD:R_0603_1608Metric_Pad0.98x0.95mm_HandSolderR21, R22
2AO3400APackage_TO_SOT_SMD:SOT-23Q3, Q4
2SN74HC165PWRSN74HC165PWR:SOP65P640X120-16NU29, U30
11.5KResistor_SMD:R_0603_1608Metric_Pad0.98x0.95mm_HandSolderR33
11.5u1269AS-H-1R5M_P2:INDC2520X100NL3
110uCapacitor_SMD:C_0603_1608Metric_Pad1.08x0.95mm_HandSolderC19
118650 Li-ion (3.7V-4.2V)648102131822:648102131822J1
11KResistor_SMD:R_0603_1608Metric_Pad0.98x0.95mm_HandSolderR28
12.2ufssffff:SRN4030HA2R2YL2
120KResistor_SMD:R_0603_1608Metric_Pad0.98x0.95mm_HandSolderR29
147nCapacitor_SMD:C_0603_1608Metric_Pad1.08x0.95mm_HandSolderC13
1750KResistor_SMD:R_0603_1608Metric_Pad0.98x0.95mm_HandSolderR35
1AO3401APackage_TO_SOT_SMD:SOT-23_HandsolderingQ1
1AP2112KAP2112K_3_3TRG1:SOT95P285X140-5NU36
1BQ25300RTERssfsf:QFN50P300X300X80-17N-DZ1
1Boot_bttnButton_Switch_SMD:SW_Push_1P1T_NO_CK_KMR2SW1
1CD74HC4067SMPackage_SO:SSOP-24_5.3x8.2mm_P0.65mmU28
1DW01APackage_TO_SOT_SMD:SOT-23-6U32
1ESP32-C6-MINI-1RF_Module:ESP32-C6-MINI-1U27
1EncoderConnector_JST:JST_ZH_B4B-ZR-SM4-TF_1x04-1MP_P1.50mm_VerticalJ3
1LOGOLOGO
1Lay_buttonButton_Switch_Keyboard:SW_Cherry_MX_1.00u_PCBSW2
1MCP3202Package_SO:SOIC-8_3.9x4.9mm_P1.27mmU35
1Reset_bttnButton_Switch_SMD:SW_Push_1P1T_NO_CK_KMR2SW3
1SN74AHCT1G125DCKRafadfsfaf:DCK5U34
1SN74HC595DRSN74HC595DR:SOIC127P600X175-16NU14
1TPS61023DRLRTPS61023DRLR:SOT563-ORIU33
1USBLC6-2SC6Package_TO_SOT_SMD:SOT-23-6U31
1USB_C_Receptacle_USB2.0_16PConnector_USB:USB_C_Receptacle_GCT_USB4110J2

Similar boards

  • 2 layers48.6 × 59.3 mmAbdotrope, the printed circuit board in 3D

    Abdotrope

    Victor-Field/Andotrope

    DIY open source andotrope

    31 parts2
  • 2 layers181.6 × 172.3 mmPMK Keyboard, the printed circuit board in 3D

    PMK Keyboard

    PumaFPV/PMK

    PMK - Full wireless split keyboard

    151 parts4MIT
  • 4 layers233.4 × 147.3 mmOpenPLC Hardware, the printed circuit board in 3D

    OpenPLC Hardware

    gasiepgodoy/Open-Source-PLC

    Open Source Programmable Logic Controller (Hardware and Software). Based on the Master of Science in Electrical Engineering of João Vitor Rocha Santana

    494 parts2
  • 2 layers85 × 85 mmCore64c LB, the printed circuit board in 3D

    Core64c LB

    ageppert/Core-64c-Compact-Interactive-Core-Memory-Badge

    64 bits of core memory and LEDs to interact with directly using a magnetic wand.

    162 parts1GPL-3.0
  • 2 layers100 × 100 mmPCB SALUS v3, the printed circuit board in 3D

    PCB SALUS v3

    LeoSole423/PCB_SALUS_V3

    PCB de control para el robot Ackermann SALUS. Esta revision se inspira en la arquitectura de Hoja-Base, pero usa un ESP32-S3 y se mantiene como un diseno independiente.

    91 parts
  • 2 layers5.1 × 12.2 mmKeychaingame, the printed circuit board in 3D

    Keychaingame

    pollend/keychaingame

    28 parts
  • 2 layers85 × 170 mmCore64 LB, the printed circuit board in 3D

    Core64 LB

    ageppert/Core-64-Interactive-Core-Memory-Badge

    64 bits of core memory and LEDs to interact with directly using a magnetic wand.

    194 parts17GPL-3.0
  • 2 layers32 × 74 mmVenturi Remote, the printed circuit board in 3D

    Venturi Remote

    David207025/Venturi

    Highly optimized line follower robot controlled by the ESP32-S31-WROOM-3 module

    38 parts

Questions

How big is the Macropad PCB?

It measures 65 × 100 mm and has 4 copper layers, 1.6 mm thick.

What parts does the Macropad use?

165 parts, built around the SN74AHCT1G125DCKR(LX), TCS40DLR,LF, MCP3202-CI/P and SN74HC165PWRG3. 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 Macropad KiCad files?

From the mcskny/wireless-he-macropad repository on GitHub, at the commit this page was made from: the board is Hardware/Kicad/macropad.kicad_pcb and its schematic Hardware/Kicad/macropad.kicad_sch. PCBKit opens the board in the browser, with nothing to install.

Can I use the Macropad 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).