How to Test a Keyboard PCB: Step-by-Step Guide

Whether you are building your own keyboard or troubleshooting one that started dropping keys, a few minutes of PCB testing saves hours of frustration later. The PCB is the backbone of the board, tying every switch and component together, so a single bad joint or trace can take out a key, a row, or the whole thing. Testing early tells you exactly where the problem is while it is still easy to fix or return.

What You Need

• The keyboard PCB
• A USB cable
• A computer
• A key-testing tool: VIA (usevia.app) or the QMK Configurator test matrix for programmable boards, or a browser tester such as keyboardchecker.com for any board
• A conductive object: metal tweezers, a paperclip, or a small screwdriver
• A multimeter set to continuity mode (optional, for tracing dead spots)

Work on a clean, static-free surface and take a moment to look over the board first. Knowing where the switch pads, diodes, and microcontroller sit makes it much easier to spot anything out of place while you test.

Step 1: Test the Switch Positions

The switch positions are the most important thing to check, since they register every key press. You can test them on a completely bare PCB, no soldering required.

1. Connect the PCB to your computer with the USB cable.
2. Open your key-testing tool and, if prompted, select the layout that matches your PCB.
3. Take your metal tweezers or paperclip and briefly bridge the two pads for one switch position.
4. Watch the screen. If that position is good, the tester registers a key press.
5. Repeat for every switch position on the board.

If a position never registers, you have found a fault at that spot. On a hot-swap PCB you can also test by pushing a known-good switch into the socket instead of bridging the pads.

Step 2: Test the Other Components

Once the switch matrix checks out, confirm the rest of the board is healthy.

• Microcontroller: with a multimeter, measure the voltage across the VCC (power) and GND (ground) pins. A reading close to the expected value (usually around 5V or 3.3V) means it is powered correctly.
• LEDs: power the board and check that any indicator or per-key LEDs light up as expected. Dead LEDs point to a bad solder joint or a faulty LED.
• USB connector: plug the board into your computer and confirm it is recognised as a device. If nothing appears, the connector or its solder joints are the first suspects.

Step 3: Troubleshoot What You Find

When a position or component fails, the fix depends on the pattern of the fault:

• A single dead key: reflow the solder joints on that switch and check the nearby diode. A cold joint or a cracked diode leg is the usual cause.
• A whole row or column dead at once: the problem is almost always one shared trace or diode, not every switch. Follow that row or column back with a multimeter in continuity mode to find the break.
• LEDs, microcontroller, or USB port: reflow the joints first. If the part itself is damaged, it may need replacing, which calls for careful soldering or professional help.

Always unplug the board before reworking joints, and take basic anti-static precautions when handling the components.

Extra Tips

• Test in a logical order. Work row by row so you never lose track of which position you just checked, especially on a full-size board.
• Not sure about a single key? Bridge its pads again and watch closely. A position that registers intermittently usually has a marginal solder joint worth reflowing.
• Use the multimeter for the stubborn faults. Continuity mode between a switch pad and the microcontroller side quickly reveals a broken trace that a key tester alone cannot pinpoint.

Frequently Asked Questions

We keep our build and repair guides updated as tools and techniques change.