Why Is My DIY Keyboard Not Typing? Common Build Fixes
By Vortex Keyboard - Retro and Modern Style Mechanical ... | Published: 2026-10-16
Category: How-to Guides
Diagnose why your DIY mechanical keyboard isn't typing: check cable and port first, then PCB detection, solder joints, and firmware. Fixes for QMK, VIA, and Vial builds.
Quick answer
Start with the cable and port: try a known data cable in a different USB port before touching firmware or solder. If the PCB still isn't detected, reflow the USB connector and check for bridged joints. Only reflash firmware after the board is detected, and if a pad is lifted or the MCU is dead, stop and replace the PCB or choose a hot-swap kit instead.
First: rule out the cable, port, and host
A surprising share of 'dead' builds are power-only USB cables or a flaky hub. Use a cable you have already synced data with, plug directly into the motherboard, and test on a second computer. If the board shows up in Device Manager or System Information, the problem is firmware or keymap, not hardware. If nothing appears, move to the PCB checks below.
PCB not detected: inspect power and the USB connector
With the board unplugged, look at the USB connector legs under magnification. A cracked or cold joint here causes intermittent detection. Reflow each leg with fresh solder and flux. Then check for solder bridges between the data pins and the shield. If you have a multimeter, confirm 5V reaches the MCU and that D+ and D- are not shorted to ground. A board that never enumerates needs these fixed before any firmware step.
Keys missing or repeating: reflow suspect joints
If the board types but specific keys fail, the diode or switch joint for that row or column is the likely cause. Reflow both switch pins and the diode for every affected key. On a wired solderable PCB, a single cold joint can take out a whole row. Test with a key tester or a text editor after each reflow so you know which joint fixed it.
Firmware flashing issues: reset, then reflash
When the PCB is detected but keys are wrong or dead, enter the bootloader with the reset button or the key combo your board uses, then flash the correct layout. If VIA or Vial does not see the board, confirm the firmware was built with the matching protocol. On the M0110 QMK/VIA/Vial version, Vial is not yet updated to the V3 protocol, so VIA is the reliable configurator until documentation is posted.
When to stop and change course
Stop if a pad lifts, the MCU overheats, or the board shorts every time you plug it in. Those are board-level failures, not tuning issues. A hot-swap PCB or a pre-built kit removes the soldering variable entirely, and an assembly service removes both soldering and firmware setup if you would rather type than debug.
Diagnosis table: symptom, cause, action, stop point
- No detection at all: Likely a power-only cable, dead port, or cracked USB connector joint. Try a data cable in a rear motherboard port, then reflow the connector legs and check for bridges. If it still does not enumerate after a clean reflow, the MCU or board is the problem; replace the PCB rather than chasing firmware.
- Detected but some keys dead: A cold switch or diode joint on that row or column. Reflow both pins and the diode for each affected key, testing after each one. If reflowing does not restore the key, the pad or trace is damaged; stop and use a different PCB or a hot-swap board.
- Types but wrong characters or layers: Firmware layout does not match the physical build. Enter the bootloader and flash the correct layout, then remap in VIA or Vial. If Vial cannot see the board, use VIA; on the M0110 QMK/VIA/Vial version Vial is not yet updated for the V3 protocol.
- Intermittent disconnects while typing: A loose USB joint or a cable strain issue. Reflow the connector and use a strain-relieved cable. If disconnects continue after reflow, stop; the connector or MCU is failing and a replacement PCB is the safer path.
Build options that reduce these failure points
- M0110 QMK/VIA/Vial Version: M0110 QMK/VIA/Vial is certified based on the V3 protocol, while the Vial protocol has not yet been updated; upon shipment the product will only be compatible with QMK and VIA. If your build uses this PCB, configure with VIA instead of Vial to avoid a configurator that cannot see the board.
- Wired Solderable PCB: This is not a fully assembled keyboard; it cannot be returned or refunded and does not include a 12-month warranty. Buy it only if you are comfortable diagnosing solder joints yourself, since there is no warranty fallback for a build error.
- Vortex Model M SSK Kit - ISO Layout (Assembly Service): Vortex Model M SSK Kit is a retro inspired fully CNC aluminum mechanical keyboard with RGB backlit fully hot swappable function, NKRO, and supports QMK/VIA/Vial for key remapping or macros. Hot-swap sockets remove the soldering step that causes most 'not typing' failures, and the assembly service handles firmware for you.
