v2

Version 2 of the Splinter keyboard

A 62-key split columnar ergonomic keyboard - Symmetrical enclsoures. Non-traditional placement of backspace and backslash keys.

Hardware

Parts

Category	Quantity	Part
Diodes	62	Nexperia BAS16H,115
Hot swap sockets	62	Kailh CPG151101S11-16
Keycap sets		GMK Sixes keycaps and Ortho Kit
Key switches	62	Cherry MX Ergo Clear (developer information)
Microcontrollers	2	SparkFun Qwiic Pro Micro - USB-C (ATmega32U4) (GitHub) (Note that some USB-C Pro Micros are 3mm longer than the Micro-USB version that the Ergogen footprint is based on, but this is not true of the SparkFun USB-C Pro Micro)
Reset buttons	2	E-Switch TL3342F450QG (Not needed if using the SparkFun microcontroller)
Screws	4	M3x12mm screws
Silicon bumpers	8	100Pcs Self Adhesive Round Silicone Rubber Bumpers
Sockets (12-pin)	4	Mill-Max 315-43-112-41-003000
Socket pins	48	Mill-Max 3320-0-00-15-00-00-03-0
Threaded inserts	4	M3x3mm (short) threaded inserts
TRRS cables	1	Monoprice Onyx TRRS Cable
TRRS jacks	2	HCTL HC-PJ-320A-4P-D

Part dimensions

Part	Dimensions
Keycap size	18mm²
SparkFun Qwiic Pro Micro - USB-C (ATmega32U4)	PCB: width: 17.78mm, length: 33.02; USB: protrusion: 1.27mm
Keycap size with padding	19mm²
PCB thickness	1.6mm
Switch (MX) cutout size	14mm²
Switch (MX) outer size	15.6mm²

Microcontroller

• Pro Micro pinout

Left Arduino	Left AVR	Right Arduino	Right AVR
1 (TX0)	D3	RAW
0 (RX1)	D2	GND
GND		RST
GND		VCC
2 (SDA)	D1	A3 (21)	F4
3 (SCL)	D0	A2 (20)	F5
4 (A6)	D4	A1 (19)	F6
5	C6	A0 (18)	F7
6 (A7)	D7	15	B1
7	E6	14	B3
8 (A8)	B4	16	B2
9 (A9)	B5	10 (A10)	B6

TRRS serial pinout

• qmk_firmware/docs/features/split_keyboard
• qmk_firmware/docs/drivers/serial

Connect: 0 (RX1, D2), GND, VCC

Developing

• Overall process

Keyboard Layout

• Project folder
• Configuration file

1. Prototype a keyboard layout using Keyboard Layout Editor
2. Export the layout configuration to ./keyboard-layout-editor/keyboard-layout-editor.json, so that you can import it and iterate on it in the future
3. Use the prototype as inspiration for creating a production-ready design using Ergogen

Ergogen

• Project folder
• Configuration file
• Online version of Ergogen that includes ceoloide's footprints

1. Convert the prototype to Ergogen's DSL, and then save it to ./ergogen/config.yaml
   • If prototyping using this online version of Ergogen, then download the "raw.txt" file
2. Run npm run build to generate and save outlines and pcbs to ../dist/v2/ergogen/
   • Alternatively, run npm run watch or npm run watch-and-copy-pcbs-to-kicad

KiCad

• Project folder

1. Run npm run copy-pcbs-to-kicad to copy the ../dist/v2/ergogen/pcbs/*.kicad_pcb files generated by Ergogen to ./kicad/
2. Run xdg-open ./v2/kicad/left.kicad_pcb
3. Route the PCBs in ./kicad/, and then save them to ./kicad/routed/
   • If you've generated new PCB files using Ergogen, then you can run npm run copy-traces to copy traces from the PCBs in ./kicad/routed/ back to those of the same name in ./kicad/
4. Run npm run fab-jlcpcb to generate and save gerber and drill files to ../dist/v2/kicad/jlcpcb/*.zip
5. Submit the ../dist/v2/kicad/jlcpcb/*.zip files to JLCPCB

Configuration

1. Navigate to File > Board Setup... > Design Rules > Netclasses
2. Update the "Default" netclass
3. Click the "+" button to add a "VCC" netclass

Configuration	Description
Default netclass	Clearance: 0.20mm, Track width: 0.20mm
VCC netclass	Clearance: 0.25mm, Track width: 0.25mm

OnShape

• Project folder

1. Create a new document
2. Start a new sketch
3. Select "Import DXF or DWG files" > "Import ..." (at the bottom of the dialog) > Select ../dist/v2/ergogen/outlines/full.dxf
4. Design a keyboard case
5. Export *.step files to ./onshape/

OrcaSlicer

1. Open or create an OrcaSlicer project file
2. Import *.step files from ./onshape/
3. Print the keyboard case

QMK Firmware

Install the "splinter" fork of qmk_firmware.