v1

Version 1 of the Splinter keyboard

A 61-key split columnar ergonomic keyboard - Production ready. Asymetrical. Traditional key layout.

Hardware

atmega32u4

• 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/feature_split_keyboard
• qmk_firmware/docs/serial_driver

Left	Right
--	0 (RX1, D2)
--	GND
--	VCC
--	--

Parts

Category	Quantity	Part
Diodes	61	Nexperia BAS16H,115
Hot swap sockets	61	Kailh CPG151101S11-16
Keycap sets		GMK Sixes keycaps and Ortho Kit
Key switches	61	Cherry MX Ergo Clear (developer information)
Microcontrollers	2	SparkFun Qwiic Pro Micro - USB-C (ATmega32U4) (GitHub)
Reset buttons	2	E-Switch TL3342F450QG (Not needed if using the SparkFun microcontroller)
Screws	4	M3x12mm screws
Silicon bumpers	10	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²
Switch (MX) cutout size	14mm²
Switch (MX) outer size	15.6mm²

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.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

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/v1/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/v1/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/v1/kicad/jlcpcb/*.zip
5. Submit the ../dist/v1/kicad/jlcpcb/*.zip files to JLCPCB

PCB dimensions

Position each PCB at (105,105). The left half starts at this position, but the right half must be moved before running npm run copy-traces. 100mm to provide a buffer around the edges of the document, and 5 mm to account for the case walls.

Configuration

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

Left half

Overall (h,w): 122.1 mm, 155.5 mm

Edge	Start and end (x,y) coordinates
Left	(105,105) (105,205.5)
Top	(105,105) (260.5,105)
Right	(260.5,105) (260.5,208.8)
Corner	(253.4,224.1) (260.5,208.8)
Bottom	(105,205.5) (253.4,224.1)
PCB edge to center of M3 hole	23mm (28mm to outer wall)

Right half

Overall (h,w): 122.1 mm, 193.6 mm

Edge	Start and end (x,y) coordinates
Left	(105,105) (105,208.8)
Top	(105,105) (298.6,105)
Right	(298.6, 105) (298.6,167.1)
Right corner	(263,205.2) (298.6,167.1)
Buttom	(112,224.1) (263,205.2)
Left corner	(105, 208.8) (112,224.1)
PCB outside edge to center of M3 hole	18mm (23mm to outer wall)

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/

Dimensions

Left half

Overall dimensions (h,w): 129.51474 mm, 165.5 mm

Edge	Length
Left	110 mm
Top	165.5 mm
Right	110 mm
Corner	21.53214 mm
Bottom	157.61289 mm

Right half

Overall dimensions (h,w): 129.51474 mm, 203.6 mm

Edge	Start and end (x,y) coordinates
Left	110 mm
Top	203.6 mm
Right	110 mm
Right corner	55.85994 mm
Buttom	157.61289 mm
Left corner	21.53214 mm

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.