instructables

KoiBoard - Fully Customizable Mechanical Keyboard With a Koi!

by salilkhare65

I made a fully customized keyboard from scratch. Every part was designed by me to create my dream keyboard. My idea
for this project stemmed from a project I tried to do last year to make a customized keycap. This idea failed and
blossomed into the ambition to create a fully edged keyboard. The con guration of my keyboard is tenkeyless.

Thank you so much to Ms. Berbawy for helping me throughout the project, letting me use her equipment, and giving me
advice.
A HUGE thanks to Crash#8751(discord tag)for helping me out whenever I needed it and taking me through the entire
process of building a keyboard.
Supplies:

My keyboard was fairly expensive compared to that of what you can get prebuilt on any online vendor like Amazon.
Supplies that I used include:
Microcontroller
Diodes
Reset Key
Key Switches
PCB
Stabilizers
Keycaps
M2 Screws

Tools that are Needed:

Solder
Soldering Iron
Laser Cutter
3d Printer
Screwdrivers
Sand Paper
M2 Allen Key

KoiBoard - Fully Customizable Mechanical Keyboard With a Koi!: Page 1

Software That I Used:
Fusion 360
Adobe Illustrator
KiCad
KLE
Free Router
Keyboard Firmware Builder
QMK
Prusa Slicer

KoiBoard - Fully Customizable Mechanical Keyboard With a Koi!: Page 2

Step 1: KiCad and the PCB Process

1. First use KLE to make your plate layout. This will allow you to take a pre-existing layout and make it your own by
making a few tweaks. (Pic 1)

2. Take this to Kicad which is a software used to design PCBs and nd a suitable library for your switch and layout of
preference.

3. Make your schematic using a switch matrix and diodes. This optimizes the number of rows and columns used and
assigned those rows and columns to pins on your Elite-C microcontroller. (Pic 2)

4. Create a circuit with a push button switch to short the reset and ground pins in the MCU.

5. After nishing your schematic, put your switches into KiCad's PCB editor and arranged them properly with a distance
of 19mm between each centers of each switch. (if you look at KLE you can see that one regular switch is equal to 1U. 1U is
equal to 19mm. For special keys like the shift key, KLE will display it as 2.25U. This means that you will have to do 2.25+1 and

KoiBoard - Fully Customizable Mechanical Keyboard With a Koi!: Page 3

then multiply that by 19. Then divide by 2 to get your distance between the center of each switch. This is only used for special
keys like shift, caps lock, and the space bar to name a few)(Pic 3 and 4)

6. Take the footprints of your PCB and put it into Free Router a program which automatically routes the traces. (Pic 5)

7. The PCB was ready and I ordered it using JLCPCB to get it manufactured.

KoiBoard - Fully Customizable Mechanical Keyboard With a Koi!: Page 4

KoiBoard - Fully Customizable Mechanical Keyboard With a Koi!: Page 5
KoiBoard - Fully Customizable Mechanical Keyboard With a Koi!: Page 6
KoiBoard - Fully Customizable Mechanical Keyboard With a Koi!: Page 7
Step 2: Plate Design

1.Take your SVG le from KLE and import that into Fusion 360 creating your PCB plate. (Pic 1)
2. Extrude the plate by 1.5 mm and change the dimensions to match your PCB from KiCad. (Pic 2)

Add tabs to the side of my PCB to act as gaskets

3. Export your plate from Fusion as a SVG and put it into Adobe Illustrator to be laser cut.

4. I decided to Vector Cut wood and use wood as my nal product but you can also use acrylic. I would recommend using
wood for your initial test cuts even if you decide to use acrylic for your plate. The laser cutter I used is a Universal VLS3.5
40W.
Stroke of 0.1
RGB 255 RED (Pic 3)

5. I had to do multiple iterations until my plate perfectly matched my PCB. (Pic 4 and 5)

6.Check if your cut plate is correctly aligned with your PCB by inserting your switches into both your switch plate and
your PCB. (Pic 6)

KoiBoard - Fully Customizable Mechanical Keyboard With a Koi!: Page 8

KoiBoard - Fully Customizable Mechanical Keyboard With a Koi!: Page 9
KoiBoard - Fully Customizable Mechanical Keyboard With a Koi!: Page 10
KoiBoard - Fully Customizable Mechanical Keyboard With a Koi!: Page 11
Step 3: Case Design

1. I created a case in Fusion 360 to house my PCB.

Golden Top Case (Pic 1)
Red PCB (Pic 2)
Grey Bottom Case (Pic 3)

2. I created this case around my preexisting plate design that I used for laser cutting.
3. I added tabs that stick out to be ush with my case design. This would allow the switch plate to sit on the case without
sticking out making it look more aesthetically pleasing.
4. Research di erent layouts for your keyboard. A website that I found particularly helpful is Keyboard University.
5. After researching, I decided to make the layout of my keyboard in the form of a Intergrated Plate. This would be the
easiest for me to do. (Pic 4)
6. The case was split using Female/Male tabs to connect the pieces together and allow it to t on a 3d printer.
7. Add holes where the top and bottom case meet for M2 screws. This will hold the board nicely together and rm.
KoiBoard - Fully Customizable Mechanical Keyboard With a Koi!: Page 12
This is your part to be creative and add whatever you want to your case design to make it unique to yourself.

KoiBoard - Fully Customizable Mechanical Keyboard With a Koi!: Page 13

Step 4: 3d Printing Case Parts

KoiBoard - Fully Customizable Mechanical Keyboard With a Koi!: Page 14

After looking at my keycaps (Pic 1) I decided to make the color of my main body baby blue and the color of my top body
brick red.
I used PLA or my print as there were better color options but PETG gives more strength.
I used a Prusa MK3S+ so I had to print in two intervals.

KoiBoard - Fully Customizable Mechanical Keyboard With a Koi!: Page 15

KoiBoard - Fully Customizable Mechanical Keyboard With a Koi!: Page 16
KoiBoard - Fully Customizable Mechanical Keyboard With a Koi!: Page 17
KoiBoard - Fully Customizable Mechanical Keyboard With a Koi!: Page 18
KoiBoard - Fully Customizable Mechanical Keyboard With a Koi!: Page 19
Step 5: Stabilizers and Soldering

Follow the instructions that come with your stabilizers and install them onto your PCB. (Pic 1 and 2)

For soldering, I used through hole 1N4148W diodes and soldered them onto my board making sure the anode and the
cathode on the diode correlated with it's equivalent negative and positive side on the PCB. On a through hole 1N4148W
diode, the black part is negative. . (Pic 3)
Through hold solder your MCU (microcontroller unit) onto your board. First insert your 12 pin headers and then put your
MCU on top of that. (Pic 4)

Match up your PCB plate with your PCB ensuring that all of the holes match with their correct switch on the PCB. Put in
your switches ensuring that the legs of the switches go through both the plate and the holes in the PCB. (Pic 5 and 6)
Through hole solder all of your switches into the PCB.

KoiBoard - Fully Customizable Mechanical Keyboard With a Koi!: Page 20

KoiBoard - Fully Customizable Mechanical Keyboard With a Koi!: Page 21
KoiBoard - Fully Customizable Mechanical Keyboard With a Koi!: Page 22
KoiBoard - Fully Customizable Mechanical Keyboard With a Koi!: Page 23
Step 6: Programming

For programming your keyboard I recommend using Keyboard Firmware Builder. While it is outdated and not supported
anymore, it should still work with your keyboard. (Pic 1)
Here are the steps on how to use Keyboard Firmware Builder.
1. Go to Keyboard Layout Generator. (the program you used earlier in this project)
2. Build you schematic from KiCad in KLE. (make sure all your keys are only 1 unit) (Pic 2)
3. Make sure all your wiring looks correct. (Pic 3)
4. Next go to the pins section and look back at your schematic. Match the pins with your MCU. (Pic 4 and 5)
5. Go back to wiring and make sure to specify the diode direction as column to row. (Pic 6)
6. After you have gone through and double checked that you did everything correctly, download your le
as a .hex.

Download QMK Toolbox

If QMK Toolbox asks you to download any drivers say OK and let them download. This is crucial for Toolblox to work
properly. (Pic 7)
Connect your MCU to your computer. On your Toolbox there should be con rmation that something has connected. Take
your .hex le and click ash.
Your MCU should now be working!!

KoiBoard - Fully Customizable Mechanical Keyboard With a Koi!: Page 24

KoiBoard - Fully Customizable Mechanical Keyboard With a Koi!: Page 25
KoiBoard - Fully Customizable Mechanical Keyboard With a Koi!: Page 26
KoiBoard - Fully Customizable Mechanical Keyboard With a Koi!: Page 27
KoiBoard - Fully Customizable Mechanical Keyboard With a Koi!: Page 28
Step 7: Putting It Together

1. Get your soldered PCB and plate and insert it into your case making sure the USB connection of the MCU
is accessible through the slot.
2. Take your top case and screw it on top making sure it does not ex too much. For my keyboard I used
M2x12 screws.
3. Enjoy your new keyboard :D

This entire process was a invaluable experience to me. I started o clueless about how to approach this project but came
out how to use di erent software, how to 3d print, and how to laser cut. I had a lot of fun and it is safe to say that making
this keyboard was the highlight of my year.

If you ever need help feel free to contact me on Aiza#1000 (my discord tag)

KoiBoard - Fully Customizable Mechanical Keyboard With a Koi!: Page 29

Oh wow, this is fantastic! I've always wanted to make a keyboard but never had the (insert thing
here) to actually make a start on one. And the prospect of modifying an existing one is just like,
meh!
Your design is quite inspiring!
So, the big question - is it nice to type on?
The only thing that really un-floats my boat here, is those nice keycap sets, they're all US layout!

KoiBoard - Fully Customizable Mechanical Keyboard With a Koi!: Page 30