Skip to the content
2 layers77.5 × 61 mmMacropad, the printed circuit board in 3D

hall effect split keyboard based on the redox layout with custom firmware

Size
77.5 × 61 mm
Copper layers
2
Thickness
1.6 mm
Parts
45
Nets
91
Pads
255
Tracks, vias
591, 100
Pours
1
Routed
Yes
KiCad
KiCad 7 (file 20221018)
Created
7 Mar 2026
Updated
2 Nov 2026

Overview

Macropad is an open-source printed circuit board by maxaudron, from the maxaudron/woodox repository on GitHub. It is a 2-layer board of 77.5 × 61 mm with 45 parts on 91 nets, routed with 591 tracks and 100 vias.

It is built around the RP2040, CD74HC4067SM96E4 and NCP1117LPST33T3G-MS, with the SK6812MINI-E, MSAST105SB7104KFNB25 and RCC06031K00FKEA among its other parts. Its parts include 13 ICs, 10 capacitors, 8 resistors, 8 diodes and 2 connectors. It belongs with the keyboards and input boards and the RP2040 boards of this library.

Main components

12

README

README.md

Woodox Firmware

Embedded Rust firmware for an analog hall-effect keyboard, targeting the RP2040 (Cortex-M0+). Runs bare-metal with no_std.

Architecture

The firmware runs on both RP2040 cores simultaneously. Core 1 continuously scans hall-effect switches through analog multiplexers and ADC. Core 0 runs the USB HID stack and sends keyboard reports to the host at 1ms intervals. Switch state is shared between cores via static global memory, avoiding lock overhead.

Workspace

The project is split into two crates:

board

Hardware-specific code that directly interfaces with RP2040 peripherals.

  • main.rs -- Entry point. Initializes clocks, GPIO pins, ADC, multiplexers, and the USB bus. Spawns the scan loop on core 1 and the USB loop on core 0.
  • scan.rs -- Scan loop running on core 1. Iterates through all multiplexer channels, reads ADC values for each switch, and updates switch state.
  • usb.rs -- USB loop running on core 0. Reads the global keyboard state every 1ms and sends NKRO HID reports to the host.
  • hardware/mux.rs -- Driver for the CD74HC4067 16-channel analog multiplexer. Selects channels by setting four GPIO pins to the binary representation of the channel number.
  • hardware/adc.rs -- Trait and implementation for reading raw values from the RP2040 ADC. Supports reading a single channel or all multiplexer inputs in sequence.
  • dma.rs -- Work-in-progress DMA configuration for ADC transfers. Not currently used in the main loop.
  • led/mod.rs -- Commented-out WS2812 LED driver using PIO. Not currently active.

library (woodox-lib)

Platform-independent logic. Can be tested on the host machine.

  • matrix/switch.rs -- Core switch logic. Each switch tracks its position, press/release state, and hold timing. Supports configurable actuation and release points. Implements rapid trigger, which dynamically fires press/release events based on relative travel distance rather than fixed thresholds.
  • matrix/hall.rs -- Lookup table that converts raw 8-bit ADC values to physical travel distance in 0.1mm increments, based on the hall-effect sensor response curve.
  • matrix/keys.rs -- Global keymap and keyboard state. Defines key types: regular keycodes, layer switching, layer-tap (layer on hold / keycode on tap), key-tap (keycode on hold / different keycode on tap), and grave-escape. Resolves key actions by walking down the layer stack.
  • matrix/mod.rs -- Scan and ScanOrder structs that map physical switch positions (mux ID + channel) to their logical index in the keymap.
  • layout/mod.rs -- Macros (switches!, keymap!, layer!, key!) for declaratively defining keyboard layouts at compile time.
  • layout/macropad.rs -- Default layout for an 8-key macropad with 1 multiplexer. Defines the physical switch wiring and a two-layer keymap.

Hardware

  • MCU: RP2040 (dual Cortex-M0+ at 125 MHz, 12 MHz external crystal)
  • Switches: Analog hall-effect sensors read via ADC
  • Multiplexers: CD74HC4067 (16-channel analog mux), selecting switches for ADC reading
  • USB: Native RP2040 USB with NKRO keyboard HID
  • LEDs: WS2812 via PIO (currently disabled)

Features

  • macropad (default) -- Builds with the 8-key macropad layout.
  • timers -- Enables microsecond-precision scan loop timing via the hardware timer.

Building

Requires the thumbv6m-none-eabi target:

sh
rustup target add thumbv6m-none-eabi
cargo build --release -p woodox

Flashing

Uses probe-run via cargo runner, or cargo-embed with the provided Embed.toml:

sh
cargo embed --release -p woodox

Debugger protocol is SWD at 20 MHz. RTT logging is enabled with defmt output.

Parts

45
QtyValueFootprintReferences
8DRV5056A2lib:DRV505xU2, U3, U4, U5, U7, U8, U10, U11
4MX_SK6812MINI-Elib:LED_MX_SK6812MINI-R_FLIPPEDLED2, LED4, LED6, LED8
4MX_SK6812MINI-Elib:LED_MX_SK6812MINI-RLED1, LED3, LED5, LED7
30.1uFCapacitor_SMD:C_0603_1608MetricC1, C7, C9
31kResistor_SMD:R_0603_1608MetricR1, R3, R8
31uFCapacitor_SMD:C_0603_1608MetricC4, C5, C8
210uFCapacitor_SMD:C_0603_1608MetricC6, C11
227.4Resistor_SMD:R_0603_1608MetricR4, R5
227pFCapacitor_SMD:C_0603_1608MetricC2, C3
25k1Resistor_SMD:R_0603_1608MetricR6, R7
110kResistor_SMD:R_0603_1608MetricR2
1BOOTButton_Switch_SMD:SW_Push_1P1T_NO_Vertical_Wuerth_434133025816SW1
1CD74HC4067SM96E4Package_SO:SSOP-24_5.3x8.2mm_P0.65mmU6
1Conn_01x03_FemaleConnector_PinHeader_2.54mm:PinHeader_1x04_P2.54mm_VerticalJ1
1ECS-120-8-30-JGN-TRCrystal:Crystal_SMD_5032-2Pin_5.0x3.2mmY1
1NCP1117-3.3_SOT223Package_TO_SOT_SMD:SOT-223-3_TabPin2U9
1OLED_256x64_I2Clib:OLED_256x64_I2CU12
1RESETButton_Switch_SMD:SW_Push_1P1T_NO_Vertical_Wuerth_434133025816SW2
1RP2040Package_DFN_QFN:QFN-56-1EP_7x7mm_P0.4mm_EP3.2x3.2mmU1
1USB_C_ReceptacleConnector_USB:USB_C_Receptacle_Amphenol_12401610E4-2AJ2
1W25Q16JVUXIQ_TRW25Q16JVUXIQ_TR:SON50P300X200X60-9NIC1

The 44 most common of 45 parts.

More from maxaudron/woodox

2
  • 4 layers162.2 × 126.5 mmWoodox, the printed circuit board in 3D

    Woodox

    maxaudron/woodox

    hall effect split keyboard based on the redox layout with custom firmware

    233 parts
  • 2 layers162.2 × 126.5 mmWoodox rounded, the printed circuit board in 3D

    Woodox rounded

    maxaudron/woodox

    hall effect split keyboard based on the redox layout with custom firmware

    95 parts

Similar boards

  • 2 layers220 × 20 mmSensorboard, the printed circuit board in 3D

    Sensorboard

    penton1753/knightly

    Assets for Knightly, an automatic chessboard product by Chessington.

    32 parts1CC-BY-SA-4.0
  • 4 layers55.9 × 27.9 mmUART Bus Board V2, the printed circuit board in 3D

    UART Bus Board V2

    mibs510/UART-Bus-Board-V2

    A UART bus to configure MKS SERVO42C closed looped stepper drivers on my 5' x 6.5' laser CNC

    63 partsGPL-3.0
  • 2 layers51 × 18.5 mmEntree, the printed circuit board in 3D

    Entree

    tuna-f1sh/entree

    Entree is a USB-C CAN interface designed to fully support CANnectivity - gets the CAN party started!

    78 parts89
  • 4 layers50 × 16 mmSystem board, the printed circuit board in 3D

    System board

    proegssilb/lightsaber-hardware

    PCBs and other files for lightsaber soundboard hardware.

    72 parts2CERN-OHL-S-2.0
  • 4 layers66.8 × 44 mmTelemetry box 01, the printed circuit board in 3D

    Telemetry box 01

    ZakharSergeevich/telemetry_box_pcb

    76 parts
  • 4 layers82.5 × 82.5 mm1s3p battery board, the printed circuit board in 3D

    1s3p battery board

    stellarcorp/tvsc

    Core software repository for the Tennessee Valley Stellar Corporation

    141 parts1MIT
  • 4 layers77.2 × 86.4 mmMad RP2040, the printed circuit board in 3D

    Mad RP2040

    Cimos/etchy

    Fast, trustworthy PCB visual and geometric diff tool (Rust). Successor to gerber-diff.

    117 parts1Apache-2.0

Questions

How big is the Macropad PCB?

It measures 77.5 × 61 mm and has 2 copper layers, 1.6 mm thick.

What parts does the Macropad use?

45 parts, built around the RP2040, CD74HC4067SM96E4, NCP1117LPST33T3G-MS and SK6812MINI-E. 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 maxaudron/woodox repository on GitHub, at the commit this page was made from: the board is hardware/macropad/macropad.kicad_pcb and its schematic hardware/macropad/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 states no licence, so its author keeps all rights: ask maxaudron before reusing the design.