Skip to the content
2 layers35 × 57 mmDyad controller, the printed circuit board in 3D

Dyad controller

bathoorn/dyad-keyboard

Split keyboard: KiCad PCB, 3D-printed case, QMK firmware. Rotary encoder ring per half — round display left, Cirque trackpad right. Bare RP2040 per side.

Size
35 × 57 mm
Copper layers
2
Thickness
1.6 mm
Parts
44
Nets
72
Pads
283
Tracks, vias
1,019, 244
Pours
2
Routed
Yes
KiCad
KiCad 10.0 (file 20260206)
Created
6 Sep 2026
Updated
9 Oct 2026

Overview

Dyad controller is an open-source printed circuit board by bathoorn, from the bathoorn/dyad-keyboard repository on GitHub, published under the MIT licence. It is a 2-layer board of 35 × 57 mm with 44 parts on 72 nets, routed with 1,019 tracks and 244 vias.

It is built around the RP2040, W25Q128JVSIQ and USBLC6-2SC6, with the HC-FPC-0.5-20P-FH20, HC-FPC-0.5-14P-FH20 and SS34 among its other parts. Its parts include 17 capacitors, 7 resistors, 6 connectors, 4 ICs and 2 switches. It belongs with the keyboards and input and lEDs and displays boards and the RP2040 boards of this library.

Main components

6

README

README.md

Dyad

A split keyboard with a rotary encoder ring on each half — a round display inside the left ring, a circular trackpad inside the right. Custom PCBs in KiCad, a 3D-printed case, running QMK.

Dyad: a pair. Two halves, two dials, two boards.

Layout

69 keys, 32 left and 37 right, row-staggered. Bare RP2040 on each side.


The idea that makes it work

"A display on top of a knob" normally means the display rotates, which needs a slip ring or a wire loom that survives unlimited rotation.

Dyad inverts it. The display and trackpad are static; the ring rotates around them. A fixed centre post rises through the bearing bore and cantilevers the sensor above the moving parts, so no wire ever moves. Visually and ergonomically it reads as a knob with a screen on top — electrically it's a static part with a ring turning beneath it.

Both rings are 50 mm outside diameter, so the halves are a matched pair.

Hardware

MCUBare RP2040, one shared controller module used by both halves
Left podGC9A01 1.28" round LCD, 240×240, SPI
Right podCirque Pinnacle TM040040, 40 mm
EncodersEC11, driven by a ring gear from the rotating ring
SwitchesMX hot-swap, Kailh sockets
Per-key RGBSK6812MINI-E — footprints fitted, populated only if wanted
Split linkUSB-C to USB-C, half-duplex serial

Four board designs: one controller module (the only board needing an assembly service), two asymmetric main PCBs, and two knob-module variants.

Status

PhaseState
0 — LayoutDone. Validated against printed 1:1 mock-ups.
1 — Bench bring-upPartial. Toolchain, flashing, encoder and Cirque all pass. Display, ribbon-SPI, split and current tests await parts.
2 — Knob mechanismNot started.
3 — KiCadMain PCBs generated and placed; controller pin assignment and BOM settled.
4 — CaseNot started. Board outlines and plate cutouts exported for it.

The main PCBs are a placement scaffold, not a finished layout. DRC reports 195 violations on the left and 253 on the right, none electrical (shorts, clearance, mask bridges). The 32 and 37 errors are all diode/switch courtyard overlaps from the deliberate diode-under-switch placement; the rest is silkscreen. Routing is incomplete, notably the angled thumb keys.

Repository

text
docs/          PLAN.md, WORKFLOW.md, CONTROLLER.md, PHASE1.md, TOOLS.md,
               GIT.md, plus printable 1:1 mock-ups
hardware/
  interface.yaml   the contract between the PCB and case designs
  layout/          KLE source of truth, parser, pod-placement solver
  pcb-main-*/      the two main PCBs (generated)
  pcb-controller/  controller module, and the vendored RP2040 reference
  outlines/        board outlines, plate cutouts and STEP, for the case
firmware/      QMK external userspace

Nearly everything under hardware/ is generated from the KLE layout. Regenerate with hardware/generate_main_pcbs.py, export_outlines.py and export_plate.py — see docs/TOOLS.md for the environment they need.

Building the firmware

bash
qmk config user.qmk_home=~/qmk_firmware
qmk config user.overlay_dir=$PWD/firmware
ln -sfn $PWD/firmware/keyboards/dyad ~/qmk_firmware/keyboards/dyad
qmk compile -kb dyad/split -km default

The symlink is required: QMK's external userspace holds keymaps and build targets, but not keyboards.

dyad/proto and dyad/split are Phase 1 bring-up targets for dev boards, not the shipping keyboard definition.

Documentation

  • PLAN.md — the full design, decisions and rationale
  • WORKFLOW.md — how the case and PCBs are co-designed without deadlocking
  • CONTROLLER.md — controller pin assignment, BOM and build steps
  • PHASE1.md — bench bring-up, with results
  • TOOLS.md — toolchain, and the traps found in it
  • GIT.md — feature branches, and why KiCad files change how git is used here

Licence

MIT — see LICENSE.

hardware/pcb-controller/upstream/ vendors RP2040-designguide (MIT, © 2021 Sleepdealer) as a read-only reference. The key layout originates from the Hasukey KLE layout.

Parts

44
QtyValueFootprintReferences
10100nFCapacitor_SMD:C_0402_1005MetricC1, C5, C6, C9, C10, C11, C12, C13, C14, C15
41uFCapacitor_SMD:C_0402_1005MetricC4, C8, C16, C17
4MountingHole_2.2mm_M2_PadMountingHole:MountingHole_2.2mm_M2_PadH1, H2, H3, H4
31kResistor_SMD:R_0402_1005MetricR1, R2, R7
215pFCapacitor_SMD:C_0402_1005MetricC2, C3
227RResistor_SMD:R_0603_1608MetricR5, R6
2500mAFuse:Fuse_1206_3216MetricF1, F2
25k1Resistor_SMD:R_0402_1005MetricR3, R4
2HC-FPC-0.5-20P-FH20dyad:FPC-SMD_20P-P0.50_HC-FPC-0.5-20P-FH20J6, J7
2USB-C split linkdyad:USB_C_Receptacle_HRO_TYPE-C-31-M-12J9, J10
110uFCapacitor_SMD:C_0402_1005MetricC7
112MHzCrystal:Crystal_SMD_3225-4Pin_3.2x2.5mmY1
1BOOTSELButton_Switch_SMD:SW_Push_1P1T_XKB_TS-1187ASW1
1HC-FPC-0.5-14P-FH20dyad:FPC-SMD_14P-P0.50_HC-FPC-0.5-14P-FH20J8
1RESETButton_Switch_SMD:SW_Push_1P1T_XKB_TS-1187ASW2
1RP2040Sleep-Lib:RP2040-QFN-56U3
1SS34Diode_SMD:D_SMAD1
1USBLC6-2SC6Package_TO_SOT_SMD:SOT-23-6U2
1USB_C_Receptacle_USB2.0dyad:USB_C_Receptacle_HRO_TYPE-C-31-M-12J1
1W25Q128JVSPackage_SO:SOIC-8_5.23x5.23mm_P1.27mmU1
1XC6206PxxxMR-Regulator_LinearPackage_TO_SOT_SMD:SOT-23U4

More from bathoorn/dyad-keyboard

2
  • 2 layers167.2 × 120.7 mmDyad main right, the printed circuit board in 3D

    Dyad main right

    bathoorn/dyad-keyboard

    Split keyboard: KiCad PCB, 3D-printed case, QMK firmware. Rotary encoder ring per half — round display left, Cirque trackpad right. Bare RP2040 per side.

    149 partsMIT
  • 2 layers149 × 120.7 mmDyad main left, the printed circuit board in 3D

    Dyad main left

    bathoorn/dyad-keyboard

    Split keyboard: KiCad PCB, 3D-printed case, QMK firmware. Rotary encoder ring per half — round display left, Cirque trackpad right. Bare RP2040 per side.

    129 partsMIT

Similar boards

  • 2 layers70 × 70 mm3300 board v1, the printed circuit board in 3D

    3300 board v1

    Lake0049/3300_Spider_truck

    HI

    104 parts
  • 4 layers93.5 × 118.6 mmRD56, the printed circuit board in 3D

    RD56

    lhm0/rotating_display_color

    56 LED rotating color display with RP2040 and ESP32 microcontrollers

    266 parts25
  • 4 layers92 × 56 mmREIN R1, the printed circuit board in 3D

    REIN R1

    rein-baremetal/REIN_R1_KiCad

    Dual-MCU baremetal embedded development board featuring high-speed QSPI storage, hardware USB hub, and flexible power management. Open for PCB trace routing collaboration

    177 parts2
  • 4 layers76 × 50 mmWigglecam, the printed circuit board in 3D

    Wigglecam

    jadenrhee/wigglecam-controller

    RP2040 co-processor board for a 4-lens wigglegram camera: constant-current flash, controls, battery telemetry, Pi 5 I2C interface. 4-layer, DRC-clean, fab-ready.

    105 parts
  • 2 layers163.7 × 124.3 mmMicro PowerModule, the printed circuit board in 3D

    Micro PowerModule

    yingchaotw/micro_PowerModule

    µPower Supply Module

    235 parts1GPL-3.0
  • 2 layers114.3 × 25.4 mmIr transmitter, the printed circuit board in 3D

    Ir transmitter

    adeboni/electronics

    This repository stores code for various electronics projects I've made

    92 parts
  • 2 layers95.5 × 99 mmMacropad, the printed circuit board in 3D

    Macropad

    devramsean0/copperkeyboard

    My WIP Mechanical Keyboard

    88 parts
  • 4 layers50 × 58.9 mmCombo lock cracker, the printed circuit board in 3D

    Combo lock cracker

    ShaanJ1/combo-lock-breaker

    A device that goes through every single combination to find the correct code for your lock

    60 parts

Questions

How big is the Dyad controller PCB?

It measures 35 × 57 mm and has 2 copper layers, 1.6 mm thick.

What parts does the Dyad controller use?

44 parts, built around the RP2040, W25Q128JVSIQ, USBLC6-2SC6 and HC-FPC-0.5-20P-FH20. 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 Dyad controller KiCad files?

From the bathoorn/dyad-keyboard repository on GitHub, at the commit this page was made from: the board is hardware/pcb-controller/dyad-controller.kicad_pcb and its schematic hardware/pcb-controller/dyad-controller.kicad_sch. PCBKit opens the board in the browser, with nothing to install.

Can I use the Dyad controller design in my own project?

Its repository publishes it under the MIT licence: you may reuse it on that licence's terms (keep the author's notice, and for a copyleft licence share your changes alike).