Our guides have moved. Please access the most latest and updated guides here. Thank you!


Congratulations on receiving your Pikatea Macropad Kit. This guide will walk you through the assembly process. Please email support if you have any questions.

What's in the Box

picture of box contents
  • (1) Top plate
  • (2) Circuit boards
  • (5) Mechanical keyboard switches
  • (5) Keycaps
  • (1) Knob
  • (1) MicroSD card
  • (1) Rotary encoder with hardware (washer and nut)
  • (1) MicroSD card reader
  • (1) Allen wrench (1/16th)
  • (2) Screws for mounting
  • (1) USB cable
  • (2) pieces of mounting tape

Gather Required Materials

You will need everything that comes with the kit as well as a few other items. Those additional items include:

  • Soldering Iron and solder
  • Tape
  • Snips, metal cutter, or wire cutters.
  • Screw driver
  • Pliers, adjustable wrench or the correct size socket/wrench for the rotary encoder hardware. 
  • Extra cardboard. We recommend using the box your kit came in. 

Now that you have everything you need, lets get started!

Inspect the Top Plate

The top plate is either powder coated steel or 3d printed. Sometimes extra paint can be built up in the encoder hole, especially on the inside surface. This can cause problems for the encoder since it makes the shaft not perpendicular to the top plate surface. Use flush cuts, finger nail clippers, or carefully use sand paper or a file to remove this extra paint before getting started. 

Install the Mechanical Keyboard Switches

The mechanical keyboard switches need to be installed in a specific orientation. The pins need to be furthest away from the circular rotary encoder side of the top plate. Make sure they snap into place and are flush with the top plate. 

Setup the Soldering Jig

Use a cardboard box (we recommend the box your kit came in) and tape one of the flaps so that it is at a 30 degree angle. Don't worry about this being precise or elegant, we are only using this to keep the macropad in the correct orientation for soldering without damaging the top plate surface.

Use the screws that were included in the kit for mounting to attach your macropad to your angled cardboard surface. Place something heavy in the box like a book or a mug to make sure it doesn't tip over while soldering.

Solder the Daughter Board

Place the long, skinnier circuit board (daughter board) on the switches so the pins go through the holes. Some switches will require some extra force but most do not. Make sure everything is lined up and the pins are poking through. If not, you might have a bent pin. When everything is in place, solder the pins to the daughter board. 

Install the Rotary Encoder

Next up is the rotary encoder. (Note: the encoder may already be prepped but here are the directions in case yours is not). Prep the rotary encoder by snipping the mounting tabs with snips or wire cutters. Cut the set of 3 pins shorter so they are flush with the bottom of the rotary encoder. Lastly, bend the set of 2 pins so they are pointing straight out with a slight angle. 

Place the rotary encoder in the hole of the top plate and hand tighten the washer and nut to hold it in place for soldering. Don't tighten this with any tools just yet. The washer has a slight bend in it so be careful to place the raised part in the center facing towards the front of the macropad. Use the pictures shown to ensure the correct orientation. 

Solder the Rotary Encoder

After the rotary encoder is in place, it is time to solder it. The 2 bent pins on the rotary encoder are resting just above the pads were they need to be soldered to, facing toward the switches. The 3 shorter pins on the rotary encoder are placed just to the side of the pads were they need to be soldered to. They do not go through the holes. Take a look at the pictures shown for a better explanation. 

Test Fit and Solder the Main Board

Before removing the paper from the tape on the back of the main circuit board (square shaped), place the board with the pins facing downwards onto the daughter board. Ensure that the pins line up and do not need to be bent. The pins do not need to fit all the way into the holes, they just rest on top. It could be possible that pins bend out of shape slightly and need to be straightened. If the fit is good, remove the paper that protects the adhesive and carefully place the main circuit board in the same position as before. 

Solder the 15 connections between the main board and the daughter board.

Tighten the Encoder and Attach the Knob

Unscrew the macropad from the box but save it incase there is something wrong when testing. 

Tighten the encoder with a wrench or pliers. Do not over tighten, especially if using a 3d printed top plate. Turning the nut about 1/2 of a full turn after hand tightening should fine for all plate materials.

Use the Allen wrench included with the kit to bring the set screw inside the knob so that it barely pokes out. Place the knob on the encoder shaft so that the set screw interfaces with the flat part of the encoder shaft. After it is in place, tighten the set screw. Be careful not to over tighten with the 3d printed knobs or it will strip. Error on the side of too loose since it can be tightened later. 

Add the Keycaps

Add the keycaps to your macropad and click the switches a bunch because it's fun and satisfying.

Test the Macropad BEFORE mounting

This is a very crucial step. The last thing you'd want to do is install your macropad only to realize you forgot to solder all the pins correctly. 

Download the test config file below or edit the config file already on the included SD card. (The included SD card only has actions setup for 3 buttons so a different configuration should be used to test all the buttons. I would recommend just downloading the test config file and using that.)


Make sure that a config file is on the SD card that uses all 5 buttons, knob, and knob button. Again, the test config file that can be downloaded has that setup for you already. 

Insert the SD card into the macropad and use the included USB cable to connect it to your computer. Test all the buttons, the knob, and the knob button.

If everything works, congrats! You're done. Move on to the user guide for further instruction. 


If your macropad doesn't work or part of the functionality is missing, there are a few steps you can take to solve the most likely issues.

Double check each of your solder connections and make sure you didn't miss any.

Re-solder the top side of the 15-pin header circled. The pins are soldered from the other side and may need to be re-soldered from the side facing you.

Please email support if you have any other issues in regards to the assembly process.