Skip to the content
2 layers172.3 × 140.7 mmPcb keyboard left, the printed circuit board in 3D

My second custom split keyboard: qmk firmware, pcb, 3d files

Size
172.3 × 140.7 mm
Copper layers
2
Thickness
1.6 mm
Parts
134
Nets
131
Pads
870
Tracks, vias
1,129, 203
Pours
78
Routed
Yes
KiCad
KiCad 8.0 (file 20240108)
Created
10 Jun 2025
Updated
8 Feb 2026

Overview

Pcb keyboard left is an open-source printed circuit board by Gabriele-tomai00, from the Gabriele-tomai00/split_keyboard_2_qmk_pcb repository on GitHub. It is a 2-layer board of 172.3 × 140.7 mm with 134 parts on 131 nets, routed with 1,129 tracks and 203 vias.

It is built around the 74LVC1G34Z. Its parts include 70 diodes, 35 switches, 4 connectors and 2 ICs. It belongs with the keyboards and input boards and the RP2040 boards of this library.

Main components

1

README

README.md

SPLIT KEYBOARD (my second version)

This project details the design and construction of my first custom split keyboard. The build features a custom PCB, hand-soldered components, and a 3D-printed case, all powered by the Raspberry Pi Pico and QMK firmware.

Key Features:

  • Microcontroller: Raspberry Pi Pico (RP2040)
  • Firmware: QMK with Vial GUI support
  • Switches: Hot-swappable MX switches
  • Displays: OLED status screens
  • Input: Rotary encoders
  • Interconnect: RJ11 cabling for safe hot-plugging

The layout is a traditional row-staggered design (non-ortholinear) with ergonomic enhancements:

  • Inner Macro Keys: 3 extra keys on the inner side of the right half.
  • Thumb Cluster: 2 low-profile keys under each spacebar, primarily used as layer modifiers.

Acknowledgments: Special thanks to the QMK and Vial communities, and the authors of the Sofle Pico keyboard, whose work provided invaluable inspiration and knowledge.

Repository Structure

  • /3d_images: 3D design files (STL) created with Autodesk Fusion 360
  • /images: Photographic documentation of the keyboard assembly and final build.
  • /kicad: Electrical schematics and PCB layout designs developed in KiCad, ready for fabrication.
  • /vial-qmk: Source code for the QMK-based firmware with Vial GUI support.
  • /vial_config.vil: Vial configuration file (you can upload this file to Vial to configure the keyboard).
  • /perimeter_right.dxf and /perimeter_left.dxf: DXF files for the right and left half PCB perimeter (used to cut the PCB).

Components List

  • Custom PCBs (Left & Right)
  • 2x Raspberry Pi Pico
  • 1N4148 Diodes
  • Kailh Hot-swap Sockets
  • SK6812MINI-E SMD LEDs
  • EC11 Rotary Encoders
  • 0.91" I2C OLED Displays
  • RJ11 Jacks (6P6C or similar)
  • Brass Standoffs (M2)

Features & Implementation

Layout & Ergonomics

The keyboard deviates slightly from a standard 60% ANSI layout to accommodate split ergonomics. It combines standard MX switches with low-profile switches for the thumb cluster to reduce strain. The extra macro keys on the left half provide quick access to custom functions.

Software (QMK & Vial)

The keyboard runs on QMK firmware and is fully compatible with Vial. This allows for real-time configuration via a graphical interface without re-flashing. Users can program:

  • Layers: Toggle between different keymaps (e.g., QWERTY, navigation, numpad).
  • Macros: Automate complex key sequences.
  • Tap Dance: Assign different actions to a key based on how many times it is tapped.
Vial Interface

Rotary Encoders (EC11)

The keyboard utilizes EC11 rotary encoders. In the QMK ecosystem, encoders provide a fluid input method distinct from binary key presses. They are ideal for continuous values like volume control, page scrolling, or history navigation.

OLED Displays

Each half is equipped with an OLED display connected via the I2C protocol.

OLED Display

RGB Backlighting (SK6812MINI-E)

The PCB features per-key RGB backlighting using SK6812MINI-E LEDs.

  • Technology: These addressable "reverse-mount" LEDs sit within PCB cutouts, shining upwards through the switch housing.
  • Effects: Powered by QMK's RGB Matrix system, the keyboard supports vast lighting animations, reactive typing effects, and layer-specific color coding (e.g., turning the keyboard red when on the "Function" layer).
PCB LED Backlighting

Hardware Details

Microcontroller: Raspberry Pi Pico (RP2040)

I selected the Raspberry Pi Pico for this build due to its generous GPIO count compared to the Pro Micro. With 26 usable GPIO pins, the RP2040 handles the matrix, encoders, OLEDs, and RGB data lines directly, simplifying the PCB design.

Split Connection: UART via RJ11

Communication between the two halves uses Full Duplex UART over an RJ11 cable (inspired by the Ultimate Hacking Keyboard).

  • Why RJ11?: Unlike the common TRRS (Aux) cables used in many split keyboards, RJ11 connectors do not short pins momentarily during insertion or removal. This design choice eliminates the risk of shorting VCC to GND while the keyboard is powered.
RJ11 Socket

I constructed a custom cable using 4-pin RJ11 connectors (6P4C) attached to a 4-core wire. It is crucial to ensure the connectors support at least 4 pins, avoiding the common 2-pin variants typically used for telephone lines in Italy.

USB Type-C Connectivity

Each keyboard half features a dedicated USB Type-C port for computer connectivity. I chose this standard for its versatility and widespread adoption. The port is distinct from the inter-half connection to prevent accidental mismatches. Either half can be connected to the host computer. I referenced the Raspberry Pi Pico datasheet to correctly wire the external USB-C breakout board to the microcontroller, ensuring the Pico detects the external connection as its primary USB interface.

Key Matrix Wiring

QMK supports a key matrix configuration where each key is identified by a unique row-column combination, with diodes preventing ghosting (unwanted column activation). The PCB and QMK firmware are configured as follows:

3D-Printed Case Design

I designed with Autodesk Fusion 360 and printed a custom enclosure using PLA. The chassis is modular, divided into multiple parts to:

  • Allow for easy replacement of individual components without re-printing the entire case.
  • Reduce print time per part (avoiding >20h single prints).
Components

3D Printing Process

The enclosure components were manufactured using a Bambu Lab P1P 3D printer. While the design is compatible with standard printing profiles, a 0.2mm nozzle was utilized to achieve superior surface finish and precise detail resolution. PLA (Polylactic Acid) was selected as the filament material due to its optimal balance of cost-effectiveness, printability, and mechanical durability suitable for this application.

Assembly

The case uses threaded brass inserts (M2) for a robust and aesthetically pleasing assembly. Case Assembly Case Assembly Case Assembly

Component Assembly & Soldering

All PCB components were hand-soldered, which included:

  • Raspberry Pi Pico: Soldering all GPIO pins plus the two small test pads required for the external USB data lines.
  • Passive Components: 2 capacitors per PCB.
  • Connectors: External USB-C breakout (4 pins) and RJ11 jacks (4 pins).
  • Peripherals: Rotary encoders (5 pins) and OLED display headers (4 pins).

For the matrix:

  • Diodes: 1N4148 diodes for each key (2 points).
  • Sockets: Kailh hot-swap sockets (2 points) - switches are not soldered directly.
  • LEDs: SK6812MINI-E SMD LEDs (4 points per key).

A significant challenge was soldering the small voltage level shifter required for correct LED data signaling. As this was my first experience with soldering—especially with such small SMD components—the results are functional but reflect the learning curve involved.

Flashing Instructions

  1. Set up the vial-qmk environment by cloning the repository: https://github.com/vial-kb/vial-qmk.
  2. Copy the qmk-vial/new_split_keyboard_gabriele directory from this project into the vial-qmk/keyboards/ directory.
  3. Flash the firmware using the following commands:
bash
# Flash Left Side
qmk flash -kb new_split_keyboard_gabriele -km vial -bl uf2-split-left

# Flash Right Side
qmk flash -kb new_split_keyboard_gabriele -km vial -bl uf2-split-right

Conclusions

Additional photographic documentation is available in the /images directory.

References

Parts

134
QtyValueFootprintReferences
35DiodeScottoKeebs_Components:D_SOD-123_DO-35_Hybrid_DoubleSided_V2D1, D2, D10, D11, D12, D13, D14, D15, D16, D17, D18, D19, D20, D21, D22, D23 +19
35LED_SK6812MINIScottoKeebs_Components:LED_SK6812MINILED1, LED2, LED10, LED11, LED12, LED13, LED14, LED15, LED16, LED17, LED18, LED19, LED20, LED21, LED22, LED23 +19
25KeyswitchScottoKeebs_Hotswap:Hotswap_MX_1.00uS1, S10, S11, S12, S14, S15, S16, S17, S18, S19, S22, S23, S24, S25, S27, S28 +9
8MountingHolepersonal:MountingHole_3.2mm_M3H4, H5, H6, H7, H8, H9, H10, H11
4KeyswitchScottoKeebs_Hotswap:Hotswap_MX_1.25uS4, S7, S13, S21
3MountingHolepersonal:PCB_support_2.2mm_M2H1, H2, H3
3MountingHolepersonal:MountingPCB_2.2mm_M2H12, H13, H14
3TestPointConnector_PinHeader_2.54mm:PinHeader_1x01_P2.54mm_VerticalTP1, TP2, TP3
2CCapacitor_SMD:C_1812_4532Metric_Pad1.57x3.40mm_HandSolderbegin1, end1
2Jumper_HightJumper:SolderJumper-2_P1.3mm_Bridged2Bar_Pad1.0x1.5mmJP2, JP3
2KeyswitchScottoKeebs_Hotswap:Hotswap_MX_1.75uS3, S26
14P4CConnector_RJ:RJ12_Amphenol_54601-x06_HorizontalJ1
174LVC1G34Package_TO_SOT_SMD:SOT-353_SC-70-5_HandsolderingU3
1Conn_01x02Connector_PinHeader_2.54mm:PinHeader_1x02_P2.54mm_HorizontalJ4
1Conn_01x04Connector_PinHeader_2.54mm:PinHeader_1x04_P2.54mm_HorizontalJ3
1Jumper_2_BridgedJumper:SolderJumper-2_P1.3mm_Bridged2Bar_Pad1.0x1.5mmJP4
1Jumper_LowJumper:SolderJumper-2_P1.3mm_Bridged2Bar_Pad1.0x1.5mmJP1
1KeyswitchScottoKeebs_Hotswap:Hotswap_MX_2.25uS5
1KeyswitchScottoKeebs_Choc:Choc_V1_1.00uS29
1KeyswitchScottoKeebs_Hotswap:Hotswap_MX_1.50uS2
1KeyswitchScottoKeebs_Choc:Choc_V1_1.75uS20
1OLED_128x32ScottoKeebs_Components:OLED_128x32J2
1Picopersonal:Raspberry_Pi_Pico_with_usb_ringsU2

More from Gabriele-tomai00/split_keyboard_2_qmk_pcb

1
  • 2 layers156.8 × 141.1 mmPcb keyboard right, the printed circuit board in 3D

    Pcb keyboard right

    Gabriele-tomai00/split_keyboard_2_qmk_pcb

    My second custom split keyboard: qmk firmware, pcb, 3d files

    133 parts

Similar boards

  • 6 layers230 × 56 mmOvc, the printed circuit board in 3D

    Ovc

    osrf/ovc

    the Open Vision Computer

    379 parts207Apache-2.0
  • 2 layers109 × 71 mmGamma split, the printed circuit board in 3D

    Gamma split

    ahtn/keyboard_pcb

    156 parts96
  • 2 layers243.4 × 76.7 mmSteamvan, the printed circuit board in 3D

    Steamvan

    jmdaly/steamvan

    KiCAD design files for the SteamVan PCB - a 40% keyboard PCB based on an STM32 MCU

    188 parts76CC-BY-SA-4.0
  • 2 layers285 × 95.1 mmCO60, the printed circuit board in 3D

    CO60

    jmdaly/CO60

    KiCad design files for the CO60, an open hardware 60% keyboard PCB

    286 parts55CC-BY-SA-4.0
  • 4 layers100.9 × 77.5 mmYm2610-pcb, the printed circuit board in 3D

    Ym2610-pcb

    dan-rodrigues/ym2610-pcb

    FPGA-based PCB to control a YM2610 sound synthesis chip.

    168 parts31
  • 2 layers395.3 × 138.1 mmCustom keyboard (f303), the printed circuit board in 3D

    Custom keyboard (f303)

    howardt12345/keyboard0

    TKL + macro keys, 2 rotary encoders, and OLED

    514 parts15
  • 2 layers303.2 × 94.5 mmVoyager65, the printed circuit board in 3D

    Voyager65

    foggyflute/Voyager65

    Fully versatile 65% keyboard PCB. Simplified variants available.

    224 parts7GPL-3.0
  • 2 layers99.7 × 74.8 mmSplit steno rev2.1, the printed circuit board in 3D

    Split steno rev2.1

    samlli/Split-Steno

    Split Stenographic Keyboard

    78 parts2GPL-3.0

Questions

How big is the Pcb keyboard left PCB?

It measures 172.3 × 140.7 mm and has 2 copper layers, 1.6 mm thick.

What parts does the Pcb keyboard left use?

134 parts, built around the 74LVC1G34Z. 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 Pcb keyboard left KiCad files?

From the Gabriele-tomai00/split_keyboard_2_qmk_pcb repository on GitHub, at the commit this page was made from: the board is kicad/pcb_keyboard_left/pcb_keyboard_left.kicad_pcb and its schematic kicad/pcb_keyboard_left/pcb_keyboard_left.kicad_sch. PCBKit opens the board in the browser, with nothing to install.

Can I use the Pcb keyboard left design in my own project?

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