Skip to content

Build Guide (Wired)

Christoph Rehmann edited this page Jan 22, 2022 · 2 revisions

Build Guide - Wired

The wired build makes use of an Pro Micro microcontroller board and the QMK Firmware

Bill Of Materials

Part Name Amount Notes / Link
PCB 2 See the release page for the latest Gerber files or use KiCad to generate them
Top Plate 2 For a sandwich-case build. See the release page for the latest Gerber files or use KiCad to generate them. Note that the top and bottom plate are designed to be little bit larger than the PCB of the keyboard itself.
Bottom Plate 2 For a sandwich-case build. See the release page for the latest Gerber files or use KiCad to generate them. Note that the top and bottom plate are designed to be little bit larger than the PCB of the keyboard itself.
Pro Micro 2 or a compatible microcontroller board
Microcontroller Sockets 4 (Optional)
Diodes (e.g. 1N4148) 40 You can either use through hole or surface mount diodes
e.g. https://www.aliexpress.com/item/32334222067.html
Switches 40 Only Kailh Choc switches are supported (PG1350)
Hot Swap Sockets 30 (Optional)
e.g. https://aliexpress.com/item/33023283633.html
TRRS connectors 2 The same type which is used in other split keyboards like the Corne or Kyria. Technically even TRS should work as only serial communication is supported between the halves
e.g https://aliexpress.com/item/32869968774.html
Tactile push button 2 Technically optional: you can use metal tweezers whenever you need to reset the microcontroller.
https://aliexpress.com/item/10000184124465.html
TRRS Cable 1 A TRS cable does also work
e.g. https://aliexpress.com/item/4000291134188.html or if you preferer it a longer one.
M2 Case Spacers 14 The height depends on whether you are going to use hot swap sockets and/or a TrackPoint module. I am using 6mm spacers together with hot swap sockets and a TrackPoint
M2 Guard Spacers 4 Optional: Spacers for an acrylic glass shield. The length depends on the socketing of the microcontroller / display. I am using 8mm long spacers
M2 Screws 36 For the M2 spacers (plate & guard)
4.7kΩ Resistor (I2C) 2 Only required if you a want to use an OLED display and/or linear actuator.
OLED Display 2 (Optional)
Use a 0.91 inch display e.g. https://aliexpress.com/item/32712441521.html
Linear Actuator 1 (Optional) Only supported on the master side (by default right halve).
DRV2605L Linear Actuator Haptic Breakout – Pimoroni
4.7kΩ Resistor (TrackPoint) 2 Only required if you are going to use a TrackPoint
100kΩ Resistor (TrackPoint) 1 Only required if you are going to use a TrackPoint
2.2uF Capacitor (TrackPoint) 1 Only required if you are going to use a TrackPoint
TrackPoint 1 (Optional) Only supported on the master side (by default right halve)
The PCB is designed for a TrackPoint of a Thinkpad X230S, X240, X240S, X250, X250S, X260 or X270
Not personally tested: https://aliexpress.com/item/1005003581279881.html
TrackPoint Stem Extension 1 A stem extension for the TrackPoint is required. The hole in the top plate between the two inner columns is only 2.6mm in diameter and the hole between index and middle finger column has a diameter of 6mm.
I am using a labret piercing as stem extension between the two inner columns. It is glued onto the TrackPoint module and is 6mm long and has a diameter of only 0.8mm

Instructions

1) Prepare the PCBs

The PCB is reversible and it is easy to solder a component on the wrong side if you pay not attention to it. Tipp: mark the front/top side by a piece of tape in order to remember which side is which.

Mark top side of PCB with tape

2) Diodes

The diodes have to be soldered on the back/bottom of the PCB. Make sure you have the orientation right. The end with the line is cathode (-) and it should go in the direction of the "arrow" symbol on the PCB

Surface mount diode Through hole diode
Surface Mount Diode Through Hole Diode

3) Hot Swap Sockets (Optional)

The use of hot swap sockets is optional. They must also be soldered on the back of the PCB like the diodes

Hot Swap Sockets

4) I2C Resistors (Optional)

The resistors R1 and R2 (between thumb key and inner index column) are only required if you are going to use a display and / or a linear actuator. The have also to be soldered on the back of the PCB like the diodes and hot swap sockets.

5) Linear Actuator / Haptic Buzz (Optional)

The linear actuator haptic breakout can only on the master halve be used. It should be inserted from the bottom. I also put some insulation tape between it and the PCB. Only the pins which are labeled on the front of the PCB must be soldered. Note also the two jumper pads. Those have to be bridged on the front of the PCB.

Linear Actuator

6) OLED Display Jumpers (Optional)

You have to bridge the OLED jumpers if you want to use an OLED display. They are right below the microcontroller footprint and have to be bridged on the front side of the PCB

OLED Jumpers

Note: in the image above are the jumpers not bridged because I already had assembled the keyboard when I took the pictures for the guide and was not able to take a good picture of the bridged jumpers and used therefore an image of a spare PCB

7) TrackPoint Reset Circuit (Optional)

The TrackPoint reset circuit is required if you are planning to use a TrackPoint. Note that the TrackPoint is only on the master halve supported. Solder the resistors R3 (4.7kΩ), R4 (4.7kΩ) and R5 (100kΩ) and the capacitor C1 (2.2uF) also on the back Side of the PCB

TrackPoint Reset Circuit

8) Front Components

Now it is time to solder on the TRRS socket and optionally the reset button. Use a piece of tape to fix them on the front side of the PCB and solder from the bottom side.

9) Microcontroller Board

Socketing a microcontroller is quite useful. It makes it easier to remove the microcontroller later in case you would want to reuse it if it should break (the USB port on a Pro Micro is easily damaged).

Align the microcontroller/sockets with the outline columns of the pads. Which pair of rows you need to solder the controller to will be different depending on which half you solder it to. The microcontroller always faces with its backside up.

Sockets Microcontroller
Sockets Microcontroller

10) Top Plate & Switches

Important: If you are going to use a TrackPoint or are planning to maybe use one in the future than make sure to already insert the the screws for the TrackPoint from the front of the PCB (marked blue in the image below). After installing the top plate, it is no longer possible to insert the screws for the TrackPoint. It is only possible to tighten the screws with a small screwdriver because a screw head is to big to go through the hole of the top plate.

Install the switches through the plate and make sure they sit fully seated and solder them in case you are not using the hot swap sockets. It is easier when you start with a switch near each corner and working your way to the center.

I trimmed the four switches around TrackPoint to module to mount it later as flush as possible to the PCB (marked red in the image below). The stem are short enough and only the housing had to be cut off a little together with the supportive pins on either side.

Switches

11) TrackPoint (Optional)

I am using a labret piercing as stem extension (6mm long and with a diameter of 0.8mm). It can be attached to the TrackPoint with a drop of super glue. Additionally you can roughen the surface of the labret piercing with a file. The ribbon cable is to short and has to be removed. Do not apply to much pressure when removing it as you can tear of the pads. Use a solder iron to remove one lane of the cable at a time.

TrackPoint with extension Back of TrackPoint
TrackPoint Extension TrackPoint Back

I used a TrackPoint module of an defective ThinkPad X240. In the picture below you can see the pinout of the module. Take care when soldering the wires to it. The pads are quite small and after solder I used clear nail polish to avoid unwanted shorts and secured the wires with some hot glue and a shrinking tube.

TrackPoint Pinout

Screw off the ball of the piercing before mounting the TrackPoint to the PCB. It is recommended to use some tape between the PCB and the TrackPoint module to avoid any shorts.

The TrackPoint circuit board can be placed below the microcontroller board. I added here also some tape to avoid any shorts. The wires can than be solder the keyboard PCB at the designated TrackPoint pins.

Installed TrackPoint

I cut off the edges of the switches to make space for the TrackPoint rubber can. The used hot glue to secure the ball of the labret piercing to the rubber cap. It can then be screwed on/off.

TrackPoint Cap

12) OLED Display & OLED Guard

As with the microcontroller it can also be useful to socket the OLED display. Place it on top of the microcontroller and solder it from the bottom. Optionally you can also add an OLED guard. I am using dark acrylic glass and 6mm spacers. I also added some black tape on the back of the guard to let only the OLED shine through.

OLED

13) Bottom Plate

Finally the bottom plate can be screwed on and you are finished with your build (after adding your keycaps)!

Build finished

See https://github.com/qmk/qmk_firmware/tree/master/keyboards/buzzard for the firmware.