# The Gherkin Build Guide ## Required to Build: Before we start, let’s check we've got everything included in the kit. If there’s anything missing, send us a message [here](https://mechboards.co.uk/pages/faq) so we can get you back to the build ASAP! | | | | | ----------------------------------- | ------------------- | ---------------- | | 1 x Gherkin PCB | 1 x Switch Plate | 1 x Back Plate | | 30 x Through-hole Diodes | 16 x 12mm Standoffs | 32 x 6mm Screws | | 1 x RP2040 Controller + Header Pins | 4 x Rubber Feet | 30 x MX Switches | | 1 x Keycap Set | | |

## Tools Required: Here's a list of the tools you need to build the keyboard: | | | | | ---------------- | ------------------------------ | ------ | | Soldering iron | Phillips head screwdriver (M2) | Solder | | Snippers/Cutters | Diode Bender (Optional) | |

## Making the Gherkin: ### Step 1: Soldering the Controller Headers First things first, we can solder the controller headers (they may be one pin too long, if so, you can just snip it off!), you'll want to orientate them by putting the longer pins through the bottom of the PCB. Once they're soldered, we need to snip off any excess pin to avoid them interfering with the switches. {% hint style="danger" %} It's important not to get ahead and solder the controller yet, we'll need to solder the switches and diodes underneath it first! {% endhint %}

### Step 2: Bending and Soldering the Diodes Now we can install our diodes. You can usually get away with estimating the bends, using the distance between the diode holes as a guide. A diode bender does make the job much more accurate and quicker if you've got one!

Once they're bent, we can insert and solder them into the holes on the top of the PCB, making sure that the black end is pointing the same way as the line on the PCB.

### Step 3: Installing the Switches Next up we can insert the switches into the switch plate, the orientation isn't vital here, but the notch on switch plate should allign with the notch on the PCB.

Now we can insert the switches into the top of the PCB carefully, making sure the pins allign with the holes on the PCB. A nice firm press should be enough! And once they're inserted we can solder each switch pin on the back of the PCB.

### Step 4: Flashing and Installing the Controller Before we install the controller, it's worth checking there's no obvious issues with it (desoldering controllers can be a big pain!). If you're unsure how to do this, [click here.](https://guides-mechboards.gitbook.io/guides/other-guides/controller-flashing-guide-rp2040-wired#flashing-a-wired-rp2040-controller) After its been flashed we can solder it to the headers, components side down.

### Step 5: Installing the Case and Keycaps Now we can screw the standoffs to the bottom plate (checking the orientation of the notch again), and place the rest of the Gherkin on top, screwing it into place.

Finally, we can install the keycaps by simply pressing them onto the switches.

And there we have it, you should now have a fully assembled Gherkin! ## Additional Info: RP2040 firmware: {% file src="" %} To customise your layout in VIA, you'll need to upload this .json file: {% file src="" %} All you need to do is go to the settings tab in VIA, enable 'Show Design tab'.\ Now you can select the design tab, press the 'Load' button, and upload the .json file there!