Skip to the content
4 layers162.2 × 126.5 mmWoodox, the printed circuit board in 3D

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

Size
162.2 × 126.5 mm
Copper layers
4
Thickness
1.58 mm
Parts
233
Nets
310
Pads
1,239
Tracks, vias
3,108, 433
Pours
23
Routed
Yes
KiCad
KiCad 10.0 (file 20260206)
Created
7 Mar 2026
Updated
2 Nov 2026

Overview

Woodox is an open-source printed circuit board by maxaudron, from the maxaudron/woodox repository on GitHub. It is a 4-layer board of 162.2 × 126.5 mm with 233 parts on 310 nets, routed with 3,108 tracks and 433 vias.

It is built around the W25Q128JVPIQ, 74HC4051 and NCP1117LPST33T3G-MS, with the SK6812MINI-E, 95C06B2GWRT and ABM8-272-T3 among its other parts. Its parts include 79 ICs, 64 diodes, 40 capacitors, 22 resistors and 12 connectors. It belongs with the keyboards and input boards and the RP2350 boards of this library.

Main components

7

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

233
QtyValueFootprintReferences
64DRV5057A3lib:DRV505xU1, U2, U11, U12, U13, U14, U15, U16, U17, U18, U19, U20, U21, U22, U23, U24 +48
64MX_SK6812MINI-Elib:LED_MX_SK6812MINI-RLED1, LED2, LED10, LED11, LED12, LED13, LED14, LED15, LED16, LED17, LED18, LED19, LED20, LED21, LED22, LED23 +48
24100nCapacitor_SMD:C_0402_1005MetricC4, C15, C18, C19, C23, C26, C27, C32, C33, C34, C35, C36, C37, C38, C39, C44 +8
874HC4051Package_SO:TSSOP-16_4.4x5mm_P0.65mmU34, U35, U36, U37, U73, U74, U75, U76
8SolderJumper_2_OpenJumper:SolderJumper-2_P1.3mm_Open_Pad1.0x1.5mmJP1, JP2, JP3, JP4, JP5, JP6, JP7, JP8
61kResistor_SMD:R_0402_1005MetricR1, R2, R12, R16, R21, R23
410uFCapacitor_SMD:C_0402_1005MetricC6, C10, C16, C20
415pCapacitor_SMD:C_0402_1005MetricC40, C41, C42, C43
427Resistor_SMD:R_0402_1005MetricR24, R25, R27, R28
44.7uCapacitor_SMD:C_0402_1005MetricC14, C17, C24, C25
44.7uRP2350_80QFN_minimal:C_0402_1005Metric_small_padsC12, C13, C21, C22
456kResistor_SMD:R_0402_1005MetricR17, R18, R19, R20
45k1Resistor_SMD:R_0402_1005MetricR6, R7, R14, R15
4Conn_01x01MountingHole:MountingHole_3.2mm_M3_DIN965_PadJ9, J10, J11, J12
4SW_PushButton_Switch_SMD:SW_Push_1P1T_NO_Vertical_Wuerth_434133025816SW1, SW2, SW3, SW4
23.3uRP2350_80QFN_minimal:L_pol_2016L2, L3
233Resistor_SMD:R_0402_1005MetricR22, R26
2ABM8-272-T3Crystal:Crystal_SMD_3225-4Pin_3.2x2.5mmY2, Y3
2Conn_01x03_Femalelib:TestPad_3pinsJ1, J3
2Conn_01x05_Socketlib:TestPad_5pinsJ5, J8
2DNFResistor_SMD:R_0402_1005MetricR11, R13
2NCP1117-3.3_SOT223Package_TO_SOT_SMD:SOT-223-3_TabPin2U33, U72
2RP2350_80QFNRP2350_80QFN_minimal:RP2350-QFN-80-1EP_10x10_P0.4mm_EP3.4x3.4mm_ThermalViasU64, U79
2USB_C_InterlinkConnector_USB:USB_C_Receptacle_Amphenol_12401610E4-2AJ6, J7
2USB_C_To_HostConnector_USB:USB_C_Receptacle_Amphenol_12401610E4-2AJ2, J4
2W25Q128JVPPackage_SON:WSON-8-1EP_6x5mm_P1.27mm_EP3.4x4.3mmU25, U49
1OLED_256x64_I2Clib:OLED_256x64_I2CU10

More from maxaudron/woodox

2
  • 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
  • 2 layers77.5 × 61 mmMacropad, the printed circuit board in 3D

    Macropad

    maxaudron/woodox

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

    45 parts

Similar boards

  • 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 layers277.2 × 107.5 mmKatia, the printed circuit board in 3D

    Katia

    ikajdan/katia

    A split keyboard with 6 by 3 column staggered keys and 3 thumb keys, based on the Crkbrd design

    230 parts33CERN-OHL-P-2.0
  • 4 layers213.7 × 140.6 mmMSCKee, the printed circuit board in 3D

    MSCKee

    Creative-Difficulty/mSCKee

    Split Keyboard for Hack Club Outpost with dual light sensors, per-key addressable backlighting, integrated RP2040 MCU

    205 parts1

Questions

How big is the Woodox PCB?

It measures 162.2 × 126.5 mm and has 4 copper layers, 1.58 mm thick.

What parts does the Woodox use?

233 parts, built around the W25Q128JVPIQ, 74HC4051, 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 Woodox KiCad files?

From the maxaudron/woodox repository on GitHub, at the commit this page was made from: the board is hardware/woodox/woodox.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 Woodox design in my own project?

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