
Woodox rounded
maxaudron/woodox
hall effect split keyboard based on the redox layout with custom firmware

hall effect split keyboard based on the redox layout with custom firmware
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.
Embedded Rust firmware for an analog hall-effect keyboard, targeting the RP2040 (Cortex-M0+). Runs bare-metal with no_std.
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.
The project is split into two crates:
boardHardware-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.macropad (default) -- Builds with the 8-key macropad layout.timers -- Enables microsecond-precision scan loop timing via the hardware timer.Requires the thumbv6m-none-eabi target:
rustup target add thumbv6m-none-eabi
cargo build --release -p woodoxUses probe-run via cargo runner, or cargo-embed with the provided Embed.toml:
cargo embed --release -p woodoxDebugger protocol is SWD at 20 MHz. RTT logging is enabled with defmt output.
| Qty | Value | Footprint | References |
|---|---|---|---|
| 64 | DRV5057A3 | lib:DRV505x | U1, U2, U11, U12, U13, U14, U15, U16, U17, U18, U19, U20, U21, U22, U23, U24 +48 |
| 64 | MX_SK6812MINI-E | lib:LED_MX_SK6812MINI-R | LED1, LED2, LED10, LED11, LED12, LED13, LED14, LED15, LED16, LED17, LED18, LED19, LED20, LED21, LED22, LED23 +48 |
| 24 | 100n | Capacitor_SMD:C_0402_1005Metric | C4, C15, C18, C19, C23, C26, C27, C32, C33, C34, C35, C36, C37, C38, C39, C44 +8 |
| 8 | 74HC4051 | Package_SO:TSSOP-16_4.4x5mm_P0.65mm | U34, U35, U36, U37, U73, U74, U75, U76 |
| 8 | SolderJumper_2_Open | Jumper:SolderJumper-2_P1.3mm_Open_Pad1.0x1.5mm | JP1, JP2, JP3, JP4, JP5, JP6, JP7, JP8 |
| 6 | 1k | Resistor_SMD:R_0402_1005Metric | R1, R2, R12, R16, R21, R23 |
| 4 | 10uF | Capacitor_SMD:C_0402_1005Metric | C6, C10, C16, C20 |
| 4 | 15p | Capacitor_SMD:C_0402_1005Metric | C40, C41, C42, C43 |
| 4 | 27 | Resistor_SMD:R_0402_1005Metric | R24, R25, R27, R28 |
| 4 | 4.7u | Capacitor_SMD:C_0402_1005Metric | C14, C17, C24, C25 |
| 4 | 4.7u | RP2350_80QFN_minimal:C_0402_1005Metric_small_pads | C12, C13, C21, C22 |
| 4 | 56k | Resistor_SMD:R_0402_1005Metric | R17, R18, R19, R20 |
| 4 | 5k1 | Resistor_SMD:R_0402_1005Metric | R6, R7, R14, R15 |
| 4 | Conn_01x01 | MountingHole:MountingHole_3.2mm_M3_DIN965_Pad | J9, J10, J11, J12 |
| 4 | SW_Push | Button_Switch_SMD:SW_Push_1P1T_NO_Vertical_Wuerth_434133025816 | SW1, SW2, SW3, SW4 |
| 2 | 3.3u | RP2350_80QFN_minimal:L_pol_2016 | L2, L3 |
| 2 | 33 | Resistor_SMD:R_0402_1005Metric | R22, R26 |
| 2 | ABM8-272-T3 | Crystal:Crystal_SMD_3225-4Pin_3.2x2.5mm | Y2, Y3 |
| 2 | Conn_01x03_Female | lib:TestPad_3pins | J1, J3 |
| 2 | Conn_01x05_Socket | lib:TestPad_5pins | J5, J8 |
| 2 | DNF | Resistor_SMD:R_0402_1005Metric | R11, R13 |
| 2 | NCP1117-3.3_SOT223 | Package_TO_SOT_SMD:SOT-223-3_TabPin2 | U33, U72 |
| 2 | RP2350_80QFN | RP2350_80QFN_minimal:RP2350-QFN-80-1EP_10x10_P0.4mm_EP3.4x3.4mm_ThermalVias | U64, U79 |
| 2 | USB_C_Interlink | Connector_USB:USB_C_Receptacle_Amphenol_12401610E4-2A | J6, J7 |
| 2 | USB_C_To_Host | Connector_USB:USB_C_Receptacle_Amphenol_12401610E4-2A | J2, J4 |
| 2 | W25Q128JVP | Package_SON:WSON-8-1EP_6x5mm_P1.27mm_EP3.4x4.3mm | U25, U49 |
| 1 | OLED_256x64_I2C | lib:OLED_256x64_I2C | U10 |

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

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

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

proegssilb/lightsaber-hardware
PCBs and other files for lightsaber soundboard hardware.



stellarcorp/tvsc
Core software repository for the Tennessee Valley Stellar Corporation

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

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

It measures 162.2 × 126.5 mm and has 4 copper layers, 1.58 mm thick.
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.
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.
Its repository states no licence, so its author keeps all rights: ask maxaudron before reusing the design.